@noodleseed/one 0.16.0 → 0.18.0

package/dist/commands/catalog-dispatch.js

@@ -0,0 +1,95 @@
+/**
+ * Pre-dispatch catalog interception for `cli.ts`: per-command `--help`, bare-noun help for
+ * subcommand dispatchers, unknown-subcommand did-you-mean, and unknown-top-level-command
+ * did-you-mean. Kept out of `cli.ts` itself so it stays a thin dispatch table (see its doc
+ * comment) — this module owns the catalog-facing behavior, `cli.ts` just calls it.
+ */
+import { findCommand, SUBCOMMAND_DISPATCHERS } from './catalog.js';
+import { renderCommandHelp, unknownCommandInfo, unknownSubcommandInfo } from './catalog-render.js';
+import { EXIT } from './output.js';
+function isFlag(token) {
+    return token?.startsWith('-') ?? false;
+}
+/**
+ * Runs before `cli.ts`'s dispatch switch for any `command` that matches a catalog entry.
+ * Returns an exit code when it fully handled the invocation (help, bare-noun, or unknown
+ * subcommand); returns `undefined` when the normal command handler should run.
+ */
+export function interceptCatalogHelp(command, rest) {
+    const entry = findCommand(command);
+    if (entry === undefined)
+        return undefined;
+    if (rest.includes('--help') || rest.includes('-h')) {
+        console.log(renderCommandHelp(entry));
+        return EXIT.OK;
+    }
+    if (entry.subcommands === undefined || !SUBCOMMAND_DISPATCHERS.has(entry.name))
+        return undefined;
+    const json = rest.includes('--json');
+    const first = rest[0];
+    if (first === undefined || isFlag(first)) {
+        return printMissingSubcommand(entry, json);
+    }
+    if (!entry.subcommands.some((sub) => sub.name === first)) {
+        return printUnknownSubcommand(entry, first, json);
+    }
+    return undefined;
+}
+function printMissingSubcommand(entry, json) {
+    if (json) {
+        console.error(JSON.stringify({
+            ok: false,
+            error: {
+                code: 'missing_subcommand',
+                message: `noodle ${entry.name} requires a subcommand`,
+                fix: `Choose one of: ${(entry.subcommands ?? []).map((sub) => sub.name).join(', ')}.`,
+                next: `noodle ${entry.name} --help`,
+            },
+        }));
+    }
+    else {
+        console.error(renderCommandHelp(entry));
+    }
+    return EXIT.USAGE;
+}
+function printUnknownSubcommand(entry, input, json) {
+    const info = unknownSubcommandInfo(entry, input);
+    if (json) {
+        console.error(JSON.stringify({
+            ok: false,
+            error: {
+                code: 'unknown_subcommand',
+                message: info.message,
+                fix: `Choose one of: ${(entry.subcommands ?? []).map((sub) => sub.name).join(', ')}.`,
+                next: `noodle ${entry.name} --help`,
+                suggestions: info.suggestions,
+            },
+        }));
+    }
+    else {
+        console.error(info.message);
+    }
+    return EXIT.USAGE;
+}
+/** Handle a top-level verb with no catalog entry at all (`cli.ts`'s `default:` case). */
+export function handleUnknownCommand(command, rest) {
+    const info = unknownCommandInfo(command);
+    const json = rest.includes('--json');
+    if (json) {
+        console.error(JSON.stringify({
+            ok: false,
+            error: {
+                code: 'unknown_command',
+                message: info.message,
+                fix: 'Run `noodle commands` to list every supported command.',
+                next: 'noodle commands',
+                suggestions: info.suggestions,
+            },
+        }));
+    }
+    else {
+        console.error(info.message);
+    }
+    return EXIT.USAGE;
+}
+//# sourceMappingURL=catalog-dispatch.js.map

package/dist/commands/catalog-dispatch.js.map

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

