@duyquangnvx/agent-cli 0.0.0-stage → 0.1.0

package/dist/run-cli.js

@@ -0,0 +1,211 @@
+import { Command as Commander } from "commander";
+import { builtInCommands } from "./built-ins.js";
+import { isCommand, } from "./define.js";
+import { FailureWithData, formatRuntimeError, UsageError } from "./errors.js";
+import { execute } from "./execute.js";
+import { fieldsOption, projected, renderRows, rowFieldsOf, selectedFields } from "./fields.js";
+import { JSON_FLAG, runtimeFlagsFor } from "./flags.js";
+import { cliHelp, commandHelp, groupHelp } from "./help.js";
+import { cliHelpJson, commandHelpJson, groupHelpJson } from "./help-json.js";
+import { inputFields, registerInput } from "./input.js";
+import { RunControl } from "./interrupts.js";
+import { Page, pageFooter, printedPage } from "./page.js";
+import { parseInput } from "./parse-input.js";
+import { styleFor } from "./style.js";
+import { commandLine, ParseStop, stopAt, usageErrorOf } from "./usage.js";
+const RUNTIME_EXIT_CODE = 1;
+const USAGE_EXIT_CODE = 2;
+function withTrailingNewline(text) {
+    return text === "" || text.endsWith("\n") ? text : `${text}\n`;
+}
+function isJson(cmd) {
+    return cmd.optsWithGlobals().json === true;
+}
+function isDryRun(cmd) {
+    return cmd.opts().dryRun === true;
+}
+function confirmOf(cmd) {
+    return cmd.opts().confirm;
+}
+function printed(outcome, { json, invocation, style, fields }) {
+    if (!(outcome.value instanceof Page)) {
+        return json ? `${JSON.stringify(outcome.value)}\n` : withTrailingNewline(outcome.render(style));
+    }
+    const page = printedPage(outcome.value, invocation);
+    if (fields === undefined) {
+        return json
+            ? `${JSON.stringify(page)}\n`
+            : `${withTrailingNewline(outcome.render(style))}${pageFooter(page)}`;
+    }
+    const rows = projected(page.items, fields);
+    // The author's render may read any field, so selected rows are rendered by the Runtime.
+    return json
+        ? `${JSON.stringify({ ...page, items: rows })}\n`
+        : `${renderRows(rows, fields)}${pageFooter(page)}`;
+}
+function failure(error, format) {
+    return {
+        stdout: "",
+        stderr: formatRuntimeError(error, format),
+        exitCode: error instanceof UsageError ? USAGE_EXIT_CODE : RUNTIME_EXIT_CODE,
+    };
+}
+async function runCommand(sub, command, fields, { base, signal, style, invocation, errorFormat }) {
+    const json = isJson(sub);
+    let input;
+    let selected;
+    try {
+        input = parseInput(command, sub, fields, invocation);
+        const rowFields = rowFieldsOf(command);
+        selected =
+            rowFields === undefined
+                ? undefined
+                : selectedFields(sub.opts().fields, rowFields, commandLine(sub));
+    }
+    catch (error) {
+        return failure(error, { ...errorFormat, json });
+    }
+    const control = new RunControl(commandLine(sub), signal);
+    const ctx = {
+        ...base,
+        signal: control.signal,
+        deadline: (ms) => control.deadline(ms),
+        runToEnd: (work) => control.runToEnd(work),
+    };
+    try {
+        const outcome = await control.settle(execute(command, input, ctx, {
+            dryRun: isDryRun(sub),
+            confirmation: { invocation, commandLine: commandLine(sub), given: confirmOf(sub) },
+        }));
+        return {
+            stdout: printed(outcome, { json, invocation, style, fields: selected }),
+            stderr: "",
+            exitCode: 0,
+        };
+    }
+    catch (error) {
+        const reported = control.errorAfter(error);
+        const result = failure(reported, { ...errorFormat, json });
+        if (!(reported instanceof FailureWithData)) {
+            return result;
+        }
+        const outcome = {
+            value: reported.data,
+            render: (renderStyle) => command.render(reported.data, renderStyle),
+        };
+        return { ...result, stdout: printed(outcome, { json, invocation, style, fields: selected }) };
+    }
+}
+// Commander parses every option before it prints help, so `--json` counts on either side of `--help`.
+function helpFor(cmd, text, json) {
+    cmd.configureHelp({ formatHelp: () => (isJson(cmd) ? json() : text()) });
+}
+function configureCommand(sub, command, setup, json = () => commandHelpJson(commandLine(sub), command)) {
+    const fields = inputFields(command);
+    const rowFields = rowFieldsOf(command);
+    const helpFields = rowFields === undefined
+        ? fields
+        : { ...fields, options: [...fields.options, fieldsOption(rowFields)] };
+    helpFor(sub, () => commandHelp(commandLine(sub), command, helpFields, setup.style), json);
+    registerInput(sub, helpFields.options);
+    // The root already carries --json, for every Command.
+    for (const flag of runtimeFlagsFor(command.effect).filter((flag) => flag !== JSON_FLAG)) {
+        sub.option(flag.usage, flag.description);
+    }
+    sub.action(async () => {
+        setup.finish(await runCommand(sub, command, fields, setup));
+    });
+}
+function addCommand(parent, command, setup) {
+    const sub = stopAt(parent.command(command.name).description(command.description));
+    configureCommand(sub, command, setup);
+}
+function addCommands(parent, commands, setup) {
+    for (const [key, node] of Object.entries(commands)) {
+        if (isCommand(node)) {
+            addCommand(parent, node, setup);
+        }
+        else {
+            const group = stopAt(parent.command(key));
+            helpFor(group, () => groupHelp(commandLine(group), node, setup.style), () => groupHelpJson(commandLine(group), node));
+            addCommands(group, node, setup);
+        }
+    }
+}
+function stopped(error, { commanderOut, invocation, errorFormat }) {
+    if (!(error instanceof ParseStop)) {
+        return failure(error, errorFormat);
+    }
+    if (error.reason.exitCode === 0) {
+        return { stdout: commanderOut, stderr: "", exitCode: 0 };
+    }
+    // A group called without a Command answers with its help, the same as its --help.
+    if (error.reason.code === "commander.help") {
+        return { stdout: error.command.helpInformation(), stderr: "", exitCode: 0 };
+    }
+    return failure(usageErrorOf(error, invocation), { ...errorFormat, json: isJson(error.command) });
+}
+function versionLine({ version, build }) {
+    if (build === undefined)
+        return version;
+    return `${version} (${build.sha}${build.dirty ? "+dirty" : ""})`;
+}
+export async function runCli(cli, argv, options) {
+    const progress = [];
+    const result = await runWithProgress(cli, argv, options, (line) => progress.push(line));
+    return { ...result, stderr: progress.join("") + result.stderr };
+}
+// Progress is written as it happens: an Agent harness kills a process that stays silent too long.
+export async function runWithProgress(cli, argv, options, writeProgress) {
+    const style = styleFor(options.env, options.stdoutIsTTY === true);
+    const errorFormat = { cliName: cli.name, json: false, env: options.env, style };
+    const commanderOut = [];
+    // Settings must be on the root before .command(): children copy them at creation.
+    const root = stopAt(new Commander(cli.name))
+        .configureOutput({
+        writeOut: (text) => commanderOut.push(text),
+        // Commander writes here only the help for a group called without a Command, answered below.
+        writeErr: () => { },
+        outputError: () => { },
+        // The Runtime decides colour itself, so commander must not strip it by reading `process`.
+        stripColor: (text) => text,
+    })
+        .helpCommand(false)
+        .version(versionLine(cli), "--version")
+        .option(JSON_FLAG.usage, JSON_FLAG.description);
+    const invocation = { cliName: cli.name, argv };
+    let commandResult;
+    const setup = {
+        base: {
+            cwd: options.cwd,
+            env: options.env,
+            progress: (message) => writeProgress(`${message}\n`),
+        },
+        signal: options.signal,
+        style,
+        invocation,
+        errorFormat,
+        finish: (result) => {
+            commandResult = result;
+        },
+    };
+    if (cli.commands === undefined) {
+        configureCommand(root, cli.command, setup, () => cliHelpJson(cli.name, cli.version, cli.command));
+    }
+    else {
+        const commands = { ...cli.commands, ...builtInCommands(cli, options.bin) };
+        helpFor(root, () => cliHelp(cli.name, cli.version, commands, style), () => cliHelpJson(cli.name, cli.version, commands));
+        addCommands(root, commands, setup);
+    }
+    try {
+        await root.parseAsync([...argv], { from: "user" });
+    }
+    catch (error) {
+        return stopped(error, { commanderOut: commanderOut.join(""), invocation, errorFormat });
+    }
+    if (commandResult === undefined) {
+        throw new Error("commander finished parsing without running a Command");
+    }
+    return commandResult;
+}
+//# sourceMappingURL=run-cli.js.map

