[Stener1]

Stacked on #175 (archive in the background) and on the background-jobs tray branch (Stener1:background-jobs-tray, not opened upstream yet). Both are rebased onto current main. The diff includes their commits until they land: the tray is the six commits after #175's, and this PR's own work is the ten commits from feat(box): a bulk Stop runs on the box… on.

Summary

Closing the laptop mid bulk Stop used to halt it. The app ran the whole sequence, so in-flight and queued requests failed on wake, and agents ended up stopped but not archived. Now each box with runs does its share itself, as one durable stop run, and so does the sidebar's single Archive…:

runStopJob (app)                                   box (internal/box)
  split rows by box
  keep the job (berth.jobs.stopRuns) ── before anything is sent
  box has runs + online ──► POST /v1/runs {template: stop, group, idem_key}
     no answer ─► ask again, same key, until it answers (rows: Waiting for BOX)
                                                    map  stop_session ×N   (3 at a time, session.stop gate)
                                                    map  archive_worktree  (one at a time)
                                                           archiveTurn: one archive at a time on the box, across runs
                                                           live agent there?   → Kept: …
                                                           uncommitted work?   → Kept: uncommitted changes
                                                           worktree.remove gate
                                                           dropWorktreeIf(no force, branch kept)
                                                             archive script, then under lastLook:
                                                             re-check agents, remove (no session starts in between)
  follow GET /v1/runs/{id} ──► rows                (no answer = ask again; only the box fails a row)
  "Stop the rest" ──► cancel the run; a start still unanswered is looked up by group (GET /v1/runs?group=)
                      and cancelled if the box took it; the cancel is kept across a relaunch
  else: the app's own loop (older boxes, offline at start, a 4xx on start),
        each box's line held until the box says an archive script finished

Archive… (sidebar, zen, launcher)
  box has runs ──► one-worktree stop run: its sessions stop, then archive_worktree as above
  else         ──► the app's per-box line, held until worktree.removed / worktree.archive.failed

• Box: the stop template and stop_session / archive_worktree leaves (runstop.go). dropWorktree gets an in-flight guard, so a second ask (a resumed run, a duplicate run, a second DELETE) joins the first instead of running the archive script again. The dirty check comes before that guard, so a second ask for a dirty worktree is refused, not answered 202. archiveTurn serializes archives across a box's stop runs. removeAfter / startUnseen close the check-then-remove race: no session starts between the last look for agents and the folder going. If berthd stops mid-archive, the step stays unfinished in the journal for the resumed run.
• App: lib/stop-job.ts keeps the job before it sends, asks an unanswered box again under one key until it answers, and looks a run up by its group when Stop the rest comes first. A job comes back to the tray after a relaunch (for at most 24 h), cancelled if it was. The Worktrees table's Stop sessions and Archive, the sidebar's Stop everything in … and its Archive… use the same run (lib/stop-on-box.ts, archiveOnBox).
• The mock plays stop runs out against its own fixtures (playStop), in each box's archive line. ?noruns gives the old path.
• Docs: the stop template in guides/runs.mdx, the new step kinds, changelog bullets, and the verify skill's feature map and scenarios.

Evidence

All on the final head, with the verify-berthd skill.

A start the box never answers (new dashboard-stop-unanswered, a real dev box, synthetic acme-shop). berthd is killed (SIGKILL) as Stop is pressed and started again 20 s later.

• Before: startStopRun gave up after three asks (about 6 s) and failed the rows, Failed: devq is offline, though the box might have the run. That was the old unit test a box that never answers the start fails its rows.
• After: no row fails, the start is asked again once the box is back, and the box ends with one run for the job:

- with the box down the rows say: verify-mute-gp4k-a Waiting for devq | verify-mute-gp4k-b Waiting for devq
- after 20 s down, no row failed
- one stop run on the box for it (group stop-mvqsgss9yzpz): r_mvqshg2697ke succeeded
- git on the box agrees: both worktrees gone, both branches kept

Box down: rows wait	Box back: done

Bulk Stop and sidebar Archive… on a real box (dashboard-stop-live): the report reads 3 stopped, 2 archived, 1 kept; git agrees; the box lists Stopping 3 agents: succeeded and Archive verify-solo: succeeded. No request is refused any more: the dirty worktree is kept inside the run.

Report	Archive… as a stop run

The lid closing (dashboard-stop-lid): the laptop agent was paused for 25 s mid-archive, and on wake the tray read 5 stopped, 3 archived, 2 kept. A reload mid-run brought the job back, ending 2 stopped, 2 archived. The Worktrees table's Stop sessions and Archive each ran as a stop run.

After waking	Reattached, done

One archive at a time per box (mock, worktree-archive): Archive… on gpu/ci-flake, then judge-v2 at once. Both are stop runs on gpu, and judge-v2 waits in gpu's line (Archived ci-flake at 5.5 s, Archived judge-v2 at 10.0 s). qa-deck's row stays Archiving… until its script is done, then shows one toast.

Both archiving	Script running	Dirty: kept

Tests:

• Go, new:
  • TestStopRunsOnABoxArchiveOneAtATime: two runs' scripts log start end start end.
  • TestNoAgentStartsUnseenAsAWorktreeGoes: a session asked for during the last look waits, then gets no folder.
  • TestAWorktreeAskedAgainIsCheckedForWorkFirst: dirty while the first archive runs, so the second DELETE is refused.
  • The dedup test now waits for worktree.archive.started and quotes its path.