package/dist/commands/catalog-render.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Renders the command catalog (`catalog.ts`) into every human/machine surface: the grouped
+ * `usage()` banner, per-command `--help` text, `noodle commands` (human + `--json`), and
+ * did-you-mean error text for unknown commands/subcommands.
+ */
+import { type CommandSpec } from './catalog.js';
+/** Render the full grouped usage banner (`noodle --help` / `noodle -h` / bare unknown command). */
+export declare function renderUsageText(): string;
+/** Render the full per-command help block for `noodle <name> --help` (or a bare-noun dispatcher
+ * with no subcommand given). */
+export declare function renderCommandHelp(entry: CommandSpec): string;
+export interface UnknownCommandInfo {
+    readonly message: string;
+    readonly suggestions: readonly string[];
+}
+/** Build the plain-text + suggestion list for an unknown top-level verb. */
+export declare function unknownCommandInfo(input: string): UnknownCommandInfo;
+/** Build the plain-text + suggestion list for an unknown subcommand of a known dispatcher. */
+export declare function unknownSubcommandInfo(entry: CommandSpec, input: string): UnknownCommandInfo;
+/** Compact grouped human list for `noodle commands` (no `--json`). */
+export declare function renderCommandsHuman(): string;
+/** The full machine-readable catalog payload for `noodle commands --json`. */
+export declare function buildCatalogJsonPayload(version: string): {
+    readonly commands: readonly CommandSpec[];
+    readonly exitCodes: Readonly<Record<number, string>>;
+    readonly version: string;
+};
+//# sourceMappingURL=catalog-render.d.ts.map

package/dist/commands/catalog-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-render.d.ts","sourceRoot":"","sources":["../../src/commands/catalog-render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,KAAK,WAAW,EAMjB,MAAM,cAAc,CAAC;AAoDtB,mGAAmG;AACnG,wBAAgB,eAAe,IAAI,MAAM,CAexC;AAcD;gCACgC;AAChC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAyB5D;AAID,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAIpE;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAO3F;AAID,sEAAsE;AACtE,wBAAgB,mBAAmB,IAAI,MAAM,CAW5C;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IACxD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAEA"}

package/dist/commands/catalog-render.js