package/dist/run-cli.js.map

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

package/dist/run-process.d.ts

@@ -0,0 +1,2 @@
+import type { Cli } from "./define.js";
+export declare function runProcess(cli: Cli): Promise<void>;

package/dist/run-process.js

@@ -0,0 +1,37 @@
+import { runWithProgress } from "./run-cli.js";
+const SIGNAL_EXIT_CODES = { SIGINT: 130, SIGTERM: 143 };
+function written(stream, text) {
+    return new Promise((resolve) => stream.write(text, () => resolve()));
+}
+export async function runProcess(cli) {
+    const stop = new AbortController();
+    // A second signal quits at once, accepting lost output, so a stuck Command never traps a person.
+    const onSignal = (signal) => {
+        if (stop.signal.aborted) {
+            process.exit(SIGNAL_EXIT_CODES[signal]);
+        }
+        process.stderr.write("\nstopping… (Ctrl-C again to quit now)\n");
+        stop.abort();
+    };
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    try {
+        const result = await runWithProgress(cli, process.argv.slice(2), {
+            env: process.env,
+            cwd: process.cwd(),
+            stdoutIsTTY: process.stdout.isTTY === true,
+            signal: stop.signal,
+            bin: process.argv[1],
+        }, (line) => process.stderr.write(line));
+        await written(process.stdout, result.stdout);
+        await written(process.stderr, result.stderr);
+        process.exitCode = result.exitCode;
+    }
+    finally {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+    }
+    // A Command may leave a timer or socket holding the event loop open; its output is written by now.
+    process.exit();
+}
+//# sourceMappingURL=run-process.js.map

