Skip to content

docs(skill): reduce file-mailbox coordination round trips - #1065

Open
fglock wants to merge 7 commits into
chore/perl5-sync-35694276from
docs/file-mailbox-bounded-envelopes
Open

docs(skill): reduce file-mailbox coordination round trips#1065
fglock wants to merge 7 commits into
chore/perl5-sync-35694276from
docs/file-mailbox-bounded-envelopes

Conversation

@fglock

@fglock fglock commented Aug 18, 2026

Copy link
Copy Markdown
Owner

Summary

  • add bounded execution envelopes to reduce worker approval round trips
  • document self-advancing dependency handoffs and explicit stop conditions
  • replace coordinator-granted local build slots with decentralized admission
    under a published concurrency limit
  • make long corpus/build gates observable with GATE_STARTED/GATE_FINISHED,
    resumable session, log, and ETA metadata
  • distinguish queued preparation from active implementation by requiring an
    activity kind, exact worktree/branch/base, and first edited file or gate
    process evidence
  • require source repository + ref + exact commit for cross-checkout handoffs so
    workers do not wait on SHAs absent from their object database
  • audit observable state transitions rather than treating mailbox volume or an
    “ACTIVE” label as implementation progress

Validation

  • warning-free full make at 684a3e65b: exit 0, all 17 tasks in 5m53s
  • Joni packaging verification, all Joni tests, and five unit shards passed
  • skill frontmatter, required keys, 419-line size, and git diff --check pass
  • the supplied quick_validate.py could not start because this environment
    lacks its PyYAML dependency; no dependency was installed during active builds
  • protocol exercised by Phase 36: observable worktree checks exposed a missing
    DEFINE start, exact cross-repository fetch instructions unblocked workers,
    and conditional implementation queues removed coordinator round trips

Stacking

This is based on chore/perl5-sync-35694276 and should be retargeted to
master after that PR merges.

fglock and others added 3 commits August 18, 2026 21:51
Add bounded execution envelopes that authorize predictable focused testing,
resource claims, commits, and pushes while retaining explicit ownership and
stop conditions.

Generated with [Codex](https://openai.com/codex/)

Co-Authored-By: Codex <codex@openai.com>
Count every unexpired build intent as occupied capacity until release or
expiry, and require a second mailbox/process audit immediately before launch.
This closes the race where several workers saw no process for one another's
already-announced starts and exceeded the shared concurrency limit.

Generated with [Codex](https://openai.com/codex)

Co-Authored-By: Codex <codex@openai.com>
Require gate-start metadata before long commands, preserve leases while logs advance, and treat denied process inspection as unknown rather than evidence of idleness.

Generated with [OpenAI Codex](https://openai.com/codex)

Co-Authored-By: OpenAI Codex <codex@openai.com>
@fglock
fglock force-pushed the docs/file-mailbox-bounded-envelopes branch from 8a8ed7b to 616a4bf Compare August 19, 2026 08:21
fglock and others added 4 commits August 19, 2026 14:28
Distinguish queued preparation from active implementation, require verifiable
worktree and gate evidence, and make cross-repository dependency handoffs
self-advancing.

Generated with [Codex](https://openai.com/codex)

Co-Authored-By: Codex <codex@openai.com>
Keep the coordinator on integration and regression triage while delegating
long read-only differential runs. Permit exact-SHA acceptance gates to run
speculatively beside their prerequisite build with explicit cancellation and
resource safeguards.

Generated with Codex (https://openai.com/codex)

Co-Authored-By: Codex <codex@openai.com>
Require explicit command scoping after worktree creation and record the
recovered wrong-checkout integration incident.

Generated with [OpenAI Codex](https://openai.com/codex/)

Co-Authored-By: OpenAI Codex <codex@openai.com>
Keep workers productive through cohesive root clusters, batched validation,
residual classification, and conditional disjoint follow-ons.

Generated with [OpenAI Codex](https://openai.com/codex/)

Co-Authored-By: OpenAI Codex <codex@openai.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant