toolroll 0.9.99 → 0.9.101

package/dist/design/kit.css

@@ -19,7 +19,7 @@
  * stays here: status words on their soft wash, mixed toward ink so they read at 4.5:1 or better, and the motion
  * vocabulary (three durations, one curve; nothing longer, no bounce). */
 :root {
-  --so-needs-ink: color-mix(in srgb, var(--so-needs) 78%, var(--so-ink));
+  --so-needs-ink: var(--so-ink);
   --so-live-ink: color-mix(in srgb, var(--so-info) 82%, var(--so-ink));
   --so-done-ink: color-mix(in srgb, var(--so-success) 80%, var(--so-ink));
   --so-fail-ink: color-mix(in srgb, var(--so-danger) 85%, var(--so-ink));
@@ -64,7 +64,8 @@
 /* ---------- Status: five words, one tone each ---------- */
 .k-chip { display: inline-flex; align-items: center; gap: 6px; height: 20px; padding: 0 7px; border-radius: 6px; font: var(--so-typography-badge); background: var(--so-neutral-soft); color: var(--so-neutral-ink); white-space: nowrap; flex: none; }
 .k-chip::before { content: ""; width: 6px; height: 6px; border-radius: 50%; background: var(--dot, var(--so-muted)); flex: none; }
-.k-chip.needs { background: var(--so-needs-soft); color: var(--so-needs-ink); --dot: var(--so-needs); }
+.k-chip.needs { background: var(--so-needs); color: var(--so-on-signal); }
+.k-chip.needs::before { display: none; }
 .k-chip.ask { background: var(--so-neutral-soft); color: var(--so-ink); --dot: var(--so-needs); }
 .k-chip.live { background: var(--so-info-soft); color: var(--so-live-ink); --dot: var(--so-info); }
 .k-chip.done { background: var(--so-success-soft); color: var(--so-done-ink); --dot: var(--so-success); }
@@ -255,6 +256,82 @@
 .k-step-l { line-height: 1.2; white-space: nowrap; }
 .k-step-s { margin-top: -4px; min-height: 1.3em; font-size: 11.5px; font-weight: 400; line-height: 1.3; color: var(--so-muted); white-space: nowrap; }
 
+/* ---------- Step rows: the steps are the page ---------- */
+.k-steprows { display: flex; flex-direction: column; margin: 0; padding: 0; list-style: none; }
+.k-steprow { position: relative; display: grid; grid-template-columns: 20px minmax(0, 1fr); column-gap: 14px; margin: 0; padding: 0; }
+.k-steprow::before { content: ""; position: absolute; left: 9.5px; top: 24px; bottom: 4px; width: 1px; background: var(--so-line); }
+.k-steprow:last-child::before { content: none; }
+.k-steprow-mark { position: relative; z-index: 1; box-sizing: border-box; display: grid; place-items: center; width: 20px; height: 20px; border-radius: 50%; border: 1.5px solid var(--so-field-line); background: var(--so-paper); }
+.k-steprow.done .k-steprow-mark { border-color: var(--so-ink); background: var(--so-ink); }
+.k-steprow.done .k-steprow-mark::after { content: ""; width: 4px; height: 8px; margin-top: -2px; border: solid var(--so-paper); border-width: 0 1.6px 1.6px 0; transform: rotate(45deg); }
+.k-steprow:is(.needs, .live, .wait, .stuck) .k-steprow-mark { border-width: 2px; }
+.k-steprow:is(.needs, .live, .wait, .stuck) .k-steprow-mark::after { content: ""; width: 8px; height: 8px; border-radius: 50%; background: currentColor; }
+.k-steprow.needs .k-steprow-mark { border-color: var(--so-needs); color: var(--so-needs); }
+.k-steprow.live .k-steprow-mark { border-color: var(--so-info); color: var(--so-info); }
+.k-steprow.wait .k-steprow-mark { border-color: var(--so-muted); color: var(--so-muted); }
+.k-steprow.stuck .k-steprow-mark { border-color: var(--so-danger); color: var(--so-danger); }
+.k-steprow.skipped .k-steprow-mark { border-style: dashed; }
+.k-steprow-main { min-width: 0; display: grid; align-content: start; gap: 12px; padding-bottom: 22px; }
+.k-steprow:last-child .k-steprow-main { padding-bottom: 0; }
+.k-steprow:is(.needs, .live, .wait, .stuck) .k-steprow-main { padding-bottom: 26px; }
+.k-steprow-head { display: flex; align-items: baseline; gap: 12px; width: 100%; min-width: 0; min-height: 20px; margin: 0; padding: 0; border: 0; border-radius: 6px; background: none; color: inherit; font: 400 13px/20px var(--so-font-sans); text-align: left; }
+button.k-steprow-head { cursor: pointer; transition: color var(--m-quick) var(--m-ease); }
+button.k-steprow-head::after { content: ""; flex: none; align-self: center; width: 6px; height: 6px; margin: 0 4px 0 2px; border: solid var(--so-muted); border-width: 0 1.5px 1.5px 0; transform: rotate(-45deg); transition: transform var(--m-quick) var(--m-ease); }
+button.k-steprow-head[aria-expanded="true"]::after { transform: rotate(45deg); }
+.k-steprow-label { flex: 0 0 84px; min-width: 0; font: 600 14px/20px var(--so-font-sans); color: var(--so-ink); }
+.k-steprow-say { flex: 1 1 auto; min-width: 0; display: flex; flex-wrap: wrap; align-items: center; gap: 4px 8px; color: var(--so-muted); overflow-wrap: anywhere; }
+.k-steprow:is(.needs, .live, .wait, .stuck) .k-steprow-say { color: var(--so-ink); }
+.k-steprow-time { flex: none; color: var(--so-muted); font-size: 12.5px; }
+.k-steprow.todo .k-steprow-label { font-weight: 500; color: var(--so-muted); }
+.k-steprow-body { display: grid; gap: 16px; min-width: 0; }
+.k-steprow-body[hidden] { display: none; }
+/* The one ink outline of a step that waits on the viewer is the row's; a waiting box inside it draws none of its own. */
+.k-steprow.needs > .k-steprow-main > .k-steprow-body { border: 1px solid var(--so-needs); border-radius: var(--so-radius-card); padding: 16px 18px 18px; }
+.k-steprow.needs > .k-steprow-main > .k-steprow-body .k-slots.wait { border: 0; border-radius: 0; padding: 0; }
+.k-steprow-body .k-slot-status h2 { color: var(--so-ink); }
+.k-steprow-body .k-slot-acts:empty { display: none; }
+@media (hover: hover) and (pointer: fine) {
+  button.k-steprow-head:hover .k-steprow-say { color: var(--so-ink); }
+}
+
+/* ---------- The work: one agent's work as a chat ---------- */
+.k-work { box-sizing: border-box; display: flex; flex-direction: column; min-width: 0; min-height: 0; background: var(--so-paper); color: var(--so-ink); }
+.k-work[hidden] { display: none; }
+.k-work-head { flex: none; display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 12px 10px 12px 18px; border-bottom: 1px solid var(--so-line); }
+.k-work-title { display: grid; gap: 1px; min-width: 0; }
+.k-work-title h2 { margin: 0; font: 600 14px/1.4 var(--so-font-sans); }
+.k-work-who { display: flex; align-items: center; gap: 6px; min-width: 0; margin: 0; font-size: 12px; line-height: 1.4; color: var(--so-muted); }
+.k-work-who > span:last-child { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.k-work-dot { flex: none; width: 6px; height: 6px; border-radius: 50%; background: var(--so-live); }
+.k-work-body { flex: 1 1 auto; min-height: 0; overflow-y: auto; overscroll-behavior: contain; display: grid; align-content: start; gap: 16px; padding: 18px; }
+.k-work-foot { flex: none; display: grid; gap: 8px; padding: 8px 14px 14px; max-height: min(50%, 420px); overflow-y: auto; overscroll-behavior: contain; }
+.k-work-foot:empty { display: none; }
+.k-work-conv { display: grid; gap: var(--so-space-sm); min-width: 0; }
+.k-work-conv-h { display: flex; justify-content: flex-end; }
+.k-work-conv .k-work-tx { max-height: 60vh; overflow-y: auto; overscroll-behavior: contain; }
+.k-work-tx { min-width: 0; display: grid; gap: 12px; }
+.k-work-empty { margin: 0; padding: var(--so-space-md) 0; font-size: 13px; color: var(--so-muted); }
+.k-work-lines { display: grid; gap: 14px; margin: 0; padding: 0; list-style: none; font-size: 14px; line-height: 1.6; }
+.k-work-say { white-space: pre-wrap; overflow-wrap: anywhere; }
+.k-work-mark { font-size: 12px; color: var(--so-muted); }
+.k-work-steps { display: grid; gap: 2px; margin: 0; padding: 0; list-style: none; font-size: 13px; line-height: 1.5; color: var(--so-muted); }
+.k-work-step-l { display: flex; align-items: center; gap: 10px; min-height: 26px; min-width: 0; }
+.k-work-step.running .k-work-step-l { color: var(--so-ink); }
+.k-work-step-t { flex: 1 1 auto; min-width: 0; overflow-wrap: anywhere; }
+.k-work-step-t .k-mono { font-size: 12px; color: var(--so-ink); }
+.k-work-step-s { flex: none; display: inline-flex; align-items: center; gap: var(--so-space-xs); font-size: 12px; color: var(--so-muted); }
+.k-work-step-s.ok { color: var(--so-done-ink); }
+.k-work-step-s.failed { color: var(--so-fail-ink); }
+.k-work-step-s.running { color: var(--so-live-ink); }
+.k-work-out { max-height: 288px; overflow: auto; margin: 4px 0 6px; padding: var(--so-space-sm) 10px; border-radius: var(--so-radius-md); background: var(--so-code-bg); color: var(--so-ink); font: 12px/1.5 var(--so-font-mono); white-space: pre-wrap; overflow-wrap: anywhere; }
+.k-work-note { display: grid; justify-items: end; gap: 2px; }
+.k-work-bubble { max-width: 82%; margin: 0; padding: 8px 14px; border-radius: 18px; background: var(--so-user-bubble); white-space: pre-wrap; overflow-wrap: anywhere; }
+.k-work-note-s { margin: 0; font-size: 12px; color: var(--so-muted); }
+.k-work-term { display: grid; gap: 2px; margin: 0; padding: 10px var(--so-space-md); list-style: none; border-radius: var(--so-radius-card); background: var(--so-code-bg); color: var(--so-ink); font: 12px/1.45 var(--so-font-mono); white-space: pre-wrap; overflow-wrap: anywhere; }
+.k-work-term-note { color: var(--so-live-ink); }
+.k-work-term-out { display: block; padding-left: var(--so-space-md); }
+.k-work-term-failed { color: var(--so-fail-ink); }
+
 /* ---------- Approval: four fixed slots in every state ---------- */
 .k-slots { border: 1px solid var(--so-line); border-radius: var(--so-radius-card); padding: 16px 18px; display: grid; gap: 10px; background: var(--so-paper); transition: border-color var(--m-slow) var(--m-ease); }
 .k-slots.wait { border-color: var(--so-needs); }
@@ -521,6 +598,21 @@ html:not(.k-js) .k-composer:focus-within, html.k-kbd .k-composer:focus-within {
   .k-card { padding: 12px 16px; }
   .k-step { font-size: 11px; }
   .k-step-s { font-size: 10.5px; white-space: normal; }
+  .k-steprow-head { flex-wrap: wrap; row-gap: 2px; min-height: 44px; padding: 12px 0; }
+  .k-steprow-mark { margin-top: 12px; }
+  .k-steprow::before { top: 36px; }
+  .k-steprow-main { gap: 8px; padding-bottom: 8px; }
+  .k-steprow:is(.needs, .live, .wait, .stuck) .k-steprow-main { padding-bottom: 16px; }
+  /* The label and its time on one line, the sentence under them. */
+  .k-steprow-label { flex: 1 1 auto; order: 0; }
+  .k-steprow-time { order: 1; }
+  button.k-steprow-head::after { order: 2; }
+  .k-steprow-say { order: 3; flex: 1 1 100%; }
+  .k-steprow-say:empty { display: none; }
+  .k-steprow.needs > .k-steprow-main > .k-steprow-body { padding: 14px; }
+  /* An open body takes the whole width under its head; the rail stops at the head. No z-index: one would trap the body's phone dock under the app's. */
+  .k-steprow-body { margin-left: -34px; position: relative; background: var(--so-paper); }
+  .k-steprow-body .k-slot-acts > .k-btn, .k-steprow-body .k-slot-acts > form, .k-steprow-body .k-slot-acts > form > .k-btn { flex: 1 1 100%; width: 100%; }
   .k-doc { padding: 14px 16px 40px; gap: 18px; }
   .k-dh h1 { font-size: 20px; }
   .k-backlink { display: none; }

package/dist/design/kit.d.ts

@@ -10,14 +10,14 @@
 import { type Headline } from "../task-status.js";
 /** The five status words. */
 export type StatusKey = "needs" | "running" | "queued" | "finished" | "failed";
-/** A chip's tone: "" is neutral; "ask" names a specific ask inside a Needs-you group (ink words, amber dot). */
+/** A chip's tone: "" is neutral; "ask" names a specific ask inside a Needs-you group (ink words, ink dot). */
 export type ChipTone = "" | "needs" | "ask" | "live" | "done" | "failed";
 export declare const STATUS: Readonly<Record<StatusKey, {
     word: string;
     tone: ChipTone;
 }>>;
 /** A task's headline (task-status.ts) as the kit's chip: its own word, in the tone of the status it belongs to. A
- * row that waits on a person never shows a failure tone; something that waits on someone else is never amber. */
+ * row that waits on a person never shows a failure tone; something that waits on someone else never carries the needs-you mark. */
 export declare function chipOfHeadline(headline: Headline): {
     word: string;
     tone: ChipTone;
@@ -25,7 +25,7 @@ export declare function chipOfHeadline(headline: Headline): {
 };
 /** Which of the five a headline is. */
 export declare function statusOfHeadline(headline: Headline): StatusKey;
-/** Resource states (a computer that builds, not work): never amber. */
+/** Resource states (a computer that builds, not work): never the needs-you mark. */
 export declare const RESOURCE: Readonly<Record<"idle" | "building" | "offline", {
     word: string;
     tone: ChipTone;
@@ -77,7 +77,15 @@ export declare function timingBars(rows: readonly TimingRow[], scale?: number):
     left: number;
     width: number;
 } | null>;
-/** One step on a progress line: done (a check), now (waits on you: amber), live (running: blue), failed, or to do. */
+/** A step row's marker: done (an ink disc with a check), needs (waits on this person: an ink ring with a dot), live
+ * (runs now: blue), wait (current, waiting on nothing this person does), stuck (stopped there: vermilion), skipped (a
+ * dashed ring), todo (not reached: a grey ring). */
+export type StepRowMark = "done" | "needs" | "live" | "wait" | "stuck" | "skipped" | "todo";
+/** The words a screen reader hears for a step row's marker. */
+export declare const STEP_ROW_WORDS: Readonly<Record<StepRowMark, string>>;
+/** The id of a step row's body, for its disclosure's aria-controls. */
+export declare const stepRowBodyId: (key: string) => string;
+/** One step on a progress line: done (a check), now (waits on you: ink), live (running: blue), failed, or to do. */
 export type StepState = "done" | "now" | "live" | "failed" | "todo";
 export type StepItem = {
     label: string;

package/dist/design/kit.js

@@ -16,7 +16,7 @@ export const STATUS = {
     failed: { word: "Failed", tone: "failed" },
 };
 /** A task's headline (task-status.ts) as the kit's chip: its own word, in the tone of the status it belongs to. A
- * row that waits on a person never shows a failure tone; something that waits on someone else is never amber. */
+ * row that waits on a person never shows a failure tone; something that waits on someone else never carries the needs-you mark. */
 export function chipOfHeadline(headline) {
     const status = statusOfHeadline(headline);
     return { word: headline === "Needs you" ? STATUS.needs.word : headline, tone: STATUS[status].tone, status };
@@ -32,7 +32,7 @@ export function statusOfHeadline(headline) {
         case "neutral": return "queued";
     }
 }
-/** Resource states (a computer that builds, not work): never amber. */
+/** Resource states (a computer that builds, not work): never the needs-you mark. */
 export const RESOURCE = {
     idle: { word: "Idle", tone: "" },
     building: { word: "Building", tone: "live" },
@@ -100,6 +100,12 @@ export function timingBars(rows, scale) {
     const sc = scale ?? Math.max(1, ...rows.map(row => row.start + (row.st === "q" ? 0 : row.dur))) * 1.02;
     return rows.map(row => row.st === "q" ? null : { left: (Math.max(0, row.start) / sc) * 100, width: (Math.max(row.dur, sc / 400) / sc) * 100 });
 }
+/** The words a screen reader hears for a step row's marker. */
+export const STEP_ROW_WORDS = {
+    done: "done", needs: "waiting on you", live: "in progress", wait: "waiting", stuck: "stopped here", skipped: "skipped", todo: "not started",
+};
+/** The id of a step row's body, for its disclosure's aria-controls. */
+export const stepRowBodyId = (key) => `steprow-${key}`;
 /** The words a screen reader hears for a step's state. */
 export const STEP_WORDS = { done: "done", now: "waiting on you", live: "in progress", failed: "failed", todo: "not started" };
 /** How far the line is filled, 0–1: up to the current step (the first that isn't done), or all of it. */

package/dist/design/tokens.css

@@ -41,10 +41,10 @@
   --so-nav-hover: #e4e4e4;
   /* Nav Ink: idle sidebar rows and their hover fill on the frame. */
   --so-nav-ink: #525252;
-  /* Needs You Amber: what waits on this person, and nothing else (the Needs-you chip's dot, a waiting box's outline, the dock's dot). Never a warning, quota, link or decoration. */
-  --so-needs: var(--so-warning);
-  /* The wash behind a Needs-you chip. */
-  --so-needs-soft: var(--so-warning-soft);
+  /* Ink accent: the default accent, used for what waits on a person. */
+  --so-needs: var(--so-signal);
+  /* Ink wash: the fill behind attention badge text and the 3px focus halo around a focused field or composer — one step stronger than the neutral badge fill, so a waiting badge still reads first. */
+  --so-needs-soft: var(--so-signal-soft);
   --so-neutral-ink: #525252;
   /* Neutral Badge: the badge for anything that is a fact and not a claim on the person, such as queued, running or built today in a project peek, or a count in a fold. */
   --so-neutral-soft: #f0f0f0;
@@ -156,7 +156,7 @@
   --so-typography-title-sm-letter-spacing: -0.14px;
   --so-typography-title-sm-line-height: 1.3;
   --so-user-bubble: #f2f2f2;
-  /* Amber: setup trouble and caution. */
+  /* The terminal's yellow only. Pages never use it: cautions are neutral ink. */
   --so-warning: #ab6400;
   --so-warning-soft: #fff4d5;
 }

package/dist/desktop-update.d.ts

@@ -97,13 +97,13 @@ export declare function sqliteLock(file: string, busyTimeoutMs?: number): Databa
 export declare function lockHeld(file: string): boolean;
 export declare const installationLock: (j: UpdateJournal) => DatabaseSync | null;
 export declare function desktopUpdateStatus(stateDir: string): {
-    error?: never;
     active: boolean;
     phase: string;
     detail: string;
     running: boolean;
     canResume: boolean;
     canCancel: boolean;
+    error?: never;
     automaticRecovery?: never;
     recoveryAttempts?: never;
     recoveryRepairs?: never;

package/dist/discord-chat.js

@@ -7,7 +7,7 @@ import { cardWithin } from "./chat-card.js";
 import { chatFlowButtons } from "./chat-flow.js";
 import { refuseResultShots, resultShotsPruned, shotWaitsUntil } from "./result-shots.js";
 import { admitChatEvent } from "./chat-admission.js";
-import { ChatState, ChatDeliveryError, chatHash, partContent, } from "./chat-delivery-state.js";
+import { ChatState, ChatDeliveryError, chatHash, chatRetryAt, partContent, } from "./chat-delivery-state.js";
 import { readChatPart } from "./contracts/chat-content.js";
 import { readDiscordButtonToken, readDiscordComponentInteraction } from "./contracts/discord-callback.js";
 import { processChatEvent, planChatNotifications, channelAccess, chatObject as object, planRoomMessages, heldForWatch, } from "./chat-delivery.js";
@@ -418,8 +418,7 @@ export async function deliverDiscordPart(options) {
         const problem = error instanceof ChatDeliveryError
             ? error
             : new DiscordError("Discord delivery is waiting to retry", 15_000, true);
-        const until = new Date((options.clock?.() ?? new Date()).getTime() +
-            Math.max(problem.retryMs, [5000, 15000, 60000, 300000][Math.min(row.attempts, 3)])).toISOString();
+        const until = chatRetryAt(options.clock?.() ?? new Date(), problem.retryMs, row.attempts);
         state.partFailed(row.id, { problem: problem.message, until, uncertain: problem.uncertain });
         state.setProblem(identity.installation, options.owner, problem.code === "ratelimited" ? "Discord asked us to wait. Saved replies will retry." : problem.message);
         if (problem.code === "ratelimited")

package/dist/dispatch.js

@@ -19,6 +19,7 @@ import { failedAttemptSentence, latestFinishedAttempt } from "./needs-you.js";
 import { buildReviewOf } from "./review-switch.js";
 import { vanishedStopOf, vanishedStopSentence } from "./vanished-retry.js";
 import { routeChangeOf } from "./route-change.js";
+import { wasInterrupted } from "./run-ending.js";
 import { BUILT_IN, refArchived, parseCapabilityKey } from "./store.js";
 import { shortWhen } from "./when-html.js";
 export const DEFAULT_MAX_OPEN_DECISIONS = 5;
@@ -157,7 +158,7 @@ function reviewViewOf(sourceRun, retry) {
         retriesRemaining: retry.retriesRemaining,
         latestRun: retry.latest?.runId ?? null,
         latestReason: retry.latest?.reason ?? null,
-        interrupted: retry.latest !== null && (retry.latest.outcome === "interrupted" || retry.latest.reason === "interrupted"),
+        interrupted: retry.latest !== null && wasInterrupted(retry.latest),
         queued: retry.openRequest === null ? null : { requestedBy: retry.openRequest.requestedBy, origin: retry.openRequest.origin },
     };
 }

package/dist/dispose.d.ts

@@ -1,7 +1,7 @@
 import { STORAGE_HOLD_PREFIX } from "./needs-you.js";
 import { type FailureClass } from "./claim.js";
 import type { BuildResult } from "./builder.js";
-import type { Store } from "./store.js";
+import type { ClosedState, Store } from "./store.js";
 import { type ProofVerdict } from "./proof.js";
 /**
  * Which road is disposing. 'tick' = the unattended loop: full task
@@ -59,6 +59,9 @@ export type Disposition = {
     disposition: string | null;
     strikes: number | null;
     sealed: boolean;
+    /** The state sealed when strikes ran out on a task a person had already closed (disposition "closed"): it is
+     * kept, with no incident, hold or page. Null for every other ending. */
+    closedState: ClosedState | null;
 }
 /** The standalone road's simple record: outcome written, nothing else. */
  | {

package/dist/dispose.js

@@ -316,7 +316,7 @@ function disposeBuildOutcomeLocked(context, result) {
         }
         if (leaseId === undefined) {
             store.finishRun(runId, { outcome: "failed", reason: result.reason, now: clock() });
-            return { kind: "failed", failureClass, disposition: null, strikes: null, sealed: false };
+            return { kind: "failed", failureClass, disposition: null, strikes: null, sealed: false, closedState: null };
         }
         const sealed = finalize(store, leaseId, {
             kind: "failure",
@@ -333,6 +333,7 @@ function disposeBuildOutcomeLocked(context, result) {
             disposition: sealed.ok ? sealed.disposition : null,
             strikes: sealed.ok && "strikes" in sealed ? sealed.strikes : null,
             sealed: sealed.ok,
+            closedState: sealed.ok && sealed.disposition === "closed" ? sealed.state : null,
         };
     }
     if (result.reason === "protected-storage") {

package/dist/fallback.js

@@ -22,6 +22,7 @@ import { isProviderId, validateSpec } from "./provider.js";
 import { providerName } from "./provider-auth.js";
 import { PLAN_LOGIN_PROVABLE } from "./plan-login.js";
 import { canonicalChainJson, chainDigestOf, LIVE_CHAIN_VERSION, liveChainFromJson, machineActing, profileDigestOf } from "./scope.js";
+import { moveTask } from "./task-moves.js";
 export const MAX_FALLBACK_ENTRIES = 3;
 const tablesSeen = new WeakSet();
 function hasTables(store) {
@@ -516,7 +517,7 @@ export function blockAfterSignedOut(store, runId, now) {
         store.handle.prepare("UPDATE run SET reason = 'fallback-signed-out' WHERE id = ? AND outcome = 'refused'").run(runId);
         const ref = store.refForId(run.taskRef);
         if (ref !== null)
-            store.handle.prepare("UPDATE task SET state = 'failed', updated_at = ? WHERE id = ? AND state IN ('queued','running')").run(now.toISOString(), ref.externalId);
+            moveTask(store.handle, ref.externalId, "giveUp", now);
         return true;
     });
 }
@@ -568,7 +569,7 @@ export function moveOnIfExhausted(store, runId, taskId, now) {
     store.handle.prepare("INSERT INTO fallback_move (walk, to_index, from_run, terminal_class, paid, moved_at) VALUES (?, ?, ?, ?, ?, ?)")
         .run(walk.id, run.chainIndex + 1, run.id, evidence.terminalClass, paid ? 1 : 0, now.toISOString());
     store.handle.prepare("UPDATE fallback_walk SET cursor = ? WHERE id = ?").run(run.chainIndex + 1, walk.id);
-    store.handle.prepare("UPDATE task SET state = 'queued', updated_at = ? WHERE id = ? AND state = 'running'").run(now.toISOString(), taskId);
+    moveTask(store.handle, taskId, "requeue", now);
     store.recordAction({ at: now.toISOString(), actor: "toolroll", repo: store.refForId(run.taskRef)?.repo ?? null, taskId, runId: run.id, action: "work moved to fallback agent", outcome: paid ? "paid" : "plan", source: "work", detail: entryWords(to) });
     tell(store, run, taskId, "moved", to, now);
     store.bumpWake();

package/dist/fast-start.js

@@ -31,7 +31,7 @@ import { fileTaskProposal } from "./proposal.js";
 import { releaseCiHoldOf } from "./release-ci-hold.js";
 import { COMPLETION_ACTION, COMPLETION_BY_PERSON } from "./result-completion.js";
 import { deployGateScope, machineActing, propose, releaseCheckScope } from "./scope.js";
-import { BUILT_IN } from "./store.js";
+import { BUILT_IN, withdrawApproval } from "./store.js";
 import { classifyTask, filingSizer, heuristicSizing } from "./task-sizing.js";
 import { issueImported } from "./task-source.js";
 import { titleWithin } from "./task-text.js";
@@ -295,7 +295,7 @@ export function expireFastStarts(store, now) {
         store.transact(() => {
             if (store.currentLiveLease(ref, now) !== null)
                 return;
-            store.handle.prepare(`UPDATE task_scope SET approved_at = NULL, approved_by = NULL, approved_digest = NULL, approved_profile_json = NULL, approved_route_json = NULL, approval_basis = NULL WHERE task_id = ?`).run(task);
+            withdrawApproval(store, { where: "WHERE task_id = ?", args: [task] }, { basisAfter: null, clearRoute: true, clearModeDigest: false });
             store.handle.prepare("UPDATE task_ref SET fast_start_until = NULL WHERE id = ?").run(ref);
             store.recordAction({ at: stamp, actor: "system", repo: row["repo"] === null ? null : String(row["repo"]), taskId: task, runId: null, action: "fast start expired", outcome: "seal cleared", source: "work", detail: `no build started within ${FAST_WINDOW_MS / 60_000} minutes` });
             cleared++;

package/dist/first-run.d.ts

@@ -76,20 +76,24 @@ export declare const TODO_GREP_ARGS: readonly string[];
 export declare function findFirstTasks(repo: string, runner?: Runner): Promise<FirstTaskSuggestion[]>;
 /** "First result in 7 min": how long after the installation began its first Ready result arrived. */
 export declare function firstResultWords(since: string, at: string): string | null;
-/** The first task's five steps, as a person reads them. */
-export declare const JOURNEY_STEPS: readonly [readonly ["plan", "Plan"], readonly ["approve", "You approve"], readonly ["build", "Build"], readonly ["checks", "Checks"], readonly ["ready", "Ready"]];
+/** A task's five steps, as a person reads them: the one label set the task page's rows, chat's first-task journey and
+ * the progress line all read. */
+export declare const JOURNEY_STEPS: readonly [readonly ["plan", "Plan"], readonly ["approve", "Approval"], readonly ["build", "Build"], readonly ["checks", "Checks"], readonly ["ready", "Ready"]];
 export type JourneyKey = (typeof JOURNEY_STEPS)[number][0];
 /** `stuck`: the step it stopped at (Failed, Stopped, or waiting on something other than the approval). */
 /** `skipped`: a stage the task went past without it happening (its checks didn't run or couldn't be read). `needsYou`:
- * the current or stuck step waits on a person, so it is the one step drawn amber. */
+ * the current or stuck step waits on a person, so it is the one step drawn in the needs-you ink. */
+/** `say`: what the step's state means when its label alone doesn't say it ("Checks failed", "Checks not run"); the
+ * label is always the step's own name from JOURNEY_STEPS. */
 export type JourneyStep = {
     key: JourneyKey;
     label: string;
     state: "done" | "current" | "stuck" | "skipped" | "todo";
     needsYou?: true;
+    say?: string;
 };
 /**
- * Where the first task stands on Plan → You approve → Build → Checks → Ready, from the one stage every surface reads
+ * Where the first task stands on Plan → Approval → Build → Checks → Ready, from the one stage every surface reads
  * (task-status.ts). Waiting for a worker before approval is still the plan; after approval it is the build. `built`:
  * the build finished with a result.
  */
@@ -101,8 +105,8 @@ export declare function firstTaskJourney(read: {
  * nothing says (the step is then shown skipped, never done). The road reads this one answer, never a row's words. */
 export type RoadChecks = "passed" | "running" | "failed" | "not-run" | "off" | "unreadable" | null;
 /**
- * Any task's road (the read-only stepper on its page, after ReUI's Stepper): the first task's five steps, told only
- * from recorded facts. You approve is done only when the plan was approved (a rewritten plan waiting on approval
+ * Any task's road (the step rows on its page): the first task's five steps, told only
+ * from recorded facts. Approval is done only when the plan was approved (a rewritten plan waiting on approval
  * stands there again); a task that never needed one shows it skipped. Checks is done only when the approved check
  * passed; a running, missing or Off check says so, and with no checks fact it is skipped. A failed check, or one that
  * can't be read, stops the road at Checks: Ready isn't done (fail closed), even on a task a person marked complete.

package/dist/first-run.js

@@ -133,10 +133,11 @@ export function firstResultWords(since, at) {
     }
     return `First result in ${Math.round(minutes / (24 * 60))} days`;
 }
-/** The first task's five steps, as a person reads them. */
-export const JOURNEY_STEPS = [["plan", "Plan"], ["approve", "You approve"], ["build", "Build"], ["checks", "Checks"], ["ready", "Ready"]];
+/** A task's five steps, as a person reads them: the one label set the task page's rows, chat's first-task journey and
+ * the progress line all read. */
+export const JOURNEY_STEPS = [["plan", "Plan"], ["approve", "Approval"], ["build", "Build"], ["checks", "Checks"], ["ready", "Ready"]];
 /**
- * Where the first task stands on Plan → You approve → Build → Checks → Ready, from the one stage every surface reads
+ * Where the first task stands on Plan → Approval → Build → Checks → Ready, from the one stage every surface reads
  * (task-status.ts). Waiting for a worker before approval is still the plan; after approval it is the build. `built`:
  * the build finished with a result.
  */
@@ -155,8 +156,8 @@ export function firstTaskJourney(read, approved, built = false) {
         state: index < at.index ? "done" : index === at.index ? (at.stuck ? "stuck" : "current") : "todo" }));
 }
 /**
- * Any task's road (the read-only stepper on its page, after ReUI's Stepper): the first task's five steps, told only
- * from recorded facts. You approve is done only when the plan was approved (a rewritten plan waiting on approval
+ * Any task's road (the step rows on its page): the first task's five steps, told only
+ * from recorded facts. Approval is done only when the plan was approved (a rewritten plan waiting on approval
  * stands there again); a task that never needed one shows it skipped. Checks is done only when the approved check
  * passed; a running, missing or Off check says so, and with no checks fact it is skipped. A failed check, or one that
  * can't be read, stops the road at Checks: Ready isn't done (fail closed), even on a task a person marked complete.
@@ -181,13 +182,13 @@ export function taskRoad(read, approved, built, facts) {
                     return { ...step, state: "done" };
                 case "not-run":
                     waitsAtReady = true;
-                    return { ...step, state: "skipped", label: "Checks not run" };
+                    return { ...step, state: "skipped", say: "Checks not run" };
                 case "off":
                     waitsAtReady = true;
-                    return { ...step, state: "skipped", label: "Checks at release" };
-                case "running": return { ...step, state: "current", label: "Checks running" };
-                case "failed": return { ...step, label: "Checks failed" };
-                case "unreadable": return { ...step, label: "Checks unreadable" };
+                    return { ...step, state: "skipped", say: "Checks at release" };
+                case "running": return { ...step, state: "current", say: "Checks running" };
+                case "failed": return { ...step, say: "Checks failed" };
+                case "unreadable": return { ...step, say: "Checks unreadable" };
                 default: return step;
             }
         }
@@ -195,16 +196,16 @@ export function taskRoad(read, approved, built, facts) {
             return step;
         // At Checks now: only a recorded failure, an unreadable check or a running check changes how it reads.
         if (step.state === "current")
-            return facts.checks === "failed" ? { ...step, state: "stuck", label: "Checks failed" }
-                : facts.checks === "unreadable" ? { ...step, state: "stuck", label: "Checks unreadable" }
-                    : facts.checks === "running" ? { ...step, label: "Checks running" } : step;
+            return facts.checks === "failed" ? { ...step, state: "stuck", say: "Checks failed" }
+                : facts.checks === "unreadable" ? { ...step, state: "stuck", say: "Checks unreadable" }
+                    : facts.checks === "running" ? { ...step, say: "Checks running" } : step;
         switch (facts.checks ?? null) {
             case "passed": return step;
-            case "running": return { ...step, state: "current", label: "Checks running" };
-            case "failed": return { ...step, state: "stuck", label: "Checks failed" };
-            case "not-run": return { ...step, state: "skipped", label: "Checks not run" };
-            case "off": return { ...step, state: "skipped", label: "Checks at release" };
-            case "unreadable": return { ...step, state: "stuck", label: "Checks unreadable", ...(complete ? {} : { needsYou: true }) };
+            case "running": return { ...step, state: "current", say: "Checks running" };
+            case "failed": return { ...step, state: "stuck", say: "Checks failed" };
+            case "not-run": return { ...step, state: "skipped", say: "Checks not run" };
+            case "off": return { ...step, state: "skipped", say: "Checks at release" };
+            case "unreadable": return { ...step, state: "stuck", say: "Checks unreadable", ...(complete ? {} : { needsYou: true }) };
             default: return { ...step, state: "skipped" };
         }
     });

package/dist/guides.js

@@ -335,7 +335,7 @@ ${AUTHORITY_LINE}
 - The rail is four rows — inbox · board · builds · projects — and a
   **more** group: portfolio, task list, fleet, system,
   requirements, people, operating mode, settings. On a phone the same
-  five sit in the tab bar and more is \`/menu\`. Amber appears only on
+  five sit in the tab bar and more is \`/menu\`. The needs-you mark appears only on
   what needs a person: the inbox count and the one act that resolves a
   screen (approve, answer, retry).
 

package/dist/monitoring.js

@@ -19,6 +19,7 @@ import { createHash, createHmac, randomUUID } from "node:crypto";
 import { closeSync, constants, fsyncSync, lstatSync, mkdirSync, openSync, readFileSync, writeSync } from "node:fs";
 import { hostname } from "node:os";
 import { basename, join } from "node:path";
+import { wasInterrupted } from "./run-ending.js";
 import { COMPLETION_ACTION } from "./result-completion.js";
 export const SIGNATURE_HEADER = "x-standing-orders-signature";
 const BATCH = 200;
@@ -164,7 +165,7 @@ export function spansFor(store, entries) {
                 continue;
             const root = rootOf(taskId);
             const ref = store.refForId(run.taskRef);
-            const failed = run.outcome === "failed" || run.outcome === "refused" || run.outcome === "interrupted";
+            const failed = run.outcome === "failed" || run.outcome === "refused" || wasInterrupted(run);
             spans.push({
                 traceId: hex(`standing-orders/trace/${root}`, 32), spanId: hex(`standing-orders/run/${run.id}`, 16), parentSpanId: hex(`standing-orders/task/${root}`, 16),
                 name: `${run.role} · ${run.provider}`, kind: 1, startTimeUnixNano: nanos(run.startedAt), endTimeUnixNano: nanos(run.finishedAt),