package/dist/run-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-process.js","sourceRoot":"","sources":["../src/run-process.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,iBAAiB,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAW,CAAC;AAIjE,SAAS,OAAO,CAAC,MAA0B,EAAE,IAAY;IACvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ;IACvC,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,iGAAiG;IACjG,MAAM,QAAQ,GAAG,CAAC,MAAkB,EAAQ,EAAE;QAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,GAAG,EACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EACrB;YACE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;YAC1C,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;SACrB,EACD,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CACrC,CAAC;QACF,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACrC,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,mGAAmG;IACnG,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC"}

package/dist/semver.d.ts

@@ -0,0 +1,9 @@
+export declare function isVersion(text: string): boolean;
+/** Negative when `a` is older than `b`, positive when newer, 0 when the same release. */
+export declare function compareVersions(a: string, b: string): number;
+export type Standing = "behind" | "current" | "ahead";
+/** Where `version` stands against `latest`. */
+export declare function standingOf(version: string, latest: string): Standing;
+/** The minimum an `engines.node` range asks for, or undefined when it is not `>=X[.Y[.Z]]`. */
+export declare function engineMinimum(range: string): readonly number[] | undefined;
+export declare function meetsMinimum(version: string, minimum: readonly number[]): boolean;

package/dist/semver.js

