toolroll 0.9.97 → 0.9.99

package/dist/server/home.js

@@ -1,15 +1,16 @@
 import { browserWorkActionHref } from "../browser-crew.js";
-import { ASK_LABEL } from "../needs-you.js";
+import { HOME_GROUP_LABEL, homeGroupOf } from "../home-groups.js";
 import { projectName } from "../project.js";
 import { workIndexPage } from "../work-index.js";
 import { relativeAge } from "./chrome.js";
 import { taskHref } from "./http.js";
 const TONE = { attention: "needs", ready: "needs", live: "live", done: "done", problem: "failed", muted: "", neutral: "" };
-const ASKS = ["decide", "review", "unblock"];
 const ASK_WORD = { decide: "Decision", review: "Result", unblock: "Blocked" };
 /** How many waiting rows Home lists; the rest open in Tasks. */
 export const HOME_NEEDS_SHOWN = 30;
 const HOME_RUNNING_SHOWN = 8;
+/** How many rows finished in the last 7 days Home lists; the rest open in Tasks. */
+const HOME_DONE_SHOWN = 8;
 /** "7 need you across 2 projects." — the sentence and the figures read the same totals. */
 export function homeSentence(needs, perProject, scope, any) {
     if (!any)
@@ -51,50 +52,54 @@ function rowOf(store, item, now, multi, canAnswer, closedDoor) {
             : href === null || action === null ? null : { label: action.label, href }, question,
     };
 }
