toolroll 0.9.101 → 0.9.103

package/dist/server/tasks.js

@@ -80,7 +80,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 { retiredRedirect } from "./retired-routes.js";
-import { chatReturnWithSaid, matchTaskPath, redirect, respond, reviewHref, safeChatReturn, safeReturn, SAFETY, taskChatHref, taskHref } from "./http.js";
+import { answersInPlace, chatReturnWithSaid, matchTaskPath, redirect, respond, reviewHref, safeChatReturn, safeReturn, SAFETY, taskChatHref, taskHref } from "./http.js";
 import { putAwayPage, boardBody, boardWorkers, QUEUE_FRONT, queueBody, queueScript, TASK_STATES, workPage } from "./render-pages.js";
 import { runEfficiencyOf } from "../run-efficiency.js";
 import { timingFor } from "../latency-timeline.js";
@@ -1165,7 +1165,7 @@ export function createTasksHandlers(runtime) {
         const act = matchTaskPath(url.pathname, `/${verb}$`);
         if (act === null)
             return noPage(who, response);
-        return taskMutation(response, who, act.taskId, verb, posted, now);
+        return taskMutation(response, who, act.taskId, verb, posted, now, ctx.request);
     };
     // Cockpit E: Show in Finder — the checkout proved again right now (live, this machine's runner, inside the pool),
     // then Finder asked to reveal it with a fixed argv. Nothing runs in it; a Mac only.
@@ -1632,7 +1632,9 @@ export function createTasksHandlers(runtime) {
         }
     }
     // ---- mutations -----------------------------------------------------------
