@wirecat/cli-base 0.0.0-stage → 0.21.0

package/dist/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;GAOG;AACH,MAAM,OAAO;AACX,4FAA4F;AAC5F,kHAAkH,CAAA;AAEpH,MAAM,gBAAgB,GAAG,2FAA2F,CAAA;AAEpH,MAAM,WAAW,GAAG,qBAAqB,CAAA;AAEzC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE;IACpC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAClC,IAAI,IAAI,GAAG,MAAM;QAAE,OAAO,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAA;IACrD,OAAO,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;AAC9G,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAU,EAAE;IACtD,IAAI,EAAE,GAAG,CAAC,CAAA;IACV,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;QACxE,EAAE,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAClC,CAAC;IACD,OAAO,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC1D,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA"}

package/dist/skill/index.d.ts

@@ -0,0 +1,78 @@
+import { Command } from "commander";
+import type { Renderer } from "../renderer.js";
+import type { Streams } from "../streams.js";
+type Env = Readonly<Record<string, string | undefined>>;
+export interface SkillApp {
+    /** `tg` — what an agent types. */
+    command: string;
+    /** `tg-cli` — the skill's directory name, and the `name` in its frontmatter. */
+    appName: string;
+    version: string;
+}
+export declare const SKILL_TARGETS: readonly ["claude", "agents"];
+export type SkillTarget = (typeof SKILL_TARGETS)[number];
+/** `~/.claude/skills` is Claude Code's; `~/.agents/skills` is read by Codex and Gemini CLI. */
+export declare const skillPath: (target: SkillTarget, appName: string, env: Env) => string;
+/**
+ * `metadata.version` from the frontmatter — where the Agent Skills specification keeps fields of its
+ * own — or a top-level `version:`, which pre-release builds of this package wrote.
+ */
+export declare const skillVersion: (content: string) => string | undefined;
+/** Adds or replaces `metadata.version` as a string; every other byte stays as it was. */
+export declare const withVersion: (content: string, version: string) => string;
+/** Writes the stamped SKILL.md to each target, creating directories; the same run twice gives the same files. */
+export declare const installSkill: (app: SkillApp, skill: URL, { targets, env }?: {
+    targets?: readonly SkillTarget[];
+    env?: Env;
+}) => string[];
+/** What the command writes to and where home is, for this invocation — the host's own output resolution. */
+export type SkillEnvironment = (command: Command) => {
+    renderer: Renderer;
+    streams: Streams;
+    env?: Env;
+};
+/**
+ * `more`: skills a library ships for every CLI built on it, by name — `skill show <name>` prints one with
+ * `{{command}}` turned into this CLI's command. They are printed, not installed: two CLIs would install
+ * the same name.
+ */
+export declare const skillCommand: (app: SkillApp, skill: URL, environment: SkillEnvironment, more?: Readonly<Record<string, URL>>) => Command;
+export interface SkillHintRequest {
+    app: SkillApp;
+    /** The words the CLI was run with: no hint while it runs `skill` or `complete`. */
+    argv: readonly string[];
+    env: Env;
+    /** The update notice's state file — one file for both daily notices. */
+    statePath: string;
+    /** The setting `skillHint`; `false` turns the hint off. */
+    enabled?: boolean;
+    now?: () => number;
+}
+/**
+ * One line for an agent whose copy of SKILL.md is missing or older than this CLI, at most once a
+ * day, or `undefined`. The host prints it on stderr. Any failure is silence.
+ */
+export declare const skillHint: ({ app, argv, env, statePath, enabled, now }: SkillHintRequest) => string | undefined;
+export interface SkillResource {
+    uri: string;
+    name: string;
+    title: string;
+    description: string;
+    mimeType: "text/markdown";
+    read: () => {
+        contents: {
+            uri: string;
+            mimeType: "text/markdown";
+            text: string;
+        }[];
+    };
+    /** A line for the server's `instructions`. */
+    instruction: string;
+}
+/**
+ * What an MCP server registers to serve SKILL.md as `<command>://skill`, for a client with no shell —
+ * `server.registerResource(r.name, r.uri, { title, description, mimeType }, r.read)`. The SDK stays the host's.
+ */
+export declare const skillResource: (app: SkillApp, skill: URL) => SkillResource;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/skill/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAG5C,KAAK,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;AAEvD,MAAM,WAAW,QAAQ;IACvB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,aAAa,YAAI,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAC1D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAIxD,+FAA+F;AAC/F,eAAO,MAAM,SAAS,WAAY,WAAW,WAAW,MAAM,OAAO,GAAG,KAAG,MACoB,CAAA;AAoB/F;;;GAGG;AACH,eAAO,MAAM,YAAY,YAAa,MAAM,KAAG,MAAM,GAAG,SAMvD,CAAA;AAOD,yFAAyF;AACzF,eAAO,MAAM,WAAW,YAAa,MAAM,WAAW,MAAM,KAAG,MAoB9D,CAAA;AAED,iHAAiH;AACjH,eAAO,MAAM,YAAY,QAClB,QAAQ,SACN,GAAG,qBACsC;IAAE,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,KAC9F,MAAM,EAiBR,CAAA;AAED,4GAA4G;AAC5G,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,CAAA;AAExG;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAClB,QAAQ,SACN,GAAG,eACG,gBAAgB,SACvB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAClC,OAiDF,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,QAAQ,CAAA;IACb,mFAAmF;IACnF,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,GAAG,EAAE,GAAG,CAAA;IACR,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAgBD;;;GAGG;AACH,eAAO,MAAM,SAAS,gDAAmE,gBAAgB,uBAaxG,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,eAAe,CAAA;IACzB,IAAI,EAAE,MAAM;QAAE,QAAQ,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,eAAe,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAA;IACpF,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAS,QAAQ,SAAS,GAAG,KAAG,aAWzD,CAAA"}

package/dist/skill/index.js

@@ -0,0 +1,190 @@
+/**
+ * The CLI's own SKILL.md for coding agents: printing it, installing it where agents look for skills,
+ * telling an agent once a day that its copy is missing or old, and serving it to an MCP client.
+ *
+ * Nothing here prints by itself. The command writes through the renderer and streams the host hands
+ * it, and the hint is a string the host puts on stderr — never stdout, which an agent parses.
+ */
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { Command, Option } from "commander";
+import { CliError } from "../errors.js";
+import { CHECK_EVERY_MS, isNewer, readNoticeState, writeUpdateState } from "../update/index.js";
+export const SKILL_TARGETS = ["claude", "agents"];
+const homeOf = (env) => env.HOME || env.USERPROFILE || homedir();
+/** `~/.claude/skills` is Claude Code's; `~/.agents/skills` is read by Codex and Gemini CLI. */
+export const skillPath = (target, appName, env) => join(homeOf(env), target === "claude" ? ".claude" : ".agents", "skills", appName, "SKILL.md");
+const FRONTMATTER = /^---(\r?\n)([\s\S]*?\r?\n)?---(\r?\n|$)/;
+const scalar = (key, indent) => new RegExp(`^${indent}${key}:[ \\t]*["']?([^"'\\r\\n]*?)["']?[ \\t]*\\r?\\n?$`);
+const frontmatterLines = (content) => (FRONTMATTER.exec(content)?.[2] ?? "").split(/(?<=\n)/);
+/** Where `metadata:` and its indented lines are, as `[start, end)`; a flow map (`metadata: {…}`) is refused. */
+const metadataBlock = (lines) => {
+    const start = lines.findIndex((line) => /^metadata:/.test(line));
+    if (start === -1)
+        return undefined;
+    if (!/^metadata:[ \t]*\r?\n?$/.test(lines[start])) {
+        throw new CliError("configuration_error", "SKILL.md: write `metadata` as an indented block, not on one line");
+    }
+    let end = start + 1;
+    while (end < lines.length && /^[ \t]/.test(lines[end]))
+        end++;
+    return [start, end];
+};
+/**
+ * `metadata.version` from the frontmatter — where the Agent Skills specification keeps fields of its
+ * own — or a top-level `version:`, which pre-release builds of this package wrote.
+ */
+export const skillVersion = (content) => {
+    const lines = frontmatterLines(content);
+    const block = metadataBlock(lines);
+    const nested = block && lines.slice(block[0] + 1, block[1]).find((line) => scalar("version", "[ \\t]+").test(line));
+    const line = nested ?? lines.find((line) => scalar("version", "").test(line));
+    return line === undefined ? undefined : scalar("version", "[ \\t]*").exec(line)?.[1];
+};
+const skillName = (content) => {
+    const line = frontmatterLines(content).find((line) => scalar("name", "").test(line));
+    return line === undefined ? undefined : scalar("name", "").exec(line)?.[1];
+};
+/** Adds or replaces `metadata.version` as a string; every other byte stays as it was. */
+export const withVersion = (content, version) => {
+    const match = FRONTMATTER.exec(content);
+    if (!match)
+        return `---\nmetadata:\n  version: "${version}"\n---\n${content}`;
+    const [whole, eol = "\n", body = "", close = ""] = match;
+    const lines = body.split(/(?<=\n)/).filter((line) => line !== "");
+    const block = metadataBlock(lines);
+    if (!block) {
+        lines.push(`metadata:${eol}`, `  version: "${version}"${eol}`);
+    }
+    else {
+        const [start, end] = block;
+        const indent = /^[ \t]+/.exec(lines[start + 1] ?? "")?.[0] ?? "  ";
+        const at = lines.slice(start + 1, end).findIndex((line) => scalar("version", "[ \\t]+").test(line));
+        if (at === -1)
+            lines.splice(start + 1, 0, `${indent}version: "${version}"${eol}`);
+        else {
+            const old = lines[start + 1 + at];
+            const lineEol = /\r?\n$/.exec(old)?.[0] ?? "";
+            lines[start + 1 + at] = `${/^[ \t]+/.exec(old)?.[0]}version: "${version}"${lineEol}`;
+        }
+    }
+    return `---${eol}${lines.join("")}---${close}${content.slice(whole.length)}`;
+};
+/** Writes the stamped SKILL.md to each target, creating directories; the same run twice gives the same files. */
+export const installSkill = (app, skill, { targets = SKILL_TARGETS, env = process.env } = {}) => {
+    const source = readFileSync(skill, "utf8");
+    // The specification requires it, and an agent that checks skips a skill whose name and directory differ.
+    const name = skillName(source);
+    if (name !== app.appName) {
+        throw new CliError("configuration_error", `SKILL.md is named ${name === undefined ? "nothing" : `"${name}"`}, but installs into a directory "${app.appName}"; the two must match`);
+    }
+    const content = withVersion(source, app.version);
+    return targets.map((target) => {
+        const path = skillPath(target, app.appName, env);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content);
+        return path;
+    });
+};
+/**
+ * `more`: skills a library ships for every CLI built on it, by name — `skill show <name>` prints one with
+ * `{{command}}` turned into this CLI's command. They are printed, not installed: two CLIs would install
+ * the same name.
+ */
+export const skillCommand = (app, skill, environment, more = {}) => {
+    const command = new Command("skill").description("the instructions an agent is given for this tool");
+    const machine = (self) => {
+        const { json, jsonl } = self.optsWithGlobals();
+        return json === true || jsonl === true;
+    };
+    const named = Object.keys(more);
+    const show = command
+        .command("show")
+        .description(`print SKILL.md — \`${app.command} skill install\` puts it where Claude Code, Codex and Gemini CLI look for it`);
+    if (named.length > 0)
+        show.argument("[name]", `one of the skills shipped for a task: ${named.join(", ")}`);
+    show.action(function (given) {
+        // Without a declared argument Commander passes the options here, not a name.
+        const name = typeof given === "string" ? given : undefined;
+        const { renderer, streams } = environment(this);
+        const source = name === undefined ? skill : more[name];
+        if (!source) {
+            throw new CliError("validation_error", `no skill "${name}" — there are: ${named.join(", ")}`);
+        }
+        const content = name === undefined
+            ? readFileSync(source, "utf8").trimEnd()
+            : readFileSync(source, "utf8").trimEnd().replaceAll("{{command}}", app.command);
+        // The file itself even into a pipe: saving it is a redirect, and a redirect is where every
+        // other command switches to JSON. Asked for by name, it is JSON like the rest.
+        if (machine(this))
+            renderer.result({ name: name ?? app.appName, content });
+        else
+            streams.data(content);
+    });
+    command
+        .command("install")
+        .description(`write SKILL.md to ~/.claude/skills/${app.appName}/ (Claude Code) and ~/.agents/skills/${app.appName}/ (Codex, Gemini CLI)`)
+        .addOption(new Option("--for <agents>", "which agents to install for").choices(["claude", "agents", "all"]).default("all"))
+        .action(function ({ for: chosen }) {
+        const { renderer, env } = environment(this);
+        const targets = chosen === "all" ? SKILL_TARGETS : [chosen];
+        const written = installSkill(app, skill, { targets, ...(env ? { env } : {}) });
+        renderer.result({ name: app.appName, version: app.version, written });
+        renderer.success(`${app.appName} ${app.version} skill installed: ${written.join(", ")}`);
+    });
+    return command;
+};
+const isAgent = (env) => Boolean(env.AI_AGENT || env.CLAUDECODE);
+const needsInstall = (app, env) => {
+    const installed = SKILL_TARGETS.flatMap((target) => {
+        try {
+            return [skillVersion(readFileSync(skillPath(target, app.appName, env), "utf8"))];
+        }
+        catch {
+            return [];
+        }
+    });
+    // A location never installed to is a choice (`--for claude`); only no copy at all, or an old one, is worth a line.
+    return installed.length === 0 || installed.some((version) => version === undefined || isNewer(app.version, version));
+};
+/**
+ * One line for an agent whose copy of SKILL.md is missing or older than this CLI, at most once a
+ * day, or `undefined`. The host prints it on stderr. Any failure is silence.
+ */
+export const skillHint = ({ app, argv, env, statePath, enabled = true, now = Date.now }) => {
+    try {
+        if (!enabled || !isAgent(env))
+            return undefined;
+        if (argv.includes("skill") || argv.includes("complete"))
+            return undefined;
+        const at = now();
+        const shown = readNoticeState(statePath).skillHintAt;
+        if (shown !== undefined && at - shown < CHECK_EVERY_MS)
+            return undefined;
+        if (!needsInstall(app, env))
+            return undefined;
+        writeUpdateState(statePath, { skillHintAt: at });
+        return `agents: \`${app.command} skill install\` installs this tool's guide`;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * What an MCP server registers to serve SKILL.md as `<command>://skill`, for a client with no shell —
+ * `server.registerResource(r.name, r.uri, { title, description, mimeType }, r.read)`. The SDK stays the host's.
+ */
+export const skillResource = (app, skill) => {
+    const uri = `${app.command}://skill`;
+    return {
+        uri,
+        name: "skill",
+        title: `${app.appName} SKILL.md`,
+        description: `How to use ${app.command}: the guide an agent is given for this tool.`,
+        mimeType: "text/markdown",
+        read: () => ({ contents: [{ uri, mimeType: "text/markdown", text: readFileSync(skill, "utf8") }] }),
+        instruction: `- The full guide is the resource ${uri}; \`${app.command} skill install\` installs it as an agent skill.`,
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/skill/index.js.map

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

package/dist/streams.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The line every machine mode depends on: **stdout carries data, stderr carries everything
+ * else.** Two functions and no formatting decisions — the renderer that chooses tables, colour
+ * and spinners is `CLI-5` and sits on top of this, never beside it.
+ */
+export interface Streams {
+    data: (text: string) => void;
+    diagnostic: (text: string) => void;
+    /**
+     * A line that replaces itself — a progress counter, and nothing else.
+     *
+     * It lives here rather than beside the renderer so that a test capturing streams captures this
+     * too: the invariant it could break is rule 3, and an output channel the machine-output test
+     * cannot see is exactly how that gets broken quietly. An empty string clears the line.
+     */
+    progress?: (text: string) => void;
+}
+export declare const processStreams: Streams;
+/** Collects both halves separately, so a test can assert nothing leaked across. */
+export declare const captureStreams: () => Streams & {
+    stdout: string[];
+    stderr: string[];
+};
+//# sourceMappingURL=streams.d.ts.map

package/dist/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED,eAAO,MAAM,cAAc,EAAE,OAY5B,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,cAAc,QAAO,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAW/E,CAAA"}

package/dist/streams.js

@@ -0,0 +1,26 @@
+export const processStreams = {
+    data: (text) => {
+        process.stdout.write(`${text}\n`);
+    },
+    diagnostic: (text) => {
+        process.stderr.write(`${text}\n`);
+    },
+    progress: (text) => {
+        // Carriage return and no newline, so the next line overwrites this one. Padded to the width of
+        // what was there before, or the tail of a longer previous line is left on screen.
+        process.stderr.write(`\r${text.padEnd(72)}${text === "" ? "\r" : ""}`);
+    },
+};
+/** Collects both halves separately, so a test can assert nothing leaked across. */
+export const captureStreams = () => {
+    const stdout = [];
+    const stderr = [];
+    return {
+        stdout,
+        stderr,
+        data: (text) => stdout.push(text),
+        diagnostic: (text) => stderr.push(text),
+        progress: (text) => stderr.push(text),
+    };
+};
+//# sourceMappingURL=streams.js.map

package/dist/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAA;IACnC,CAAC;IACD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAA;IACnC,CAAC;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,+FAA+F;QAC/F,kFAAkF;QAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACxE,CAAC;CACF,CAAA;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAqD,EAAE;IACnF,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,OAAO;QACL,MAAM;QACN,MAAM;QACN,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACvC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;KACtC,CAAA;AACH,CAAC,CAAA"}

package/dist/testing/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The seams a test needs, so that "no test touched the real machine" is a property of the code
+ * rather than a hope about every test remembering to opt out.
+ */
+export { brokenKeyring, memoryKeyring } from "../keyring.js";
+export { captureStreams } from "../streams.js";
+import type { MonotonicClock, SleepLike, WallClock } from "../time.js";
+export interface FakeClock {
+    clock: MonotonicClock;
+    now: WallClock;
+    sleep: SleepLike;
+    /** Every sleep asked for, in order, with the reason the caller gave. Nothing actually waits. */
+    waits: {
+        ms: number;
+        reason?: string;
+    }[];
+    advance(ms: number): void;
+}
+/**
+ * Time that never passes unless a test says so. A retry test that really sleeps 250 ms is a retry
+ * test nobody runs, so `sleep` resolves at once and records what it was asked for.
+ */
+export declare const fakeClock: (startMs?: number) => FakeClock;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,cAAc,CAAA;IACrB,GAAG,EAAE,SAAS,CAAA;IACd,KAAK,EAAE,SAAS,CAAA;IAChB,gGAAgG;IAChG,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,wBAAkB,SAiBvC,CAAA"}

package/dist/testing/index.js

@@ -0,0 +1,29 @@
+/**
+ * The seams a test needs, so that "no test touched the real machine" is a property of the code
+ * rather than a hope about every test remembering to opt out.
+ */
+export { brokenKeyring, memoryKeyring } from "../keyring.js";
+export { captureStreams } from "../streams.js";
+/**
+ * Time that never passes unless a test says so. A retry test that really sleeps 250 ms is a retry
+ * test nobody runs, so `sleep` resolves at once and records what it was asked for.
+ */
+export const fakeClock = (startMs = 0) => {
+    let elapsed = startMs;
+    const waits = [];
+    return {
+        waits,
+        clock: () => elapsed,
+        now: () => new Date(startMs + elapsed),
+        sleep: async (ms, signal, reason) => {
+            if (signal?.aborted)
+                throw new DOMException("The operation was aborted.", "AbortError");
+            waits.push(reason === undefined ? { ms } : { ms, reason });
+            elapsed += ms;
+        },
+        advance: (ms) => {
+            elapsed += ms;
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAa9C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAO,GAAG,CAAC,EAAa,EAAE;IAClD,IAAI,OAAO,GAAG,OAAO,CAAA;IACrB,MAAM,KAAK,GAAsC,EAAE,CAAA;IAEnD,OAAO;QACL,KAAK;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO;QACpB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACtC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAClC,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAA;YACvF,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;YAC1D,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE;YACd,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/time.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The two clocks and the one timer core needs. All three are injectable, which is what makes
+ * timeout and backoff testable without anything actually waiting.
+ */
+/**
+ * Why the client is waiting. The real sleep ignores it; a test uses it to tell an attempt's
+ * deadline apart from a delay between attempts, which are the only two reasons core ever waits.
+ * Without it a test that records waits sees both and cannot assert on either.
+ */
+export type SleepReason = "timeout" | "retry";
+/** Rejects with an `AbortError` if the signal fires first, the way `fetch` does. */
+export type SleepLike = (ms: number, signal?: AbortSignal, reason?: SleepReason) => Promise<void>;
+/** Monotonic milliseconds. Durations come from here; a wall clock can step backwards. */
+export type MonotonicClock = () => number;
+/** Wall time. Timestamps that a person or another system will read come from here. */
+export type WallClock = () => Date;
+export declare const abortError: () => DOMException;
+export declare const realSleep: SleepLike;
+export declare const monotonic: MonotonicClock;
+export declare const wallClock: WallClock;
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7C,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEjG,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,MAAM,MAAM,CAAA;AAEzC,sFAAsF;AACtF,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAA;AAElC,eAAO,MAAM,UAAU,QAAO,YAA4E,CAAA;AAE1G,eAAO,MAAM,SAAS,EAAE,SAgBpB,CAAA;AAEJ,eAAO,MAAM,SAAS,EAAE,cAAwC,CAAA;AAEhE,eAAO,MAAM,SAAS,EAAE,SAA4B,CAAA"}

package/dist/time.js

@@ -0,0 +1,19 @@
+/**
+ * The two clocks and the one timer core needs. All three are injectable, which is what makes
+ * timeout and backoff testable without anything actually waiting.
+ */
+export const abortError = () => new DOMException("The operation was aborted.", "AbortError");
+export const realSleep = (ms, signal) => new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+        reject(abortError());
+        return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener("abort", () => {
+        clearTimeout(timer);
+        reject(abortError());
+    }, { once: true });
+});
+export const monotonic = () => performance.now();
+export const wallClock = () => new Date();
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAiB,EAAE,CAAC,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAA;AAE1G,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;QACpB,OAAM;IACR,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACrC,MAAM,EAAE,gBAAgB,CACtB,OAAO,EACP,GAAG,EAAE;QACH,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;IACtB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,SAAS,GAAmB,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAA;AAEhE,MAAM,CAAC,MAAM,SAAS,GAAc,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAA"}

package/dist/update/index.d.ts

@@ -0,0 +1,76 @@
+export { executableEnvironment, executableOnPath } from "../executable.js";
+import * as v from "valibot";
+import type { FetchLike } from "../http/index.js";
+export type Installer = "pnpm" | "npm" | "bun" | "npx" | "checkout" | "unknown";
+/**
+ * Read from where the running file really lives — `realpath` of the script, not `which`: the
+ * command on `PATH` is a shim or a link, and only its target says who installed it. Paths measured
+ * on 2026-09-24 by installing into throwaway prefixes.
+ */
+export declare const installerOf: (scriptPath: string) => Installer;
+/** The argv that updates a global install, or `undefined` where there is nothing to run. */
+export declare const updateCommand: (installer: Installer, packageName: string) => string[] | undefined;
+/** Plain `x.y.z` only: a pre-release is never offered, so it never counts as newer. */
+export declare const isNewer: (candidate: string, current: string) => boolean;
+/** The `latest` version on npm, or `undefined` on any failure — a hint may never fail a command. */
+export declare const latestVersion: (packageName: string, fetch: FetchLike, { timeoutMs }?: {
+    timeoutMs?: number;
+}) => Promise<string | undefined>;
+export declare const CHECK_EVERY_MS: number;
+export interface NotifyContext {
+    /** `pretty`, `json` or `jsonl` — the line exists only for the first. */
+    format: string;
+    stderrIsTTY: boolean;
+    quiet: boolean;
+    /** The setting; `false` turns the check off. */
+    enabled: boolean;
+    installer: Installer;
+    env: Readonly<Record<string, string | undefined>>;
+    /** Extra variables that turn it off, for the CLI's own prefix: `MAX_NO_UPDATE_CHECK`. */
+    offVariables?: readonly string[];
+}
+/** Whether a person is at a terminal who could be told — the only case a check is worth making. */
+export declare const mayNotify: ({ format, stderrIsTTY, quiet, enabled, installer, env, offVariables, }: NotifyContext) => boolean;
+declare const updateState: v.ObjectSchema<{
+    readonly checkedAt: v.NumberSchema<undefined>;
+    readonly latest: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** When the skill hint (`cli-base/skill`) was last shown — the other daily notice kept in this file. */
+    readonly skillHintAt: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type UpdateState = v.InferOutput<typeof updateState>;
+/** The file as it is, `checkedAt: 0` when it is missing or unreadable. */
+export declare const readNoticeState: (path: string) => UpdateState;
+/** What the last check found. A missing or unreadable file is "never checked", not an error. */
+export declare const readUpdateState: (path: string) => UpdateState | undefined;
+/**
+ * Merged into the file as it is at the moment of writing: the update notice reads before it asks
+ * npm and writes after, and the skill hint may have written in between.
+ */
+export declare const writeUpdateState: (path: string, state: Partial<UpdateState>) => void;
+export declare const checkIsDue: (state: UpdateState | undefined, now: number) => boolean;
+/** Resolve Windows shims from explicit PATH entries; cross-spawn quotes them through the trusted shell. */
+export declare const spawnPlan: ([command, ...args]: readonly string[], platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv, exists?: (path: string) => boolean) => {
+    file: string;
+    args: string[];
+    shell: boolean;
+};
+/** Runs the update and answers its exit code. stdout stays one result: the package manager's output goes to stderr. */
+export declare const runUpdate: (argv: readonly string[]) => number;
+export interface NoticeRequest extends NotifyContext {
+    /** The words the CLI was run with, to leave `update` and `complete` alone. */
+    argv: readonly string[];
+    packageName: string;
+    /** The command a person types: `braze`, `max`. */
+    command: string;
+    version: string;
+    /** Where the last answer from npm is kept — the CLI's state directory. */
+    statePath: string;
+    fetch: FetchLike;
+    now?: () => number;
+}
+/**
+ * The daily "a newer version exists" line, or `undefined`. Meant to be started beside the command
+ * and awaited after it, so asking npm costs the command nothing; any failure is silence.
+ */
+export declare const updateNotice: ({ argv, packageName, command, version, statePath, fetch, now, ...context }: NoticeRequest) => Promise<string | undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/update/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/update/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE1E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAA;AAE/E;;;;GAIG;AACH,eAAO,MAAM,WAAW,eAAgB,MAAM,KAAG,SAOhD,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,aAAa,cAAe,SAAS,eAAe,MAAM,KAAG,MAAM,EAAE,GAAG,SAYpF,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,OAAO,cAAe,MAAM,WAAW,MAAM,KAAG,OAS5D,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,aAAa,gBACX,MAAM,SACZ,SAAS,kBACM;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3C,OAAO,CAAC,MAAM,GAAG,SAAS,CAY5B,CAAA;AAED,eAAO,MAAM,cAAc,QAAsB,CAAA;AAEjD,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,SAAS,CAAA;IACpB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IACjD,yFAAyF;IACzF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAED,mGAAmG;AACnG,eAAO,MAAM,SAAS,2EAQnB,aAAa,KAAG,OAQuB,CAAA;AAE1C,QAAA,MAAM,WAAW;;;IAGf,wGAAwG;;aAExG,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,WAAW,CAAC,CAAA;AAE3D,0EAA0E;AAC1E,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,WAM9C,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,WAAW,GAAG,SAG5D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,SAAU,MAAM,SAAS,OAAO,CAAC,WAAW,CAAC,KAAG,IAM5E,CAAA;AAED,eAAO,MAAM,UAAU,UAAW,WAAW,GAAG,SAAS,OAAO,MAAM,KAAG,OACT,CAAA;AAEhE,2GAA2G;AAC3G,eAAO,MAAM,SAAS,uBACA,SAAS,MAAM,EAAE,aAC3B,MAAM,CAAC,QAAQ,QACpB,MAAM,CAAC,UAAU,WACd,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO;;;;CAC4D,CAAA;AAE/F,uHAAuH;AACvH,eAAO,MAAM,SAAS,SAAU,SAAS,MAAM,EAAE,KAAG,MASnD,CAAA;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,8EAA8E;IAC9E,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,SAAS,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,+EAStB,aAAa,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAsB5C,CAAA"}