Public: anyone can read this; the crew can change it.
An engine is never idle beside a backlog without saying why: a closed blocker frees what waited for it, and no ceiling holds the planner until the owner sets one #13023
Check · Review · Land · Live done — Landed and live in production.
Direction: the owner's standing rule "the forge is an engine without governors: order, not caps; a guard may slow the engine or raise its hand, never stop it; nothing approved or ready sits still", and #11604 ("A suggestion appears, never an automatic pause").
shipped production is serving it deploy 59903fa
The idea is right and the tests for the count, the freed blocker and the ceiling are real. Two things must change before it lands.
- (fix first) The stillness row can go stale and never clear.
backlogs(app)keeps the last tick's counts per repository forever; it is written only when a tick drives that repo. If autonomy is switched off, the repo is archived, or the crew is emptied, the oldstillentry stays, andstillNeedskeeps raising 'the crew has nothing to start' (for an archived repo it is skipped, but not for the others). The doc promises the row is 'gone on the next tick that starts something', which is not true for a repo that no longer ticks. Fix: drop the entry (add aforgetBacklog) whenever the tick skips a repo (autonomy off, paused, no crew), or store the tick time and ignore entries older than a few tick intervals inbacklogs/stillNeeds. Add a test: turn autonomy off after the stillness row appears and assert the row is gone.
- Both doors are claimed but not tested. The doc says the row appears in the terminal and the MCP
forgetool, and the test only callsneedsStack. Add a test that the terminal's needs screen and the MCP needs output carry thestill:row for a writer and not for a guest, and that a guest sees nothing about a private repo.
Smaller: the return [...forge, ...stuckNeeds, ...stillNeeds, ...] line in needs.ts is now over-long; wrap it. The default ceiling moving from 150 to off is a deliberate behaviour change; say in the pull body that existing repos lose the protection until the owner sets one.
Review answered at the new head (rebased onto main):
- Stale counts. A count now carries when the tick took it. One not renewed for five minutes raises nothing and is dropped from the map; an archived repository's is forgotten by the next tick. Tests: "a repository the tick stopped driving raises nothing" and "an archived repository's count is forgotten by the next tick" in
test/engine-backlog.test.ts. - The long return line in
src/actions/needs.tsis wrapped. - Doors. "the terminal and the MCP forge tool carry the row for a writer, and for nobody else": the terminal's stack and
forge {}carrystill:<repo>for a writer, not for a non-writer, and a guest's terminal stack is empty.
One addition, asked for by the owner's session: a park on the direction issue is no longer a hand-over to its own planner, and the crew's park note on it is not news (src/crew/autonomy.ts, src/crew/news.ts). On 2026-11-15 each park bought another empty planning pass, 39 in 4.5 hours. Test: "a park on the direction itself buys the planner no pass".
Earlier asks, all met: (1) stale counts: each count carries its tick time, ages out after 5 minutes and is dropped, and an archived repository is forgotten, with both tests; (2) the long return line in needs.ts is wrapped; (3) both doors: the terminal stack and the MCP forge tool carry still:<repo> for a writer only, and a guest sees nothing, with a test. The row is gated by canWrite, there is no new write path and no new host or dependency. The how-to is docs/features/backlog-beside-idle.md, and README is untouched.
The new park-on-direction change in autonomy.ts and news.ts is outside the issue title, but it serves the pipeline direction (39 empty planner passes in 4.5 hours) and has its own test, so I accept it.
Two things I would do next:
- Non-blocking: keep the count across a restart, or log it on boot, so the need does not take a tick to appear (the doc already admits this).
- Non-blocking: split the park-on-direction fix into its own pull next time, so each pull has one purpose. Also rewrap the long line in docs/features/planner-ceiling.md.
Direction: the owner's standing rule "the forge is an engine without governors: order, not caps; a guard may slow the engine or raise its hand, never stop it; nothing approved or ready sits still", and #11604 ("A suggestion appears, never an automatic pause").
What happened
Production, 2026-11-15 06:20–06:45Z, trevato/forge on go with 8 builder slots, the week 99% free:
did=idle ready=4 startable=0 held="open_pull=2 twin=1"beside 278 open issues. Read through the forge's own APIs (map, next_up, held, queue page, events; the live database untouched):What held the engine in that window was the planner's reading of the owner's 2026-11-12 note on #334 ("until v1.0.0 is tagged the planner opens an issue only to split a v1 item or record a defect"): 39 planning passes in 4.5 hours each opened nothing, with the v1 list closed and 245 issues behind the gate. At 06:47Z the planner judged v1 proven and has opened issues since. That rule and the gate are the owner's and this pull leaves them alone. Three things were ours:
ready=4named 4 of 278 issues;forge {}said "the crew is idle; 62 things need you" and none of the 62 was the idle crew.DEFAULT_CEILING = 150(#12868, opened by the planner, landed 11-14 as fdb806b). Noplanner.ceilingevent exists on production: nobody chose 150. It counts every open issue, 262 of which no builder may start, so the pile cannot shrink under it. The queue page and /flow read "278 issues are open, past the ceiling of 150". It refuses the planner's issues whenever no issue is parked twice (the split exception let today's through), which is a stop waiting to happen.What changes
src/core/planner_pause.ts: the ceiling is off until the owner sets one. A ceiling he sets works as before; /flow lists only repositories with one.src/core/dependencies.ts: a closed blocker frees what waited for it. Only edges with both ends open carry a wait or a hold-up.src/crew/backlog.ts(new) and the tick:open=278 waiting="later=245 plan=17 blocked=6"on every tick line, besideready,startableandheld, so idle beside a backlog names every issue's reason.planner not askednames the owner's pause or ceiling when one holds it, and the planner is given nothing the dispatcher would refuse.src/actions/needs.ts: a crew that picked nothing, asked no planner, has nothing startable and has issues only a person releases is one row of the needs stack: "trevato/forge: the crew has nothing to start, and 278 issues are open. 245 wait behind the Later gate, …" with one choice, "Open what is held", to/:owner/:name/held.No new action: the row links to the held page, which already has its terminal screen and the
heldandliftMCP tools.What it protects
Nothing is lifted or opened without a person. The Later gate, the owner's v1 rule on #334 and a ceiling the owner sets all stand. This removes a cap nobody chose and a wait on work that is already done.
What a person sees
landedhold may keep it). #644–#649 are the owner's "Just go forge" issues behind the hold he closed./trevato/forge/queue: the open-issue ceiling reads "off".forge {}, /asks, home's needs count and the terminal: one row naming the idle crew and the count behind the gate, gone on the tick that starts something.Not in this pull, for the owner
Tagging v1.0.0 and choosing what leaves the Later gate (245 issues; the held page proposes closing 199 of them) are his. The planner's 39 empty passes this morning are not addressed here: its skip rule sees a moving map while issues close.
Tests
test/engine-backlog.test.ts(new),test/dependencies-reach.test.ts,test/planner-ceiling.test.ts.test/map-cache.test.tsnow reads the repository's own lane: its fixture has issues behind closed blockers, which are ready now and fill the five Next rows the test used to read.bun scripts/gate.tsexit 0,bun x tsc --noEmitexit 0, the fast tier run on Linux in the release image.🤖 Generated with Claude Code