@@ -0,0 +1,70 @@
+const VERSION = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+const ENGINE = /^>=\s*(\d+)(?:\.(\d+))?(?:\.(\d+))?$/;
+export function isVersion(text) {
+    return VERSION.test(text);
+}
+// Numeric identifiers compare as numbers and rank below alphanumeric ones.
+function compareIdentifiers(x, y) {
+    const xNumeric = /^\d+$/.test(x);
+    const yNumeric = /^\d+$/.test(y);
+    if (xNumeric && yNumeric)
+        return Number(x) - Number(y);
+    if (xNumeric !== yNumeric)
+        return xNumeric ? -1 : 1;
+    if (x === y)
+        return 0;
+    return x < y ? -1 : 1;
+}
+function comparePrerelease(a, b) {
+    if (a === b)
+        return 0;
+    // A release outranks its prereleases: 1.0.0 > 1.0.0-rc.1.
+    if (a === undefined)
+        return 1;
+    if (b === undefined)
+        return -1;
+    const left = a.split(".");
+    const right = b.split(".");
+    for (let i = 0; i < Math.min(left.length, right.length); i += 1) {
+        const difference = compareIdentifiers(left[i] ?? "", right[i] ?? "");
+        if (difference !== 0)
+            return difference;
+    }
+    return left.length - right.length;
+}
+/** Negative when `a` is older than `b`, positive when newer, 0 when the same release. */
+export function compareVersions(a, b) {
+    const left = VERSION.exec(a);
+    const right = VERSION.exec(b);
+    if (left === null || right === null) {
+        throw new Error(`cannot compare ${a} with ${b}: both must be X.Y.Z versions`);
+    }
+    for (const part of [1, 2, 3]) {
+        const difference = Number(left[part]) - Number(right[part]);
+        if (difference !== 0)
+            return difference;
+    }
+    return comparePrerelease(left[4], right[4]);
+}
+/** Where `version` stands against `latest`. */
+export function standingOf(version, latest) {
+    const difference = compareVersions(version, latest);
+    if (difference < 0)
+        return "behind";
+    return difference > 0 ? "ahead" : "current";
+}
+/** The minimum an `engines.node` range asks for, or undefined when it is not `>=X[.Y[.Z]]`. */
+export function engineMinimum(range) {
+    const match = ENGINE.exec(range.trim());
+    return match === null ? undefined : match.slice(1).map((part) => Number(part ?? 0));
+}
+export function meetsMinimum(version, minimum) {
+    const parts = version.split(".").map(Number);
+    for (const [i, wanted] of minimum.entries()) {
+        const found = parts[i] ?? 0;
+        if (found !== wanted)
+            return found > wanted;
+    }
+    return true;
+}
+//# sourceMappingURL=semver.js.map

package/dist/semver.js.map

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

package/dist/skills.d.ts

@@ -0,0 +1,11 @@
+import type { Env } from "./define.js";
+import { type Standing } from "./semver.js";
+export declare function skillUpdateCommand(cliName: string): string;
+export type SkillState = Standing | "unversioned" | "unreadable";
+export interface SkillCopy {
+    readonly path: string;
+    readonly version: string | undefined;
+    readonly state: SkillState;
+}
+/** Every installed copy of the skill named after the CLI, in the project first, then under home. */
+export declare function skillCopies(skillName: string, cliVersion: string, cwd: string, env: Env): Promise<SkillCopy[]>;

package/dist/skills.js