@@ -0,0 +1,142 @@
+/**
+ * Renders the command catalog (`catalog.ts`) into every human/machine surface: the grouped
+ * `usage()` banner, per-command `--help` text, `noodle commands` (human + `--json`), and
+ * did-you-mean error text for unknown commands/subcommands.
+ */
+import { CATALOG, closestCommands, closestSubcommands, STANDARD_EXIT_CODES, } from './catalog.js';
+const NAME_COLUMN = 14;
+const SUMMARY_COLUMN = 37;
+/** Section header shown just above the first entry with this name, in catalog order. Purely a
+ * rendering grouping for readability — not part of the catalog data itself. */
+const SECTION_BREAKS = new Map([
+    ['help', 'CLI basics'],
+    ['start', 'Guided workflow'],
+    ['init', 'Authoring & validation'],
+    ['dev', 'Local run & inspect'],
+    ['update', 'CLI maintenance'],
+    ['audit', 'Governance & observability'],
+    ['deploy', 'Hosted deploy & operations'],
+    ['login', 'Account & session'],
+    ['orgs', 'Org & members'],
+    ['target', 'Config & target'],
+    ['secrets', 'Managed config'],
+]);
+function flagToken(flag) {
+    return flag.type === 'boolean' ? `--${flag.name}` : `--${flag.name} ${flag.value ?? '<value>'}`;
+}
+function commandUsageToken(entry) {
+    if (entry.usage !== undefined)
+        return entry.usage;
+    if (entry.subcommands !== undefined && entry.subcommands.length > 0) {
+        return entry.subcommands.map((sub) => sub.name).join('|');
+    }
+    if (entry.positional !== undefined)
+        return entry.positional;
+    return '';
+}
+function joinSuggestions(names) {
+    if (names.length === 0)
+        return '';
+    if (names.length === 1)
+        return names[0];
+    if (names.length === 2)
+        return `${names[0]} or ${names[1]}`;
+    return `${names.slice(0, -1).join(', ')}, or ${names[names.length - 1]}`;
+}
+// --- usage() -----------------------------------------------------------------
+function renderUsageEntryLines(entry) {
+    if (entry.removed !== undefined) {
+        return [`  ${entry.name.padEnd(NAME_COLUMN)}(removed — use ${entry.removed.use})`];
+    }
+    const token = commandUsageToken(entry);
+    const head = token.length > 0 ? `  ${entry.name} ${token}` : `  ${entry.name}`;
+    return [head, `${' '.repeat(SUMMARY_COLUMN)}${entry.summary}`];
+}
+/** Render the full grouped usage banner (`noodle --help` / `noodle -h` / bare unknown command). */
+export function renderUsageText() {
+    const lines = ['usage: noodle <command>', ''];
+    CATALOG.forEach((entry, index) => {
+        const section = SECTION_BREAKS.get(entry.name);
+        if (section !== undefined) {
+            if (index > 0)
+                lines.push('');
+            lines.push(`${section}:`);
+        }
+        lines.push(...renderUsageEntryLines(entry));
+    });
+    lines.push('', 'Resolution: flag > env (NOODLE_SERVICE_URL / NOODLE_AUTH_TOKEN) > ~/.noodle/config.json > default');
+    return lines.join('\n');
+}
+// --- per-command --help --------------------------------------------------------
+function renderSubcommandLine(name, sub) {
+    const token = sub.usage ?? [sub.name, sub.positional].filter(Boolean).join(' ');
+    return `  noodle ${name} ${token}\n      ${sub.summary}`;
+}
+function renderFlagLine(flag) {
+    const summary = flag.summary !== undefined ? `  ${flag.summary}` : '';
+    return `  ${flagToken(flag)}${summary}`;
+}
+/** Render the full per-command help block for `noodle <name> --help` (or a bare-noun dispatcher
+ * with no subcommand given). */
+export function renderCommandHelp(entry) {
+    const lines = [`noodle ${entry.name} — ${entry.summary}`];
+    if (entry.removed !== undefined) {
+        lines.push('', `Removed. Use: ${entry.removed.use}`);
+        return lines.join('\n');
+    }
+    lines.push('', `Usage: noodle ${entry.name} ${commandUsageToken(entry)}`.trimEnd());
+    if (entry.subcommands !== undefined && entry.subcommands.length > 0) {
+        lines.push('', 'Subcommands:');
+        for (const sub of entry.subcommands)
+            lines.push(renderSubcommandLine(entry.name, sub));
+    }
+    if (entry.flags !== undefined && entry.flags.length > 0) {
+        lines.push('', 'Flags:');
+        for (const flag of entry.flags)
+            lines.push(renderFlagLine(flag));
+    }
+    if (entry.exitCodes !== undefined && Object.keys(entry.exitCodes).length > 0) {
+        lines.push('', 'Additional exit codes:');
+        for (const [code, meaning] of Object.entries(entry.exitCodes)) {
+            lines.push(`  ${code}  ${meaning}`);
+        }
+    }
+    if (entry.local === true) {
+        lines.push('', 'Runs locally — no account or hosted service required.');
+    }
+    return lines.join('\n');
+}
+/** Build the plain-text + suggestion list for an unknown top-level verb. */
+export function unknownCommandInfo(input) {
+    const suggestions = closestCommands(input);
+    const hint = suggestions.length > 0 ? ` Did you mean: ${joinSuggestions(suggestions)}?` : '';
+    return { message: `Unknown command "${input}".${hint}`, suggestions };
+}
+/** Build the plain-text + suggestion list for an unknown subcommand of a known dispatcher. */
+export function unknownSubcommandInfo(entry, input) {
+    const suggestions = closestSubcommands(entry, input);
+    const hint = suggestions.length > 0 ? ` Did you mean: ${joinSuggestions(suggestions)}?` : '';
+    return {
+        message: `Unknown subcommand "${input}" for "${entry.name}".${hint}`,
+        suggestions,
+    };
+}
+// --- noodle commands ---------------------------------------------------------------
+/** Compact grouped human list for `noodle commands` (no `--json`). */
+export function renderCommandsHuman() {
+    const lines = [];
+    for (const entry of CATALOG) {
+        if (entry.removed !== undefined) {
+            lines.push(`  ${entry.name.padEnd(NAME_COLUMN)}(removed — use ${entry.removed.use})`);
+            continue;
+        }
+        lines.push(`  ${entry.name.padEnd(NAME_COLUMN)}${entry.summary}`);
+    }
+    lines.push('', 'Run `noodle <command> --help` for subcommands, flags, and exit codes.');
+    return lines.join('\n');
+}
+/** The full machine-readable catalog payload for `noodle commands --json`. */
+export function buildCatalogJsonPayload(version) {
+    return { commands: CATALOG, exitCodes: STANDARD_EXIT_CODES, version };
+}
+//# sourceMappingURL=catalog-render.js.map

package/dist/commands/catalog-render.js.map

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

