@repo-os/repoos 0.5.76 → 0.5.78

package/dist/.build-info.json

@@ -1,5 +1,5 @@
 {
-  "hash": "ee6f28bc85995205fba9c8e23d6fc9802ccba3ff85045ffd94eaba4a635c603f",
-  "version": "0.5.76",
+  "hash": "38040072cfd2b545bf2a27d69bffb1b2a29dede01df01ee2dd8cde7388833fa9",
+  "version": "0.5.78",
   "devUi": false
 }

package/dist/.build-stamp.json

@@ -1,3 +1,3 @@
 {
-  "generatedAt": "2026-11-05T04:53:41.853Z"
+  "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/agent-compatibility.json

@@ -216,6 +216,28 @@
       "verificationSource": "repoos certify pi live probe \u2014 8/8 seams passed on 2026-10-04T11:42:16.118Z against binary /Users/nick/.local/bin/pi on model openrouter/z-ai/glm-5.3-flash",
       "upgradeGuidance": "pi is pre-1.0, so `--mode json` and session flags can change between minor releases; the supported range is deliberately narrow. Upgrade with `npm i -g @earendil-works/pi-coding-agent`, then run `repoos doctor --probe pi --yes` and update this contract only after a documented passing probe.",
       "officialUrl": "https://github.com/earendil-works/pi-coding-agent"
+    },
+    {
+      "cli": "muse",
+      "name": "Muse Code",
+      "supportedMajor": 1,
+      "supportedRange": ">=1.0.0 <2.0.0",
+      "newestCertifiedVersion": "1.4.14",
+      "knownIncompatibleRanges": [],
+      "requiredCapabilities": [
+        "version",
+        "help",
+        "model-discovery",
+        "headless-one-shot",
+        "structured-events",
+        "auto-permissions",
+        "session-continuation",
+        "cancellation"
+      ],
+      "verifiedAt": "2026-11-05",
+      "verificationSource": "repoos certify muse live probe \u2014 8/8 seams passed on 2026-11-05T14:30:48.057Z against binary /Users/nick/.local/bin/muse on model muse-spark-1.3",
+      "upgradeGuidance": "Install the latest Muse Code release: curl -fsSL https://dev.meta.ai/install.sh | sh",
+      "officialUrl": "https://dev.meta.ai/docs/muse-code"
     }
   ]
 }