@@ -0,0 +1,58 @@
+import { readFile, realpath } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { isMissingFile } from "./errors.js";
+import { isVersion, standingOf } from "./semver.js";
+/** Where the skills CLI (`npx skills add`) puts a skill, under a project and under home. */
+const SKILL_DIRS = [
+    [".claude", "skills"],
+    [".agents", "skills"],
+];
+export function skillUpdateCommand(cliName) {
+    return `npx -y skills update ${cliName}`;
+}
+const FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---/;
+const METADATA_VERSION = /^metadata:[ \t]*\r?\n(?:[ \t]+.*\r?\n)*?[ \t]+version:[ \t]*["']?([^"'\s]+)["']?[ \t]*$/m;
+/** The version a SKILL.md's frontmatter `metadata.version` states. */
+function skillVersionIn(skill) {
+    const frontmatter = FRONTMATTER.exec(skill)?.[1];
+    return frontmatter === undefined ? undefined : METADATA_VERSION.exec(`${frontmatter}\n`)?.[1];
+}
+function homeOf(env) {
+    return env.HOME ?? env.USERPROFILE ?? homedir();
+}
+async function copyAt(path, cliVersion) {
+    let skill;
+    try {
+        skill = await readFile(join(path, "SKILL.md"), "utf8");
+    }
+    catch (error) {
+        if (isMissingFile(error)) {
+            return undefined;
+        }
+        return { path, version: undefined, state: "unreadable" };
+    }
+    const version = skillVersionIn(skill);
+    if (version === undefined || !isVersion(version) || !isVersion(cliVersion)) {
+        return { path, version, state: "unversioned" };
+    }
+    return { path, version, state: standingOf(version, cliVersion) };
+}
+/** Every installed copy of the skill named after the CLI, in the project first, then under home. */
+export async function skillCopies(skillName, cliVersion, cwd, env) {
+    const roots = [cwd, homeOf(env)];
+    const paths = roots.flatMap((root) => SKILL_DIRS.map((dir) => join(root, ...dir, skillName)));
+    const seen = new Set();
+    const copies = [];
+    for (const path of paths) {
+        const copy = await copyAt(path, cliVersion);
+        // The project may be home itself, or one skill dir a link to the other.
+        const real = copy === undefined ? undefined : await realpath(path);
+        if (copy !== undefined && real !== undefined && !seen.has(real)) {
+            seen.add(real);
+            copies.push(copy);
+        }
+    }
+    return copies;
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/style.d.ts

@@ -0,0 +1,13 @@
+import type { Env } from "./define.js";
+type Paint = (text: string) => string;
+/** Colours text when colour is on; every method returns the text unchanged when it is off. */
+export interface Style {
+    readonly bold: Paint;
+    readonly dim: Paint;
+    readonly red: Paint;
+    readonly green: Paint;
+    readonly yellow: Paint;
+    readonly cyan: Paint;
+}
+export declare function styleFor(env: Env, stdoutIsTTY: boolean): Style;
+export {};

package/dist/style.js

@@ -0,0 +1,38 @@
+// Some Agent harnesses run commands in a PTY, so a TTY alone doesn't mean a person is watching.
+const AGENT_VARIABLES = [
+    "CLAUDECODE",
+    "CODEX_CI",
+    "CODEX_SANDBOX",
+    "GEMINI_CLI",
+    "CURSOR_AGENT",
+    "CI",
+];
+function colourEnabled(env, stdoutIsTTY) {
+    const noColor = env.NO_COLOR !== undefined && env.NO_COLOR !== "";
+    const agent = AGENT_VARIABLES.some((name) => env[name] !== undefined);
+    return stdoutIsTTY && !noColor && !agent;
+}
+function sgr(open, close) {
+    return (text) => `\u001b[${open}m${text}\u001b[${close}m`;
+}
+const COLOURED = {
+    bold: sgr(1, 22),
+    dim: sgr(2, 22),
+    red: sgr(31, 39),
+    green: sgr(32, 39),
+    yellow: sgr(33, 39),
+    cyan: sgr(36, 39),
+};
+const plain = (text) => text;
+const PLAIN = {
+    bold: plain,
+    dim: plain,
+    red: plain,
+    green: plain,
+    yellow: plain,
+    cyan: plain,
+};
+export function styleFor(env, stdoutIsTTY) {
+    return colourEnabled(env, stdoutIsTTY) ? COLOURED : PLAIN;
+}
+//# sourceMappingURL=style.js.map

package/dist/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"AAcA,gGAAgG;AAChG,MAAM,eAAe,GAAG;IACtB,YAAY;IACZ,UAAU;IACV,eAAe;IACf,YAAY;IACZ,cAAc;IACd,IAAI;CACI,CAAC;AAEX,SAAS,aAAa,CAAC,GAAQ,EAAE,WAAoB;IACnD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC;IAClE,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;IACtE,OAAO,WAAW,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC;AAC3C,CAAC;AAED,SAAS,GAAG,CAAC,IAAY,EAAE,KAAa;IACtC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,IAAI,IAAI,UAAU,KAAK,GAAG,CAAC;AAC5D,CAAC;AAED,MAAM,QAAQ,GAAU;IACtB,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;IAChB,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;IACf,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;IAClB,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;IACnB,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,KAAK,GAAU,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;AAEpC,MAAM,KAAK,GAAU;IACnB,IAAI,EAAE,KAAK;IACX,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,GAAQ,EAAE,WAAoB;IACrD,OAAO,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5D,CAAC"}

package/dist/suggest.d.ts

@@ -0,0 +1,2 @@
+/** The one long flag closest to `flag`, or none when nothing is close or several tie. */
+export declare function closestFlag(flag: string, flags: readonly string[]): string | undefined;

package/dist/suggest.js

@@ -0,0 +1,41 @@
+const MAX_DISTANCE = 3;
+const MIN_SIMILARITY = 0.4;
+// Optimal string alignment distance, the measure commander uses for its own suggestions.
+function distance(a, b) {
+    const width = b.length + 1;
+    const d = Array.from({ length: (a.length + 1) * width }, (_, k) => {
+        const i = Math.floor(k / width);
+        const j = k % width;
+        // The first row and column count the edits from an empty string.
+        return i === 0 || j === 0 ? i + j : 0;
+    });
+    const at = (i, j) => d[i * width + j] ?? 0;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            const edit = Math.min(at(i - 1, j) + 1, at(i, j - 1) + 1, at(i - 1, j - 1) + cost);
+            const transposed = i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1];
+            d[i * width + j] = transposed ? Math.min(edit, at(i - 2, j - 2) + 1) : edit;
+        }
+    }
+    return at(a.length, b.length);
+}
+function isClose(word, candidate) {
+    const length = Math.max(word.length, candidate.length);
+    const edits = distance(word, candidate);
+    return candidate.length > 1 && edits < MAX_DISTANCE && (length - edits) / length > MIN_SIMILARITY;
+}
+/** The one long flag closest to `flag`, or none when nothing is close or several tie. */
+export function closestFlag(flag, flags) {
+    if (!flag.startsWith("--")) {
+        return undefined;
+    }
+    const word = flag.slice(2);
+    const close = [...new Set(flags)]
+        .map((candidate) => candidate.slice(2))
+        .filter((candidate) => isClose(word, candidate));
+    const best = Math.min(...close.map((candidate) => distance(word, candidate)));
+    const closest = close.filter((candidate) => distance(word, candidate) === best);
+    return closest.length === 1 ? `--${closest[0]}` : undefined;
+}
+//# sourceMappingURL=suggest.js.map

package/dist/suggest.js.map

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

package/dist/update.d.ts

@@ -0,0 +1,3 @@
+import { type Command, type CommandTreeCli, type GlobalInstall } from "./define.js";
+/** The built-in `update`, for a CLI installed globally with npm. */
+export declare function updateCommand(cli: CommandTreeCli, install: GlobalInstall, bin: string | undefined): Command;