toolroll 0.9.100 → 0.9.102

package/dist/project-knowledge.d.ts

@@ -22,18 +22,19 @@ export type KnowledgeView = ReturnType<typeof knowledgeView>;
 export declare function knowledgeVersion(store: Store, repo: string, actor: string, revision: number): Knowledge;
 /** Chat reads only an admitted project. Keep the full source in the project UI. */
 export declare function conversationKnowledge(store: Store, repo: string, actor: string, reference?: string, decision?: number): {
+    title?: never;
+    content?: never;
     history?: never;
     revision: number;
     stale: boolean;
     notice: string;
-    title?: never;
-    content?: never;
     instructions?: never;
     references?: never;
     decisions?: never;
     waiting?: never;
 } | {
-    revision?: never;
+    title?: never;
+    content?: never;
     history?: never;
     stale?: never;
     decision: {
@@ -52,8 +53,7 @@ export declare function conversationKnowledge(store: Store, repo: string, actor:
     };
     afterwards?: string;
     notice: string;
-    title?: never;
-    content?: never;
+    revision?: never;
     instructions?: never;
     references?: never;
     decisions?: never;
@@ -70,9 +70,9 @@ export declare function conversationKnowledge(store: Store, repo: string, actor:
     decisions?: never;
     waiting?: never;
 } | {
-    stale?: never;
     title?: never;
     content?: never;
+    stale?: never;
     revision: number;
     history: {
         revision: number;

package/dist/run-efficiency.d.ts

@@ -68,6 +68,7 @@ export declare function deriveRunEfficiency(run: Run & {
 }, evidenceRoot: string, now: Date, commands?: boolean): RunEfficiency;
 /**
  * A finished run's How it ran: the saved one when it was derived by this version, else derived now and saved (once:
- * a row whose steps were complete or have expired is final). An unfinished run is derived but never saved.
+ * a row whose steps were complete or have expired is final). An unfinished run is derived but never saved, and
+ * nothing is saved when `save` is false (a page read ahead of its link writes nothing).
  */
-export declare function runEfficiencyOf(store: Store, evidenceRoot: string, runId: number, now: Date): RunEfficiency | null;
+export declare function runEfficiencyOf(store: Store, evidenceRoot: string, runId: number, now: Date, save?: boolean): RunEfficiency | null;

package/dist/run-efficiency.js

@@ -199,9 +199,10 @@ export function deriveRunEfficiency(run, evidenceRoot, now, commands = false) {
 }
 /**
  * A finished run's How it ran: the saved one when it was derived by this version, else derived now and saved (once:
- * a row whose steps were complete or have expired is final). An unfinished run is derived but never saved.
+ * a row whose steps were complete or have expired is final). An unfinished run is derived but never saved, and
+ * nothing is saved when `save` is false (a page read ahead of its link writes nothing).
  */
-export function runEfficiencyOf(store, evidenceRoot, runId, now) {
+export function runEfficiencyOf(store, evidenceRoot, runId, now, save = true) {
     const run = store.getRun(runId);
     if (run === null)
         return null;
@@ -227,7 +228,7 @@ export function runEfficiencyOf(store, evidenceRoot, runId, now) {
     const payload = JSON.stringify(derived);
     // A row too large for its column (it can't be: the counts are bounded) is shown, never saved.
     // Saving is a convenience: a store that can't take the row (read-only, busy) still shows what was derived.
-    if (payload.length <= 16_384) {
+    if (save && payload.length <= 16_384) {
         try {
             store.handle.prepare(`INSERT INTO run_efficiency (run, parser_version, steps, steps_reason, payload_json, derived_at) VALUES (?, ?, ?, ?, ?, ?)
         ON CONFLICT(run) DO UPDATE SET parser_version = excluded.parser_version, steps = excluded.steps, steps_reason = excluded.steps_reason,

package/dist/scope.d.ts

@@ -605,6 +605,11 @@ export type ApproveResult = {
  | {
     ok: false;
     reason: "archived";
+}
+/** The task was cancelled: a cancelled task takes no approval, by any road (a stale page, the CLI). */
+ | {
+    ok: false;
+    reason: "cancelled";
 };
 /**
  * Whether this name-and-token pair is a person the store knows. Shared by

package/dist/scope.js

@@ -52,7 +52,7 @@ import { z } from "zod";
 import {} from "./contracts/acceptance-terms.js";
 import { parseContract } from "./contracts/contract.js";
 import { readAcceptance, readScopeTerms, storedRubricSchema } from "./contracts/scope.js";
-import { taskArchived } from "./task-archive.js";
+import { taskArchived, taskCancelled } from "./task-archive.js";
 import { releaseCiHoldOf, releaseCiHoldWords } from "./release-ci-hold.js";
 import { NO_READINESS, exactModelId, legOf, projectRoute, routeDigestOf, routeFromJson, routeJsonProblem, routeWords, } from "./phase-routing.js";
 /** Same shape as a runner's credential, for the same reasons. */
@@ -1120,6 +1120,10 @@ chat) {
         // A put-away task (v145) is restored first; sealScopeApproval refuses it too, on every road.
         if (taskArchived(store, taskId))
             return { ok: false, reason: "archived" };
+        // A cancelled task takes no yes either — read here, in the seal's transaction, before any vote or proof is
+        // written: an approval page left open while the task was cancelled elsewhere, or the CLI, approves nothing.
+        if (taskCancelled(store, taskId))
+            return { ok: false, reason: "cancelled" };
         // The digest is required, not optional. An operator reads a scope, somebody
         // rewrites it, and an approval that did not name what it saw would agree to
         // the new one in silence — which is the whole failure this guards.
@@ -1550,6 +1554,9 @@ export function liveReleaseOf(store, taskId, action, now = new Date()) {
     // A put-away task (v145, task-tidy.md), or a put-away anchor, deploys, merges and carries nothing: restore it first.
     if (taskArchived(store, taskId) || taskArchived(store, a.anchorTask))
         return refuse("the release task is put away");
+    // A cancelled task, or a cancelled anchor, the same: cancelling ends what its approval allows.
+    if (taskCancelled(store, taskId) || taskCancelled(store, a.anchorTask))
+        return refuse("the release task was cancelled");
     const newest = newestReleaseGeneration(store, a.repo, a.version, a.pr);
     if (newest === null || newest.id !== a.id)
         return refuse("a newer approval of this release replaced this one");

package/dist/serve.js

@@ -27,6 +27,7 @@ const PROXY_HEADER = /^(forwarded|via|x-forwarded-.+|x-real-ip|x-client-ip|x-ori
 const BACKGROUND_CHECKS_MS = 30_000;
 const LOCAL_AGENTS_EVERY_MS = 2 * 60_000;
 import { browserCrewFromIndex, browserCrewOf, browserNavigationOf, browserProjectsOf, needsYouLabelOf } from './browser-workspace.js';
+import { PAGE_WORK_HEADER, PAGE_WORK_VERSION } from './page-work-contract.js';
 import { sharedActionPayload } from './chat-actions.js';
 import { prepareCodingContext } from './coding-context.js';
 import { CodingWorkspace } from './coding-workspace.js';
@@ -155,7 +156,8 @@ import { createFlowsHandlers } from './server/flows.js';
 import { createPagesHandlers } from './server/pages.js';
 import { createPeopleHandlers } from './server/people-tokens.js';
 import { createSettingsHandlers } from './server/settings.js';
-import { requestContext } from "./server/request-context.js";
+import { readPurpose, requestContext } from "./server/request-context.js";
+import { inPlaceRoute, prefetchRoute } from "./server/in-place.js";
 import { asLocalOwner, localModeOn, localOwnerRefusal, localOwnerStandsNow } from "./local-owner.js";
 import { defaultAgentOf, fillDefaultRouting } from "./model-choices.js";
 import { chromeScript, DEMO_BANNER, DEMO_BANNER_SHORT, focusDocument, KBD_HELP, pinnedTheme, QUEUE_VIEW, refuse, screen, SENSITIVE_INPUT, shell, sidebarScript } from "./server/chrome.js";
@@ -878,9 +880,22 @@ export function createDecisionServer(options) {
         // Passive polls authenticate without extending the browser session.
         const fragmentName = url.searchParams.get("fragment");
         const workspaceRead = method === "GET" && url.searchParams.get('format') === 'workspace';
-        const touch = !(method === "GET" && (edgeRoute?.domain === 'live' || workspaceRead || (fragmentName !== null && NO_TOUCH_FRAGMENTS.has(fragmentName)) || /^\/code\/[a-f0-9]{32}\/state$/.test(url.pathname) || url.pathname === '/term/state'
+        // A workspace read's purpose (live-pages-and-home.md A1.4): bookkeeping only. Read on workspace GETs alone; on any other
+        // request the header means nothing. No authorisation decision below reads it.
+        const purpose = workspaceRead ? readPurpose(request.headers['x-toolroll-read']) : 'poll';
+        // The reads that never extend the session, whatever their header says.
+        const noTouch = edgeRoute?.domain === 'live' || (fragmentName !== null && NO_TOUCH_FRAGMENTS.has(fragmentName)) || /^\/code\/[a-f0-9]{32}\/state$/.test(url.pathname) || url.pathname === '/term/state'
             // The Agents view's Live grid only watches: its polls never extend or write the session.
-            || url.pathname === '/agents/live' || /^\/agents\/live\/[0-9]{1,15}$/.test(url.pathname) || (url.pathname === '/agents' && url.searchParams.get('view') === 'live')));
+            || url.pathname === '/agents/live' || /^\/agents\/live\/[0-9]{1,15}$/.test(url.pathname) || (url.pathname === '/agents' && url.searchParams.get('view') === 'live');
+        // A followed link (`navigate`) extends the session exactly as the HTML GET of the same address would; every other
+        // workspace read (a re-read, a prefetch) does not.
+        const touch = !(method === "GET" && (noTouch || (workspaceRead && purpose !== 'navigate')));
+        // A read ahead is answered only for a browser session, only for the prefetch allowlist (in-place.ts): anything else
+        // hears 204 before any sign-in bookkeeping (a token's last use, a sign-in charge) is written.
+        if (purpose === 'prefetch' && (request.headers.authorization !== undefined || !prefetchRoute(matchedRoute?.id, url))) {
+            request.resume();
+            return respond(response, 204, "text/plain; charset=utf-8", "");
+        }
         const refuseBudget = (admitted) => {
             if (admitted.ok)
                 return false;
@@ -906,6 +921,11 @@ export function createDecisionServer(options) {
         }
         if (who?.via === "bearer" && refuseBudget(admitBearer(request, who)))
             return;
+        // A read ahead from anything but a signed-in browser session (signed out, a token): 204, never the sign-in page.
+        if (purpose === 'prefetch' && who?.via !== 'cookie') {
+            request.resume();
+            return respond(response, 204, "text/plain; charset=utf-8", "");
+        }
         const passwordProof = who?.via === 'cookie' ? { name: who.name, generation: who.session.generation } : null;
         const fresh = freshFactsOf(request, who, matchedRoute?.freshness === 'allowlist');
         if (edgeRoute?.domain === 'people')
@@ -940,6 +960,9 @@ export function createDecisionServer(options) {
                 get fresh() { return freshFacts.getStore() != null && ssoNowAvailable(who.name); } } : undefined,
             refusal: (answer, status, body) => sendScreen(answer, status, screen(status === 404 ? "Not found" : "Request refused", body, { chrome: chromeFor(who.via === "cookie" ? who.session.project : null, "work") })),
             workspaceRead,
+            readPurpose: purpose,
+            ...(workspaceRead && request.headers[PAGE_WORK_HEADER] === String(PAGE_WORK_VERSION) ? { appWork: true } : {}),
+            ...(matchedRoute?.stage === 'console' ? { routeId: matchedRoute.id } : {}),
             freshWork: ["request", "task", "result"].some(name => url.searchParams.has(name)),
             ...(workspaceRead && typeof request.headers['if-none-match'] === 'string' ? { workspaceIfNoneMatch: request.headers['if-none-match'] } : {}),
             workspaceRequest: url.searchParams.get('request'),
@@ -952,7 +975,9 @@ export function createDecisionServer(options) {
                 ? { localStepUp: localOwnerRefusal(false, method === "GET" ? passwordSetNext(pagePathOf(url)) : "/").href } : {}),
             reconnect: browserKeys.stale(who, method === "GET" ? safeReturn(pagePathOf(url)) : "/"),
         };
-        response.once("finish", () => keepSlowRequest(store, timeline, matchedRoute?.id ?? "unmatched", response.statusCode, clock()));
+        // A read ahead writes nothing, not even a slow request's record.
+        if (purpose !== 'prefetch')
+            response.once("finish", () => keepSlowRequest(store, timeline, matchedRoute?.id ?? "unmatched", response.statusCode, clock()));
         if (method === "GET" || method === "POST")
             return freshFacts.run(fresh, () => provenPasswordAccount.run(passwordProof, () => requestContext.run(requestFacts, async () => {
                 if (edgeRoute?.domain === 'live')
@@ -1669,8 +1694,29 @@ export function createDecisionServer(options) {
             }
             const conversation = extras.conversation ?? null;
             const request = requestFacts.workspaceRequest;
+            // React owns the conversation and its refresh/draft lifecycle. Native
+            // guarded forms keep their current behavior after React inserts them.
+            // A page with its own view keeps its script; the chat page runs the result script.
+            // The exact page script the document would run: the JSON arm and the document arm read this one value.
+            const ownScript = conversation === null || extras.view;
+            const pageScript = ownScript ? (s.functional?.script ?? '') : RESULT_REVIEW_SCRIPT;
+            const routeInPlace = inPlaceRoute(requestFacts.routeId, path);
+            // The app runs the page's behaviour itself (docs/plans/task-page-in-app.md §2) only when all of these hold: the
+            // app covers the WHOLE script, no password field (a password page keeps its string path), an in-place route, and a
+            // reader that can run it: a document load (its bundle is this server's, served no-store) or a workspace read that
+            // says so. Anything else is the page exactly as before: the string, no work, a document.
+            const covered = ownScript ? s.functional?.app : undefined;
+            const work = pageScript !== '' && covered !== undefined && covered.length > 0 && !sensitive && routeInPlace
+                && (!requestFacts.workspaceRead || requestFacts.appWork === true) ? covered : null;
+            const functional = work === null ? pageScript : '';
+            // May replace another page without a document load (live-pages-and-home.md A1.1): an allowlisted route, no password
+            // field, no page script (a page script runs once per document, so its page always loads as one).
+            const inPlace = routeInPlace && !sensitive && functional === '';
             const workspace = {
-                version: 1, path: currentPath, title: s.title, user: requestFacts.actor ?? '', csrf: requestFacts.csrf, sensitive,
+                version: 1, path: currentPath, title: s.title, user: requestFacts.actor ?? '', csrf: requestFacts.csrf, sensitive, inPlace,
+                ...(work === null ? {} : { work }),
+                // Said on the document that ships it: this document's page script listens for as long as the document lives.
+                ...(functional !== '' && !requestFacts.workspaceRead ? { scripted: true } : {}),
                 // The project picker names the open project; the settings frame carries its breadcrumb.
                 // Only a project this person may see now: never the raw saved path (settings-kit.ts openProjectFor).
                 openProject: openProjectFor(requestFacts.openProject ?? null, s.chrome.project, s.chrome.projects ?? []),
@@ -1761,10 +1807,6 @@ export function createDecisionServer(options) {
                 return respond(response, status, 'application/json; charset=utf-8', body);
             }
             const nonce = randomBytes(16).toString('base64');
-            // React owns the conversation and its refresh/draft lifecycle. Native
-            // guarded forms keep their current behavior after React inserts them.
-            // A page with its own view keeps its script; the chat page runs the result script.
-            const functional = conversation === null || extras.view ? (s.functional?.script ?? '') : RESULT_REVIEW_SCRIPT;
             const document = shell(s.title, s.body, { chrome: s.chrome, sensitive });
             // The keys and their list (keymap.ts) work here as on every chromed page; the list sits beside the app React owns.
             // A sensitive page keeps to its own script.

package/dist/server/chrome.d.ts

@@ -1,4 +1,4 @@
-import { type BrowserSignIn, type BrowserUpdateNotice, type BrowserWorkspace } from "../browser-workspace.js";
+import { type BrowserSignIn, type BrowserUpdateNotice, type BrowserWorkspace, type PageWork } from "../browser-workspace.js";
 import { type Crumb } from "../settings-kit.js";
 import { type Decision, type Run } from "../store.js";
 import { type tally } from "../summary.js";
@@ -56,7 +56,7 @@ export declare const DEMO_BANNER_SHORT = "Demo: sample projects. Nothing calls a
  * a person's accent (accentHead) still wins over the generated default. */
 export declare const STYLE: string;
 /** Appearance: a three-way segmented switch, one tap per choice. */
-export declare const THEME_CONTROLS_CSS = ".task-repo select{width:100%;min-height:2.75rem;font-size:1rem}.task-repo-add{margin:.35rem .1rem .5rem}.task-repo-add a{display:inline-flex;align-items:center;min-height:2.25rem}details.result-request-open.result-request-form>summary{border:0;background:transparent;padding:.5rem 0;min-height:2.75rem;font-weight:600;display:list-item;list-style:revert}details.result-request-open.result-request-form>summary::-webkit-details-marker{display:revert}form.js-autosave button[type=submit]{display:none}.provider-row{border-bottom:1px solid var(--so-line);padding:.35rem 0}.provider-row:first-of-type{border-top:1px solid var(--so-line)}.provider-head{display:flex;align-items:center;gap:.75rem;margin:.4rem 0 0}.provider-status{display:inline-flex;align-items:center;gap:.4rem;color:var(--so-muted);font-size:.875rem}.provider-status i{width:.5rem;height:.5rem;border-radius:50%;background:var(--so-muted)}.provider-status--ok i{background:var(--so-success)}.provider-status--warn i{background:var(--so-attention)}.provider-status--off i{background:transparent;border:1.5px solid var(--so-muted)}details.provider-manage>summary{cursor:pointer;color:var(--so-accent-text);font-size:.875rem;min-height:2.5rem;display:list-item;padding-block:.5rem}.card.props .row{display:grid;gap:.1rem;margin:0 0 .75rem}.card.props .row>.meta{display:block;font-size:.75rem}.card.props .row>.meta::first-letter{text-transform:uppercase}.card.props .row>.mono{font-family:var(--font-sans);font-size:.875rem}.card.props .row>.mono .seal{font-family:var(--font-mono);font-size:.8125rem}details.evidence-files{margin:1rem 0}details.evidence-files>summary{cursor:pointer;min-height:2.75rem;display:list-item;padding-block:.7rem;font-weight:600}details.evidence-files ul{list-style:none;margin:0;padding:0}details.evidence-files li{display:flex;justify-content:space-between;gap:1rem;padding:.5rem 0;border-bottom:1px solid var(--so-line)}.result-action .result-feedback-link{display:inline-flex;align-items:center;min-height:2.5rem;padding:.5rem 1rem;border:1px solid var(--so-input-line);border-radius:.5rem;background:var(--so-paper);color:var(--so-ink);font-weight:600;text-decoration:none}@media(hover:hover) and (pointer:fine){.result-action .result-feedback-link:hover{background:var(--so-raised)}}.so-sr-only{position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important}.verdict{margin:.5rem 0 .75rem}.verdict-chips{display:flex;flex-wrap:wrap;gap:.4rem;list-style:none;padding:0;margin:0}.verdict-chip{display:inline-flex;align-items:center;gap:.3rem;min-height:1.75rem;padding:.2rem .65rem;border-radius:999px;font-size:.8125rem;font-weight:600;background:var(--so-neutral-soft);color:var(--so-neutral-ink)}.verdict-chip svg{width:.9rem;height:.9rem}.verdict-chip--success{background:var(--so-success-soft);color:var(--so-success)}.verdict-chip--danger{background:var(--so-danger-soft);color:var(--so-danger)}.verdict-chip--warning{background:var(--so-warning-soft);color:var(--so-warning)}.verdict-chip--info{background:var(--so-info-soft);color:var(--so-info)}.verdict-by{margin:.4rem 0 0}details.result-request-open{margin:.5rem 0}details.result-request-open>summary{display:inline-flex;align-items:center;min-height:2.5rem;padding:.5rem 1rem;border:1px solid var(--so-input-line);border-radius:.5rem;background:var(--so-paper);color:var(--so-ink);font-weight:600;cursor:pointer;list-style:none}details.result-request-open>summary::-webkit-details-marker{display:none}details.result-request-open[open]>summary{margin-bottom:.75rem}.settings-tiles{display:grid;gap:1.25rem;margin:0 0 2rem}.settings-tiles h2{margin:0 0 .5rem;font-size:.875rem;font-weight:600;color:var(--so-muted)}.settings-tiles section>div{display:grid;grid-template-columns:repeat(auto-fill,minmax(8.5rem,1fr));gap:.5rem}.settings-tiles a>span{display:grid;gap:.1rem;min-width:0}.settings-tiles .provider-status{font-weight:400;font-size:.8125rem}.settings-tiles a{display:flex;align-items:center;gap:.6rem;min-height:3rem;padding:.65rem .8rem;border:1px solid var(--so-line);border-radius:.625rem;background:var(--so-paper);color:var(--so-ink);text-decoration:none;font-weight:550;font-size:.875rem}@media(hover:hover) and (pointer:fine){.settings-tiles a:hover{border-color:var(--so-input-line);background:var(--so-raised)}}.settings-tiles a>svg{width:1.1rem;height:1.1rem;flex-shrink:0;color:var(--so-accent-text)}details.settings-more{margin:.25rem 0 1.25rem}details.settings-more>summary{cursor:pointer;min-height:2.75rem;display:list-item;padding-block:.7rem;font-weight:550}details.settings-more>summary .meta{font-weight:400;margin-left:.35rem}.settings-changed{margin-top:-.25rem}.appearance{margin:0 0 28px}.appearance h2{margin:0 0 10px}.theme-switch{display:inline-flex;flex-wrap:nowrap;max-width:100%;gap:4px;padding:4px;margin:0;border:1px solid var(--so-line);border-radius:10px;background:var(--so-raised)}.theme-switch .theme-choice,.so-native-region .theme-switch .theme-choice{flex:1 1 0;width:auto;white-space:nowrap;min-height:40px;padding:8px 16px;border:0;border-radius:7px;background:transparent;color:var(--so-muted);font:inherit;font-weight:550;box-shadow:none;cursor:pointer}@media(hover:hover) and (pointer:fine){.theme-switch .theme-choice:hover{color:var(--so-ink)}}.theme-switch .theme-choice[aria-pressed=\"true\"]{background:var(--so-paper);color:var(--so-ink);box-shadow:0 1px 2px rgb(0 0 0 / .1)}.appearance .meta{margin:8px 0 0}@media(max-width:600px){.theme-switch .theme-choice{min-height:44px}}.update-notes{white-space:pre-wrap;overflow-wrap:anywhere;font:inherit;max-height:18rem;overflow:auto}";
+export declare const THEME_CONTROLS_CSS = ".task-repo select{width:100%;min-height:2.75rem;font-size:1rem}.task-repo-add{margin:.35rem .1rem .5rem}.task-repo-add a{display:inline-flex;align-items:center;min-height:2.25rem}details.result-request-open.result-request-form>summary{border:0;background:transparent;padding:.5rem 0;min-height:2.75rem;font-weight:600;display:list-item;list-style:revert}details.result-request-open.result-request-form>summary::-webkit-details-marker{display:revert}form.js-autosave button[type=submit]{display:none}.provider-row{border-bottom:1px solid var(--so-line);padding:.35rem 0}.provider-row:first-of-type{border-top:1px solid var(--so-line)}.provider-head{display:flex;align-items:center;gap:.75rem;margin:.4rem 0 0}.provider-status{display:inline-flex;align-items:center;gap:.4rem;color:var(--so-muted);font-size:.875rem}.provider-status i{width:.5rem;height:.5rem;border-radius:50%;background:var(--so-muted)}.provider-status--ok i{background:var(--so-success)}.provider-status--warn i{background:var(--so-attention)}.provider-status--off i{background:transparent;border:1.5px solid var(--so-muted)}details.provider-manage>summary{cursor:pointer;color:var(--so-accent-text);font-size:.875rem;min-height:2.5rem;display:list-item;padding-block:.5rem}.card.props .row{display:grid;gap:.1rem;margin:0 0 .75rem}.card.props .row>.meta{display:block;font-size:.75rem}.card.props .row>.meta::first-letter{text-transform:uppercase}.card.props .row>.mono{font-family:var(--font-sans);font-size:.875rem}.card.props .row>.mono .seal{font-family:var(--font-mono);font-size:.8125rem}details.evidence-files{margin:1rem 0}details.evidence-files>summary{cursor:pointer;min-height:2.75rem;display:list-item;padding-block:.7rem;font-weight:600}details.evidence-files ul{list-style:none;margin:0;padding:0}details.evidence-files li{display:flex;justify-content:space-between;gap:1rem;padding:.5rem 0;border-bottom:1px solid var(--so-line)}.result-action .result-feedback-link{display:inline-flex;align-items:center;min-height:2.5rem;padding:.5rem 1rem;border:1px solid var(--so-input-line);border-radius:.5rem;background:var(--so-paper);color:var(--so-ink);font-weight:600;text-decoration:none}@media(hover:hover) and (pointer:fine){.result-action .result-feedback-link:hover{background:var(--so-raised)}}.so-sr-only{position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important}.verdict{margin:.5rem 0 .75rem}.verdict-chips{display:flex;flex-wrap:wrap;gap:.4rem;list-style:none;padding:0;margin:0}.verdict-chip{display:inline-flex;align-items:center;gap:.3rem;min-height:1.75rem;padding:.2rem .65rem;border-radius:999px;font-size:.8125rem;font-weight:600;background:var(--so-neutral-soft);color:var(--so-neutral-ink)}.verdict-chip svg{width:.9rem;height:.9rem}.verdict-chip--success{background:var(--so-success-soft);color:var(--so-success)}.verdict-chip--danger{background:var(--so-danger-soft);color:var(--so-danger)}.verdict-chip--warning{background:var(--so-neutral-soft);color:var(--so-ink)}.verdict-chip--info{background:var(--so-info-soft);color:var(--so-info)}.verdict-by{margin:.4rem 0 0}details.result-request-open{margin:.5rem 0}details.result-request-open>summary{display:inline-flex;align-items:center;min-height:2.5rem;padding:.5rem 1rem;border:1px solid var(--so-input-line);border-radius:.5rem;background:var(--so-paper);color:var(--so-ink);font-weight:600;cursor:pointer;list-style:none}details.result-request-open>summary::-webkit-details-marker{display:none}details.result-request-open[open]>summary{margin-bottom:.75rem}.settings-tiles{display:grid;gap:1.25rem;margin:0 0 2rem}.settings-tiles h2{margin:0 0 .5rem;font-size:.875rem;font-weight:600;color:var(--so-muted)}.settings-tiles section>div{display:grid;grid-template-columns:repeat(auto-fill,minmax(8.5rem,1fr));gap:.5rem}.settings-tiles a>span{display:grid;gap:.1rem;min-width:0}.settings-tiles .provider-status{font-weight:400;font-size:.8125rem}.settings-tiles a{display:flex;align-items:center;gap:.6rem;min-height:3rem;padding:.65rem .8rem;border:1px solid var(--so-line);border-radius:.625rem;background:var(--so-paper);color:var(--so-ink);text-decoration:none;font-weight:550;font-size:.875rem}@media(hover:hover) and (pointer:fine){.settings-tiles a:hover{border-color:var(--so-input-line);background:var(--so-raised)}}.settings-tiles a>svg{width:1.1rem;height:1.1rem;flex-shrink:0;color:var(--so-accent-text)}details.settings-more{margin:.25rem 0 1.25rem}details.settings-more>summary{cursor:pointer;min-height:2.75rem;display:list-item;padding-block:.7rem;font-weight:550}details.settings-more>summary .meta{font-weight:400;margin-left:.35rem}.settings-changed{margin-top:-.25rem}.appearance{margin:0 0 28px}.appearance h2{margin:0 0 10px}.theme-switch{display:inline-flex;flex-wrap:nowrap;max-width:100%;gap:4px;padding:4px;margin:0;border:1px solid var(--so-line);border-radius:10px;background:var(--so-raised)}.theme-switch .theme-choice,.so-native-region .theme-switch .theme-choice{flex:1 1 0;width:auto;white-space:nowrap;min-height:40px;padding:8px 16px;border:0;border-radius:7px;background:transparent;color:var(--so-muted);font:inherit;font-weight:550;box-shadow:none;cursor:pointer}@media(hover:hover) and (pointer:fine){.theme-switch .theme-choice:hover{color:var(--so-ink)}}.theme-switch .theme-choice[aria-pressed=\"true\"]{background:var(--so-paper);color:var(--so-ink);box-shadow:0 1px 2px rgb(0 0 0 / .1)}.appearance .meta{margin:8px 0 0}@media(max-width:600px){.theme-switch .theme-choice{min-height:44px}}.update-notes{white-space:pre-wrap;overflow-wrap:anywhere;font:inherit;max-height:18rem;overflow:auto}";
 /** The page CSS this module writes itself (not the imported modules'), for the stylesheet contract tests. */
 export declare const PAGE_CSS: string;
 /** The Inbox tabs (console v2): a segmented track of real links; the dot marks a tab with something new, on phones only. */
@@ -176,6 +176,9 @@ export type Screen = {
     functional?: {
         script: string;
         fetches?: boolean;
+        /** The app's own version of this WHOLE script (task-page-in-app.md §1): where the app can run it, the document
+         * ships no script string and the page may change in place. Added to only through withScript. */
+        app?: readonly PageWork[];
     };
     refreshSeconds?: number;
     /** Render sensitive even when no password field is visible — one-time
@@ -317,3 +320,9 @@ export declare function oneLineOf(text: string, cap: number): string;
  * minutes are the answer without script.
  */
 export declare function boardTickScript(regionId?: string): string;
+/**
+ * A page's script with one more added (docs/plans/task-page-in-app.md §1). All or nothing: `app` survives only when
+ * every part has it, so a script the app does not cover keeps the whole page a document, and a page never gets half
+ * its behaviour from the string and half from the app.
+ */
+export declare function withScript(base: Screen["functional"], add: NonNullable<Screen["functional"]>): NonNullable<Screen["functional"]>;

package/dist/server/chrome.js

@@ -150,7 +150,7 @@ export const STYLE = readFileSync(join(import.meta.dirname, "..", "design", "tok
     // server pages (server/kit.ts) and React views (browser/kit/) looks the same everywhere.
     readFileSync(join(import.meta.dirname, "..", "design", "kit.css"), "utf8");
 /** Appearance: a three-way segmented switch, one tap per choice. */
-export const THEME_CONTROLS_CSS = `.task-repo select{width:100%;min-height:2.75rem;font-size:1rem}.task-repo-add{margin:.35rem .1rem .5rem}.task-repo-add a{display:inline-flex;align-items:center;min-height:2.25rem}details.result-request-open.result-request-form>summary{border:0;background:transparent;padding:.5rem 0;min-height:2.75rem;font-weight:600;display:list-item;list-style:revert}details.result-request-open.result-request-form>summary::-webkit-details-marker{display:revert}form.js-autosave button[type=submit]{display:none}.provider-row{border-bottom:1px solid var(--so-line);padding:.35rem 0}.provider-row:first-of-type{border-top:1px solid var(--so-line)}.provider-head{display:flex;align-items:center;gap:.75rem;margin:.4rem 0 0}.provider-status{display:inline-flex;align-items:center;gap:.4rem;color:var(--so-muted);font-size:.875rem}.provider-status i{width:.5rem;height:.5rem;border-radius:50%;background:var(--so-muted)}.provider-status--ok i{background:var(--so-success)}.provider-status--warn i{background:var(--so-attention)}.provider-status--off i{background:transparent;border:1.5px solid var(--so-muted)}details.provider-manage>summary{cursor:pointer;color:var(--so-accent-text);font-size:.875rem;min-height:2.5rem;display:list-item;padding-block:.5rem}.card.props .row{display:grid;gap:.1rem;margin:0 0 .75rem}.card.props .row>.meta{display:block;font-size:.75rem}.card.props .row>.meta::first-letter{text-transform:uppercase}.card.props .row>.mono{font-family:var(--font-sans);font-size:.875rem}.card.props .row>.mono .seal{font-family:var(--font-mono);font-size:.8125rem}details.evidence-files{margin:1rem 0}details.evidence-files>summary{cursor:pointer;min-height:2.75rem;display:list-item;padding-block:.7rem;font-weight:600}details.evidence-files ul{list-style:none;margin:0;padding:0}details.evidence-files li{display:flex;justify-content:space-between;gap:1rem;padding:.5rem 0;border-bottom:1px solid var(--so-line)}.result-action .result-feedback-link{display:inline-flex;align-items:center;min-height:2.5rem;padding:.5rem 1rem;border:1px solid var(--so-input-line);border-radius:.5rem;background:var(--so-paper);color:var(--so-ink);font-weight:600;text-decoration:none}@media(hover:hover) and (pointer:fine){.result-action .result-feedback-link:hover{background:var(--so-raised)}}.so-sr-only{position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important}.verdict{margin:.5rem 0 .75rem}.verdict-chips{display:flex;flex-wrap:wrap;gap:.4rem;list-style:none;padding:0;margin:0}.verdict-chip{display:inline-flex;align-items:center;gap:.3rem;min-height:1.75rem;padding:.2rem .65rem;border-radius:999px;font-size:.8125rem;font-weight:600;background:var(--so-neutral-soft);color:var(--so-neutral-ink)}.verdict-chip svg{width:.9rem;height:.9rem}.verdict-chip--success{background:var(--so-success-soft);color:var(--so-success)}.verdict-chip--danger{background:var(--so-danger-soft);color:var(--so-danger)}.verdict-chip--warning{background:var(--so-warning-soft);color:var(--so-warning)}.verdict-chip--info{background:var(--so-info-soft);color:var(--so-info)}.verdict-by{margin:.4rem 0 0}details.result-request-open{margin:.5rem 0}details.result-request-open>summary{display:inline-flex;align-items:center;min-height:2.5rem;padding:.5rem 1rem;border:1px solid var(--so-input-line);border-radius:.5rem;background:var(--so-paper);color:var(--so-ink);font-weight:600;cursor:pointer;list-style:none}details.result-request-open>summary::-webkit-details-marker{display:none}details.result-request-open[open]>summary{margin-bottom:.75rem}.settings-tiles{display:grid;gap:1.25rem;margin:0 0 2rem}.settings-tiles h2{margin:0 0 .5rem;font-size:.875rem;font-weight:600;color:var(--so-muted)}.settings-tiles section>div{display:grid;grid-template-columns:repeat(auto-fill,minmax(8.5rem,1fr));gap:.5rem}.settings-tiles a>span{display:grid;gap:.1rem;min-width:0}.settings-tiles .provider-status{font-weight:400;font-size:.8125rem}.settings-tiles a{display:flex;align-items:center;gap:.6rem;min-height:3rem;padding:.65rem .8rem;border:1px solid var(--so-line);border-radius:.625rem;background:var(--so-paper);color:var(--so-ink);text-decoration:none;font-weight:550;font-size:.875rem}@media(hover:hover) and (pointer:fine){.settings-tiles a:hover{border-color:var(--so-input-line);background:var(--so-raised)}}.settings-tiles a>svg{width:1.1rem;height:1.1rem;flex-shrink:0;color:var(--so-accent-text)}details.settings-more{margin:.25rem 0 1.25rem}details.settings-more>summary{cursor:pointer;min-height:2.75rem;display:list-item;padding-block:.7rem;font-weight:550}details.settings-more>summary .meta{font-weight:400;margin-left:.35rem}.settings-changed{margin-top:-.25rem}.appearance{margin:0 0 28px}.appearance h2{margin:0 0 10px}.theme-switch{display:inline-flex;flex-wrap:nowrap;max-width:100%;gap:4px;padding:4px;margin:0;border:1px solid var(--so-line);border-radius:10px;background:var(--so-raised)}.theme-switch .theme-choice,.so-native-region .theme-switch .theme-choice{flex:1 1 0;width:auto;white-space:nowrap;min-height:40px;padding:8px 16px;border:0;border-radius:7px;background:transparent;color:var(--so-muted);font:inherit;font-weight:550;box-shadow:none;cursor:pointer}@media(hover:hover) and (pointer:fine){.theme-switch .theme-choice:hover{color:var(--so-ink)}}.theme-switch .theme-choice[aria-pressed="true"]{background:var(--so-paper);color:var(--so-ink);box-shadow:0 1px 2px rgb(0 0 0 / .1)}.appearance .meta{margin:8px 0 0}@media(max-width:600px){.theme-switch .theme-choice{min-height:44px}}.update-notes{white-space:pre-wrap;overflow-wrap:anywhere;font:inherit;max-height:18rem;overflow:auto}`;
+export const THEME_CONTROLS_CSS = `.task-repo select{width:100%;min-height:2.75rem;font-size:1rem}.task-repo-add{margin:.35rem .1rem .5rem}.task-repo-add a{display:inline-flex;align-items:center;min-height:2.25rem}details.result-request-open.result-request-form>summary{border:0;background:transparent;padding:.5rem 0;min-height:2.75rem;font-weight:600;display:list-item;list-style:revert}details.result-request-open.result-request-form>summary::-webkit-details-marker{display:revert}form.js-autosave button[type=submit]{display:none}.provider-row{border-bottom:1px solid var(--so-line);padding:.35rem 0}.provider-row:first-of-type{border-top:1px solid var(--so-line)}.provider-head{display:flex;align-items:center;gap:.75rem;margin:.4rem 0 0}.provider-status{display:inline-flex;align-items:center;gap:.4rem;color:var(--so-muted);font-size:.875rem}.provider-status i{width:.5rem;height:.5rem;border-radius:50%;background:var(--so-muted)}.provider-status--ok i{background:var(--so-success)}.provider-status--warn i{background:var(--so-attention)}.provider-status--off i{background:transparent;border:1.5px solid var(--so-muted)}details.provider-manage>summary{cursor:pointer;color:var(--so-accent-text);font-size:.875rem;min-height:2.5rem;display:list-item;padding-block:.5rem}.card.props .row{display:grid;gap:.1rem;margin:0 0 .75rem}.card.props .row>.meta{display:block;font-size:.75rem}.card.props .row>.meta::first-letter{text-transform:uppercase}.card.props .row>.mono{font-family:var(--font-sans);font-size:.875rem}.card.props .row>.mono .seal{font-family:var(--font-mono);font-size:.8125rem}details.evidence-files{margin:1rem 0}details.evidence-files>summary{cursor:pointer;min-height:2.75rem;display:list-item;padding-block:.7rem;font-weight:600}details.evidence-files ul{list-style:none;margin:0;padding:0}details.evidence-files li{display:flex;justify-content:space-between;gap:1rem;padding:.5rem 0;border-bottom:1px solid var(--so-line)}.result-action .result-feedback-link{display:inline-flex;align-items:center;min-height:2.5rem;padding:.5rem 1rem;border:1px solid var(--so-input-line);border-radius:.5rem;background:var(--so-paper);color:var(--so-ink);font-weight:600;text-decoration:none}@media(hover:hover) and (pointer:fine){.result-action .result-feedback-link:hover{background:var(--so-raised)}}.so-sr-only{position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important}.verdict{margin:.5rem 0 .75rem}.verdict-chips{display:flex;flex-wrap:wrap;gap:.4rem;list-style:none;padding:0;margin:0}.verdict-chip{display:inline-flex;align-items:center;gap:.3rem;min-height:1.75rem;padding:.2rem .65rem;border-radius:999px;font-size:.8125rem;font-weight:600;background:var(--so-neutral-soft);color:var(--so-neutral-ink)}.verdict-chip svg{width:.9rem;height:.9rem}.verdict-chip--success{background:var(--so-success-soft);color:var(--so-success)}.verdict-chip--danger{background:var(--so-danger-soft);color:var(--so-danger)}.verdict-chip--warning{background:var(--so-neutral-soft);color:var(--so-ink)}.verdict-chip--info{background:var(--so-info-soft);color:var(--so-info)}.verdict-by{margin:.4rem 0 0}details.result-request-open{margin:.5rem 0}details.result-request-open>summary{display:inline-flex;align-items:center;min-height:2.5rem;padding:.5rem 1rem;border:1px solid var(--so-input-line);border-radius:.5rem;background:var(--so-paper);color:var(--so-ink);font-weight:600;cursor:pointer;list-style:none}details.result-request-open>summary::-webkit-details-marker{display:none}details.result-request-open[open]>summary{margin-bottom:.75rem}.settings-tiles{display:grid;gap:1.25rem;margin:0 0 2rem}.settings-tiles h2{margin:0 0 .5rem;font-size:.875rem;font-weight:600;color:var(--so-muted)}.settings-tiles section>div{display:grid;grid-template-columns:repeat(auto-fill,minmax(8.5rem,1fr));gap:.5rem}.settings-tiles a>span{display:grid;gap:.1rem;min-width:0}.settings-tiles .provider-status{font-weight:400;font-size:.8125rem}.settings-tiles a{display:flex;align-items:center;gap:.6rem;min-height:3rem;padding:.65rem .8rem;border:1px solid var(--so-line);border-radius:.625rem;background:var(--so-paper);color:var(--so-ink);text-decoration:none;font-weight:550;font-size:.875rem}@media(hover:hover) and (pointer:fine){.settings-tiles a:hover{border-color:var(--so-input-line);background:var(--so-raised)}}.settings-tiles a>svg{width:1.1rem;height:1.1rem;flex-shrink:0;color:var(--so-accent-text)}details.settings-more{margin:.25rem 0 1.25rem}details.settings-more>summary{cursor:pointer;min-height:2.75rem;display:list-item;padding-block:.7rem;font-weight:550}details.settings-more>summary .meta{font-weight:400;margin-left:.35rem}.settings-changed{margin-top:-.25rem}.appearance{margin:0 0 28px}.appearance h2{margin:0 0 10px}.theme-switch{display:inline-flex;flex-wrap:nowrap;max-width:100%;gap:4px;padding:4px;margin:0;border:1px solid var(--so-line);border-radius:10px;background:var(--so-raised)}.theme-switch .theme-choice,.so-native-region .theme-switch .theme-choice{flex:1 1 0;width:auto;white-space:nowrap;min-height:40px;padding:8px 16px;border:0;border-radius:7px;background:transparent;color:var(--so-muted);font:inherit;font-weight:550;box-shadow:none;cursor:pointer}@media(hover:hover) and (pointer:fine){.theme-switch .theme-choice:hover{color:var(--so-ink)}}.theme-switch .theme-choice[aria-pressed="true"]{background:var(--so-paper);color:var(--so-ink);box-shadow:0 1px 2px rgb(0 0 0 / .1)}.appearance .meta{margin:8px 0 0}@media(max-width:600px){.theme-switch .theme-choice{min-height:44px}}.update-notes{white-space:pre-wrap;overflow-wrap:anywhere;font:inherit;max-height:18rem;overflow:auto}`;
 /** The page CSS this module writes itself (not the imported modules'), for the stylesheet contract tests. */
 export const PAGE_CSS = STYLE + THEME_CONTROLS_CSS;
 /** The Inbox tabs (console v2): a segmented track of real links; the dot marks a tab with something new, on phones only. */
@@ -807,3 +807,12 @@ export function boardTickScript(regionId = "board-region") {
         `run();setInterval(function(){if(!document.hidden)run();},1000);document.addEventListener("visibilitychange",function(){if(!document.hidden)run();});` +
         `if(region&&typeof MutationObserver==="function")new MutationObserver(run).observe(region,{childList:true});})();`);
 }
+/**
+ * A page's script with one more added (docs/plans/task-page-in-app.md §1). All or nothing: `app` survives only when
+ * every part has it, so a script the app does not cover keeps the whole page a document, and a page never gets half
+ * its behaviour from the string and half from the app.
+ */
+export function withScript(base, add) {
+    const app = base === undefined ? add.app : base.app !== undefined && add.app !== undefined ? [...base.app, ...add.app] : undefined;
+    return { script: (base?.script ?? "") + add.script, fetches: (base?.fetches ?? false) || (add.fetches ?? false), ...(app === undefined ? {} : { app }) };
+}

package/dist/server/console.css

@@ -41,7 +41,7 @@
     --muted: var(--so-raised); --muted-foreground: var(--so-muted); --border: var(--so-line); --input: var(--so-input-line);
     --primary: var(--so-accent); --primary-foreground: var(--so-on-accent); --secondary: var(--so-raised);
     --accent: var(--so-soft); --destructive: var(--so-danger); --destructive-soft: var(--so-danger-soft);
-    --success: var(--so-success); --success-soft: var(--so-success-soft); --warning: var(--so-warning); --warning-soft: var(--so-warning-soft);
+    --success: var(--so-success); --success-soft: var(--so-success-soft); --warning: var(--so-neutral-ink); --warning-soft: var(--so-neutral-soft);
     --running: var(--so-info); --running-soft: var(--so-info-soft); --ring: var(--so-signal);
     /* The accent means one thing: a person is needed (approve, answer, decide). */
     --brand: var(--so-attention); --brand-foreground: var(--so-on-attention); --brand-soft: var(--so-attention-soft);
@@ -141,7 +141,7 @@
   }
   .badge-note {
     background: color-mix(in srgb, var(--muted) 58%, var(--card));
-    color: var(--so-warning, #ab6400); border-color: var(--border);
+    color: var(--so-neutral-ink); border-color: var(--border);
   }
   .badge-overdue {
     background: color-mix(in srgb, var(--muted) 58%, var(--card)); color: var(--foreground);
@@ -173,17 +173,17 @@
   }
   .badge-cut { background: var(--muted); }
   /* The status chip (components/ui/badge.tsx `size="chip"`, after ReUI's light badge with a dot): 20px, 6px
-     corners, a soft wash, 11.5px words and a 6px dot. Needs you is the amber wash with its words leaned toward ink
-     (4.5:1); the dot is decoration and the word carries the meaning. */
+     corners, a soft wash, 11.5px words and a 6px dot. Needs you is solid ink with paper words and
+     no dot; elsewhere the dot is decoration and the word carries the meaning. */
   .chip {
     display: inline-flex; align-items: center; gap: .375rem; height: 1.25rem; padding: 0 .375rem; border-radius: var(--so-radius-sm);
     font-family: var(--font-sans); font-size: .71875rem; font-weight: 500; line-height: 1; white-space: nowrap; vertical-align: middle;
     background: var(--so-neutral-soft); color: var(--so-ink);
   }
-  /* Ink words, the tone in the dot (the Agents → Live chip); Needs you keeps amber words leaned toward ink. */
+  /* Ink words, the tone in the dot (the Agents → Live chip); Needs you is solid ink, no dot. */
   .chip-dot { width: .375rem; height: .375rem; flex-shrink: 0; border-radius: var(--so-radius-full); background: var(--so-neutral-ink); }
-  .chip-needs { background: var(--so-warning-soft); color: color-mix(in oklab, var(--so-warning) 85%, var(--so-ink)); }
-  .chip-needs .chip-dot { background: var(--so-warning); }
+  .chip-needs { background: var(--so-needs); color: var(--so-on-signal); }
+  .chip-needs .chip-dot { display: none; }
   .chip-live { background: var(--so-info-soft); }
   .chip-live .chip-dot { background: var(--so-info); }
   .chip-done { background: var(--so-success-soft); }
@@ -195,7 +195,7 @@
   .frame { display: flex; flex-direction: column; gap: .25rem; padding: .25rem; border: 1px solid var(--so-line); border-radius: var(--so-radius-card); background: var(--so-raised); }
   .frame-head { display: flex; align-items: center; justify-content: space-between; gap: .5rem; min-height: 2rem; padding: .25rem .625rem; }
   .frame-panel { position: relative; border: 1px solid var(--so-line); border-radius: calc(var(--so-radius-card) - .25rem - 1px); background: var(--so-paper); padding: .75rem .875rem; }
-  .frame-panel.waits { border-color: var(--so-warning); }
+  .frame-panel.waits { border-color: var(--so-needs); }
 
   .card {
     border: 1px solid var(--glass-border); border-radius: var(--radius); background: var(--glass);
@@ -1012,7 +1012,7 @@
   .dispatch-status[data-dispatch-status="proof-refuted"] .dispatch-copy > strong::before,
   .dispatch-status[data-dispatch-status="needs-verification"] .dispatch-copy > strong::before {
     content: ""; display: inline-block; width: .45rem; height: .45rem; margin-right: .45rem; border-radius: 50%; vertical-align: .08rem;
-    background: var(--so-warning, #ab6400);
+    background: var(--warning);
   }
   .problem.dispatch-status[data-dispatch-status="proof-refuted"] .dispatch-copy > strong::before { background: var(--destructive); }
   .dispatch-status[data-dispatch-status="needs-verification"] .dispatch-copy > strong::before { background: var(--muted-foreground); }
@@ -1110,14 +1110,14 @@
   .contract-panel { margin-top: .8rem; padding: .7rem .85rem; border: 1px solid var(--glass-border); border-radius: calc(var(--radius) - 3px); background: color-mix(in srgb, var(--muted) 45%, transparent); }
   .contract-panel .approval-label { margin: 0 0 .25rem; }
   .contract-panel p { margin: .2rem 0; }
-  .contract-amended { border-color: color-mix(in srgb, var(--warning, #c98a1b) 55%, var(--glass-border)); background: color-mix(in srgb, var(--warning, #c98a1b) 9%, transparent); }
+  .contract-amended { border-color: color-mix(in srgb, var(--warning) 55%, var(--glass-border)); background: color-mix(in srgb, var(--warning) 9%, transparent); }
   .contract-reason { font-size: .9rem; }
   .contract-changes { margin: .5rem 0 0; padding-left: 1.1rem; display: grid; gap: .45rem; }
   .contract-changes li { overflow-wrap: anywhere; }
   .contract-change-kind { display: inline-block; margin-right: .3rem; padding: .05rem .4rem; border-radius: 999px; font: 600 .62rem/1.5 var(--font-mono); letter-spacing: .06em; text-transform: uppercase; background: color-mix(in srgb, var(--muted) 70%, transparent); }
   .contract-change-added { background: color-mix(in srgb, var(--success, #2f9e5f) 18%, transparent); }
   .contract-change-removed { background: color-mix(in srgb, var(--danger, #c8453d) 18%, transparent); }
-  .contract-change-changed { background: color-mix(in srgb, var(--warning, #c98a1b) 22%, transparent); }
+  .contract-change-changed { background: color-mix(in srgb, var(--warning) 22%, transparent); }
   .contract-before, .contract-after { margin-top: .15rem; font-size: .85rem; }
   .contract-before { color: var(--muted-foreground); text-decoration: line-through; text-decoration-color: color-mix(in srgb, var(--muted-foreground) 55%, transparent); }
   .contract-note { margin-top: .5rem; }
@@ -1251,6 +1251,35 @@
   .approval-roles dd { margin: 0; }
   .approval-roles dd ul { margin: 2px 0 0; color: var(--muted-foreground); }
   .chat-plan .approval-sheet { padding: 0; border: 0; background: none; }
+  /* The plan sheet (task page, docs/plans/task-page-steps.md): the same terms read top to bottom — one lead sentence,
+     Steps, Done when, Will change / Won't touch, Worth knowing, the agent — every part open, small muted headings. */
+  .plan-sheet { display: grid; gap: 22px; margin: 0; min-width: 0; color: var(--so-ink); }
+  .plan-sheet > * { margin: 0; }
+  .plan-sheet-lead { max-width: 66ch; font-size: 17px; line-height: 1.5; letter-spacing: -.01em; overflow-wrap: anywhere; }
+  .plan-sheet-lead-long { font-size: 15px; line-height: 1.6; letter-spacing: 0; }
+  .plan-sheet-text { max-width: 66ch; font-size: 14px; line-height: 1.65; overflow-wrap: anywhere; white-space: pre-wrap; }
+  .plan-sheet-part { display: grid; align-content: start; gap: var(--so-space-sm); min-width: 0; max-width: 75ch; font-size: 14px; line-height: 1.6; overflow-wrap: anywhere; }
+  .plan-sheet-part > *, .plan-sheet-part p, .plan-sheet-part ul, .plan-sheet-part ol, .plan-sheet-part dl { margin: 0; }
+  .plan-sheet-h { margin: 0; font-size: 12px; font-weight: 500; line-height: 1.5; letter-spacing: 0; text-transform: none; color: var(--so-muted); }
+  .plan-sheet-sub { color: var(--so-muted); font-size: 12.5px; }
+  .plan-sheet-steps { display: grid; gap: var(--so-space-sm); padding: 0; list-style: none; counter-reset: plan-step; }
+  .plan-sheet-steps > li { display: flex; gap: var(--so-space-md); counter-increment: plan-step; }
+  .plan-sheet-steps > li::before { content: counter(plan-step); flex: 0 0 22px; box-sizing: border-box; width: 22px; height: 22px; border: 1px solid var(--so-line); border-radius: 50%; display: grid; place-items: center; font-size: 12px; color: var(--so-muted); font-variant-numeric: tabular-nums; }
+  .plan-sheet-steps > li > span { min-width: 0; padding-top: 1px; }
+  .plan-sheet-done { display: grid; padding: 0; list-style: none; }
+  .plan-sheet-done > li { display: flex; flex-wrap: wrap; align-items: baseline; gap: var(--so-space-xs) var(--so-space-md); padding: var(--so-space-sm) 0; border-bottom: 1px solid var(--so-line); }
+  .plan-sheet-done > li:last-child { border-bottom: 0; }
+  .plan-sheet-done > li > span:first-child { flex: 1 1 260px; min-width: 0; }
+  .plan-sheet-how { flex: none; font-size: 12.5px; color: var(--so-muted); }
+  .plan-sheet-pair { display: flex; flex-wrap: wrap; gap: var(--so-space-lg) 40px; }
+  .plan-sheet-pair > .plan-sheet-part { flex: 1 1 220px; }
+  .plan-sheet .approval-paths li { color: var(--so-ink); font-size: 13px; line-height: 1.7; }
+  .plan-sheet-list { display: grid; gap: var(--so-space-xs); padding-left: 1.25rem; }
+  .plan-sheet-warn { color: var(--so-ink); }
+  .plan-sheet .approval-amendment { margin: 0; }
+  .plan-sheet .approval-who, .plan-sheet .approval-evidence, .plan-sheet .approval-allowing, .plan-sheet .approval-you-check { margin: 0; }
+  .plan-sheet .approval-roles { margin: 0; }
+  .plan-sheet .revision-card { margin: 0; padding: 0; border: 0; background: none; }
   @media (max-width: 760px) {
     .approval-sheet { gap: var(--so-space-md); padding: 14px; }
     .approval-row { grid-template-columns: 1fr; gap: 2px; }
@@ -1564,7 +1593,7 @@
   .status-line { display: inline-flex; align-items: center; gap: .45rem; min-width: 0; font-size: .875rem; font-weight: 600; color: var(--foreground); }
   .status-line .status-label { min-width: 0; overflow-wrap: anywhere; }
   .status-line .status-dot { flex: none; width: .5rem; height: .5rem; border-radius: 50%; background: var(--muted-foreground); }
-  .status-line[data-tone="attention"] .status-dot { background: var(--warning); }
+  .status-line[data-tone="attention"] .status-dot { background: var(--so-needs); }
   .status-line[data-tone="problem"] .status-dot { background: var(--destructive); }
   .status-line[data-tone="live"] .status-dot { background: var(--running); box-shadow: 0 0 0 3px var(--running-soft); }
   .status-line[data-tone="ready"] .status-dot, .status-line[data-tone="done"] .status-dot { background: var(--success); }
@@ -1577,7 +1606,7 @@
   .pull-request-head strong { font-size: 1.0625rem; font-weight: 600; color: var(--foreground); display: inline-flex; align-items: center; gap: .5rem; }
   .pull-request-head strong::before { content: ""; width: .5rem; height: .5rem; border-radius: 999px; background: var(--muted-foreground); }
   .pull-request--ok .pull-request-head strong::before { background: var(--success, #15803d); }
-  .pull-request--problem .pull-request-head strong::before { background: var(--so-warning, #ab6400); }
+  .pull-request--problem .pull-request-head strong::before { background: var(--foreground); }
   .pull-request-act { display: flex; flex-wrap: wrap; align-items: flex-end; gap: .5rem .75rem; margin: .25rem 0 0; }
   .pull-request-act .meta { flex: 1 1 100%; }
   .pull-request-act label { display: grid; gap: .25rem; flex: 1 1 12rem; margin: 0; }
@@ -1813,7 +1842,7 @@
   }
   /* A lane is a frame (components/ui/frame.tsx, after ReUI's Frame): a raised well with a hairline, its head a
      status chip and a mono count on the well's fill, its cards paper panels at concentric corners. Only the lane
-     that waits on a person is amber: its chip, and each card's thin full outline. No fill, no stripe, no shadow. */
+     that waits on a person is ink: its chip, and each card's thin full outline. No fill, no stripe, no shadow. */
   .lane {
     background: var(--so-raised); border: 1px solid var(--so-line);
     border-radius: var(--so-radius-card); padding: .25rem; min-height: 12rem;
@@ -1830,7 +1859,7 @@
     background: var(--so-paper); border: 1px solid var(--so-line);
     border-radius: calc(var(--so-radius-card) - .25rem - 1px); padding: .625rem .75rem; margin-top: .25rem;
   }
-  .lane-attention .lane-card { border-color: var(--so-warning); }
+  .lane-attention .lane-card { border-color: var(--so-needs); }
   /* The order view's columns are frames too, with roomier insides (a form, a note) and a quiet dot by the name. */
   .lane.queue-column { padding: .5rem; }
   .queue-column > h2::before { content: ""; width: .375rem; height: .375rem; border-radius: var(--so-radius-full); flex: none; background: var(--muted-foreground); opacity: .55; }
@@ -2633,14 +2662,29 @@ button { min-height: 44px; }
    the same on both, swaps in place instead of fading (each shell names its
    own, so a page can never carry the name twice). */
 ::view-transition-old(root) { animation: so-page-leave 80ms ease-in both; }
-::view-transition-new(root) { animation: so-page-arrive 140ms ease-out 60ms both; }
+::view-transition-new(root) { animation: so-page-arrive 160ms ease-out 60ms both; }
 @keyframes so-page-leave { to { opacity: 0; } }
 @keyframes so-page-arrive { from { opacity: 0; } }
 .side { view-transition-name: so-nav-page; }
 .so-sidebar { view-transition-name: so-nav-app; }
-::view-transition-group(so-nav-page), ::view-transition-group(so-nav-app),
+.so-ph { view-transition-name: so-phone-header; }
+::view-transition-group(so-nav-page), ::view-transition-group(so-nav-app), ::view-transition-group(so-phone-header), ::view-transition-group(so-message-box),
 ::view-transition-old(so-nav-page), ::view-transition-new(so-nav-page),
-::view-transition-old(so-nav-app), ::view-transition-new(so-nav-app) { animation: none; }
+::view-transition-old(so-nav-app), ::view-transition-new(so-nav-app),
+::view-transition-old(so-phone-header), ::view-transition-new(so-phone-header),
+::view-transition-old(so-message-box), ::view-transition-new(so-message-box) { animation: none; }
+/* A page changed in place (docs/plans/live-pages-and-home.md A2.2, browser/transition.ts): only the page content
+   moves; everything else (the root, the sidebar, the phone header, the message box) swaps where it stands. The same
+   level fades through like a document load (80 ms out, 160 ms in); deeper, the new page also moves 8px in from the
+   right over 200 ms; shallower, from the left. Nothing runs past 220 ms. */
+html.so-nav #workspace-main { view-transition-name: so-page; }
+html.so-nav::view-transition-old(root), html.so-nav::view-transition-new(root), html.so-nav::view-transition-group(so-page) { animation: none; }
+html.so-nav::view-transition-old(so-page) { animation: so-page-leave 80ms ease-in both; }
+html.so-nav-same::view-transition-new(so-page) { animation: so-page-arrive 160ms ease-out 60ms both; }
+html.so-nav-deeper::view-transition-new(so-page) { animation: so-page-deeper 200ms cubic-bezier(.2, .8, .2, 1) both; }
+html.so-nav-shallower::view-transition-new(so-page) { animation: so-page-shallower 200ms cubic-bezier(.2, .8, .2, 1) both; }
+@keyframes so-page-deeper { from { opacity: 0; transform: translateX(8px); } }
+@keyframes so-page-shallower { from { opacity: 0; transform: translateX(-8px); } }
 /* UI polish 2026-09-13 — the motion contract. Feedback transitions run
    140–200 ms on color, border, shadow, opacity, and transform only; an
    overlay's entrance is at most 220 ms of opacity + transform. Nothing
@@ -2670,7 +2714,7 @@ button { min-height: 44px; }
 @keyframes fade { from { opacity: 0; } }
 @media (prefers-reduced-motion: reduce) {
   *, *::before, *::after { animation: none !important; transition: none !important; }
-  ::view-transition-group(*), ::view-transition-old(root), ::view-transition-new(root) { animation: none; }
+  ::view-transition-group(*), ::view-transition-old(*), ::view-transition-new(*) { animation: none !important; }
   button:active, :is(.button-link, .side .new-task, .content .new-task, .result-feedback-link, .next-pager .skip):active { transform: none; }
   @media (hover: hover) and (pointer: fine) { button:hover, .side nav a:hover, .chat-project-card:hover, .lane-card:hover, .decide-card:hover, .menu-row:hover { transform: none; } }
 }
@@ -2854,9 +2898,9 @@ html.so-swap::view-transition-old(*):only-child { animation: so-card-out 160ms e
 .tc-c0 { color: var(--so-ink); stroke: var(--so-ink); }
 .tc-c1 { color: var(--so-info); stroke: var(--so-info); }
 .tc-c2 { color: var(--so-success); stroke: var(--so-success); }
-.tc-c3 { color: var(--so-warning); stroke: var(--so-warning); }
+.tc-c3 { color: var(--so-muted); stroke: var(--so-muted); }
 .tc-c4 { color: var(--so-danger); stroke: var(--so-danger); }
-.tc-c5 { color: var(--so-muted); stroke: var(--so-muted); }
+.tc-c5 { color: var(--so-input-line); stroke: var(--so-input-line); }
 .tc-line { margin: 0; display: grid; gap: var(--so-space-xs); }
 .tc-line svg { width: 100%; height: 90px; }
 .tc-line figcaption { font-size: 11.5px; color: var(--so-muted); }

package/dist/server/home.d.ts

@@ -1,14 +1,20 @@
 /**
- * Home ("/", UI revamp wave B): one sentence that answers "what needs me?", four counts read from the same work index
- * the Tasks list filters (so a count and the list it opens always agree), the work in three groups (Waiting on you,
- * Working, Done; home-groups.ts), and the lead's message box. Reads only: every act keeps its own route and rules (an agent's
- * question is answered through POST /d/<id>/answer, the same one-click act as its own page).
+ * Home ("/", docs/plans/live-pages-and-home.md B1): what needs this person, grouped by what is asked (Approve a plan,
+ * Answer a question, Something went wrong, Review results, and Needs you for the rest), each group with its exact
+ * count; one quiet line for what runs and waits; with nothing waiting, what runs and what finished today. The figures
+ * are read from the same work index the Tasks list filters, so a count and the list it opens always agree. Reads
+ * only: every act keeps its own route and rules (an agent's question is answered through POST /d/<id>/answer, the
+ * same one-click act as its own page).
  */
-import type { BrowserHomeView } from "../browser-workspace.js";
+import type { BrowserHomeAsk, BrowserHomeView } from "../browser-workspace.js";
 import type { Store } from "../store.js";
 import type { WorkSummaryAccess } from "../work-summary.js";
-/** How many waiting rows Home lists; the rest open in Tasks. */
+/** How many waiting rows Home lists; each group says how many more open in Tasks. */
 export declare const HOME_NEEDS_SHOWN = 30;
+/** How many rows finished today Home lists; its figure counts them all. */
+export declare const HOME_DONE_SHOWN = 8;
+/** Each group's heading, in the order Home shows them. */
+export declare const HOME_ASK_LABEL: Readonly<Record<BrowserHomeAsk, string>>;
 export type HomeFacts = {
     store: Store;
     now: Date;
@@ -16,7 +22,7 @@ export type HomeFacts = {
     evidenceRoot?: string;
     /** The project in view (already admitted), or null for every project. */
     project: string | null;
-    /** Every admitted project, for the scope links. */
+    /** Every admitted project, for the project filter. */
     projects: readonly {
         name: string;
         path: string;
@@ -31,12 +37,19 @@ export type HomeFacts = {
         why: string;
         road: "scope" | "agents";
     } | null;
+    /** The lead's last message in this person's main thread, already read through the chat's own access check
+     * (pages.ts leadLastMessage); null when there is none or this person may not read that thread. */
+    leadMessage?: {
+        text: string;
+        at: string;
+    } | null;
 };
-/** "7 need you across 2 projects." — the sentence and the figures read the same totals. */
-export declare function homeSentence(needs: number, perProject: readonly {
-    name: string;
-    needs: number;
-}[], scope: string | null, any: boolean): string;
-/** Home's view for one person and scope, from four reads of the work index (what waits on you, what runs, what waits on
- * Toolroll, what was done), grouped by the one rule every surface shares (home-groups.ts). */
+/** "19 tasks need you": the heading, said once, from the same total as the rail's count. */
+export declare function homeSentence(needs: number, any: boolean): string;
+/** The lead's words as one plain line: no markdown marks, no line breaks, cut to about one line. */
+export declare function leadLineOf(text: string): string;
+/** Midnight today on this computer's clock: "finished today" starts here. */
+export declare function startOfToday(now: Date): Date;
+/** Home's view for one person and scope, from four reads of the work index: what waits on you (with exact per-ask
+ * totals), what runs, what waits its turn, and what was completed today (filtered before its limit). */
 export declare function homeView(facts: HomeFacts): BrowserHomeView;