@wirecat/cli-base 0.0.0-stage → 0.22.0

package/dist/dev/main.js

@@ -0,0 +1,279 @@
+/**
+ * `cli-dev`: the development scripts every CLI on cli-base used to carry a copy of. Each command
+ * reads and writes under `cwd` and reports through `out` and `err`; `main` returns the exit code.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { parseArgs } from "node:util";
+import spawn from "cross-spawn";
+import * as v from "valibot";
+import { parseCommandsDocument } from "../commands/document.js";
+import { changelogProblems, docsProblems, JOURNAL_IDS, markdownFiles, structureProblems, versionScript, } from "../release/index.js";
+import { baselineProblems, baselineSchema, LINT_RULES, OVERRIDE_BUDGET, overridesProblems, overridesSchema, } from "../standards/lint.js";
+import { issuesOf } from "../standards/registry.js";
+import { VOCABULARY } from "../standards/vocabulary.js";
+import { baselineOf, judge, lintCommands } from "./lint.js";
+import { nextVersion } from "./next-version.js";
+import { slowTests } from "./slow-tests.js";
+import { matrixPage, matrixRows, parseArgvLog } from "./test-matrix.js";
+const USAGE = `usage: cli-dev <command> [options]
+
+  slow-tests [report] [count]          the slowest tests and files (report: coverage/tests.json, count: 20)
+  next-version <wanted> <latest> <versions-json>
+                                       the version bin/release publishes, given npm's answers
+  version [--sync] [--file <path>]     package.json's version against src/version.ts
+  docs-check [--rules <module>] [--ids <A,B>] [--pages]
+                                       links, anchors and the changelog's shape; --pages also
+                                       docs/ against docs/meta.json, the docs portal's structure
+  test-matrix --program <module> --untested <module> --name <cli> [--page <path>] [--check]
+                                       docs/dev/test-matrix.md from coverage/argv.jsonl
+  lint (--cli <bin> | --commands <file>) [--baseline <dir>] [--overrides <file>] [--budget <n>]
+       [--write-baseline]              the command tree against the standard's rules; fails on a
+                                       new violation, a stale baseline entry or override, or more
+                                       overrides than the budget (10). --write-baseline rewrites
+                                       lint/baseline/<rule>.json to today's violations`;
+const load = async (cwd, path) => (await import(pathToFileURL(isAbsolute(path) ? path : join(cwd, path)).href));
+const report = (io, problems, ok) => {
+    for (const problem of problems)
+        io.err(problem);
+    if (problems.length > 0)
+        return 1;
+    io.out(ok);
+    return 0;
+};
+const docsCheck = async (args, io) => {
+    const { values } = parseArgs({
+        args,
+        options: { rules: { type: "string" }, ids: { type: "string" }, pages: { type: "boolean" } },
+    });
+    const root = io.cwd;
+    let changelog;
+    let docs;
+    if (values.rules) {
+        // A module exporting the rules the release check uses too: `CHANGELOG` and `docsRules(root)`.
+        const rules = await load(root, values.rules);
+        changelog = rules.CHANGELOG;
+        docs = rules.docsRules(root);
+    }
+    else {
+        const ids = [...JOURNAL_IDS, ...(values.ids?.split(",").filter(Boolean) ?? [])];
+        changelog = {
+            headings: ["Added", "Changed — may break callers", "Fixed", "Security", "Removed"],
+            unreleased: "Unreleased",
+            ids,
+        };
+        docs = { files: markdownFiles(root, new Set(["node_modules", "dist", "coverage", ".git", "docs_ai"])), ids };
+    }
+    return report(io, [
+        ...changelogProblems(readFileSync(join(root, "CHANGELOG.md"), "utf8"), { ...changelog, release: false }),
+        ...docsProblems(root, docs),
+        ...(values.pages ? structureProblems(root) : []),
+    ], "docs: ok");
+};
+const testMatrix = async (args, io) => {
+    const { values } = parseArgs({
+        args,
+        options: {
+            program: { type: "string" },
+            untested: { type: "string" },
+            name: { type: "string" },
+            page: { type: "string", default: "docs/dev/test-matrix.md" },
+            check: { type: "boolean", default: false },
+        },
+    });
+    if (!values.program || !values.untested || !values.name) {
+        io.err("test-matrix needs --program, --untested and --name");
+        return 2;
+    }
+    const log = join(io.cwd, "coverage", "argv.jsonl");
+    if (!existsSync(log)) {
+        io.err("no coverage/argv.jsonl — run the suite first (pnpm test:matrix does)");
+        return 1;
+    }
+    const program = (await load(io.cwd, values.program)).createProgram();
+    const untested = (await load(io.cwd, values.untested)).UNTESTED;
+    const { rows, stale } = matrixRows(program, parseArgvLog(readFileSync(log, "utf8")), untested);
+    writeFileSync(join(io.cwd, values.page), matrixPage(rows, values.name));
+    let failed = false;
+    if (stale.length > 0) {
+        failed = true;
+        io.err("untested entries that name nothing in the program any more:");
+        for (const entry of stale)
+            io.err(`  ${entry.command}${entry.option ? ` ${entry.option}` : ""}`);
+    }
+    const missing = rows.filter((row) => row.state === "missing");
+    if (missing.length > 0 && values.check) {
+        failed = true;
+        io.err(`${missing.length} commands or options with no test and no reason — see ${values.page}:`);
+        for (const row of missing)
+            io.err(`  ${row.command || "(global)"}${row.option ? ` ${row.option}` : ""}`);
+    }
+    const count = (state) => rows.filter((row) => row.state === state).length;
+    io.err(`test matrix: ${count("tested")} tested, ${count("untested")} untested with a reason, ${missing.length} missing`);
+    return failed ? 1 : 0;
+};
+const readJson = (path) => {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`${path}: ${error.message}`);
+    }
+};
+const commandsJson = (io, cli, file) => {
+    if (file)
+        return readJson(isAbsolute(file) ? file : join(io.cwd, file));
+    const bin = cli ?? "";
+    const script = /\.[cm]?js$/.test(bin);
+    const run = spawn.sync(script ? process.execPath : bin, [...(script ? [bin] : []), "commands", "--json"], {
+        cwd: io.cwd,
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (run.error || run.status !== 0)
+        throw new Error(`${bin} commands --json failed: ${run.error?.message ?? String(run.stderr).trim().split("\n")[0]}`);
+    return JSON.parse(String(run.stdout));
+};
+const lint = (args, io) => {
+    try {
+        return lintRun(args, io);
+    }
+    catch (error) {
+        io.err(error.message);
+        return 2;
+    }
+};
+const lintRun = (args, io) => {
+    const { values } = parseArgs({
+        args,
+        options: {
+            cli: { type: "string" },
+            commands: { type: "string" },
+            baseline: { type: "string", default: "lint/baseline" },
+            overrides: { type: "string", default: "lint/overrides.json" },
+            budget: { type: "string", default: String(OVERRIDE_BUDGET) },
+            "write-baseline": { type: "boolean", default: false },
+        },
+    });
+    if (Boolean(values.cli) === Boolean(values.commands)) {
+        io.err("lint needs one of --cli <bin> or --commands <file>");
+        return 2;
+    }
+    const budget = Number(values.budget);
+    if (!Number.isInteger(budget) || budget < 0) {
+        io.err(`--budget takes a whole number, not "${values.budget}"`);
+        return 2;
+    }
+    let raw;
+    try {
+        raw = commandsJson(io, values.cli, values.commands);
+    }
+    catch (error) {
+        io.err(error.message);
+        return 2;
+    }
+    const parsed = parseCommandsDocument(raw);
+    if (!parsed.document) {
+        io.err("the commands document is not the shape cli-base's commandsDocument() writes:");
+        for (const problem of parsed.problems.slice(0, 20))
+            io.err(`  ${problem}`);
+        if (parsed.problems.length > 20)
+            io.err(`  … and ${parsed.problems.length - 20} more`);
+        return 2;
+    }
+    const problems = [];
+    const overridesPath = join(io.cwd, values.overrides);
+    let overrides = [];
+    if (existsSync(overridesPath)) {
+        const read = v.safeParse(overridesSchema, readJson(overridesPath));
+        const found = read.success ? overridesProblems(read.output) : issuesOf(read.issues);
+        if (read.success)
+            overrides = read.output;
+        problems.push(...found.map((issue) => `${values.overrides}: ${issue}`));
+    }
+    const baselineDir = join(io.cwd, values.baseline);
+    const baseline = {};
+    if (existsSync(baselineDir))
+        for (const file of readdirSync(baselineDir).filter((name) => name.endsWith(".json"))) {
+            const read = v.safeParse(baselineSchema, readJson(join(baselineDir, file)));
+            const found = read.success ? baselineProblems(read.output) : issuesOf(read.issues);
+            if (read.success)
+                baseline[file.slice(0, -".json".length)] = read.output;
+            problems.push(...found.map((issue) => `${values.baseline}/${file}: ${issue}`));
+        }
+    const violations = lintCommands(parsed.document, VOCABULARY);
+    const severity = new Map(LINT_RULES.map((rule) => [rule.id, rule.severity]));
+    if (values["write-baseline"]) {
+        mkdirSync(baselineDir, { recursive: true });
+        for (const [rule, targets] of Object.entries(baselineOf(violations, overrides))) {
+            const path = join(baselineDir, `${rule}.json`);
+            if (targets.length > 0)
+                writeFileSync(path, `${JSON.stringify(targets, null, 2)}\n`);
+            else
+                rmSync(path, { force: true });
+            baseline[rule] = targets;
+        }
+    }
+    const verdict = judge(violations, baseline, overrides, budget);
+    for (const id of verdict.unknownRules)
+        problems.push(`no lint rule "${id}" (named in ${values.baseline} or ${values.overrides})`);
+    for (const found of verdict.fresh)
+        problems.push(`${severity.get(found.rule) ?? "?"}  ${found.rule}  ${found.target}: ${found.message}`);
+    for (const entry of verdict.stale)
+        problems.push(entry.in === "baseline"
+            ? `stale baseline entry, fixed or overridden — remove it: ${values.baseline}/${entry.rule}.json "${entry.target}"`
+            : `stale override, no such violation — remove it: ${entry.rule} "${entry.target}"`);
+    if (verdict.overBudget)
+        problems.push(`${overrides.length} overrides; the budget is ${budget}`);
+    io.err(`lint: ${violations.length} violations — ${verdict.baselined} in the baseline, ${verdict.overridden} overridden (budget ${budget}), ${verdict.fresh.length} new`);
+    return report(io, problems, "lint: ok");
+};
+export const main = async (argv, io) => {
+    const [command, ...args] = argv;
+    switch (command) {
+        case "slow-tests": {
+            const [file = "coverage/tests.json", count = "20"] = args;
+            const parsed = JSON.parse(readFileSync(join(io.cwd, file), "utf8"));
+            io.out(slowTests(parsed, io.cwd, Number(count)));
+            return 0;
+        }
+        case "next-version": {
+            const [wanted = "", latest = "", versions = ""] = args;
+            const found = nextVersion(wanted, latest, versions);
+            if ("error" in found) {
+                io.err(found.error);
+                return 1;
+            }
+            io.out(found.version);
+            return 0;
+        }
+        case "version": {
+            const { values } = parseArgs({
+                args,
+                options: { sync: { type: "boolean", default: false }, file: { type: "string", default: "src/version.ts" } },
+            });
+            const { code, message } = versionScript(io.cwd, values.sync ? ["--sync"] : [], values.file);
+            if (code === 0)
+                io.out(message);
+            else
+                io.err(message);
+            return code;
+        }
+        case "docs-check":
+            return docsCheck(args, io);
+        case "test-matrix":
+            return testMatrix(args, io);
+        case "lint":
+            return lint(args, io);
+        case "help":
+        case "--help":
+        case "-h":
+            io.out(USAGE);
+            return 0;
+        default:
+            io.err(command ? `cli-dev: no command "${command}"\n\n${USAGE}` : USAGE);
+            return 2;
+    }
+};
+//# sourceMappingURL=main.js.map

package/dist/dev/main.js.map

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

package/dist/dev/next-version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The version `bin/release` publishes: the one in package.json when npm has not taken it and it is
+ * above npm's latest, else the next free one at the same bump level (x.y.0 → minor, x.y.z → patch).
+ * npm's answers are arguments, not calls, so CI and a test can hand it any registry state.
+ */
+export declare const nextVersion: (wanted: string, latest: string, versionsJson: string) => {
+    version: string;
+} | {
+    error: string;
+};
+//# sourceMappingURL=next-version.d.ts.map