package/dist/commands/catalog-types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Types for the CLI's declarative command catalog (`catalog.ts`). Pure type definitions — no
+ * runtime code — so this module has zero import cost for anything that only needs the shapes
+ * (including the doc/skill generator scripts, which read the sibling data modules directly).
+ */
+export interface FlagSpec {
+    /** Flag name without leading dashes, e.g. `'org'` renders as `--org`. */
+    readonly name: string;
+    readonly type: 'string' | 'boolean';
+    /** Placeholder shown for a string flag's value, e.g. `'<slug>'`. Omitted for booleans. */
+    readonly value?: string;
+    /** One-line description shown in per-command help and `commands --json`. */
+    readonly summary?: string;
+}
+export interface SubcommandSpec {
+    readonly name: string;
+    readonly summary: string;
+    readonly flags?: readonly FlagSpec[];
+    /** Positional placeholder(s) after the subcommand name, e.g. `'<app>'`. */
+    readonly positional?: string;
+    /** Full usage-line override for a subcommand whose shape doesn't fit name+positional+flags. */
+    readonly usage?: string;
+}
+/** A hard-removed verb: no longer runs, but stays in the catalog so `commands --json` and
+ * did-you-mean can point at its replacement instead of silently forgetting it existed. */
+export interface RemovedSpec {
+    readonly use: string;
+}
+export interface CommandSpec {
+    readonly name: string;
+    readonly summary: string;
+    readonly subcommands?: readonly SubcommandSpec[];
+    /** Top-level flags. Shown alongside subcommands (flags common to all of them) or standalone
+     * for a command with no subcommands. */
+    readonly flags?: readonly FlagSpec[];
+    /** Top-level positional placeholder for a command with no subcommands, e.g. `'<server.ts>'`. */
+    readonly positional?: string;
+    /** Full usage-line override when derived rendering (name + positional + flags) isn't a good fit. */
+    readonly usage?: string;
+    /** Exit codes beyond the standard 0–4 taxonomy (e.g. `update`'s 10–14, ADR 0118). */
+    readonly exitCodes?: Readonly<Record<number, string>>;
+    readonly removed?: RemovedSpec;
+    /** No account/service required — the command only touches the local project/filesystem. */
+    readonly local?: boolean;
+}
+//# sourceMappingURL=catalog-types.d.ts.map

package/dist/commands/catalog-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-types.d.ts","sourceRoot":"","sources":["../../src/commands/catalog-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;0FAC0F;AAC1F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD;4CACwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oGAAoG;IACpG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,2FAA2F;IAC3F,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/dist/commands/catalog-types.js

@@ -0,0 +1,7 @@
+/**
+ * Types for the CLI's declarative command catalog (`catalog.ts`). Pure type definitions — no
+ * runtime code — so this module has zero import cost for anything that only needs the shapes
+ * (including the doc/skill generator scripts, which read the sibling data modules directly).
+ */
+export {};
+//# sourceMappingURL=catalog-types.js.map

package/dist/commands/catalog-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-types.js","sourceRoot":"","sources":["../../src/commands/catalog-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/commands/catalog.d.ts

@@ -0,0 +1,30 @@
+import type { CommandSpec } from './catalog-types.js';
+export type { CommandSpec, FlagSpec, RemovedSpec, SubcommandSpec } from './catalog-types.js';
+/** The full command catalog, in a stable, curated order (not alphabetical — grouped by workflow). */
+export declare const CATALOG: readonly CommandSpec[];
+/**
+ * The standard CLI exit-code taxonomy (ADR 0129), described for `commands --json` consumers.
+ * Mirrors `EXIT` in `commands/output.ts`; kept as a separate literal here so this module has no
+ * runtime dependency on it (see the "no cross-file runtime imports" rule in `catalog-data-core.ts`
+ * — `output.ts` is never imported by the raw-source doc/skill generators, but `catalog.ts` itself
+ * only needs the numbers/descriptions, not the `EXIT` binding).
+ */
+export declare const STANDARD_EXIT_CODES: Readonly<Record<number, string>>;
+/** Command names that dispatch to at least one subcommand and error on a missing/unknown one —
+ * the set eligible for centralized bare-noun help and subcommand did-you-mean in `cli.ts`. Kept
+ * as an explicit allowlist (not "every catalog entry with `subcommands`") because a few commands
+ * with subcommand-shaped data (e.g. `connect`, `tools`) either treat a bare invocation as
+ * meaningful on their own or resolve state before checking the subcommand token. */
+export declare const SUBCOMMAND_DISPATCHERS: ReadonlySet<string>;
+/** Names to exclude from did-you-mean suggestions: removed verbs. Never point a typo at a dead end. */
+export declare function activeCatalogNames(): readonly string[];
+export declare function findCommand(name: string | undefined): CommandSpec | undefined;
+/** Levenshtein edit distance, iterative DP with an O(min(a,b)) row buffer. */
+export declare function levenshteinDistance(a: string, b: string): number;
+/** Nearest catalog names to `input` within `maxDistance`, closest first, capped at `maxResults`. */
+export declare function closestNames(input: string, pool: readonly string[], maxDistance?: number, maxResults?: number): readonly string[];
+/** Nearest *active* (non-removed) top-level command names to an unknown verb. */
+export declare function closestCommands(input: string, maxDistance?: number, maxResults?: number): readonly string[];
+/** Nearest subcommand names for a catalog entry that has subcommands. */
+export declare function closestSubcommands(entry: CommandSpec, input: string, maxDistance?: number, maxResults?: number): readonly string[];
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/commands/catalog.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE7F,qGAAqG;AACrG,eAAO,MAAM,OAAO,EAAE,SAAS,WAAW,EAIzC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMhE,CAAC;AAEF;;;;oFAIoF;AACpF,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAmBrD,CAAC;AAEH,uGAAuG;AACvG,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAG7E;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBhE;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,WAAW,SAAI,EACf,UAAU,SAAI,GACb,SAAS,MAAM,EAAE,CAOnB;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,SAAI,EAAE,UAAU,SAAI,GAAG,SAAS,MAAM,EAAE,CAEjG;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,SAAI,EACf,UAAU,SAAI,GACb,SAAS,MAAM,EAAE,CAGnB"}

package/dist/commands/catalog.js

@@ -0,0 +1,108 @@
+/**
+ * The CLI's declarative command catalog: the single source of truth `usage()`, per-command
+ * `--help`, `noodle commands --json`, and did-you-mean suggestions all render from. Data lives in
+ * `catalog-data-core.ts` (authoring/local-run-loop + CLI meta-verbs),
+ * `catalog-data-resources.ts` (hosted/tenant/ops commands), and `catalog-data-config.ts`
+ * (deploy-target + managed config); this module merges them and adds the small amount of lookup
+ * logic every renderer needs.
+ *
+ * `test/catalog.test.ts` asserts every `case` in `cli.ts`'s dispatch switch has a matching entry
+ * here (and vice versa) — the anti-drift lock referenced in AGENTS.md.
+ */
+import { CATALOG_CONFIG } from './catalog-data-config.js';
+import { CATALOG_CORE } from './catalog-data-core.js';
+import { CATALOG_RESOURCES } from './catalog-data-resources.js';
+/** The full command catalog, in a stable, curated order (not alphabetical — grouped by workflow). */
+export const CATALOG = [
+    ...CATALOG_CORE,
+    ...CATALOG_RESOURCES,
+    ...CATALOG_CONFIG,
+];
+/**
+ * The standard CLI exit-code taxonomy (ADR 0129), described for `commands --json` consumers.
+ * Mirrors `EXIT` in `commands/output.ts`; kept as a separate literal here so this module has no
+ * runtime dependency on it (see the "no cross-file runtime imports" rule in `catalog-data-core.ts`
+ * — `output.ts` is never imported by the raw-source doc/skill generators, but `catalog.ts` itself
+ * only needs the numbers/descriptions, not the `EXIT` binding).
+ */
+export const STANDARD_EXIT_CODES = {
+    0: 'success',
+    1: 'domain/runtime failure (the request ran but did not succeed)',
+    2: 'usage error, missing target, or headless missing-answer',
+    3: 'authentication/authorization failure (HTTP 401/403)',
+    4: 'service unreachable (network error)',
+};
+/** Command names that dispatch to at least one subcommand and error on a missing/unknown one —
+ * the set eligible for centralized bare-noun help and subcommand did-you-mean in `cli.ts`. Kept
+ * as an explicit allowlist (not "every catalog entry with `subcommands`") because a few commands
+ * with subcommand-shaped data (e.g. `connect`, `tools`) either treat a bare invocation as
+ * meaningful on their own or resolve state before checking the subcommand token. */
+export const SUBCOMMAND_DISPATCHERS = new Set([
+    'apps',
+    'envs',
+    'deployments',
+    'orgs',
+    'members',
+    'github',
+    'target',
+    'secrets',
+    'variables',
+    'agents',
+    'audit',
+    'policy',
+    'service',
+    'docs',
+    'import',
+    'export',
+    'connect',
+    'access',
+]);
+/** Names to exclude from did-you-mean suggestions: removed verbs. Never point a typo at a dead end. */
+export function activeCatalogNames() {
+    return CATALOG.filter((entry) => entry.removed === undefined).map((entry) => entry.name);
+}
+export function findCommand(name) {
+    if (name === undefined)
+        return undefined;
+    return CATALOG.find((entry) => entry.name === name);
+}
+/** Levenshtein edit distance, iterative DP with an O(min(a,b)) row buffer. */
+export function levenshteinDistance(a, b) {
+    if (a === b)
+        return 0;
+    if (a.length === 0)
+        return b.length;
+    if (b.length === 0)
+        return a.length;
+    let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        const current = [i];
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            current.push(Math.min((current[j - 1] ?? 0) + 1, // insertion
+            (previous[j] ?? 0) + 1, // deletion
+            (previous[j - 1] ?? 0) + cost));
+        }
+        previous = current;
+    }
+    return previous[b.length] ?? Math.max(a.length, b.length);
+}
+/** Nearest catalog names to `input` within `maxDistance`, closest first, capped at `maxResults`. */
+export function closestNames(input, pool, maxDistance = 2, maxResults = 3) {
+    return pool
+        .map((name) => ({ name, distance: levenshteinDistance(input, name) }))
+        .filter((entry) => entry.distance <= maxDistance)
+        .sort((a, b) => a.distance - b.distance || a.name.localeCompare(b.name))
+        .slice(0, maxResults)
+        .map((entry) => entry.name);
+}
+/** Nearest *active* (non-removed) top-level command names to an unknown verb. */
+export function closestCommands(input, maxDistance = 2, maxResults = 3) {
+    return closestNames(input, activeCatalogNames(), maxDistance, maxResults);
+}
+/** Nearest subcommand names for a catalog entry that has subcommands. */
+export function closestSubcommands(entry, input, maxDistance = 2, maxResults = 3) {
+    const pool = (entry.subcommands ?? []).map((sub) => sub.name);
+    return closestNames(input, pool, maxDistance, maxResults);
+}
+//# sourceMappingURL=catalog.js.map

