claude-code-infinite 1.0.25 → 1.0.27

package/dist/claude-locate.js

@@ -0,0 +1,303 @@
+/**
+ * Finding Claude Code to launch, however it was installed.
+ *
+ * ccc launches `claude` through cross-spawn, which finds it on PATH (with
+ * PATHEXT on Windows, so npm's `claude.cmd` shim and the native `claude.exe`
+ * both run). What it cannot do is find a Claude Code that is installed but not
+ * on this terminal's PATH. On Windows that is the common case: the native
+ * installer puts `claude.exe` in `%USERPROFILE%\.local\bin` and may only ask
+ * the user to add it to PATH, winget links it under
+ * `%LOCALAPPDATA%\Microsoft\WinGet\Links`, and any installer that does update
+ * the user's PATH (in the registry) leaves terminals already open without it.
+ * So after PATH this looks in the user's and machine's registry PATH, then in
+ * each installer's own location. On macOS and Linux it checks the native
+ * installer's `~/.local/bin`, the legacy `~/.claude/local` and Homebrew.
+ *
+ * Only paths are probed; nothing is run except `reg query` on Windows, and
+ * only when PATH has no `claude`.
+ */
+import { spawnSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+/** Where Claude Code was found, for diagnostics (an enum, never a path). */
+export const CLAUDE_SOURCES = [
+    "path", "registry-path", "native", "npm", "winget", "homebrew", "legacy-local",
+];
+/** `claude_found` in diagnostics: a source, or `desktop_only` (only the desktop app is installed). */
+export const CLAUDE_FOUND = [...CLAUDE_SOURCES, "desktop_only"];
+/** Claude Code to launch, or null when it is not installed anywhere known. */
+export function locateClaude(opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const env = opts.env ?? process.env;
+    const isExecutable = opts.isExecutable ?? defaultIsExecutable(platform);
+    const onPath = locateOnPath(pathDirs(env, platform), platform, env, isExecutable);
+    if (onPath)
+        return onPath;
+    const home = opts.homedir ?? os.homedir();
+    for (const candidate of candidates(platform, env, home, opts)) {
+        const file = candidate.dirs
+            .map((dir) => findOnPath("claude", [dir], platform, env, isExecutable))
+            .find((f) => f !== null && !isDesktopAppExe(f, platform));
+        if (file)
+            return { command: file, source: candidate.source, dir: pathFor(platform).dirname(file) };
+    }
+    return null;
+}
+/** The child's environment with `location.dir` first on PATH, when it was not on PATH. */
+export function withClaudeOnPath(env, location, platform = process.platform) {
+    if (!location.dir)
+        return env;
+    const key = pathKey(env, platform);
+    const current = env[key];
+    const delimiter = platform === "win32" ? ";" : ":";
+    return { ...env, [key]: current ? `${location.dir}${delimiter}${current}` : location.dir };
+}
+/**
+ * Whether the Claude desktop app is installed (Windows, macOS). It runs Claude
+ * Code inside the app (its own copy, in the app's data folder, kept at the
+ * app's version), but puts no `claude` on the terminal's PATH, so ccc cannot
+ * use it. Only its own folders count, never `~/.claude`, which the CLI shares.
+ */
+export function claudeDesktopInstalled(opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const env = opts.env ?? process.env;
+    const home = opts.homedir ?? os.homedir();
+    const exists = opts.exists ?? fs.existsSync;
+    return desktopAppPaths(platform, env, home).some((p) => exists(p));
+}
+/** Said instead of claudeMissingText when only the desktop app is installed. */
+export function claudeDesktopOnlyText(platform = process.platform) {
+    const install = platform === "win32"
+        ? "`irm https://claude.ai/install.ps1 | iex` (in PowerShell)"
+        : "`curl -fsSL https://claude.ai/install.sh | bash`";
+    return "Found the Claude desktop app, but ccc needs Claude Code in the terminal: " +
+        `install it with ${install}, then open a new terminal and run \`claude\` once to sign in.`;
+}
+/**
+ * Said once, instead of launching, when Claude Code is not installed: the
+ * official install command for this OS and the sign-in step.
+ */
+export function claudeMissingText(platform = process.platform) {
+    const install = platform === "win32"
+        ? "  irm https://claude.ai/install.ps1 | iex      (in PowerShell)"
+        : "  curl -fsSL https://claude.ai/install.sh | bash";
+    return [
+        "Claude Code isn't installed. ccc runs Claude Code, so install it first:",
+        install,
+        "then open a new terminal, run `claude` once to sign in, and run ccc again.",
+    ].join("\n");
+}
+/**
+ * One line, not blocking, when ccc starts somewhere that is not a project:
+ * C:\Windows\System32 (where an admin terminal opens) or the home folder.
+ */
+export function cwdHintText(cwd, opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    const env = opts.env ?? process.env;
+    const p = pathFor(platform);
+    const same = (a, b) => {
+        const norm = (s) => p.resolve(s).replace(/[\\/]+$/, "");
+        return platform === "win32" || platform === "darwin"
+            ? norm(a).toLowerCase() === norm(b).toLowerCase()
+            : norm(a) === norm(b);
+    };
+    const home = opts.homedir ?? os.homedir();
+    let where = null;
+    if (platform === "win32") {
+        const windows = env.SystemRoot || env.windir || "C:\\Windows";
+        if (["System32", "SysWOW64"].some((d) => same(cwd, p.join(windows, d))))
+            where = cwd;
+    }
+    if (where === null && home && same(cwd, home))
+        where = "your home folder";
+    if (where === null)
+        return null;
+    return `Tip: ccc is running in ${where}. Run it from your project folder (cd into it, then ccc) ` +
+        "so Claude Code works on that project.";
+}
+function candidates(platform, env, home, opts) {
+    if (platform === "win32")
+        return windowsCandidates(env, home, opts);
+    const p = path.posix;
+    return [
+        { source: "native", dirs: [p.join(home, ".local", "bin")] },
+        { source: "legacy-local", dirs: [p.join(home, ".claude", "local")] },
+        { source: "homebrew", dirs: ["/opt/homebrew/bin", "/usr/local/bin", "/home/linuxbrew/.linuxbrew/bin"] },
+        { source: "npm", dirs: [p.join(home, ".npm-global", "bin")] },
+    ];
+}
+function windowsCandidates(env, home, opts) {
+    const w = path.win32;
+    const profile = envValue(env, "USERPROFILE") || home;
+    const appData = envValue(env, "APPDATA") || w.join(profile, "AppData", "Roaming");
+    const localAppData = envValue(env, "LOCALAPPDATA") || w.join(profile, "AppData", "Local");
+    const winget = w.join(localAppData, "Microsoft", "WinGet");
+    // The installers' own folders first (cheap stats); the registry (two spawns) last.
+    return [
+        { source: "native", dirs: [w.join(profile, ".local", "bin")] },
+        { source: "npm", dirs: [w.join(appData, "npm")] },
+        { source: "winget", dirs: [w.join(winget, "Links"), ...wingetPackageDirs(winget, opts)] },
+        { source: "registry-path", get dirs() { return registryDirs(env, opts); } },
+    ];
+}
+/** The desktop app's install and data folders (Squirrel, Microsoft Store/MSIX, macOS). */
+function desktopAppPaths(platform, env, home) {
+    if (platform === "darwin") {
+        return ["/Applications/Claude.app", path.posix.join(home, "Applications", "Claude.app")];
+    }
+    if (platform !== "win32")
+        return [];
+    const w = path.win32;
+    const profile = envValue(env, "USERPROFILE") || home;
+    const localAppData = envValue(env, "LOCALAPPDATA") || w.join(profile, "AppData", "Local");
+    // Not %APPDATA%\Claude: MCP guides have people create it by hand.
+    return [
+        w.join(localAppData, "AnthropicClaude"),
+        w.join(localAppData, "Packages", DESKTOP_MSIX_FAMILY),
+    ];
+}
+/** The Microsoft Store / MSIX package family of the Claude desktop app. */
+const DESKTOP_MSIX_FAMILY = "Claude_pzs8sxrjxfjjc";
+/**
+ * The desktop app's own `claude.exe` (Squirrel: %LOCALAPPDATA%\AnthropicClaude
+ * and its app-<version> folders; MSIX: WindowsApps\Claude_<version>_<arch>__<id>).
+ * Launched as Claude Code it opens the app instead, so it is skipped. So is a
+ * Store app execution alias (%LOCALAPPDATA%\Microsoft\WindowsApps): none of the
+ * CLI's installers puts claude.exe there.
+ */
+function isDesktopAppExe(file, platform) {
+    if (platform !== "win32")
+        return false;
+    const dir = path.win32.dirname(file).toLowerCase();
+    return /\\anthropicclaude(\\app-[^\\]+)?$/.test(dir) ||
+        /\\windowsapps\\claude_[^\\]*__pzs8sxrjxfjjc(\\app)?$/.test(dir) ||
+        /\\microsoft\\windowsapps(\\claude_pzs8sxrjxfjjc)?$/.test(dir);
+}
+/**
+ * `claude` on PATH, skipping the desktop app's exe. Spawned by name when it is
+ * the first `claude` on PATH (as before); by full path when the desktop app's
+ * comes first, since spawning by name would start the app.
+ */
+function locateOnPath(dirs, platform, env, isExecutable) {
+    let skipped = false;
+    for (const dir of dirs) {
+        const file = findOnPath("claude", [dir], platform, env, isExecutable);
+        if (!file)
+            continue;
+        if (isDesktopAppExe(file, platform)) {
+            skipped = true;
+            continue;
+        }
+        if (!skipped)
+            return { command: "claude", source: "path" };
+        return { command: file, source: "path", dir: pathFor(platform).dirname(file) };
+    }
+    return null;
+}
+function registryDirs(env, opts) {
+    return (opts.registryPath ?? (() => readRegistryPath(env)))()
+        .flatMap((value) => splitPath(expandWindowsVars(value, env), "win32"));
+}
+/** winget's own folders for Claude Code (Anthropic.ClaudeCode_<source hash>). */
+function wingetPackageDirs(winget, opts) {
+    const packages = path.win32.join(winget, "Packages");
+    const list = opts.listDir ?? defaultListDir;
+    return list(packages)
+        .filter((name) => /^Anthropic\.ClaudeCode/i.test(name))
+        .map((name) => path.win32.join(packages, name));
+}
+function findOnPath(name, dirs, platform, env, isExecutable) {
+    const p = pathFor(platform);
+    const exts = platform === "win32"
+        ? (envValue(env, "PATHEXT") || ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean)
+        : [""];
+    for (const dir of dirs) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            const file = p.join(dir, name + ext.toLowerCase());
+            if (isExecutable(file))
+                return file;
+        }
+    }
+    return null;
+}
+function pathDirs(env, platform) {
+    return splitPath(env[pathKey(env, platform)] ?? "", platform);
+}
+function splitPath(value, platform) {
+    return value
+        .split(platform === "win32" ? ";" : ":")
+        .map((dir) => dir.trim().replace(/^"(.*)"$/, "$1"))
+        .filter(Boolean);
+}
+/** Windows env names are case-insensitive, but a copied env object is not. */
+function pathKey(env, platform) {
+    if (platform !== "win32")
+        return "PATH";
+    return Object.keys(env).reverse().find((key) => key.toUpperCase() === "PATH") ?? "Path";
+}
+function envValue(env, name) {
+    const key = Object.keys(env).find((k) => k.toUpperCase() === name.toUpperCase());
+    return key === undefined ? undefined : env[key];
+}
+/** `%USERPROFILE%\.local\bin` → its value; unknown names stay as written. */
+export function expandWindowsVars(value, env) {
+    return value.replace(/%([^%;]+)%/g, (whole, name) => envValue(env, name) ?? whole);
+}
+/** The Path values in `reg query` output (REG_SZ or REG_EXPAND_SZ). */
+export function parseRegQueryPath(output) {
+    const m = /^\s*Path\s+REG_(?:EXPAND_)?SZ\s+(.*)$/im.exec(output);
+    return m ? m[1].trim() : null;
+}
+function readRegistryPath(env) {
+    // By full path: PATH is what may be broken here.
+    const root = envValue(env, "SystemRoot") || envValue(env, "windir") || "C:\\Windows";
+    const reg = path.win32.join(root, "System32", "reg.exe");
+    const keys = [
+        "HKCU\\Environment",
+        "HKLM\\SYSTEM\\CurrentControlSet\\Control\\Session Manager\\Environment",
+    ];
+    const out = [];
+    for (const key of keys) {
+        try {
+            const result = spawnSync(reg, ["query", key, "/v", "Path"], {
+                encoding: "utf8", timeout: 2000, windowsHide: true,
+            });
+            const value = result.status === 0 ? parseRegQueryPath(result.stdout ?? "") : null;
+            if (value)
+                out.push(value);
+        }
+        catch {
+            // No reg.exe (or not Windows): nothing more to search.
+        }
+    }
+    return out;
+}
+function pathFor(platform) {
+    return platform === "win32" ? path.win32 : path.posix;
+}
+function defaultIsExecutable(platform) {
+    return (file) => {
+        try {
+            if (!fs.statSync(file).isFile())
+                return false;
+            if (platform !== "win32")
+                fs.accessSync(file, fs.constants.X_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+}
+function defaultListDir(dir) {
+    try {
+        return fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=claude-locate.js.map

package/dist/claude-locate.js.map

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

package/dist/claude-plan-warning.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The "no Claude plan" line. ccc runs the user's own Claude Code, so it only
+ * works well signed in with a Claude Pro or Max plan; on an API key every token
+ * is billed by Anthropic, and a key with no credit is refused outright
+ * (credit_balance_too_low, the most common first-prompt failure). The line is
+ * printed once before Claude Code starts when its sign-in is an API key or
+ * missing, and never for a subscription; the credit refusal gets the same text
+ * as ccc exits (claude-auth.ts creditNoticeText).
+ *
+ * Which sign-in Claude Code really used is only known from its requests'
+ * auth headers (claude-auth.ts claudeAuthFromHeaders). The last one seen is
+ * kept as a type name in ccc's config directory so the next launch decides on
+ * fact rather than on the config files' guess.
+ */
+import type { ClaudeAuthType, ClaudePlan } from "./claude-auth.js";
+export declare const NO_PLAN_TEXT: string;
+/** The file in ccc's config directory holding the last sign-in type Claude Code sent. */
+export declare const SEEN_AUTH_FILE = "claude-auth-seen";
+export interface PlanWarningInput {
+    /** From env and Claude Code's config files (claudeAuthFromConfig). */
+    auth: ClaudeAuthType;
+    /** From Claude Code's config files (claudePlanFromConfig). */
+    plan: ClaudePlan;
+    /** What Claude Code's own requests last showed, when known. */
+    seen?: ClaudeAuthType;
+    /** A claude.ai login is on file (claudeSubscriptionLogin), whatever else is set. */
+    subscriptionLogin?: boolean;
+}
+/**
+ * True when Claude Code is on an API key or not signed in, and nothing shows a
+ * paid plan. Any sign of a subscription wins, a stale API-key sighting
+ * included (the user may have run `/login` outside ccc since), so a subscriber
+ * is never warned.
+ */
+export declare function needsPlanWarning(input: PlanWarningInput): boolean;
+/** `claude --version`, `claude doctor` and the like: no session, so no line. */
+export declare function isInfoOnlyRun(args: readonly string[]): boolean;
+/**
+ * Whether a credit_balance_too_low refusal gets the advice at exit: for an API
+ * key, or a request with no auth header ccc could read; not for a subscription
+ * token (extra usage spent) or a bearer ccc does not recognise.
+ */
+export declare function creditAdviceApplies(auth: ClaudeAuthType | undefined): boolean;
+export declare function noPlanWarningText(color: boolean): string;
+/**
+ * The line on stderr when it applies: stdout stays Claude Code's in print
+ * runs, and in a terminal stderr shows above the session just the same.
+ * Returns whether it was printed.
+ */
+export declare function printNoPlanWarning(input: PlanWarningInput, color: boolean): boolean;
+/** The last sign-in type Claude Code's requests showed, or undefined. */
+export declare function readSeenClaudeAuth(configDir: string): ClaudeAuthType | undefined;
+/** Keep a subscription or API-key sign-in for the next launch; never throws. */
+export declare function writeSeenClaudeAuth(configDir: string, auth: ClaudeAuthType): void;
+//# sourceMappingURL=claude-plan-warning.d.ts.map

package/dist/claude-plan-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-plan-warning.d.ts","sourceRoot":"","sources":["../src/claude-plan-warning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnE,eAAO,MAAM,YAAY,QAE4D,CAAC;AAEtF,yFAAyF;AACzF,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAKjD,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,IAAI,EAAE,cAAc,CAAC;IACrB,8DAA8D;IAC9D,IAAI,EAAE,UAAU,CAAC;IACjB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAOjE;AAQD,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAE7E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAInF;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAOhF;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAOjF"}

package/dist/claude-plan-warning.js

@@ -0,0 +1,95 @@
+/**
+ * The "no Claude plan" line. ccc runs the user's own Claude Code, so it only
+ * works well signed in with a Claude Pro or Max plan; on an API key every token
+ * is billed by Anthropic, and a key with no credit is refused outright
+ * (credit_balance_too_low, the most common first-prompt failure). The line is
+ * printed once before Claude Code starts when its sign-in is an API key or
+ * missing, and never for a subscription; the credit refusal gets the same text
+ * as ccc exits (claude-auth.ts creditNoticeText).
+ *
+ * Which sign-in Claude Code really used is only known from its requests'
+ * auth headers (claude-auth.ts claudeAuthFromHeaders). The last one seen is
+ * kept as a type name in ccc's config directory so the next launch decides on
+ * fact rather than on the config files' guess.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+export const NO_PLAN_TEXT = "ccc needs Claude Code signed in with a Claude Pro or Max plan (run `claude`, then `/login`). " +
+    "With an API key you pay Anthropic per token, and a key with no credit won't work.";
+/** The file in ccc's config directory holding the last sign-in type Claude Code sent. */
+export const SEEN_AUTH_FILE = "claude-auth-seen";
+const PAID_PLANS = ["pro", "max", "max_5x", "max_20x", "team", "enterprise"];
+const SEEN_TYPES = ["subscription", "api_key"];
+/**
+ * True when Claude Code is on an API key or not signed in, and nothing shows a
+ * paid plan. Any sign of a subscription wins, a stale API-key sighting
+ * included (the user may have run `/login` outside ccc since), so a subscriber
+ * is never warned.
+ */
+export function needsPlanWarning(input) {
+    const { auth, plan, seen } = input;
+    if (auth === "bedrock" || auth === "vertex" || auth === "foundry")
+        return false;
+    if (PAID_PLANS.includes(plan))
+        return false;
+    // Even a "free" plan on record: it may predate an upgrade.
+    if (auth === "subscription" || input.subscriptionLogin === true)
+        return false;
+    return seen !== "subscription";
+}
+const INFO_FLAGS = ["--version", "-v", "--help", "-h"];
+/** Claude Code subcommands that start no session (`setup-token` makes a subscription token). */
+const NO_SESSION_COMMANDS = [
+    "setup-token", "doctor", "update", "upgrade", "mcp", "install", "plugin", "plugins",
+];
+/** `claude --version`, `claude doctor` and the like: no session, so no line. */
+export function isInfoOnlyRun(args) {
+    if (args.length > 0 && NO_SESSION_COMMANDS.includes(args[0]))
+        return true;
+    const end = args.indexOf("--");
+    return (end === -1 ? args : args.slice(0, end)).some((a) => INFO_FLAGS.includes(a));
+}
+/**
+ * Whether a credit_balance_too_low refusal gets the advice at exit: for an API
+ * key, or a request with no auth header ccc could read; not for a subscription
+ * token (extra usage spent) or a bearer ccc does not recognise.
+ */
+export function creditAdviceApplies(auth) {
+    return auth === "api_key" || auth === undefined;
+}
+export function noPlanWarningText(color) {
+    return color ? `\x1b[33m${NO_PLAN_TEXT}\x1b[39m` : NO_PLAN_TEXT;
+}
+/**
+ * The line on stderr when it applies: stdout stays Claude Code's in print
+ * runs, and in a terminal stderr shows above the session just the same.
+ * Returns whether it was printed.
+ */
+export function printNoPlanWarning(input, color) {
+    if (!needsPlanWarning(input))
+        return false;
+    process.stderr.write(`${noPlanWarningText(color)}\n`);
+    return true;
+}
+/** The last sign-in type Claude Code's requests showed, or undefined. */
+export function readSeenClaudeAuth(configDir) {
+    try {
+        const value = fs.readFileSync(path.join(configDir, SEEN_AUTH_FILE), "utf8").trim();
+        return SEEN_TYPES.includes(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Keep a subscription or API-key sign-in for the next launch; never throws. */
+export function writeSeenClaudeAuth(configDir, auth) {
+    if (!SEEN_TYPES.includes(auth))
+        return;
+    try {
+        fs.writeFileSync(path.join(configDir, SEEN_AUTH_FILE), `${auth}\n`, { mode: 0o600 });
+    }
+    catch {
+        // Best effort: the next launch falls back to the config files.
+    }
+}
+//# sourceMappingURL=claude-plan-warning.js.map

package/dist/claude-plan-warning.js.map

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

package/dist/cli-lifecycle.d.ts

@@ -3,6 +3,11 @@ export type ShutdownSignal = "SIGINT" | "SIGTERM";
 export declare function exitCodeForSignal(signal: NodeJS.Signals): number;
 /** Preserve a child's numeric status or translate its terminating signal. */
 export declare function exitCodeForChild(code: number | null, signal: NodeJS.Signals | null): number;
+/**
+ * Claude Code's exit for diagnostics: the status (clamped by the schema as
+ * `code`, unclamped as `code_raw`), its signal, and how long it ran.
+ */
+export declare function claudeExitFields(code: number | null, signal: NodeJS.Signals | null, startedAt: number, now?: number): Record<string, number | string | undefined>;
 export interface SignalShutdownActions {
     forward(signal: ShutdownSignal): void;
     shutdown(code: number): void;

package/dist/cli-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-lifecycle.d.ts","sourceRoot":"","sources":["../src/cli-lifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAGhE;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,GAC5B,MAAM,CAGR;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,qBAAqB,GAC7B,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CASlC;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAkB,GACzD,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjF"}
+{"version":3,"file":"cli-lifecycle.d.ts","sourceRoot":"","sources":["../src/cli-lifecycle.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAGhE;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,GAC5B,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAmB,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAO7C;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,qBAAqB,GAC7B,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CASlC;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAkB,GACzD,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjF"}

package/dist/cli-lifecycle.js

@@ -1,4 +1,5 @@
 import { constants as osConstants } from "node:os";
+import { signalName } from "./diagnostics-schema.js";
 /** Conventional shell status for a process terminated by a POSIX signal. */
 export function exitCodeForSignal(signal) {
     const signalNumber = osConstants.signals[signal];
@@ -10,6 +11,18 @@ export function exitCodeForChild(code, signal) {
         return code;
     return signal === null ? 1 : exitCodeForSignal(signal);
 }
+/**
+ * Claude Code's exit for diagnostics: the status (clamped by the schema as
+ * `code`, unclamped as `code_raw`), its signal, and how long it ran.
+ */
+export function claudeExitFields(code, signal, startedAt, now = Date.now()) {
+    return {
+        code: code ?? undefined,
+        code_raw: code ?? undefined,
+        signal: signalName(signal),
+        uptime_ms: Math.max(0, now - startedAt),
+    };
+}
 /**
  * First signal forwards to the child and starts graceful shutdown; a second
  * signal forwards again and becomes an immediate conventional-status escape.

package/dist/cli-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-lifecycle.js","sourceRoot":"","sources":["../src/cli-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAInD,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,IAAmB,EACnB,MAA6B;IAE7B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAA8B;IAE9B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;;YACtC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,SAA4C,OAAO,CAAC,MAAM;IAE1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,OAAyB,EAAE,EAAU;IAChE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CACV,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EACzC,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"cli-lifecycle.js","sourceRoot":"","sources":["../src/cli-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIrD,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,IAAmB,EACnB,MAA6B;IAE7B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAmB,EACnB,MAA6B,EAC7B,SAAiB,EACjB,MAAc,IAAI,CAAC,GAAG,EAAE;IAExB,OAAO;QACL,IAAI,EAAE,IAAI,IAAI,SAAS;QACvB,QAAQ,EAAE,IAAI,IAAI,SAAS;QAC3B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;QAC1B,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC;KACxC,CAAC;AACJ,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAA8B;IAE9B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;;YACtC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,SAA4C,OAAO,CAAC,MAAM;IAE1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,OAAyB,EAAE,EAAU;IAChE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CACV,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EACzC,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}