package/dist/dev/next-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-version.d.ts","sourceRoot":"","sources":["../../src/dev/next-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,WAAW,WACd,MAAM,UACN,MAAM,gBACA,MAAM,KACnB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CA6BvC,CAAA"}

package/dist/dev/next-version.js

@@ -0,0 +1,33 @@
+/**
+ * The version `bin/release` publishes: the one in package.json when npm has not taken it and it is
+ * above npm's latest, else the next free one at the same bump level (x.y.0 → minor, x.y.z → patch).
+ * npm's answers are arguments, not calls, so CI and a test can hand it any registry state.
+ */
+export const nextVersion = (wanted, latest, versionsJson) => {
+    const parse = (version) => /^(\d+)\.(\d+)\.(\d+)$/.exec(version)?.slice(1).map(Number);
+    const compare = (a, b) => (a[0] ?? 0) - (b[0] ?? 0) || (a[1] ?? 0) - (b[1] ?? 0) || (a[2] ?? 0) - (b[2] ?? 0);
+    const want = parse(wanted);
+    // A pre-release is picked by hand; bin/release still refuses it if npm has it.
+    if (!want)
+        return { version: wanted };
+    let published = [];
+    try {
+        published = [JSON.parse(versionsJson || "[]")].flat();
+    }
+    catch { }
+    const taken = new Set(published);
+    const top = parse(latest);
+    if (!top) {
+        if (taken.has(wanted))
+            return { error: `${wanted} is on npm, and npm's latest "${latest}" is not a plain x.y.z version` };
+        return { version: wanted };
+    }
+    if (!taken.has(wanted) && compare(want, top) > 0)
+        return { version: wanted };
+    const step = ([major = 0, minor = 0, patch = 0]) => want[2] === 0 ? [major, minor + 1, 0] : [major, minor, patch + 1];
+    let next = step(top);
+    while (taken.has(next.join(".")))
+        next = step(next);
+    return { version: next.join(".") };
+};
+//# sourceMappingURL=next-version.js.map

