@synap-core/cli 1.13.0 → 1.13.1-next.20261102.3a66eb1

package/dist/lib/transcript-index.test.js

@@ -0,0 +1,200 @@
+/**
+ * The transcript index: what a conversation has running in the background,
+ * from the transcript JSONL, read incrementally.
+ *
+ * Fixture lines mirror Claude Code 2.1.x transcripts (shapes taken from real
+ * transcripts on 2026-10-29: a Bash `backgroundTaskId` result, an Agent
+ * `async_launched` result, a `teammate_spawned` result, `<task-notification>`
+ * user messages, a SendMessage `resumedAgentId` result, a TaskStop).
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, it, expect, beforeEach } from "vitest";
+import { applyLine, emptyIndex, updateIndex } from "./transcript-index.js";
+const T0 = Date.parse("2026-10-29T10:00:00.000Z");
+const iso = (s) => new Date(T0 + s * 1000).toISOString();
+function toolUse(id, name, input, s = 0) {
+    return JSON.stringify({
+        type: "assistant",
+        timestamp: iso(s),
+        message: { role: "assistant", content: [{ type: "tool_use", id, name, input }] },
+    });
+}
+function toolResult(id, toolUseResult, text = "ok", s = 1) {
+    return JSON.stringify({
+        type: "user",
+        timestamp: iso(s),
+        message: { role: "user", content: [{ type: "tool_result", tool_use_id: id, content: text }] },
+        toolUseResult,
+    });
+}
+function notification(taskIds, status, s, summary = "done") {
+    const ids = taskIds.map((t) => `<task-id>${t}</task-id>`).join("\n");
+    return JSON.stringify({
+        type: "user",
+        timestamp: iso(s),
+        message: { role: "user", content: `<task-notification>\n${ids}\n<status>${status}</status>\n<summary>${summary}</summary>\n</task-notification>` },
+    });
+}
+/** A notice that arrived while a turn ran: Claude Code queues it (shape from a real transcript, 2026-10-30). */
+function queued(operation, taskIds, status, s) {
+    const ids = taskIds.map((t) => `<task-id>${t}</task-id>`).join("\n");
+    return JSON.stringify({
+        type: "queue-operation",
+        operation,
+        timestamp: iso(s),
+        sessionId: "s1",
+        content: `<task-notification>\n${ids}\n<tool-use-id>toolu_x</tool-use-id>\n<status>${status}</status>\n<summary>done</summary>\n</task-notification>`,
+    });
+}
+function teammateIdle(from, s) {
+    const body = JSON.stringify({ type: "idle_notification", from, timestamp: iso(s), idleReason: "available" });
+    return JSON.stringify({
+        type: "user",
+        timestamp: iso(s),
+        message: { role: "user", content: `<teammate-message teammate_id="${from}" color="blue">\n${body}\n</teammate-message>` },
+    });
+}
+function apply(lines, idx = emptyIndex("/t.jsonl")) {
+    for (const l of lines)
+        applyLine(idx, l, T0);
+    return idx;
+}
+describe("background tasks open and close", () => {
+    it("a Bash launch opens on its backgroundTaskId result and closes on its notification", () => {
+        const idx = apply([
+            toolUse("toolu_1", "Bash", { command: "synap wait devbox w7", description: "Wait for w7", run_in_background: true }),
+            toolResult("toolu_1", { stdout: "", backgroundTaskId: "bx1" }, "Command running in background with ID: bx1."),
+        ]);
+        expect(Object.keys(idx.open)).toEqual(["bx1"]);
+        expect(idx.open.bx1).toMatchObject({ kind: "bash", description: "Wait for w7", command: "synap wait devbox w7", startedAt: T0 });
+        expect(idx.pending).toEqual({});
+        apply([notification(["bx1"], "completed", 60)], idx);
+        expect(idx.open).toEqual({});
+        expect(idx.recentlyClosed.at(-1)).toMatchObject({ taskId: "bx1", status: "completed", closedAt: T0 + 60_000 });
+    });
+    it("a notification queued while a turn runs closes its task at the enqueue", () => {
+        const launch = [
+            toolUse("toolu_q", "Bash", { command: "sleep 600", description: "Wait for the gate", run_in_background: true }),
+            toolResult("toolu_q", { backgroundTaskId: "bq1" }),
+        ];
+        const idx = apply([...launch, queued("remove", ["bq1"], "completed", 30)]);
+        expect(Object.keys(idx.open)).toEqual(["bq1"]); // a remove is the queue draining, not news
+        apply([queued("enqueue", ["bq1"], "completed", 40)], idx);
+        expect(idx.open).toEqual({});
+        expect(idx.recentlyClosed.at(-1)).toMatchObject({ taskId: "bq1", status: "completed", closedAt: T0 + 40_000 });
+    });
+    it("a foreground Bash that finishes normally opens nothing", () => {
+        const idx = apply([toolUse("toolu_2", "Bash", { command: "ls" }), toolResult("toolu_2", { stdout: "a\nb" })]);
+        expect(idx.open).toEqual({});
+        expect(idx.pending).toEqual({});
+    });
+    it("a foreground Bash moved to the background by its timeout opens too", () => {
+        const idx = apply([
+            toolUse("toolu_3", "Bash", { command: "pnpm test", description: "Run tests" }),
+            toolResult("toolu_3", { stdout: "", backgroundTaskId: "bmoved" }, "Command did not complete within its 120s timeout and was moved to the background"),
+        ]);
+        expect(idx.open.bmoved?.description).toBe("Run tests");
+    });
+    it("an async Agent opens on async_launched and a TaskStop closes it", () => {
+        const idx = apply([
+            toolUse("toolu_4", "Agent", { description: "Audit the flow", prompt: "…" }),
+            toolResult("toolu_4", { isAsync: true, status: "async_launched", agentId: "a5ceb" }),
+        ]);
+        expect(idx.open.a5ceb).toMatchObject({ kind: "agent", description: "Audit the flow" });
+        apply([toolUse("toolu_5", "TaskStop", { task_id: "a5ceb" }, 30)], idx);
+        expect(idx.open).toEqual({});
+        expect(idx.recentlyClosed.at(-1)).toMatchObject({ taskId: "a5ceb", status: "stopped" });
+    });
+    it("a resumed agent is open again, and its next notification closes it again (last event wins)", () => {
+        const idx = apply([
+            toolUse("toolu_6", "Agent", { description: "Draft the plan" }),
+            toolResult("toolu_6", { status: "async_launched", agentId: "a48ea" }),
+            notification(["a48ea"], "completed", 100),
+            // Addressed by name: only the result's `resumedAgentId` says which task this is.
+            toolUse("toolu_7", "SendMessage", { to: "drafter", message: "one more thing" }, 200),
+            toolResult("toolu_7", { success: true, message: "Resuming agent a48ea", resumedAgentId: "a48ea" }, "ok", 201),
+        ]);
+        expect(idx.open.a48ea).toMatchObject({ kind: "agent", description: "Draft the plan", startedAt: T0 + 201_000 });
+        apply([notification(["a48ea"], "completed", 300)], idx);
+        expect(idx.open).toEqual({});
+        expect(idx.recentlyClosed.filter((c) => c.taskId === "a48ea")).toHaveLength(1);
+    });
+    it("one notification can close several tasks, and its scan marker is not a task", () => {
+        const idx = apply([
+            toolUse("toolu_8", "Bash", { command: "sleep 100", run_in_background: true }),
+            toolResult("toolu_8", { backgroundTaskId: "b1" }),
+            toolUse("toolu_9", "Bash", { command: "sleep 200", run_in_background: true }),
+            toolResult("toolu_9", { backgroundTaskId: "b2" }),
+            notification(["b1", "b2", "__orphan_summary__:shell"], "stopped", 50),
+        ]);
+        expect(idx.open).toEqual({});
+        expect(idx.recentlyClosed.map((c) => c.taskId)).toEqual(["b1", "b2"]);
+    });
+    it("a teammate is open while busy, closed on its idle notice, open again once messaged", () => {
+        const idx = apply([
+            toolUse("toolu_10", "Agent", { name: "nowline", description: "Build the now line" }),
+            toolResult("toolu_10", { status: "teammate_spawned", agentId: "anowline-1", name: "nowline" }),
+        ]);
+        expect(idx.open["anowline-1"]).toMatchObject({ kind: "teammate", description: "@nowline" });
+        apply([teammateIdle("nowline", 90)], idx);
+        expect(idx.open).toEqual({});
+        apply([
+            toolUse("toolu_11", "SendMessage", { to: "nowline", message: "next" }, 120),
+            toolResult("toolu_11", { success: true, message: "Message sent to nowline's inbox" }, "ok", 121),
+        ], idx);
+        expect(idx.open["anowline-1"]?.startedAt).toBe(T0 + 121_000);
+    });
+});
+describe("incremental read", () => {
+    let dir;
+    let file;
+    beforeEach(() => {
+        dir = fs.mkdtempSync(path.join(os.tmpdir(), "synap-ti-"));
+        file = path.join(dir, "s.jsonl");
+    });
+    const launch = (n) => [
+        toolUse(`toolu_${n}`, "Bash", { command: `job ${n}`, description: `job ${n}`, run_in_background: true }),
+        toolResult(`toolu_${n}`, { backgroundTaskId: `b${n}` }),
+    ];
+    it("reads only what was appended, and leaves a half-written line for next time", () => {
+        fs.writeFileSync(file, launch(1).join("\n") + "\n");
+        const first = updateIndex(null, file, { maxBytes: Infinity });
+        expect(Object.keys(first.index.open)).toEqual(["b1"]);
+        expect(first.index.offset).toBe(fs.statSync(file).size);
+        const [use, result] = launch(2);
+        fs.appendFileSync(file, use + "\n" + result.slice(0, 20)); // the result is mid-write
+        const second = updateIndex(first.index, file, { maxBytes: Infinity });
+        expect(second.index.pending.toolu_2).toBeDefined();
+        expect(second.index.open.b2).toBeUndefined();
+        fs.appendFileSync(file, result.slice(20) + "\n");
+        const third = updateIndex(second.index, file, { maxBytes: Infinity });
+        expect(Object.keys(third.index.open).sort()).toEqual(["b1", "b2"]);
+        expect(third.index.offset).toBe(fs.statSync(file).size);
+    });
+    it("a transcript smaller than the offset (truncated or replaced) is read again from 0", () => {
+        fs.writeFileSync(file, [...launch(1), ...launch(2)].join("\n") + "\n");
+        const before = updateIndex(null, file, { maxBytes: Infinity });
+        expect(Object.keys(before.index.open)).toHaveLength(2);
+        fs.writeFileSync(file, launch(3).join("\n") + "\n"); // shorter
+        const after = updateIndex(before.index, file, { maxBytes: Infinity });
+        expect(Object.keys(after.index.open)).toEqual(["b3"]);
+    });
+    it("a backlog bigger than maxBytes is not read by render: it says how far behind it is", () => {
+        fs.writeFileSync(file, launch(1).join("\n") + "\n");
+        const r = updateIndex(null, file, { maxBytes: 10 });
+        expect(r.behind).toBe(fs.statSync(file).size);
+        expect(r.index.offset).toBe(0);
+        expect(r.index.open).toEqual({});
+    });
+    it("reads a multi-chunk transcript line by line (lines straddling the 4 MB chunk edge)", () => {
+        const filler = JSON.stringify({ type: "user", message: { content: "x".repeat(1_000_000) } });
+        const lines = [...launch(1), filler, filler, filler, filler, filler, ...launch(2)];
+        fs.writeFileSync(file, lines.join("\n") + "\n");
+        const r = updateIndex(null, file, { maxBytes: Infinity });
+        expect(Object.keys(r.index.open).sort()).toEqual(["b1", "b2"]);
+        expect(r.index.offset).toBe(fs.statSync(file).size);
+    });
+});
+//# sourceMappingURL=transcript-index.test.js.map