-/** Home's view for one person and scope, from two reads of the work index (what waits, what runs). */
+/** Home's view for one person and scope, from four reads of the work index (what waits on you, what runs, what waits on
+ * Toolroll, what was done), grouped by the one rule every surface shares (home-groups.ts). */
 export function homeView(facts) {
     const { store, now, access, project } = facts;
     const read = (view, limit) => workIndexPage(store, now, access, { view, limit, project, ...(facts.evidenceRoot === undefined ? {} : { root: facts.evidenceRoot }) });
     const needs = read("needs-you", HOME_NEEDS_SHOWN);
     const running = read("running", HOME_RUNNING_SHOWN);
-    // Waiting (docs/plans/plain-toolroll.md P1.4): what Toolroll or another task moves on, with no person asked.
-    const waiting = workIndexPage(store, now, access, { view: "queued", limit: HOME_RUNNING_SHOWN, project, ...(facts.evidenceRoot === undefined ? {} : { root: facts.evidenceRoot }) });
+    // Queued: what waits its turn, or what Toolroll or another task moves on, with no person asked.
+    const waiting = read("queued", HOME_RUNNING_SHOWN);
+    // Done: the Completed list is ordered by completion time, newest first, so its first rows are the newest finished;
+    // only those finished in the last 7 days are listed, and that filter runs before the cap.
+    const completed = read("completed", HOME_DONE_SHOWN);
     const totals = needs.totals;
     // Queued: the Tasks list's own Queued count (the same predicate its view=queued filter lists).
     const queued = totals.queued;
     // Every project is said by name (scope=all): /tasks alone would narrow to the session's open project.
     const scopeQuery = project === null ? "scope=all&" : `project=${encodeURIComponent(project)}&`;
+    // Each figure keeps the name of the list it opens; Done is the whole Completed list, not just this week.
     const counts = [
-        { key: "needs", label: "Needs you", value: totals["needs-you"], href: `/tasks?${scopeQuery}view=needs-you` },
+        { key: "needs", label: HOME_GROUP_LABEL.you, value: totals["needs-you"], href: `/tasks?${scopeQuery}view=needs-you` },
         { key: "running", label: "Running", value: totals.running, href: `/tasks?${scopeQuery}view=running` },
         { key: "queued", label: "Queued", value: queued, href: `/tasks?${scopeQuery}view=queued` },
-        { key: "finished", label: "Finished", value: totals.completed, href: `/tasks?${scopeQuery}view=completed` },
+        { key: "finished", label: HOME_GROUP_LABEL.done, value: totals.completed, href: `/tasks?${scopeQuery}view=completed` },
     ];
-    const multi = project === null && new Set([...needs.items, ...running.items].map(one => one.repo ?? "")).size > 1;
+    // One row per family, in the first group that claims it.
+    const seen = new Set();
+    const take = (items, group) => items.filter(one => {
+        if (homeGroupOf(one) !== group || seen.has(one.rootId))
+            return false;
+        seen.add(one.rootId);
+        return true;
+    });
+    // Waiting on you, in today's order of what it asks: decide (with any row whose ask the index couldn't name, which
+    // still waits on this person and is never lost), then review, then unblock. Each row's chip names its ask.
+    const yours = take(["decide", null, "review", "unblock"].flatMap(ask => needs.items.filter(one => one.ask === ask)), "you");
+    // Working: what runs, then what is queued (waits its turn, or on Toolroll or another task), each read with its own bound.
+    const working = [...take(running.items, "working"), ...take(waiting.items, "working")];
+    const weekAgo = new Date(now.getTime() - 7 * 86_400_000).toISOString();
+    const done = take(completed.items.filter(one => (one.completion?.at ?? one.updatedAt) >= weekAgo), "done").slice(0, HOME_DONE_SHOWN);
+    const multi = project === null && new Set([...yours, ...working, ...done].map(one => one.repo ?? "")).size > 1;
     const groups = [];
-    for (const ask of ASKS) {
-        const rows = needs.items.filter(one => one.ask === ask).map(one => rowOf(store, one, now, multi, facts.canAnswer, facts.closedDoor));
-        if (rows.length > 0)
-            groups.push({ key: ask, label: ASK_LABEL[ask], rows });
+    for (const [key, items] of [["you", yours], ["working", working], ["done", done]]) {
+        if (items.length > 0)
+            groups.push({ key, label: HOME_GROUP_LABEL[key], rows: items.map(one => rowOf(store, one, now, multi, facts.canAnswer, facts.closedDoor)) });
     }
-    // A waiting row whose ask the index couldn't name still waits on this person: it goes under Decide, never lost.
-    const unnamed = needs.items.filter(one => one.ask === null).map(one => rowOf(store, one, now, multi, facts.canAnswer, facts.closedDoor));
-    if (unnamed.length > 0) {
-        const decide = groups.find(one => one.key === "decide");
-        if (decide)
-            decide.rows.push(...unnamed);
-        else
-            groups.unshift({ key: "decide", label: ASK_LABEL.decide, rows: unnamed });
-    }
-    const live = running.items.filter(one => !one.status.views.includes("needs-you")).map(one => rowOf(store, one, now, multi, facts.canAnswer, facts.closedDoor));
-    if (live.length > 0)
-        groups.push({ key: "running", label: "Running", rows: live });
-    const waits = waiting.items.filter(one => one.status.label === "Waiting" && !one.status.views.includes("needs-you")).map(one => rowOf(store, one, now, multi, facts.canAnswer, facts.closedDoor));
-    if (waits.length > 0)
-        groups.push({ key: "waiting", label: "Waiting", rows: waits });
     const perProject = needs.projects.map(one => ({ name: one.repo === null ? "Unplaced" : projectName(one.repo), needs: one.totals["needs-you"] }));
     const any = totals.all > 0 || totals.completed > 0 || (totals.archived ?? 0) > 0;
-    const shown = groups.filter(one => one.key !== "running" && one.key !== "waiting").reduce((sum, one) => sum + one.rows.length, 0);
+    const shown = yours.length;
     return {
         kind: "home",
         say: homeSentence(totals["needs-you"], perProject, project === null ? null : projectName(project), any),

package/dist/server/render-chat.js

@@ -396,7 +396,7 @@ export function chatLimitsHtml(facts) {
         html `<span>${facts.turnsToday} / ${facts.dailyTurns} turns today</span>`,
     ];
     if (facts.subscription)
-        rows.push(html `<span>membership login · no dollar ceiling</span>`);
+        rows.push(html `<span>membership login · no dollar limit</span>`);
     else if (facts.weekly !== null)
         rows.push(html `<span>this week ${chatMoney(facts.weekly.spent)} of ${chatMoney(facts.weekly.ceiling)}</span>`);
     return html `<details class="chat-limits"><summary>Model &amp; limits<span class="meta">${facts.subscription ? "membership" : facts.provider}</span></summary><div class="chat-budget">${rows}</div></details>`;
@@ -564,7 +564,7 @@ export function proposalCardParts(view, inert, decision, returnTo = null) {
         hold: { label: "Pause work", action: "hold", icon: html `<rect x="6" y="4" width="4" height="16" rx="1"/><rect x="14" y="4" width="4" height="16" rx="1"/>` },
         unhold: { label: "Resume work", action: "release hold", icon: html `<path d="m7 4 13 8-13 8z"/>` },
         steer: { label: "Guidance for the agent", action: "add guidance", icon: html `<path d="M5 12h14"/><path d="m13 6 6 6-6 6"/>` },
-        scope: { label: "Scope revision", action: "save scope", icon: html `<path d="M12 20h9"/><path d="M16.5 3.5a2.1 2.1 0 0 1 3 3L8 18l-4 1 1-4z"/>` },
+        scope: { label: "Plan change", action: "save plan", icon: html `<path d="M12 20h9"/><path d="M16.5 3.5a2.1 2.1 0 0 1 3 3L8 18l-4 1 1-4z"/>` },
         answer: { label: "Decision answer", action: "confirm answer", icon: html `<path d="M9.1 9a3 3 0 1 1 5.8 1c0 2-3 2-3 4"/><path d="M12 18h.01"/><circle cx="12" cy="12" r="9"/>` },
         cancel: { label: "Cancel task", action: "open task", icon: html `<path d="m15 9-6 6"/><path d="m9 9 6 6"/><circle cx="12" cy="12" r="9"/>` },
         repair: {
@@ -599,7 +599,8 @@ export function proposalCardParts(view, inert, decision, returnTo = null) {
     }
     else if (view.kind === "action") {
         const action = sharedActionPayload(payload);
-        what = action === null ? html `<p>This action is unavailable.</p>` : (sharedActionNeedsReview(action) ? html `` : html `${action.terms.map(term => html `<p style="white-space:pre-wrap;overflow-wrap:anywhere">${term}</p>`)}`);
+        // A Start card (one-step-chat.md C2) names what starts and where; its whole terms and the confirm are on the review page.
+        what = action === null ? html `<p>This action is unavailable.</p>` : action.operation === "task_start" ? html `<h3>${action.title}</h3>${facts(["project", mono(action.repo.split(/[\\/]/).filter(Boolean).at(-1) ?? action.repo)])}` : (sharedActionNeedsReview(action) ? html `` : html `${action.terms.map(term => html `<p style="white-space:pre-wrap;overflow-wrap:anywhere">${term}</p>`)}`);
     }
     else if (view.kind === "task_action") {
         const operation = payload["operation"];
@@ -723,7 +724,7 @@ export function proposalCardParts(view, inert, decision, returnTo = null) {
     if (view.state === "pending" && !inert) {
         acts =
             view.kind === "action" && sharedActionPayload(payload) !== null && sharedActionNeedsReview(sharedActionPayload(payload))
-                ? html `<a class="button-link" href="${sharedActionReviewPath(view.id)}">Review action</a>${dismissForm(html `<button class="quiet">Dismiss</button>`)}`
+                ? html `<a class="button-link" href="${sharedActionReviewPath(view.id)}">${reviewWords(sharedActionPayload(payload))}</a>${dismissForm(html `<button class="quiet">Dismiss</button>`)}`
                 : view.kind === "control"
                     ? (isChatControl(payload["control"]) ? html `<a class="button-link" href="${chatControlHref(payload["control"], task, payload["run"], payload["project"])}">${CHAT_CONTROLS[payload["control"]].label}</a>` : html `<p>Control unavailable.</p>`)
                     : view.kind === "cancel"
@@ -758,7 +759,7 @@ export function proposalCardParts(view, inert, decision, returnTo = null) {
     const sentence = (words) => words.charAt(0).toUpperCase() + words.slice(1);
     const pending = view.state === "pending" && !inert;
     const primary = !pending ? null
-        : reviewAction !== null && sharedActionNeedsReview(reviewAction) ? { kind: "link", label: "Review action", href: sharedActionReviewPath(view.id) }
+        : reviewAction !== null && sharedActionNeedsReview(reviewAction) ? { kind: "link", label: reviewWords(reviewAction), href: sharedActionReviewPath(view.id) }
             : view.kind === "control" ? (isChatControl(payload["control"]) ? { kind: "link", label: CHAT_CONTROLS[payload["control"]].label, href: chatControlHref(payload["control"], task, payload["run"], payload["project"]) } : null)
                 : view.kind === "cancel" ? { kind: "link", label: "Open task", href: taskHref(task) }
                     : { kind: "confirm", label: sentence(presentation.action), irreversible, native: view.kind === "task_action" && payload["operation"] === "resume" };
@@ -777,6 +778,10 @@ export function proposalCardParts(view, inert, decision, returnTo = null) {
     };
     return { html: cardHtml, card };
 }
+/** The review link's words: a Start card's is "Review and start". */
+function reviewWords(action) {
+    return action?.operation === "task_start" ? "Review and start" : "Review action";
+}
 export function leadProposalCard(proposal, inert, decision, returnTo = null) {
     return leadProposalCardParts(proposal, inert, decision, returnTo).html;
 }
@@ -981,7 +986,7 @@ export function leadPage(chrome, data) {
         data.session === null ? "" : html `<details class="lead-follow"><summary>Automatic crew updates${data.follow?.enabled ? ' · On' : ''}</summary><p class="meta">${data.follow?.detail ?? 'Automatic crew updates are off.'}</p>${postForm("/chat/mate/follow", html `${data.follow?.enabled ? '' : html `<p>The lead responds when results or decisions arrive. Uses this conversation’s ${subscription ? 'membership usage, with no dollar maximum' : 'remaining spend allowance'} and daily turn limit. Existing task approvals still apply.</p>`}<button type="submit" class="quiet">${data.follow?.enabled ? 'Pause updates' : 'Enable updates'}</button>`, { returnTo, hidden: { enabled: data.follow?.enabled ? 'no' : 'yes' } })}</details>`,
         html `<details class="chat-limits chat-session-details"><summary>Conversation details<span class="meta">${subscription ? "membership" : data.config.provider}</span></summary>\n${joinHtml([
             html `<div class="chat-budget"><span class="mono">${data.config.provider} · ${data.config.model}</span><span>${data.turnsToday} / ${data.config.dailyTurns} turns today</span>${subscription
-                ? html `<span>membership login · no dollar ceiling</span>`
+                ? html `<span>membership login · no dollar limit</span>`
                 : html `<span>this conversation: ${chatMoney(data.session?.spentMicrousd ?? 0)} of ${chatMoney(data.session?.ceilingMicrousd ?? 0)}</span><span>this week ${chatMoney(data.weeklySpent)} of ${chatMoney(data.config.weeklyCeilingMicrousd)}</span>`}</div>`,
             data.session === null
                 ? html `<p class="meta">No conversation yet. Send a message to start one.</p>`

package/dist/server/render-pages.js

@@ -439,7 +439,7 @@ export function workPage(chrome, data) {
         ['finished', 'Finished', data.board.finished, 'completed', 'Nothing has finished yet.'],
     ].map(([key, label, page, view, empty]) => ({ key, label, count: page.totals[view], href: query({ view, layout: 'list' }), empty, rows: page.items.map(rowOf) }));
     const putAwayLink = data.canPutAway === true && data.view !== 'archived' ? { label: 'Archive old tasks', href: '/tasks/archive' } : null;
-    const toolLinks = [['/tasks?view=order', 'Order the queue'], ['/recipes', 'Recipes'], ...(chrome.projectScoped ? [] : [['/tasks?scope=all', 'Every project']]), ['/ledger', 'Action ledger']];
+    const toolLinks = [['/tasks?view=order', 'Order the queue'], ['/recipes', 'Recipes'], ...(chrome.projectScoped ? [] : [['/tasks?scope=all', 'Every project']]), ['/ledger', 'Audit log']];
     const newTaskHref = lens === null ? '/tasks/new' : `/tasks/new?project=${encodeURIComponent(lens)}`;
     const emptyNow = 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) } } : {
         text: data.previous ? 'There are no more tasks on this page.' : current.empty,
@@ -496,7 +496,7 @@ export function workPage(chrome, data) {
             ? html `<div class="work-empty" data-work-empty="${data.view}"><p>${data.previous ? 'There are no more tasks on this page.' : current.empty}</p>${data.view === 'all' && !data.previous ? html `<p><a class="button-link" href="${chrome.chat === true ? '/chat' : '/tasks/new'}">${chrome.chat === true ? 'Start in chat' : 'Add a task'}</a></p>` : html `<a href="${href('all')}">See all tasks →</a>`}</div>`
             : html `<div class="work-list">${data.work.items.map(rowHtml)}</div>`;
     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">${[['/', 'Home'], ['/tasks?view=board', 'Board'], ['/tasks?view=order', 'Order'], ['/recipes', 'Recipes'], ...(chrome.projectScoped ? [] : [['/tasks?scope=all', 'Every project']]), ['/ledger', 'Action ledger']]
+    const tools = html `<details class="work-tools"><summary>Work tools${CHEVRON_ICON}</summary><nav class="work-tools-menu">${[['/', 'Home'], ['/tasks?view=board', 'Board'], ['/tasks?view=order', 'Order'], ['/recipes', 'Recipes'], ...(chrome.projectScoped ? [] : [['/tasks?scope=all', 'Every project']]), ['/ledger', 'Audit log']]
         .map(([path, label]) => html `<a href="${path}">${label}</a>`)}</nav></details>`;
     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)}${legacyTabs}${stateLinks}${list}${pages}`, { chrome, workspace: { view } });
 }

package/dist/setup-guide.d.ts

@@ -15,10 +15,10 @@ export declare function detectPreparation(repo: string): {
 } | null;
 /** Browser installation may write only this known file inside its project. */
 export declare function previewProjectInstructions(repo: string): {
+    content?: never;
     ok: false;
     message: string;
     plan?: never;
-    content?: never;
     fingerprint?: never;
     installed?: never;
 } | {
@@ -30,10 +30,10 @@ export declare function previewProjectInstructions(repo: string): {
     installed: boolean;
 };
 export declare function addProjectInstructions(repo: string, fingerprint: string): {
+    content?: never;
     ok: false;
     message: string;
     plan?: never;
-    content?: never;
     fingerprint?: never;
     installed?: never;
 } | import("./skills.js").InstallResult;

package/dist/staged-runtimes.js

@@ -12,6 +12,7 @@ import { lstatSync, readFileSync, readdirSync, readlinkSync, realpathSync, rmSyn
 import { execFileSync } from "node:child_process";
 import { homedir } from "node:os";
 import { basename, dirname, join, resolve, sep } from "node:path";
+import { isDeployed } from "./deploy-phase.js";
 import { quarantine, quarantineEntries, claimQuarantine, releaseQuarantine, restoreQuarantine, deleteQuarantineSync } from "./sweep-quarantine.js";
 import { processCensus } from "./run-closeout.js";
 const DAY_MS = 86_400_000;
@@ -84,7 +85,7 @@ function readStage(path, name, fallbackAt) {
             at = 0;
         }
     }
-    const finished = deploy !== null ? deploy["phase"] === "deployed" : update !== null ? typeof update["finishedAt"] === "string" : false;
+    const finished = deploy !== null ? isDeployed(deploy["phase"]) : update !== null ? typeof update["finishedAt"] === "string" : false;
     const from = update?.["from"];
     const prior = typeof deploy?.["priorRuntime"] === "string" ? deploy["priorRuntime"] : typeof from?.dist === "string" ? from.dist : null;
     let keptAside = false;

package/dist/store.d.ts

@@ -10,6 +10,7 @@ import { V155_STEPS } from "./fleet-schema.js";
 import { V156_STEPS } from "./fallback-schema.js";
 import { V158_STEPS, type LeadFailureDetail, type LeadRoute } from "./lead-latency-schema.js";
 import { V157_STEPS } from "./chat-live-schema.js";
+import { V159_STEPS } from "./one-step-chat-schema.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";
@@ -250,7 +251,7 @@ export type SealedLedgerEntry = LedgerEntry & {
         hash: string;
     } | null;
 };
-export declare const SCHEMA_VERSION = 158;
+export declare const SCHEMA_VERSION = 159;
 /** 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>>;
 /**
@@ -442,7 +443,7 @@ export declare const V147_ADDED_COLUMNS: Readonly<Record<string, Readonly<Record
 }>>>>;
 /** The v147 migration's steps after the epoch, in order: a test seam (OpenOptions.migrationStep) may stop after each. */
 export declare const V147_STEPS: readonly ["epoch", "local-mode", "password-set", "web-session", "console-instance"];
-export type MigrationStep = (typeof V147_STEPS)[number] | (typeof V148_STEPS)[number] | (typeof V149_STEPS)[number] | (typeof V150_STEPS)[number] | (typeof V151_STEPS)[number] | (typeof V152_STEPS)[number] | (typeof V153_STEPS)[number] | (typeof V154_STEPS)[number] | (typeof V156_STEPS)[number] | (typeof V155_STEPS)[number] | (typeof V157_STEPS)[number] | (typeof V158_STEPS)[number];
+export type MigrationStep = (typeof V147_STEPS)[number] | (typeof V148_STEPS)[number] | (typeof V149_STEPS)[number] | (typeof V150_STEPS)[number] | (typeof V151_STEPS)[number] | (typeof V152_STEPS)[number] | (typeof V153_STEPS)[number] | (typeof V154_STEPS)[number] | (typeof V156_STEPS)[number] | (typeof V155_STEPS)[number] | (typeof V157_STEPS)[number] | (typeof V158_STEPS)[number] | (typeof V159_STEPS)[number];
 /**
  * v148 (docs/plans/results-routing.md): every table the results-routing arc uses, landed at once because a current
  * store runs no DDL. Slice 1 writes run_cohort, route_record and models_generation; route_rule, route_exposure* and
@@ -532,6 +533,7 @@ export { V155_STEPS };
 export { V156_STEPS };
 export { V157_STEPS };
 export { V158_STEPS };
+export { V159_STEPS };
 /**
  * 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

package/dist/store.js

@@ -15,6 +15,7 @@ import { FINDING_SOURCES, FINDING_SOURCES_BEFORE_LEAD, V155_SCHEMA, V155_STEPS }
 import { V156_SCHEMA, V156_STEPS } from "./fallback-schema.js";
 import { V158_ADDED_COLUMNS, V158_SCHEMA, V158_STEPS, LEAD_FAILURE_DETAILS, LEAD_ROUTES } from "./lead-latency-schema.js";
 import { V157_SCHEMA, V157_STEPS } from "./chat-live-schema.js";
+import { V159_ADDED_COLUMNS, V159_SCHEMA, V159_STEPS } from "./one-step-chat-schema.js";
 import { refArchived, taskArchived } from "./task-archive.js";
 export { refArchived, taskArchived } from "./task-archive.js";
 import { CHAT_PROVIDERS, CHAT_SCHEMA } from "./contracts/chat-tables.js";
@@ -1148,7 +1149,10 @@ const REGISTERED_AT_FILING = "again, as it was filed";
 // v158 adds, and changes no saved row (docs/plans/responsive-chat.md, slice 5): the tools each lead step asked for, an
 // exact failure detail on a step and a reply, which model answered a reply (mate_turn.route), and the quick-answer
 // switch (lead_quick_setting). V158_SCHEMA, V158_ADDED_COLUMNS (lead-latency-schema.ts): saved rows read NULL.
-export const SCHEMA_VERSION = 158;
+// v159 adds, and changes no saved row (docs/plans/one-step-chat.md): the lead turn a chat start's preview was prepared
+// in (fast_preview.turn) and a typed yes's record (chat_typed_start, a new table). V159_SCHEMA, V159_ADDED_COLUMNS
+// (one-step-chat-schema.ts): saved rows read NULL.
+export const SCHEMA_VERSION = 159;
 /** v118: the tables merged into `credential`, in the order they move (a person's API tokens keep their ids first). */
 export const V118_MERGED_TABLES = Object.freeze({ api_token: "person", coordinator_credential: "coordinator", lead_credential: "lead" });
 /** The foreign keys that named a merged table, exactly as their DDL wrote them; each names `credential(id)` instead. */
@@ -1281,7 +1285,7 @@ const V115_DROPPED_REFERENCES = /\s+REFERENCES (?:contestant|contest|tournament_
  * unchanged), and adds the nullable column in V125_ADDED_COLUMNS, checked the same way. v126 only adds a new table
  * (task_source) and the columns in V126_ADDED_COLUMNS (null or 0), checked the same way.
  */
-export const UPDATE_SAFE_MIGRATIONS = Object.freeze([108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158]);
+export const UPDATE_SAFE_MIGRATIONS = Object.freeze([108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122, 123, 124, 125, 126, 127, 128, 129, 130, 131, 132, 133, 134, 135, 136, 137, 138, 139, 140, 141, 142, 143, 144, 145, 146, 147, 148, 149, 150, 151, 152, 153, 154, 155, 156, 157, 158, 159]);
 /** v119: the columns it adds, by table, with the value every row saved before it reads (toolroll-update's HISTORY_RULES). */
 export const V119_ADDED_COLUMNS = Object.freeze({
     task_ref: { planning_generation: { definition: "INTEGER NOT NULL DEFAULT 0", saved: "0" } },
@@ -1944,6 +1948,7 @@ export { V155_STEPS };
 export { V156_STEPS };
 export { V157_STEPS };
 export { V158_STEPS };
+export { V159_STEPS };
 /**
  * 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
@@ -5293,6 +5298,13 @@ CREATE INDEX IF NOT EXISTS run_checkpoint_by_task ON run_checkpoint (task_ref, i
         for (const [column, { definition }] of Object.entries(columns))
             addColumn(db, table, column, definition);
     step("lead-latency-columns");
+    // v159: one-step start from chat (V159_SCHEMA, V159_ADDED_COLUMNS: saved rows read NULL). Idempotent, as v158's are.
+    db.exec(V159_SCHEMA);
+    step("one-step-chat-tables");
+    for (const [table, columns] of Object.entries(V159_ADDED_COLUMNS))
+        for (const [column, { definition }] of Object.entries(columns))
+            addColumn(db, table, column, definition);
+    step("one-step-chat-columns");
     // Keep the epoch until reclamation succeeds, including a retry after compaction already committed. A new file has
     // nothing to reclaim.
     if (!fresh)
@@ -8244,6 +8256,9 @@ export class Store {
                     throw new ReleaseSealRefused();
             }
             if (changed.changes > 0) {
+                // A real seal is work a builder can take now: wake the loops (live-wakeups.md). Inside the seal's own
+                // transaction, so a seal that rolls back wakes nothing. The claim re-proves the approval regardless.
+                this.bumpWake();
                 // The project's tools this yes saw (v80): a later addition needs a later yes.
                 this.sealProjectTools(taskId, String(working["digest"]), now);
                 // A fresh yes lifts the stale-approval hold and closes its page
@@ -11754,17 +11769,23 @@ export class Store {
      * enough, and neither is a stale yes).
      */
     markCapability(repo, kind, name, outcome, now, expiresAt = null) {
-        const { changes } = this.db
-            .prepare(`UPDATE capability SET status = ?, last_verified_at = ?, verified_by = ?, last_result = ?, expires_at = COALESCE(?, expires_at)
+        return this.transact(() => {
+            // The status before this answer, read in the same transaction: only a gap that fills wakes the loop. A
+            // repeated passing probe refreshes the timestamp and says nothing new, so it must not wake (live-wakeups.md).
+            const prior = this.db.prepare("SELECT status FROM capability WHERE repo = ? AND kind = ? AND name = ?").get(repo, kind, name);
+            const { changes } = this.db
+                .prepare(`UPDATE capability SET status = ?, last_verified_at = ?, verified_by = ?, last_result = ?, expires_at = COALESCE(?, expires_at)
           WHERE repo = ? AND kind = ? AND name = ?`)
-            .run(outcome.status, outcome.status === "verified" ? now.toISOString() : null, outcome.by, outcome.detail ?? null, expiresAt, repo, kind, name);
-        // A gap that just filled ends its notification episode: the next failure
-        // is a new fact, and must be allowed to say so.
-        if (Number(changes) > 0 && outcome.status === "verified") {
-            this.clearGapEpisode(repo, kind, name);
-            this.bumpWake();
-        }
-        return Number(changes) > 0;
+                .run(outcome.status, outcome.status === "verified" ? now.toISOString() : null, outcome.by, outcome.detail ?? null, expiresAt, repo, kind, name);
+            // A gap that just filled ends its notification episode: the next failure
+            // is a new fact, and must be allowed to say so.
+            if (Number(changes) > 0 && outcome.status === "verified") {
+                this.clearGapEpisode(repo, kind, name);
+                if (prior?.["status"] !== "verified")
+                    this.bumpWake();
+            }
+            return Number(changes) > 0;
+        });
     }
     /** Set what a task needs, as `kind:name` keys, replacing what it needed before. */
     setRequirements(taskRef, keys, mutation = {}) {
@@ -16452,6 +16473,8 @@ export class Store {
                   generation = generation + 1, last_error = NULL
             WHERE id = ? AND state = 'waiting-human'`)
                 .run(id);
+            // The person's yes makes the merge actionable now: wake the loops (live-wakeups.md). The firing CAS re-proves it.
+            this.bumpWake();
             return { ok: true };
         });
     }

package/dist/telegram-lead.js

@@ -1,7 +1,8 @@
 import { telegramCardMessage } from "./card-render.js";
 import { cardOfProposal, cardPlainOf, cardsFirst, cardWithin, isCardProposal } from "./chat-card.js";
 import { CHAT_ACTIONS, sharedActionAllowsChallenge, sharedActionPayload } from "./chat-actions.js";
-import { armedQuestion, taskInCeiling, mirrorToTaskChat, couldNotAnswerText, channelRepos as telegramConversationRepos, resolveChannelLead as resolveTelegramLead, NO_PHONE_LINK, NO_TASK_LINK, phoneProposalLink, confirmedLink, phoneProposalPreview, proposalOutcomeText, handoffCardText, confirmedCardText } from "./chat-channel.js";
+import { typedStartOf } from "./typed-start.js";
+import { armedQuestion, taskInCeiling, mirrorToTaskChat, couldNotAnswerText, channelRepos as telegramConversationRepos, resolveChannelLead as resolveTelegramLead, NO_PHONE_LINK, NO_TASK_LINK, phoneProposalLink, confirmedLink, startedTaskLink, phoneProposalPreview, proposalOutcomeText, handoffCardText, confirmedCardText } from "./chat-channel.js";
 export { channelRepos as telegramConversationRepos, resolveChannelLead as resolveTelegramLead, tooLongText, whichTaskText, replyContextFor, NO_PHONE_LINK, NO_TASK_LINK, proposalLink, confirmedLink, proposalPreview, proposalOutcomeText, handoffCardText, confirmedCardText, CHAT_ACTION_PARITY as TELEGRAM_ACTION_PARITY, parityGaps } from "./chat-channel.js";
 /**
  * The paired phone as one more way to use the same assistant.
@@ -26,7 +27,7 @@ export { channelRepos as telegramConversationRepos, resolveChannelLead as resolv
  */
 import { createHash, randomBytes } from "node:crypto";
 import { leadFailureText, runLeadTurn } from "./lead.js";
-import { confirmLeadProposal, dismissLeadProposal } from "./lead-doors.js";
+import { confirmLeadProposal, confirmTypedStart, dismissLeadProposal, TYPED_START_STARTED } from "./lead-doors.js";
 import { ceilingDigestOf, verifyApproverStanding } from "./principal.js";
 import { LEAD_ASK_OTHER } from "./store.js";
 import { phoneText } from "./telegram-status.js";
@@ -129,7 +130,10 @@ export function mintCardTokens(store, binding, proposal, now, messageId, chatId
     for (const [token, phase] of [[confirm, "confirm"], [dismiss, "dismiss"]]) {
         store.createTelegramProposalAction({ token, binding: binding.id, proposal, phase, chatId, ttlMs: CARD_TTL_MS, ...(messageId === undefined ? {} : { messageId }) }, now);
     }
-    return { keyboard: [[telegramButton("Confirm", confirm), telegramButton("Dismiss", dismiss)]], tokens: [confirm, dismiss] };
+    // A Start card's button says what it does: the card's last line tells the person to tap it (or reply yes).
+    const saved = store.getLeadProposal(proposal);
+    const label = saved?.kind === "action" && sharedActionPayload(saved.payload)?.operation === "task_start" ? "Start work" : "Confirm";
+    return { keyboard: [[telegramButton(label, confirm), telegramButton("Dismiss", dismiss)]], tokens: [confirm, dismiss] };
 }
 /**
  * One tap on a proposal card, applied inside the update's own transaction
@@ -249,7 +253,7 @@ export function applyProposalTap(store, binding, token, message, repos, options,
     }
     const irreversible = proposal.kind === "answer" && proposal.payload["reversible"] === false;
     const sharedAction = proposal.kind === "action" ? sharedActionPayload(proposal.payload) : null;
-    const challenged = sharedAction !== null && sharedActionAllowsChallenge(sharedAction);
+    const challenged = sharedAction !== null && sharedActionAllowsChallenge(sharedAction, "telegram");
     // The arm: two fresh one-time tokens make a real challenge, exactly as a
     // decision button does. Nothing is answered or recorded here.
     const arm = () => {
@@ -573,7 +577,11 @@ async function runTelegramConversation(row, args) {
                 const proposal = part.kind === "card" && part.proposal !== null ? store.getLeadProposal(part.proposal) : null;
                 const origin = proposal === null ? null : options.phoneOrigin?.() ?? null;
                 const wanted = proposal === null ? null : phoneProposalLink(store, proposal, repos);
-                const keyboard = keyboardWith(part.keyboard, phoneLinkButton(origin, wanted));
+                // A typed yes that started a task (one-step-chat.md C5): Toolroll's reply carries the task's link, as a tapped
+                // card does. From the record and the origin read now, like every link.
+                const yes = part.kind === "reply" ? typedStartOf(store, "telegram", `m${row.id}`) : null;
+                const started = yes !== null && yes.outcome === "started" && yes.taskId !== null ? phoneLinkButton(options.phoneOrigin?.() ?? null, startedTaskLink(store, yes.taskId, repos)) : null;
+                const keyboard = keyboardWith(part.keyboard, started ?? phoneLinkButton(origin, wanted));
                 // A Toolroll card: read again now, shown only where every project behind it is still reachable. An unreadable
                 // one goes out as its saved plain words.
                 const isCard = proposal !== null && isCardProposal(proposal);
@@ -751,6 +759,62 @@ async function runTelegramConversation(row, args) {
         return;
     }
     const repos = telegramConversationRepos(store, binding.approver, registry);
+    // A typed yes to a Start card (docs/plans/one-step-chat.md C5), recorded when the message arrived: Toolroll acts on it
+    // here and no lead turn runs for it. Its outcome and Toolroll's own reply are written in ONE transaction (the claim
+    // fences the reply; a lapsed claim takes the whole act back), then sent like any reply. A settled record returns its
+    // first outcome, so a redelivery or a crash starts nothing more.
+    const typed = typedStartOf(store, "telegram", `m${row.id}`);
+    if (typed !== null) {
+        const verified = verifyApproverStanding(store, binding.approver, binding.approverGeneration, repos);
+        // The card's turn is gone when the chat was ended (its proposals are deleted) or its project deleted: there is then
+        // no session to send a reply under, and nothing can have started. Toolroll says so itself. The yes is never passed on.
+        const unanchored = { said: null };
+        try {
+            store.transact(() => {
+                const now = clock();
+                const answered = confirmTypedStart(store, verified.ok ? verified.who : null, { provider: "telegram", event: typed.event }, now, { binding: binding.id, evidenceRoot: options.evidenceRoot });
+                // The reply is fenced on the session the card was composed under.
+                const card = store.getLeadProposal(typed.proposal);
+                const turn = card === null ? null : store.getLeadTurn(card.turn);
+                if (turn === null) {
+                    // A start without its card can't happen (the door re-reads the card); if it ever did, take it back.
+                    if (answered.ok)
+                        throw new PlanRefused();
+                    unanchored.said = answered.said;
+                    return;
+                }
+                // The card is answered: its buttons are spent with it.
+                if (answered.ok)
+                    store.consumeTelegramProposalActions(typed.proposal, now);
+                if (!store.planTelegramConversationParts(row.id, owner, { session: turn.session, turn: turn.id }, [{ kind: "reply", text: answered.said, replyTo: row.messageId }], now))
+                    throw new PlanRefused();
+            });
+        }
+        catch (error) {
+            if (error instanceof PlanRefused)
+                return;
+            throw error;
+        }
+        if (unanchored.said !== null) {
+            await notify(unanchored.said);
+            finish({ state: "failed", outcome: "typed-start:not-counted" });
+            report.refused++;
+            return;
+        }
+        // The card it answered is repainted as a tap's would be, best effort: its buttons are already spent, and the
+        // reply below says the same words with the same link.
+        const settled = typedStartOf(store, "telegram", typed.event);
+        if (settled?.outcome === "started" && settled.taskId !== null && pairingProblem() === null && held()) {
+            const link = phoneLinkButton(options.phoneOrigin?.() ?? null, startedTaskLink(store, settled.taskId, repos));
+            try {
+                await transport("editMessageText", { chat_id: chatId, message_id: Number(typed.cardMessage), text: `✓ ${TYPED_START_STARTED}`, link_preview_options: { is_disabled: true },
+                    reply_markup: { inline_keyboard: link === null ? [] : [link] } });
+            }
+            catch { /* the reply below still says it */ }
+        }
+        await sendOrHandOff("typed-start");
+        return;
+    }
     // 4. A session bound before an earlier dispatch: the receipt lives there,
     // whatever session is live today.
     if (row.session !== null) {

package/dist/telegram-status.js

@@ -8,6 +8,8 @@ import { familyCompleted } from "./result-completion.js";
 import { approvedCheckOf, approvedCheckStateOf, assignmentStatusFacts, checksFactOf, plainReasonOf, stageOfDispatch, taskStatusOf } from "./task-status.js";
 import { assignmentChecksForRun, assignmentOf } from "./assignment.js";
 import { CHAT_CONTROLS, chatControlHref, chatResultHref } from "./chat-controls.js";
+import { homeFiguresLine, homeFiguresOf } from "./home-groups.js";
+import { workIndexPage } from "./work-index.js";
 export function phoneCommand(text) {
     // Slash forms everywhere; the bare words too, because Slack and Discord
     // keep unregistered slash text for themselves. Only a whole message that
@@ -106,10 +108,13 @@ function nextStep(d) {
  * history. This snapshot is intentionally bounded and advertises that bound. */
 export function phoneStatus(store, repos, now, focused = null, root) {
     if (repos.length === 0)
-        return "No connected projects are available to this bridge. Add a project in Toolroll, then send /status again.";
+        return "No projects are connected here yet. Add a project in Toolroll, then send /status again.";
     return store.transact(() => {
         const snapshot = withDispatchDiagnoses(store, store.chatSnapshot(repos, now), now);
-        const lines = [...(focused === null ? [] : [`Talking about: ${focused} · /lead to switch back`, ""]), "Recent work", `As of ${now.toISOString().replace("T", " ").slice(0, 19)} UTC · ${repos.length} project(s)`, ""];
+        // It opens with Home's figures, from the work index totals over these projects (the Tasks lists' own counts);
+        // the groups below are dispatch diagnoses, which are not the work index's families, so they keep their headings.
+        const figures = homeFiguresOf(workIndexPage(store, now, { principal: "operator", repos, includeUnplaced: false }, { limit: 1, ...(root === undefined ? {} : { root }) }).totals);
+        const lines = [homeFiguresLine(figures), "", ...(focused === null ? [] : [`Talking about: ${focused} · /lead to switch back`, ""]), "Recent work", `As of ${now.toISOString().replace("T", " ").slice(0, 19)} UTC · ${repos.length} project(s)`, ""];
         if (snapshot.tasksSaturated)
             lines.push("Newest 60 tasks only — older work may still need attention.", "");
         if (snapshot.tasks.length === 0)
@@ -126,7 +131,7 @@ export function phoneStatus(store, repos, now, focused = null, root) {
                 lines.push(`  +${rows.length - 2} more in the console`);
             lines.push("");
         }
-        lines.push("Send /tasks to pick one, or /task <name> for its next step. Status is a snapshot, not a promise that the next attempt will succeed.");
+        lines.push("Send /tasks to pick one, or /task <name> for its next step. This is how things stand right now.");
         return lines.join("\n");
     });
 }
@@ -251,7 +256,7 @@ export function phoneTaskView(store, repos, id, now, root) {
                 lines.push(`Attempt ended: ${plain(latest.finishedAt, 40)}`);
             else if (d.condition === "running") {
                 const checkpoint = store.latestCheckpointForRun(latest.id);
-                lines.push(checkpoint === null ? "No milestone progress has been recorded for this attempt." : `Latest agent-reported milestone update: ${plain(checkpoint.createdAt, 40)} (not independent proof).`);
+                lines.push(checkpoint === null ? "No milestone progress has been recorded for this attempt." : `Latest update from the agent, not verified: ${plain(checkpoint.createdAt, 40)}.`);
             }
         }
         let link = null;

package/dist/telegram.d.ts

@@ -148,6 +148,8 @@ export type BridgeReport = {
     contention?: number;
     /** v98: Telegram answered that it pushes this bot's updates to a webhook. */
     webhookActive?: boolean;
+    /** The long poll was ended on purpose because a message was due to go out (live-wakeups.md): not a failure. */
+    deliveryWake?: boolean;
     /** v98: pushed updates applied this pass. */
     pushed?: number;
 };
@@ -242,6 +244,8 @@ export declare function followBridge(store: Store, options: {
     } | null;
     /** v98: how often to check Telegram still pushes to us (tests shorten it). */
     pushCheckMs?: number;
+    /** While a long poll is open, how often to look for a message due to go out (tests shorten it). */
+    deliveryCheckMs?: number;
 }): Promise<FollowReport>;
 /** The digest text: a header with the count and the window, then one
  * fact per entry — its subject, then its body's first line, indented.
@@ -260,3 +264,9 @@ export declare function digestText(rows: readonly Notification[], since: string
 export declare const TELEGRAM_MAX_WAITING = 10;
 /** A pushed update was kept for this bot: wake its bridge if it runs in this process (docs/plans/responsive-chat.md §3.1). */
 export declare function wakeTelegramBridge(botId: string): void;
+/**
+ * Whether a message for this bot was written after `mark` and is still due: unresolved, addressed to everyone or to a
+ * person paired with this bot, and the bot not held back by Telegram's rate limit. Read-only; delivery itself still
+ * decides each row under its own fences.
+ */
+export declare function telegramOutboxDue(store: Store, botId: string, mark: number, now: Date): boolean;