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

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-moved.d.ts

@@ -0,0 +1,70 @@
+/**
+ * A pod that moved to a new address.
+ *
+ * Hosted pods move from `{name}.synap.live` to `{name}.pod.synap.live`
+ * (Control Plane "tenant domains v2"). For 90 days the old name answers every
+ * request with a redirect to the new one. The CLI NEVER follows a redirect to
+ * another host for an API call: the request carries the pod key, and a
+ * redirect is something any server on the old name can send. Instead:
+ *
+ *   1. every pod call goes through `podFetch`, which refuses a cross-host
+ *      redirect with `PodMovedError` (one line: what happened, what to run);
+ *   2. `synap doctor` asks the Control Plane where the pod lives now —
+ *      `POST {cp}/pods/handshake {targetUrl: <old url>}` answers
+ *      `410 {code: "POD_MOVED", podId, podUrl, consoleUrl}` for a moved pod
+ *      (CP `src/routes/pods.ts`, `src/lib/pod-handshake-problem.ts`) —
+ *      and `synap doctor --fix` rewrites the saved profile through the one
+ *      door for a URL change (`synap pods update`).
+ *
+ * The new address comes ONLY from the Control Plane, never from the redirect.
+ */
+/** What to run when a pod has moved. */
+export declare const POD_MOVED_HINT = "Run: synap doctor --fix   (it finds the new address and updates your settings)";
+/** The one line a command prints when its pod has moved. */
+export declare function podMovedMessage(podUrl: string): string;
+export declare class PodMovedError extends Error {
+    /** The address the CLI holds (origin). */
+    readonly podUrl: string;
+    /** Where the old address redirected — informational only, never used. */
+    readonly redirectedTo: string;
+    constructor(podUrl: string, redirectedTo: string);
+}
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+/**
+ * `fetch` for calls to a pod: redirects within the same host are followed (at
+ * most 5), a redirect to another host throws `PodMovedError`. Network errors
+ * propagate unchanged, so callers keep their own transport classification.
+ */
+export declare function podFetch(url: string, init?: RequestInit, fetchImpl?: FetchLike): Promise<Response>;
+/** What the Control Plane says about a pod address. */
+export type PodMoveAnswer = {
+    kind: "moved";
+    podUrl: string;
+    consoleUrl?: string;
+    podId?: string;
+}
+/** The CP knows this address as the pod's own (or knows nothing to move). */
+ | {
+    kind: "not-moved";
+    code?: string;
+}
+/** No Control Plane sign-in on this computer, or it expired. */
+ | {
+    kind: "signed-out";
+}
+/** The CP could not be asked, or answered something unreadable. */
+ | {
+    kind: "unknown";
+    reason: string;
+};
+/**
+ * Ask the Control Plane where a pod lives now. Needs the CP sign-in from
+ * `synap login` (a bearer token); without one the answer is `signed-out`.
+ */
+export declare function askControlPlaneWherePodIs(params: {
+    podUrl: string;
+    cpUrl: string;
+    cpToken: string | undefined;
+    fetchImpl?: FetchLike;
+}): Promise<PodMoveAnswer>;
+export {};

package/dist/lib/pod-moved.js

