@repo-os/repoos 0.5.77 → 0.5.78

package/dist/.build-info.json

@@ -1,5 +1,5 @@
 {
-  "hash": "00d00bc38a262d4e2656d0b83e58441ebf83f85bb8a15fb25355d96683336177",
-  "version": "0.5.77",
+  "hash": "38040072cfd2b545bf2a27d69bffb1b2a29dede01df01ee2dd8cde7388833fa9",
+  "version": "0.5.78",
   "devUi": false
 }

package/dist/.build-stamp.json

@@ -1,3 +1,3 @@
 {
-  "generatedAt": "2026-11-06T06:24:32.457Z"
+  "generatedAt": "2026-11-08T14:57:15.392Z"
 }

package/dist/cli/api-route-parity.js

@@ -18,6 +18,8 @@ const CONTROL_API_MATCHERS = [
     re("POST", /^\/api\/tasks\/([^/]+)\/needs-input\/dismiss$/.source),
     re("POST", /^\/api\/tasks\/([^/]+)\/review\/again$/.source),
     re("GET", /^\/api\/tasks\/([^/]+)\/landable$/.source),
+    // `repoos summary <id>` generates or retries the post-merge summary (#1041).
+    re("POST", /^\/api\/tasks\/([^/]+)\/summary$/.source),
     // Non-blocking handoff outcome for `repoos handoff-status` (#1028).
     re("GET", /^\/api\/tasks\/([^/]+)\/handoff-status$/.source),
     re("POST", /^\/api\/tasks\/([^/]+)\/preview$/.source),
@@ -78,6 +80,7 @@ const UI_ONLY_MATCHERS = [
     // Task-card-only explicit cancellation of a stalled, registered local check.
     re("POST", /^\/api\/tasks\/([^/]+)\/cancel-check$/.source),
     // Read-only task engineering-report history used by the Dev tab.
+    re("GET", /^\/api\/tasks\/([^/]+)\/summary$/.source),
     re("GET", /^\/api\/tasks\/([^/]+)\/engineering-reports$/.source),
     re("GET", /^\/api\/tasks\/([^/]+)\/engineering-reports\/([^/]+)$/.source),
     under("/api/auth/"),

package/dist/cli/help.js

@@ -83,9 +83,9 @@ const GROUPS = [
             },
             {
                 name: "send-back",
-                usage: 'send-back <id> (--message "…" | --message-file <file|->) [--json] [--port N]',
+                usage: 'send-back <id> [text | - | --message "…" | --file <path> | --message-file <path>] [--json] [--port N]',
                 desc: "Return a task to the engineer, start work, then queue feedback",
-                flags: "--message · --message-file · --json · --port",
+                flags: "--message · --file · --message-file · --json · --port",
             },
             {
                 name: "start",
@@ -113,9 +113,9 @@ const GROUPS = [
             },
             {
                 name: "message",
-                usage: 'message <id> "<text>" [--now] [--json] [--port N]',
+                usage: 'message <id> [text | - | --message "…" | --file <path> | --message-file <path>] [--now] [--json] [--port N]',
                 desc: "Send a follow-up to the task agent; queues while busy, --now interrupts the turn and delivers immediately (POST /api/tasks/:id/message)",
-                flags: "--now · --json · --port",
+                flags: "--message · --file · --message-file · --now · --json · --port",
             },
             {
                 name: "review",
@@ -160,6 +160,12 @@ const GROUPS = [
                 desc: "Read-only checks before merging (verdict, lock, worktree, merge, scope, main) — exits non-zero when the task is not ready to merge (GET /api/tasks/:id/landable)",
                 flags: "--json · --port",
             },
+            {
+                name: "summary",
+                usage: "summary <id> [--json] [--port N]",
+                desc: "Generate or retry the post-merge PM summary report (POST /api/tasks/:id/summary)",
+                flags: "--json · --port",
+            },
             {
                 name: "handoff-status",
                 usage: "handoff-status <id> [--json] [--port N]",

package/dist/cli/index.js

@@ -27,7 +27,7 @@ import { cmdCertify } from "../commands/certify.js";
 import { cmdSupport } from "../commands/support.js";
 import { cmdService } from "../commands/service.js";
 import { cmdServers } from "../commands/servers.js";
-import { cmdAgentsRunning, cmdConfig, cmdDone, cmdLandable, cmdHandoffStatus, cmdMessage, cmdSendBack, cmdOverride, cmdPause, cmdPreview, cmdDev, cmdReview, cmdVerify, cmdRunners, cmdStart, cmdSync, cmdStats, cmdDecisions, cmdApi, cmdIntegration, cmdAttention, cmdHold, cmdUnhold, } from "../commands/control-api.js";
+import { cmdAgentsRunning, cmdConfig, cmdDone, cmdLandable, cmdHandoffStatus, cmdSummary, cmdMessage, cmdSendBack, cmdOverride, cmdPause, cmdPreview, cmdDev, cmdReview, cmdVerify, cmdRunners, cmdStart, cmdSync, cmdStats, cmdDecisions, cmdApi, cmdIntegration, cmdAttention, cmdHold, cmdUnhold, } from "../commands/control-api.js";
 import { cmdWatch } from "../commands/watch.js";
 import { cmdDriver } from "../commands/driver.js";
 import { cmdBundle } from "../commands/bundle.js";
@@ -333,6 +333,12 @@ function main() {
                     process.exitCode = code;
             });
             break;
+        case "summary":
+            void cmdSummary(rest).then((code) => {
+                if (code !== 0)
+                    process.exitCode = code;
+            });
+            break;
         case "override":
             void cmdOverride(rest).then((code) => {
                 if (code !== 0)

package/dist/commands/control-api.d.ts

@@ -1,11 +1,36 @@
 import { RepoOsApi, type ApiJson } from "../cli/repoos-api.js";
+interface CommonOpts {
+    json: boolean;
+    wait: boolean;
+    now: boolean;
+    port?: number;
+    /** `repoos hold`: free-text reason the task was parked (#0960). */
+    reason?: string;
+    /** `repoos hold`: ISO-8601 auto-release time (#0960). */
+    until?: string;
+    /** `repoos hold`: who placed the hold (#0960); defaults to "driver" server-side. */
+    by?: string;
+    /** `repoos unhold --start`: start the engineer after releasing the hold (#0960). */
+    start?: boolean;
+    /** `repoos start --force`: start even a held task (#0960). */
+    force?: boolean;
+}
 export declare function cmdStart(args: string[]): Promise<number>;
 export declare function cmdHold(args: string[]): Promise<number>;
 export declare function cmdUnhold(args: string[]): Promise<number>;
 export declare function cmdPause(args: string[]): Promise<number>;
-export declare function cmdMessage(args: string[]): Promise<number>;
+/** Parse message sources before contacting the server, preserving option values verbatim. */
+export declare function parseMessageInput(args: string[], stdin?: {
+    isTTY: boolean;
+    read: () => string;
+}): {
+    id: string;
+    text: string;
+    opts: CommonOpts;
+};
+export declare function cmdMessage(args: string[], stdin?: Parameters<typeof parseMessageInput>[1]): Promise<number>;
 /** `repoos send-back` — reopen, start the engineer, then deliver feedback. */
-export declare function cmdSendBack(args: string[]): Promise<number>;
+export declare function cmdSendBack(args: string[], stdin?: Parameters<typeof parseMessageInput>[1]): Promise<number>;
 export declare function cmdReviewAgain(args: string[]): Promise<number>;
 export declare function cmdReview(args: string[]): Promise<number>;
 type ReviewWaitApi = Pick<RepoOsApi, "requestOk">;
@@ -94,6 +119,44 @@ export declare function cmdHandoffStatus(args: string[]): Promise<number>;
  * exit 0 only when every check passes. Never edits, commits or moves status.
  */
 export declare function cmdLandable(args: string[]): Promise<number>;
+/** Shape of `GET /api/tasks/:id/summary` used by `repoos summary`. */
+export interface TaskSummaryState {
+    ok: boolean;
+    exists: boolean;
+    markdown: string | null;
+    status: "idle" | "pending" | "done" | "failed";
+    statusAt: string | null;
+    /** Anchor for this `pending` run (ISO); mirrors server payload. */
+    pendingSince: string | null;
+    reportMtimeMs: number | null;
+    error: string | null;
+}
+/**
+ * Terminal poll states: `done`/`failed`, a committed report while status is
+ * `idle` (lost write), or `pending` long enough that the server coerces to `done`
+ * (API returns `done` when stale; this mirrors that for older servers).
+ */
+export declare function isSummaryPollTerminal(state: Pick<TaskSummaryState, "status" | "exists" | "statusAt" | "pendingSince" | "reportMtimeMs">, expectedRunAt?: string | null): boolean;
+/**
+ * Poll a summary status fetcher until terminal. A committed report (`exists`)
+ * with non-`pending` status is terminal (including `idle` when the done-status
+ * write was lost). While `pending`, keep polling even when the file exists —
+ * a retry may still be running. Persistent fetch failures fail fast.
+ */
+export declare function pollSummaryState(getState: () => Promise<TaskSummaryState>, opts?: {
+    label?: string;
+    timeoutMs?: number;
+    intervalMs?: number;
+    maxConsecutiveErrors?: number;
+    expectedRunAt?: string | null;
+}): Promise<TaskSummaryState>;
+/**
+ * `repoos summary <id>` (#1041): queue the post-merge PM summary report and
+ * wait for its terminal state. Requires a released (`done`) task — the normal
+ * path runs it automatically after Move to done; this is the visible retry.
+ * Never touches the task status.
+ */
+export declare function cmdSummary(args: string[]): Promise<number>;
 /** Shared server-down check for tests. */
 export declare function controlApiServerDownMessage(port: number): Promise<string>;
 export {};

package/dist/commands/control-api.js

@@ -8,6 +8,7 @@ import { effectiveEngineerFromApi } from "../cli/effective-from-api.js";
 import { HANDOFF_DEADLINE_MS } from "../server/handoff.js";
 import { fmtDuration } from "./driver.js";
 import { agentModelAllowRows, pauseAllowlistEntry, resumeAllowlistEntry, pairPauseInfo, } from "../core/budget-allowlist.js";
+import { effectiveSummaryJobStatus } from "../core/task-summary.js";
 function parseCommonFlags(args) {
     const opts = { json: false, wait: false, now: false };
     const rest = [];
@@ -276,18 +277,88 @@ export async function cmdPause(args) {
         return 1;
     }
 }
-export async function cmdMessage(args) {
-    const { rest, opts, error } = parseCommonFlags(args);
-    if (error) {
-        printErr(error);
-        return 1;
+/** Parse message sources before contacting the server, preserving option values verbatim. */
+export function parseMessageInput(args, stdin = { isTTY: process.stdin.isTTY, read: () => readFileSync(0, "utf8") }) {
+    const opts = { json: false, wait: false, now: false };
+    let id;
+    let source;
+    let value = "";
+    const choose = (next, input) => {
+        if (source && !(source === "inline" && next === "inline"))
+            throw new Error("Use only one message input source");
+        value = source === "inline" ? `${value} ${input}` : input;
+        source = next;
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--json")
+            opts.json = true;
+        else if (arg === "--now")
+            opts.now = true;
+        else if (arg === "--port") {
+            const port = Number(args[++i]);
+            if (!Number.isInteger(port) || port <= 0)
+                throw new Error("--port requires a positive integer");
+            opts.port = port;
+        }
+        else if (arg === "--message" || arg === "--file" || arg === "--message-file") {
+            const input = args[++i];
+            if (input === undefined || input.startsWith("--"))
+                throw new Error(`${arg} requires a value`);
+            choose(arg === "--message" ? "message" : "file", input);
+        }
+        else if (arg.startsWith("--"))
+            throw new Error(`Unknown flag: ${arg}`);
+        else if (!id) {
+            if (arg === "-")
+                throw new Error("A task id is required before stdin");
+            id = arg;
+        }
+        else if (arg === "-")
+            choose("stdin", "-");
+        else
+            choose("inline", arg);
     }
-    const id = rest[0];
-    const text = rest.slice(1).join(" ").trim();
-    if (!id || !text) {
-        printErr('Usage: repoos message <id> "<text>" [--now] [--json] [--port N]');
+    if (!id)
+        throw new Error("A task id is required");
+    if (!source && !stdin.isTTY)
+        source = "stdin";
+    if (source === "stdin" || (source === "file" && value === "-")) {
+        if (stdin.isTTY)
+            throw new Error("No stdin provided; pipe a message or use a heredoc");
+        try {
+            value = stdin.read();
+        }
+        catch (e) {
+            throw new Error(`Could not read stdin: ${e.message}`);
+        }
+    }
+    else if (source === "file") {
+        try {
+            value = readFileSync(value, "utf8");
+        }
+        catch (e) {
+            throw new Error(`Could not read message file: ${e.message}`);
+        }
+    }
+    const text = value.trim();
+    if (!text)
+        throw new Error("Message cannot be empty or whitespace-only");
+    return { id, text, opts };
+}
+function messageSummary(text) {
+    return `${text.length} characters: ${text.split(/\r?\n/, 1)[0]}`;
+}
+export async function cmdMessage(args, stdin) {
+    let input;
+    try {
+        input = parseMessageInput(args, stdin);
+    }
+    catch (e) {
+        printErr(e.message);
         return 1;
     }
+    const { id, text, opts } = input;
     const api = new RepoOsApi({ port: opts.port });
     try {
         await ensureServer(api);
@@ -301,14 +372,14 @@ export async function cmdMessage(args) {
             const why = data.now
                 ? (data.reason ?? "agent still busy after the interrupt")
                 : "agent busy — delivers when the turn ends";
-            console.log(c.green("  ✓ ") + c.dim(`message queued to #${id} (${why})`));
+            console.log(c.green("  ✓ ") + c.dim(`message queued to #${id} (${why}) — ${messageSummary(text)}`));
         }
         else if (data?.deliveredNow) {
             const how = data.interrupted ? " (interrupted the running turn)" : " (agent was idle)";
-            console.log(c.green("  ✓ ") + c.dim(`message delivered now to #${id}${how}`));
+            console.log(c.green("  ✓ ") + c.dim(`message delivered now to #${id}${how} — ${messageSummary(text)}`));
         }
         else {
-            console.log(c.green("  ✓ ") + c.dim(`message sent to #${id}`));
+            console.log(c.green("  ✓ ") + c.dim(`message sent to #${id} — ${messageSummary(text)}`));
         }
         return 0;
     }
@@ -318,49 +389,20 @@ export async function cmdMessage(args) {
     }
 }
 /** `repoos send-back` — reopen, start the engineer, then deliver feedback. */
-export async function cmdSendBack(args) {
-    const { rest, opts, error } = parseCommonFlags(args);
-    if (error) {
-        printErr(error);
+export async function cmdSendBack(args, stdin) {
+    let input;
+    try {
+        input = parseMessageInput(args, stdin);
+    }
+    catch (e) {
+        printErr(e.message);
         return 1;
     }
+    const { id, text: message, opts } = input;
     if (opts.now) {
         printErr("repoos send-back does not support --now; feedback is queued after the engineer starts");
         return 1;
     }
-    let id;
-    let message;
-    let messageFile;
-    for (let i = 0; i < rest.length; i++) {
-        if (rest[i] === "--message")
-            message = rest[++i];
-        else if (rest[i] === "--message-file")
-            messageFile = rest[++i];
-        else if (!id)
-            id = rest[i];
-        else {
-            printErr(`Unexpected argument: ${rest[i]}`);
-            return 1;
-        }
-    }
-    if (message !== undefined && messageFile !== undefined) {
-        printErr("Use --message or --message-file, not both");
-        return 1;
-    }
-    if (messageFile !== undefined) {
-        try {
-            message = messageFile === "-" ? readFileSync(0, "utf8") : readFileSync(messageFile, "utf8");
-        }
-        catch (e) {
-            printErr(`Could not read message file: ${e.message}`);
-            return 1;
-        }
-    }
-    message = message?.trim();
-    if (!id || !message) {
-        printErr('Usage: repoos send-back <id> (--message "…" | --message-file <file|->) [--json] [--port N]');
-        return 1;
-    }
     const api = new RepoOsApi({ port: opts.port });
     try {
         await ensureServer(api);
@@ -370,7 +412,7 @@ export async function cmdSendBack(args) {
         else {
             console.log(c.green("  ✓ ") + c.dim(`moved #${id} to active`));
             console.log(c.green("  ✓ ") + c.dim(`started engineer on #${id}`));
-            console.log(c.green("  ✓ ") + c.dim(`queued message to #${id}`));
+            console.log(c.green("  ✓ ") + c.dim(`queued message to #${id} — ${messageSummary(message)}`));
         }
         return 0;
     }
@@ -1602,6 +1644,115 @@ export async function cmdLandable(args) {
         return 1;
     }
 }
+/**
+ * Terminal poll states: `done`/`failed`, a committed report while status is
+ * `idle` (lost write), or `pending` long enough that the server coerces to `done`
+ * (API returns `done` when stale; this mirrors that for older servers).
+ */
+export function isSummaryPollTerminal(state, expectedRunAt) {
+    if (state.status === "failed")
+        return true;
+    // A successful POST starts a specific run. Do not let an unchanged idle/done
+    // record and its previous report satisfy that run's poll.
+    if (expectedRunAt) {
+        const runAt = Date.parse(expectedRunAt);
+        if (!Number.isFinite(runAt))
+            return false;
+        if (state.status === "pending") {
+            const pendingAt = Date.parse(state.pendingSince ?? state.statusAt ?? "");
+            if (!Number.isFinite(pendingAt) || pendingAt < runAt)
+                return false;
+        }
+        else {
+            const stateAt = Date.parse(state.statusAt ?? "");
+            if (!Number.isFinite(stateAt) || stateAt < runAt)
+                return false;
+            if (state.exists && state.reportMtimeMs !== null && state.reportMtimeMs < runAt)
+                return false;
+        }
+    }
+    if (state.status === "done")
+        return true;
+    const eff = effectiveSummaryJobStatus(state.status, state.statusAt ?? "", state.exists, Date.now(), state.reportMtimeMs ?? null, state.pendingSince);
+    if (eff === "done")
+        return true;
+    if (state.exists && state.status !== "pending")
+        return true;
+    return false;
+}
+const SUMMARY_MAX_GET_ERRORS = 10;
+/**
+ * Poll a summary status fetcher until terminal. A committed report (`exists`)
+ * with non-`pending` status is terminal (including `idle` when the done-status
+ * write was lost). While `pending`, keep polling even when the file exists —
+ * a retry may still be running. Persistent fetch failures fail fast.
+ */
+export async function pollSummaryState(getState, opts = {}) {
+    const maxConsecutiveErrors = opts.maxConsecutiveErrors ?? SUMMARY_MAX_GET_ERRORS;
+    let consecutiveGetErrors = 0;
+    const label = opts.label ?? "summary";
+    return pollUntil(async () => {
+        let state;
+        try {
+            state = await getState();
+        }
+        catch (err) {
+            consecutiveGetErrors += 1;
+            if (consecutiveGetErrors >= maxConsecutiveErrors)
+                throw new RepoOsApiError(`summary status unreachable (${label}): ${err.message}`, 503);
+            return null;
+        }
+        consecutiveGetErrors = 0;
+        return isSummaryPollTerminal(state, opts.expectedRunAt) ? state : null;
+    }, { label, timeoutMs: opts.timeoutMs ?? 900_000, intervalMs: opts.intervalMs ?? 2_000 });
+}
+/**
+ * `repoos summary <id>` (#1041): queue the post-merge PM summary report and
+ * wait for its terminal state. Requires a released (`done`) task — the normal
+ * path runs it automatically after Move to done; this is the visible retry.
+ * Never touches the task status.
+ */
+export async function cmdSummary(args) {
+    const { rest, opts, error } = parseCommonFlags(args);
+    if (error) {
+        printErr(error);
+        return 1;
+    }
+    const id = rest[0];
+    if (!id) {
+        printErr("Usage: repoos summary <id> [--json] [--port N]");
+        return 1;
+    }
+    const api = new RepoOsApi({ port: opts.port });
+    try {
+        await ensureServer(api);
+        const queued = await api.request("POST", `/api/tasks/${id}/summary`, {});
+        if (queued.status === 404)
+            throw new RepoOsApiError(`Task #${id} not found`, 404, queued.body);
+        if (queued.status !== 202 || !queued.body.ok)
+            throw new RepoOsApiError(queued.body.error ?? `summary refused (${queued.status})`, queued.status, queued.body);
+        if (!opts.json)
+            console.log(c.dim(`  … generating post-merge summary for #${id}`));
+        const expectedRunAt = typeof queued.body.pendingSince === "string" ? queued.body.pendingSince : null;
+        const final = await pollSummaryState(async () => (await api.requestOk("GET", `/api/tasks/${id}/summary`)), { label: `summary for #${id}`, expectedRunAt });
+        const eff = effectiveSummaryJobStatus(final.status, final.statusAt ?? "", final.exists, Date.now(), final.reportMtimeMs ?? null, final.pendingSince);
+        const success = eff === "done" || (final.exists && eff !== "failed" && eff !== "pending");
+        if (opts.json) {
+            printJson(final);
+            return success ? 0 : 1;
+        }
+        if (success) {
+            console.log(c.green(`  ✓ #${id} summary ready: work/reports/${id}/summary.md`));
+            return 0;
+        }
+        printErr(final.error ?? `summary generation failed for #${id}`);
+        return 1;
+    }
+    catch (e) {
+        printErr(e.message);
+        return 1;
+    }
+}
 /** Shared server-down check for tests. */
 export async function controlApiServerDownMessage(port) {
     const { baseUrl } = resolveControlPlaneBase({ port });

package/dist/commands/message-input.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/message-input.test.js

@@ -0,0 +1,61 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { cmdMessage, cmdSendBack, parseMessageInput } from "./control-api.js";
+import { RepoOsApi } from "../cli/repoos-api.js";
+const dir = mkdtempSync(join(tmpdir(), "repoos-message-input-"));
+const file = join(dir, "brief.txt");
+writeFileSync(file, " first line\nsecond line \n");
+const piped = { isTTY: false, read: () => " first line\nsecond line \n" };
+const terminal = {
+    isTTY: true,
+    read: () => {
+        throw new Error("unexpected read");
+    },
+};
+afterEach(() => vi.restoreAllMocks());
+process.on("exit", () => rmSync(dir, { recursive: true, force: true }));
+describe.each([
+    ["message", cmdMessage],
+    ["send-back", cmdSendBack],
+])("%s message input", (_name, command) => {
+    it.each([
+        [["first", "line"], "first line"],
+        [["-"], "first line\nsecond line"],
+        [[], "first line\nsecond line"],
+        [["--file", file], "first line\nsecond line"],
+        [["--message-file", file], "first line\nsecond line"],
+        [["--message", "first line"], "first line"],
+        [["--message-file", "-"], "first line\nsecond line"],
+    ])("accepts %j", async (args, expected) => {
+        vi.spyOn(RepoOsApi.prototype, "health").mockResolvedValue(true);
+        const request = vi.spyOn(RepoOsApi.prototype, "requestOk").mockResolvedValue({});
+        vi.spyOn(console, "log").mockImplementation(() => { });
+        expect(await command(["123", ...args], piped)).toBe(0);
+        expect(request).toHaveBeenCalledWith("POST", expect.any(String), expect.objectContaining(_name === "message" ? { text: expected } : { message: expected }));
+    });
+    it.each([
+        ["text", "--file", file],
+        ["-"],
+        ["--unknown"],
+        ["--message", "  "],
+        ["--file", join(dir, "missing")],
+        ["--message"],
+        ["--message", "x", "extra"],
+    ])("rejects %j before the API", async (...args) => {
+        expect(() => parseMessageInput(["123", ...args], terminal)).toThrow();
+        const health = vi.spyOn(RepoOsApi.prototype, "health");
+        vi.spyOn(console, "error").mockImplementation(() => { });
+        expect(await command(["123", ...args], terminal)).toBe(1);
+        expect(health).not.toHaveBeenCalled();
+    });
+    it("reports the text length and first line", async () => {
+        vi.spyOn(RepoOsApi.prototype, "health").mockResolvedValue(true);
+        const request = vi.spyOn(RepoOsApi.prototype, "requestOk").mockResolvedValue({});
+        const log = vi.spyOn(console, "log").mockImplementation(() => { });
+        expect(await command(["123", "--message", "hello\nworld"])).toBe(0);
+        expect(request).toHaveBeenCalledWith("POST", expect.any(String), expect.objectContaining(_name === "message" ? { text: "hello\nworld" } : { message: "hello\nworld" }));
+        expect(log.mock.calls.flat().join(" ")).toContain("11 characters: hello");
+    });
+});

package/dist/core/active-task-card.d.ts

@@ -56,6 +56,11 @@ export interface ActiveTaskCardInput {
     localQueueTitle: string | null;
     remotePoolQueueLabel: string | null;
     remotePoolQueueTitle: string | null;
+    /** A live local check slot can prove a run when no check history row exists. */
+    localCheckSlot?: {
+        ageMs: number;
+        heartbeatAgeMs: number;
+    } | null;
     busyChild: string | null;
     stuckSilenceMs?: number;
     checkStallMs?: number;

package/dist/core/active-task-card.js

@@ -99,6 +99,15 @@ export function resolveActiveEngineerCardHint(input) {
             blocksAgentInterrupt: true,
         };
     }
+    if (input.localCheckSlot) {
+        const elapsed = formatCardDuration(input.localCheckSlot.ageMs);
+        return {
+            label: `running checks · check · ${elapsed}`,
+            title: `A local check slot is held for this task · running for ${elapsed}.`,
+            cls: "tc-reviewing",
+            blocksAgentInterrupt: true,
+        };
+    }
     const check = input.check;
     if (check?.running && checkHeartbeating(check, input.nowMs, stallMs)) {
         const elapsed = formatCardDuration(msSince(check.startedAt, input.nowMs) ?? 0);

package/dist/core/config.js

@@ -235,6 +235,7 @@ export const DEFAULT_CONFIG = {
     worktreeWarnThreshold: 20,
     board: {
         agentPopoverCloseSeconds: 15,
+        doneCollapsedByDefault: true,
     },
     whisper: {
         provider: "none",
@@ -1561,6 +1562,9 @@ export function loadConfig(rootArg, options = {}) {
             cfg.worktreeWarnThreshold = Math.floor(worktreeWarnThreshold);
         else if (typeof worktreeWarnThreshold === "string" && /^\d+$/.test(worktreeWarnThreshold))
             cfg.worktreeWarnThreshold = Number(worktreeWarnThreshold);
+        const doneCollapsedByDefault = get("board.doneCollapsedByDefault");
+        if (typeof doneCollapsedByDefault === "boolean")
+            cfg.board = { ...cfg.board, doneCollapsedByDefault };
         const popoverClose = get("board.agentPopoverCloseSeconds");
         const popoverCloseNum = typeof popoverClose === "number"
             ? popoverClose
@@ -2901,6 +2905,15 @@ export function getConfigSchema() {
             ],
             description: "Advisory ceiling on registered git worktrees. Above it, the Control page's Codebase card turns amber and the server logs a `repoos gc` reminder. Never blocks a task.",
         },
+        {
+            key: "board.doneCollapsedByDefault",
+            label: "Start Done collapsed",
+            type: "boolean",
+            tier: "live",
+            restartRequired: false,
+            default: true,
+            description: "Collapse Done for browsers without a saved board preference.",
+        },
         {
             key: "board.agentPopoverCloseSeconds",
             label: "Agent popover auto-close",
@@ -4027,6 +4040,7 @@ export const SUPPORTED_TOML_KEYS = [
     "cto.nudgeCooldownMs",
     "skillSuggestions",
     "worktreeWarnThreshold",
+    "board.doneCollapsedByDefault",
     "board.agentPopoverCloseSeconds",
     "dev.inspector.enabled",
     "dev.inspector.editorCommand",

package/dist/core/db.d.ts

@@ -198,7 +198,11 @@ export declare class RepoOSDb {
      * rounds for a candidate's completed work without a cross join.
      */
     getTaskSessionTypeCounts(taskIds: string[], sessionTypes: string[]): Map<string, number>;
-    /** Retrieve all sessions for a task. */
+    /**
+     * Retrieve all sessions for a task. Returns [] when SQLite is unavailable
+     * (no DB). Throws on query/prepare failures so callers can distinguish
+     * "no rows" from a broken read (#1041).
+     */
     getTaskSessions(taskId: string): SessionRecord[];
     /** Aggregate stats for a task (all sessions and review rounds). */
     getTaskStats(taskId: string): TaskStats | null;

package/dist/core/db.js

@@ -452,7 +452,11 @@ export class RepoOSDb {
         }
         return out;
     }
-    /** Retrieve all sessions for a task. */
+    /**
+     * Retrieve all sessions for a task. Returns [] when SQLite is unavailable
+     * (no DB). Throws on query/prepare failures so callers can distinguish
+     * "no rows" from a broken read (#1041).
+     */
     getTaskSessions(taskId) {
         if (!this.available || !this.db)
             return [];
@@ -461,8 +465,8 @@ export class RepoOSDb {
                 .prepare("SELECT * FROM sessions WHERE taskId = ? ORDER BY startedAt DESC")
                 .all(taskId);
         }
-        catch {
-            return [];
+        catch (err) {
+            throw new Error(`getTaskSessions failed: ${err.message}`);
         }
     }
     /** Aggregate stats for a task (all sessions and review rounds). */