toolroll 0.9.85 → 0.9.87

package/dist/server/render-tasks.d.ts

@@ -17,12 +17,11 @@ import { type CriterionMatrixRow, type ProofVerdict } from "../proof.js";
 import { type Phase } from "../provider.js";
 import { type QualityMode } from "../quality.js";
 import { type AcceptanceCriterion, type Scope, type UnattendedPermissionMode } from "../scope.js";
-import { type Artifact, type CheckProgress, type CoordinatorProposal, type Decision, type ExternalMirror, type Hold, type Incident, type PlanRevisionKind, type PlanRevisionStatus, type Publication, type PublicationGrant, type RepairChainRow, type ReviewRetryState, type RevisionLineage, type Run, type SteerNote, type Store, type Task } from "../store.js";
+import { type CheckProgress, type CoordinatorProposal, type Decision, type ExternalMirror, type Hold, type Incident, type PlanRevisionKind, type PlanRevisionStatus, type Publication, type PublicationGrant, type RepairChainRow, type ReviewRetryState, type RevisionLineage, type Run, type SteerNote, type Store, type Task } from "../store.js";
 import { type TaskControlView } from "../task-control.js";
 import { type DisplayStatus, type PublicationFacts, type ReviewFacts, type WorkStatus } from "../workspace-ui.js";
 import { type Chrome, type Screen } from "./chrome.js";
 import { type CompletionReceiptView, type EvidenceLinkMap, type TaskPullRequest } from "./render-results.js";
-import { type Who } from "./session.js";
 import { type TaskOrigin } from "../task-source.js";
 /** What the task and approval views show about a drafted plan's contract
  * (contract handoff, task 1). A problem is a named problem, never a blank. */