package/dist/dev/next-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-version.js","sourceRoot":"","sources":["../../src/dev/next-version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,MAAc,EACd,MAAc,EACd,YAAoB,EACqB,EAAE;IAC3C,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC9F,MAAM,OAAO,GAAG,CAAC,CAAW,EAAE,CAAW,EAAE,EAAE,CAC3C,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAErF,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IAC1B,+EAA+E;IAC/E,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IAErC,IAAI,SAAS,GAAc,EAAE,CAAA;IAC7B,IAAI,CAAC;QACH,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACvD,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IACV,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAA;IAEhC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;IACzB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,iCAAiC,MAAM,gCAAgC,EAAE,CAAA;QACpG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IAC5B,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;IAE5E,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAW,EAAE,EAAE,CAC3D,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;IACnE,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;IACpB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACnD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;AACpC,CAAC,CAAA"}

package/dist/dev/slow-tests.d.ts

@@ -0,0 +1,14 @@
+/** The slowest tests and files from vitest's JSON report (`--reporter=json`), slowest first. */
+export interface VitestReport {
+    testResults: {
+        name: string;
+        startTime: number;
+        endTime: number;
+        assertionResults: {
+            title: string;
+            duration?: number;
+        }[];
+    }[];
+}
+export declare const slowTests: (report: VitestReport, cwd: string, count: number) => string;
+//# sourceMappingURL=slow-tests.d.ts.map