package/dist/lib/transcript-index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-index.test.js","sourceRoot":"","sources":["../../src/lib/transcript-index.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/wait-help.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `synap wait`'s exit codes and help text: kept apart from the command so the
+ * CLI entry can show the help without loading the command module.
+ */
+export declare const WAIT_EXIT: {
+    readonly PASSED: 0;
+    readonly FAILED: 1;
+    readonly TIMEOUT: 2;
+    readonly INFRA: 3;
+};
+export declare const WAIT_HELP = "\nWhat each kind waits for:\n  devbox <job>      the devbox job of that name (gate.sh, q.sh, runlocked.sh) to finish a\n                    run that ended after the wait started (see --since). Reads\n                    `ssh devbox python3 ~/wt/devbox-status.py --name <job>` every 30 s.\n  pr <repo>#<n>     --for checks (default): every check on the PR (or the --checks list) to\n                    complete. --for merged: the PR to be merged or closed. A bare repo name\n                    means Synap-core/<repo>. Reads `gh pr view` every 60 s.\n  run <url|id>      a GitHub Actions run to complete. Reads `gh run view` every 60 s.\n\nIt prints one line per state change and a final summary, and keeps its state in\n~/.synap/waits/<conversation>/<id>.json, which the Claude Code status line shows.\n\nExit codes:\n  0  passed (devbox green; every check success/skipped/neutral; merged; run success)\n  1  failed (a red gate; a failed or cancelled check; closed unmerged; run failed)\n  2  timeout (--timeout, default 4h)\n  3  infra (devbox infra / died / refused / NOT-RUN), or the probe kept failing until the timeout\n";

