toolroll 0.9.100 → 0.9.102

package/dist/browser-workspace.d.ts

@@ -8,7 +8,8 @@ import type { AssignmentSnapshot } from './assignment.js';
 export { browserCrewFromIndex, browserWorkActionHref } from './browser-crew.js';
 import type { Store } from './store.js';
 import type { WorkSummaryAccess } from './work-summary.js';
-import type { StatusTone } from './workspace-ui.js';
+import type { StatusTone, StepRow } from './workspace-ui.js';
+import type { PageWork } from './page-work-contract.js';
 import type { Ask, AskChip } from './needs-you.js';
 import type { WorkIndexGroup } from './work-index.js';
 import type { AssignmentCard } from './assignment-ui.js';
@@ -414,6 +415,24 @@ export type BrowserTaskView = {
             line: string;
             action: BrowserLink | null;
         } | null;
+        /** The plan's steps and where each stands, from the latest checkpoint (all pending before the first). */
+        steps?: {
+            title: string;
+            state: "pending" | "current" | "completed" | "blocked";
+        }[];
+    } | null;
+    /** The Plan row: the plan's lead sentence, who wrote it and when, and its body (the plan sheet and the plan's editor;
+     * only the editor while the approval shows the sheet). `planning`: a planner is writing it now. Null: no plan yet.
+     * `key` names what the body holds (the editor alone, or the sheet of one exact plan): the page installs the body once
+     * and again when the key changes. */
+    plan?: {
+        lead: string | null;
+        by: string | null;
+        at: string | null;
+        html: string;
+        planning: boolean;
+        updating?: boolean;
+        key: string;
     } | null;
     /** What the agent did last on the live run, and when; the page words it against its own clock (activity-line.ts). */
     activity?: RunActivity | null;
@@ -422,6 +441,14 @@ export type BrowserTaskView = {
         room: string;
         at: string | null;
     } | null;
+    /** The work panel's run (docs/plans/task-page-steps.md "Watch the work"): the live build, else the latest one, who ran it,
+     * and its records window on the run page (null on a page that asks for a password). Null: no build yet. */
+    work?: {
+        run: number;
+        live: boolean;
+        agent: string;
+        transcript: string | null;
+    } | null;
     /** Stop, on the Building card: the exact live build's stop form (posts its run id). */
     stop?: {
         action: string;
@@ -460,9 +487,12 @@ export type BrowserTaskView = {
         }[];
     } | null;
     /** Server cards that may need a person now (stop/resume, scope prompt, plan, live attempt). */
+    /** `instance`: what the block is about now (the attempt card: its build). The page installs a block's HTML once;
+     * another instance replaces it. */
     lead: {
         key: string;
         html: string;
+        instance?: string;
     }[];
     questions: string;
     facts: BrowserTaskFact[];
@@ -478,8 +508,11 @@ export type BrowserTaskView = {
         href: string;
         starter: string;
     } | null;
-    /** Until the first Ready result: Plan → You approve → Build → Checks → Ready, filled in as it moves. */
+    /** The task's road, Plan → Approval → Build → Checks → Ready (four for a report), from recorded facts. */
     journey?: JourneyStep[] | null;
+    /** The page's step rows (workspace-ui.ts stepRowsOf over this view, after every change the server made to it): the
+     * steps are the page. Null: no road (cancelled, or no status), so the page keeps its status block. */
+    steps?: StepRow[] | null;
     /** The thread's server-side entries; the conversation's messages join them in time order. */
     thread?: BrowserTaskThreadItem[];
     details?: BrowserTaskDetailGroup[];
@@ -520,6 +553,8 @@ export type BrowserTaskView = {
         /** When a remembered password stops counting (ISO); the page words it in the viewer's zone. */
         rememberedUntil: string | null;
         planHtml: string;
+        /** The plan sheet alone (no editor, no form): what Home shows beside its Approve (live-pages-and-home.md B2.1). */
+        sheetHtml?: string;
         /** The terms line in words, when the rule isn't one of the kit's (easy-start C5: a laptop's own owner). */
         termsWords?: string;
     } | null;