package/dist/dev/slow-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slow-tests.d.ts","sourceRoot":"","sources":["../../src/dev/slow-tests.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,gBAAgB,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KACzD,EAAE,CAAA;CACJ;AAED,eAAO,MAAM,SAAS,WAAY,YAAY,OAAO,MAAM,SAAS,MAAM,KAAG,MAkB5E,CAAA"}

package/dist/dev/slow-tests.js

@@ -0,0 +1,17 @@
+export const slowTests = (report, cwd, count) => {
+    const relative = (path) => path.slice(cwd.length + 1);
+    const tests = report.testResults
+        .flatMap((result) => result.assertionResults.map((test) => ({ ms: test.duration ?? 0, file: result.name, test: test.title })))
+        .sort((a, b) => b.ms - a.ms);
+    const files = report.testResults
+        .map((result) => ({ ms: result.endTime - result.startTime, file: result.name }))
+        .sort((a, b) => b.ms - a.ms);
+    const total = tests.reduce((sum, test) => sum + test.ms, 0);
+    return [
+        `${tests.length} tests, ${(total / 1000).toFixed(1)} s of test time\n\nslowest tests:`,
+        ...tests.slice(0, count).map(({ ms, file, test }) => `${ms.toFixed(0).padStart(6)} ms  ${relative(file)}  ${test}`),
+        "\nslowest files:",
+        ...files.slice(0, 10).map(({ ms, file }) => `${ms.toFixed(0).padStart(6)} ms  ${relative(file)}`),
+    ].join("\n");
+};
+//# sourceMappingURL=slow-tests.js.map

package/dist/dev/slow-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slow-tests.js","sourceRoot":"","sources":["../../src/dev/slow-tests.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAoB,EAAE,GAAW,EAAE,KAAa,EAAU,EAAE;IACpF,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW;SAC7B,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAClB,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CACzG;SACA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW;SAC7B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;SAC/E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAA;IAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IAC3D,OAAO;QACL,GAAG,KAAK,CAAC,MAAM,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mCAAmC;QACtF,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QACnH,kBAAkB;QAClB,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;KAClG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC,CAAA"}

package/dist/dev/test-matrix.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The test matrix page: every command and option of a commander program, and what exercises it — an
+ * offline test that drove it (one `{ command, options }` JSON line per parsed run, written by the
+ * CLI under vitest), or a written reason it is not tested offline.
+ */
+/** The part of commander's `Command` read here; structural, so commander stays an optional peer. */
+export interface ProgramNode {
+    name(): string;
+    parent: ProgramNode | null;
+    commands: readonly ProgramNode[];
+    options: readonly {
+        long?: string;
+        short?: string;
+    }[];
+}
+/** `command` ending in ` *` covers every subcommand under it; `""` is the program's own options. */
+export interface Untested {
+    command: string;
+    option?: string;
+    reason: string;
+}
+interface Row {
+    command: string;
+    option?: string;
+    state: "tested" | "untested" | "missing";
+    note: string;
+}
+export declare const parseArgvLog: (text: string) => Map<string, Set<string>>;
+export declare const matrixRows: (program: ProgramNode, seen: Map<string, Set<string>>, untested: readonly Untested[]) => {
+    rows: Row[];
+    stale: Untested[];
+};
+export declare const matrixPage: (rows: readonly Row[], cli: string) => string;
+export {};
+//# sourceMappingURL=test-matrix.d.ts.map

package/dist/dev/test-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-matrix.d.ts","sourceRoot":"","sources":["../../src/dev/test-matrix.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oGAAoG;AACpG,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,OAAO,EAAE,SAAS;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CACtD;AAED,oGAAoG;AACpG,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED,UAAU,GAAG;IACX,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IACxC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,YAAY,SAAU,MAAM,6BAUxC,CAAA;AAcD,eAAO,MAAM,UAAU,YAAa,WAAW,QAAQ,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,YAAY,SAAS,QAAQ,EAAE;;;CAoD7G,CAAA;AAID,eAAO,MAAM,UAAU,SAAU,SAAS,GAAG,EAAE,OAAO,MAAM,WAuB3D,CAAA"}

package/dist/dev/test-matrix.js

