toolroll 0.9.97 → 0.9.98

package/dist/reply-voice.js

@@ -0,0 +1,37 @@
+/**
+ * How a lead reply reads (docs/plans/lead-voice.md, V3): its length, its sentences, the internal words it says and
+ * whether it opens by describing its own steps. Measured on the shaped text a person sees, never the raw reply.
+ * A measure for the lead-answer eval's report; nothing gates on it and no reply is rewritten from it.
+ */
+import { PLAIN_WORDS } from "./plain-words.js";
+import { shapeReply } from "./reply-shape.js";
+/** A reply longer than this is counted as long in the eval's report. */
+export const LONG_REPLY_CHARACTERS = 320;
+const CODE = /```[\s\S]*?(?:```|$)|`[^`\n]+`/g;
+const OWNER_AS_ADDRESS = /(?<![\w-])the\s+owner(?![\w-])/i;
+const NARRATED_OPENING = /^(?:i\s+checked|i\s+looked\s+at|let\s+me|certainly|sure,)/i;
+export function replyVoice(reply) {
+    const shaped = shapeReply(reply);
+    const prose = shaped.replace(CODE, " ");
+    const internalWords = PLAIN_WORDS.filter(one => one.pattern.test(prose)).map(one => one.never);
+    if (OWNER_AS_ADDRESS.test(prose))
+        internalWords.push("owner");
+    return {
+        characters: shaped.length,
+        sentences: prose.split(/(?<=[.!?])\s+|\n+/).filter(part => /[\p{L}\p{N}]/u.test(part)).length,
+        internalWords,
+        narratedOpening: NARRATED_OPENING.test(shaped.trimStart()),
+    };
+}
+/** One model's answers, summed up for the report. */
+export function summarizeVoice(voices) {
+    const sorted = voices.map(one => one.characters).sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return {
+        answers: voices.length,
+        medianCharacters: sorted.length === 0 ? 0 : sorted.length % 2 === 1 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2,
+        longShare: voices.length === 0 ? 0 : voices.filter(one => one.characters > LONG_REPLY_CHARACTERS).length / voices.length,
+        internalWords: voices.reduce((sum, one) => sum + one.internalWords.length, 0),
+        narratedOpenings: voices.filter(one => one.narratedOpening).length,
+    };
+}

package/dist/scope.d.ts

@@ -796,10 +796,15 @@ export declare function fileAndSealUnderMode(store: Store, input: ScopeInput & {
     detail?: string;
 };
 export declare function approve(store: Store, taskId: string, by: string, now: Date, sawDigest: string, token: string, mutation?: Mutation, 
-/** A fast start (fast-start.ts): Build is this same yes, with its marker in the proof. Only that road passes it. */
+/** A fast start (fast-start.ts): Build is this same yes, with its marker in the proof. Only that road passes it.
+ * `typed`: a typed yes to a Start card (one-step-chat.md C5), the message that was the yes, recorded beside the marker. */
 fastStart?: {
     rule: string;
     at: string;
+    typed?: {
+        provider: string;
+        event: string;
+    };
 }, 
 /** A person's own yes in chat (owner's decision, docs/plans/toolroll-cards.md): their tap or signed-in click stands in
  * for a password, so `token` is unused. Every rule below still applies. The caller has proved the person is the one

package/dist/scope.js

@@ -1075,7 +1075,8 @@ export function fileAndSealUnderMode(store, input) {
     });
 }
 export function approve(store, taskId, by, now, sawDigest, token, mutation = {}, 
-/** A fast start (fast-start.ts): Build is this same yes, with its marker in the proof. Only that road passes it. */
+/** A fast start (fast-start.ts): Build is this same yes, with its marker in the proof. Only that road passes it.
+ * `typed`: a typed yes to a Start card (one-step-chat.md C5), the message that was the yes, recorded beside the marker. */
 fastStart, 
 /** A person's own yes in chat (owner's decision, docs/plans/toolroll-cards.md): their tap or signed-in click stands in
  * for a password, so `token` is unused. Every rule below still applies. The caller has proved the person is the one
@@ -1216,7 +1217,7 @@ export const APPROVAL_PROOF = "approval proved";
 export const approvalProofDetail = (at, generation, digest, local) => `${new Date(at).toISOString()} · generation ${generation}${local === undefined ? "" : ` · local ${local.generation} ${local.transport}`} · digest ${digest}`;
 /** A fast start's proof: the v1 record proofDetailOf reads, with the marker. `local` keeps the legacy words
  * localSealStandsSql reads, so a local owner's seal stands on the same rule. */
-const fastProofDetail = (fastStart) => (at, generation, digest, local) => JSON.stringify({ v: 1, at: new Date(at).toISOString(), generation, digest, fastStart, ...(local === undefined ? {} : { local: `proof · local ${local.generation} ${local.transport} · seal` }) });
+const fastProofDetail = ({ typed, ...fastStart }) => (at, generation, digest, local) => JSON.stringify({ v: 1, at: new Date(at).toISOString(), generation, digest, fastStart, ...(typed === undefined ? {} : { typed: { provider: typed.provider, event: typed.event } }), ...(local === undefined ? {} : { local: `proof · local ${local.generation} ${local.transport} · seal` }) });
 /** The proof of THIS approval: the approver's own row for these exact bytes (never another approval's words). */
 export function approvalProofOf(store, taskId, by, digest) {
     const rows = store.handle.prepare("SELECT outcome, detail FROM action_ledger WHERE task_id = ? AND action = ? AND actor = ? ORDER BY id DESC LIMIT 50").all(taskId, APPROVAL_PROOF, by);

package/dist/server/chat.js

@@ -780,7 +780,7 @@ export function createChatHandlers(runtime) {
         const cardJson = String(request.headers["accept"] ?? "").includes("application/json") && !body.has("nonce");
         const cardAnswer = (status, ok, said, taskId = null) => respond(response, status, "application/json", JSON.stringify({ ok, said, taskId }));
         if (principal === null)
-            return cardJson ? cardAnswer(403, false, "Your approver standing changed. Sign in again.") : refuse(response, who, 403, "your approver standing changed — sign in again", back);
+            return cardJson ? cardAnswer(403, false, "Your sign-in changed. Sign in again.") : refuse(response, who, 403, "Your sign-in changed. Sign in again.", back);
         if (op === "dismiss") {
             const dismissed = dismissLeadProposal(store, principal, id, now);
             if (cardJson)
@@ -849,7 +849,7 @@ export function createChatHandlers(runtime) {
             return refuse(response, who, 403, "proposals are confirmed from the browser or the CLI");
         const principal = leadPrincipal(who);
         if (principal === null)
-            return refuse(response, who, 403, "your approver standing changed — sign in again", "/chat");
+            return refuse(response, who, 403, "Your sign-in changed. Sign in again.", "/chat");
         const id = Number(url.pathname.split("/")[2]);
         store.sweepCoordinatorProposals(now);
         const back = body.get("return") === null ? "/chat" : safeReturn(body.get("return"));
@@ -919,7 +919,7 @@ export function createChatHandlers(runtime) {
         if (who.role === "approver" && enabled.billing === "subscription" && unbound) {
             const principal = leadPrincipal(who);
             if (principal === null)
-                return wantsJson ? said(403, "your approver standing changed — sign in again") : refuse(response, who, 403, "your approver standing changed — sign in again", back);
+                return wantsJson ? said(403, "Your sign-in changed. Sign in again.") : refuse(response, who, 403, "Your sign-in changed. Sign in again.", back);
             const sentRequest = body.get("request");
             if (sentRequest !== null && (body.getAll("request").length !== 1 || !/^[a-f0-9]{32}$/.test(sentRequest)))
                 return said(409, "This conversation changed. Reload it before sending your message.");
@@ -961,7 +961,7 @@ export function createChatHandlers(runtime) {
             const requestId = sentRequest ?? randomBytes(16).toString("hex");
             const principal = leadPrincipal(who);
             if (principal === null)
-                return wantsJson ? said(403, "your approver standing changed — sign in again") : refuse(response, who, 403, "your approver standing changed — sign in again", back);
+                return wantsJson ? said(403, "Your sign-in changed. Sign in again.") : refuse(response, who, 403, "Your sign-in changed. Sign in again.", back);
             const message = (body.get("message") ?? "").trim();
             if (message === "" || message.length > LEAD_MESSAGE_MAX_CHARS) {
                 return said(400, `a message is 1 to ${LEAD_MESSAGE_MAX_CHARS} characters`, leadSession.id);

package/dist/server/chrome.js

@@ -726,7 +726,7 @@ export function workToolRows(scoped = false, _offersChat = false, offersCode = f
         { key: "tasks", href: "/tasks", label: "Task list", hint: "everything, filterable by state" },
         { key: "recipes", href: "/recipes", label: "Recipes", hint: "choose, customize, and reuse a workflow" },
         { key: "workbench", href: "/tasks?scope=all", label: "Every project", hint: "every project's tasks in one list" },
-        { key: "ledger", href: "/ledger", label: "Action ledger", hint: "who acted, what happened, and the result" },
+        { key: "ledger", href: "/ledger", label: "Audit log", hint: "who acted, what happened, and the result" },
         { key: "spend", href: "/spend", label: "Spend", hint: "what agent work cost, and monthly budgets" },
     ];
     return scoped ? rows.filter(row => row.key !== "workbench" && row.key !== "spend") : rows;
@@ -737,7 +737,7 @@ export function settingsRows(scoped = false, offersSettings = false) {
         { key: "fleet", href: "/fleet", label: "Fleet", hint: "who is working, and on what" },
         { key: "caps", href: "/caps", label: "Requirements", hint: "tools and credentials builds need" },
         { key: "people", href: "/people", label: "People", hint: "who can sign in, and what they have done" },
-        { key: "mode", href: "/mode", label: "Operating mode", hint: "the signed posture this repository runs under" },
+        { key: "mode", href: "/mode", label: "Operating mode", hint: "how much this project may do without asking" },
         { key: "system", href: "/system", label: "System", hint: "workers, providers, and grants" },
     ];
     return scoped ? rows.filter(row => row.key === "people" || row.key === "settings") : rows;

package/dist/server/home.d.ts

@@ -1,7 +1,7 @@
 /**
  * Home ("/", UI revamp wave B): one sentence that answers "what needs me?", four counts read from the same work index
- * the Tasks list filters (so a count and the list it opens always agree), what waits on this person grouped by what it
- * asks, what is running, and the lead's message box. Reads only: every act keeps its own route and rules (an agent's
+ * the Tasks list filters (so a count and the list it opens always agree), the work in three groups (Waiting on you,
+ * Working, Done; home-groups.ts), and the lead's message box. Reads only: every act keeps its own route and rules (an agent's
  * question is answered through POST /d/<id>/answer, the same one-click act as its own page).
  */
 import type { BrowserHomeView } from "../browser-workspace.js";
@@ -37,5 +37,6 @@ export declare function homeSentence(needs: number, perProject: readonly {
     name: string;
     needs: number;
 }[], scope: string | null, any: boolean): string;
-/** Home's view for one person and scope, from 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 declare function homeView(facts: HomeFacts): BrowserHomeView;

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/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 };
         });
     }