-    function taskMutation(response, who, taskId, verb, posted, now) {
+    function taskMutation(response, who, taskId, verb, posted, now, 
+    /** Read only to shape an answer in place (answersInPlace), after the act's proofs. */
+    request = null) {
         const ref = store.lookupRef(taskId);
         if (ref === null || store.getTask(taskId) === null) {
             return refuse(response, who, 404, "no such task", "/tasks");
@@ -2277,9 +2279,13 @@ export function createTasksHandlers(runtime) {
                         : safeChatReturn(requestedReturn);
                 // The release sheet's Approve release (trusted-release-reports.md A7): the same door, its own page for words.
                 const sheet = body.get("sheet") === "release";
-                const approvalProblem = (message, status) => {
+                // Each caller names its outcome (live-pages-and-home.md B2.3); none is inferred from the status.
+                const approvalProblem = (outcome, message, status) => {
                     if (sheet)
                         return releaseSheet.sheetScreen({ who, response, project: null }, taskId, message, status);
+                    // Asked in place: the same proofs ran, only the answer's shape differs.
+                    if (answersInPlace(request))
+                        return answerApprovalInPlace(response, outcome, message, status);
                     if (requestedReturn !== null && requestedReturn !== "next") {
                         return redirect(response, chatReturnWithSaid(approvalBack, message));
                     }
@@ -2287,7 +2293,7 @@ export function createTasksHandlers(runtime) {
                 };
                 const approvingRef = store.lookupRef(taskId);
                 if (approvingRef?.plan === "requested") {
-                    return approvalProblem("approval is blocked while planning is in progress — review the drafted plan first", 409);
+                    return approvalProblem("refused", "approval is blocked while planning is in progress — review the drafted plan first", 409);
                 }
                 // Step-up: the session got you here; only the token agrees. The
                 // digest names what was seen; the nonce proves this exact form was
@@ -2296,25 +2302,25 @@ export function createTasksHandlers(runtime) {
                 const token = body.get("token") ?? "";
                 const nonce = body.get("nonce") ?? "";
                 if (!consumeApprovalNonce(nonce, who.name, taskId, digest)) {
-                    return approvalProblem("that approval form is stale — read it again", 409);
+                    return approvalProblem("refused", "that approval form is stale — read it again", 409);
                 }
                 // An empty password stands for an explicit identity-provider re-check not yet spent, or (cockpit B2) a password
                 // remembered on this session; approve() decides whether these terms may stand on a remembered one.
                 // Easy-start C5: a laptop's local owner approves eligible work with no password (approve() proves it again).
                 if (token === "" && !passwordlessSessionFor(store, who.name) && !ssoNowAvailable(who.name) && withFreshness("approve-standard", () => freshnessFor(who.name)) === null
                     && !(who.authority === "local-owner" && localApprovalEligible(store, who.name, taskId).ok)) {
-                    return approvalProblem("approval requires your password, typed again", 400);
+                    return approvalProblem("refused", "approval requires your password, typed again", 400);
                 }
                 // The sheet binds the release card's digest (the nonce was minted for it): the shared card wrapper decides.
                 if (sheet)
                     return releaseSheet.approveFromSheet({ who, response, project: null }, taskId, digest, token);
                 const scopeRow = store.getScope(taskId);
                 if (scopeRow === null)
-                    return approvalProblem("this task has no scope to approve", 409);
+                    return approvalProblem("refused", "this task has no scope to approve", 409);
                 const planView = planViewOf(ref.id);
                 const expectedDigest = approvalFormDigest(scopeRow.digest, planView?.sha256 ?? null);
                 if (digest !== expectedDigest) {
-                    return approvalProblem("the scope or plan changed while this form was open — read the latest version and approve again", 409);
+                    return approvalProblem("refused", "the scope or plan changed while this form was open — read the latest version and approve again", 409);
                 }
                 // A revision approves ONLY against a brief that still verifies
                 // (Codex M5-M8 audit, IV-3): the batch the screen restated must be
@@ -2324,7 +2330,7 @@ export function createTasksHandlers(runtime) {
                 if (approvingRef !== null && approvingRef.revisionBriefArtifact !== null) {
                     const view = revisionViewOf(approvingRef);
                     if (view !== null && "problem" in view) {
-                        return approvalProblem(`approval is blocked: ${view.problem}`, 409);
+                        return approvalProblem("refused", `approval is blocked: ${view.problem}`, 409);
                     }
                 }
                 // A re-check is spent only if this yes is kept (sealed, or a protected-work vote recorded).
@@ -2332,11 +2338,11 @@ export function createTasksHandlers(runtime) {
                 if (!approved.ok) {
                     // v102: a first yes on protected work is recorded, not refused — the page says who else is needed.
                     if (approved.reason === "second-approver")
-                        return approvalProblem(gateWords({ verdict: "vote", have: approved.have, need: 2, already: approved.already }), 200);
+                        return approvalProblem("vote", gateWords({ verdict: "vote", have: approved.have, need: 2, already: approved.already }), 200);
                     if (approved.reason === "policy")
-                        return approvalProblem(approved.message, 403);
+                        return approvalProblem("refused", approved.message, 403);
                     const status = approved.reason === "changed" || approved.reason === "unrouted" ? 409 : 403;
-                    return approvalProblem(approveRefusalWords(approved.reason), status);
+                    return approvalProblem("refused", approveRefusalWords(approved.reason), status);
                 }
                 // Approve & build again (the plan was rewritten after a build): the same yes requeues, only for the build the
                 // sheet named, and only while it is still the task's latest result, made to an earlier plan than this one.
@@ -2348,10 +2354,12 @@ export function createTasksHandlers(runtime) {
                     const offered = named != null && named.taskRef === ref.id && named.role === "builder" && !!named.scopeDigest && named.scopeDigest !== scopeRow.digest;
                     const requeued = offered ? store.requeueTask(taskId, who.name, now, { run: named.id, scopeDigest: scopeRow.digest }) : null;
                     if (requeued === null || (!requeued.ok && requeued.reason === "moved"))
-                        return approvalProblem("Approved. The task changed while this page was open, so it wasn't built again — check its status.", 200);
+                        return approvalProblem("approved-not-rebuilt", "Approved. The task changed while this page was open, so it wasn't built again — check its status.", 200);
                     if (!requeued.ok)
-                        return approvalProblem(`Approved, but building again didn't start (${requeued.reason}). Use Build again.`, 200);
+                        return approvalProblem("approved-not-rebuilt", `Approved, but building again didn't start (${requeued.reason}). Use Build again.`, 200);
                 }
+                if (!sheet && answersInPlace(request))
+                    return answerApprovalInPlace(response, "approved", "Approved.", 200);
                 return redirect(response, approvalBack);
             }
             case "accept-proof": {
@@ -2759,9 +2767,10 @@ export function createTasksHandlers(runtime) {
                 summary: detail.handoff?.conclusion ?? run.handoff,
             },
             detail,
-            // How it ran: derived from the run's own records once it has finished, display only.
+            // How it ran: derived from the run's own records once it has finished, display only. A read ahead of the page's
+            // link (x-toolroll-read: prefetch) derives it and saves nothing.
             efficiency: (() => { try {
-                return runEfficiencyOf(store, evidenceRoot, run.id, now);
+                return runEfficiencyOf(store, evidenceRoot, run.id, now, requestContext.getStore()?.readPurpose !== "prefetch");
             }
             catch {
                 return null;
@@ -3325,3 +3334,8 @@ export function createReleaseSheetHandlers(runtime) {
     }
     return { routes: { "task.release": showSheet, "task.release.go-on": goOn, "release.locate": locate }, sheetScreen, approveFromSheet };
 }
+/** The answer to an approval asked in place: its named outcome and the same words the page would show, as JSON. Written
+ * only after the approve route's proofs, by the caller that knows the outcome. */
+export function answerApprovalInPlace(response, outcome, words, status) {
+    respond(response, status, "application/json; charset=utf-8", JSON.stringify({ outcome, words }));
+}

package/dist/work-index.d.ts

@@ -27,6 +27,8 @@ export type WorkIndexItem = {
     ask: Ask | null;
     /** The row's chip under its group: the specific ask (needs-you.ts askChipOf), or none. */
     chip: AskChip | null;
+    /** What a Needs you row asks, in Home's six groups (ASK_GROUP_SQL); null for every other row. */
+    askGroup: WorkAskGroup | null;
     primaryAction: WorkAction | null;
     completion: {
         actor: string;
@@ -45,7 +47,9 @@ export type WorkIndexItem = {
         at: string;
     };
 };
-/** `root`: the evidence root, so a result whose checks were Off can read the release check that covers it. */
+/** `root`: the evidence root, so a result whose checks were Off can read the release check that covers it.
+ * `completedSince` (an ISO time): the Completed view lists only what was completed at or after it, filtered before the
+ * page limit, and the page's `completedSince` counts them all. */
 export type WorkIndexOptions = {
     view?: WorkView;
     limit?: number;
@@ -54,16 +58,30 @@ export type WorkIndexOptions = {
     state?: TaskState;
     leadId?: string;
     root?: string;
+    completedSince?: string;
     /** Only these families (by root task id): the sidebar reads its rows' own words this way. */
     roots?: readonly string[];
 };
 /** How the list is grouped: the Needs you rows by their ask, then building, then the rest. */
 export type WorkIndexGroup = Ask | 'building' | 'rest';
 export type WorkIndexGroupCounts = Record<WorkIndexGroup, number>;
+/** What a Needs you row asks, as Home groups it (docs/plans/live-pages-and-home.md B1.2): a release to approve, a plan
+ * to approve, a question to answer, something that went wrong, a result to review, or anything else that needs the
+ * person. A release is a plan to approve whose active task the plane's sealed state names a release (release-approval.ts
+ * releaseTaskOf, docs/plans/home-other-asks.md v2.1); a failed release is still something that went wrong and a
+ * release's result still a result to review. */
+export type WorkAskGroup = 'release' | 'approve' | 'answer' | 'wrong' | 'review' | 'other';
+export declare const WORK_ASK_GROUPS: readonly WorkAskGroup[];
+/** `asks`: the exact Needs you totals per ask group, over every row in view (never only the page). `completedSince`:
+ * how many the Completed view lists from `options.completedSince` on (0 without it). `builderWaits`: how many Needs you
+ * rows wait for a builder to connect or start (no worker registered or none online). */
 export type WorkIndexPage = {
     items: WorkIndexItem[];
     totals: WorkIndexCounts;
     groups: WorkIndexGroupCounts;
+    asks: Record<WorkAskGroup, number>;
+    completedSince: number;
+    builderWaits: number;
     projects: WorkProjectCounts[];
     nextCursor: string | null;
     limit: number;

package/dist/work-index.js

@@ -21,11 +21,14 @@ import { withFollowUps } from './result-follow-ups.js';
 import { LANDED_ACTOR, landedReasonOf } from './result-completion.js';
 import { ASKS, CODE_READING, STORAGE_HOLD_PREFIX, NEED_ASK, NEEDS, askChipOf, failedAttemptSentence, isWaitCode, processNeedOf, resultHoldUpSentence } from './needs-you.js';
 import { retryWhenWords } from './dispatch.js';
+import { releaseTaskOf } from './release-approval.js';
 import { LEAD_CLAIM_SQL, LEAD_IDLE_MS } from './lead-voice.js';
+export const WORK_ASK_GROUPS = ['release', 'approve', 'answer', 'wrong', 'review', 'other'];
 export const WORK_INDEX_PAGE_LIMIT = 40;
 export const WORK_INDEX_MAX_LIMIT = 100;
 const EMPTY = { all: 0, 'needs-you': 0, ready: 0, running: 0, queued: 0, completed: 0, archived: 0 };
 const NO_GROUPS = { decide: 0, review: 0, unblock: 0, building: 0, rest: 0 };
+const NO_ASKS = { release: 0, approve: 0, answer: 0, wrong: 0, review: 0, other: 0 };
 const FAMILY_PROBLEM = 'Task history is unavailable or incomplete. This task is shown separately.';
 const VIEWS = ['all', 'needs-you', 'ready', 'running', 'queued', 'completed', 'archived'];
 /** The family's current version is put away (v145): it waits on nobody and only the Archived view lists it. */
@@ -70,6 +73,11 @@ export function askOfCode(code, custody = false) {
 const codesOf = (ask) => PERSON_CODES.filter(code => askOfCode(code) === ask).map(code => `'${code}'`).join(',');
 /** The ask as its place in the list (ASKS order), read by the same code the row's status reads. */
 const ASK_RANK = `CASE WHEN code IN (${codesOf('decide')}) THEN 0 WHEN code IN (${codesOf('review')}) AND NOT custody_unresolved THEN 1 ELSE 2 END`;
+/** Home's ask group of a row, by its code alone, so a row's group and its group's count are one rule: a plan waiting
+ * for its yes, a question, a build that failed or stopped unexpectedly, a saved result to review (ASK_RANK's Review),
+ * and everything else that waits on a person. Read on Needs you rows only. */
+const ASK_GROUP_SQL = `CASE WHEN code='needs-approval' AND c.id IN (SELECT value FROM json_each($releaseTasks)) THEN 'release' WHEN code='needs-approval' THEN 'approve' WHEN code IN ('waiting-decision','decision-queue') THEN 'answer'
+      WHEN code IN ('failed','waiting-incident','vanished-run') THEN 'wrong' WHEN code IN (${codesOf('review')}) AND NOT custody_unresolved THEN 'review' ELSE 'other' END`;
 /** Where a row sits in the list: Decide, Review, Unblock, then building, then the rest by recency. */
 const ORDER = `(CASE WHEN rank=0 THEN ask_rank WHEN rank=1 THEN 3 ELSE 4 END)`;
 /** A row whose build may still be running (the store's reading, custodyReadings): Waiting, not Needs you. */
@@ -261,7 +269,7 @@ const PROJECTION = `WITH RECURSIVE admitted AS MATERIALIZED (
     ${ARCHIVED} archived,
     CASE WHEN code='complete' THEN 3 WHEN code='cancelled' THEN 4 WHEN code='running' THEN 1
       WHEN ${CUSTODY_WAITS} OR code IN (${WAITING_SQL.replace(/'(?:cancelled|complete|running)',/g, '')}) THEN 2 ELSE 0 END rank,
-    ${ASK_RANK} ask_rank,
+    ${ASK_RANK} ask_rank,${ASK_GROUP_SQL} ask_group,
     CASE WHEN code='complete' THEN completed.at ELSE family_updated END sort_at,
     completed.actor checked_actor,completed.at checked_at,completed.outcome checked_digest,completed.detail checked_detail
   FROM claimed c LEFT JOIN action_ledger completed ON completed.id=c.checked_id WHERE ($state IS NULL OR c.state=$state) AND ($leadId IS NULL OR EXISTS(SELECT 1 FROM team_task_owner own WHERE own.task_ref=c.root_ref AND own.lead=$leadId))
@@ -341,9 +349,17 @@ function custodyReadings(store) {
     }
     return { readings, workspace: new Set(noted) };
 }
-function parameters(now, access, options, custody) {
+/** The list can't read a release's sealed state in SQL: each queued task (the only state a plan waiting for a yes is in)
+ * whose scope carries a release form, kept only where release-approval.ts releaseTaskOf names it a release, the one
+ * rule the release sheet reads (never a title or a task id). */
+function releaseTaskIds(store) {
+    const sealed = store.handle.prepare(`SELECT s.task_id FROM task_scope s JOIN task t ON t.id=s.task_id
+    WHERE t.state='queued' AND (s.release_terms_json IS NOT NULL OR s.release_check_json IS NOT NULL)`).all().map(row => String(row['task_id']));
+    return JSON.stringify(sealed.filter(taskId => releaseTaskOf(store, taskId) !== null));
+}
+function parameters(store, now, access, options, custody) {
     const ids = (keep) => JSON.stringify([...custody.readings].filter(([ref, fact]) => keep(ref, fact)).map(([ref]) => ref));
-    return { $settledCustody: ids((_, fact) => fact === null), $waitingCustody: ids((_, fact) => fact !== null && 'wait' in (processNeedOf(fact) ?? {})),
+    return { $releaseTasks: releaseTaskIds(store), $settledCustody: ids((_, fact) => fact === null), $waitingCustody: ids((_, fact) => fact !== null && 'wait' in (processNeedOf(fact) ?? {})),
         $workspaceCustody: ids((ref, fact) => fact !== null && custody.workspace.has(ref)),
         $now: now.toISOString(), $alive: new Date(now.getTime() - 180_000).toISOString(),
         $all: access.repos === null ? 1 : 0, $repos: JSON.stringify(access.repos ?? []),
@@ -364,6 +380,13 @@ const TOTALS = `COALESCE(SUM(archived=0),0) all_count,COALESCE(SUM(needs),0) nee
     + `COALESCE(SUM(${QUEUED}),0) queued_count,COALESCE(SUM(code='complete' AND archived=0),0) completed_count,COALESCE(SUM(archived),0) archived_count`;
 const GROUP_TOTALS = `COALESCE(SUM(rank=0 AND ask_rank=0 AND archived=0),0) decide_count,COALESCE(SUM(rank=0 AND ask_rank=1 AND archived=0),0) review_count,COALESCE(SUM(rank=0 AND ask_rank=2 AND archived=0),0) unblock_count,`
     + `COALESCE(SUM(rank=1 AND archived=0),0) building_count,COALESCE(SUM(rank>1 AND archived=0),0) rest_count`;
+/** The exact Needs you totals per ask group, and what was completed since the page's `completedSince`: page reads only. */
+const ASK_TOTALS = WORK_ASK_GROUPS.map(group => `COALESCE(SUM(needs AND ask_group='${group}'),0) ask_${group}_count`).join(',')
+    + `,COALESCE(SUM(code='complete' AND archived=0 AND $completedSince IS NOT NULL AND sort_at>=$completedSince),0) completed_since_count`
+    + `,COALESCE(SUM(needs AND code IN ('no-worker-registered','no-worker-online')),0) builder_wait_count`;
+function askCounts(row) {
+    return Object.fromEntries(WORK_ASK_GROUPS.map(group => [group, n(row, `ask_${group}_count`)]));
+}
 function groupCounts(row) {
     return { decide: n(row, 'decide_count'), review: n(row, 'review_count'), unblock: n(row, 'unblock_count'), building: n(row, 'building_count'), rest: n(row, 'rest_count') };
 }
@@ -374,7 +397,8 @@ function cursorScope(access, options, view) {
     return createHash('sha256').update(JSON.stringify({ principal: access.principal,
         repos: access.repos === null ? null : [...new Set(access.repos)].sort(),
         unplaced: access.principal === 'operator' && access.includeUnplaced === true,
-        leadId: options.leadId ?? null, project: options.project ?? null, state: options.state ?? null, view })).digest('hex');
+        leadId: options.leadId ?? null, project: options.project ?? null, state: options.state ?? null, view,
+        ...(options.completedSince === undefined ? {} : { completedSince: options.completedSince }) })).digest('hex');
 }
 function readCursor(value, scope) {
     if (value == null)
@@ -413,18 +437,18 @@ function readWorkIndexPage(store, now, access, options, taskId = null) {
     const view = VIEWS.includes(options.view ?? 'all') ? options.view ?? 'all' : 'all';
     const limit = Number.isFinite(options.limit) ? Math.max(1, Math.min(WORK_INDEX_MAX_LIMIT, Math.floor(options.limit))) : WORK_INDEX_PAGE_LIMIT;
     const scope = cursorScope(access, options, view), cursor = readCursor(options.cursor, scope);
-    const filter = view === 'archived' ? 'archived=1' : view === 'needs-you' ? 'needs=1' : view === 'ready' ? READY : view === 'running' ? 'family_running=1 AND archived=0' : view === 'queued' ? QUEUED : view === 'completed' ? "code='complete' AND archived=0" : 'archived=0';
+    const filter = view === 'archived' ? 'archived=1' : view === 'needs-you' ? 'needs=1' : view === 'ready' ? READY : view === 'running' ? 'family_running=1 AND archived=0' : view === 'queued' ? QUEUED : view === 'completed' ? "code='complete' AND archived=0 AND ($completedSince IS NULL OR sort_at>=$completedSince)" : 'archived=0';
     const rows = prepared(store, `${projection}, selected_page AS MATERIALIZED (
     SELECT * FROM ranked WHERE ($taskId IS NOT NULL OR ${filter}) AND ($taskId IS NULL OR root_ref IN (SELECT root_ref FROM members WHERE id=$taskId)) AND ($roots IS NULL OR root_id IN (SELECT value FROM json_each($roots))) AND ($cursorRoot=0 OR
       ${ORDER}>$cursorRank OR (${ORDER}=$cursorRank AND (sort_at<$cursorAt OR (sort_at=$cursorAt AND root_ref<$cursorRoot))))
     ORDER BY ${ORDER},sort_at DESC,root_ref DESC LIMIT $limit
-  ), page AS (SELECT p.*,COALESCE(p.result_id,(SELECT id FROM run WHERE task_ref=p.ref_id AND finished_at IS NOT NULL AND role IN ('builder','scout') ORDER BY id DESC LIMIT 1)) page_result_id FROM selected_page p), totals AS (SELECT ${TOTALS},${GROUP_TOTALS} FROM ranked), project_totals AS (
+  ), page AS (SELECT p.*,COALESCE(p.result_id,(SELECT id FROM run WHERE task_ref=p.ref_id AND finished_at IS NOT NULL AND role IN ('builder','scout') ORDER BY id DESC LIMIT 1)) page_result_id FROM selected_page p), totals AS (SELECT ${TOTALS},${GROUP_TOTALS},${ASK_TOTALS} FROM ranked), project_totals AS (
     SELECT repo,${TOTALS},SUM(state='queued' AND family_running=0 AND archived=0) queued,
       SUM(state='done' AND family_running=0 AND archived=0 AND updated_at>=$recent) done_recently FROM ranked GROUP BY repo
   )
   SELECT 0 record_kind,totals.*,(SELECT json_group_array(json_object('repo',repo,'all_count',all_count,'needs_count',needs_count,'ready_count',ready_count,
     'running_count',running_count,'queued_count',queued_count,'completed_count',completed_count,'archived_count',archived_count,'queued',queued,'done_recently',done_recently)) FROM project_totals) row_json FROM totals
-  UNION ALL SELECT 1,0,0,0,0,0,0,0,0,0,0,0,0,json_object('archived',archived,'archived_by',(SELECT by FROM task_archive WHERE task_ref=page.ref_id),
+  UNION ALL SELECT 1,0,0,0,0,0,0,0,0,0,0,0,0,${WORK_ASK_GROUPS.map(() => '0,').join('')}0,0,json_object('archived',archived,'archived_by',(SELECT by FROM task_archive WHERE task_ref=page.ref_id),
     'archived_kind',(SELECT by_kind FROM task_archive WHERE task_ref=page.ref_id),'archived_reason',(SELECT reason FROM task_archive WHERE task_ref=page.ref_id),
     'archived_at',(SELECT at FROM task_archive WHERE task_ref=page.ref_id),'root_ref',root_ref,'root_id',root_id,'id',id,'root_title',root_title,'repo',repo,
     'state',state,'created_at',created_at,'family_updated',family_updated,'version_count',version_count,'earlier_active',earlier_active,
@@ -436,7 +460,7 @@ function readWorkIndexPage(store, now, access, options, taskId = null) {
     'check_follows',(SELECT json_group_array(q.outcome||' '||COALESCE((SELECT substr(f.outcome,instr(f.outcome,':')+1) FROM action_ledger f WHERE f.repo IS page.repo AND f.run_id=page_result_id
       AND f.action='checks finished' AND f.outcome LIKE q.id||':%' LIMIT 1),'open')) FROM (SELECT id,outcome FROM action_ledger WHERE repo IS page.repo AND run_id=page_result_id AND action='checks requested' ORDER BY id) q),
     'proof_verdict',(SELECT COALESCE(machine_verdict,verdict) FROM proof_verdict WHERE run=page_result_id),
-    'proof_failed_check',(SELECT verdict='refuted' AND reasons_json LIKE '%approved verification command exited%' FROM proof_verdict WHERE run=page_result_id),'code',code,'needs',needs,'person_need',person_need,'lead_claim',lead_claim,'family_running',family_running,'rank',rank,'ask_rank',ask_rank,'list_order',${ORDER},'sort_at',sort_at,
+    'proof_failed_check',(SELECT verdict='refuted' AND reasons_json LIKE '%approved verification command exited%' FROM proof_verdict WHERE run=page_result_id),'code',code,'ask_group',ask_group,'needs',needs,'person_need',person_need,'lead_claim',lead_claim,'family_running',family_running,'rank',rank,'ask_rank',ask_rank,'list_order',${ORDER},'sort_at',sort_at,
     'checked_actor',checked_actor,'checked_at',checked_at,'checked_digest',checked_digest,'checked_detail',checked_detail,'question_id',question_id,
     'dependency_id',dependency_id,'dependency_state',dependency_state,'hold_until',hold_until,'attempt_run',(SELECT id FROM run WHERE task_ref IN (SELECT ref_id FROM members WHERE root_ref=page.root_ref) AND (finished_at IS NOT NULL OR outcome IS NOT NULL) AND role NOT IN ('planner','reviewer') ORDER BY id DESC LIMIT 1),'custody_unresolved',custody_unresolved,'hold_kind',hold_kind,'hold_reason',substr(hold_reason,1,600),'hold_id',hold_id,'live_lease',live_lease IS NOT NULL,'approved',COALESCE(approved,0),
     'plan_changed',scope_digest IS NOT NULL AND digest IS NOT scope_digest,'head_ok',length(head_revision)=40 AND head_revision NOT GLOB '*[^a-f0-9]*','stop_run',stop_run,'unfinished',unfinished,'signed_out',signed_out,
@@ -444,7 +468,7 @@ function readWorkIndexPage(store, now, access, options, taskId = null) {
     'agent_ask_run',(SELECT run FROM agent_question WHERE id=page.agent_ask),'agent_ask_text',(SELECT substr(question,1,300) FROM agent_question WHERE id=page.agent_ask),'replaced_by',(SELECT successor FROM task_replacement WHERE task_ref=page.ref_id),
     'completed_by_lead',(SELECT lead FROM task_act WHERE task_ref=page.root_ref AND act='completed' ORDER BY id DESC LIMIT 1),'machine_check',COALESCE(machine_check,0),
     'question_task',(SELECT r.external_id FROM decision d JOIN run ON run.id=d.run JOIN task_ref r ON r.id=run.task_ref WHERE d.id=page.question_id)) FROM page`)
-        .all({ ...parameters(now, access, options, custody), $taskId: taskId, $roots: options.roots === undefined ? null : JSON.stringify(options.roots), $cursorRoot: cursor?.root ?? 0, $cursorRank: cursor?.rank ?? 0, $cursorAt: cursor?.at ?? '', $limit: limit + 1, $recent: new Date(now.getTime() - 86_400_000).toISOString() });
+        .all({ ...parameters(store, now, access, options, custody), $taskId: taskId, $roots: options.roots === undefined ? null : JSON.stringify(options.roots), $cursorRoot: cursor?.root ?? 0, $cursorRank: cursor?.rank ?? 0, $cursorAt: cursor?.at ?? '', $limit: limit + 1, $completedSince: options.completedSince ?? null, $recent: new Date(now.getTime() - 86_400_000).toISOString() });
     const selected = rows.slice(1).map(row => JSON.parse(String(row['row_json'])));
     const page = selected.slice(0, limit), last = page.at(-1);
     const nextCursor = selected.length > limit && last !== undefined ? Buffer.from(JSON.stringify({ version: 2, scope,
@@ -462,13 +486,14 @@ function readWorkIndexPage(store, now, access, options, taskId = null) {
     const memo = new Map();
     const readiness = (row, checks) => resultReadinessFacts(store, now, options.root, row, checks, memo);
     return { items: page.map(row => itemOf(row, access.principal, probe, leadName, readiness, options.root !== undefined, now)), projects, totals: rows[0] === undefined ? { ...EMPTY } : counts(rows[0]),
-        groups: rows[0] === undefined ? { ...NO_GROUPS } : groupCounts(rows[0]), nextCursor, limit, view };
+        groups: rows[0] === undefined ? { ...NO_GROUPS } : groupCounts(rows[0]), asks: rows[0] === undefined ? { ...NO_ASKS } : askCounts(rows[0]),
+        completedSince: rows[0] === undefined ? 0 : n(rows[0], 'completed_since_count'), builderWaits: rows[0] === undefined ? 0 : n(rows[0], 'builder_wait_count'), nextCursor, limit, view };
 }
 export function workCountsByProject(store, now, access) {
     const projection = registerValidators(store);
     return store.handle.prepare(`${projection} SELECT repo,${TOTALS},SUM(state='queued' AND family_running=0 AND archived=0) queued,
     SUM(state='done' AND family_running=0 AND archived=0 AND updated_at>=$recent) done_recently FROM ranked GROUP BY repo ORDER BY repo`)
-        .all({ ...parameters(now, access, {}, custodyReadings(store)), $recent: new Date(now.getTime() - 86_400_000).toISOString() })
+        .all({ ...parameters(store, now, access, {}, custodyReadings(store)), $recent: new Date(now.getTime() - 86_400_000).toISOString() })
         .map(row => ({ repo: s(row, 'repo'), totals: counts(row), queued: n(row, 'queued'), doneRecently: n(row, 'done_recently') }));
 }
 export function workStateRows(store, now, access) {
@@ -480,7 +505,7 @@ export function workStateRows(store, now, access) {
         COALESCE((SELECT held_at FROM hold WHERE id=hold_id),''),COALESCE((SELECT requested_at FROM run_stop WHERE run=stop_run),'')),''),sort_at) ask_at,
       COALESCE(live_run,(SELECT run FROM decision WHERE id=question_id),(SELECT run FROM agent_question WHERE id=agent_ask)) ask_run,
       (SELECT json_group_array(m.ref_id) FROM members m WHERE m.root_ref=ranked.root_ref) members FROM ranked WHERE archived=0`)
-        .all(parameters(now, access, {}, custodyReadings(store)))
+        .all(parameters(store, now, access, {}, custodyReadings(store)))
         .map(row => ({ repo: s(row, 'repo'), rootId: String(row['root_id']), code: String(row['code']), needs: n(row, 'needs') === 1, personNeed: n(row, 'person_need') === 1,
         leadClaim: n(row, 'lead_claim') === 1, liveRun: row['live_run'] == null ? null : n(row, 'live_run'), unfinished: row['unfinished'] == null ? null : n(row, 'unfinished'),
         resultRun: row['result_id'] == null ? null : n(row, 'result_id'), waits: Number(row['rank']) === 2, version: String(row['version']), at: String(row['ask_at'] ?? ''), askRun: row['ask_run'] == null ? null : n(row, 'ask_run'), members: JSON.parse(String(row['members'] ?? '[]')).map(Number) }));
@@ -515,7 +540,7 @@ export function workOutcomeRows(store, now, access, project, since, limit) {
     (SELECT status FROM run_check WHERE run=f.result_id) check_status,
     COALESCE(a.runs,0) runs,COALESCE(a.api_runs,0) api_runs,a.api_microusd,COALESCE(a.subscription_runs,0) subscription_runs,a.subscription_usd
     FROM selected f LEFT JOIN attempts a ON a.root_ref=f.root_ref ORDER BY f.sort_at DESC,f.root_ref DESC`)
-        .all({ ...parameters(now, access, { project }, custodyReadings(store)), $since: since, $outcomeLimit: limit + 1 });
+        .all({ ...parameters(store, now, access, { project }, custodyReadings(store)), $since: since, $outcomeLimit: limit + 1 });
 }
 /** Families whose headline is Ready for review, newest first: the Tasks
  * list's own rows, so a completed family (root or any revision), a failed
@@ -757,6 +782,7 @@ function itemOf(row, principal, probe, leadName, readiness, readable = false, no
         status: { token: `assignment-${assignmentState}`, label, detail, tone: workToneOf(shared.headline),
             action: primaryAction === null ? null : { label: actionLabel, kind: actionCode === 'open-result' ? 'open-result' : 'open-task' }, views, rank: n(row, 'rank') },
         ask: need ? ASKS[n(row, 'ask_rank')] ?? 'unblock' : null,
+        askGroup: need ? WORK_ASK_GROUPS.find(group => group === s(row, 'ask_group')) ?? 'other' : null,
         chip: need ? askChipOf({ headline: shared.headline, need: shared.need?.key ?? null, planChanged, mismatch: verdict === 'refuted' && n(row, 'proof_failed_check') !== 1, ask: ASKS[n(row, 'ask_rank')] ?? 'unblock' }) : null,
         primaryAction, completion: code === 'complete' ? { actor: String(row['checked_actor']), at: String(row['checked_at']), digest: String(row['checked_digest']), ...(landed === null ? {} : { landed }) } : null,
         evidence: 'recorded', ...(lead === 'on-it' ? { lead: leadOnIt(leadName) } : {}), ...(archived === null ? {} : { archived }) };
@@ -767,7 +793,7 @@ export function workTidyRows(store, now, access) {
       (family_running OR live_lease IS NOT NULL OR unfinished IS NOT NULL OR custody_unresolved OR stop_run IS NOT NULL AND stop_settled IS NULL OR state='running') live,
       (SELECT json_group_array(m.ref_id) FROM members m WHERE m.root_ref=ranked.root_ref) members,
       (SELECT json_group_array(m.id) FROM members m WHERE m.root_ref=ranked.root_ref) member_ids FROM ranked`)
-        .all(parameters(now, access, {}, custodyReadings(store)))
+        .all(parameters(store, now, access, {}, custodyReadings(store)))
         .map(row => ({ rootId: String(row['root_id']), currentId: String(row['id']), title: String(row['root_title']), repo: s(row, 'repo'),
         state: String(row['state']), code: String(row['code']), live: n(row, 'live') === 1, archived: n(row, 'archived') === 1, broken: n(row, 'broken') === 1,
         updatedAt: String(row['family_updated'] ?? ''), members: JSON.parse(String(row['members'] ?? '[]')).map(Number),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolroll",
-  "version": "0.9.101",
+  "version": "0.9.103",
   "description": "A control plane for unattended coding agents — queue tasks, walk away, come back to pull requests. Agents build in leased worktrees, never touch your default branch, and interrupt you only for decisions that need a human.",
   "directories": {
     "doc": "docs"