toolroll 0.9.85 → 0.9.86

package/dist/server/console.css

@@ -2742,3 +2742,32 @@ html.so-swap::view-transition-old(*):only-child { animation: so-card-out 160ms e
 
 .result-feedback-actions { display: flex; flex-wrap: wrap; gap: .5rem; }
 .result-feedback-actions button { min-height: 44px; white-space: nowrap; }
+
+/* Put away old tasks (docs/plans/task-tidy.md): grouped checklist on the kit's column. */
+.put-away { max-width: var(--so-settings-width, 760px); }
+.put-away h1 { margin: 0 0 4px; }
+.put-away-days { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; margin: 0 0 16px; }
+.put-away-days label { display: flex; align-items: center; gap: 8px; margin: 0; font-size: 14px; }
+.put-away-days input[type=number] { width: 5rem; margin: 0; }
+.put-away-days button { width: auto; }
+.put-away-group { margin: 0 0 20px; padding: 0; border: 0; }
+.put-away-group legend { display: flex; align-items: center; gap: 8px; padding: 0; margin: 0 0 6px; font-weight: 600; font-size: 15px; }
+.put-away-group legend .count { font-family: var(--so-mono, ui-monospace, monospace); font-size: 11px; font-weight: 500; color: var(--so-muted); }
+.put-away-group ul { list-style: none; margin: 0; padding: 0; border-top: 1px solid var(--so-line); }
+.put-away-group li { border-bottom: 1px solid var(--so-line); }
+.put-away-item { display: grid; grid-template-columns: auto minmax(0, 1fr); column-gap: 10px; align-items: start; margin: 0; padding: 10px 2px; cursor: pointer; }
+.put-away-item input { margin: 3px 0 0; width: auto; min-height: 0; align-self: start; }
+.put-away-title { font-size: 13.5px; font-weight: 500; overflow-wrap: anywhere; }
+.put-away-why { grid-column: 2; font-size: 12.5px; color: var(--so-muted); }
+.put-away-id { grid-column: 2; font-family: var(--so-mono, ui-monospace, monospace); font-size: 11.5px; color: var(--so-muted); overflow-wrap: anywhere; }
+.put-away-cli { margin: 12px 0 0; font-size: 13px; color: var(--so-muted); overflow-wrap: anywhere; }
+.put-away-cli code { font-size: 12px; }
+.task-archived { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 8px 12px; margin: 0 0 12px; padding: 10px 12px; border-radius: 8px; background: var(--so-raised); }
+.task-archived p { margin: 0; font-size: 13.5px; }
+.task-archived form { margin: 0; }
+.task-archived button { width: auto; }
+.work-row-status form.inline { margin: 0; }
+@media (max-width: 900px) {
+  .put-away-item { min-height: 44px; }
+  .put-away-days button, .task-archived button, .work-row-status form.inline button { min-height: 44px; }
+}

package/dist/server/flows.js

@@ -21,6 +21,7 @@ import { exportFlow, fetchFlowFile, FlowFileError, importFlow, parseFlowFile, pl
 import { addFlowTriggerTo, checkFlowTriggerNow, pressFlowButton, removeFlowTrigger, removeLinearKey, setFlowTriggerOn, renewFlowHook, saveHooksBase, saveLinearKey, saveSigningSecret, setUpFlowHook, changeFlowHookSender, setFlowHookScope, shareFlowButton, stopSharingFlowButton, rawTakesDeliveries, rawAdmitsAnyone } from "../flow-triggers.js";
 import { FLOW_IMPORT_SCRIPT, flowFallbackHtml, flowImportHtml, flowsListHtml, flowView } from "../flows-ui.js";
 import { FLOW_TEMPLATES, FlowContractError, validateFlowDefinition, withZoneNames } from "../flows.js";
+import { revokeFlowBrowser, signFlowBrowser } from "../flow-browser.js";
 import { prepareUnattendedCandidates, parseUnattendedAsk, revokeUnattended, signUnattended, untilWords } from "../flow-unattended.js";
 import { keyStatus } from "../keys.js";
 import { kitPageHtml, kitsGalleryHtml } from "../kits-ui.js";
@@ -656,6 +657,18 @@ export function createFlowsHandlers(runtime) {
         if (action === "unattended-off") {
             return revokeUnattended(store, flow.id, who.name, now) ? settle("It no longer runs on its own. New cards wait for you.") : answer(409, { ok: false, said: "It wasn't running on its own." });
         }
+        if (action === "browser") {
+            // A person's own step-up (a lead's or remote run's token never gets here: route table), then signFlowBrowser
+            // re-reads the flow, its zones and scripts in its one write and refuses unless they are the digest the panel showed.
+            const proved = authenticateApprover(who, body.get("password") ?? "", flow.repo);
+            if (!proved.ok)
+                return answer(403, { ok: false, said: "That password isn't right. Nothing was approved." });
+            const signed = signFlowBrowser(store, { flow: flow.id, signer: who.name, proof: proved.method, sawDigest: body.get("digest") ?? "", console: { generation: who.via === "cookie" ? who.session.generation : -1 } }, now);
+            return signed.ok ? settle(`Browser allowed. ${signed.grant.zones.length === 1 ? "Its script" : "Its scripts"} can start Chromium now.`) : answer(409, { ok: false, said: signed.message });
+        }
+        if (action === "browser-off") {
+            return revokeFlowBrowser(store, flow.id, who.name, now) ? settle("Browser turned off. Its browser zones wait until someone allows it again.") : answer(409, { ok: false, said: "Browser use wasn't allowed for this flow." });
+        }
         if (action === "save") {
             let saved, drawn;
             try {
@@ -975,6 +988,8 @@ export function createFlowsHandlers(runtime) {
         "flow.secrets": flowAct("secrets"),
         "flow.unattended": flowAct("unattended"),
         "flow.unattended-off": flowAct("unattended-off"),
+        "flow.browser": flowAct("browser"),
+        "flow.browser-off": flowAct("browser-off"),
         "flow.triggers": flowAct("triggers"),
         "flow.card.move": cardAct("move"),
         "flow.card.decide": cardAct("decide"),

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

@@ -1,4 +1,5 @@
 /** Everyday console pages: home, inbox, board, work, projects, fleet and the queue. */
+import { type TidyItem } from "../tidy.js";
 import { type TaskOrigin } from "../task-source.js";
 import { type Html } from "../html.js";
 import { type AssignmentSnapshot } from "../assignment.js";
@@ -295,6 +296,8 @@ export declare function workPage(chrome: Chrome, data: {
     now: Date;
     limits?: BrowserLimits | null;
     state?: TaskState | null;
+    /** An approver in a browser session: rows offer Put away (or Restore, archived), and the page offers Put away old tasks. */
+    canPutAway?: boolean;
 }): Screen;
 export declare function browsePage(chrome: Chrome, data: {
     at: string;
@@ -562,3 +565,13 @@ export type PeekAdmission = {
     epoch: string;
     entries: ReturnType<typeof parseBaseTreeSnapshot>;
 };
+/** Put away old tasks (docs/plans/task-tidy.md): exactly what would be put away, grouped, each with why, every one
+ * ticked; one step-up puts away the ticked ones, bound to this preview's digest. The CLI twin is named beside it. */
+export declare function putAwayPage(chrome: Chrome, data: {
+    items: readonly TidyItem[];
+    days: number;
+    digest: string;
+    now: Date;
+    problem: string | null;
+    releasesSkipped: string | null;
+}): Screen;

package/dist/server/render-pages.js

@@ -1,5 +1,7 @@
 import { activityMetrics, activityScope, activityLimit } from '../project-activity.js';
 /** Everyday console pages: home, inbox, board, work, projects, fleet and the queue. */
+import { archivedWords, tidyGroups, TIDY_DEFAULT_DAYS } from "../tidy.js";
+import { stepUpForm } from "../settings-kit.js";
 import { originNote } from "../task-source.js";
 import { html, htmlString, joinHtml, postForm, replaceMarkup, reauth } from "../html.js";
 import {} from "../assignment.js";
@@ -632,14 +634,25 @@ export function workPage(chrome, data) {
         return `/work${query.size ? `?${query}` : ''}`;
     };
     const tabs = html `<nav class="work-views" aria-label="Task views">${WORK_VIEWS.map(one => html `<a href="${href(one.key)}"${one.key === data.view ? html ` class="active" aria-current="page"` : null}>${one.label}<span class="count">${data.work.totals[one.key]}</span></a>`)}</nav>`;
+    // Put away (or Restore, in Archived): one quiet act per row, never on a task with work going on.
+    const tidyAct = (row) => data.canPutAway !== true ? null : row.archived !== undefined ? { action: `${taskHref(row.rootId)}/restore`, label: 'Restore' }
+        : row.liveRunId !== null || row.unfinishedRunId !== null || row.status.views.includes('running') ? null : { action: `${taskHref(row.rootId)}/archive`, label: 'Put away' };
+    const returnTo = href(data.view, undefined);
     const rowHtml = (row) => {
+        if (row.archived !== undefined) {
+            const act = tidyAct(row);
+            const project = data.multiProject || row.repo === null ? html `<span class="project-label">${row.repo === null ? 'Unplaced' : projectName(row.repo)}</span>` : null;
+            return html `<article class="work-row" data-task="${row.rootId}" data-work-status="archived" data-work-views="archived"><div class="work-row-main"><a class="work-title" href="${taskHref(row.rootId)}">${row.title}</a><p class="work-meta">${project}<span>${relativeAge(row.archived.at, data.now)}</span><span class="mono">${row.rootId}</span></p><p class="work-detail" data-archived-by>${archivedWords(row.archived)}</p></div><div class="work-row-status">${act === null ? null : postForm(act.action, html `<button type="submit" class="secondary">${act.label}</button>`, { hidden: { return: returnTo }, attrs: { class: 'inline', 'data-tidy-act': 'restore' } })}</div></article>`;
+        }
         const target = row.primaryAction?.target;
         const actionHref = row.primaryAction?.code === 'open-result' && target?.runId != null
             ? `/review?result=${encodeURIComponent(target.taskId)}&run=${target.runId}`
             : browserWorkActionHref(row);
         const action = actionHref === null || row.primaryAction === null ? null : html `<a class="work-action" data-primary-action href="${actionHref}">${row.primaryAction.label} →</a>`;
         const project = data.multiProject || row.repo === null ? html `<span class="project-label">${row.repo === null ? 'Unplaced' : projectName(row.repo)}</span>` : null;
-        return html `<article class="work-row" data-task="${row.rootId}" data-work-status="${row.status.token}" data-work-views="${row.status.views.join(' ')}"><div class="work-row-main"><a class="work-title" href="${taskHref(row.rootId)}">${row.title}</a><p class="work-meta">${project}<span>${relativeAge(row.updatedAt, data.now)}</span><span class="mono">${row.rootId}</span></p></div><div class="work-row-status">${statusLineHtml(row.status)}${action}${row.familyProblem === null ? null : html `<p class="problem">${row.familyProblem}</p>`}${row.status.views.includes('needs-you') && !['write-scope', 'approve-scope'].includes(row.primaryAction?.code ?? '') && row.status.detail !== row.status.label && row.status.detail !== row.familyProblem ? html `<p class="work-detail">${row.status.detail}</p>` : null}${workDiagnosticsHtml(row.status.diagnostics)}</div></article>`;
+        const act = tidyAct(row);
+        const putAway = act === null ? null : postForm(act.action, html `<button type="submit" class="quiet">${act.label}</button>`, { hidden: { return: returnTo }, attrs: { class: 'inline', 'data-tidy-act': 'put-away' } });
+        return html `<article class="work-row" data-task="${row.rootId}" data-work-status="${row.status.token}" data-work-views="${row.status.views.join(' ')}"><div class="work-row-main"><a class="work-title" href="${taskHref(row.rootId)}">${row.title}</a><p class="work-meta">${project}<span>${relativeAge(row.updatedAt, data.now)}</span><span class="mono">${row.rootId}</span></p></div><div class="work-row-status">${statusLineHtml(row.status)}${action}${putAway}${row.familyProblem === null ? null : html `<p class="problem">${row.familyProblem}</p>`}${row.status.views.includes('needs-you') && !['write-scope', 'approve-scope'].includes(row.primaryAction?.code ?? '') && row.status.detail !== row.status.label && row.status.detail !== row.familyProblem ? html `<p class="work-detail">${row.status.detail}</p>` : null}${workDiagnosticsHtml(row.status.diagnostics)}</div></article>`;
     };
     const current = WORK_VIEWS.find(one => one.key === data.view);
     const filtered = (data.state ?? null) !== null;
@@ -654,6 +667,7 @@ export function workPage(chrome, data) {
     const pages = !data.previous && data.work.nextCursor === null ? null : html `<nav class="row work-pagination" aria-label="Task pages">${data.previous ? html `<a class="button-link" href="${href(data.view)}">First page</a>` : null}${data.work.nextCursor === null ? null : html `<a class="button-link" rel="next" href="${href(data.view, data.work.nextCursor)}">Next page</a>`}</nav>`;
     const tools = html `<details class="work-tools"><summary>Work tools${CHEVRON_ICON}</summary><nav class="work-tools-menu">${[['/inbox', 'Inbox'], ['/board', 'Board'], ['/board?view=order', 'Order'], ['/recipes', 'Recipes'], ...(chrome.projectScoped ? [] : [['/workbench', 'Portfolio']]), ['/ledger', 'Action ledger']]
         .map(([path, label]) => html `<a href="${path}">${label}</a>`)}</nav></details>`;
+    const putAwayLink = data.canPutAway === true && data.view !== 'archived' ? { label: 'Put away old tasks', href: '/work/put-away' } : null;
     const toolLinks = [['/inbox', 'Inbox'], ['/board', 'Board'], ['/board?view=order', 'Order'], ['/recipes', 'Recipes'], ...(chrome.projectScoped ? [] : [['/workbench', 'Portfolio']])];
     const view = {
         kind: 'tasks',
@@ -667,6 +681,15 @@ export function workPage(chrome, data) {
             const actionHref = row.primaryAction?.code === 'open-result' && target?.runId != null
                 ? `/review?result=${encodeURIComponent(target.taskId)}&run=${target.runId}`
                 : browserWorkActionHref(row);
+            const act = tidyAct(row);
+            const tidy = act === null ? null : { action: act.action, label: act.label, returnTo };
+            if (row.archived !== undefined)
+                return {
+                    id: row.rootId, title: row.title, href: taskHref(row.rootId),
+                    project: data.multiProject || row.repo === null ? (row.repo === null ? 'Unplaced' : projectName(row.repo)) : null,
+                    age: relativeAge(row.archived.at, data.now), status: { label: 'Archived', tone: 'muted', token: 'archived' },
+                    ask: null, chip: null, group: 'rest', action: null, detail: archivedWords(row.archived), problem: null, notes: [], tidy,
+                };
             const needsYouDetail = (row.status.views.includes('needs-you') || row.status.label === 'Failed') && !['write-scope', 'approve-scope'].includes(row.primaryAction?.code ?? '') && row.status.label !== 'Ready for review' && row.status.detail !== row.status.label && row.status.detail !== row.familyProblem;
             return {
                 id: row.rootId, title: row.title, href: taskHref(row.rootId),
@@ -678,6 +701,7 @@ export function workPage(chrome, data) {
                 detail: needsYouDetail ? row.status.detail : row.progress ?? null,
                 problem: row.familyProblem,
                 notes: (row.status.diagnostics ?? []).map(one => `${one.label} · ${one.detail}`),
+                tidy,
             };
         }),
         empty: data.work.items.length > 0 ? null : filtered && !data.previous ? { text: `No tasks are ${data.state} in this view.`, action: { label: "Show every state", href: href(data.view, undefined, null) } } : {
@@ -687,11 +711,12 @@ export function workPage(chrome, data) {
         pages: { first: data.previous ? href(data.view) : null, next: data.work.nextCursor === null ? null : href(data.view, data.work.nextCursor) },
         tools: toolLinks.map(([path, label]) => ({ label: label, href: path })),
         newTask: { label: 'New task', href: '/tasks/new' },
+        putAway: putAwayLink,
         limits: data.limits ?? null,
         states: [{ label: 'Any state', href: href(data.view, undefined, null), active: (data.state ?? null) === null },
             ...TASK_STATES.map(one => ({ label: one.charAt(0).toUpperCase() + one.slice(1), href: href(data.view, undefined, one), active: data.state === one }))],
     };
-    return screen('work', html `<div class="work-head"><h1>Tasks</h1>${tools}</div>${limitsHtml(data.limits ?? null)}${tabs}${stateLinks}${list}${pages}`, { chrome, workspace: { view } });
+    return screen('work', html `<div class="work-head"><h1>Tasks</h1>${putAwayLink === null ? null : html `<a class="button-link" href="${putAwayLink.href}" data-put-away-old>${putAwayLink.label}</a>`}${tools}</div>${limitsHtml(data.limits ?? null)}${tabs}${stateLinks}${list}${pages}`, { chrome, workspace: { view } });
 }
 export function browsePage(chrome, data) {
     const crumb = data.at === data.root ? projectName(data.root) : `${projectName(data.root)}${data.at.slice(data.root.length)}`;
@@ -1320,3 +1345,21 @@ export function nextPage(chrome, data) {
     }
     return screen("next", joinHtml([header, card], "\n"), { chrome });
 }
+/** Put away old tasks (docs/plans/task-tidy.md): exactly what would be put away, grouped, each with why, every one
+ * ticked; one step-up puts away the ticked ones, bound to this preview's digest. The CLI twin is named beside it. */
+export function putAwayPage(chrome, data) {
+    const groups = tidyGroups(data.items, data.days);
+    const count = data.items.length;
+    const daysArg = data.days === TIDY_DEFAULT_DAYS ? "" : ` --days ${data.days}`;
+    const crumbs = html `<nav class="kit-crumbs" aria-label="Breadcrumb"><ol><li><a href="/work">Tasks</a></li><li><span aria-current="page">Put away old tasks</span></li></ol></nav>`;
+    const daysForm = html `<form method="get" action="/work/put-away" class="put-away-days"><label>Also finished tasks untouched for <input type="number" name="days" min="1" max="365" value="${String(data.days)}" inputmode="numeric"> days</label><button type="submit" class="secondary">Update list</button></form>`;
+    const list = joinHtml(groups.map(group => html `<fieldset class="put-away-group" data-tidy-group="${group.rule}"><legend>${group.label}<span class="count">${String(group.items.length)}</span></legend><ul>${group.items.map(item => html `<li><label class="put-away-item" data-tidy-task="${item.taskId}"><input type="checkbox" name="task" value="${item.taskId}" checked><span class="put-away-title">${item.title}</span><span class="put-away-why">${item.reason}</span><span class="put-away-id">${item.taskId}${item.repo === null ? "" : ` · ${projectName(item.repo)}`}${item.members.length > 1 ? ` · ${item.members.length} versions` : ""}</span></label></li>`)}</ul></fieldset>`));
+    const cli = html `<p class="put-away-cli" data-tidy-cli>Or run: <code>toolroll task tidy --apply --digest ${data.digest}${daysArg}</code></p>`;
+    const body = count === 0
+        ? html `<p class="kit-state">Nothing to put away right now.</p><p><a href="/work?view=archived">See archived tasks →</a></p>`
+        : stepUpForm({ proof: "tasks-put-away", action: "/work/put-away", id: "put-away", hidden: { digest: data.digest, days: data.days },
+            body: html `${list}${cli}`, save: { label: "Put away selected", idle: `${count} ${count === 1 ? "task" : "tasks"} selected` }, confirm: `Put away the selected tasks. You can restore any of them from Archived.` });
+    return screen("Put away old tasks", html `<div class="put-away">${crumbs}<h1>Put away old tasks</h1>\
+<p class="kit-state">${count === 0 ? "Old releases, routine runs and fixed CI notices are put away automatically." : `${count} ${count === 1 ? "task" : "tasks"} can be put away. They leave every list and keep their history.`}</p>\
+${data.problem ? html `<p class="kit-problem" role="alert">${data.problem}</p>` : ""}${data.releasesSkipped === null ? "" : html `<p class="kit-hint">Release tasks were left out: ${data.releasesSkipped}.</p>`}${daysForm}${body}</div>`, { chrome });
+}

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

@@ -438,6 +438,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. */

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";
@@ -774,6 +776,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")
@@ -2068,8 +2072,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 +2085,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 +2216,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 +2328,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 +2345,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,7 +2363,7 @@ 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",
         more,
         confirmStopped: data.csrf !== "" && data.assignment?.primaryAction?.code === "confirm-stopped" && data.assignment.primaryAction.target.runId !== null

package/dist/server/route-table.js

@@ -127,6 +127,9 @@ get("pages", "projects.page", "/projects", { limited: "unscoped", ...free });
 get("pages", "home", "/", { 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", "workbench", "/workbench", free);
@@ -270,6 +273,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 +416,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" });

package/dist/server/task-views.js

@@ -21,6 +21,7 @@ import { newestPullRequestOf, publishingOf, pullRequestBlocker } from '../pull-r
 import { structuredHandoffView, terminalDiffView } from "../result-evidence-readers.js";
 import { resultCheckLevel } from '../result-follow-ups.js';
 import { skillsSnapshotHtml, skillTestFeedbackHtml } from "../skills-ui.js";
+import { archiveOf } from "../store.js";
 import { runActivityOf } from "../task-activity.js";
 import { taskFingerprint } from "../task-live.js";
 import { pullRequestFactOf } from '../task-status.js';
@@ -792,6 +793,10 @@ export function createTaskViews(runtime) {
         const presentedData = { ...data, rootId: family?.root.id ?? taskId, rootTitle: family?.root.title ?? data.task.title,
             ...(family === null || data.assignment != null ? {} : { history: familyHistory(family) }),
             versionLabel: family !== null && family.current.id !== taskId ? `Viewing ${family.versions.findIndex(one => one.id === taskId) === 0 ? "Original" : `Revision ${family.versions.findIndex(one => one.id === taskId)}`} · ${family.current.state === "running" ? "A newer revision is running" : "A newer revision is current"}` : null };
+        // Put away (v145, task-tidy.md): who or what put it away and why, and whether this person can put it away or restore it.
+        const archived = archiveOf(runtime.store, taskId);
+        presentedData.archived = archived;
+        presentedData.canPutAway = who.via === "cookie" && who.role === "approver";
         if (scopeDraft !== undefined)
             presentedData.scopeDraft = scopeDraft;
         if (cancelDraft !== undefined)

package/dist/server/tasks.d.ts

@@ -2,6 +2,7 @@
 import { type Html } from "../html.js";
 import { type ServerResponse } from "node:http";
 import { type Artifact, type Run, type Store } from "../store.js";
+import type { HandlerContext } from './handler-context.js';
 import type { ServerRuntime } from './runtime.js';
 import { type PeekAdmission } from "./render-pages.js";
 import { type CompletedWorkRow, type RankedReviewRow, type ReviewCockpitView } from "./render-results.js";
@@ -36,3 +37,12 @@ export declare function createTasksHandlers(runtime: ServerRuntime): {
     };
     liveRunIds: (rows: readonly (Pick<Run, "id" | "outcome" | "leaseId" | "taskRef">)[]) => Set<number>;
 };
+/** Put away and Restore one task, and Put away old tasks (docs/plans/task-tidy.md): the preview reads only (GET-quiet);
+ * putting away many is an approver's step-up bound to the digest of exactly what the preview showed. Each write
+ * re-proves the person's standing inside its own transaction. */
+export declare function createTidyHandlers(runtime: ServerRuntime): {
+    "work.put-away": (ctx: HandlerContext) => Promise<void>;
+    "work.put-away.apply": (ctx: HandlerContext) => Promise<void>;
+    "task.act.archive": (ctx: HandlerContext) => Promise<void>;
+    "task.act.restore": (ctx: HandlerContext) => Promise<void>;
+};

package/dist/server/tasks.js

@@ -1,5 +1,6 @@
 import { parseFeedbackImage, sameFeedbackImage } from "../result-review.js";
-import { dropFeedbackImage, releaseAuthorityOfTask, revokeRelease, runLiveCommands } from "../store.js";
+import { archiveTaskFamily, dropFeedbackImage, releaseAuthorityOfTask, restoreTaskFamily, revokeRelease, runLiveCommands } from "../store.js";
+import { applyTidy, approverStandsNow, familyRepoOf, releaseFactsOf, tidyDays, tidyDigest, tidyPreview, TIDY_DEFAULT_DAYS } from "../tidy.js";
 import { steerCapabilityOf } from "../steer-capabilities.js";
 import { canReveal, localCheckoutOf, revealInFinder } from "../checkout-proof.js";
 /** A form's way back to a flow card ("flow:<flow>:<card>"), read strictly: numbers only, never a path. */
@@ -67,7 +68,7 @@ import { buildProgressOf, parseWorkView } from "../workspace-ui.js";
 import { requestContext } from "./request-context.js";
 import { boardTickScript, oneLineOf, QUEUE_VIEW, refuse, regionScript, screen, transcriptScript, whenTime } from "./chrome.js";
 import { chatReturnWithSaid, matchTaskPath, redirect, respond, reviewHref, safeChatReturn, safeReturn, SAFETY, taskChatHref, taskHref } from "./http.js";
-import { boardBody, boardWorkers, donePage, inboxFingerprints, inboxPage, newTaskPage, nextPage, parseInboxTab, QUEUE_FRONT, queueBody, queueScript, TASK_STATES, workPage } from "./render-pages.js";
+import { putAwayPage, boardBody, boardWorkers, donePage, inboxFingerprints, inboxPage, newTaskPage, nextPage, parseInboxTab, QUEUE_FRONT, queueBody, queueScript, TASK_STATES, workPage } from "./render-pages.js";
 import { runEfficiencyOf } from "../run-efficiency.js";
 import { timingFor } from "../latency-timeline.js";
 import { ACCEPT_ANYWAY_NEEDS_REASON, editorFileHref, proofBundleView, rankReviewQueue, RESULT_REFUSALS, REVIEW_QUEUE_CAP, reviewCockpitDetailParts, reviewCockpitPage, reviewPriorityOf, runFactsFragment, runOutcomeBadge, runPage, RUNS_PAGE, runsPage, withRefusal } from "./render-results.js";
@@ -278,6 +279,7 @@ export function createTasksHandlers(runtime) {
             multiProject: new Set(work.items.map(task => task.repo ?? "")).size > 1,
             now,
             state,
+            canPutAway: who.via === "cookie" && who.role === "approver",
             // v105: subscription windows and monthly budgets, for whoever runs the installation.
             limits: store.isInstanceOperator(who.name)
                 ? limitsView(store.providerLimits(), store.budgets().length === 0 ? [] : store.monthSpendCached(now).budgets, { project: projectName, subagent: id => subagentNamesOf(store.handle).get(id) ?? `Subagent ${id}` }, now)
@@ -3057,7 +3059,9 @@ export function createTasksHandlers(runtime) {
                 live.add(run.id);
         return live;
     }
+    const tidyHandlers = createTidyHandlers(runtime);
     const registrations = handlersOf("tasks", {
+        ...tidyHandlers,
         "code.page": showCode("workspace"),
         "code.session": showCode("session"),
         "code.state": showCode("state"),
@@ -3154,3 +3158,51 @@ export function createTasksHandlers(runtime) {
     }
     return { registrations, runListPane, peekFragment, taskMutation, queueRegionFor, ciFailingFor, completedRowFor, attemptRowFor, resultRowOf, reviewCockpitViewOf, decisionEvidence, runEvidence, sendArtifact, peekGuards, liveRunIds };
 }
+/** Put away and Restore one task, and Put away old tasks (docs/plans/task-tidy.md): the preview reads only (GET-quiet);
+ * putting away many is an approver's step-up bound to the digest of exactly what the preview showed. Each write
+ * re-proves the person's standing inside its own transaction. */
+export function createTidyHandlers(runtime) {
+    const { store, sendScreen, chromeFor, authenticateApprover, workAccess, bustBadge } = runtime;
+    async function showPutAway(ctx) {
+        const { url, who, response, now, project } = ctx;
+        const days = tidyDays(url.searchParams.get("days"));
+        if (days === null)
+            return refuse(response, who, 400, "Choose a number of days from 1 to 365.", "/work/put-away");
+        const releases = releaseFactsOf(store);
+        const items = tidyPreview(store, now, { releases, days, access: workAccess() });
+        return sendScreen(response, 200, putAwayPage(chromeFor(project, "work"), { items, days, digest: tidyDigest(items, days), now,
+            problem: url.searchParams.get("problem"), releasesSkipped: releases.problem }));
+    }
+    async function applyPutAway(ctx) {
+        const { who, response, now, posted } = ctx;
+        const body = readForm(posted, CONSOLE_FORMS.tasksPutAway);
+        const days = tidyDays(body.get("days"));
+        const back = (problem) => redirect(response, `/work/put-away?${new URLSearchParams({ ...(days === null || days === TIDY_DEFAULT_DAYS ? {} : { days: String(days) }), problem })}`);
+        if (days === null)
+            return back("Choose a number of days from 1 to 365.");
+        if (!authenticateApprover(who, body.get("password") ?? "").ok)
+            return back("Enter your Toolroll password to put these away.");
+        const done = applyTidy(store, now, { by: who.name, days, digest: body.get("digest") ?? "", only: body.getAll("task"), releases: releaseFactsOf(store), access: workAccess() });
+        if (!done.ok)
+            return back(done.message);
+        bustBadge();
+        return redirect(response, "/work?view=archived");
+    }
+    const oneTask = (kind) => async (ctx) => {
+        const { url, who, response, now, posted } = ctx;
+        const act = matchTaskPath(url.pathname, `/${kind}$`);
+        if (act === null)
+            return refuse(response, who, 404, "There's no page at this address.", "/work");
+        const body = readForm(posted, kind === "archive" ? CONSOLE_FORMS.taskArchive : CONSOLE_FORMS.taskRestore);
+        const standing = (refs) => approverStandsNow(store, who.name, familyRepoOf(store, refs));
+        const done = kind === "archive"
+            ? archiveTaskFamily(store, act.taskId, { by: who.name, byKind: "person", rule: null, reason: (body.get("reason") ?? "").trim() || "Put away by hand" }, now, { guard: standing })
+            : restoreTaskFamily(store, act.taskId, who.name, now, standing);
+        if (!done.ok)
+            return refuse(response, who, done.reason === "unknown-task" ? 404 : 409, done.message, taskHref(act.taskId));
+        bustBadge();
+        const to = safeReturn(body.get("return"));
+        return redirect(response, to === "/" ? taskHref(act.taskId) : to);
+    };
+    return { "work.put-away": showPutAway, "work.put-away.apply": applyPutAway, "task.act.archive": oneTask("archive"), "task.act.restore": oneTask("restore") };
+}

package/dist/settings-proofs.js

@@ -56,6 +56,7 @@ export const PROOF_INVENTORY = [
     { id: "updates", action: "Update Toolroll", routes: ["/settings/updates", "/settings/updates/seen", "/settings/updates/cancel"], form: "updates", field: "password", proof: "step-up", ...ACCEPT, role: "operator", secrets: [], terms: [] },
     { id: "storage-cleanup", action: "Choose when checkouts are removed", routes: ["/settings/storage"], form: "storage", field: "password", proof: "step-up", ...ACCEPT, role: "operator", secrets: [], terms: [] },
     { id: "storage-clean", action: "Clean up checkouts", routes: ["/settings/storage/clean"], form: "storage", field: "password", proof: "step-up", ...ACCEPT, role: "operator", secrets: [], terms: ["preview"], note: "`preview` is the digest of what the page showed; a changed list is refused" },
+    { id: "tasks-put-away", action: "Put away old tasks", routes: ["/work/put-away"], form: "tasksPutAway", field: "password", proof: "step-up", ...ACCEPT, role: "approver", secrets: [], terms: ["digest", "days", "task"], note: "`digest` is the preview the page showed; a changed list, or a ticked task outside it, is refused" },
     { id: "storage-discard", action: "Discard a checkout", routes: ["/settings/storage/discard"], form: "storage", field: "password", proof: "step-up", ...ACCEPT, role: "operator", secrets: [], terms: ["path"] },
     { id: "project-live-view", action: "Show a project's commands in the live view", routes: ["/settings/project/live-view"], form: "projectLiveView", field: "password", proof: "step-up", ...ACCEPT, role: "any", handlerRole: "an approver of the project", secrets: [], terms: ["repo", "nonce"] },
     { id: "project-delete", action: "Delete a project", routes: ["/settings/project/delete"], form: "projectDelete", field: "password", proof: "step-up", ...ACCEPT, role: "operator", secrets: [], terms: ["repo", "step"], note: "the project's name typed too" },

package/dist/store.d.ts

@@ -5,6 +5,7 @@ import { type ProjectSandbox } from "./project-sandbox.js";
 import type { FencePolicy } from "./agent-fence.js";
 import { type NetworkProfile, type ProjectNetwork, type RunNetworkRecord } from "./egress.js";
 import { type AcpLaunch } from "./acp-attest.js";
+export { refArchived, taskArchived } from "./task-archive.js";
 import { type ChatBinding } from "./chat-core.js";
 import { ChatMessages, TELEGRAM_HOLD_REASONS, TELEGRAM_SKIPPED_ELSEWHERE, TELEGRAM_SKIPPED_OTHER_CHAT, TELEGRAM_SKIPPED_QUIET } from "./chat-messages.js";
 import { isLifecycleNotification, isTelegramProgressNotification, LIFECYCLE_KEY_PREFIX, LIFECYCLE_KINDS, proposalTaskOf, type LifecycleKind } from "./notification-rows.js";
@@ -232,7 +233,7 @@ export type SealedLedgerEntry = LedgerEntry & {
         hash: string;
     } | null;
 };
-export declare const SCHEMA_VERSION = 143;
+export declare const SCHEMA_VERSION = 145;
 /** v118: the tables merged into `credential`, in the order they move (a person's API tokens keep their ids first). */
 export declare const V118_MERGED_TABLES: Readonly<Record<string, CredentialKind>>;
 /**
@@ -394,6 +395,16 @@ export declare const V143_ADDED_COLUMNS: Readonly<Record<string, Readonly<Record
     definition: string;
     saved: string;
 }>>>>;
+/** v145 (docs/plans/task-tidy.md): `task_archive` is a put-away task version. A row hides it from every list and count
+ * and refuses every door that would dispatch, claim or approve it; restore deletes the row. Its history, results,
+ * approvals and ledger stay exactly as they were. `merge_in_flight` is a direct merge between its last check and GitHub's
+ * answer, owned by its token: a task can't be put away under it (a row older than 15 minutes is a crash, and no
+ * longer counts). `deploy_in_flight` is a deployment whose candidate passed its gate (30 minutes, refreshed by every
+ * phase that proves it again). `flow_step_task` is the tasks a flow step was admitted for, kept whatever the card does
+ * next, so a step still running holds them. `branch_check_run` keeps each completed GitHub workflow run (pushed to
+ * the watched branch of the watched repository) the "checks failed" trigger saw, green or red, so tidy can tell a
+ * failure notice was fixed by a later commit. */
+export declare const V145_SCHEMA = "\nCREATE TABLE IF NOT EXISTS task_archive (\n  task_ref INTEGER PRIMARY KEY REFERENCES task_ref(id),\n  by       TEXT NOT NULL,\n  by_kind  TEXT NOT NULL CHECK (by_kind IN ('person','tidy')),\n  rule     TEXT,\n  reason   TEXT NOT NULL,\n  at       TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS branch_check_run (\n  repo           TEXT NOT NULL,\n  run_id         INTEGER NOT NULL,\n  branch         TEXT NOT NULL,\n  workflow       TEXT NOT NULL,\n  head_sha       TEXT NOT NULL,\n  conclusion     TEXT NOT NULL CHECK (conclusion IN ('success','failure')),\n  run_created_at TEXT NOT NULL,\n  observed_at    TEXT NOT NULL,\n  PRIMARY KEY (repo, run_id)\n);\nCREATE INDEX IF NOT EXISTS branch_check_run_by_workflow ON branch_check_run (repo, branch, workflow, run_created_at);\nCREATE TABLE IF NOT EXISTS merge_in_flight (\n  publication INTEGER PRIMARY KEY REFERENCES publication(id),\n  task_ref    INTEGER NOT NULL REFERENCES task_ref(id),\n  token       TEXT NOT NULL,\n  by          TEXT NOT NULL,\n  at          TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS deploy_in_flight (\n  task_ref INTEGER PRIMARY KEY REFERENCES task_ref(id),\n  run      INTEGER NOT NULL,\n  at       TEXT NOT NULL\n);\nCREATE TABLE IF NOT EXISTS flow_step_task (\n  card    INTEGER NOT NULL,\n  entry   INTEGER NOT NULL,\n  task_id TEXT NOT NULL,\n  PRIMARY KEY (card, entry, task_id)\n);\n";
 /**
  * v135: one approval per release (docs/plans/release-once.md). `release_authority` is the single source of truth for a
  * release a person approved: one row per generation, changed only by compare-and-swap on `rev`, with a lease whose
@@ -3745,7 +3756,7 @@ export declare class Store {
         rejectedRun: number | null;
     } | {
         ok: false;
-        reason: "unknown-task" | "not-stalled" | "claimed" | "accepted-result" | "published" | "moved";
+        reason: "unknown-task" | "not-stalled" | "claimed" | "accepted-result" | "published" | "moved" | "archived";
     };
     /**
      * Cancel, aware of who might be building right now. A live claim wins:
@@ -6892,7 +6903,7 @@ export declare class Store {
         stop: RunStop;
     } | {
         ok: false;
-        reason: "no-stop" | "wrong-task" | "stopping" | "already-resumed" | "superseded" | "busy" | "review";
+        reason: "no-stop" | "wrong-task" | "stopping" | "already-resumed" | "superseded" | "busy" | "review" | "archived";
         detail: string;
     };
     /** Every stop recorded on a task, newest request first. */
@@ -8064,3 +8075,60 @@ export declare function dropFeedbackImage(store: Store, runId: number, commentId
     ok: false;
     reason: "not-found" | "image-usable" | "not-authorized";
 };
+/** A put-away task version (v145, docs/plans/task-tidy.md). */
+export type TaskArchive = {
+    taskRef: number;
+    taskId: string;
+    by: string;
+    byKind: "person" | "tidy";
+    rule: string | null;
+    reason: string;
+    at: string;
+};
+/** Who put a task away, and why: a person by name, or tidy by its rule. */
+export type ArchiveBy = {
+    by: string;
+    byKind: "person" | "tidy";
+    rule: string | null;
+    reason: string;
+};
+export type ArchiveRefusal = "unknown-task" | "live" | "archived" | "not-archived" | "blocked";
+/** The put-away record of this task, or null when it is not put away. */
+export declare function archiveOf(store: Store, taskId: string): TaskArchive | null;
+/** Every version of a task's family, by the same proven lineage the task page reads (`taskFamilyOf`: same project, each
+ * revision bound to its parent's own run by its brief). A family whose lineage doesn't prove is just this task. */
+export declare function taskFamilyRefs(store: Store, taskId: string): {
+    id: number;
+    taskId: string;
+}[];
+/** The first family version with something still going on, or null: running, a live newest claim, an unfinished run,
+ * a process Toolroll hasn't seen exit, a build whose processes were never recorded, a stop still settling, a follow-up
+ * check asked for and not finished, a flow step running for its card, a release in flight (a live release approval
+ * that names it, or a deploy or merge reserved, running or unknown), or a pull request merging (an intent claimed or
+ * firing, or a person's merge between its last check and GitHub's answer). */
+export declare function liveFamilyAttempt(store: Store, refs: readonly number[], now: Date): string | null;
+/** Puts a task away (v145): every version of its family, in one write transaction that re-checks it has no live
+ * attempt, that its versions are exactly `expect` when the caller showed a person a family (a preview), and that
+ * `guard` (the caller's own rule, re-read under the lock) still allows it. Its state, history, results, approvals and
+ * ledger are untouched; its open notifications are resolved; one ledger row records who and why. */
+export declare function archiveTaskFamily(store: Store, taskId: string, by: ArchiveBy, now: Date, options?: {
+    expect?: readonly number[];
+    guard?: (refs: readonly number[]) => string | null;
+}): {
+    ok: true;
+    refs: number[];
+} | {
+    ok: false;
+    reason: ArchiveRefusal;
+    message: string;
+};
+/** Brings a put-away task back (v145): every version of its family, with a ledger row. Tidy never puts a restored
+ * task away again (tidy.ts reads the `task restored` row). */
+export declare function restoreTaskFamily(store: Store, taskId: string, by: string, now: Date, guard?: (refs: readonly number[]) => string | null): {
+    ok: true;
+    refs: number[];
+} | {
+    ok: false;
+    reason: ArchiveRefusal;
+    message: string;
+};