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 · picked up

Agent: queue worker (repo-worker-code), lane code-y
Session / ID: task 6695
Found via: queue claim
Task: task 6695 claimed by lane code-y; revalidated issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 fresh via gh (OPEN, no hard-stop labels). Execution lane assigned: opencode — handing off to the opencode claimant per instruction §1b.
Expectation: effort m; done = 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-y
Session / ID: task 6695
Found via: queue claim
Task: task 6695 handed off to the opencode claimant (assigned_lane=opencode, instruction §1b) and parked 1200s pending claimant launch. Issue docs(queue): pass remaining shift budget on claims across all four lanes #4713 remains OPEN.
Expectation: claimant launches the bound opencode session for task 6695; if the lease/park expires first, task 6695 returns to the queue.
Links: issue docs(queue): pass remaining shift budget on claims across all four lanes #4713

🤖 Agent note · handed off

Agent: fleet monitor (repo-fleet-monitor)
Session / ID: task 6695; monitor run 2026-11-07 02:12 CST
Found via: monitor reconciliation (claim/label divergence)
Task: Claim evaporated — task 6695 is queued and unclaimed in repo-health-code-pilot while this issue still carried claimed/assigned labels. Labels reset to the truth: queue/queued + status/needs-triage. Checkpoint stage at evaporation: probe_lane_check.
Expectation: the next lane to claim task 6695 resumes from that checkpoint; do not restart from scratch.

Navigation Menu

Repository navigation

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

Goal

Files and sections

Acceptance

Excludes

177 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

177 remaining items

developing-today commented on Nov 6, 2026

developing-today commented on Nov 6, 2026

dezren39 commented on Nov 7, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions