@wirecat/cli-base 0.0.0-stage → 0.22.0

package/dist/commands/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The command registry: the whole command tree of a CLI as data, however each command came to be.
+ *
+ * It walks the live Commander tree rather than a list written by hand, so a command built in a
+ * loop from a catalog shows up exactly like one written in a file. What the tree cannot say — where
+ * a command came from, whether it changes anything, whether it is on its way out — is attached with
+ * `annotate`.
+ *
+ * Behind its own entry point for the same reason `/http` is: Commander is only a type here, and the
+ * root of this package stays free of any command-line framework.
+ */
+import type { Command } from "commander";
+export type Origin = "handwritten" | "generated";
+export type CommandState = "beta" | "deprecated";
+export interface CommandMeta {
+    origin?: Origin;
+    /** The catalog operation a generated command was made from. */
+    operationId?: string;
+    /** True when running the command changes something: a write, wherever it lands. */
+    mutates?: boolean;
+    /** With `mutates`: what it changes is only on this machine — a file, the keyring — never the service. */
+    local?: boolean;
+    state?: CommandState;
+    examples?: readonly string[];
+}
+export interface ArgumentInfo {
+    name: string;
+    required: boolean;
+    variadic: boolean;
+    description: string;
+    choices?: readonly string[];
+    default?: unknown;
+}
+export interface OptionInfo {
+    flags: string;
+    description: string;
+    /** False for a plain switch like `--json`, so an agent knows not to look for a value. */
+    takesValue: boolean;
+    /**
+     * Whether the option itself must be given. Deliberately not Commander's `required`, which means
+     * "takes a value when present" — reading that as "you must pass this" is the obvious misreading.
+     */
+    mandatory: boolean;
+    choices?: readonly string[];
+    default?: unknown;
+    env?: string;
+    /** Options that may not be given together with this one. */
+    conflicts?: readonly string[];
+    /** Values this option sets on others when they are not given. */
+    implies?: Readonly<Record<string, unknown>>;
+}
+export interface CommandInfo {
+    /** What to pass to the CLI, already split: `["runs", "list"]`. */
+    path: readonly string[];
+    name: string;
+    summary?: string;
+    description: string;
+    usage: string;
+    origin: Origin;
+    operationId?: string;
+    mutates?: boolean;
+    local?: boolean;
+    state?: CommandState;
+    examples?: readonly string[];
+    arguments: readonly ArgumentInfo[];
+    options: readonly OptionInfo[];
+    commands: readonly CommandInfo[];
+}
+/** Attaches what the tree cannot say. Repeated calls merge; the command is returned for chaining. */
+export declare const annotate: <T extends Command>(command: T, meta: CommandMeta) => T;
+export declare const metaOf: (command: Command) => CommandMeta;
+export declare const describeProgram: (root: Command) => CommandInfo[];
+export declare const describeOptions: (command: Command) => OptionInfo[];
+export declare const flatten: (commands: readonly CommandInfo[]) => CommandInfo[];
+export { type CommandsDocument, type CommandsDocumentAbout, commandsDocument, commandsDocumentJsonSchema, commandsDocumentSchema, parseCommandsDocument, } from "./document.js";
+export { COMMANDS_PAGE_LABELS, type CommandsPage, type CommandsPageLabels, type CommandsPageText, commandsPage, } from "./page.js";
+/**
+ * Refuses a command path that arrived as one argument — `"projects add" --help`, what a zsh loop over
+ * `$c` passes. Commander settles `--help` for an unknown word before any hook runs and prints the root
+ * help, so the words are checked before parsing. Pass the words after a leading profile, if any.
+ */
+export declare const refuseJoinedPath: (root: Command, args: readonly string[]) => void;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/commands/index.js

@@ -0,0 +1,85 @@
+import { CliError } from "../errors.js";
+const labels = new WeakMap();
+/** Attaches what the tree cannot say. Repeated calls merge; the command is returned for chaining. */
+export const annotate = (command, meta) => {
+    labels.set(command, { ...labels.get(command), ...meta });
+    return command;
+};
+export const metaOf = (command) => labels.get(command) ?? {};
+export const describeProgram = (root) => visible(root).map((child) => describe(child, root.name(), []));
+export const describeOptions = (command) => command.options.filter((option) => !option.hidden).map(describeOption);
+export const flatten = (commands) => commands.flatMap((command) => [command, ...flatten(command.commands)]);
+const describe = (command, cli, parents) => {
+    const path = [...parents, command.name()];
+    const args = command.registeredArguments.map(describeArgument);
+    const options = describeOptions(command);
+    const { origin = "handwritten", ...meta } = metaOf(command);
+    const usage = [
+        cli,
+        ...path,
+        ...args.map((argument) => (argument.required ? `<${argument.name}>` : `[${argument.name}]`)),
+        options.length > 0 ? "[options]" : "",
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return {
+        path,
+        name: command.name(),
+        ...(command.summary() ? { summary: command.summary() } : {}),
+        description: command.description(),
+        usage,
+        origin,
+        ...meta,
+        arguments: args,
+        options,
+        commands: visible(command).map((child) => describe(child, cli, path)),
+    };
+};
+// `addCommand(command, { hidden: true })` sets only this; Commander has no public getter for it.
+const visible = (command) => command.commands.filter((child) => !child._hidden);
+const describeArgument = (argument) => ({
+    name: argument.name(),
+    required: argument.required,
+    variadic: argument.variadic,
+    description: argument.description,
+    ...(argument.argChoices ? { choices: argument.argChoices } : {}),
+    ...(argument.defaultValue === undefined ? {} : { default: argument.defaultValue }),
+});
+const describeOption = (option) => {
+    const { conflictsWith = [], implied } = option;
+    return {
+        flags: option.flags,
+        description: option.description,
+        takesValue: option.required || option.optional,
+        mandatory: option.mandatory,
+        ...(option.argChoices ? { choices: option.argChoices } : {}),
+        ...(option.defaultValue === undefined ? {} : { default: option.defaultValue }),
+        ...(option.envVar ? { env: option.envVar } : {}),
+        ...(conflictsWith.length > 0 ? { conflicts: conflictsWith } : {}),
+        ...(implied ? { implies: implied } : {}),
+    };
+};
+export { commandsDocument, commandsDocumentJsonSchema, commandsDocumentSchema, parseCommandsDocument, } from "./document.js";
+export { COMMANDS_PAGE_LABELS, commandsPage, } from "./page.js";
+/**
+ * Refuses a command path that arrived as one argument — `"projects add" --help`, what a zsh loop over
+ * `$c` passes. Commander settles `--help` for an unknown word before any hook runs and prints the root
+ * help, so the words are checked before parsing. Pass the words after a leading profile, if any.
+ */
+export const refuseJoinedPath = (root, args) => {
+    let command = root;
+    const path = [];
+    for (const arg of args) {
+        if (arg.startsWith("-"))
+            return;
+        const [first = "", ...rest] = arg.trim().split(/\s+/);
+        const next = command.commands.find((child) => child.name() === first || child.aliases().includes(first));
+        if (next === undefined)
+            return;
+        if (rest.length > 0)
+            throw new CliError("validation_error", `"${arg}" was given as one argument; run: ${[root.name(), ...path, first, ...rest].join(" ")}`);
+        path.push(first);
+        command = next;
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AA+DvC,MAAM,MAAM,GAAG,IAAI,OAAO,EAAwB,CAAA;AAElD,qGAAqG;AACrG,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAoB,OAAU,EAAE,IAAiB,EAAK,EAAE;IAC9E,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;IACxD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAe,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;AAElF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAa,EAAiB,EAAE,CAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;AAEhE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAgB,EAAgB,EAAE,CAChE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;AAExE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,QAAgC,EAAiB,EAAE,CACzE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAExE,MAAM,QAAQ,GAAG,CAAC,OAAgB,EAAE,GAAW,EAAE,OAA0B,EAAe,EAAE;IAC1F,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC9D,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IACxC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAE3D,MAAM,KAAK,GAAG;QACZ,GAAG;QACH,GAAG,IAAI;QACP,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5F,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;KACtC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAA;IAEZ,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;QACpB,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;QAClC,KAAK;QACL,MAAM;QACN,GAAG,IAAI;QACP,SAAS,EAAE,IAAI;QACf,OAAO;QACP,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;KACtE,CAAA;AACH,CAAC,CAAA;AAED,iGAAiG;AACjG,MAAM,OAAO,GAAG,CAAC,OAAgB,EAAa,EAAE,CAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAE,KAAyC,CAAC,OAAO,CAAC,CAAA;AAEzF,MAAM,gBAAgB,GAAG,CAAC,QAAkB,EAAgB,EAAE,CAAC,CAAC;IAC9D,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;IAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;IAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;IACjC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,GAAG,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC;CACnF,CAAC,CAAA;AAKF,MAAM,cAAc,GAAG,CAAC,MAAc,EAAc,EAAE;IACpD,MAAM,EAAE,aAAa,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,MAA0B,CAAA;IAClE,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ;QAC9C,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QAC9E,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzC,CAAA;AACH,CAAC,CAAA;AAED,OAAO,EAGL,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,oBAAoB,EAIpB,YAAY,GACb,MAAM,WAAW,CAAA;AAElB;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAa,EAAE,IAAuB,EAAQ,EAAE;IAC/E,IAAI,OAAO,GAAG,IAAI,CAAA;IAClB,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAM;QAC/B,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACrD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;QACxG,IAAI,IAAI,KAAK,SAAS;YAAE,OAAM;QAC9B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YACjB,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,IAAI,GAAG,qCAAqC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAC/F,CAAA;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAChB,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;AACH,CAAC,CAAA"}

package/dist/commands/page.d.ts

@@ -0,0 +1,80 @@
+import type { CommandInfo, OptionInfo } from "./index.js";
+/** The labels of the tables; the same for every CLI writing in one language. */
+export type CommandsPageLabels = {
+    option: string;
+    does: string;
+    argument: string;
+    isWhat: string;
+    required: string;
+    optional: string;
+    /** Precedes a default: `Default` → "… Default: `20`." */
+    defaultIs: string;
+    /** Precedes the allowed values: `One of` → "… One of: `new`, `old`." */
+    oneOf: string;
+    code: string;
+    when: string;
+    success: string;
+    otherwise: string;
+};
+export declare const COMMANDS_PAGE_LABELS: {
+    readonly en: {
+        readonly option: "Option";
+        readonly does: "What it does";
+        readonly argument: "Argument";
+        readonly isWhat: "What it is";
+        readonly required: "required";
+        readonly optional: "optional";
+        readonly defaultIs: "Default";
+        readonly oneOf: "One of";
+        readonly code: "Code";
+        readonly when: "When";
+        readonly success: "it worked";
+        readonly otherwise: "anything else";
+    };
+    readonly ru: {
+        readonly option: "Опция";
+        readonly does: "Что делает";
+        readonly argument: "Аргумент";
+        readonly isWhat: "Что это";
+        readonly required: "обязательный";
+        readonly optional: "необязательный";
+        readonly defaultIs: "По умолчанию";
+        readonly oneOf: "Одно из";
+        readonly code: "Код";
+        readonly when: "Когда";
+        readonly success: "получилось";
+        readonly otherwise: "всё остальное";
+    };
+};
+/** The CLI's own words: everything on the page that is not read out of the program. */
+export type CommandsPageText = {
+    /** The first line, an HTML comment saying the page is generated and by what. */
+    banner: string;
+    title: string;
+    /** Markdown between the title and the global options. */
+    intro: string;
+    globalHeading: string;
+    globalIntro: string;
+    /** Shown under a command that changes something outside this machine. */
+    mutates: string;
+    /** Shown instead under a command marked `local`, which changes only this machine; without it, nothing is. */
+    mutatesLocal?: string;
+    exitHeading: string;
+    exitIntro: string;
+    /** Markdown after the exit codes; may be empty. */
+    outro: string;
+};
+export type CommandsPage = {
+    cli: string;
+    commands: readonly CommandInfo[];
+    options: readonly OptionInfo[];
+    labels: CommandsPageLabels;
+    text: CommandsPageText;
+};
+/**
+ * The whole `docs/commands.md`: every command at any depth, every option and argument, the exit
+ * codes. Descriptions are quoted as `--help` prints them, untranslated — a translation here would
+ * give the sentence a second home, and the one on screen is the one that gets corrected.
+ */
+export declare const commandsPage: ({ cli, commands, options, labels, text }: CommandsPage) => string;
+//# sourceMappingURL=page.d.ts.map

package/dist/commands/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/commands/page.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvE,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,oBAAoB;;iBAE7B,MAAM,EAAE,QAAQ;iBAChB,IAAI,EAAE,cAAc;iBACpB,QAAQ,EAAE,UAAU;iBACpB,MAAM,EAAE,YAAY;iBACpB,QAAQ,EAAE,UAAU;iBACpB,QAAQ,EAAE,UAAU;iBACpB,SAAS,EAAE,SAAS;iBACpB,KAAK,EAAE,QAAQ;iBACf,IAAI,EAAE,MAAM;iBACZ,IAAI,EAAE,MAAM;iBACZ,OAAO,EAAE,WAAW;iBACpB,SAAS,EAAE,eAAe;;;iBAG1B,MAAM,EAAE,OAAO;iBACf,IAAI,EAAE,YAAY;iBAClB,QAAQ,EAAE,UAAU;iBACpB,MAAM,EAAE,SAAS;iBACjB,QAAQ,EAAE,cAAc;iBACxB,QAAQ,EAAE,gBAAgB;iBAC1B,SAAS,EAAE,cAAc;iBACzB,KAAK,EAAE,SAAS;iBAChB,IAAI,EAAE,KAAK;iBACX,IAAI,EAAE,OAAO;iBACb,OAAO,EAAE,YAAY;iBACrB,SAAS,EAAE,eAAe;;CAEyB,CAAA;AAEvD,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,6GAA6G;IAC7G,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IAC9B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,IAAI,EAAE,gBAAgB,CAAA;CACvB,CAAA;AAWD;;;;GAIG;AACH,eAAO,MAAM,YAAY,6CAA8C,YAAY,KAAG,MAkErF,CAAA"}

package/dist/commands/page.js

@@ -0,0 +1,100 @@
+import { EXIT_CODES } from "../exit-codes.js";
+export const COMMANDS_PAGE_LABELS = {
+    en: {
+        option: "Option",
+        does: "What it does",
+        argument: "Argument",
+        isWhat: "What it is",
+        required: "required",
+        optional: "optional",
+        defaultIs: "Default",
+        oneOf: "One of",
+        code: "Code",
+        when: "When",
+        success: "it worked",
+        otherwise: "anything else",
+    },
+    ru: {
+        option: "Опция",
+        does: "Что делает",
+        argument: "Аргумент",
+        isWhat: "Что это",
+        required: "обязательный",
+        optional: "необязательный",
+        defaultIs: "По умолчанию",
+        oneOf: "Одно из",
+        code: "Код",
+        when: "Когда",
+        success: "получилось",
+        otherwise: "всё остальное",
+    },
+};
+/** A cell that will not break the table it sits in; `~~struck~~` in a description would strike the row. */
+const cell = (text) => (text ?? "").replace(/\|/g, "\\|").replace(/~/g, "\\~").replace(/\n+/g, " ").trim();
+const sentence = (text) => {
+    const said = cell(text);
+    return said === "" || /[.!?]$/.test(said) ? said : `${said}.`;
+};
+/**
+ * The whole `docs/commands.md`: every command at any depth, every option and argument, the exit
+ * codes. Descriptions are quoted as `--help` prints them, untranslated — a translation here would
+ * give the sentence a second home, and the one on screen is the one that gets corrected.
+ */
+export const commandsPage = ({ cli, commands, options, labels, text }) => {
+    // What a value may be and what it is when left out: Commander keeps both out of the description.
+    const extras = ({ choices, default: fallback }) => [
+        choices ? ` ${labels.oneOf}: ${choices.map((choice) => `\`${choice}\``).join(", ")}.` : "",
+        fallback === undefined || fallback === false ? "" : ` ${labels.defaultIs}: \`${String(fallback)}\`.`,
+    ].join("");
+    // The flags go through `cell` too: `--order <recent|name>` would otherwise split the row.
+    const optionRows = (list) => list.map((option) => `| \`${cell(option.flags)}\` | ${sentence(option.description)}${extras(option)} |`).join("\n");
+    const argumentRows = (list) => list
+        .map((argument) => `| \`${cell(argument.name)}\` | ${argument.required ? labels.required : labels.optional} | ${sentence(argument.description)}${extras(argument)} |`)
+        .join("\n");
+    const body = (command) => {
+        const parts = [cell(command.description), ""];
+        const label = command.mutates ? (command.local ? text.mutatesLocal : text.mutates) : undefined;
+        if (label)
+            parts.push(label, "");
+        parts.push("```sh", command.usage, "```");
+        if (command.arguments.length > 0)
+            parts.push("", `| ${labels.argument} | | ${labels.isWhat} |`, "|---|---|---|", argumentRows(command.arguments));
+        if (command.options.length > 0)
+            parts.push("", `| ${labels.option} | ${labels.does} |`, "|---|---|", optionRows(command.options));
+        return parts;
+    };
+    // A group shows its own usage only when it takes options of its own, as `doctor --online` does.
+    const section = (command, depth) => {
+        const heading = `${"#".repeat(Math.min(depth, 4))} \`${cli} ${command.path.join(" ")}\``;
+        if (command.commands.length === 0)
+            return [heading, "", ...body(command)].join("\n");
+        const own = command.options.length > 0 ? body(command) : [cell(command.description)];
+        return [heading, "", ...own, "", command.commands.map((child) => section(child, depth + 1)).join("\n\n")]
+            .join("\n")
+            .trimEnd();
+    };
+    const exitCodes = [
+        `| ${labels.code} | ${labels.when} |`,
+        "|---|---|",
+        `| \`0\` | ${labels.success} |`,
+        ...Object.entries(EXIT_CODES).map(([name, code]) => `| \`${code}\` | \`${name}\` |`),
+        `| \`1\` | ${labels.otherwise} |`,
+    ].join("\n");
+    return [
+        text.banner,
+        `# ${text.title}`,
+        text.intro,
+        `## ${text.globalHeading}`,
+        text.globalIntro,
+        [`| ${labels.option} | ${labels.does} |`, "|---|---|", optionRows(options)].join("\n"),
+        commands.map((command) => section(command, 2)).join("\n\n"),
+        `## ${text.exitHeading}`,
+        text.exitIntro,
+        exitCodes,
+        text.outro,
+    ]
+        .filter((part) => part !== "")
+        .join("\n\n")
+        .concat("\n");
+};
+//# sourceMappingURL=page.js.map

package/dist/commands/page.js.map

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

package/dist/completion/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shell completion over the command registry: which word may come next, as data.
+ *
+ * It speaks the protocol of the shell scripts `@bomb.sh/tab` generates — the shell runs
+ * `<cli> complete -- <words>` and reads `value<TAB>description` lines ending in `:<directive>` —
+ * so a CLI prints those scripts with tab and answers the requests with this. Nothing here reads a
+ * terminal, a file or the network: the words come in, the suggestions go out, and where values come
+ * from (a local cache, a config file) is the CLI's business, handed in as `sources`.
+ */
+import type { CommandInfo, OptionInfo } from "../commands/index.js";
+export interface Suggestion {
+    value: string;
+    description: string;
+}
+/** Values for one argument or option. Called on every Tab, so it must be cheap and must not connect anywhere. */
+export type Values = () => readonly (string | Suggestion)[];
+export interface CompletionSources {
+    /** By argument name, as registered: `chat`, `person`. */
+    arguments?: Readonly<Record<string, Values>>;
+    /** By long option name without dashes: `chat` for `--chat <id>`. */
+    options?: Readonly<Record<string, Values>>;
+    /** Offered alongside the top-level commands — a profile name that may come first, say. */
+    firstWord?: Values;
+}
+export interface CompletionRequest {
+    commands: readonly CommandInfo[];
+    globalOptions?: readonly OptionInfo[];
+    /** Everything after `complete --`; the last word is the one being typed, `""` for a fresh one. */
+    words: readonly string[];
+    sources?: CompletionSources;
+}
+/** Tells the shell not to fall back to file names when nothing matched. */
+export declare const NO_FILE_COMPLETION = 4;
+export declare const suggest: ({ commands, globalOptions, words, sources }: CompletionRequest) => Suggestion[];
+/** The answer in the form the shell script reads. */
+export declare const formatSuggestions: (suggestions: readonly Suggestion[]) => string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/completion/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAgB,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,iHAAiH;AACjH,MAAM,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAA;AAE3D,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5C,oEAAoE;IACpE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1C,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,aAAa,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;IACrC,kGAAkG;IAClG,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,eAAO,MAAM,OAAO,gDAA2D,iBAAiB,KAAG,UAAU,EA2C5G,CAAA;AAED,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,gBAAiB,SAAS,UAAU,EAAE,KAAG,MAC4C,CAAA"}

package/dist/completion/index.js

@@ -0,0 +1,87 @@
+/** Tells the shell not to fall back to file names when nothing matched. */
+export const NO_FILE_COMPLETION = 4;
+export const suggest = ({ commands, globalOptions = [], words, sources = {} }) => {
+    const typed = words.at(-1) ?? "";
+    const before = words.slice(0, -1);
+    let level = commands;
+    let current;
+    let positional = 0;
+    let pending;
+    for (const word of before) {
+        if (pending) {
+            pending = undefined;
+            continue;
+        }
+        if (word.startsWith("-")) {
+            const option = findOption(word, current, globalOptions);
+            if (option?.takesValue && !word.includes("="))
+                pending = option;
+            continue;
+        }
+        const child = level.find((command) => command.name === word);
+        if (child) {
+            current = child;
+            level = child.commands;
+            positional = 0;
+        }
+        else {
+            positional += 1;
+        }
+    }
+    const candidates = pending
+        ? optionValues(pending, sources)
+        : typed.startsWith("-")
+            ? typed.includes("=")
+                ? valuesAfterEquals(typed, current, globalOptions, sources)
+                : optionNames(current, globalOptions)
+            : [
+                ...level.filter((command) => command.state !== "deprecated").map(asSuggestion),
+                ...(current ? argumentValues(current.arguments, positional, sources) : []),
+                ...(current ? [] : resolve(sources.firstWord)),
+            ];
+    const unique = new Map(candidates.map((candidate) => [candidate.value, candidate]));
+    return [...unique.values()].filter(({ value }) => value.startsWith(typed));
+};
+/** The answer in the form the shell script reads. */
+export const formatSuggestions = (suggestions) => [...suggestions.map(({ value, description }) => `${value}\t${description}`), `:${NO_FILE_COMPLETION}`].join("\n");
+const asSuggestion = (command) => ({
+    value: command.name,
+    description: command.summary ?? command.description,
+});
+const longName = (option) => option.flags.match(/--([\w-]+)/)?.[1];
+const findOption = (word, current, globals) => {
+    const name = word.replace(/^-+/, "").split("=")[0];
+    const matches = (option) => longName(option) === name || option.flags.split(/[ ,]+/).includes(`-${name}`);
+    return [...(current?.options ?? []), ...globals].find(matches);
+};
+const optionNames = (current, globals) => [...(current?.options ?? []), ...globals].flatMap((option) => {
+    const name = longName(option);
+    return name ? [{ value: `--${name}`, description: option.description }] : [];
+});
+/** `--kind <dialog|group|channel>`: Commander does not know these as choices, but the flags say them. */
+const inlineChoices = (flags) => flags.match(/<([^>]*\|[^>]*)>/)?.[1]?.split("|") ?? [];
+const optionValues = (option, sources) => {
+    const name = longName(option);
+    return [
+        ...[...(option.choices ?? []), ...inlineChoices(option.flags)].map((value) => ({ value, description: "" })),
+        ...resolve(name ? sources.options?.[name] : undefined),
+    ];
+};
+const valuesAfterEquals = (typed, current, globals, sources) => {
+    const [flag] = typed.split("=");
+    const option = findOption(flag ?? "", current, globals);
+    if (!option?.takesValue)
+        return [];
+    return optionValues(option, sources).map(({ value, description }) => ({ value: `${flag}=${value}`, description }));
+};
+const argumentValues = (args, position, sources) => {
+    const argument = args[position] ?? (args.at(-1)?.variadic ? args.at(-1) : undefined);
+    if (!argument)
+        return [];
+    return [
+        ...(argument.choices ?? []).map((value) => ({ value, description: "" })),
+        ...resolve(sources.arguments?.[argument.name]),
+    ];
+};
+const resolve = (values) => (values?.() ?? []).map((value) => (typeof value === "string" ? { value, description: "" } : value));
+//# sourceMappingURL=index.js.map

package/dist/completion/index.js.map

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

package/dist/config.d.ts

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

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

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

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