docs(queue): pass remaining shift budget on claims across all four lanes

Goal

Update every active and maintained repo-health lane instruction to pass the real remaining shift budget on every claim, and document the new skip/park behavior.

Design / file enumeration: #3418 (comment)
Claim contract: #3418 (comment)

Files and sections

Code active runbook: hidden_files/repo-queue-worker-instruction.md, §1 Claim, §5 CI/park, §11 launch budget.
Shared active runbook used by OpenCode, OpenChamber and Nix: hidden_files/lane-shift-instruction.md, §1 Claim and §11 launch budget; also update its park/CI section as needed.
Maintained per-repo references: repo-queue-worker-instruction-opencode.md, repo-queue-worker-instruction-openchamber.md, and repo-queue-worker-instruction-nix.md, each §1 Claim and §5 CI/park.
Cron wrappers repo-queue-worker-shift-{opencode,openchamber,nix}__interval@40m.md supply queue/repo/lane parameters and reference the shared runbook; verify the active four queue invocations are consistent and do not carry stale claim examples.

Acceptance

Every first and subsequent claim recomputes max(0, configured_shift_budget - elapsed) and passes the required remaining-budget argument.
Instructions say a budget mismatch is skipped without claim or arbitrary clock park; pure capacity parks carry the minimum requirement without changing an external not_before.
External-wait readiness and budget-fit are independent gates; priority never bypasses fit.
All four queues and their active entry points are enumerated; no stale runbook can instruct an unlimited claim.
Link this issue to implementation issue feat(queue): enforce remaining-budget admission in claim and park #4712 and report a search/check showing every claim example has the new argument.

Excludes

SQL/RPC/helper implementation and tests (issue feat(queue): enforce remaining-budget admission in claim and park #4712).

🤖 Agent note · queued

Agent: queue worker (repo-worker-code), openchamber scheduled lane 02cafe76
Session / ID: queue task 6695
Found via: design issue design(queue): budget-aware claiming — parks carry a minimum required time budget, claim matches the claimer's remaining shift budget #3418 follow-up
Task: Update active and maintained lane instructions so all four queue lanes pass remaining shift budget on every claim.
Expectation: Keep first/later claim calculations, budget-vs-external-wait distinction, and queue/repo/lane mappings synchronized.
Links: design(queue): budget-aware claiming — parks carry a minimum required time budget, claim matches the claimer's remaining shift budget #3418 design record · feat(queue): enforce remaining-budget admission in claim and park #4712 implementation task · docs(queue): pass remaining shift budget on claims across all four lanes #4713

🤖 Agent note · parked

Agent: queue worker (repo-worker-code), lane code-i
Session / ID: task 6695
Found via: queue claim
Task: task 6695 / issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 — update all four repo-health lane instructions to pass remaining shift budget on claims
Expectation: parked on the design record's own rollout ordering: the design(queue): budget-aware claiming — parks carry a minimum required time budget, claim matches the claimer's remaining shift budget #3418 design (comment 6593226078, Rollout step 2) says roll the helper before enabling claim-side enforcement, THEN update all four queue lane instructions. The helper change is issue feat(queue): enforce remaining-budget admission in claim and park #4712 (task 6693), which is itself parked gated on task 6633's migration baseline.
Revalidation (fresh, 2026-11-03T01:57Z): issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 OPEN; issue feat(queue): enforce remaining-budget admission in claim and park #4712 OPEN with queue/parked labels; repo-queue.py claim --help has NO --remaining-budget-minutes argument. Editing the runbooks now to mandate that argument on every claim would make every lane's claim fail against the live helper. No files edited.
Resume: after issue feat(queue): enforce remaining-budget admission in claim and park #4712 lands (helper exposes --remaining-budget-minutes), revalidate the helper argument fresh, then make the enumerated runbook/wrapper edits and the no-stale-claim-example search.
Links: issue design(queue): budget-aware claiming — parks carry a minimum required time budget, claim matches the claimer's remaining shift budget #3418 design record · issue feat(queue): enforce remaining-budget admission in claim and park #4712 · issue docs(queue): pass remaining shift budget on claims across all four lanes #4713

🤖 Agent note · parked (correction)

Agent: queue worker (repo-worker-code), lane code-i
Session / ID: task 6695
Correction: the execution-lane assignment for task 6695 returned opencode, but that result reached me only after I had already parked the task directly (its output was swallowed in a combined command). Under the runbook §1b the correct handling was a handed_off checkpoint for the laptop claimant, not a direct park. The park's substance is unchanged — the ordering gate on issue feat(queue): enforce remaining-budget admission in claim and park #4712 is real and verified — and when task 6695 becomes claimable again, the next worker should lane-check first and hand it off to the opencode claimant rather than working it directly.
Links: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 · issue feat(queue): enforce remaining-budget admission in claim and park #4712 · issue design(queue): budget-aware claiming — parks carry a minimum required time budget, claim matches the claimer's remaining shift budget #3418 design record

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), launched by opencode-claimant
Session / ID: task 6695 / OpenCode session ses_e5e60a0910affeFkVkOWYQ5Cix
Found via: queue handoff · opencode-claimant launch
Task: Update all four repo-health lane instructions to pass remaining budget
Expectation: s — complete the scoped task or record its precise resume/block condition
Links: docs(queue): pass remaining shift budget on claims across all four lanes #4713

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-d
Session / ID: task 6695
Found via: queue claim
Task: small_fix issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 — claimed by lane code-d, revalidated fresh via gh (issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 OPEN, no hard-stop labels), execution lane assigned opencode; handing off to the opencode claimant for the bound session to work it.
Expectation: claimant launches the bound opencode session and drives task 6695 to a terminal state.
Links: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-e
Session / ID: task 6695
Found via: queue claim
Task: Handed off task 6695 (small_fix) for issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 to the opencode claimant — execution lane assigned opencode. Fresh check: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 OPEN, no hard-stop labels.
Expectation: claimant launches the bound opencode session and drives task 6695 to a terminal state
Links: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713