@@ -1584,6 +1619,15 @@ export type BrowserWorkspace = {
     user: string;
     csrf: string;
     sensitive: boolean;
+    /** True when this page may replace another without a document load (docs/plans/live-pages-and-home.md A1.1): the server
+     * sets it on every workspace it sends; absent (an older server, a fixture) is false. */
+    inPlace?: boolean;
+    /** What the app runs for this page in place of a page script (docs/plans/task-page-in-app.md): data, a closed list.
+     * Present only when the app covers the page's whole script; the document then ships no page script string. */
+    work?: readonly PageWork[];
+    /** This document ships a page script string (set on a document load only). Its listeners live as long as the
+     * document, so the app never changes pages in place from it, and never runs `work` in it. */
+    scripted?: boolean;
     /** Passwordless is on for this signed-in browser: ceremony password fields are left out (docs/plans/passwordless.md). */
     passwordless?: boolean;
     /** The session's open project (its path), or null: the sidebar's project picker names it. */
@@ -1659,13 +1703,14 @@ export type BrowserWorkspace = {
         command: string;
     };
 };
-/** Home ("/"): one sentence that answers "what needs me?", four counts that agree with the Tasks filters they open,
- * the work grouped as Waiting on you, Working and Done, and the selected item answered in place. */
+/** Home ("/", docs/plans/live-pages-and-home.md B1): the heading said once, one quiet line for what runs and waits, what
+ * needs this person grouped by what is asked (each group with its exact count), the selected one open beside the list,
+ * and the lead's last message above the message box. With nothing waiting: what runs and what finished today. */
 export type BrowserHomeView = {
     kind: 'home';
-    /** "7 need you across 2 projects.", derived from the same counts as the figures. */
+    /** "19 tasks need you", "Nothing needs you", read from the same total as the rail's count. */
     say: string;
-    /** The project in view (a path) or every project (null), and the scope links (null with one project). */
+    /** The project in view (a path) or every project (null), and the project filter's choices (null with one project). */
     project: string | null;
     scopes: {
         key: string;
@@ -1673,29 +1718,42 @@ export type BrowserHomeView = {
         href: string;
         active: boolean;
     }[] | null;
+    /** The work index totals, each with the Tasks list it opens. */
     counts: {
         key: 'needs' | 'running' | 'queued' | 'finished';
         label: string;
         value: number;
         href: string;
     }[];
-    /** The work in three groups, in this order (home-groups.ts): Waiting on you, Working, Done (finished in the last 7 days). */
+    /** What needs you, by what is asked, in this order: approve, answer, wrong, review, other (anything none of the four
+     * fits). `count` is the exact total for that ask, past the rows listed. */
     groups: {
-        key: 'you' | 'working' | 'done';
+        key: BrowserHomeAsk;
         label: string;
+        count: number;
         rows: BrowserHomeRow[];
     }[];
-    /** More waits on you than the list shows: open them all in Tasks. */
-    more: {
+    /** What runs, then what waits its turn. */
+    working: BrowserHomeRow[];
+    /** What was completed today: the exact figure, the newest rows, and the list that has them all. */
+    finishedToday: {
         count: number;
+        rows: BrowserHomeRow[];
         href: string;
-    } | null;
+    };
     newTask: string;
     /** The lead's message box, where chat is allowed for this person: a POST to /chat in this scope. */
     ask: {
         project: string | null;
         placeholder: string;
     } | null;
+    /** The lead's last message in this person's main thread, as one plain line that opens the chat; null when there is
+     * none or this person may not read that thread. */
+    lastLead: {
+        text: string;
+        age: string;
+        href: string;
+    } | null;
     empty: {
         title: string;
         text: string;
@@ -1703,16 +1761,20 @@ export type BrowserHomeView = {
     /** While the first run is open (no first result yet): the welcome's address, linked as Finish setup. */
     setup?: string | null;
 };
+/** What a waiting row asks (work-index.ts WorkAskGroup). */
+export type BrowserHomeAsk = 'approve' | 'answer' | 'wrong' | 'review' | 'other';
 export type BrowserHomeRow = {
     id: string;
     title: string;
     href: string;
     project: string | null;
     age: string;
-    chip: {
-        word: string;
-        tone: '' | 'needs' | 'ask' | 'live' | 'done' | 'failed';
-    };
+    /** Which list it is in: it needs you, it runs, it waits its turn, or it finished. */
+    state: 'needs' | 'running' | 'queued' | 'done';
+    /** What it asks of you (its group), or null when it doesn't wait on you. */
+    ask: BrowserHomeAsk | null;
+    /** Why, in one short line: only a row where something went wrong. */
+    reason: string | null;
     /** One line: what it asks, or what the agent is doing now. */
     line: string | null;
     /** The one act that resolves it (a link), or null. */
@@ -1904,3 +1966,4 @@ export type MergeReadyView = {
         act: MergeReadyAct | null;
     }[];
 };
+export type { PageWork } from './page-work-contract.js';

package/dist/browser-workspace.js

@@ -97,11 +97,13 @@ export function browserProjectsOf(projects) {
 export function browserNavigationOf(path, project = null, needsYou = 0, tasksProject = project, needsYouLabel) {
     const pathname = path.split('?')[0].split('#')[0];
     const under = (...roots) => roots.some(root => pathname === root || pathname.startsWith(`${root}/`));
-    // The rail (UI revamp, wave B): Home carries the one Needs-you count; the lead chat and an agent's question live
-    // under Home, a task's pages under Tasks, every computer and terminal under Agents, every setting under Settings.
+    // The rail (UI revamp, wave B; Chat under Home, live-pages-and-home.md B1): Home carries the one Needs-you count and
+    // an agent's question lives under it; the lead chat is its own item; a task's pages under Tasks, every computer and
+    // terminal under Agents, every setting under Settings.
     return [
-        { label: 'Home', href: '/', active: pathname === '/' || pathname === '/chat' || under('/d', '/activity', '/morning'),
+        { label: 'Home', href: '/', active: pathname === '/' || under('/d', '/activity', '/morning'),
             ...(needsYou > 0 ? { count: needsYou, ...(needsYouLabel === undefined ? {} : { countLabel: needsYouLabel }) } : {}) },
+        { label: 'Chat', href: '/chat', active: under('/chat') },
         { label: 'Tasks', href: `/tasks${tasksProject === null ? '' : `?project=${encodeURIComponent(tasksProject)}`}`,
             active: under('/tasks', '/t', '/r', '/review') },
         { label: 'Flows', href: '/flows', active: under('/flows', '/recipes', '/kits', '/routines') },

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/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/operate.js

@@ -10531,6 +10531,8 @@ function describeApproveFailure(reason, id) {
         return "only a person can approve this — approve it on the task page or from your paired chat";
     if (reason === "archived")
         return `${id} is put away — restore it with \`toolroll task restore ${id}\` first`;
+    if (reason === "cancelled")
+        return `${id} was cancelled, so there is nothing to approve`;
     if (reason === "second-approver")
         return `your approval of ${id} is recorded; it is protected work, so a second person needs to approve it (toolroll task approve ${id} as them)`;
     if (reason === "no-approvers") {

package/dist/page-work-contract.d.ts

@@ -0,0 +1,21 @@
+/**
+ * One behaviour the app runs for the page on screen instead of a page script string (docs/plans/task-page-in-app.md).
+ * `answer`: a question's inline answer (render-tasks.ts decisionAnswerScript). `region`: a server-drawn region kept
+ * current from a build's own fragment (chrome.ts regionScript), `/r/<run>?fragment=check|peek`. `result`: reviewing the
+ * result the page shows (result-review.ts RESULT_REVIEW_SCRIPT with render-results.ts reviewEvidenceScript). No code,
+ * selector or address travels here: the app runs only the kinds it knows.
+ */
+export type PageWork = {
+    kind: "answer";
+} | {
+    kind: "result";
+} | {
+    kind: "region";
+    region: "check-progress" | "run-peek";
+    run: number;
+};
+/** The work the app and the server agree on. A workspace read says it with `x-toolroll-work`; a reader that does not
+ * say exactly this version (an older tab) gets the page as a document with its script string, as before. A hint, never
+ * authority. It moves whenever a kind is added: 2 added `result`. */
+export declare const PAGE_WORK_VERSION = 2;
+export declare const PAGE_WORK_HEADER = "x-toolroll-work";

package/dist/page-work-contract.js

@@ -0,0 +1,5 @@
+/** The work the app and the server agree on. A workspace read says it with `x-toolroll-work`; a reader that does not
+ * say exactly this version (an older tab) gets the page as a document with its script string, as before. A hint, never
+ * authority. It moves whenever a kind is added: 2 added `result`. */
+export const PAGE_WORK_VERSION = 2;
+export const PAGE_WORK_HEADER = "x-toolroll-work";