@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/config.d.ts

@@ -1,20 +0,0 @@
-import * as v from "valibot";
-/**
- * Atomic, and the directory is locked down before the first write.
- *
- * Atomic because a partial credential file loses **every** profile's secret, not just the one
- * being written, and the window for that is exactly a Ctrl+C mid-write. The directory mode matters
- * as much as the file's: `0o600` on a file inside a world-readable directory is worth little.
- * ⚠ Both modes are ignored on Windows.
- */
-export declare const writeSecurely: (path: string, contents: string, mode: number) => void;
-/**
- * Reads and validates a JSON config. A missing file is not an error — it is a program that has not
- * been configured yet — but a malformed one is, and it says which field and why.
- *
- * The schema belongs to the host: what a profile holds is the one thing no shared package can know.
- */
-export declare const loadConfigFile: <TSchema extends v.GenericSchema>(path: string, schema: TSchema, fallback: () => v.InferOutput<TSchema>) => v.InferOutput<TSchema>;
-/** Config is not a secret, so it is `0644`; the credential file next to it is not. */
-export declare const saveConfigFile: (path: string, config: unknown) => void;
-//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,SAAU,MAAM,YAAY,MAAM,QAAQ,MAAM,KAAG,IAe5E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,SAAS,CAAC,CAAC,aAAa,QACtD,MAAM,UACJ,OAAO,YACL,MAAM,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,KACrC,CAAC,CAAC,WAAW,CAAC,OAAO,CAqBvB,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,cAAc,SAAU,MAAM,UAAU,OAAO,KAAG,IAE9D,CAAA"}

package/dist/config.js

@@ -1,61 +0,0 @@
-import { randomBytes } from "node:crypto";
-import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import * as v from "valibot";
-/**
- * Atomic, and the directory is locked down before the first write.
- *
- * Atomic because a partial credential file loses **every** profile's secret, not just the one
- * being written, and the window for that is exactly a Ctrl+C mid-write. The directory mode matters
- * as much as the file's: `0o600` on a file inside a world-readable directory is worth little.
- * ⚠ Both modes are ignored on Windows.
- */
-export const writeSecurely = (path, contents, mode) => {
-    const dir = dirname(path);
-    mkdirSync(dir, { recursive: true, mode: 0o700 });
-    // An unguessable name opened with `wx` fails on anything already there, a planted symlink
-    // included, instead of writing through it.
-    const temp = join(dir, `.${randomBytes(8).toString("hex")}.tmp`);
-    try {
-        writeFileSync(temp, contents, { mode, flag: "wx" });
-        // A rename within one directory is atomic on every platform we target.
-        renameSync(temp, path);
-    }
-    catch (error) {
-        rmSync(temp, { force: true });
-        throw error;
-    }
-};
-/**
- * Reads and validates a JSON config. A missing file is not an error — it is a program that has not
- * been configured yet — but a malformed one is, and it says which field and why.
- *
- * The schema belongs to the host: what a profile holds is the one thing no shared package can know.
- */
-export const loadConfigFile = (path, schema, fallback) => {
-    let text;
-    try {
-        text = readFileSync(path, "utf8");
-    }
-    catch {
-        return fallback();
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch {
-        throw new Error(`${path} is not valid JSON`);
-    }
-    const result = v.safeParse(schema, parsed);
-    if (!result.success) {
-        const problems = result.issues.map((issue) => `${v.getDotPath(issue) ?? "(root)"}: ${issue.message}`);
-        throw new Error(`${path} is not a valid config:\n  ${problems.join("\n  ")}`);
-    }
-    return result.output;
-};
-/** Config is not a secret, so it is `0644`; the credential file next to it is not. */
-export const saveConfigFile = (path, config) => {
-    writeSecurely(path, `${JSON.stringify(config, null, 2)}\n`, 0o644);
-};
-//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACpF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAE,IAAY,EAAQ,EAAE;IAClF,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAEhD,0FAA0F;IAC1F,2CAA2C;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAChE,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,uEAAuE;QACvE,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7B,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAY,EACZ,MAAe,EACf,QAAsC,EACd,EAAE;IAC1B,IAAI,IAAY,CAAA;IAChB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,EAAE,CAAA;IACnB,CAAC;IAED,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACrG,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,8BAA8B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAA;AACtB,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,MAAe,EAAQ,EAAE;IACpE,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACpE,CAAC,CAAA"}

package/dist/credentials.d.ts

@@ -1,48 +0,0 @@
-import { type KeyringStore } from "./keyring.js";
-export declare const CREDENTIAL_STORAGE: readonly ["auto", "keyring", "file"];
-export type CredentialStorage = (typeof CREDENTIAL_STORAGE)[number];
-export type CredentialSource = "environment" | "keyring" | "file";
-export interface StoredCredential {
-    secret: string;
-    source: CredentialSource;
-}
-export interface CredentialsOptions {
-    /** Where the fallback file lives when the keyring cannot be used. */
-    configDir: string;
-    /** The keyring service name — the command's name, e.g. `max-cli`. */
-    service: string;
-    /**
-     * **True when the config directory came from the environment rather than the OS convention.**
-     *
-     * The OS keyring is global: an entry is addressed by service and account and knows nothing about
-     * which config directory asked for it. So a throwaway config directory looks isolated and is
-     * not — it overwrites the real secret for that account. In `brazecli` that destroyed two working
-     * keys on 2026-09-14, and a keyring entry cannot be read back out. Passing `true` here scopes the
-     * service name to the directory, making the isolation people already assume they have real.
-     */
-    isolated?: boolean;
-    /** Read before the keyring, for CI. */
-    envVar?: string;
-    storage?: CredentialStorage;
-    keyring?: KeyringStore;
-    env?: NodeJS.ProcessEnv;
-    fileName?: string;
-    /** Where the one-line warning goes when the keyring is unavailable. Never stdout. */
-    warn?: (message: string) => void;
-}
-export declare const keyringService: (service: string, configDir: string, isolated?: boolean) => string;
-/**
- * Environment first, then the OS keyring, then a file.
- *
- * `auto` does not probe whether a keyring exists: it attempts the operation, and on failure warns
- * once and falls through. A probe would touch the user's keychain for nothing and could still
- * succeed where the real operation fails.
- */
-export declare class Credentials {
-    #private;
-    constructor(options: CredentialsOptions);
-    read(account: string): StoredCredential | undefined;
-    write(account: string, secret: string): CredentialSource;
-    remove(account: string): CredentialSource[];
-}
-//# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,cAAc,CAAA;AAE/D,eAAO,MAAM,kBAAkB,YAAI,MAAM,EAAE,SAAS,EAAE,MAAM,CAAU,CAAA;AACtE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,CAAA;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;IACf;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qFAAqF;IACrF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,eAAO,MAAM,cAAc,YAAa,MAAM,aAAa,MAAM,yBAAqB,MACtC,CAAA;AAIhD;;;;;;GAMG;AACH,qBAAa,WAAW;;IAWtB,YAAY,OAAO,EAAE,kBAAkB,EAStC;IAED,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAWlD;IAED,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAoBvD;IAED,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAe1C;CA4CF"}

package/dist/credentials.js

@@ -1,120 +0,0 @@
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-import { writeSecurely } from "./config.js";
-import { CliError } from "./errors.js";
-import { systemKeyring } from "./keyring.js";
-export const CREDENTIAL_STORAGE = ["auto", "keyring", "file"];
-export const keyringService = (service, configDir, isolated = false) => isolated ? `${service}:${configDir}` : service;
-/**
- * Environment first, then the OS keyring, then a file.
- *
- * `auto` does not probe whether a keyring exists: it attempts the operation, and on failure warns
- * once and falls through. A probe would touch the user's keychain for nothing and could still
- * succeed where the real operation fails.
- */
-export class Credentials {
-    #configDir;
-    #storage;
-    #keyring;
-    #env;
-    #service;
-    #envVar;
-    #fileName;
-    #warn;
-    #warned = false;
-    constructor(options) {
-        this.#configDir = options.configDir;
-        this.#storage = options.storage ?? "auto";
-        this.#keyring = options.keyring ?? systemKeyring;
-        this.#env = options.env ?? process.env;
-        this.#envVar = options.envVar;
-        this.#fileName = options.fileName ?? "credentials.json";
-        this.#warn = options.warn ?? ((message) => process.stderr.write(`${message}\n`));
-        this.#service = keyringService(options.service, options.configDir, options.isolated);
-    }
-    read(account) {
-        const fromEnv = this.#envVar ? this.#env[this.#envVar]?.trim() : undefined;
-        if (fromEnv)
-            return { secret: fromEnv, source: "environment" };
-        if (this.#storage !== "file") {
-            const fromKeyring = this.#tryKeyring(() => this.#keyring.get(this.#service, account));
-            if (fromKeyring)
-                return { secret: fromKeyring, source: "keyring" };
-        }
-        const fromFile = this.#readFile()?.[account]?.secret;
-        return fromFile ? { secret: fromFile, source: "file" } : undefined;
-    }
-    write(account, secret) {
-        if (this.#storage !== "file") {
-            const stored = this.#tryKeyring(() => {
-                this.#keyring.set(this.#service, account, secret);
-                return true;
-            });
-            if (stored)
-                return "keyring";
-        }
-        const store = this.#readFile();
-        if (!store) {
-            throw new CliError("configuration_error", `${this.#path()} cannot be read as a credentials file; storing now would replace every secret in it. ` +
-                "Fix the file or move it aside, then try again.");
-        }
-        store[account] = { secret };
-        this.#writeFile(store);
-        return "file";
-    }
-    remove(account) {
-        const removed = [];
-        if (this.#storage !== "file" && this.#tryKeyring(() => this.#keyring.delete(this.#service, account))) {
-            removed.push("keyring");
-        }
-        const store = this.#readFile();
-        if (store?.[account] !== undefined) {
-            delete store[account];
-            this.#writeFile(store);
-            removed.push("file");
-        }
-        return removed;
-    }
-    #path() {
-        return join(this.#configDir, this.#fileName);
-    }
-    /** `undefined` when the file exists but is not a store: writing would replace what it holds. */
-    #readFile() {
-        let text;
-        try {
-            text = readFileSync(this.#path(), "utf8");
-        }
-        catch (error) {
-            if (error.code === "ENOENT")
-                return {};
-            return undefined;
-        }
-        try {
-            const parsed = JSON.parse(text);
-            return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : undefined;
-        }
-        catch {
-            // The parser's message quotes the file, and the file holds secrets.
-            return undefined;
-        }
-    }
-    #writeFile(store) {
-        writeSecurely(this.#path(), `${JSON.stringify(store, null, 2)}\n`, 0o600);
-    }
-    #tryKeyring(operation) {
-        if (this.#storage === "keyring")
-            return operation();
-        try {
-            return operation();
-        }
-        catch (error) {
-            if (!this.#warned) {
-                this.#warned = true;
-                this.#warn(`the OS keyring is unavailable (${error instanceof Error ? error.message : String(error)}); ` +
-                    `storing in ${this.#path()} instead, readable only by you`);
-            }
-            return undefined;
-        }
-    }
-}
-//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

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

package/dist/deadline.d.ts

@@ -1,14 +0,0 @@
-import { type SleepLike } from "./time.js";
-export interface DeadlineOptions {
-    timeoutMs?: number;
-    signal?: AbortSignal;
-    sleep?: SleepLike;
-}
-export interface Deadline {
-    readonly signal: AbortSignal;
-    /** On abort, waits for the body to settle before throwing; the body must cooperate to finish promptly. */
-    race<T>(body: (signal: AbortSignal) => Promise<T>): Promise<T>;
-    dispose(): void;
-}
-export declare const createDeadline: ({ timeoutMs, signal, sleep }?: DeadlineOptions) => Deadline;
-//# sourceMappingURL=deadline.d.ts.map

package/dist/deadline.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../src/deadline.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAErD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AACD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,0GAA0G;IAC1G,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC9D,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,eAAO,MAAM,cAAc,kCAA8C,eAAe,KAAQ,QA+E/F,CAAA"}

package/dist/deadline.js

@@ -1,88 +0,0 @@
-import { CliError } from "./errors.js";
-import { realSleep } from "./time.js";
-export const createDeadline = ({ timeoutMs, signal, sleep = realSleep } = {}) => {
-    if (timeoutMs !== undefined && (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0 || timeoutMs > 2147483647))
-        throw new CliError("validation_error", "timeoutMs must be an integer from zero through 2147483647");
-    const controller = new AbortController();
-    const timer = new AbortController();
-    let disposed = false;
-    const abort = (reason) => {
-        if (controller.signal.aborted)
-            return;
-        controller.abort(reason);
-        timer.abort();
-        signal?.removeEventListener("abort", onAbort);
-    };
-    const onAbort = () => abort(signal?.reason instanceof CliError ? signal.reason : new CliError("cancelled", "command cancelled"));
-    if (signal?.aborted)
-        onAbort();
-    else
-        signal?.addEventListener("abort", onAbort, { once: true });
-    const expire = () => abort(new CliError("timeout", "the command did not finish before its deadline", {
-        reason: "command_timeout",
-        timeoutMs,
-        retryable: false,
-    }));
-    if (timeoutMs === 0)
-        expire();
-    if (timeoutMs !== undefined && timeoutMs > 0 && !controller.signal.aborted) {
-        let waiting;
-        try {
-            waiting = sleep(timeoutMs, timer.signal, "timeout");
-        }
-        catch {
-            waiting = Promise.reject(new Error("deadline timer failed"));
-        }
-        void waiting.then(() => {
-            if (!disposed && !timer.signal.aborted)
-                expire();
-        }, () => {
-            if (!disposed && !timer.signal.aborted)
-                abort(new CliError("configuration_error", "command deadline timer failed"));
-        });
-    }
-    return {
-        signal: controller.signal,
-        async race(body) {
-            if (disposed)
-                throw new CliError("validation_error", "deadline is already disposed");
-            if (controller.signal.aborted)
-                throw controller.signal.reason;
-            let interrupt = () => { };
-            const interrupted = new Promise((_, reject) => {
-                interrupt = () => reject(controller.signal.reason);
-                controller.signal.addEventListener("abort", interrupt, { once: true });
-            });
-            const running = Promise.resolve().then(() => {
-                if (controller.signal.aborted)
-                    throw controller.signal.reason;
-                return body(controller.signal);
-            });
-            try {
-                return await Promise.race([running, interrupted]);
-            }
-            catch (error) {
-                if (controller.signal.aborted) {
-                    // A caller may close resources only after its operation can no longer use them.
-                    let settled;
-                    await running.catch((reason) => {
-                        settled = reason;
-                    });
-                    if (settled instanceof CliError && settled.code === "outcome_unknown")
-                        throw settled;
-                    throw controller.signal.reason;
-                }
-                throw error;
-            }
-            finally {
-                controller.signal.removeEventListener("abort", interrupt);
-            }
-        },
-        dispose() {
-            disposed = true;
-            timer.abort();
-            signal?.removeEventListener("abort", onAbort);
-        },
-    };
-};
-//# sourceMappingURL=deadline.js.map

package/dist/deadline.js.map

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

package/dist/dev/bin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/dev/bin.ts"],"names":[],"mappings":""}

package/dist/dev/bin.js

@@ -1,8 +0,0 @@
-#!/usr/bin/env node
-import { main } from "./main.js";
-process.exitCode = await main(process.argv.slice(2), {
-    cwd: process.cwd(),
-    out: (text) => process.stdout.write(`${text}\n`),
-    err: (text) => process.stderr.write(`${text}\n`),
-});
-//# sourceMappingURL=bin.js.map

package/dist/dev/bin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/dev/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACnD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;CACjD,CAAC,CAAA"}

package/dist/dev/main.d.ts

@@ -1,7 +0,0 @@
-export interface DevIo {
-    cwd: string;
-    out: (text: string) => void;
-    err: (text: string) => void;
-}
-export declare const main: (argv: readonly string[], io: DevIo) => Promise<number>;
-//# sourceMappingURL=main.d.ts.map

package/dist/dev/main.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/dev/main.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC5B;AAqGD,eAAO,MAAM,IAAI,SAAgB,SAAS,MAAM,EAAE,MAAM,KAAK,KAAG,OAAO,CAAC,MAAM,CA0C7E,CAAA"}

package/dist/dev/main.js

@@ -1,149 +0,0 @@
-/**
- * `cli-dev`: the development scripts every CLI on cli-core 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, readFileSync, writeFileSync } from "node:fs";
-import { isAbsolute, join } from "node:path";
-import { pathToFileURL } from "node:url";
-import { parseArgs } from "node:util";
-import { changelogProblems, docsProblems, JOURNAL_IDS, markdownFiles, structureProblems, versionScript, } from "../release/index.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`;
-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;
-};
-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 "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

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

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

@@ -1,11 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,33 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}