@shield-agent/kya 0.1.36 → 0.1.38

package/dist/commands/start.js

@@ -5,8 +5,10 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { runInit } from "./init.js";
-import { runReceipt } from "./receipt.js";
+import { openPath, runReceipt } from "./receipt.js";
+import { ensureReceiptDaemon } from "../receipt/daemon.js";
 import { appendTrail, defaultSessionId } from "../trail.js";
+import { hostReload, hostRunning, listProcessNames, reloadMessage } from "../host-reload.js";
 function cliJsPath() {
     // start.ts → ../cli.js in dist; when running from dist/commands/start.js
     return fileURLToPath(new URL("../cli.js", import.meta.url));
@@ -82,21 +84,37 @@ export async function runStart(config, input = {}) {
     }
     seedTrailIfEmpty(config.cwd);
     let liveUrl;
-    let keepAlive;
+    let reportPid;
+    let reportReused;
     if (open) {
-        const receipt = await runReceipt(config, { open: true, days: 3 });
-        liveUrl = receipt.liveUrl;
-        keepAlive = receipt.keepAlive;
+        // Static artifacts first, then the live report as a detached background
+        // server so the user gets their terminal back.
+        await runReceipt(config, { open: false, days: 3 });
+        const daemon = await ensureReceiptDaemon(config, { days: 3 });
+        liveUrl = daemon.url;
+        reportPid = daemon.pid;
+        reportReused = daemon.reused;
+        openPath(daemon.url);
     }
+    // start wires the configs Claude Code (.mcp.json / mcp.json) and Cursor
+    // (.cursor/mcp.json) read — the reload note is per-host, not a blanket
+    // "restart everything".
+    const procs = input.procs ?? listProcessNames();
+    const hostNotes = ["cursor", "claude"]
+        .map((id) => hostReload(id))
+        .filter((info) => Boolean(info))
+        .map((info) => reloadMessage(info, info.id === "claude" ? "Claude Code" : "Cursor", hostRunning(info, procs)))
+        .join(" ");
     return {
         initCreated: init.created,
         wired,
         skipped,
         liveUrl,
-        keepAlive,
-        next: "Restart Cursor / Claude Code / Codex so shield-kya MCP loads. " +
-            "Then use wrap/evaluate tools — this report updates live. " +
-            "Ctrl+C stops the report server.",
+        reportPid,
+        reportReused,
+        next: `${hostNotes} ` +
+            "The report runs in the background — reopen with `kya receipt --open`, " +
+            "stop with `kya stop`.",
     };
 }
 export function formatStartHuman(r) {

package/dist/commands/start.js.map

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

package/dist/commands/stop.d.ts

@@ -0,0 +1,7 @@
+export interface StopResult {
+    readonly stopped: boolean;
+    readonly pid?: number;
+}
+export declare function runStop(cwd: string): Promise<StopResult>;
+export declare function formatStopHuman(r: StopResult): string;
+//# sourceMappingURL=stop.d.ts.map

package/dist/commands/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAe9D;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAIrD"}

package/dist/commands/stop.js

@@ -0,0 +1,31 @@
+/**
+ * `kya stop` — stop the background live-receipt server started by `kya start`.
+ */
+import { clearDaemonState, pidAlive, readDaemonState, } from "../receipt/daemon.js";
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function runStop(cwd) {
+    const state = readDaemonState(cwd);
+    if (!state)
+        return { stopped: false };
+    if (pidAlive(state.pid)) {
+        try {
+            process.kill(state.pid, "SIGTERM");
+        }
+        catch {
+            /* raced exit */
+        }
+        for (let waited = 0; waited < 3_000 && pidAlive(state.pid); waited += 100) {
+            await sleep(100);
+        }
+    }
+    clearDaemonState(cwd);
+    return { stopped: true, pid: state.pid };
+}
+export function formatStopHuman(r) {
+    return r.stopped
+        ? `stopped report server (pid ${r.pid})`
+        : "no report server running";
+}
+//# sourceMappingURL=stop.js.map

package/dist/commands/stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.js","sourceRoot":"","sources":["../../src/commands/stop.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAO9B,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW;IACvC,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACtC,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;QACD,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,GAAG,EAAE,CAAC;YAC1E,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAa;IAC3C,OAAO,CAAC,CAAC,OAAO;QACd,CAAC,CAAC,8BAA8B,CAAC,CAAC,GAAG,GAAG;QACxC,CAAC,CAAC,0BAA0B,CAAC;AACjC,CAAC"}

package/dist/host-reload.d.ts

@@ -0,0 +1,19 @@
+export type ReloadClass = "auto" | "session" | "restart";
+export interface HostReload {
+    readonly id: string;
+    readonly reload: ReloadClass;
+    /** One-line mechanism note, shown verbatim to users. */
+    readonly detail: string;
+    /** Process-name fragments (basename, lowercase) for running detection. */
+    readonly processNames: readonly string[];
+    /** Context-preserving relaunch tip, when the host has one. */
+    readonly resumeTip?: string;
+}
+export declare const HOST_RELOAD: Readonly<Record<string, HostReload>>;
+export declare function hostReload(id: string): HostReload | undefined;
+/** Basenames of running processes (lowercase). POSIX ps; empty on failure. */
+export declare function listProcessNames(platform?: NodeJS.Platform): ReadonlySet<string>;
+export declare function hostRunning(info: HostReload, procs: ReadonlySet<string>): boolean;
+/** Human next-step line for a just-wired host, accurate about restarts. */
+export declare function reloadMessage(info: HostReload, label: string, running: boolean): string;
+//# sourceMappingURL=host-reload.d.ts.map

package/dist/host-reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-reload.d.ts","sourceRoot":"","sources":["../src/host-reload.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CA4F5D,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7D;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,WAAW,CAAC,MAAM,CAAC,CA2BlG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAEjF;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAavF"}

package/dist/host-reload.js

@@ -0,0 +1,155 @@
+/**
+ * Per-host MCP reload behavior — researched against official docs, 2026-09.
+ * The blanket "restart your host" instruction was wrong for most hosts: many
+ * watch their config file (or offer an in-session reload) and pick up a new
+ * server with no restart at all. Messaging in `connect` / `start` is built
+ * from this table, and docs/hosts/<id>.md pages mirror it.
+ *
+ * Classes:
+ *   auto    — new server is picked up in the running host (file watcher or
+ *             in-session refresh; detail says which)
+ *   session — loads in the next session/conversation; app stays open
+ *   restart — process must be relaunched (resumeTip preserves context if any)
+ */
+import { execFileSync } from "node:child_process";
+export const HOST_RELOAD = {
+    cursor: {
+        id: "cursor",
+        reload: "auto",
+        detail: "Cursor watches mcp.json and starts new stdio servers on its own",
+        processNames: ["cursor", "cursor-agent"],
+    },
+    kiro: {
+        id: "kiro",
+        reload: "auto",
+        detail: "Kiro hot-reloads mcp.json on save — only the new server starts",
+        processNames: ["kiro", "kiro-cli"],
+    },
+    qwen: {
+        id: "qwen",
+        reload: "auto",
+        detail: "Qwen Code live-reconciles MCP servers when settings.json changes",
+        processNames: ["qwen"],
+    },
+    amp: {
+        id: "amp",
+        reload: "auto",
+        detail: "Amp applies settings.json changes live (workspace entries need one approval)",
+        processNames: ["amp"],
+    },
+    droid: {
+        id: "droid",
+        reload: "auto",
+        detail: "Droid reloads automatically when mcp.json changes",
+        processNames: ["droid"],
+    },
+    cline: {
+        id: "cline",
+        reload: "auto",
+        detail: "Cline watches cline_mcp_settings.json and connects new servers on save",
+        processNames: ["code", "code-insiders"],
+    },
+    grok: {
+        id: "grok",
+        reload: "auto",
+        detail: "in a running Grok session press r in /mcps to refresh after config edits",
+        processNames: ["grok"],
+    },
+    mastracode: {
+        id: "mastracode",
+        reload: "auto",
+        detail: "in a running MastraCode session run /mcp to reload connections",
+        processNames: ["mastracode"],
+    },
+    kimi: {
+        id: "kimi",
+        reload: "session",
+        detail: "Kimi Code registers MCP servers at session start — a new session is enough",
+        processNames: ["kimi"],
+    },
+    claude: {
+        id: "claude",
+        reload: "restart",
+        detail: "Claude Code loads MCP servers at process start",
+        processNames: ["claude"],
+        resumeTip: "claude --resume keeps the conversation",
+    },
+    codex: {
+        id: "codex",
+        reload: "restart",
+        detail: "Codex loads MCP servers at process start",
+        processNames: ["codex"],
+    },
+    gemini: {
+        id: "gemini",
+        reload: "restart",
+        detail: "Gemini CLI reads mcpServers once at startup (marked requiresRestart)",
+        processNames: ["gemini"],
+    },
+    copilot: {
+        id: "copilot",
+        reload: "restart",
+        detail: "Copilot CLI loads MCP servers at startup",
+        processNames: ["copilot"],
+    },
+    opencode: {
+        id: "opencode",
+        reload: "restart",
+        detail: "OpenCode connects MCP servers once at startup (hot-reload lands in v2)",
+        processNames: ["opencode"],
+    },
+    kilo: {
+        id: "kilo",
+        reload: "restart",
+        detail: "Kilo Code CLI reads kilo.json at startup (the VS Code extension hot-reloads instead)",
+        processNames: ["kilo"],
+    },
+};
+export function hostReload(id) {
+    return HOST_RELOAD[id];
+}
+/** Basenames of running processes (lowercase). POSIX ps; empty on failure. */
+export function listProcessNames(platform = process.platform) {
+    try {
+        if (platform === "win32") {
+            const out = execFileSync("tasklist", ["/fo", "csv", "/nh"], {
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+            return new Set(out
+                .split("\n")
+                .map((line) => line.split('","')[0]?.replace(/^"|"$/g, "").toLowerCase())
+                .filter((name) => Boolean(name)));
+        }
+        const out = execFileSync("ps", ["-axo", "comm="], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return new Set(out
+            .split("\n")
+            .map((line) => line.trim().split("/").pop()?.toLowerCase())
+            .filter((name) => Boolean(name)));
+    }
+    catch {
+        return new Set();
+    }
+}
+export function hostRunning(info, procs) {
+    return info.processNames.some((name) => procs.has(name));
+}
+/** Human next-step line for a just-wired host, accurate about restarts. */
+export function reloadMessage(info, label, running) {
+    switch (info.reload) {
+        case "auto":
+            return `No restart needed — ${info.detail}.`;
+        case "session":
+            return running
+                ? `${label} is running — start a new session to load shield-kya (${info.detail}). No app restart.`
+                : `shield-kya loads in your next ${label} session — no restart needed.`;
+        case "restart":
+            return running
+                ? `${label} is running — relaunch it to load shield-kya (${info.detail}${info.resumeTip ? `; ${info.resumeTip}` : ""}).`
+                : `shield-kya loads when you next start ${label} — it is not running, so nothing to restart.`;
+    }
+}
+//# sourceMappingURL=host-reload.js.map

package/dist/host-reload.js.map

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

package/dist/node-upgrade.d.ts

@@ -0,0 +1,30 @@
+export declare const REQUIRED_NODE_MAJOR = 24;
+export type NodeManager = "volta" | "fnm" | "nvm" | "brew";
+export interface NodeGateDeps {
+    readonly version?: string;
+    readonly platform?: NodeJS.Platform;
+    readonly hasCmd?: (cmd: string) => boolean;
+    readonly hasFile?: (path: string) => boolean;
+    readonly run?: (shell: string, args: readonly string[]) => Promise<number>;
+}
+export declare function currentNodeMajor(version?: string): number;
+export declare function nodeSatisfied(version?: string): boolean;
+/** Priority: dedicated managers first, brew last (shared global prefix). */
+export declare function detectNodeManager(env: NodeJS.ProcessEnv, deps?: NodeGateDeps): NodeManager | undefined;
+/** Shell script that installs Node 24, reinstalls the CLI, and re-runs argv. */
+export declare function buildUpgradeScript(manager: NodeManager, env: NodeJS.ProcessEnv, argv: readonly string[]): {
+    shell: string;
+    args: readonly string[];
+};
+export interface NodeGateIo {
+    readonly error: (msg: string) => void;
+    readonly isTty?: boolean;
+    readonly confirm?: (question: string) => Promise<boolean>;
+}
+/**
+ * Returns an exit code when the upgrade ran and the original command was
+ * handed off to the new Node; undefined when the current process should
+ * continue normally.
+ */
+export declare function ensureSupportedNode(io: NodeGateIo, env: NodeJS.ProcessEnv, argv: readonly string[], command: string | undefined, deps?: NodeGateDeps): Promise<number | undefined>;
+//# sourceMappingURL=node-upgrade.d.ts.map

package/dist/node-upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-upgrade.d.ts","sourceRoot":"","sources":["../src/node-upgrade.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAwB,GAAG,MAAM,CAG1E;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAwB,GAAG,OAAO,CAExE;AAkBD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,GAAE,YAAiB,GACtB,WAAW,GAAG,SAAS,CASzB;AASD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CA8B5C;AAoBD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,UAAU,EACd,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4B7B"}

package/dist/node-upgrade.js

@@ -0,0 +1,140 @@
+/**
+ * Node version gate with a guided upgrade. The package declares
+ * `engines.node: >=24`; on an older runtime the CLI warns, and on a TTY it
+ * offers to install Node 24 via the detected version manager, reinstall the
+ * global package under it, and re-run the original command. Declining (or a
+ * non-TTY run) continues with a warning — the gate never blocks outright.
+ *
+ * Escape hatches: KYA_SKIP_NODE_CHECK=1 skips entirely; KYA_NODE_CHECKED=1 is
+ * set by the upgrade re-exec and by the receipt daemon child so the check
+ * never loops.
+ */
+import { existsSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+export const REQUIRED_NODE_MAJOR = 24;
+export function currentNodeMajor(version = process.version) {
+    const match = /^v?(\d+)/.exec(version);
+    return match ? Number.parseInt(match[1], 10) : 0;
+}
+export function nodeSatisfied(version = process.version) {
+    return currentNodeMajor(version) >= REQUIRED_NODE_MAJOR;
+}
+function defaultHasCmd(cmd) {
+    const pathEnv = process.env.PATH ?? "";
+    const exts = process.platform === "win32" ? [".cmd", ".exe", ".bat", ""] : [""];
+    for (const dir of pathEnv.split(process.platform === "win32" ? ";" : ":")) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            if (existsSync(join(dir, cmd + ext)))
+                return true;
+        }
+    }
+    return false;
+}
+function nvmScriptPath(env) {
+    return join(env.NVM_DIR ?? join(env.HOME ?? "", ".nvm"), "nvm.sh");
+}
+/** Priority: dedicated managers first, brew last (shared global prefix). */
+export function detectNodeManager(env, deps = {}) {
+    const hasCmd = deps.hasCmd ?? defaultHasCmd;
+    const hasFile = deps.hasFile ?? existsSync;
+    const platform = deps.platform ?? process.platform;
+    if (hasCmd("volta"))
+        return "volta";
+    if (hasCmd("fnm"))
+        return "fnm";
+    if (platform !== "win32" && hasFile(nvmScriptPath(env)))
+        return "nvm";
+    if (platform !== "win32" && hasCmd("brew"))
+        return "brew";
+    return undefined;
+}
+function rerunTail(argv) {
+    // --force on start so MCP blocks are rewritten to the new node's execPath.
+    const needsForce = argv[0] === "start" && !argv.includes("--force");
+    const args = [...argv, ...(needsForce ? ["--force"] : [])];
+    return `npm i -g @shield-agent/kya@latest && KYA_NODE_CHECKED=1 kya ${args.join(" ")}`;
+}
+/** Shell script that installs Node 24, reinstalls the CLI, and re-runs argv. */
+export function buildUpgradeScript(manager, env, argv) {
+    const tail = rerunTail(argv);
+    const platform = process.platform;
+    if (platform === "win32") {
+        // Only volta/fnm are supported on Windows; && chaining works in cmd.
+        const install = manager === "volta" ? "volta install node@24" : "fnm install 24 && fnm default 24";
+        return { shell: "cmd", args: ["/c", `${install} && ${tail}`] };
+    }
+    const lines = ["set -e"];
+    switch (manager) {
+        case "volta":
+            lines.push("volta install node@24");
+            break;
+        case "fnm":
+            lines.push("fnm install 24", "fnm default 24", 'eval "$(fnm env --shell bash)"');
+            break;
+        case "nvm":
+            lines.push(`export NVM_DIR="${env.NVM_DIR ?? "$HOME/.nvm"}"`, '. "$NVM_DIR/nvm.sh"', "nvm install 24", "nvm alias default 24");
+            break;
+        case "brew":
+            lines.push("brew install node || brew upgrade node");
+            break;
+    }
+    lines.push(tail);
+    return { shell: "bash", args: ["-c", lines.join("\n")] };
+}
+async function defaultRun(shell, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(shell, [...args], { stdio: "inherit" });
+        child.on("error", reject);
+        child.on("close", (code) => resolve(code ?? 1));
+    });
+}
+function defaultConfirm(question) {
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(`${question} `, (answer) => {
+            rl.close();
+            resolve(!/^n(o)?$/i.test(answer.trim()));
+        });
+    });
+}
+const SKIP_COMMANDS = new Set(["help", "serve-mcp", "receipt-serve"]);
+/**
+ * Returns an exit code when the upgrade ran and the original command was
+ * handed off to the new Node; undefined when the current process should
+ * continue normally.
+ */
+export async function ensureSupportedNode(io, env, argv, command, deps = {}) {
+    if (!command || SKIP_COMMANDS.has(command))
+        return undefined;
+    if (env.KYA_SKIP_NODE_CHECK === "1" || env.KYA_NODE_CHECKED === "1")
+        return undefined;
+    const version = deps.version ?? process.version;
+    if (nodeSatisfied(version))
+        return undefined;
+    const warn = `KYA needs Node.js ${REQUIRED_NODE_MAJOR}+ (you have ${version}).`;
+    const isTty = io.isTty ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    const confirm = io.confirm ?? defaultConfirm;
+    if (!isTty) {
+        io.error(`${warn} Continuing anyway — some features may break.`);
+        return undefined;
+    }
+    const manager = detectNodeManager(env, deps);
+    const question = manager
+        ? `${warn} Upgrade to Node 24 via ${manager} now and continue? [Y/n]`
+        : `${warn} No version manager found (nodejs.org/en/download). Continue anyway? [Y/n]`;
+    const ok = await confirm(question);
+    if (!ok) {
+        io.error("Continuing on an unsupported Node — some features may break.");
+        return undefined;
+    }
+    if (!manager)
+        return undefined;
+    const script = buildUpgradeScript(manager, env, argv);
+    const run = deps.run ?? defaultRun;
+    return run(script.shell, script.args);
+}
+//# sourceMappingURL=node-upgrade.js.map

