@cotal-ai/cli 0.2.0 → 0.3.0

package/dist/lib/manager-proc.js

@@ -0,0 +1,84 @@
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, openSync, closeSync, writeFileSync, readFileSync, rmSync } from "node:fs";
+import { DEFAULT_SERVER } from "@cotal-ai/core";
+import { selfArgv } from "./self-exec.js";
+import { resolveSpace } from "./status.js";
+import { cotalPath } from "./paths.js";
+const PID_PATH = () => cotalPath("manager.pid");
+function alive(pid) {
+    try {
+        process.kill(pid, 0); // signal 0: liveness probe, doesn't actually signal
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** True if the manager we started for this folder is still running (pid file + liveness). */
+export function managerUp() {
+    const p = PID_PATH();
+    if (!existsSync(p))
+        return false;
+    const pid = Number(readFileSync(p, "utf8").trim());
+    return Number.isFinite(pid) && alive(pid);
+}
+/** True if any process's full command line matches `pattern` (`pgrep -f`). Detects processes that
+ *  have no pid file — the cmux-tab manager and the driving session — which live in cmux tabs. */
+export function pgrepMatches(pattern) {
+    return spawnSync("pgrep", ["-f", pattern], { stdio: "ignore" }).status === 0;
+}
+/** True if a cmux-runtime manager is live for this space. Its cmux tab persists after the process
+ *  exits, so a workspace listing isn't proof — the process is. Matches prod `cotal.js` and dev
+ *  `cotal.ts` (both carry `cmux --space <space>`). */
+export function cmuxManagerRunning(space) {
+    return pgrepMatches(`cmux --space ${space}`);
+}
+/** Start the control-plane manager detached (pid in `.cotal/manager.pid`, output to
+ *  `.cotal/manager.log`), stopped by `cotal down`. Re-execs this same CLI's `supervise` — the
+ *  composed `cotal` binary registers it; `process.execArgv` carries the tsx loader in dev and is
+ *  empty in prod. `supervise`'s auto runtime resolves to pty when detached, which answers the
+ *  control plane (`cotal_spawn`/`despawn`/`purge`/`persona`) with no tmux/cmux needed. */
+export function startManagerDetached(o = {}) {
+    const fd = openSync(cotalPath("manager.log"), "a");
+    const [node, ...self] = selfArgv();
+    const args = [
+        ...self,
+        "supervise",
+        "--space",
+        o.space ?? resolveSpace(process.cwd()),
+        "--server",
+        o.server ?? DEFAULT_SERVER,
+        ...(o.spawn?.length ? ["--spawn", o.spawn.join(",")] : []),
+    ];
+    const child = spawn(node, args, { detached: true, stdio: ["ignore", fd, fd] });
+    closeSync(fd);
+    child.unref();
+    writeFileSync(PID_PATH(), String(child.pid));
+    return child.pid ?? 0;
+}
+/** Make the control plane available: reuse a manager already running for this folder, else start
+ *  one detached. Best-effort — callers treat it as non-fatal. */
+export function ensureManager(o = {}) {
+    if (managerUp())
+        return { running: true };
+    startManagerDetached(o);
+    return { running: true };
+}
+/** Stop the detached (pty) manager if we started one. Used when switching to the cmux-tab manager
+ *  so the two don't both answer the control plane (queue-grouped requests would split between them). */
+export function stopManager() {
+    const p = PID_PATH();
+    if (!existsSync(p))
+        return;
+    const pid = Number(readFileSync(p, "utf8").trim());
+    if (Number.isFinite(pid)) {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch {
+            /* already gone */
+        }
+    }
+    rmSync(p);
+}
+//# sourceMappingURL=manager-proc.js.map

package/dist/lib/manager-proc.js.map

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

package/dist/lib/nats-bin.d.ts

@@ -0,0 +1,7 @@
+/** Resolve the nats-server binary: PATH first (an operator-installed server always
+ *  wins), then the bundled platform package. Throws when neither is available. */
+export declare function resolveNatsServer(): Promise<{
+    bin: string;
+    source: "path" | "bundled";
+}>;
+//# sourceMappingURL=nats-bin.d.ts.map

package/dist/lib/nats-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-bin.d.ts","sourceRoot":"","sources":["../../src/lib/nats-bin.ts"],"names":[],"mappings":"AAMA;kFACkF;AAClF,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CAc9F"}

package/dist/lib/nats-bin.js

@@ -0,0 +1,21 @@
+import { spawnSync } from "node:child_process";
+/** Platform-package prefix the bundled binary ships under. Swapping providers
+ *  (e.g. to our own @cotal-ai/nats-server-*) is a one-line change here. */
+const BUNDLED_PKG_PREFIX = "@eplightning/nats-server";
+/** Resolve the nats-server binary: PATH first (an operator-installed server always
+ *  wins), then the bundled platform package. Throws when neither is available. */
+export async function resolveNatsServer() {
+    const onPath = spawnSync("nats-server", ["--version"], { stdio: "ignore" });
+    if (!onPath.error && onPath.status === 0)
+        return { bin: "nats-server", source: "path" };
+    const pkg = `${BUNDLED_PKG_PREFIX}-${process.platform}-${process.arch}`;
+    try {
+        const mod = (await import(pkg));
+        return { bin: mod.getBinaryPath(), source: "bundled" };
+    }
+    catch {
+        throw new Error(`nats-server not found on PATH and no bundled binary for ${process.platform}/${process.arch} (${pkg}). ` +
+            "Install nats-server (https://github.com/nats-io/nats-server/releases) and put it on PATH.");
+    }
+}
+//# sourceMappingURL=nats-bin.js.map

package/dist/lib/nats-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-bin.js","sourceRoot":"","sources":["../../src/lib/nats-bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;2EAC2E;AAC3E,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD;kFACkF;AAClF,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5E,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAExF,MAAM,GAAG,GAAG,GAAG,kBAAkB,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAAgC,CAAC;QAC/D,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,2DAA2D,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,GAAG,KAAK;YACtG,2FAA2F,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/onboard.d.ts

@@ -0,0 +1,3 @@
+export declare function isOnboarded(): boolean;
+export declare function markOnboarded(version: string): void;
+//# sourceMappingURL=onboard.d.ts.map

package/dist/lib/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/lib/onboard.ts"],"names":[],"mappings":"AASA,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGnD"}

package/dist/lib/onboard.js

@@ -0,0 +1,15 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Machine-level "I've onboarded before" marker. Its presence flips `cotal` from the
+ *  full first-run flow to the compact ensure+status run. Lives next to the materialized
+ *  plugin marketplace under ~/.cotal. */
+const MARKER = join(homedir(), ".cotal", "onboarded.json");
+export function isOnboarded() {
+    return existsSync(MARKER);
+}
+export function markOnboarded(version) {
+    mkdirSync(join(homedir(), ".cotal"), { recursive: true });
+    writeFileSync(MARKER, JSON.stringify({ version, ts: new Date().toISOString() }, null, 2));
+}
+//# sourceMappingURL=onboard.js.map

package/dist/lib/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../../src/lib/onboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;yCAEyC;AACzC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAE3D,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC"}

package/dist/lib/paths.d.ts

@@ -0,0 +1,7 @@
+/** The project's `.cotal/` root, found by walking up from cwd (like git finds `.git`), so every
+ *  command resolves the same `.cotal/` whether you're at the project root or a subdirectory. */
+export declare function cotalRoot(): string;
+/** A path inside the project's `.cotal/` directory. Use instead of `resolve(".cotal/…")` so paths
+ *  don't break when `cotal` runs from a subdirectory. */
+export declare function cotalPath(...segments: string[]): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAGA;gGACgG;AAChG,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;yDACyD;AACzD,wBAAgB,SAAS,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD"}

package/dist/lib/paths.js

@@ -0,0 +1,13 @@
+import { join } from "node:path";
+import { findCotalRoot } from "@cotal-ai/core";
+/** The project's `.cotal/` root, found by walking up from cwd (like git finds `.git`), so every
+ *  command resolves the same `.cotal/` whether you're at the project root or a subdirectory. */
+export function cotalRoot() {
+    return findCotalRoot();
+}
+/** A path inside the project's `.cotal/` directory. Use instead of `resolve(".cotal/…")` so paths
+ *  don't break when `cotal` runs from a subdirectory. */
+export function cotalPath(...segments) {
+    return join(cotalRoot(), ".cotal", ...segments);
+}
+//# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C;gGACgG;AAChG,MAAM,UAAU,SAAS;IACvB,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC;AAED;yDACyD;AACzD,MAAM,UAAU,SAAS,CAAC,GAAG,QAAkB;IAC7C,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;AAClD,CAAC"}

package/dist/lib/self-exec.d.ts

@@ -0,0 +1,18 @@
+/** This CLI's own invocation as argv: `[node, ...loaderFlags, entryScript]`. The loader flags carry
+ *  tsx in dev (so a re-exec can run the `.ts` entry) and are empty in prod (entry = compiled JS).
+ *  Re-execed children (web, manager) and cmux pane commands use this so they never depend on
+ *  `cotal` being on PATH — works the same via `npx`, `npm i -g`, and a dev clone. */
+export declare function selfArgv(): string[];
+/** True when launched via `npx` — the package is unpacked under `~/.npm/_npx/<hash>/…`. */
+export declare function isNpx(): boolean;
+/** Is a `cotal` executable resolvable on PATH? A pure PATH scan (no exec): `cotal --version`
+ *  isn't a real command, so probing it via `onPath` would always report cotal as missing. */
+export declare function cotalOnPath(): boolean;
+/** The copy-paste command prefix for user-facing hints: `cotal` when it's on PATH, `npx cotal-ai`
+ *  for an npx run, `pnpm cotal` in a dev clone. (Display only — re-execs use {@link selfArgv}.) */
+export declare function displayCmd(): string;
+/** The self-invocation as a shell-ready, double-quoted command prefix (for cmux pane commands).
+ *  Tokens are absolute paths with no single quotes, so the surrounding `bash -lc '…'` single-quote
+ *  wrapping stays intact through a login shell (e.g. nushell) before bash. */
+export declare function selfCotal(): string;
+//# sourceMappingURL=self-exec.d.ts.map

package/dist/lib/self-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-exec.d.ts","sourceRoot":"","sources":["../../src/lib/self-exec.ts"],"names":[],"mappings":"AAGA;;;qFAGqF;AACrF,wBAAgB,QAAQ,IAAI,MAAM,EAAE,CAEnC;AAED,2FAA2F;AAC3F,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED;6FAC6F;AAC7F,wBAAgB,WAAW,IAAI,OAAO,CAcrC;AAED;mGACmG;AACnG,wBAAgB,UAAU,IAAI,MAAM,CAInC;AAED;;8EAE8E;AAC9E,wBAAgB,SAAS,IAAI,MAAM,CAIlC"}

package/dist/lib/self-exec.js

@@ -0,0 +1,50 @@
+import { accessSync, constants } from "node:fs";
+import { delimiter, join } from "node:path";
+/** This CLI's own invocation as argv: `[node, ...loaderFlags, entryScript]`. The loader flags carry
+ *  tsx in dev (so a re-exec can run the `.ts` entry) and are empty in prod (entry = compiled JS).
+ *  Re-execed children (web, manager) and cmux pane commands use this so they never depend on
+ *  `cotal` being on PATH — works the same via `npx`, `npm i -g`, and a dev clone. */
+export function selfArgv() {
+    return [process.execPath, ...process.execArgv, process.argv[1]];
+}
+/** True when launched via `npx` — the package is unpacked under `~/.npm/_npx/<hash>/…`. */
+export function isNpx() {
+    return /[/\\]_npx[/\\]/.test(process.argv[1] ?? "");
+}
+/** Is a `cotal` executable resolvable on PATH? A pure PATH scan (no exec): `cotal --version`
+ *  isn't a real command, so probing it via `onPath` would always report cotal as missing. */
+export function cotalOnPath() {
+    const exts = process.platform === "win32" ? ["", ".cmd", ".exe", ".bat"] : [""];
+    for (const dir of (process.env.PATH ?? "").split(delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            try {
+                accessSync(join(dir, `cotal${ext}`), constants.X_OK);
+                return true;
+            }
+            catch {
+                /* not here */
+            }
+        }
+    }
+    return false;
+}
+/** The copy-paste command prefix for user-facing hints: `cotal` when it's on PATH, `npx cotal-ai`
+ *  for an npx run, `pnpm cotal` in a dev clone. (Display only — re-execs use {@link selfArgv}.) */
+export function displayCmd() {
+    if (cotalOnPath())
+        return "cotal";
+    if (isNpx())
+        return "npx cotal-ai";
+    return "pnpm cotal";
+}
+/** The self-invocation as a shell-ready, double-quoted command prefix (for cmux pane commands).
+ *  Tokens are absolute paths with no single quotes, so the surrounding `bash -lc '…'` single-quote
+ *  wrapping stays intact through a login shell (e.g. nushell) before bash. */
+export function selfCotal() {
+    return selfArgv()
+        .map((a) => `"${a}"`)
+        .join(" ");
+}
+//# sourceMappingURL=self-exec.js.map

package/dist/lib/self-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-exec.js","sourceRoot":"","sources":["../../src/lib/self-exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE5C;;;qFAGqF;AACrF,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,KAAK;IACnB,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;6FAC6F;AAC7F,MAAM,UAAU,WAAW;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChF,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,EAAE,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBACrD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;mGACmG;AACnG,MAAM,UAAU,UAAU;IACxB,IAAI,WAAW,EAAE;QAAE,OAAO,OAAO,CAAC;IAClC,IAAI,KAAK,EAAE;QAAE,OAAO,cAAc,CAAC;IACnC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;8EAE8E;AAC9E,MAAM,UAAU,SAAS;IACvB,OAAO,QAAQ,EAAE;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;SACpB,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/lib/setup-log.d.ts

@@ -0,0 +1,8 @@
+export interface SetupLog {
+    path: string;
+    line(s: string): void;
+}
+/** Timestamped append log for `cotal setup` — one file, also the first thing a
+ *  Claude handoff is pointed at. Resolves the project's `.cotal/` (walks up from cwd). */
+export declare function openSetupLog(_cwd: string): SetupLog;
+//# sourceMappingURL=setup-log.d.ts.map

package/dist/lib/setup-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-log.d.ts","sourceRoot":"","sources":["../../src/lib/setup-log.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;0FAC0F;AAC1F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAUnD"}

package/dist/lib/setup-log.js

@@ -0,0 +1,17 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { cotalPath } from "./paths.js";
+/** Timestamped append log for `cotal setup` — one file, also the first thing a
+ *  Claude handoff is pointed at. Resolves the project's `.cotal/` (walks up from cwd). */
+export function openSetupLog(_cwd) {
+    const path = cotalPath("setup.log");
+    mkdirSync(dirname(path), { recursive: true });
+    appendFileSync(path, `\n=== cotal setup — ${new Date().toISOString()} ===\n`);
+    return {
+        path,
+        line(s) {
+            appendFileSync(path, `${new Date().toISOString()} ${s}\n`);
+        },
+    };
+}
+//# sourceMappingURL=setup-log.js.map

package/dist/lib/setup-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-log.js","sourceRoot":"","sources":["../../src/lib/setup-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAOvC;0FAC0F;AAC1F,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,cAAc,CAAC,IAAI,EAAE,uBAAuB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9E,OAAO;QACL,IAAI;QACJ,IAAI,CAAC,CAAS;YACZ,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/status.d.ts

@@ -0,0 +1,27 @@
+export interface MeshStatus {
+    reachable: boolean;
+    server: string;
+    space: string;
+    auth: boolean;
+}
+/** The space this folder operates on: its `.cotal/auth` space if set up, else the default.
+ *  A folder has exactly one space (its auth) — commands resolve it through here so they always
+ *  match the folder's mesh instead of assuming the global default. */
+export declare function resolveSpace(cwd: string): string;
+/** Cheap, connectionless-ish snapshot of the mesh for this folder: is a server up,
+ *  and what space/auth does the local `.cotal/` describe (found by walking up from `cwd`). */
+export declare function meshStatus(cwd: string): Promise<MeshStatus>;
+export interface MachineStatus {
+    nats: "path" | "bundled" | "missing";
+    claudePlugin: boolean;
+    agents: {
+        claude: boolean;
+        opencode: boolean;
+    };
+}
+/** Machine-level readiness: the once-per-machine setup pieces. */
+export declare function machineStatus(): Promise<MachineStatus>;
+export declare function onPath(bin: string): boolean;
+/** True once the machine-level setup has completed at least once. */
+export declare function hasLocalMesh(cwd: string): boolean;
+//# sourceMappingURL=status.d.ts.map

package/dist/lib/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/lib/status.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;sEAEsE;AACtE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;8FAC8F;AAC9F,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CASjE;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD;AAED,kEAAkE;AAClE,wBAAsB,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC,CAe5D;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG3C;AAQD,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjD"}

package/dist/lib/status.js

@@ -0,0 +1,57 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { DEFAULT_SERVER, DEFAULT_SPACE, authDir, findCotalRoot, isReachable, loadSpaceAuth } from "@cotal-ai/core";
+import { resolveNatsServer } from "./nats-bin.js";
+/** The space this folder operates on: its `.cotal/auth` space if set up, else the default.
+ *  A folder has exactly one space (its auth) — commands resolve it through here so they always
+ *  match the folder's mesh instead of assuming the global default. */
+export function resolveSpace(cwd) {
+    return loadSpaceAuth(authDir(findCotalRoot(cwd)))?.space ?? DEFAULT_SPACE;
+}
+/** Cheap, connectionless-ish snapshot of the mesh for this folder: is a server up,
+ *  and what space/auth does the local `.cotal/` describe (found by walking up from `cwd`). */
+export async function meshStatus(cwd) {
+    const server = DEFAULT_SERVER;
+    const auth = loadSpaceAuth(authDir(findCotalRoot(cwd)));
+    return {
+        reachable: await isReachable(server),
+        server,
+        space: auth?.space ?? DEFAULT_SPACE,
+        auth: Boolean(auth),
+    };
+}
+/** Machine-level readiness: the once-per-machine setup pieces. */
+export async function machineStatus() {
+    let nats = "missing";
+    try {
+        nats = (await resolveNatsServer()).source;
+    }
+    catch {
+        nats = "missing";
+    }
+    return {
+        nats,
+        claudePlugin: claudePluginInstalled(),
+        agents: {
+            claude: onPath("claude"),
+            opencode: onPath("opencode"),
+        },
+    };
+}
+export function onPath(bin) {
+    const r = spawnSync(bin, ["--version"], { stdio: "ignore" });
+    return !r.error && r.status === 0;
+}
+function claudePluginInstalled() {
+    if (!onPath("claude"))
+        return false;
+    const r = spawnSync("claude", ["plugin", "list"], { encoding: "utf8" });
+    return r.status === 0 && /cotal@cotal-mesh/.test(`${r.stdout ?? ""}${r.stderr ?? ""}`);
+}
+/** True once the machine-level setup has completed at least once. */
+export function hasLocalMesh(cwd) {
+    const root = findCotalRoot(cwd);
+    return existsSync(join(root, ".cotal", "auth", "auth.json")) || existsSync(join(root, ".cotal", "nats"));
+}
+//# sourceMappingURL=status.js.map

package/dist/lib/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/lib/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AASlD;;sEAEsE;AACtE,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,aAAa,CAAC;AAC5E,CAAC;AAED;8FAC8F;AAC9F,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAG,cAAc,CAAC;IAC9B,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxD,OAAO;QACL,SAAS,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC;QACpC,MAAM;QACN,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,aAAa;QACnC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;KACpB,CAAC;AACJ,CAAC;AAQD,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,IAAI,GAA0B,SAAS,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,qBAAqB,EAAE;QACrC,MAAM,EAAE;YACN,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;YACxB,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC;SAC7B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,qBAAqB;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3G,CAAC"}

package/dist/lib/steps.d.ts

@@ -0,0 +1,31 @@
+import type { SetupLog } from "./setup-log.js";
+export interface Step {
+    /** Slug used in the log and the Claude handoff prompt. */
+    name: string;
+    /** Human line shown while the step runs. */
+    title: string;
+    /** One-line plain-language narration shown before the step runs. */
+    explain?: string;
+    /** Ask before running (Y/n); a declined optional step is simply skipped. */
+    optional?: boolean;
+    /** Consent prompt shown (Y/n, default yes) before the step runs on a TTY; a "no"
+     *  skips the step. Non-TTY runs without asking. For steps that change the user's
+     *  system (e.g. installing the Claude Code plugin). */
+    confirm?: string;
+    /** The step draws its own live pane; the runner shows no spinner, just the result line. */
+    live?: boolean;
+    /** Paths/URLs Claude should read when this step fails. */
+    context?: string[];
+    /** Throw to fail; a returned string becomes the detail on the result line. */
+    run(): Promise<string | void>;
+}
+/** Run steps in order with a failure loop per step: offer a Claude handoff, then
+ *  retry / skip / quit. Returns false on abort.
+ *
+ *  `yes` is non-interactive accept-all (agents/CI): optional and `confirm` steps run
+ *  without prompting (so e.g. demo agents are written), and a failure aborts with the
+ *  log path instead of opening the recovery menu/handoff, even on a TTY. */
+export declare function runSteps(steps: Step[], log: SetupLog, opts?: {
+    yes?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=steps.d.ts.map

package/dist/lib/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/lib/steps.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,IAAI;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;2DAEuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8EAA8E;IAC9E,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC/B;AAED;;;;;4EAK4E;AAC5E,wBAAsB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB3G"}

package/dist/lib/steps.js

@@ -0,0 +1,91 @@
+import * as p from "@clack/prompts";
+import { dim } from "./theme.js";
+import { abortIfCancel } from "./cancel.js";
+import { assistAvailable, runHandoff } from "./assist.js";
+/** Run steps in order with a failure loop per step: offer a Claude handoff, then
+ *  retry / skip / quit. Returns false on abort.
+ *
+ *  `yes` is non-interactive accept-all (agents/CI): optional and `confirm` steps run
+ *  without prompting (so e.g. demo agents are written), and a failure aborts with the
+ *  log path instead of opening the recovery menu/handoff, even on a TTY. */
+export async function runSteps(steps, log, opts = {}) {
+    const interactive = process.stdin.isTTY && !opts.yes;
+    for (const step of steps) {
+        if (step.optional && !opts.yes && (!interactive || !(await ask(`${step.title}?`)))) {
+            p.log.info(dim(`skipped: ${step.title}`));
+            log.line(`${step.name}: skipped (declined)`);
+            continue;
+        }
+        // Consent before a system-changing step (interactive only); a "no" skips it.
+        if (step.confirm && interactive && !(await ask(step.confirm))) {
+            p.log.info(dim(`skipped: ${step.title}`));
+            log.line(`${step.name}: skipped (declined consent)`);
+            continue;
+        }
+        if (!(await runOne(step, log, interactive)))
+            return false;
+    }
+    return true;
+}
+async function runOne(step, log, interactive) {
+    for (;;) {
+        if (step.explain)
+            p.log.step(step.explain);
+        const spin = step.live ? undefined : p.spinner();
+        spin?.start(step.title);
+        try {
+            const detail = await step.run();
+            const line = `${step.title}${detail ? dim(` · ${detail}`) : ""}`;
+            if (spin)
+                spin.stop(line);
+            else
+                p.log.success(line);
+            log.line(`${step.name}: ok${detail ? ` · ${detail}` : ""}`);
+            return true;
+        }
+        catch (e) {
+            const err = e;
+            if (spin)
+                spin.stop(`${step.title}: failed`);
+            p.log.error(err.message);
+            log.line(`${step.name}: FAILED · ${err.message}`);
+            // Non-interactive (CI, piped, or --yes): no recovery loop; abort with the log path.
+            if (!interactive) {
+                p.log.message(dim(`See ${log.path}`));
+                return false;
+            }
+            const choice = await failureMenu(step);
+            if (choice === "debug") {
+                await runHandoff({ step: step.name, error: err, context: step.context ?? [], logPath: log.path });
+                continue;
+            }
+            if (choice === "retry")
+                continue;
+            if (choice === "skip") {
+                if (!step.optional) {
+                    p.log.warn(`Setup can't continue without "${step.title}". Fix it and re-run: cotal setup`);
+                    return false;
+                }
+                log.line(`${step.name}: skipped (after failure)`);
+                return true;
+            }
+            return false; // quit
+        }
+    }
+}
+async function failureMenu(step) {
+    const options = [{ value: "retry", label: "Retry this step" }];
+    if (assistAvailable())
+        options.push({ value: "debug", label: "Debug it with Claude" });
+    options.push({ value: "skip", label: step.optional ? "Skip it" : "Skip (may abort)" });
+    options.push({ value: "quit", label: "Quit setup" });
+    const choice = await p.select({ message: "What now?", options });
+    if (p.isCancel(choice))
+        return "quit";
+    return choice;
+}
+async function ask(message) {
+    // A real "No" returns false (skip the step); Ctrl-C aborts setup.
+    return abortIfCancel(await p.confirm({ message, initialValue: true }));
+}
+//# sourceMappingURL=steps.js.map

package/dist/lib/steps.js.map

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

package/dist/lib/theme.d.ts

@@ -0,0 +1,18 @@
+export declare const brand: (s: string) => string;
+export declare const brandBold: (s: string) => string;
+export declare const ok: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const bold: (s: string) => string;
+/** Multi-line strings get colored line-by-line so the SGR reset doesn't bleed across
+ *  clack's `│` gutter prefix. Used as the `format` callback for `note()` bodies. */
+export declare const brandBody: (s: string) => string;
+/** Elapsed-time suffix for spinners: `47s` under a minute, `2m 34s` above. */
+export declare function fmtDuration(ms: number): string;
+/** Truncate to the terminal width (minus a gutter) so live-pane lines never wrap. */
+export declare function fit(s: string, gutter?: number): string;
+/** A branded `p.note` (body in brand color). */
+export declare function note(message: string, title?: string): void;
+/** First-run splash: brand wordmark + tagline + rule. No-op detail when ANSI is off
+ *  still prints the plain wordmark so piped logs stay legible. */
+export declare function splash(): void;
+//# sourceMappingURL=theme.d.ts.map

package/dist/lib/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/lib/theme.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,WAAkB,CAAC;AAClD,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,WAAwB,CAAC;AAC5D,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,WAAyE,CAAC;AACtG,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,WAA0C,CAAC;AACxE,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,WAA0C,CAAC;AAEzE;oFACoF;AACpF,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,KAAG,MAIvB,CAAC;AAEhB,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,qFAAqF;AACrF,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAGjD;AAED,gDAAgD;AAChD,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAE1D;AASD;kEACkE;AAClE,wBAAgB,MAAM,IAAI,IAAI,CAG7B"}

package/dist/lib/theme.js

@@ -0,0 +1,61 @@
+/**
+ * Cotal brand palette for the terminal setup flow. Colors match the web dashboard
+ * (implementations/cli/src/web/index.html): brand blue #58a6ff, success green #3fb950.
+ *
+ * Rendering gates (same as the rest of the CLI's color story):
+ *   - No TTY (piped/redirected) or NO_COLOR → plain text, no ANSI
+ *   - COLORTERM truecolor/24bit            → 24-bit ANSI (exact brand color)
+ *   - otherwise                            → 16-color fallback
+ */
+import * as p from "@clack/prompts";
+const USE_ANSI = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+const TRUECOLOR = USE_ANSI && (process.env.COLORTERM === "truecolor" || process.env.COLORTERM === "24bit");
+const BRAND = [88, 166, 255]; // #58a6ff
+const GREEN = [63, 185, 80]; // #3fb950
+function rgb([r, g, b], s, bold = false) {
+    if (!USE_ANSI)
+        return s;
+    if (TRUECOLOR)
+        return `\x1b[${bold ? "1;" : ""}38;2;${r};${g};${b}m${s}\x1b[0m`;
+    return `\x1b[${bold ? "1;" : ""}34m${s}\x1b[0m`; // 16-color blue/green fallback
+}
+export const brand = (s) => rgb(BRAND, s);
+export const brandBold = (s) => rgb(BRAND, s, true);
+export const ok = (s) => (USE_ANSI ? (TRUECOLOR ? rgb(GREEN, s) : `\x1b[32m${s}\x1b[0m`) : s);
+export const dim = (s) => (USE_ANSI ? `\x1b[2m${s}\x1b[0m` : s);
+export const bold = (s) => (USE_ANSI ? `\x1b[1m${s}\x1b[0m` : s);
+/** Multi-line strings get colored line-by-line so the SGR reset doesn't bleed across
+ *  clack's `│` gutter prefix. Used as the `format` callback for `note()` bodies. */
+export const brandBody = (s) => s
+    .split("\n")
+    .map((line) => (line.length ? brand(line) : line))
+    .join("\n");
+/** Elapsed-time suffix for spinners: `47s` under a minute, `2m 34s` above. */
+export function fmtDuration(ms) {
+    const total = Math.round(ms / 1000);
+    if (total < 60)
+        return `${total}s`;
+    return `${Math.floor(total / 60)}m ${total % 60}s`;
+}
+/** Truncate to the terminal width (minus a gutter) so live-pane lines never wrap. */
+export function fit(s, gutter = 4) {
+    const width = Math.max(20, (process.stdout.columns ?? 80) - gutter);
+    return s.length > width ? `${s.slice(0, width - 1)}…` : s;
+}
+/** A branded `p.note` (body in brand color). */
+export function note(message, title) {
+    p.note(message, title, { format: brandBody });
+}
+const WORDMARK = String.raw `
+            _        _
+   ___ ___ | |_ __ _| |
+  / __/ _ \| __/ _` + "`" + String.raw `| |
+ | (_| (_) | || (_| | |
+  \___\___/ \__\__,_|_|`;
+/** First-run splash: brand wordmark + tagline + rule. No-op detail when ANSI is off
+ *  still prints the plain wordmark so piped logs stay legible. */
+export function splash() {
+    const rule = "─".repeat(Math.min(44, (process.stdout.columns ?? 80) - 2));
+    process.stdout.write(`${brand(WORDMARK)}\n\n   ${dim("the web for agents")}\n  ${brand(rule)}\n\n`);
+}
+//# sourceMappingURL=theme.js.map