Lane B (code-b) claimed task 6695 for issue #4713. Execution-lane assignment returned opencode (§1b), so this task is handed off to the opencode claimant — checkpointed handed_off and parked 1200s for the claimant to launch the bound session. Issue verified OPEN with no hard-stop labels (held / user/owned / do-not-merge / do-not-auto-edit).

🤖 Agent note · handed off

Agent: repo queue worker, lane code-b (repo-worker-code)
Session / ID: cron repo-queue-worker-shift-b run 2026-11-05; task 6695
Found via: claimed task 6695 this shift; execution-lane assignment returned opencode
Task: task 6695 for issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 (small_fix). Fresh check: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 is OPEN, no hard-stop labels (held / user/owned / do-not-merge / do-not-auto-edit). Handed off to the opencode claimant — the claimant launches the bound opencode session; this lane does not work it directly.
Expectation: claimant session drives task 6695 to a terminal state.
Links: task 6695 · issue docs(queue): pass remaining shift budget on claims across all four lanes #4713

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-e
Session / ID: task 6695
Found via: queue claim
Task: Handed off task 6695 (small_fix) for issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 to the opencode claimant — execution lane assigned opencode. Fresh check: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 OPEN, no hard-stop labels.
Expectation: claimant launches the bound opencode session and drives task 6695 to a terminal state
Links: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713

Lane Q (code-q) claimed task 6695 for issue #4713. Execution-lane assignment returned opencode (§1b), so this task is handed off to the opencode claimant — checkpointed handed_off and parked 1200s for the claimant to bind. Attempts 30/32 (at cap soon — strands if claimant does not bind).

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-y
Session / ID: task 6695 (queue repo-health-code-pilot), shift 2026-11-06 07:24 CST
Found via: queue claim
Task: task 6695 (small_fix for issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 — update all four repo-health lane instructions to pass remaining budget) is assigned to the opencode execution lane; handed off to the opencode claimant, which launches the bound session. Issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 re-verified OPEN with no hard-stop labels at handoff (attempts 31/32 — near cap; one attempt remains).
Expectation: claimant launches the bound opencode session, which drives task 6695 to its terminal state; if unbound at lease expiry the task returns to the queue with one attempt left.
Links: task 6695 · issue docs(queue): pass remaining shift budget on claims across all four lanes #4713

Agent note — task 6695 handed off (lane code-g)

Task: task 6695 (small_fix, issue docs(queue): pass remaining shift budget on claims across all four lanes #4713)
Execution lane assignment re-checked this claim: opencode — handing off to the opencode claimant per the worker runbook; this lane did not work the issue directly.
Verified fresh 2026-11-06: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 is OPEN, no hard-stop labels; labels already in the parked set.
Attempts now 31/32 — NEAR CAP: one attempt remains after this park cycle. The claimant must bind this cycle, or the cap needs raising / the task needs manual rescue. Prior progress also names an ordering gate (feat(queue): enforce remaining-budget admission in claim and park #4712 / task 6633).
Next: claimant launches the bound opencode session for task 6695; parked 1200s for that launch window.

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-y
Session / ID: task 6695
Found via: queue claim
Task: task 6695 assigned to opencode execution lane; handing off to the opencode claimant — verified issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 OPEN, no hard-stop labels (held, user/owned, do-not-merge, do-not-auto-edit absent); attempts 31/32, near cap — one attempt remains if the claimant does not bind
Expectation: claimant launches the bound opencode session for task 6695; parked 1200s in the queue pending that launch
Links: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-b
Session / ID: task 6695
Found via: queue claim
Task: Handing task 6695 for issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 to the opencode claimant — execution lane assigned opencode by fleet queue lane; this lane does not work it directly. NOTE: task 6695 is at attempts 31/32 (near cap) — claimant binding is urgently needed.
Expectation: claimant launches the bound opencode session for issue docs(queue): pass remaining shift budget on claims across all four lanes #4713; task parked 1200s for that launch.
Links: docs(queue): pass remaining shift budget on claims across all four lanes #4713

Navigation Menu

Repository navigation

docs(queue): pass remaining shift budget on claims across all four lanes #4713

Goal

Files and sections

Acceptance

Excludes

149 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

docs(queue): pass remaining shift budget on claims across all four lanes #4713

Description

Goal

Files and sections

Acceptance

Excludes

Activity

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

149 remaining items

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

dezren39 commented on Nov 6, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions