@synap-core/cli 1.13.0 → 1.13.1-next.20261102.246dc73

package/dist/lib/now-line.js

@@ -0,0 +1,193 @@
+/**
+ * The status line's 4th line: what this conversation is doing NOW, and what it
+ * is waiting on. Built only from local files (Claude Code's process registry,
+ * the transcript index, `synap wait` state files): no network, ever.
+ *
+ *   ✋ needs you · permission prompt          the registry says it waits for the person
+ *   ▶ working · 4m · ⏳ 2 · …                 a turn is running (open waits follow)
+ *   ⏳ waiting on 2 · devbox w7 running · …    idle, with background work still open
+ *   ■ stopped · nothing running · 12m         idle with nothing open: the cue to prompt
+ *
+ * `buildNowLine` is pure (time, liveness and width come in as arguments) so
+ * every state is testable from fixtures.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { isFinal, stateAndDetail, waitName } from "./wait-state.js";
+import { AMBER as A, BOLD_YELLOW as Y, CYAN as C, DIM as D, GREEN as G, RED as R, RESET as X, safeText } from "./term.js";
+/** A passed wait stays on the line this long, then goes. */
+export const PASSED_VISIBLE_MS = 10 * 60_000;
+/** A failed / infra / error / timeout / died wait stays this long. */
+export const FAILED_VISIBLE_MS = 30 * 60_000;
+/** A wait whose state has not changed for this long is shown as stale. */
+export const STALE_AFTER_MS = 30 * 60_000;
+export const DEFAULT_WIDTH = 120;
+/**
+ * The registry file (`~/.claude/sessions/<pid>.json`) whose `sessionId` is
+ * this conversation; the most recently updated one when a resumed
+ * conversation left several. Null when there is none (or no registry at all).
+ */
+export function readRegistry(sessionId, dir = path.join(os.homedir(), ".claude", "sessions")) {
+    let names;
+    try {
+        names = fs.readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    let best = null;
+    for (const n of names) {
+        if (!n.endsWith(".json"))
+            continue;
+        try {
+            const e = JSON.parse(fs.readFileSync(path.join(dir, n), "utf-8"));
+            if (e?.sessionId !== sessionId)
+                continue;
+            if (!best || (e.statusUpdatedAt ?? 0) > (best.statusUpdatedAt ?? 0))
+                best = e;
+        }
+        catch {
+            /* a file mid-write */
+        }
+    }
+    return best;
+}
+// ── Formatting helpers ─────────────────────────────────────────────────
+export function age(ms) {
+    const s = Math.max(0, Math.floor(ms / 1000));
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h${String(m % 60).padStart(2, "0")}`;
+    return `${Math.floor(h / 24)}d`;
+}
+export function ordinal(n) {
+    const t = n % 100;
+    if (t >= 11 && t <= 13)
+        return `${n}th`;
+    return `${n}${{ 1: "st", 2: "nd", 3: "rd" }[n % 10] ?? "th"}`;
+}
+// Colours and OSC 8 links (whose URL is never seen).
+// eslint-disable-next-line no-control-regex
+const ANSI = /\x1b\[[0-9;]*m|\x1b\]8;;[^\x1b]*\x1b\\/g;
+export function visibleLength(s) {
+    return [...s.replace(ANSI, "")].length;
+}
+/** A piece of text as the terminal shows it: control characters out (term.ts), at most `max` characters. */
+export function clip(s, max) {
+    const chars = [...safeText(s)];
+    return chars.length > max ? `${chars.slice(0, max - 1).join("")}…` : chars.join("");
+}
+/** How one typed wait shows, or null when it is no longer worth a place. */
+export function waitItem(w, now, alive) {
+    const name = clip(waitName(w), 40);
+    const try3 = w.attempt >= 3 ? ` ${A}· ${ordinal(w.attempt)} try${X}` : "";
+    // "queued 2nd (light)" already says its state: never "queued queued 2nd".
+    const said = clip(stateAndDetail(w.state, w.detail), 56);
+    if (isFinal(w)) {
+        const since = now - (w.finishedAt ?? w.probedAt);
+        if (w.state === "passed") {
+            return since <= PASSED_VISIBLE_MS ? { text: `${G}✓ ${name} passed${X} ${D}${age(since)} ago${X}${try3}`, open: false } : null;
+        }
+        if (since > FAILED_VISIBLE_MS)
+            return null;
+        return { text: `${R}✗ ${name} ${said}${X}${try3}`, open: false };
+    }
+    if (!alive(w.pid)) {
+        if (now - w.probedAt > FAILED_VISIBLE_MS)
+            return null;
+        return { text: `${R}✗ ${name} died${X} ${D}(the wait stopped at ${w.state})${X}${try3}`, open: false };
+    }
+    const waited = ` ${D}${age(now - w.startedAt)}${X}`;
+    if (now - w.changedAt > STALE_AFTER_MS) {
+        return { text: `${A}${name} ${said} · no change ${age(now - w.changedAt)}${X}${try3}`, open: true };
+    }
+    if (w.state === "error")
+        return { text: `${R}${name} ${said}${X}${waited}${try3}`, open: true };
+    if (w.state === "running")
+        return { text: `${C}${name} ${said}${X}${waited}${try3}`, open: true };
+    return { text: `${D}${name} ${said}${X}${waited}${try3}`, open: true }; // queued, pending
+}
+/** A background task is the typed wait it runs when its command is `synap wait …` for that wait's target. */
+function runsWait(t, w) {
+    const cmd = t.command ?? "";
+    if (!/\bsynap\b[^|;&]*\bwait\s+(devbox|pr|run)\b/.test(cmd))
+        return false;
+    if (!cmd.includes(`wait ${w.kind}`))
+        return false;
+    const target = w.kind === "devbox" ? w.ref : /(?:#| run )(\d+)/.exec(w.ref)?.[1] ?? w.ref; // job name, PR number, run id
+    return cmd.includes(target) && w.startedAt >= t.startedAt - 5_000;
+}
+/** Every item worth showing: what is still open (typed waits first), then recent results. */
+export function nowItems(input) {
+    const { now, registry, open, waits, alive } = input;
+    const items = [];
+    const done = [];
+    for (const w of [...waits].sort((a, b) => a.startedAt - b.startedAt)) {
+        const it = waitItem(w, now, alive);
+        if (it)
+            (it.open ? items : done).push(it.text);
+    }
+    // A task launched by an earlier Claude Code process died with it (Claude
+    // Code marks it stopped on resume): only this process's tasks are open.
+    const since = registry?.startedAt ?? 0;
+    // A shell killed by hand (`kill`, a Monitor timeout) leaves no transcript
+    // marker, so the index keeps it open. Claude Code itself knows: an ended
+    // turn reads `shell` while a background shell is live and `idle` once none
+    // is (seen 2026-10-29: every `idle` session's task outputs were held open by
+    // no process; `shell` ones had live holders). So `idle` closes the shells.
+    const shellsGone = registry?.status === "idle";
+    for (const t of [...open].sort((a, b) => a.startedAt - b.startedAt)) {
+        if (t.startedAt < since)
+            continue;
+        if (shellsGone && (t.kind === "bash" || t.kind === "monitor"))
+            continue;
+        if (waits.some((w) => runsWait(t, w)))
+            continue; // shown once, as its typed wait
+        items.push(`${clip(t.description || t.kind, 40)} ${D}${age(now - t.startedAt)}${X}`);
+    }
+    return { open: items, done };
+}
+export function capped(head, items, width) {
+    let line = head;
+    for (let i = 0; i < items.length; i++) {
+        const rest = items.length - i - 1;
+        const more = rest > 0 ? ` ${D}· +${rest} more${X}` : "";
+        const next = `${line} ${D}·${X} ${items[i]}`;
+        if (visibleLength(next) + visibleLength(more) > width && i > 0) {
+            return `${line} ${D}· +${items.length - i} more${X}`;
+        }
+        line = next;
+    }
+    return line;
+}
+/** The 4th line. */
+export function buildNowLine(input) {
+    const { now, registry } = input;
+    const width = input.width && input.width > 20 ? input.width : DEFAULT_WIDTH;
+    const { open, done } = nowItems(input);
+    const all = [...open, ...done];
+    const status = registry?.status;
+    const since = registry?.statusUpdatedAt ?? input.lastActivityAt;
+    if (status === "waiting") {
+        return `${Y}✋ needs you${X} ${D}·${X} ${clip(registry?.waitingFor || "your answer", width - 16)}`;
+    }
+    if (status === "busy") {
+        const head = `${C}▶ working${X}${since ? ` ${D}· ${age(now - since)}${X}` : ""}`;
+        return capped(open.length ? `${head} ${D}·${X} ⏳ ${open.length}` : head, all, width);
+    }
+    if (open.length)
+        return capped(`${Y}⏳ waiting on ${open.length}${X}`, all, width);
+    // Nothing open: the turn is over and nothing will wake it — the cue to prompt.
+    // A recent result (✓ / ✗) follows, so the person sees what came back.
+    if (!registry)
+        return capped(`${D}○ no session status${X}`, done, width);
+    // idle, shell (a turn ended) and any status this CLI does not know yet
+    return capped(`${A}■ stopped${X} ${D}· nothing running${since ? ` · ${age(now - since)}` : ""}${X}`, done, width);
+}
+//# sourceMappingURL=now-line.js.map

package/dist/lib/now-line.js.map

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

package/dist/lib/now-line.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The status line's 4th line, for each state, from fixtures. Pure: time,
+ * liveness and width are arguments.
+ */
+export {};

package/dist/lib/now-line.test.js

@@ -0,0 +1,177 @@
+/**
+ * The status line's 4th line, for each state, from fixtures. Pure: time,
+ * liveness and width are arguments.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, it, expect } from "vitest";
+import { buildNowLine, ordinal, readRegistry, visibleLength } from "./now-line.js";
+const NOW = Date.parse("2026-10-29T12:00:00Z");
+const min = (m) => NOW - m * 60_000;
+// eslint-disable-next-line no-control-regex
+const plain = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
+const reg = (status, extra = {}) => ({
+    sessionId: "s1",
+    pid: 1,
+    status,
+    statusUpdatedAt: min(4),
+    startedAt: min(600),
+    ...extra,
+});
+const task = (description, startedMin, extra = {}) => ({
+    kind: "bash",
+    description,
+    toolUseId: `t-${description}`,
+    startedAt: min(startedMin),
+    ...extra,
+});
+const wait = (extra) => ({
+    id: "w1",
+    kind: "devbox",
+    ref: "w7-regen",
+    label: "",
+    pid: 4242,
+    startedAt: min(6),
+    probedAt: min(0.5),
+    changedAt: min(2),
+    state: "running",
+    detail: "be-file · 2/4 done",
+    attempt: 1,
+    probeErrors: 0,
+    ...extra,
+});
+const alive = () => true;
+const dead = () => false;
+const line = (over) => plain(buildNowLine({ now: NOW, registry: reg("idle"), open: [], waits: [], alive, ...over }));
+describe("the four states", () => {
+    it("needs you: the registry says waiting, with what for", () => {
+        expect(line({ registry: reg("waiting", { waitingFor: "permission prompt" }) })).toBe("✋ needs you · permission prompt");
+    });
+    it("working: busy, with its age, then the open waits", () => {
+        expect(line({ registry: reg("busy") })).toBe("▶ working · 4m");
+        expect(line({ registry: reg("busy"), open: [task("Run the suite", 3)] })).toBe("▶ working · 4m · ⏳ 1 · Run the suite 3m");
+    });
+    it("waiting on n: idle (turn over) with open waits, typed waits first", () => {
+        const out = line({ registry: reg("shell"), open: [task("Serve the build", 10)], waits: [wait({})] });
+        expect(out).toBe("⏳ waiting on 2 · devbox w7-regen running (be-file · 2/4 done) 6m · Serve the build 10m");
+    });
+    it("stopped: idle with nothing open, and how long since", () => {
+        expect(line({ registry: reg("idle") })).toBe("■ stopped · nothing running · 4m");
+    });
+    it("no registry entry at all says so instead of guessing", () => {
+        expect(line({ registry: null })).toBe("○ no session status");
+    });
+});
+describe("which background tasks count", () => {
+    it("a task from before this Claude Code process started is not shown (it died with that process)", () => {
+        expect(line({ registry: reg("busy", { startedAt: min(5) }), open: [task("old", 30)] })).toBe("▶ working · 4m");
+    });
+    it("idle means no live background shell, so open shells are dropped; agents and teammates stay", () => {
+        const open = [task("Serve the build", 10), task("Audit", 10, { kind: "agent" }), task("@lane-a", 9, { kind: "teammate" })];
+        expect(line({ registry: reg("idle"), open })).toBe("⏳ waiting on 2 · Audit 10m · @lane-a 9m");
+        expect(line({ registry: reg("shell"), open })).toContain("Serve the build");
+    });
+    it("a background task that runs `synap wait` for a typed wait is shown once, as the typed wait", () => {
+        const t = task("Wait for w7", 7, { command: "synap wait devbox w7-regen --label w7" });
+        const out = line({ registry: reg("shell"), open: [t], waits: [wait({})] });
+        expect(out).toBe("⏳ waiting on 1 · devbox w7-regen running (be-file · 2/4 done) 6m");
+    });
+    it("a `synap wait` task for ANOTHER target is still its own item", () => {
+        const t = task("Wait for PR", 7, { command: "synap wait pr backend#412" });
+        expect(line({ registry: reg("shell"), open: [t], waits: [wait({})] })).toContain("Wait for PR");
+    });
+});
+describe("typed wait states", () => {
+    const one = (w, alive_ = alive) => line({ registry: reg("shell"), waits: [wait(w)], alive: alive_ });
+    const raw = (w) => buildNowLine({ now: NOW, registry: reg("shell"), open: [], waits: [wait(w)], alive });
+    it("queued is dim, running cyan", () => {
+        expect(one({ state: "queued", detail: "queued 2nd (light)" })).toBe("⏳ waiting on 1 · devbox w7-regen queued 2nd (light) 6m");
+        expect(raw({ state: "queued", detail: "queued 2nd (light)" })).toContain("\x1b[2mdevbox w7-regen queued");
+        expect(raw({ state: "running" })).toContain("\x1b[36mdevbox w7-regen running");
+    });
+    it("passed shows green ✓ for 10 min after it finished, then goes", () => {
+        const passed = { state: "passed", detail: "4 gates green", exitCode: 0 };
+        expect(one({ ...passed, finishedAt: min(3) })).toBe("■ stopped · nothing running · 4m · ✓ devbox w7-regen passed 3m ago");
+        expect(raw({ ...passed, finishedAt: min(3) })).toContain("\x1b[32m✓");
+        expect(one({ ...passed, finishedAt: min(11) })).toBe("■ stopped · nothing running · 4m");
+    });
+    it("failed shows red ✗ with its detail", () => {
+        const out = one({ state: "failed", detail: "red: be-file (3 tests)", exitCode: 1, finishedAt: min(1) });
+        expect(out).toBe("■ stopped · nothing running · 4m · ✗ devbox w7-regen failed (red: be-file (3 tests))");
+        expect(raw({ state: "failed", detail: "x", exitCode: 1, finishedAt: min(1) })).toContain("\x1b[31m✗");
+    });
+    it("infra, error and timeout are red", () => {
+        for (const state of ["infra", "error", "timeout"]) {
+            expect(raw({ state, detail: "d", exitCode: state === "timeout" ? 2 : 3, finishedAt: min(1) })).toContain(`\x1b[31m✗ devbox w7-regen ${state}`);
+        }
+        expect(raw({ state: "error", detail: "probe failed 3× in a row" })).toContain("\x1b[31mdevbox w7-regen error");
+    });
+    it("a result is not something waited on: an open wait is counted, a finished one only shown", () => {
+        const out = line({ registry: reg("shell"), waits: [wait({ id: "a" }), wait({ id: "b", ref: "w8", state: "failed", detail: "red: x", exitCode: 1, finishedAt: min(1) })] });
+        expect(out).toBe("⏳ waiting on 1 · devbox w7-regen running (be-file · 2/4 done) 6m · ✗ devbox w8 failed (red: x)");
+        expect(line({ registry: reg("busy"), waits: [wait({ state: "passed", exitCode: 0, finishedAt: min(1) })] })).toBe("▶ working · 4m · ✓ devbox w7-regen passed 1m ago");
+    });
+    it("stale: a non-final state that has not changed for 30 min is amber, with how long", () => {
+        const out = raw({ state: "queued", detail: "queued 1st (heavy)", changedAt: min(34) });
+        expect(out).toContain("\x1b[33mdevbox w7-regen queued");
+        expect(plain(out)).toContain("no change 34m");
+    });
+    it("died: a non-final state whose process is gone is red", () => {
+        expect(one({ state: "running" }, dead)).toBe("■ stopped · nothing running · 4m · ✗ devbox w7-regen died (the wait stopped at running)");
+    });
+    it("the 3rd try on one target is called out in amber", () => {
+        expect(one({ attempt: 3 })).toContain("· 3rd try");
+        expect(raw({ attempt: 3 })).toContain("\x1b[33m· 3rd try");
+        expect(one({ attempt: 2 })).not.toContain("try");
+    });
+    it("a PR wait drops the Synap-core owner from its name", () => {
+        expect(one({ kind: "pr", ref: "Synap-core/backend#412", state: "running", detail: "Release gate running · 2/4 done" })).toContain("pr backend#412 Release gate running · 2/4 done");
+    });
+});
+describe("width", () => {
+    it("caps the line to the width, saying how many more there are", () => {
+        const open = Array.from({ length: 8 }, (_, i) => task(`Background job number ${i}`, 20 - i, { kind: "agent" }));
+        const out = line({ registry: reg("idle"), open, width: 100 });
+        expect(visibleLength(out)).toBeLessThanOrEqual(100);
+        expect(out).toMatch(/· \+\d more$/);
+        expect(out.startsWith("⏳ waiting on 8 · Background job number 0")).toBe(true);
+    });
+    it("defaults to 120 columns", () => {
+        const open = Array.from({ length: 20 }, (_, i) => task(`Job ${i} with a long description`, 20, { kind: "agent" }));
+        expect(visibleLength(line({ registry: reg("idle"), open }))).toBeLessThanOrEqual(120);
+    });
+});
+describe("helpers", () => {
+    it("ordinal", () => {
+        expect([1, 2, 3, 4, 11, 12, 13, 21, 22, 23, 101].map(ordinal)).toEqual(["1st", "2nd", "3rd", "4th", "11th", "12th", "13th", "21st", "22nd", "23rd", "101st"]);
+    });
+    it("readRegistry picks the file for this conversation, newest status when several", () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "synap-reg-"));
+        fs.writeFileSync(path.join(dir, "1.json"), JSON.stringify({ pid: 1, sessionId: "a", status: "idle", statusUpdatedAt: 5 }));
+        fs.writeFileSync(path.join(dir, "2.json"), JSON.stringify({ pid: 2, sessionId: "a", status: "busy", statusUpdatedAt: 9 }));
+        fs.writeFileSync(path.join(dir, "3.json"), JSON.stringify({ pid: 3, sessionId: "b", status: "waiting", statusUpdatedAt: 99 }));
+        fs.writeFileSync(path.join(dir, "3.abc.key"), "not json");
+        expect(readRegistry("a", dir)?.status).toBe("busy");
+        expect(readRegistry("z", dir)).toBeNull();
+        expect(readRegistry("a", path.join(dir, "missing"))).toBeNull();
+    });
+});
+describe("no wait, task or prompt text reaches the terminal with its control characters", () => {
+    it("a wait label, a task description and a waitingFor are printed inert", () => {
+        const raw = buildNowLine({
+            now: NOW,
+            registry: reg("busy"),
+            open: [task("run\x1b]0;pwned\x07 tests", 3)],
+            waits: [wait({ label: "PR \x1b[2J#5" })],
+            alive,
+        });
+        expect(raw).not.toContain("\x1b]0;");
+        expect(raw).not.toContain("\x1b[2J");
+        expect(raw).not.toContain("\x07");
+        expect(plain(raw)).toContain("PR [2J#5");
+        const asked = buildNowLine({ now: NOW, registry: reg("waiting", { waitingFor: "allow\x1b[8m rm" }), open: [], waits: [], alive });
+        expect(asked).not.toContain("\x1b[8m");
+    });
+});
+//# sourceMappingURL=now-line.test.js.map

package/dist/lib/now-line.test.js.map

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

package/dist/lib/package-updates.d.ts

@@ -0,0 +1,66 @@
+/**
+ * "Does this installed package have an update?" — the POD's answer, read.
+ *
+ * The pod derives it ONCE for every installed kind (a space's template, the
+ * overlay packs on it, capabilities, views, skills, automations) with one
+ * rule: the catalog's content-hash version against the one the pod last
+ * converged to (`packageHasUpdate`, `@synap-core/types/package-updates`,
+ * served by Hub `GET /package-updates` → `installed[]`). Pod admin's Updates
+ * tab reads the same list, so the CLI and pod admin can no longer disagree
+ * (2 Nov 2026: the CLI said "brand-library: content changed" while pod admin
+ * said nothing, because each derived it its own way).
+ *
+ * This module never compares versions. A pod that cannot answer (an older
+ * pod, a key that is not a pod admin's) is said out loud by the caller:
+ * never a verdict the CLI made up.
+ */
+import { type HubConfig } from "./hub-client.js";
+import type { InstalledKind } from "./installed.js";
+/** One installed package and the pod's verdict (`PackageStanding` on the pod). */
+export interface PackageStanding {
+    slug: string;
+    kind: InstalledKind;
+    name: string;
+    installedVersion: string | null;
+    latestVersion: string | null;
+    /** true / false = the pod compared it; null = it could not (`reason`). */
+    hasUpdate: boolean | null;
+    reason?: string;
+}
+/** Why the pod's answer could not be read. */
+export type StandingsUnavailable = 
+/** The key's person is not a pod admin: the pod answers updates to admins only. */
+"not-pod-admin"
+/** The pod predates the one rule (no `GET /package-updates`, or no `installed[]`). */
+ | "pod-too-old";
+export declare class StandingsUnavailableError extends Error {
+    readonly reason: StandingsUnavailable;
+    constructor(reason: StandingsUnavailable, message: string);
+}
+/**
+ * Every installed package with the pod's verdict. Throws
+ * {@link StandingsUnavailableError} when the pod cannot answer, and the hub
+ * error itself for anything else (unreachable, 5xx): never an empty list for
+ * a read that failed.
+ */
+export declare function fetchPackageStandings(cfg: HubConfig): Promise<PackageStanding[]>;
+/** The shape `market update` prints and returns in `checks[]`, from the pod's verdicts. */
+export interface StandingCheck {
+    slug: string;
+    kind: InstalledKind;
+    installedVersion: string;
+    latestVersion: string | undefined;
+    updateAvailable: boolean;
+    /** No version stamp on the pod: it could not compare. */
+    noVersionInfo: boolean;
+    /** The pod's reason when it could not compare. */
+    reason?: string;
+}
+/**
+ * The pod's verdicts as `market update` checks. `updateAvailable` is the
+ * pod's `hasUpdate === true`, nothing else: a package the pod could not
+ * compare is never "up to date" (no latest version → "can't check"; no stamp
+ * → "version unknown"; a space whose last update did not finish has an update
+ * and no stamp → "not finished").
+ */
+export declare function checksFromStandings(standings: PackageStanding[]): StandingCheck[];

package/dist/lib/package-updates.js

@@ -0,0 +1,76 @@
+/**
+ * "Does this installed package have an update?" — the POD's answer, read.
+ *
+ * The pod derives it ONCE for every installed kind (a space's template, the
+ * overlay packs on it, capabilities, views, skills, automations) with one
+ * rule: the catalog's content-hash version against the one the pod last
+ * converged to (`packageHasUpdate`, `@synap-core/types/package-updates`,
+ * served by Hub `GET /package-updates` → `installed[]`). Pod admin's Updates
+ * tab reads the same list, so the CLI and pod admin can no longer disagree
+ * (2 Nov 2026: the CLI said "brand-library: content changed" while pod admin
+ * said nothing, because each derived it its own way).
+ *
+ * This module never compares versions. A pod that cannot answer (an older
+ * pod, a key that is not a pod admin's) is said out loud by the caller:
+ * never a verdict the CLI made up.
+ */
+import { hubGet, HubError } from "./hub-client.js";
+export class StandingsUnavailableError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.reason = reason;
+        this.name = "StandingsUnavailableError";
+    }
+}
+const SENTENCES = {
+    "not-pod-admin": "Only a pod admin can read the pod's package updates, and this key's person is not one. Nothing was checked.",
+    "pod-too-old": "This pod is too old to answer which packages have an update (no installed[] on GET /package-updates). Update the pod, then run this again. Nothing was checked.",
+};
+/**
+ * Every installed package with the pod's verdict. Throws
+ * {@link StandingsUnavailableError} when the pod cannot answer, and the hub
+ * error itself for anything else (unreachable, 5xx): never an empty list for
+ * a read that failed.
+ */
+export async function fetchPackageStandings(cfg) {
+    let body;
+    try {
+        // One definition fetch per package with an update, on the pod: a cold
+        // catalog can take a while.
+        body = await hubGet("/package-updates", {}, cfg, 60_000);
+    }
+    catch (err) {
+        if (err instanceof HubError && err.status === 403 && !/scope/i.test(`${err.message} ${err.detail ?? ""}`)) {
+            throw new StandingsUnavailableError("not-pod-admin", SENTENCES["not-pod-admin"]);
+        }
+        if (err instanceof HubError && err.status === 404) {
+            throw new StandingsUnavailableError("pod-too-old", SENTENCES["pod-too-old"]);
+        }
+        throw err;
+    }
+    const installed = body?.installed;
+    if (!Array.isArray(installed)) {
+        throw new StandingsUnavailableError("pod-too-old", SENTENCES["pod-too-old"]);
+    }
+    return installed;
+}
+/**
+ * The pod's verdicts as `market update` checks. `updateAvailable` is the
+ * pod's `hasUpdate === true`, nothing else: a package the pod could not
+ * compare is never "up to date" (no latest version → "can't check"; no stamp
+ * → "version unknown"; a space whose last update did not finish has an update
+ * and no stamp → "not finished").
+ */
+export function checksFromStandings(standings) {
+    return standings.map((s) => ({
+        slug: s.slug,
+        kind: s.kind,
+        installedVersion: s.installedVersion ?? "",
+        latestVersion: s.hasUpdate === null && s.installedVersion ? undefined : (s.latestVersion ?? undefined),
+        updateAvailable: s.hasUpdate === true,
+        noVersionInfo: !s.installedVersion,
+        ...(s.reason ? { reason: s.reason } : {}),
+    }));
+}
+//# sourceMappingURL=package-updates.js.map

package/dist/lib/package-updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-updates.js","sourceRoot":"","sources":["../../src/lib/package-updates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,iBAAiB,CAAC;AAsBnE,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAEvC;IADX,YACW,MAA4B,EACrC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,WAAM,GAAN,MAAM,CAAsB;QAIrC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,SAAS,GAAyC;IACtD,eAAe,EACb,6GAA6G;IAC/G,aAAa,EACX,iKAAiK;CACpK,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAc;IACxD,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,sEAAsE;QACtE,4BAA4B;QAC5B,IAAI,GAAG,MAAM,MAAM,CAAC,kBAAkB,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;YAC1G,MAAM,IAAI,yBAAyB,CAAC,eAAe,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAClD,MAAM,IAAI,yBAAyB,CAAC,aAAa,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,SAAS,GAAI,IAAuC,EAAE,SAAS,CAAC;IACtE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,yBAAyB,CAAC,aAAa,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,SAA8B,CAAC;AACxC,CAAC;AAeD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAA4B;IAC9D,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,IAAI,EAAE;QAC1C,aAAa,EAAE,CAAC,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,SAAS,CAAC;QACtG,eAAe,EAAE,CAAC,CAAC,SAAS,KAAK,IAAI;QACrC,aAAa,EAAE,CAAC,CAAC,CAAC,gBAAgB;QAClC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/lib/pod.d.ts

@@ -248,7 +248,3 @@ export interface PodStatus {
  * Check if a Synap pod is healthy.
  */
 export declare function checkPodHealth(podUrl: string): Promise<PodStatus>;
-/**
- * Install Docker and start a self-hosted Synap pod.
- */
-export declare function startSelfHostedPod(): void;

package/dist/lib/pod.js

@@ -4,7 +4,6 @@
 import { readJsonStrict, writeFileAtomic, ensureSecretDir } from "./atomic-file.js";
 import { PodMovedError, podFetch } from "./pod-moved.js";
 import { classifyFetchError, classifyHttpStatus } from "./pod-reach.js";
-import { execSync } from "child_process";
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
@@ -488,10 +487,4 @@ export async function checkPodHealth(podUrl) {
     }
     return status;
 }
-/**
- * Install Docker and start a self-hosted Synap pod.
- */
-export function startSelfHostedPod() {
-    execSync('curl -fsSL https://raw.githubusercontent.com/Synap-core/backend/main/install.sh | bash', { stdio: "inherit" });
-}
 //# sourceMappingURL=pod.js.map