package/dist/commands/catalog.js.map

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

package/dist/commands/commands-ops.d.ts

@@ -0,0 +1,2 @@
+export declare function runCommands(rest: readonly string[]): number;
+//# sourceMappingURL=commands-ops.d.ts.map

package/dist/commands/commands-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-ops.d.ts","sourceRoot":"","sources":["../../src/commands/commands-ops.ts"],"names":[],"mappings":"AASA,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAS3D"}

package/dist/commands/commands-ops.js

@@ -0,0 +1,19 @@
+/**
+ * `noodle commands [--json]` — the runtime capability catalog (roadmap item closed by this
+ * module): a compact human list, or the full machine-readable `{ commands, exitCodes, version }`
+ * payload every coding agent can query from the installed binary without reading source.
+ */
+import { currentCliVersion } from '../update.js';
+import { buildCatalogJsonPayload, renderCommandsHuman } from './catalog-render.js';
+import { EXIT, printJsonOk } from './output.js';
+export function runCommands(rest) {
+    const json = rest.includes('--json');
+    const version = currentCliVersion();
+    if (json) {
+        printJsonOk(buildCatalogJsonPayload(version));
+        return EXIT.OK;
+    }
+    console.log(renderCommandsHuman());
+    return EXIT.OK;
+}
+//# sourceMappingURL=commands-ops.js.map

package/dist/commands/commands-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-ops.js","sourceRoot":"","sources":["../../src/commands/commands-ops.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,UAAU,WAAW,CAAC,IAAuB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,IAAI,IAAI,EAAE,CAAC;QACT,WAAW,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC"}

package/dist/commands/deploy-ops.d.ts

@@ -1,13 +1,55 @@
+import { type DeployFireController } from '../fire.js';
 export { assetFailureRecovery, formatAssetSummary } from './deploy-output.js';