package/dist/lib/wait-help.js

@@ -0,0 +1,25 @@
+/**
+ * `synap wait`'s exit codes and help text: kept apart from the command so the
+ * CLI entry can show the help without loading the command module.
+ */
+export const WAIT_EXIT = { PASSED: 0, FAILED: 1, TIMEOUT: 2, INFRA: 3 };
+export const WAIT_HELP = `
+What each kind waits for:
+  devbox <job>      the devbox job of that name (gate.sh, q.sh, runlocked.sh) to finish a
+                    run that ended after the wait started (see --since). Reads
+                    \`ssh devbox python3 ~/wt/devbox-status.py --name <job>\` every 30 s.
+  pr <repo>#<n>     --for checks (default): every check on the PR (or the --checks list) to
+                    complete. --for merged: the PR to be merged or closed. A bare repo name
+                    means Synap-core/<repo>. Reads \`gh pr view\` every 60 s.
+  run <url|id>      a GitHub Actions run to complete. Reads \`gh run view\` every 60 s.
+
+It prints one line per state change and a final summary, and keeps its state in
+~/.synap/waits/<conversation>/<id>.json, which the Claude Code status line shows.
+
+Exit codes:
+  0  passed (devbox green; every check success/skipped/neutral; merged; run success)
+  1  failed (a red gate; a failed or cancelled check; closed unmerged; run failed)
+  2  timeout (--timeout, default 4h)
+  3  infra (devbox infra / died / refused / NOT-RUN), or the probe kept failing until the timeout
+`;
+//# sourceMappingURL=wait-help.js.map

