toolroll 0.9.100 → 0.9.102

package/dist/work-index.js

@@ -22,10 +22,12 @@ 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 { LEAD_CLAIM_SQL, LEAD_IDLE_MS } from './lead-voice.js';
+export const WORK_ASK_GROUPS = ['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 = { 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 +72,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' 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 +268,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))
@@ -364,6 +371,12 @@ 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`;
+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 +387,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 +427,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,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 +450,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 +458,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(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,7 +476,8 @@ 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'), nextCursor, limit, view };
 }
 export function workCountsByProject(store, now, access) {
     const projection = registerValidators(store);
@@ -757,6 +772,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 }) };

package/dist/workspace-ui.d.ts

@@ -314,3 +314,72 @@ export type BuildProgress = {
 export declare function buildProgressOf(steps: readonly BuildStep[] | null | undefined): BuildProgress | null;
 /** Earlier attempts that stopped before the one now running, in one quiet line. */
 export declare function earlierAttemptsWords(count: number): string;
+/** One row of a task page's steps (docs/plans/task-page-steps.md): the step's label, how its marker reads, one plain
+ * sentence and a time, whether it has something to open, and whether it starts open. `mark`: done (an ink disc with
+ * a check), needs (waits on this person: ink), live (something runs now: blue), wait (current, waiting on nothing
+ * this person does), stuck (stopped there: vermilion), skipped (a dashed ring), todo (not reached: grey). */
+export type StepRow = {
+    key: "plan" | "approve" | "build" | "checks" | "ready";
+    label: string;
+    state: "done" | "current" | "stuck" | "skipped" | "todo";
+    mark: "done" | "needs" | "live" | "wait" | "stuck" | "skipped" | "todo";
+    sentence: string;
+    /** When the step happened (ISO), shown as a clock time; null when nothing recorded says. */
+    at: string | null;
+    needsYou: boolean;
+    /** It holds something to read or do: a finished row opens on press, the current one is open. */
+    opens: boolean;
+    open: boolean;
+};
+/** What `stepRowsOf` reads: facts the task page's view already carries. */
+export type StepRowFacts = {
+    journey?: readonly {
+        key: StepRow["key"];
+        label: string;
+        state: StepRow["state"];
+        needsYou?: true;
+        say?: string;
+    }[] | null;
+    scout: boolean;
+    status: {
+        status: {
+            headline: string;
+        };
+        attempts: readonly unknown[];
+    } | null;
+    /** Builds that stopped before this one: with more than one version, the Build row's history. */
+    earlier?: {
+        attempts: readonly unknown[];
+    } | null;
+    approved?: {
+        by: string;
+        at: string;
+        automatic: boolean;
+        rule: string | null;
+    } | null;
+    approve?: {
+        heading: string;
+    } | null;
+    approval?: string;
+    progress?: {
+        line: string;
+    } | null;
+    plan?: {
+        lead: string | null;
+        by: string | null;
+        at: string | null;
+        planning: boolean;
+        updating?: boolean;
+    } | null;
+    result?: {
+        selected: unknown;
+    } | null;
+    thread?: readonly {
+        kind: string;
+        at: string;
+    }[];
+    release?: unknown;
+};
+/** The task page's rows, from its road (first-run.ts taskRoad) and the facts beside it. Null when the task has no road
+ * (cancelled, or no status): the page keeps its status block then. Pure: no clock, no store. */
+export declare function stepRowsOf(view: StepRowFacts): StepRow[] | null;

package/dist/workspace-ui.js

@@ -624,3 +624,106 @@ export function buildProgressOf(steps) {
 export function earlierAttemptsWords(count) {
     return `${count} earlier attempt${count === 1 ? "" : "s"} stopped`;
 }
+/** The task page's rows, from its road (first-run.ts taskRoad) and the facts beside it. Null when the task has no road
+ * (cancelled, or no status): the page keeps its status block then. Pure: no clock, no store. */
+export function stepRowsOf(view) {
+    const road = view.journey ?? null;
+    if (road === null || road.length === 0)
+        return null;
+    const headline = view.status?.status.headline ?? null;
+    const runs = headline === "Planning" || headline === "Building";
+    const approvalOpen = view.approve != null || road.some(step => step.key === "approve" && step.state === "current");
+    const hasResult = view.result != null;
+    // Earlier versions or stopped builds: the Build row holds them, and opens for them before the next build starts.
+    const hasHistory = (view.status?.attempts.length ?? 0) > 1 || (view.earlier?.attempts.length ?? 0) > 0;
+    const lastResult = [...(view.thread ?? [])].filter(one => one.kind === "result").map(one => one.at).sort().at(-1) ?? null;
+    const checksStuck = road.some(step => step.key === "checks" && step.state === "stuck");
+    // A step stopped there, in a word (its box under it says why).
+    const stoppedWord = headline === "Failed" ? "Failed" : headline === "Stopped" ? "Stopped" : headline === "Waiting" || headline === "Queued" ? "Waiting" : "Stopped here";
+    const words = (step) => {
+        const here = step.state === "current" || step.state === "stuck";
+        switch (step.key) {
+            case "plan":
+                if (step.state === "done" || step.state === "skipped") {
+                    const by = view.plan?.by ?? null;
+                    if (approvalOpen)
+                        return { sentence: by === null ? "Shown below" : `Written by ${by} · shown below`, at: view.plan?.at ?? null };
+                    return { sentence: view.plan?.lead ?? (by === null ? "Plan written" : `Written by ${by}`), at: view.plan?.at ?? null };
+                }
+                // Stopped at Plan with a plan already written (a held task whose plan waits for approval): it says it stopped, never "No plan yet".
+                if (here)
+                    return { sentence: view.plan?.updating === true ? "Updating the plan" : view.plan?.planning === true || headline === "Planning" ? "Writing the plan" : step.needsYou ? ""
+                            : step.state === "stuck" && view.approve != null ? stoppedWord : "No plan yet", at: null };
+                return { sentence: "A plan for you to approve", at: null };
+            case "approve":
+                if (step.state === "done") {
+                    const by = view.approved ?? null;
+                    return { sentence: by === null ? "Approved" : by.automatic ? "Approved automatically" : `Approved by ${by.by}`, at: by?.at ?? null };
+                }
+                if (step.state === "skipped")
+                    return { sentence: "No approval was asked for", at: null };
+                if (here)
+                    return { sentence: step.needsYou ? "" : "Waiting for approval", at: null };
+                return { sentence: view.scout ? "You approve before it starts" : "You approve before anything is built", at: null };
+            case "build":
+                if (step.state === "done")
+                    return { sentence: view.scout ? "The investigation finished" : "The build finished", at: lastResult };
+                if (step.state === "skipped")
+                    return { sentence: "Didn't run", at: null };
+                // The open row's box says the rest: its head says only how the step stands.
+                if (here)
+                    return { sentence: step.needsYou ? "" : runs ? "Working now" : step.state === "stuck" ? stoppedWord : "Waiting to start", at: null };
+                return { sentence: `${approvalOpen ? "Starts when you approve" : "Starts after approval"}${hasHistory ? ". Earlier attempts are here." : ""}`, at: null };
+            case "checks": {
+                const said = step.say ?? null;
+                if (step.state === "done")
+                    return { sentence: "Project checks passed", at: null };
+                if (step.state === "skipped")
+                    return { sentence: said === "Checks not run" ? "The checks didn't run" : said === "Checks at release" ? "Checked at release" : "No checks were recorded", at: null };
+                if (step.state === "stuck")
+                    return { sentence: step.needsYou && said === null ? "" : said === "Checks unreadable" ? "The checks couldn't be read" : said === "Checks failed" ? "The checks failed" : stoppedWord, at: null };
+                if (step.state === "current")
+                    return { sentence: said === "Checks running" ? "The checks are running" : step.needsYou ? "" : "Waiting for the checks", at: null };
+                return { sentence: "The project's checks run on the result", at: null };
+            }
+            case "ready":
+                if (step.state === "done")
+                    return { sentence: headline === "Complete" ? "Finished" : view.scout ? "Report ready" : "Ready", at: lastResult };
+                if (here)
+                    return { sentence: step.needsYou ? "" : step.state === "stuck" ? stoppedWord : "Waiting", at: null };
+                if (hasResult)
+                    return { sentence: checksStuck ? "Not ready: the checks didn't pass. The result is here." : "Not ready yet. The result so far is here.", at: null };
+                return { sentence: view.scout ? "A report for you to read" : "A result for you to review", at: null };
+        }
+    };
+    const rows = road.map((step) => {
+        const said = words(step);
+        const here = step.state === "current" || step.state === "stuck";
+        const needsYou = step.needsYou === true && here;
+        const mark = step.state === "done" ? "done" : step.state === "skipped" ? "skipped" : step.state === "todo" ? "todo"
+            // Vermilion only for a failure: a stopped or held step waits, in grey.
+            : needsYou ? "needs" : step.state === "stuck" ? (headline === "Failed" || step.say === "Checks failed" || step.say === "Checks unreadable" ? "stuck" : "wait")
+                : runs || step.say === "Checks running" ? "live" : "wait";
+        // A step not reached opens only when it holds something already there: a result before Ready was reached, or
+        // earlier attempts before the next build starts.
+        // An approval this person can give is always on the page, open, wherever the road stands (a held task stops at
+        // Plan with its plan still waiting for a yes): the Approval row holds its form.
+        const approvalHere = step.key === "approve" && view.approve != null;
+        const opens = step.state !== "todo" || (step.key === "ready" && hasResult) || (step.key === "build" && hasHistory) || approvalHere;
+        return { key: step.key, label: step.label, state: step.state, mark, sentence: said.sentence, at: said.at, needsYou, opens, open: here || approvalHere };
+    });
+    // A finished road whose task still waits on this person (a result to review): the last step it reached is theirs.
+    const waitsOnViewer = headline === "Ready for review" || headline === "Needs you";
+    if (waitsOnViewer && !rows.some(row => row.state === "current" || row.state === "stuck")) {
+        const last = [...rows].reverse().find(row => row.state === "done");
+        if (last !== undefined)
+            Object.assign(last, { state: "current", mark: "needs", needsYou: true, sentence: "", at: null, open: true, opens: true });
+    }
+    // Nothing happening (a finished task): the last step it reached is the one open.
+    if (!rows.some(row => row.open)) {
+        const last = [...rows].reverse().find(row => row.opens && row.state !== "todo");
+        if (last !== undefined)
+            last.open = true;
+    }
+    return rows;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolroll",
-  "version": "0.9.100",
+  "version": "0.9.102",
   "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"