+/**
+ * Whether this `deploy` run is eligible for the animated fire band in place of the plain spinner:
+ * a genuinely interactive, colored TTY on *both* streams (dismissal needs stdin), not `--json`,
+ * and not explicitly opted out by setting `NOODLE_NO_FIRE` (any value — presence-based, like
+ * `NO_COLOR`). `CI`/`NO_COLOR` are checked on the INJECTED env (presence, mirroring
+ * `detectColorMode`'s semantics) so the gate honors its seam rather than only the global env.
+ */
+export declare function shouldRunDeployFire(opts: {
+    readonly json: boolean;
+    readonly stdout: {
+        readonly isTTY?: boolean;
+    };
+    readonly stdin: {
+        readonly isTTY?: boolean;
+    };
+    readonly env: NodeJS.ProcessEnv;
+}): boolean;
+/**
+ * Wrap a `fetch` so the fire band's progress reflects real network milestones instead of a timer:
+ * the first call proves compile finished (nothing else could have made a request yet); the assets
+ * preflight response proves assets are checked; each asset upload nudges progress toward the upload
+ * milestone; and starting the final `/deploy` POST proves uploads are done (deploy.ts always awaits
+ * them first) and marks entry into the indeterminate activate wait — which a deploy that packaged no
+ * assets also reaches directly, correctly collapsing the assets/upload stages to instant.
+ */
+export declare function instrumentFireFetch(base: typeof fetch, fire: DeployFireController): typeof fetch;
+/**
+ * Print the one-time `tip: deploy on every push` nudge after a successful interactive deploy, when
+ * the project is a GitHub-remoted git repo and the hint hasn't been shown before.
+ */
+export declare function maybePrintGithubHint(cwd?: string): void;
 export declare function runDeploy(rest: readonly string[], env: NodeJS.ProcessEnv, home: string): Promise<number>;
 export declare function runOpen(rest: readonly string[], env: NodeJS.ProcessEnv, home: string): number;
+/**
+ * The shared "auto-open a browser here?" gate: true only on an interactive TTY that isn't `CI`.
+ * `printOrOpenUrl` (below) and `noodle github connect`'s install-URL opener share this one decision
+ * instead of each re-deriving the headless-vs-interactive check.
+ */
+export declare function shouldOpenBrowser(env: NodeJS.ProcessEnv): boolean;
+/**
+ * The shared open-vs-print decision every URL-opening command uses: headless (`--print`, `CI`,
+ * or a non-TTY stdout) just prints the URL; an interactive TTY also opens it in the browser.
+ * Exported so `apps open` (which resolves its URL from the hosted API rather than a local
+ * deployment cache) reuses the exact same decision instead of re-implementing it.
+ */
+export declare function printOrOpenUrl(url: string, env: NodeJS.ProcessEnv, printOnly: boolean): void;
 export declare function serviceUrlFromLegacy(server: {
     readonly url: string;
 } | undefined): string | undefined;
 export declare function openUrl(url: string): void;
-export declare function runStatus(rest: readonly string[], env: NodeJS.ProcessEnv, home: string): Promise<number>;
-export declare function runRollback(rest: readonly string[], env: NodeJS.ProcessEnv, home: string): Promise<number>;
-export declare function runAccess(rest: readonly string[], env: NodeJS.ProcessEnv, home: string): Promise<number>;
 export declare function missingSecretNames(errors: unknown): string[];
 export declare function secretSetCommand(name: string, target: {
     readonly org: string;

package/dist/commands/deploy-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-ops.d.ts","sourceRoot":"","sources":["../../src/commands/deploy-ops.ts"],"names":[],"mappings":"AAyCA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAiUjB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA6B7F;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC3C,MAAM,GAAG,SAAS,CAQpB;AAUD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKzC;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAmEjB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CA6HjB;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAyEjB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAiB5D;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3E,MAAM,CAKR"}
+{"version":3,"file":"deploy-ops.d.ts","sourceRoot":"","sources":["../../src/commands/deploy-ops.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,oBAAoB,EAA6B,MAAM,YAAY,CAAC;AAqClF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI9E;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACjC,GAAG,OAAO,CAUV;AAQD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,KAAK,CA+BhG;AA0CD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAsB,GAAG,IAAI,CAItE;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAsWjB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAwB7F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAO5F;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC3C,MAAM,GAAG,SAAS,CAQpB;AAUD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAKzC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAiB5D;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3E,MAAM,CAKR"}