package/dist/lib/wait-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-help.js","sourceRoot":"","sources":["../../src/lib/wait-help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAW,CAAC;AAEjF,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;CAkBxB,CAAC"}

package/dist/lib/wait-state.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The state files `synap wait` writes, and the status line reads.
+ *
+ * One file per wait: `~/.synap/waits/<conversation>/<id>.json`, where the
+ * conversation is the Claude Code session id the wait ran under
+ * (`CLAUDE_CODE_SESSION_ID`, set in every Bash command an agent runs) or
+ * `_nosession`. The wait rewrites its file after every probe (tmp + rename,
+ * so a reader never sees half a file); the status line only ever reads.
+ *
+ * Local files only, no network: the status line renders from these.
+ */
+export type WaitKind = "devbox" | "pr" | "run";
+/** A wait is over once it carries `exitCode` (and `finishedAt`); `error` can be either. */
+export type WaitState = "pending" | "queued" | "running" | "passed" | "failed" | "infra" | "error" | "timeout";
+export declare function isFinal(w: Pick<WaitRecord, "exitCode">): boolean;
+export interface WaitRecord {
+    id: string;
+    kind: WaitKind;
+    /** Normalised target: the devbox job name, `owner/repo#n`, `owner/repo run <id>`. */
+    ref: string;
+    label: string;
+    pid: number;
+    startedAt: number;
+    probedAt: number;
+    changedAt: number;
+    state: WaitState;
+    detail: string;
+    /** 1 + the earlier waits in this conversation for the same kind+ref: the "looping" signal. */
+    attempt: number;
+    probeErrors: number;
+    exitCode?: number;
+    finishedAt?: number;
+}
+export declare function waitsRoot(): string;
+/** A session id as a directory name: anything outside [A-Za-z0-9_-] is dropped. */
+export declare function safeSessionDir(sessionId: string | undefined): string;
+export declare function waitsDir(sessionId: string | undefined): string;
+/** Every readable wait file of one conversation. A file that does not parse is skipped. */
+export declare function readWaits(sessionId: string | undefined): WaitRecord[];
+/** Atomic: write a sibling tmp file, then rename it over the target. */
+export declare function writeWait(sessionId: string | undefined, rec: WaitRecord): void;
+/** 1 + the earlier waits (any state) in this conversation for the same kind+ref. */
+export declare function attemptFor(existing: WaitRecord[], kind: WaitKind, ref: string): number;
+/**
+ * Remove waits that finished more than 24 h ago, and non-final ones whose
+ * process is gone and whose last probe is that old. Best-effort.
+ */
+export declare function pruneWaits(sessionId: string | undefined, now?: number): void;
+export declare function pidAlive(pid: number): boolean;
+/** How a wait is named on screen: its label, else kind + target without the Synap-core owner. */
+export declare function waitName(w: Pick<WaitRecord, "kind" | "ref" | "label">): string;
+/**
+ * A state and its detail in one phrase, never saying the state twice:
+ * "running (be-file · 1/2 done)", but "queued 2nd (light)" and
+ * "Release gate running · 2/4 done" as they are.
+ */
+export declare function stateAndDetail(state: string, detail: string): string;