@@ -75,7 +74,7 @@ export declare function revisionSentence(revision: Extract<RevisionView, {
 /** A planner's amendment, said plainly and kept in view: approving binds
  * the amended terms, so this is never folded away. */
 export declare function approvalAmendmentHtml(view: PlanContractView | null | undefined): Html;
-export declare function approvalSheetHtml(input: {
+export type ApprovalSheetInput = {
     surface: "task" | "chat";
     action: string;
     csrf: string;
@@ -120,7 +119,24 @@ export declare function approvalSheetHtml(input: {
     } | null;
     /** Cockpit B2: this person's password is remembered (when, ISO) and these terms may stand on it. */
     freshSince?: string | null;
-}): Html;
+};
+/** The approval sheet: one form that restates every term it signs, the password, and Approve & start. */
+export declare function approvalSheetHtml(input: ApprovalSheetInput): Html;
+/** The approval sheet's parts: what it says first, the signed rows, the in-place editor and its own form, the
+ * details fold, and the words the act and its outcome use. The task page (src/design/KIT.md) shows the rows in its
+ * Plan tab and the act in its approval box; the chat and /next keep the one sheet. */
+export declare function approvalSheetParts(input: ApprovalSheetInput): {
+    lead: Html;
+    rows: Html;
+    editor: Html | null;
+    editorForm: Html | string;
+    details: Html;
+    submit: Html;
+    label: string;
+    after: Html;
+    allowing: string[];
+    passwordNote: string;
+};
 /** Earlier versions of a task still in flight, in plain words: queued
  * while they only wait, running once one has started; null when none. */
 export declare function earlierVersionsWords(active: number, running: number): string | null;
@@ -438,6 +454,14 @@ export declare function taskBodyParts(data: {
     /** Markup the caller rendered (the version history). */
     history?: Html;
     versionLabel?: string | null;
+    /** Put away (v145): by whom and why; and whether the viewer can put it away or restore it (an approver's browser). */
+    archived?: {
+        by: string;
+        byKind: "person" | "tidy";
+        reason: string;
+        at: string;
+    } | null;
+    canPutAway?: boolean;
     status?: DisplayStatus;
     task: Task;
     /** Shared read-side lifecycle answer; the atomic claim still re-proves it. */
@@ -685,9 +709,23 @@ export declare function qualityModeChoices(name: string, selected: QualityMode):
  * writes the field); kept for callers.
  */
 export declare function decisionOptionForms(decision: Decision, returnTo: string | null): Html;
-export declare function decisionPage(chrome: Chrome, decision: Decision, taskId: string, artifacts: Artifact[], who: Who, now: Date, returnTo?: string | null): Screen;
 export declare function taskOf(store: Store, decision: Decision): string;
 /** A release task's own card (release-once.md, "What people see"): the release it's approved for, the later commits
  * carried under it (on demand), what a later check must run again, the last nightly check of main, and one action to
  * stop carrying. A carried task says whose approval it was carried from. */
 export declare function releaseCardHtml(taskId: string, release: ReleaseView | null, canStop: boolean): Html;
+/** The task page's approval box (src/design/KIT.md): what it asks, the act's own form fields, and the facts the
+ * approve control reads to show a password, one click, or nothing. The rows it signs go to the Plan tab (`planHtml`).
+ * These decide only what the page shows: the approve route proves the person, the freshness and the digest again. */
+export declare function approveKitOf(input: ApprovalSheetInput, freshSince: string | null): NonNullable<BrowserTaskView["approve"]>;
+/** How an approved plan was approved, for the status box's terms line: by whom and how, or the rule that approved it. */
+export declare function approvedKitOf(scope: Scope, approval: {
+    approved: true;
+    at: string;
+    by: string;
+} | {
+    approved: false;
+}, proof: {
+    method: string;
+    at: string;
+} | null): NonNullable<BrowserTaskView["approved"]> | null;

package/dist/server/render-tasks.js

@@ -1,4 +1,6 @@
 /** Task pages: approval, agents, plans, controls, decisions and the task body. */
+import { archivedWords } from "../tidy.js";
+import { whenUtc } from "../when-html.js";
 import { networkWords } from "../egress.js";
 import { releaseAsksAgainWords, releaseTermsSentence } from "../scope.js";
 import { RELEASE_CI_RUNNING_WORDS } from "../release-ci-hold.js";
@@ -6,7 +8,7 @@ import { writesWords } from "../writes-mode.js";
 import { checkAccessWords } from "../check-access.js";
 import { sandboxTermsWords } from "../project-sandbox.js";
 import { ACP_AGENTS, isAcpProfile } from "../acp-agents.js";
-import { html, htmlString, joinHtml, postForm, replaceMarkup, reauth } from "../html.js";
+import { html, htmlString, joinHtml, passwordlessRendering, postForm, replaceMarkup, reauth } from "../html.js";
 import { closedQuestionReason, closedQuestionWords } from "../decision.js";
 import {} from "../activity-line.js";
 import {} from "../agentconfig.js";
@@ -36,7 +38,7 @@ import { agentModelName } from "../model-names.js";
 import {} from "../provider.js";
 import { qualityModeTitle } from "../quality.js";
 import { evidenceShortenedWords } from "../result-review.js";
-import { acceptanceToLines, approvalOf, scopeAuthorityOf } from "../scope.js";
+import { acceptanceToLines, approvalOf, freshUntil, scopeAuthorityOf } from "../scope.js";
 import {} from "../store.js";
 import { runCostWords } from "../summary.js";
 import {} from "../task-control.js";
@@ -228,7 +230,34 @@ function originParts(origin) {
     }
     return parts;
 }
+/** The approval sheet: one form that restates every term it signs, the password, and Approve & start. */
 export function approvalSheetHtml(input) {
+    const parts = approvalSheetParts(input);
+    return joinHtml([
+        postForm(input.action, joinHtml([
+            html `<input type="text" name="username" autocomplete="username" class="visually-hidden" tabindex="-1" aria-hidden="true">`,
+            parts.lead,
+            parts.rows,
+            html `<div class="approval-act" id="${input.surface === "task" ? "approval-confirm" : "chat-approval-confirm"}">`,
+            html `${reauth(html `<label class="approval-password"><span class="visually-hidden">Your password</span><input type="password" name="token" autocomplete="current-password" placeholder="Your password" aria-describedby="${parts.passwordNote}"></label>`)}`,
+            input.freshSince == null ? html `<p class="approval-password-note" id="${parts.passwordNote}">Your password signs this approval.</p>`
+                : html `<p class="approval-password-note" id="${parts.passwordNote}" data-approval-fresh>Your password from ${whenTime(input.freshSince)} is remembered on this computer — leave this blank to approve with it, or type it again.</p>`,
+            html `<button type="submit" data-primary-action>${parts.submit}</button></div>`,
+            html `<p class="approval-after">${parts.after}</p>`,
+            html `<div class="approval-secondary">${parts.editor ?? html `<a class="approval-link" href="${input.editHref}">Edit plan</a>`}<a class="approval-link" href="${input.notNowHref}">Not now</a></div>`,
+            parts.details,
+        ]), {
+            attrs: { class: "approve-form approval-sheet", id: input.surface === "task" ? "approve" : null, "data-sticky": input.sticky },
+            hidden: { nonce: input.nonce, digest: input.digest, ...(input.rebuild == null ? {} : { rebuild: String(input.rebuild) }) },
+            returnTo: input.returnTo,
+        }),
+        parts.editorForm,
+    ]);
+}
+/** The approval sheet's parts: what it says first, the signed rows, the in-place editor and its own form, the
+ * details fold, and the words the act and its outcome use. The task page (src/design/KIT.md) shows the rows in its
+ * Plan tab and the act in its approval box; the chat and /next keep the one sheet. */
+export function approvalSheetParts(input) {
     const { scope, route } = input;
     // A machine-drafted repair appends its brief to the signed goal; the row
     // shows the goal and one sentence says what the repair fixes. The whole
@@ -390,40 +419,27 @@ export function approvalSheetHtml(input) {
             "budget-microusd": scope.budgetMicrousd === null ? "none" : String(scope.budgetMicrousd),
         },
     });
-    return joinHtml([
-        postForm(input.action, joinHtml([
-            html `<input type="text" name="username" autocomplete="username" class="visually-hidden" tabindex="-1" aria-hidden="true">`,
-            html `<h2 class="approval-sheet-title">${input.deliverable === "report" ? "The investigation" : "The plan"}</h2>`,
-            sentence === null ? "" : html `<p class="approval-revision">${sentence}</p>`,
-            input.coordinator === null ? "" : html `<p class="approval-note">An agent filed this: <span class="mono">${input.coordinator.label}</span>${input.coordinator.filedAgo === null ? "" : html `, ${input.coordinator.filedAgo}`}. Nothing runs until you approve, and approving runs its request.</p>`,
-            input.deliverable === "report" ? html `<p class="approval-note">Read-only: it reports back and changes nothing in the repository.</p>` : "",
-            originNote(input.origin) === null ? "" : html `<p class="approval-note" data-approval-origin>${originNote(input.origin)}</p>`,
-            html `<dl class="approval-rows">`,
-            row("Goal", html `<p class="approval-goal">${goalShown}</p>`),
-            row("Changes", changes),
-            row("Won’t touch", html `<p>${scope.outOfScope === null ? "Nothing is ruled out." : scope.outOfScope}</p>`),
-            row("Done when", doneWhen),
-            html `</dl>`,
-            amendment,
-            // The size, said once and plainly beside who builds: "Small change: fast model, no plan".
-            projection === null ? "" : sizeLineHtml(projection),
-            who.length === 0 ? "" : html `<p class="approval-who">${who.join(" · ")}</p>`,
-            consent,
-            html `<div class="approval-act" id="${input.surface === "task" ? "approval-confirm" : "chat-approval-confirm"}">`,
-            html `${reauth(html `<label class="approval-password"><span class="visually-hidden">Your password</span><input type="password" name="token" autocomplete="current-password" placeholder="Your password" aria-describedby="${passwordNote}"></label>`)}`,
-            input.freshSince == null ? html `<p class="approval-password-note" id="${passwordNote}">Your password signs this approval.</p>`
-                : html `<p class="approval-password-note" id="${passwordNote}" data-approval-fresh>Your password from ${whenTime(input.freshSince)} is remembered on this computer — leave this blank to approve with it, or type it again.</p>`,
-            html `<button type="submit" data-primary-action>${submit}</button></div>`,
-            html `<p class="approval-after">${after}</p>`,
-            html `<div class="approval-secondary">${editor ?? html `<a class="approval-link" href="${input.editHref}">Edit plan</a>`}<a class="approval-link" href="${input.notNowHref}">Not now</a></div>`,
-            details,
-        ]), {
-            attrs: { class: "approve-form approval-sheet", id: input.surface === "task" ? "approve" : null, "data-sticky": input.sticky },
-            hidden: { nonce: input.nonce, digest: input.digest, ...(rebuild === null ? {} : { rebuild: String(rebuild) }) },
-            returnTo: input.returnTo,
-        }),
-        editorForm,
+    const lead = joinHtml([
+        html `<h2 class="approval-sheet-title">${input.deliverable === "report" ? "The investigation" : "The plan"}</h2>`,
+        sentence === null ? "" : html `<p class="approval-revision">${sentence}</p>`,
+        input.coordinator === null ? "" : html `<p class="approval-note">An agent filed this: <span class="mono">${input.coordinator.label}</span>${input.coordinator.filedAgo === null ? "" : html `, ${input.coordinator.filedAgo}`}. Nothing runs until you approve, and approving runs its request.</p>`,
+        input.deliverable === "report" ? html `<p class="approval-note">Read-only: it reports back and changes nothing in the repository.</p>` : "",
+        originNote(input.origin) === null ? "" : html `<p class="approval-note" data-approval-origin>${originNote(input.origin)}</p>`,
     ]);
+    const rows = joinHtml([
+        html `<dl class="approval-rows">`,
+        row("Goal", html `<p class="approval-goal">${goalShown}</p>`),
+        row("Changes", changes),
+        row("Won’t touch", html `<p>${scope.outOfScope === null ? "Nothing is ruled out." : scope.outOfScope}</p>`),
+        row("Done when", doneWhen),
+        html `</dl>`,
+        amendment,
+        // The size, said once and plainly beside who builds: "Small change: fast model, no plan".
+        projection === null ? "" : sizeLineHtml(projection),
+        who.length === 0 ? "" : html `<p class="approval-who">${who.join(" · ")}</p>`,
+        consent,
+    ]);
+    return { lead, rows, editor, editorForm, details, submit, label: rebuild !== null ? "Approve and build again" : "Approve and start", after, allowing, passwordNote };
 }
 /** Earlier versions of a task still in flight, in plain words: queued
  * while they only wait, running once one has started; null when none. */
@@ -774,6 +790,8 @@ export function approveRefusalWords(reason) {
         return gateWords({ verdict: "refuse", reason });
     if (reason === "machine-proof")
         return "not approved: only a person can approve this. Approve it on the task page or from your paired chat";
+    if (reason === "archived")
+        return "not approved: this task is put away. Restore it first";
     if (reason === "unrouted")
         return "not approved: this scope predates agent routing and its old approval no longer stands — edit and re-file the scope so it is routed under today’s agents, then approve it";
     if (reason === "profile-unresolved")
@@ -1623,6 +1641,36 @@ export function taskBodyParts(data) {
     // assignment's one action): then it is shown open under the status, never folded.
     const approvalLeads = data.dispatch?.action === "approve-scope" ||
         (data.assignment?.primaryAction?.code === "approve-scope" && data.assignment.primaryAction.target.taskId === task.id);
+    // The sheet's terms, when this person can approve them here: the task page's kit approval box (its Plan tab shows
+    // the rows) and the legacy sheet both read these.
+    const sheetInput = scope === null || approval.approved || data.plan === "requested" || (data.revision != null && "problem" in data.revision) ||
+        scope.profileState === "unresolved" || !consentDoor.open ? null : {
+        surface: "task",
+        action: `${taskHref(task.id)}/approve`,
+        csrf: data.csrf,
+        nonce: data.nonce,
+        digest: data.approvalDigest ?? scope.digest,
+        freshSince: data.approvalFresh ?? null,
+        returnTo: null,
+        scope,
+        planDocument: data.plan === "drafted" ? data.planDocument : null,
+        planContract: data.plan === "drafted" ? data.planContract ?? null : null,
+        revision: data.revision == null || "problem" in data.revision ? null : data.revision,
+        revisionSourceHref: data.revision == null || "problem" in data.revision ? "" : `/r/${data.revision.sourceRun}`,
+        repairChain: data.repairChain ?? null,
+        route: data.route,
+        coordinator: data.coordinator ?? null,
+        origin: data.origin ?? null,
+        deliverable: data.deliverable ?? "branch",
+        rebuild: data.assignment?.need != null && "key" in data.assignment.need && data.assignment.need.key === "replan" ? data.assignment.need.build : null,
+        editHref: data.csrf !== "" && data.planSha != null && data.planDocument !== null ? "#plan-edit" : "#scope",
+        notNowHref: "/work",
+        sticky: approvalLeads,
+        earlier: { active: data.assignment?.earlierActive ?? 0, running: data.assignment?.earlierRunning ?? 0 },
+        edit: data.csrf === "" ? null
+            : { action: `${taskHref(task.id)}/scope`, draft: inlineScopeDraft ? data.scopeDraft ?? null : null, problem: inlineScopeDraft ? data.problem : null,
+                open: data.editPlan === true, stepsHref: data.planSha != null && data.planDocument !== null ? "#plan-edit" : null },
+    };
     const approveForm = scope === null || approval.approved || data.plan === "requested"
         ? ""
         : data.revision !== null && data.revision !== undefined && "problem" in data.revision
@@ -1631,33 +1679,7 @@ export function taskBodyParts(data) {
                 ? html `<div class="card approve-form" id="approve"><p><strong>This task is waiting on you: its scope cannot be approved yet.</strong></p>${profileWords(scope)}<p class="ceremony-road"><a class="button-link" href="#scope">Edit the scope to fix it →</a></p></div>`
                 : !consentDoor.open
                     ? consentClosedHtml(task.id, consentDoor, "task")
-                    : approvalSheetHtml({
-                        surface: "task",
-                        action: `${taskHref(task.id)}/approve`,
-                        csrf: data.csrf,
-                        nonce: data.nonce,
-                        digest: data.approvalDigest ?? scope.digest,
-                        freshSince: data.approvalFresh ?? null,
-                        returnTo: null,
-                        scope,
-                        planDocument: data.plan === "drafted" ? data.planDocument : null,
-                        planContract: data.plan === "drafted" ? data.planContract ?? null : null,
-                        revision: data.revision == null || "problem" in data.revision ? null : data.revision,
-                        revisionSourceHref: data.revision == null || "problem" in data.revision ? "" : `/r/${data.revision.sourceRun}`,
-                        repairChain: data.repairChain ?? null,
-                        route: data.route,
-                        coordinator: data.coordinator ?? null,
-                        origin: data.origin ?? null,
-                        deliverable: data.deliverable ?? "branch",
-                        rebuild: data.assignment?.need != null && "key" in data.assignment.need && data.assignment.need.key === "replan" ? data.assignment.need.build : null,
-                        editHref: data.csrf !== "" && data.planSha != null && data.planDocument !== null ? "#plan-edit" : "#scope",
-                        notNowHref: "/work",
-                        sticky: approvalLeads,
-                        earlier: { active: data.assignment?.earlierActive ?? 0, running: data.assignment?.earlierRunning ?? 0 },
-                        edit: data.csrf === "" ? null
-                            : { action: `${taskHref(task.id)}/scope`, draft: inlineScopeDraft ? data.scopeDraft ?? null : null, problem: inlineScopeDraft ? data.problem : null,
-                                open: data.editPlan === true, stepsHref: data.planSha != null && data.planDocument !== null ? "#plan-edit" : null },
-                    });
+                    : approvalSheetHtml(sheetInput);
     const scopeForm = joinHtml([
         html `<details${scope === null || scopeDraft !== undefined ? html ` open` : ""}><summary>${scope === null ? "Write the scope" : "Edit the scope"}${approval.approved ? " (editing voids the approval)" : ""}</summary>`,
         postForm(`${taskHref(task.id)}/scope`, joinHtml([
@@ -2068,8 +2090,11 @@ export function taskBodyParts(data) {
         // The title is bare; the receipt or shared task status leads once.
         html `<div class="task-title-row"><h1 class="task-main-title">${data.rootTitle ?? task.title}</h1>${data.csrf === "" ? "" : taskViewSwitch(data.rootId ?? task.id, "overview")}</div>`,
         data.versionLabel == null ? "" : html `<p class="meta">${data.versionLabel} · <a href="${taskHref(data.rootId ?? task.id)}">Current work</a></p>`,
+        data.archived == null ? "" : html `<div class="task-archived" data-archived><p>${archivedWords(data.archived)} · ${whenUtc(data.archived.at)}</p>${data.canPutAway === true && data.csrf !== ""
+            ? postForm(`${taskHref(task.id)}/restore`, html `<button type="submit" class="secondary">Restore</button>`, { hidden: { return: taskHref(task.id) }, attrs: { class: "inline" } }) : ""}</div>`,
         (data.history ?? ""),
-        statusHtml,
+        // A put-away task's banner is its status: no Needs you card, no act, no approval form (each would be refused).
+        data.archived == null ? statusHtml : "",
         controlHtml,
         previousResult === null ? "" : html `<details class="task-previous-result"><summary>${previousResult.title}</summary>${previousResult.html}</details>`,
         progressCard,
@@ -2078,7 +2103,7 @@ export function taskBodyParts(data) {
         mirrorCard,
         problemHtml,
         needsScopeCard,
-        approvalHtml,
+        data.archived == null ? approvalHtml : "",
         html `<details class="task-status-details" id="task-diagnostics"${optionsOpen ? html ` open` : ""}><summary>Task options</summary>${optionsHtml}</details>`,
         // Evidence-first (M5.5): what needs you, then what happened — decisions
         // and incidents above the attempt ledger and spend, the mechanics
@@ -2209,7 +2234,8 @@ export function taskBodyParts(data) {
     // The Details panel: the same facts, grouped and said once.
     const lastRunForAgent = liveRun ?? familyRuns.filter(run => run.role !== "reviewer").sort((a, b) => b.id - a.id)[0];
     const work = [];
-    work.push({ label: "Status", parts: [data.assignment != null && assignmentOptions !== null ? assignmentCardOf(data.assignment, assignmentOptions).status.headline : status.label] });
+    // A put-away task's one status is Archived (its banner says by whom and why).
+    work.push({ label: "Status", parts: [data.archived != null ? "Archived" : data.assignment != null && assignmentOptions !== null ? assignmentCardOf(data.assignment, assignmentOptions).status.headline : status.label] });
     if (data.repo !== null)
         work.push({ label: "Project", parts: [projectName(data.repo)] });
     if (data.base != null)
@@ -2320,6 +2346,7 @@ export function taskBodyParts(data) {
         ...(sectionIds.has("waits-for") ? [{ group: "work", label: "Dependencies", kind: "goto", tab: "plan", target: "waits-for" }] : []),
         ...(sectionIds.has("holds") ? [{ group: "work", label: "Holds", kind: "goto", tab: "plan", target: "holds" }] : []),
         ...(data.csrf !== "" ? [{ group: "work", label: "Task options", kind: "goto", tab: "plan", target: "task-diagnostics" }] : []),
+        ...(data.canPutAway === true && data.csrf !== "" && data.archived == null && !building ? [{ group: "work", label: "Put away", kind: "post", action: `${taskHref(task.id)}/archive`, fields: { return: taskHref(task.id) } }] : []),
         { group: "share", label: "Copy link", kind: "copy" },
         ...(facts.some(one => one.label === "Audit") ? [{ group: "share", label: "Evidence pack", kind: "link", href: `${taskHref(rootOf)}/evidence` }] : []),
         ...(data.repo !== null && data.scope !== null ? [{ group: "share", label: "Reuse as recipe", kind: "link", href: `/recipes/from-task?task=${encodeURIComponent(task.id)}` }] : []),
@@ -2336,10 +2363,12 @@ export function taskBodyParts(data) {
             { label: "Ask", href: taskChatHref(data.rootId ?? task.id), active: false },
         ],
         version: data.versionLabel == null ? null : { label: data.versionLabel, current: { label: "Current work", href: taskHref(data.rootId ?? task.id) } },
-        status: statusCard === null ? null : inPlaceChecks(failedCard ? { ...statusCard, action: null, status: { ...statusCard.status, sentence: data.failure?.line ?? statusCard.status.sentence } }
+        archived: data.archived == null ? null : { words: archivedWords(data.archived), at: data.archived.at,
+            restore: data.canPutAway === true && data.csrf !== "" ? { action: `${taskHref(task.id)}/restore`, returnTo: taskHref(task.id) } : null },
+        status: statusCard === null || data.archived != null ? null : inPlaceChecks(failedCard ? { ...statusCard, action: null, status: { ...statusCard.status, sentence: data.failure?.line ?? statusCard.status.sentence } }
             : progress !== null || record !== null ? { ...statusCard, action: statusCard.action?.href === record?.href ? null : statusCard.action, status: { ...statusCard.status, sentence: progress?.line ?? statusCard.status.sentence } }
                 : statusCard.action !== null && rebuild === null && bareSelfLink(statusCard.action.href) ? { ...statusCard, action: null } : statusCard),
-        statusHtml: htmlString(statusHtml),
+        statusHtml: data.archived != null ? "" : htmlString(statusHtml),
         failure: failedCard && data.failure != null ? { line: data.failure.line, evidence: data.failure.evidence, suggestion: data.failure.suggestion, link: data.failure.link } : null,
         retry,
         runChecks,
@@ -2352,8 +2381,11 @@ export function taskBodyParts(data) {
         ...(data.csrf !== "" && (data.steerRecent?.length ?? 0) > 0 ? { steerRecent: data.steerRecent } : {}),
         record,
         earlier,
-        approval: fragmentString(approvalHtml),
+        approval: data.archived != null ? "" : fragmentString(approvalHtml),
         approvalPlacement: approvalLeads ? "lead" : "plan",
+        // The kit's approval box (src/design/KIT.md): the act, by the real rules, with the rows in the Plan tab.
+        approve: data.archived != null || sheetInput === null || dependencyChoiceNeeded || data.csrf === "" ? null : approveKitOf(sheetInput, data.approvalFresh ?? null),
+        approved: scope !== null && approval.approved ? approvedKitOf(scope, approval, data.approvalProof ?? null) : null,
         more,
         confirmStopped: data.csrf !== "" && data.assignment?.primaryAction?.code === "confirm-stopped" && data.assignment.primaryAction.target.runId !== null
             ? { action: `${taskHref(data.assignment.rootId)}/confirm-stopped`, run: data.assignment.primaryAction.target.runId, checked: needsCheck(data.assignment) } : null,
@@ -2477,29 +2509,6 @@ export function decisionOptionForms(decision, returnTo) {
             : html `<details class="arm-danger"><summary>${option.label} — irreversible, tap to arm</summary>${inner}</details>`;
     }), "\n");
 }
-export function decisionPage(chrome, decision, taskId, artifacts, who, now, returnTo = null) {
-    const options = decisionOptionForms(decision, returnTo);
-    const answered = decision.supersededReason !== null
-        ? html `<p class="meta">${closedQuestionReason(decision.supersededReason)}</p>`
-        : decision.state === "answered"
-            ? html `<div class="answered">Answered: <strong>${decision.choice ?? ""}</strong> by ${decision.answeredBy ?? ""}${decision.note === null ? "" : ` — ${decision.note}`}</div>`
-            : "";
-    const evidence = artifacts.length === 0
-        ? ""
-        : joinHtml([
-            html `<div class="evidence"><strong>Evidence</strong>`,
-            joinHtml(artifacts.map(artifact => html `<a href="/d/${decision.id}/evidence/${artifact.id}">${evidenceWords(artifact.kind)}${artifact.truncated ? " (truncated)" : ""} · ${artifact.bytesStored} bytes</a>`), "\n"),
-            html `</div>`,
-        ]);
-    return screen(`decide · ${taskId}`, joinHtml([
-        html `<h1>${taskId} <span class="badge badge-${decision.state}">${decision.supersededReason !== null ? "closed" : decision.state}</span>${isOverdue(decision, now) ? html ` <span class="badge badge-overdue">Overdue</span>` : ""}${decision.deadline === null ? "" : html ` <span class="meta">deadline ${decision.deadline}</span>`}</h1>`,
-        html `<div class="recap">${decision.recap}</div>`,
-        html `<div class="question">${decision.question}</div>`,
-        decision.state === "answered" ? answered : options,
-        evidence,
-        html `<p class="meta"><a href="${returnTo === null ? "/" : returnTo}">← ${returnTo === null ? "everything waiting" : "back to the task chat"}</a></p>`,
-    ], "\n"), { chrome });
-}
 export function taskOf(store, decision) {
     const run = store.getRun(decision.run);
     return run === null ? "?" : store.externalIdFor(run.taskRef) ?? "?";
@@ -2527,3 +2536,34 @@ export function releaseCardHtml(taskId, release, canStop) {
         html `</div>`,
     ], "\n");
 }
+/** The task page's approval box (src/design/KIT.md): what it asks, the act's own form fields, and the facts the
+ * approve control reads to show a password, one click, or nothing. The rows it signs go to the Plan tab (`planHtml`).
+ * These decide only what the page shows: the approve route proves the person, the freshness and the digest again. */
+export function approveKitOf(input, freshSince) {
+    const parts = approvalSheetParts(input);
+    const rebuild = input.rebuild ?? null;
+    const after = rebuild !== null ? "builds it again to this plan" : input.deliverable === "report" ? "starts the investigation" : "starts the build";
+    const allowing = parts.allowing.length === 0 ? "" : ` You’re allowing ${parts.allowing.join(", ")}.`;
+    const until = freshSince === null ? null : freshUntil(freshSince);
+    return {
+        action: input.action,
+        fields: { nonce: input.nonce, digest: input.digest, ...(rebuild === null ? {} : { rebuild: String(rebuild) }) },
+        label: parts.label,
+        heading: rebuild !== null ? "The plan changed" : input.deliverable === "report" ? "Investigation ready" : "Plan ready",
+        text: `Approving signs plan version ${input.scope.digest.slice(0, 12)} and ${after}.${allowing}`,
+        kind: "standard",
+        facts: { passwordless: passwordlessRendering(), remembered: until !== null },
+        rememberedUntil: until,
+        planHtml: htmlString(joinHtml([parts.lead, parts.rows, parts.editor ?? "", parts.details, parts.editorForm])),
+    };
+}
+/** How an approved plan was approved, for the status box's terms line: by whom and how, or the rule that approved it. */
+export function approvedKitOf(scope, approval, proof) {
+    if (!approval.approved)
+        return null;
+    const basis = scope.approvalBasis ?? null;
+    const rule = basis === "mode" ? "your operating mode for this project" : basis === "grant" ? "its flow, which runs on its own" : basis === "schedule" ? "the schedule you approved"
+        : basis === "auto-green" || basis === "auto-check" ? "this project’s release approval (CI and the release check passed)" : basis === "carried" ? "the release approval it was carried under" : null;
+    const how = approvalProofWords(proof).replace(/^ \(|\)$/g, "");
+    return { by: approval.by, at: approval.at, automatic: rule !== null, rule, how: how === "" ? (rule === null ? "password typed" : "") : how, version: scope.digest.slice(0, 12) };
+}

package/dist/server/route-table.js

@@ -124,22 +124,30 @@ get("pages", "projects.browse", "/projects/browse", free);
 get("pages", "projects.github", "/projects/github", { ...free, callers: ["cookie"], callerRefusal: { status: 403, type: "text/plain; charset=utf-8", body: "listing repositories feeds a browser session's act" },
     ...anyApprover("your login can watch — adding projects is an approver's act") });
 get("pages", "projects.page", "/projects", { limited: "unscoped", ...free });
+// One project's reading page (/projects/<name>): reads only, like every GET (docs/plans/get-side-effects.md). It shows a
+// project this account can see and never switches the session's project; its Open project button posts to
+// /projects/select. The handler resolves the name among the account's visible projects; anything else is not found.
+get("pages", "projects.project", "^\\/projects\\/[^/]+$", { limited: "unscoped", ...free, sample: "/projects/payments-api" });
 get("pages", "home", "/", { limited: "collection", ...free });
+get("pages", "search", "/search", { limited: "collection", ...free });
 get("tasks", "inbox", "/inbox", { limited: "collection", ...free });
 get("tasks", "work", "/work", { limited: "collection", ...free });
+// Put away old tasks (task-tidy.md): the preview reads only; putting away is an approver's step-up in a browser session.
+get("tasks", "work.put-away", "/work/put-away", { limited: "collection", ...free, callers: ["cookie"], ...approver("Only an approver can put tasks away.", "/work") });
+post("tasks", "work.put-away.apply", "/work/put-away", { scope: "step-up", limited: "collection", ...approver("Only an approver can put tasks away.", "/work") });
 get("tasks", "next", "/next", { limited: "collection" });
-get("pages", "morning", "/morning");
+get("pages", "morning", "/morning", { limited: "collection", ...free }); // a redirect to / now
 get("pages", "workbench", "/workbench", free);
 get("tasks", "board", "/board", { limited: "collection" });
 get("tasks", "review", "/review", { limited: "collection" });
 get("settings", "spend", "/spend", { ...free, ...anyOperator("An instance operator sees spend.", "/") });
 get("settings", "settings.spend", "/settings/spend", { ...free, ...anyOperator("An instance operator sets spending limits.", "/settings") });
 get("pages", "ledger", "/ledger", { limited: "unscoped", ...free });
-get("pages", "activity", "/activity");
-get("tasks", "done", "/done", { limited: "collection" });
+get("pages", "activity", "/activity", { limited: "collection", ...free }); // a redirect to / now (Home has the summary)
+get("tasks", "done", "/done", { limited: "collection", ...free }); // a redirect to the Tasks list's Finished view now
 get("settings", "mode", "/mode");
 get("people", "people.page", "/people", { limited: "unscoped", ...free });
-get("pages", "system", "/system");
+get("pages", "system", "/system", free);
 // Where every "Connect a builder" leads: read-only, open to a project-limited person (the handler shows only a visible project).
 get("pages", "start-builder", "/start-builder", { limited: "unscoped", ...free });
 get("tasks", "tasks", "/tasks", { limited: "collection", ...free }); // a redirect to /work now: never sent to the project opener first
@@ -150,12 +158,17 @@ get("pages", "agents", "/agents", { limited: "unscoped", ...free });
 // Browser sessions only, like the transcript and the peek: no token (a lead's, a runner's, a remote one) reads live output.
 get("pages", "agents.live", "/agents/live", { limited: "unscoped", callers: ["cookie"], ...free });
 get("pages", "agents.live.read", `^\\/agents\\/live\\/${ID}$`, { limited: "unscoped", callers: ["cookie"], ...free, sample: "/agents/live/1" });
+// Terminals' address in the Agents area: a 302 to /term, admitted exactly as /term is (an operator's browser session).
+get("pages", "agents.terminals", "/agents/terminals", TERM);
+// Fleet and System are parts of Agents now: GET aliases to /agents#computers and /agents#models.
 get("pages", "fleet", "/fleet", free);
 get("tasks", "tasks.new", "/tasks/new", { limited: "collection", ...free });
+// The first run's own page (Wave E): five guided steps, reads only; it leads Home once the first run is over.
+get("tasks", "welcome", "/welcome", { limited: "collection", ...free });
 get("tasks", "task.page", `^\\/t\\/${TASK}$`, { project: "task", limited: "resource", ...free, sample: "/t/one" });
 get("tasks", "task.evidence", `^\\/t\\/${TASK}\\/evidence$`, { project: "task", limited: "resource", ...free, sample: "/t/one/evidence" });
 get("pages", "ledger.export", "/ledger/export", { limited: "unscoped", ...free });
-get("tasks", "runs", "/runs", { limited: "collection" });
+get("tasks", "runs", "/runs", { limited: "collection", ...free }); // a redirect to /agents now
 get("pages", "menu", "/menu", { limited: "collection", ...free });
 get("tasks", "run.page", `^\\/r\\/${ID}$`, { project: "run", limited: "resource", ...free, sample: "/r/1" });
 get("tasks", "run.evidence", `^\\/r\\/${ID}\\/evidence\\/${ID}$`, { project: "run", limited: "resource", ...free, sample: "/r/1/evidence/2" });
@@ -215,6 +228,11 @@ get("settings", "settings.knowledge", "/settings/knowledge", { limited: "unscope
 get("settings", "settings.learning", "/settings/learning", { limited: "unscoped", ...free });
 get("settings", "settings.telegram", "/settings/telegram", { limited: "self", ...free, ...approver("An approver can pair their own phone.", "/settings") });
 get("settings", "settings.page", "/settings", { limited: "unscoped", ...free });
+// The Settings groups (docs/plans/settings-revamp.md §3): one read-only page each, drawn by the overview's handler.
+// Anyone signed in may open one; the page shows only the sections this person can use, and every form's own route
+// keeps its own role and proof.
+for (const one of ["general", "agents", "alerts", "projects", "access", "system"])
+    get("settings", `settings.group-${one}`, `/settings/${one}`, { limited: "unscoped", ...free });
 get("pages", "health", "/health", { ...free, ...anyOperator("An instance operator reads server health.", "/") });
 get("pages", "metrics", "/metrics", { ...free, ...anyOperator("An instance operator reads metrics.", "/") });
 get("chat", "push.key", "/push/key");
@@ -270,6 +288,11 @@ for (const one of ["linear-key", "hooks-address", "secrets"])
 // "Runs on its own": signing raises authority (the owner's password, a step-up); revoking is one click for any approver.
 post("flows", "flow.unattended", `^\\/flows\\/${FLOW}\\/unattended$`, { scope: "step-up", project: "flow", sample: "/flows/1/unattended", ...EDIT_FLOWS });
 post("flows", "flow.unattended-off", `^\\/flows\\/${FLOW}\\/unattended-off$`, { project: "flow", sample: "/flows/1/unattended-off", ...EDIT_FLOWS });
+// Browser use in a flow's script zones (flow-browser.ts): allowing it widens the sandbox, so a person's own step-up from
+// their browser, carrying the approval digest they read; turning it off lowers authority, one click. Browser only: a
+// lead's or remote run's token never reaches either (the CLI says the same).
+post("flows", "flow.browser", `^\\/flows\\/${FLOW}\\/browser$`, { scope: "step-up", project: "flow", sample: "/flows/1/browser", ...EDIT_FLOWS });
+post("flows", "flow.browser-off", `^\\/flows\\/${FLOW}\\/browser-off$`, { callers: ["cookie"], project: "flow", limited: "resource", sample: "/flows/1/browser-off", ...EDIT_FLOWS });
 post("flows", "flow.triggers", `^\\/flows\\/${FLOW}\\/triggers$`, { project: "flow", limited: "resource", sample: "/flows/1/triggers", ...EDIT_FLOWS });
 for (const one of ["move", "decide", "cancel", "comment", "assign", "watch"])
     post("flows", `flow.card.${one}`, `^\\/flows\\/${FLOW}\\/cards\\/${FLOW}\\/${one}$`, { project: "flow", limited: "resource", sample: `/flows/1/cards/2/${one}`, ...EDIT_FLOWS });
@@ -408,6 +431,9 @@ post("tasks", "task.act.merge", `^\\/t\\/${TASK}\\/merge$`, { project: "task", l
 post("tasks", "task.act.confirm-stopped", `^\\/t\\/${TASK}\\/confirm-stopped$`, { scope: "step-up", project: "task", limited: "resource", sample: "/t/one/confirm-stopped", ...approver("Only an approver can confirm a build stopped.") });
 post("tasks", "task.act.stop-carrying", `^\\/t\\/${TASK}\\/stop-carrying$`, { project: "task", limited: "resource", sample: "/t/one/stop-carrying", ...approver("Only an approver can stop carrying a release.") });
 post("tasks", "task.act.stop", `^\\/t\\/${TASK}\\/stop$`, { project: "task", limited: "resource", sample: "/t/one/stop" });
+// Putting one task away and bringing it back (task-tidy.md): a person's act, so only a browser session.
+post("tasks", "task.act.archive", `^\\/t\\/${TASK}\\/archive$`, { project: "task", limited: "resource", sample: "/t/one/archive", callers: ["cookie"], ...approver("Only an approver can put a task away.") });
+post("tasks", "task.act.restore", `^\\/t\\/${TASK}\\/restore$`, { project: "task", limited: "resource", sample: "/t/one/restore", callers: ["cookie"], ...approver("Only an approver can restore a task.") });
 post("tasks", "task.act.pause", `^\\/t\\/${TASK}\\/pause$`, { project: "task", limited: "resource", sample: "/t/one/pause" });
 post("tasks", "task.act.resume-arm", `^\\/t\\/${TASK}\\/resume-arm$`, { project: "task", limited: "resource", sample: "/t/one/resume-arm" });
 post("tasks", "task.act.resume", `^\\/t\\/${TASK}\\/resume$`, { scope: "step-up", project: "task", limited: "resource", sample: "/t/one/resume" });