@@ -0,0 +1,93 @@
+/**
+ * The test matrix page: every command and option of a commander program, and what exercises it — an
+ * offline test that drove it (one `{ command, options }` JSON line per parsed run, written by the
+ * CLI under vitest), or a written reason it is not tested offline.
+ */
+export const parseArgvLog = (text) => {
+    const seen = new Map();
+    for (const line of text.split("\n")) {
+        if (!line)
+            continue;
+        const { command, options } = JSON.parse(line);
+        const known = seen.get(command) ?? new Set();
+        for (const option of options)
+            known.add(option);
+        seen.set(command, known);
+    }
+    return seen;
+};
+const runnable = (command) => command._actionHandler != null;
+const pathOf = (command) => {
+    const words = [];
+    for (let at = command; at?.parent; at = at.parent)
+        words.unshift(at.name());
+    return words.join(" ");
+};
+const covers = (entry, command) => entry.command === command || (entry.command.endsWith(" *") && command.startsWith(entry.command.slice(0, -1)));
+export const matrixRows = (program, seen, untested) => {
+    const skipFor = (command, option) => untested.find((entry) => covers(entry, command) && entry.option === option);
+    const rows = [];
+    const walk = (command) => {
+        if (command.parent && runnable(command)) {
+            const path = pathOf(command);
+            const ran = seen.get(path);
+            const skip = skipFor(path);
+            rows.push(ran
+                ? { command: path, state: "tested", note: "" }
+                : skip
+                    ? { command: path, state: "untested", note: skip.reason }
+                    : { command: path, state: "missing", note: "" });
+            for (const option of command.options) {
+                const name = option.long ?? option.short ?? "";
+                if (name === "--help")
+                    continue;
+                const optionSkip = skipFor(path, name) ?? (skip && !ran ? skip : undefined);
+                rows.push(ran?.has(name)
+                    ? { command: path, option: name, state: "tested", note: "" }
+                    : optionSkip
+                        ? { command: path, option: name, state: "untested", note: optionSkip.reason }
+                        : { command: path, option: name, state: "missing", note: "" });
+            }
+        }
+        for (const child of command.commands)
+            walk(child);
+    };
+    walk(program);
+    const globalSeen = new Set([...seen.values()].flatMap((options) => [...options]));
+    for (const option of program.options) {
+        const name = option.long;
+        if (!name || name === "--help")
+            continue;
+        const skip = skipFor("", name);
+        rows.push(globalSeen.has(name)
+            ? { command: "", option: name, state: "tested", note: "" }
+            : skip
+                ? { command: "", option: name, state: "untested", note: skip.reason }
+                : { command: "", option: name, state: "missing", note: "" });
+    }
+    const stale = untested.filter((entry) => !rows.some((row) => row.option === entry.option && covers(entry, row.command)));
+    return { rows, stale };
+};
+const MARK = { tested: "✅", untested: "⛔", missing: "❌" };
+export const matrixPage = (rows, cli) => {
+    const count = (state) => rows.filter((row) => row.state === state).length;
+    const cell = (text) => text.replace(/\|/g, "\\|");
+    return `<!-- Generated by cli-dev test-matrix from the command tree and a test run. Do not edit; \`pnpm test:matrix\`. -->
+
+# Test matrix
+
+Every command and option of \`${cli}\`, and whether an offline test drives it through the CLI. ✅ a test
+ran it · ⛔ not tested offline, with the reason and where it is checked instead · ❌ nothing.
+Measured from the test run (\`coverage/argv.jsonl\`), not searched for — see
+[TESTING.md](TESTING.md) for how, and for the states and failures that cut across commands.
+
+**${count("tested")} ✅ · ${count("untested")} ⛔ · ${count("missing")} ❌** — ${rows.filter((row) => !row.option).length} commands, ${rows.filter((row) => row.option).length} options.
+
+| Command | Option | | Note |
+|---|---|---|---|
+${rows
+        .map((row) => `| ${row.command ? `\`${row.command}\`` : "*global*"} | ${row.option ? `\`${row.option}\`` : ""} | ${MARK[row.state]} | ${cell(row.note)} |`)
+        .join("\n")}
+`;
+};
+//# sourceMappingURL=test-matrix.js.map