package/dist/lib/wait-state.js

@@ -0,0 +1,114 @@
+/**
+ * The state files `synap wait` writes, and the status line reads.
+ *
+ * One file per wait: `~/.synap/waits/<conversation>/<id>.json`, where the
+ * conversation is the Claude Code session id the wait ran under
+ * (`CLAUDE_CODE_SESSION_ID`, set in every Bash command an agent runs) or
+ * `_nosession`. The wait rewrites its file after every probe (tmp + rename,
+ * so a reader never sees half a file); the status line only ever reads.
+ *
+ * Local files only, no network: the status line renders from these.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export function isFinal(w) {
+    return typeof w.exitCode === "number";
+}
+const PRUNE_AFTER_MS = 24 * 60 * 60_000;
+export function waitsRoot() {
+    return path.join(os.homedir(), ".synap", "waits");
+}
+/** A session id as a directory name: anything outside [A-Za-z0-9_-] is dropped. */
+export function safeSessionDir(sessionId) {
+    const clean = (sessionId ?? "").replace(/[^A-Za-z0-9_-]/g, "");
+    return clean || "_nosession";
+}
+export function waitsDir(sessionId) {
+    return path.join(waitsRoot(), safeSessionDir(sessionId));
+}
+/** Every readable wait file of one conversation. A file that does not parse is skipped. */
+export function readWaits(sessionId) {
+    const dir = waitsDir(sessionId);
+    let names;
+    try {
+        names = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const n of names) {
+        if (!n.endsWith(".json"))
+            continue;
+        try {
+            const rec = JSON.parse(fs.readFileSync(path.join(dir, n), "utf-8"));
+            if (rec && typeof rec.id === "string" && typeof rec.state === "string")
+                out.push(rec);
+        }
+        catch {
+            /* a file mid-write by an older writer, or not ours */
+        }
+    }
+    return out;
+}
+/** Atomic: write a sibling tmp file, then rename it over the target. */
+export function writeWait(sessionId, rec) {
+    const dir = waitsDir(sessionId);
+    fs.mkdirSync(dir, { recursive: true });
+    const target = path.join(dir, `${rec.id}.json`);
+    const tmp = `${target}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify(rec));
+    fs.renameSync(tmp, target);
+}
+/** 1 + the earlier waits (any state) in this conversation for the same kind+ref. */
+export function attemptFor(existing, kind, ref) {
+    return 1 + existing.filter((w) => w.kind === kind && w.ref === ref).length;
+}
+/**
+ * Remove waits that finished more than 24 h ago, and non-final ones whose
+ * process is gone and whose last probe is that old. Best-effort.
+ */
+export function pruneWaits(sessionId, now = Date.now()) {
+    const dir = waitsDir(sessionId);
+    for (const w of readWaits(sessionId)) {
+        const old = isFinal(w)
+            ? now - (w.finishedAt ?? w.probedAt) > PRUNE_AFTER_MS
+            : now - w.probedAt > PRUNE_AFTER_MS && !pidAlive(w.pid);
+        if (!old)
+            continue;
+        try {
+            fs.unlinkSync(path.join(dir, `${w.id}.json`));
+        }
+        catch {
+            /* already gone */
+        }
+    }
+}
+export function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        // EPERM: the process exists, it is just not ours to signal.
+        return e.code === "EPERM";
+    }
+}
+/** How a wait is named on screen: its label, else kind + target without the Synap-core owner. */
+export function waitName(w) {
+    return w.label || `${w.kind} ${w.ref.replace(/^Synap-core\//, "")}`;
+}
+/**
+ * A state and its detail in one phrase, never saying the state twice:
+ * "running (be-file · 1/2 done)", but "queued 2nd (light)" and
+ * "Release gate running · 2/4 done" as they are.
+ */
+export function stateAndDetail(state, detail) {
+    if (!detail)
+        return state;
+    return new RegExp(`\\b${state}\\b`).test(detail) ? detail : `${state} (${detail})`;
+}
+//# sourceMappingURL=wait-state.js.map

package/dist/lib/wait-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-state.js","sourceRoot":"","sources":["../../src/lib/wait-state.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synap-core/cli",
-  "version": "1.13.0",
+  "version": "1.13.1-next.20261102.3a66eb1",
   "description": "Connect any AI agent (Claude Code, Codex, Cursor and more) to your own Synap data pod: shared memory, structured data and human-approved changes.",
   "type": "module",
   "bin": {
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "@synap-core/hub-rest-client": "^1.1.1",
-    "@synap-core/types": "^1.12.1",
+    "@synap-core/types": "^1.12.4",
     "@synap-core/workspace-templates": ">=0.12.0 <1.0.0",
     "chalk": "^5.4.0",
     "commander": "^13.0.0",