@@ -0,0 +1,146 @@
+/**
+ * A pod that moved to a new address.
+ *
+ * Hosted pods move from `{name}.synap.live` to `{name}.pod.synap.live`
+ * (Control Plane "tenant domains v2"). For 90 days the old name answers every
+ * request with a redirect to the new one. The CLI NEVER follows a redirect to
+ * another host for an API call: the request carries the pod key, and a
+ * redirect is something any server on the old name can send. Instead:
+ *
+ *   1. every pod call goes through `podFetch`, which refuses a cross-host
+ *      redirect with `PodMovedError` (one line: what happened, what to run);
+ *   2. `synap doctor` asks the Control Plane where the pod lives now —
+ *      `POST {cp}/pods/handshake {targetUrl: <old url>}` answers
+ *      `410 {code: "POD_MOVED", podId, podUrl, consoleUrl}` for a moved pod
+ *      (CP `src/routes/pods.ts`, `src/lib/pod-handshake-problem.ts`) —
+ *      and `synap doctor --fix` rewrites the saved profile through the one
+ *      door for a URL change (`synap pods update`).
+ *
+ * The new address comes ONLY from the Control Plane, never from the redirect.
+ */
+/** What to run when a pod has moved. */
+export const POD_MOVED_HINT = "Run: synap doctor --fix   (it finds the new address and updates your settings)";
+/** The one line a command prints when its pod has moved. */
+export function podMovedMessage(podUrl) {
+    return `The pod at ${podUrl} has a new address. Run: synap doctor --fix`;
+}
+export class PodMovedError extends Error {
+    /** The address the CLI holds (origin). */
+    podUrl;
+    /** Where the old address redirected — informational only, never used. */
+    redirectedTo;
+    constructor(podUrl, redirectedTo) {
+        super(podMovedMessage(podUrl));
+        this.name = "PodMovedError";
+        this.podUrl = podUrl;
+        this.redirectedTo = redirectedTo;
+    }
+}
+const MAX_SAME_HOST_HOPS = 5;
+function isRedirect(status) {
+    return status === 301 || status === 302 || status === 303 || status === 307 || status === 308;
+}
+/**
+ * A redirect the CLI may follow: the same origin, or the same host upgraded
+ * from http to https (default ports). Anything else is another host.
+ */
+function isSameHost(from, to) {
+    if (from.origin === to.origin)
+        return true;
+    return (from.protocol === "http:" &&
+        to.protocol === "https:" &&
+        from.hostname === to.hostname &&
+        from.port === "" &&
+        to.port === "");
+}
+/**
+ * `fetch` for calls to a pod: redirects within the same host are followed (at
+ * most 5), a redirect to another host throws `PodMovedError`. Network errors
+ * propagate unchanged, so callers keep their own transport classification.
+ */
+export async function podFetch(url, init = {}, fetchImpl = fetch) {
+    const start = new URL(url);
+    let current = start;
+    let currentInit = init;
+    for (let hop = 0;; hop++) {
+        const res = await fetchImpl(current.toString(), { ...currentInit, redirect: "manual" });
+        if (!isRedirect(res.status))
+            return res;
+        const location = res.headers.get("location");
+        if (!location)
+            return res;
+        let next;
+        try {
+            next = new URL(location, current);
+        }
+        catch {
+            return res;
+        }
+        if (!isSameHost(start, next)) {
+            throw new PodMovedError(start.origin, next.origin);
+        }
+        if (hop >= MAX_SAME_HOST_HOPS)
+            return res;
+        if (res.status === 303 && (currentInit.method ?? "GET").toUpperCase() !== "GET") {
+            const { body: _body, ...rest } = currentInit;
+            currentInit = { ...rest, method: "GET" };
+        }
+        current = next;
+    }
+}
+/**
+ * Ask the Control Plane where a pod lives now. Needs the CP sign-in from
+ * `synap login` (a bearer token); without one the answer is `signed-out`.
+ */
+export async function askControlPlaneWherePodIs(params) {
+    if (!params.cpToken)
+        return { kind: "signed-out" };
+    const fetchImpl = params.fetchImpl ?? fetch;
+    let res;
+    try {
+        res = await fetchImpl(`${params.cpUrl.replace(/\/+$/, "")}/pods/handshake`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${params.cpToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ targetUrl: params.podUrl }),
+            redirect: "manual",
+            signal: AbortSignal.timeout(10_000),
+        });
+    }
+    catch (err) {
+        return { kind: "unknown", reason: err instanceof Error ? err.message : String(err) };
+    }
+    if (res.status === 401)
+        return { kind: "signed-out" };
+    const body = (await res.json().catch(() => null));
+    if (res.status === 410 && body?.code === "POD_MOVED") {
+        const podUrl = typeof body.podUrl === "string" ? safeHttpsOrigin(body.podUrl) : null;
+        if (!podUrl)
+            return { kind: "unknown", reason: "the Control Plane named no usable new address" };
+        return {
+            kind: "moved",
+            podUrl,
+            ...(typeof body.consoleUrl === "string" ? { consoleUrl: body.consoleUrl } : {}),
+            ...(typeof body.podId === "string" ? { podId: body.podId } : {}),
+        };
+    }
+    if (res.ok || res.status === 403 || res.status === 409) {
+        return { kind: "not-moved", ...(typeof body?.code === "string" ? { code: body.code } : {}) };
+    }
+    return { kind: "unknown", reason: `the Control Plane answered ${res.status}` };
+}
+/** An https origin, or null. A new pod address is never plain http. */
+function safeHttpsOrigin(value) {
+    try {
+        const url = new URL(value);
+        if (url.protocol !== "https:" || url.username || url.password)
+            return null;
+        return url.origin;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=pod-moved.js.map

package/dist/lib/pod-moved.js.map

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

package/dist/lib/pod-reach.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Why a pod probe failed, told apart: the network between this machine and the
+ * pod (egress proxy, DNS, firewall, TLS) versus the pod itself answering badly.
+ *
+ * `checkPodHealth` used to fold every failure into `healthy: false`, so `synap
+ * init` behind an egress proxy that answers 403 to CONNECT printed a pod-side
+ * checklist ("is the container running?") for a pod that was never contacted.
+ * This is the one place that taxonomy lives for the probe.
+ */
+export type ReachKind = 
+/** An egress proxy refused the CONNECT tunnel — the pod was never contacted. */
+"proxy"
+/** DNS, refused, reset, unroutable, timeout, TLS — no HTTP answer from anything. */
+ | "network"
+/** The pod host answered, but not with a healthy /health. */
+ | "pod";
+export interface ReachFailure {
+    kind: ReachKind;
+    /** The underlying error, one line: status / error code / message. */
+    detail: string;
+    /** Env variable whose proxy this process used, with credentials stripped. */
+    proxy?: {
+        env: string;
+        url: string;
+    };
+}
+/** The env proxy that applies to `podUrl`, credentials removed. Honors NO_PROXY. */
+export declare function proxyInUse(podUrl: string, env?: NodeJS.ProcessEnv): {
+    env: string;
+    url: string;
+} | undefined;
+/** Classify a fetch that threw (no HTTP answer from the pod). */
+export declare function classifyFetchError(err: unknown, podUrl: string, env?: NodeJS.ProcessEnv): ReachFailure;
+/** Classify a /health that answered with a non-2xx status. */
+export declare function classifyHttpStatus(status: number, podUrl: string, env?: NodeJS.ProcessEnv): ReachFailure;
+/** The lines `synap init` / `synap doctor` print under "not reachable", by cause. */
+export declare function reachChecklist(f: ReachFailure | undefined): string[];
+/** The one-line headline: names the underlying error, not just "not reachable". */
+export declare function unreachableMessage(podUrl: string, failure?: ReachFailure): string;