package/dist/dev/test-matrix.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Every failure a CLI built on this package, and anything consuming its output, can see. The list
+ * is closed on purpose: an agent branches on `code`, and a new code is a contract change.
+ *
+ * "provider" is whatever the CLI talks to — an HTTP API, a socket, a messenger. The word is
+ * deliberately not "server": a provider that answered with a refusal is not the same as one that
+ * never answered.
+ */
+export declare const errorCodes: readonly ["validation_error", "configuration_error", "authentication_error", "permission_error", "not_found", "confirmation_required", "rate_limited", "timeout", "network_error", "provider_error", "provider_unavailable", "invalid_response", "outcome_unknown", "cancelled"];
+export type ErrorCode = (typeof errorCodes)[number];
+/**
+ * Anything a caller may attach. Everything is optional because these are diagnostics, not a
+ * contract — the contract is `code`.
+ *
+ * `retryable` says whether **this** failure could be retried, not whether the operation is safe to
+ * retry. Those are different questions and conflating them is how a duplicate write happens.
+ */
+export interface CliErrorDetails {
+    readonly status?: number;
+    readonly retryable?: boolean;
+    readonly attempts?: number;
+    readonly requestId?: string;
+    readonly runId?: string;
+    readonly retryAfterMs?: number;
+    readonly operation?: string;
+    readonly [key: string]: unknown;
+}
+export declare class CliError extends Error {
+    readonly code: ErrorCode;
+    readonly details: CliErrorDetails;
+    constructor(code: ErrorCode, message: string, details?: CliErrorDetails);
+}
+export declare const isCliError: (value: unknown) => value is CliError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,YACrB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,CACH,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAChC;AAMD,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IAEjC,YAAY,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,EAM1E;CACF;AAED,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,KAAK,IAAI,QAC4C,CAAA"}

package/dist/errors.js

@@ -0,0 +1,40 @@
+/**
+ * Every failure a CLI built on this package, and anything consuming its output, can see. The list
+ * is closed on purpose: an agent branches on `code`, and a new code is a contract change.
+ *
+ * "provider" is whatever the CLI talks to — an HTTP API, a socket, a messenger. The word is
+ * deliberately not "server": a provider that answered with a refusal is not the same as one that
+ * never answered.
+ */
+export const errorCodes = [
+    "validation_error",
+    "configuration_error",
+    "authentication_error",
+    "permission_error",
+    "not_found",
+    "confirmation_required",
+    "rate_limited",
+    "timeout",
+    "network_error",
+    "provider_error",
+    "provider_unavailable",
+    "invalid_response",
+    "outcome_unknown",
+    "cancelled",
+];
+// Symbol.for, so two copies of this package — one CLI's and one dependency's, during a pin bump —
+// recognise each other's errors where `instanceof` cannot.
+const BRAND = Symbol.for("@wirecat/cli-base/CliError");
+export class CliError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "CliError";
+        this.code = code;
+        this.details = details;
+        Object.defineProperty(this, BRAND, { value: true });
+    }
+}
+export const isCliError = (value) => typeof value === "object" && value !== null && value[BRAND] === true;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,kBAAkB;IAClB,WAAW;IACX,uBAAuB;IACvB,cAAc;IACd,SAAS;IACT,eAAe;IACf,gBAAgB;IAChB,sBAAsB;IACtB,kBAAkB;IAClB,iBAAiB;IACjB,WAAW;CACH,CAAA;AAsBV,kGAAkG;AAClG,2DAA2D;AAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAEtD,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAW;IACf,OAAO,CAAiB;IAEjC,YAAY,IAAe,EAAE,OAAe,EAAE,OAAO,GAAoB,EAAE;QACzE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,CAAC;CACF;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE,CAC9D,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAA+B,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA"}

package/dist/executable.d.ts

@@ -0,0 +1,3 @@
+export declare const executableOnPath: (command: string, env: NodeJS.ProcessEnv, platform?: NodeJS.Platform, exists?: (path: string) => boolean) => string;
+export declare const executableEnvironment: (env: NodeJS.ProcessEnv, platform?: NodeJS.Platform) => NodeJS.ProcessEnv;
+//# sourceMappingURL=executable.d.ts.map