package/dist/node-upgrade.js.map

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

package/dist/receipt/daemon.d.ts

@@ -0,0 +1,29 @@
+import { type ResolvedConfig } from "../config.js";
+export interface ReceiptDaemonState {
+    readonly pid: number;
+    readonly url: string;
+    readonly token: string;
+    readonly port: number;
+    readonly startedAt: string;
+}
+export interface ReceiptDaemonHandle {
+    readonly url: string;
+    readonly pid: number;
+    readonly reused: boolean;
+}
+export declare function daemonStatePath(cwd: string): string;
+export declare function daemonLogPath(cwd: string): string;
+export declare function readDaemonState(cwd: string): ReceiptDaemonState | undefined;
+export declare function writeDaemonState(cwd: string, state: ReceiptDaemonState): void;
+export declare function clearDaemonState(cwd: string): void;
+export declare function pidAlive(pid: number): boolean;
+/**
+ * Reuse the running daemon when its pid is alive; otherwise spawn a fresh
+ * detached one and wait for it to publish its state file.
+ */
+export declare function ensureReceiptDaemon(config: ResolvedConfig, input: {
+    days: number;
+    sessionId?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<ReceiptDaemonHandle>;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/receipt/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/receipt/daemon.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAiB3E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAM7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAS7C;AAWD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACnE,OAAO,CAAC,mBAAmB,CAAC,CAqC9B"}

package/dist/receipt/daemon.js

@@ -0,0 +1,107 @@
+/**
+ * Background live-receipt daemon: `kya start` spawns it detached and returns
+ * to the terminal. State (pid, url, token) lives in `.kya/receipt-server.json`
+ * (mode 0600 — it carries the loopback auth token); stdout/stderr go to
+ * `.kya/receipt-server.log`. The daemon child is the hidden `receipt-serve`
+ * command, which writes the state file once it is listening and removes it on
+ * shutdown.
+ */
+import { existsSync, mkdirSync, openSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { configDir } from "../config.js";
+import { KyaError } from "../errors.js";
+export function daemonStatePath(cwd) {
+    return join(configDir(cwd), "receipt-server.json");
+}
+export function daemonLogPath(cwd) {
+    return join(configDir(cwd), "receipt-server.log");
+}
+export function readDaemonState(cwd) {
+    const path = daemonStatePath(cwd);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        const raw = JSON.parse(readFileSync(path, "utf8"));
+        if (typeof raw.pid === "number" &&
+            typeof raw.url === "string" &&
+            typeof raw.token === "string" &&
+            typeof raw.port === "number") {
+            return raw;
+        }
+    }
+    catch {
+        /* corrupt state — treat as absent */
+    }
+    return undefined;
+}
+export function writeDaemonState(cwd, state) {
+    mkdirSync(configDir(cwd), { recursive: true });
+    writeFileSync(daemonStatePath(cwd), `${JSON.stringify(state, null, 2)}\n`, {
+        encoding: "utf8",
+        mode: 0o600,
+    });
+}
+export function clearDaemonState(cwd) {
+    rmSync(daemonStatePath(cwd), { force: true });
+}
+export function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM: process exists but owned by someone else — still alive.
+        return err.code === "EPERM";
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function cliJsPath() {
+    // dist/receipt/daemon.js → dist/cli.js
+    return fileURLToPath(new URL("../cli.js", import.meta.url));
+}
+/**
+ * Reuse the running daemon when its pid is alive; otherwise spawn a fresh
+ * detached one and wait for it to publish its state file.
+ */
+export async function ensureReceiptDaemon(config, input) {
+    const existing = readDaemonState(config.cwd);
+    if (existing && pidAlive(existing.pid)) {
+        return { url: existing.url, pid: existing.pid, reused: true };
+    }
+    clearDaemonState(config.cwd);
+    mkdirSync(configDir(config.cwd), { recursive: true });
+    const logFd = openSync(daemonLogPath(config.cwd), "a");
+    const args = [cliJsPath(), "receipt-serve", "--days", String(input.days)];
+    if (input.sessionId)
+        args.push("--session", input.sessionId);
+    const child = spawn(process.execPath, args, {
+        cwd: config.cwd,
+        detached: true,
+        stdio: ["ignore", logFd, logFd],
+        env: {
+            ...process.env,
+            ...input.env,
+            KYA_NO_BROWSER: "1",
+            KYA_NODE_CHECKED: "1",
+        },
+    });
+    child.unref();
+    const pid = child.pid ?? -1;
+    for (let waited = 0; waited < 10_000; waited += 100) {
+        const state = readDaemonState(config.cwd);
+        if (state && state.pid === pid && pidAlive(pid)) {
+            return { url: state.url, pid, reused: false };
+        }
+        if (child.exitCode !== null)
+            break;
+        await sleep(100);
+    }
+    throw new KyaError(`receipt server failed to start — see ${daemonLogPath(config.cwd)}`, "RECEIPT_DAEMON_FAILED");
+}
+//# sourceMappingURL=daemon.js.map