• Go, the full suite: go vet ./... && go test -race ./... fails only in tests that fail on main on this machine under load (TestTheCatalogIsCapped, TestReviewRoutesOverTheWire, TestDetach, TestServicesAreCounted); TestReviewRoutesOverTheWire passes 3/3 alone.
• Unit, new in stop-job.test.ts:
  • an unanswered start is asked until answered
  • Stop the rest while unanswered: a run the box took is cancelled, and with none nothing is done
  • kept before sending, then asked again after a relaunch
  • a cancel while out of reach is kept: after a relaunch it is only looked up and cancelled, never started (both with and without the box having taken it)
  • a 404'd run clears its Archiving… marks
  • an archive script holds its box's line
• Unit, elsewhere: runPool with an undefined item, and unmarked. pnpm test: 636 pass.
• E2E: dashboard-stop-archive.spec.ts and worktree-remove.spec.ts pass, 11/11.
• These pass: typecheck:plugins, check:titles, check:type, check:grid, check:csp, check:themes, tsc -p e2e and pnpm build. cargo check was not run: GTK dev libs are missing on this machine, which is unrelated.
• The 29 review threads from cubic are each answered with the commit that addresses them. Codex review and adversarial review ran on the fixes; their findings (a cancel lost across a relaunch, and an archive failure that beats the 202) are fixed in the last commit.

Merge Danger

Door: two-way

On the box it's additive: a new template, two step kinds, an in-flight guard, an archive line across stop runs, and a lock held only from a removal's last look for agents until the folder goes. Old clients are unaffected, and new clients fall back on boxes without runs. Reverting the PR restores the app's loop.

Blast Radius: bulk-stop and archive

• Where it reaches: on boxes with runs, the board's bulk Stop / Clean up, the Worktrees table's Stop sessions and Archive, the sidebar's Stop everything and its single Archive… all go through the box.
• What changes there:
  • A row reads Archived once the script is done, not Archiving while it runs.
  • Archive stops the worktree's sessions first, as archiving always ended them.
  • A worktree is kept if an agent starts there during the script.
  • A bulk Stop row waits for an unreachable box instead of failing.
  • A session start can wait up to one git worktree remove while a stop run removes a worktree.
• On boxes without runs: the app holds a box's line until an archive script finishes, so queued archives there wait longer, but never overlap.

🤖 Generated with Claude Code

[vercel]

@Stener1 is attempting to deploy a commit to the seanbrydonio's projects Team on Vercel.

A member of the Team first needs to authorize it.

[Stener1]

Could a maintainer add run-ci? I can't label PRs here. The checks from AGENTS.md pass locally; details are in the PR body.

[cubic-dev-ai]

2 issues found across 41 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. When an issue isn't valid or won't be fixed in this PR, reply in its thread with the reason and then resolve the thread. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="app/src/App.tsx">

<violation number="1" location="app/src/App.tsx:244">
P3: `JobsTray` remains mounted under the Settings-hidden container, so its layout measurement can reserve space for an invisible tray and shift Settings toasts upward. Render it only outside Settings or reset its height while hidden.</violation>
</file>

<file name="docs/changelog.mdx">

<violation number="1" location="docs/changelog.mdx:38">
P2: An unanswered run start can also mark rows failed: `startStopRun` throws after three transient errors, and `runStopJob` records those rows as failed locally. Qualify this as applying after the box accepts the run.</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

View guided diff | Re-trigger cubic</sub>

[Stener1]

Rebased onto current main on top of the rebased #175 (and background-jobs-tray), head 2575aac3. All 29 cubic threads are addressed, each with a reply naming its commit; all were valid and fixed. The larger ones:

• a stop run's start is asked again until the box answers, kept before it's sent, and looked up by group on Stop the rest or a relaunch (the P1)
• the sidebar's Archive… is a one-worktree stop run on boxes with runs
• the box archives one worktree at a time across its stop runs
• no session can start between a removal's last look for agents and the folder going

Codex's review of the fixes found two more (a cancel lost across a relaunch, and an archive failure arriving before its 202); both are fixed in the last commit. The PR body has the new evidence, including dashboard-stop-unanswered, which kills berthd as Stop is pressed.

[Stener1]

Rebased the stack (#175, background-jobs-tray, this PR) onto current main (71efa89a), head 38ab82b5. The 29 cubic threads are unchanged and stay resolved. The rebase only changed three things, each folded into the commit it belongs to:

• queueRemoval's keep-work check now uses main's keptReason (from fix(box): worktrees with submodules can be removed when nothing would be lost #197), so only a real refusal over unsaved work offers Remove anyway, and its toast gives the box's own reason (submodule commits, couldn't check). The PR's archive toast is the same as before.
• With that check, remove-worktree.ts no longer imports keepsWork, and errorMessage is imported again.
• v0.3.31 renamed ## Unreleased, so the three changelog bullets had landed in the released section. They are under a new ## Unreleased again.

Re-run on the new head: tsc --noEmit; the unit tests for the changed libs (stop-job, jobs, removing, kept-reason, …), 81/81; go vet ./internal/box/...; go test -race on the box's stop-run, archive, worktree and submodule tests, and on internal/box/runs. It still needs run-ci.