@rasensio/aidlc 1.9.1 → 1.10.1

package/README.md

@@ -37,6 +37,8 @@ The CLI has two core jobs: **bootstrap** (installing and refreshing skills) and
 
 | Command | Purpose |
 |---------|---------|
+| `aidlc` (no arguments) | Interactive menu of common commands; each entry shows the command it runs |
+| `aidlc menu` | The same menu, addressable by name |
 | `aidlc init [--platform <id>]` | Set up AIDLC: interactive wizard, or non-interactive with `--platform` |
 | `aidlc update` | Update CLI and refresh project skills |
 | `aidlc gate <phase>` | CI gate check (exit 0 = pass, 1 = fail) |

package/dist/cli.d.ts

@@ -7,5 +7,22 @@
  *
  * Requirements: 17.1
  */
-export {};
+import { Command } from 'commander';
+/**
+ * Build the fully-registered commander program.
+ *
+ * Exported so tests and the interactive menu can obtain the program without
+ * running the CLI. Registration order is load-bearing: commander renders the
+ * `--help` Commands section in this order (interactive-cli-menu/AC-5).
+ */
+export declare function buildProgram(): Command;
+/**
+ * Whether this module is the process entry point.
+ *
+ * `import.meta.main` expresses this directly but is not typed by TypeScript
+ * 5.8, so compare resolved real paths instead — verified to agree with
+ * `import.meta.main` when run directly, when imported, and when invoked through
+ * a symlink (how npm installs the `aidlc` bin).
+ */
+export declare function isMainModule(metaUrl: string, entry?: string | undefined): boolean;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAeH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,OAAO,CA+BtC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAM,GAAG,SAA2B,GAC1C,OAAO,CAQT"}

package/dist/cli.js

@@ -18,7 +18,7 @@ process.on('warning', (warning) => {
     for (const listener of defaultWarningListeners)
         listener(warning);
 });
-import { readFileSync } from 'node:fs';
+import { readFileSync, realpathSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { resolve, dirname } from 'node:path';
 import { Command } from 'commander';
@@ -39,30 +39,80 @@ import { registerClaim } from './commands/claim.js';
 import { registerMetrics } from './commands/metrics.js';
 import { registerDoctor } from './commands/doctor.js';
 import { registerAddSkill } from './commands/add-skill.js';
+import { registerMenu } from './commands/menu.js';
+import { isBareInvocation } from './menu/invocation.js';
+import { openMenu } from './menu/index.js';
 const pkg = JSON.parse(readFileSync(resolve(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8'));
-const program = new Command();
-program
-    .name('aidlc')
-    .description('AI Development Lifecycle Framework')
-    .version(pkg.version);
-registerInit(program);
-registerStart(program);
-registerContinue(program);
-registerStatus(program);
-registerGate(program);
-registerTransition(program);
-registerDiscover(program);
-registerAddAction(program);
-registerDocs(program);
-registerReview(program);
-registerUpdate(program);
-registerKnowledge(program);
-registerCost(program);
-registerClaim(program);
-registerMetrics(program);
-registerDoctor(program);
-registerAddSkill(program);
-// parseAsync: async command actions (doctor's confirm prompt, knowledge's
-// merge-driver install) must be awaited so exit codes land reliably.
-await program.parseAsync();
+/**
+ * Build the fully-registered commander program.
+ *
+ * Exported so tests and the interactive menu can obtain the program without
+ * running the CLI. Registration order is load-bearing: commander renders the
+ * `--help` Commands section in this order (interactive-cli-menu/AC-5).
+ */
+export function buildProgram() {
+    const program = new Command();
+    program
+        .name('aidlc')
+        .description('AI Development Lifecycle Framework')
+        .version(pkg.version);
+    registerInit(program);
+    registerStart(program);
+    registerContinue(program);
+    registerStatus(program);
+    registerGate(program);
+    registerTransition(program);
+    registerDiscover(program);
+    registerAddAction(program);
+    registerDocs(program);
+    registerReview(program);
+    registerUpdate(program);
+    registerKnowledge(program);
+    registerCost(program);
+    registerClaim(program);
+    registerMetrics(program);
+    registerDoctor(program);
+    registerAddSkill(program);
+    // Last, so `menu` renders last in `aidlc --help` (interactive-cli-menu/AC-5).
+    // Takes the factory, not `program`: the menu dispatches on a throwaway copy so
+    // the caller's program never carries an `exitOverride` it cannot undo.
+    registerMenu(program, buildProgram);
+    return program;
+}
+/**
+ * Whether this module is the process entry point.
+ *
+ * `import.meta.main` expresses this directly but is not typed by TypeScript
+ * 5.8, so compare resolved real paths instead — verified to agree with
+ * `import.meta.main` when run directly, when imported, and when invoked through
+ * a symlink (how npm installs the `aidlc` bin).
+ */
+export function isMainModule(metaUrl, entry = process.argv[1]) {
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(metaUrl)) === realpathSync(entry);
+    }
+    catch {
+        // Either path may not exist (bundled, deleted, or a virtual entry).
+        return false;
+    }
+}
+// The main-module guard is load-bearing, not tidiness
+// (interactive-cli-menu/AC-38): without it, importing this module runs the CLI
+// against the host process's argv — and a vitest worker's argv is length 2, the
+// very shape the bare-invocation guard treats as "open the menu".
+if (isMainModule(import.meta.url)) {
+    if (isBareInvocation(process.argv)) {
+        // Bare `aidlc` only. An argv guard rather than a root `.action()`: the
+        // latter changes commander's unknown-command diagnostic to "too many
+        // arguments" (interactive-cli-menu/AC-3, interactive-cli-menu/AC-8).
+        await openMenu(buildProgram, 'bare');
+    }
+    else {
+        // parseAsync: async command actions (doctor's confirm prompt, knowledge's
+        // merge-driver install) must be awaited so exit codes land reliably.
+        await buildProgram().parseAsync();
+    }
+}
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/menu.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `aidlc menu` — the interactive command launcher
+ * (interactive-cli-menu/AC-1, interactive-cli-menu/AC-2).
+ *
+ * Bare `aidlc` opens the same menu through the argv guard in `cli.ts`; this
+ * command makes it addressable, so the behaviour is testable without depending
+ * on how the process was invoked.
+ *
+ * @module
+ */
+import type { Command } from 'commander';
+/**
+ * Register the `menu` command.
+ *
+ * Registered **last** in `buildProgram()` so `menu` appears last in
+ * `aidlc --help`: commander renders the Commands section in registration order,
+ * which keeps the help-screen diff to a single appended line
+ * (interactive-cli-menu/AC-5).
+ */
+export declare function registerMenu(program: Command, makeProgram: () => Command): void;
+//# sourceMappingURL=menu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../src/commands/menu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,GAAG,IAAI,CAc/E"}

package/dist/commands/menu.js

@@ -0,0 +1,32 @@
+/**
+ * `aidlc menu` — the interactive command launcher
+ * (interactive-cli-menu/AC-1, interactive-cli-menu/AC-2).
+ *
+ * Bare `aidlc` opens the same menu through the argv guard in `cli.ts`; this
+ * command makes it addressable, so the behaviour is testable without depending
+ * on how the process was invoked.
+ *
+ * @module
+ */
+import { openMenu } from '../menu/index.js';
+/**
+ * Register the `menu` command.
+ *
+ * Registered **last** in `buildProgram()` so `menu` appears last in
+ * `aidlc --help`: commander renders the Commands section in registration order,
+ * which keeps the help-screen diff to a single appended line
+ * (interactive-cli-menu/AC-5).
+ */
+export function registerMenu(program, makeProgram) {
+    program
+        .command('menu')
+        .description('Interactive menu of common commands (also: run `aidlc` with no arguments)')
+        .addHelpText('after', `
+Every entry shows the command it runs, so the menu teaches the flag-driven CLI
+rather than replacing it. Requires an interactive terminal.
+`)
+        .action(async () => {
+        await openMenu(makeProgram, 'menu');
+    });
+}
+//# sourceMappingURL=menu.js.map

package/dist/commands/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../src/commands/menu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,WAA0B;IACvE,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,2EAA2E,CAAC;SACxF,WAAW,CACV,OAAO,EACP;;;CAGL,CACI;SACA,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/menu/dispatch.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Argv construction and command re-dispatch (interactive-cli-menu/AC-22,
+ * interactive-cli-menu/AC-23, interactive-cli-menu/AC-24,
+ * interactive-cli-menu/AC-25, interactive-cli-menu/AC-36,
+ * interactive-cli-menu/AC-37).
+ *
+ * A selected entry runs through commander's own parser, so there is exactly one
+ * code path per command and every option default, coercion, and validation still
+ * applies. No command's logic is reimplemented here.
+ *
+ * @module
+ */
+import type { Command } from 'commander';
+import { CommanderError } from 'commander';
+import type { MenuEntry } from './roster.js';
+/** Every command in a tree, root first. */
+export declare function allCommands(cmd: Command): Command[];
+/**
+ * Build the argv for a selected entry (interactive-cli-menu/AC-37).
+ *
+ * Prompted values go after a `--` separator so commander can never parse one as
+ * an option: without it, a user typing `--json` at a term prompt produces
+ * `error: unknown option`, and one typing `--help` gets help printed with exit 0
+ * — a silent success that ran nothing. With it, both arrive as literal values.
+ *
+ * The `['node','aidlc']` prefix matches commander's default `from: 'node'`,
+ * which treats argv[0]/argv[1] as the exec path and script and parses from
+ * index 2. No separator is emitted when there are no values.
+ */
+export declare function buildArgv(entry: MenuEntry, values?: readonly string[]): string[];
+export interface RunOutcome {
+    /** The command's action ran to completion. */
+    ran: boolean;
+    /** Set when commander threw instead of dispatching. */
+    commanderError?: CommanderError;
+    /**
+     * Commander wrote help or version output and "failed" with exit code 0.
+     * Not an error — the user got what they asked for.
+     */
+    displayedHelp?: boolean;
+}
+/**
+ * Re-dispatch a synthesized argv through a commander program
+ * (interactive-cli-menu/AC-22, interactive-cli-menu/AC-36).
+ *
+ * A **fresh** program is built for the dispatch rather than reusing the caller's.
+ * `exitOverride()` has no public un-set, and commander copies inherited settings
+ * into a subcommand at *creation* time — so overriding a shared program means
+ * either leaving it permanently mutated (a later parse would throw where it used
+ * to exit) or reaching for the private `_exitCallback` to restore it. A
+ * throwaway program avoids both, and re-registers through the same `registerX`
+ * functions, so it is the same code path per command.
+ *
+ * The recursion is mandatory: applied to the root alone *after* the subcommands
+ * exist, `exitOverride` is a no-op for every one of them and the process exits
+ * from inside the nested parse.
+ */
+export declare function runEntry(makeProgram: () => Command, argv: readonly string[]): Promise<RunOutcome>;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/menu/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/menu/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,EAAE,CAEnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,EAAE,CAOpF;AAED,MAAM,WAAW,UAAU;IACzB,8CAA8C;IAC9C,GAAG,EAAE,OAAO,CAAC;IACb,uDAAuD;IACvD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,OAAO,EAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC,UAAU,CAAC,CAmBrB"}

package/dist/menu/dispatch.js

@@ -0,0 +1,76 @@
+/**
+ * Argv construction and command re-dispatch (interactive-cli-menu/AC-22,
+ * interactive-cli-menu/AC-23, interactive-cli-menu/AC-24,
+ * interactive-cli-menu/AC-25, interactive-cli-menu/AC-36,
+ * interactive-cli-menu/AC-37).
+ *
+ * A selected entry runs through commander's own parser, so there is exactly one
+ * code path per command and every option default, coercion, and validation still
+ * applies. No command's logic is reimplemented here.
+ *
+ * @module
+ */
+import { CommanderError } from 'commander';
+/** Every command in a tree, root first. */
+export function allCommands(cmd) {
+    return [cmd, ...cmd.commands.flatMap(allCommands)];
+}
+/**
+ * Build the argv for a selected entry (interactive-cli-menu/AC-37).
+ *
+ * Prompted values go after a `--` separator so commander can never parse one as
+ * an option: without it, a user typing `--json` at a term prompt produces
+ * `error: unknown option`, and one typing `--help` gets help printed with exit 0
+ * — a silent success that ran nothing. With it, both arrive as literal values.
+ *
+ * The `['node','aidlc']` prefix matches commander's default `from: 'node'`,
+ * which treats argv[0]/argv[1] as the exec path and script and parses from
+ * index 2. No separator is emitted when there are no values.
+ */
+export function buildArgv(entry, values = []) {
+    return [
+        'node',
+        'aidlc',
+        ...entry.path,
+        ...(values.length > 0 ? ['--', ...values] : []),
+    ];
+}
+/**
+ * Re-dispatch a synthesized argv through a commander program
+ * (interactive-cli-menu/AC-22, interactive-cli-menu/AC-36).
+ *
+ * A **fresh** program is built for the dispatch rather than reusing the caller's.
+ * `exitOverride()` has no public un-set, and commander copies inherited settings
+ * into a subcommand at *creation* time — so overriding a shared program means
+ * either leaving it permanently mutated (a later parse would throw where it used
+ * to exit) or reaching for the private `_exitCallback` to restore it. A
+ * throwaway program avoids both, and re-registers through the same `registerX`
+ * functions, so it is the same code path per command.
+ *
+ * The recursion is mandatory: applied to the root alone *after* the subcommands
+ * exist, `exitOverride` is a no-op for every one of them and the process exits
+ * from inside the nested parse.
+ */
+export async function runEntry(makeProgram, argv) {
+    const program = makeProgram();
+    for (const cmd of allCommands(program))
+        cmd.exitOverride();
+    try {
+        await program.parseAsync([...argv]);
+        return { ran: true };
+    }
+    catch (error) {
+        if (error instanceof CommanderError) {
+            // A CommanderError is not necessarily a failure: under exitOverride,
+            // `--help` throws commander.helpDisplayed and `--version` throws
+            // commander.version, both with exitCode 0. Honour the code commander
+            // chose rather than assuming 1 (interactive-cli-menu/AC-25).
+            const displayedHelp = error.exitCode === 0;
+            if (!displayedHelp)
+                process.exitCode = error.exitCode;
+            return { ran: false, commanderError: error, displayedHelp };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/menu/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/menu/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAI3C,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,SAA4B,EAAE;IACxE,OAAO;QACL,MAAM;QACN,OAAO;QACP,GAAG,KAAK,CAAC,IAAI;QACb,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC;AAcD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,WAA0B,EAC1B,IAAuB;IAEvB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC;QAAE,GAAG,CAAC,YAAY,EAAE,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACpC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,qEAAqE;YACrE,iEAAiE;YACjE,qEAAqE;YACrE,6DAA6D;YAC7D,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,aAAa;gBAAE,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YACtD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAC9D,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/menu/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Interactive menu orchestration (interactive-cli-menu/AC-10,
+ * interactive-cli-menu/AC-13, interactive-cli-menu/AC-14,
+ * interactive-cli-menu/AC-18, interactive-cli-menu/AC-19,
+ * interactive-cli-menu/AC-20, interactive-cli-menu/AC-26,
+ * interactive-cli-menu/AC-29, interactive-cli-menu/AC-31,
+ * interactive-cli-menu/AC-35).
+ *
+ * Reads **no** lifecycle state: no `.aidlc/`, no git, no template loading, no
+ * network. The menu answers "what commands exist", never "what should I do
+ * next?" — that question belongs to the `aidlc` skill, which cannot depend on
+ * the CLI at runtime, so a second state-aware implementation here would drift
+ * from it permanently.
+ *
+ * @module
+ */
+import type { Command } from 'commander';
+import { type MenuDeps } from './prompt.js';
+import { type MenuEntry } from './roster.js';
+/** Which entry point asked for the menu; selects the non-interactive fallback. */
+export type MenuMode = 'bare' | 'menu';
+/**
+ * The equivalent command form for an entry (interactive-cli-menu/AC-14).
+ *
+ * This is the teaching string: what the user would type to do the same thing
+ * without the menu. The `--` separator `buildArgv` inserts is deliberately
+ * omitted — it is a parser safeguard, not part of a command anyone types.
+ */
+export declare function commandForm(entry: MenuEntry, values?: readonly string[]): string;
+/**
+ * Non-interactive fallbacks (interactive-cli-menu/AC-10,
+ * interactive-cli-menu/AC-31).
+ *
+ * `'bare'` preserves today's contract exactly — the program help on stderr, zero
+ * bytes on stdout, exit 1 — because the argv guard runs before `parseAsync`, so
+ * commander never emits its own no-args help. `outputHelp` is used rather than
+ * `help`, which calls `_exit`.
+ *
+ * `'menu'` is a deliberate non-replay: the user named a valid command, so the
+ * diagnostic is about the terminal, not the command surface.
+ */
+export declare function writeNonInteractiveFallback(program: Command, mode: MenuMode): void;
+/**
+ * Open the interactive menu.
+ *
+ * @param makeProgram Factory for a fully-registered program. A factory rather
+ *   than an instance because `runEntry` dispatches on a throwaway copy, leaving
+ *   the caller's program free of an `exitOverride` it could not undo.
+ */
+export declare function openMenu(makeProgram: () => Command, mode?: MenuMode, deps?: MenuDeps): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/menu/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,CAEpF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CASlF;AAgBD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,OAAO,EAC1B,IAAI,GAAE,QAAiB,EACvB,IAAI,GAAE,QAAsB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmDf"}

package/dist/menu/index.js

@@ -0,0 +1,117 @@
+/**
+ * Interactive menu orchestration (interactive-cli-menu/AC-10,
+ * interactive-cli-menu/AC-13, interactive-cli-menu/AC-14,
+ * interactive-cli-menu/AC-18, interactive-cli-menu/AC-19,
+ * interactive-cli-menu/AC-20, interactive-cli-menu/AC-26,
+ * interactive-cli-menu/AC-29, interactive-cli-menu/AC-31,
+ * interactive-cli-menu/AC-35).
+ *
+ * Reads **no** lifecycle state: no `.aidlc/`, no git, no template loading, no
+ * network. The menu answers "what commands exist", never "what should I do
+ * next?" — that question belongs to the `aidlc` skill, which cannot depend on
+ * the CLI at runtime, so a second state-aware implementation here would drift
+ * from it permanently.
+ *
+ * @module
+ */
+import { buildArgv, runEntry } from './dispatch.js';
+import { CANCEL, defaultDeps, requireNonEmpty, } from './prompt.js';
+import { hintFor, requiredArgs, resolveEntry } from './resolve.js';
+import { ROSTER } from './roster.js';
+/**
+ * The equivalent command form for an entry (interactive-cli-menu/AC-14).
+ *
+ * This is the teaching string: what the user would type to do the same thing
+ * without the menu. The `--` separator `buildArgv` inserts is deliberately
+ * omitted — it is a parser safeguard, not part of a command anyone types.
+ */
+export function commandForm(entry, values = []) {
+    return ['aidlc', ...entry.path, ...values].join(' ');
+}
+/**
+ * Non-interactive fallbacks (interactive-cli-menu/AC-10,
+ * interactive-cli-menu/AC-31).
+ *
+ * `'bare'` preserves today's contract exactly — the program help on stderr, zero
+ * bytes on stdout, exit 1 — because the argv guard runs before `parseAsync`, so
+ * commander never emits its own no-args help. `outputHelp` is used rather than
+ * `help`, which calls `_exit`.
+ *
+ * `'menu'` is a deliberate non-replay: the user named a valid command, so the
+ * diagnostic is about the terminal, not the command surface.
+ */
+export function writeNonInteractiveFallback(program, mode) {
+    if (mode === 'bare') {
+        program.outputHelp({ error: true });
+    }
+    else {
+        process.stderr.write('menu requires an interactive terminal; run `aidlc --help` for the command list\n');
+    }
+    process.exitCode = 1;
+}
+/** Build the select options: curated label + command form, description as hint. */
+function optionsFor(program) {
+    return ROSTER.map((entry, index) => {
+        const cmd = resolveEntry(program, entry);
+        return {
+            value: String(index),
+            // AC-14: every entry carries its equivalent command form, not just the
+            // one the user ends up picking.
+            label: `${entry.label}  ·  ${commandForm(entry)}`,
+            hint: cmd ? hintFor(cmd) : undefined,
+        };
+    });
+}
+/**
+ * Open the interactive menu.
+ *
+ * @param makeProgram Factory for a fully-registered program. A factory rather
+ *   than an instance because `runEntry` dispatches on a throwaway copy, leaving
+ *   the caller's program free of an `exitOverride` it could not undo.
+ */
+export async function openMenu(makeProgram, mode = 'bare', deps = defaultDeps) {
+    const program = makeProgram();
+    if (!deps.interactive()) {
+        writeNonInteractiveFallback(program, mode);
+        return;
+    }
+    deps.intro(`aidlc v${program.version() ?? ''}`);
+    const choice = await deps.select({
+        message: 'What do you want to do?',
+        options: optionsFor(program),
+    });
+    if (choice === CANCEL) {
+        deps.outro('cancelled');
+        return;
+    }
+    const entry = ROSTER[Number(choice)];
+    if (!entry) {
+        deps.outro('cancelled');
+        return;
+    }
+    const values = [];
+    // `start` runs its own template picker and offers the isolation choice via
+    // the concurrency gate, so prompting here would duplicate it (AC-35).
+    if (!entry.delegatesArgs) {
+        const leaf = resolveEntry(program, entry);
+        for (const arg of leaf ? requiredArgs(leaf) : []) {
+            const value = await deps.text({
+                message: `${entry.label} — ${arg.name()}`,
+                validate: requireNonEmpty(arg.name()),
+            });
+            // Cancel at any depth returns before dispatch, so there is no partial
+            // side effect to unwind: nothing has run yet (AC-26).
+            if (value === CANCEL) {
+                deps.outro('cancelled');
+                return;
+            }
+            values.push(value);
+        }
+    }
+    // Close this clack session BEFORE dispatching: `aidlc init` opens its own
+    // intro, and nesting them stacks two session headers while leaving the
+    // menu's unclosed. The outro doubles as the AC-14 teaching line.
+    deps.outro(commandForm(entry, values));
+    await runEntry(makeProgram, buildArgv(entry, values));
+}
+//# sourceMappingURL=index.js.map

package/dist/menu/index.js.map

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

package/dist/menu/invocation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Bare-invocation detection (interactive-cli-menu/AC-3).
+ *
+ * The zero-argument case is dispatched by an argv guard evaluated *before*
+ * `program.parseAsync()`, never by a root `.action()` handler. A root action
+ * changes commander's unknown-command diagnostic from
+ * `error: unknown command 'x'` to `error: too many arguments. Expected 0
+ * arguments but got 1: x.`, which would break the untouched-CLI contract
+ * (interactive-cli-menu/AC-8).
+ *
+ * @module
+ */
+/**
+ * Whether this is a bare `aidlc` invocation — no arguments, no flags.
+ *
+ * `argv` is a full Node argv: `[execPath, scriptPath, ...args]`, so "no
+ * arguments" is length 2 exactly. Anything longer belongs to commander.
+ */
+export declare function isBareInvocation(argv: readonly string[]): boolean;
+//# sourceMappingURL=invocation.d.ts.map

package/dist/menu/invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../src/menu/invocation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAEjE"}

package/dist/menu/invocation.js

@@ -0,0 +1,22 @@
+/**
+ * Bare-invocation detection (interactive-cli-menu/AC-3).
+ *
+ * The zero-argument case is dispatched by an argv guard evaluated *before*
+ * `program.parseAsync()`, never by a root `.action()` handler. A root action
+ * changes commander's unknown-command diagnostic from
+ * `error: unknown command 'x'` to `error: too many arguments. Expected 0
+ * arguments but got 1: x.`, which would break the untouched-CLI contract
+ * (interactive-cli-menu/AC-8).
+ *
+ * @module
+ */
+/**
+ * Whether this is a bare `aidlc` invocation — no arguments, no flags.
+ *
+ * `argv` is a full Node argv: `[execPath, scriptPath, ...args]`, so "no
+ * arguments" is length 2 exactly. Anything longer belongs to commander.
+ */
+export function isBareInvocation(argv) {
+    return argv.length === 2;
+}
+//# sourceMappingURL=invocation.js.map

package/dist/menu/invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.js","sourceRoot":"","sources":["../../src/menu/invocation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/menu/prompt.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Prompt seam for the interactive menu (interactive-cli-menu/AC-12,
+ * interactive-cli-menu/AC-13, interactive-cli-menu/AC-26).
+ *
+ * The only module that imports `@clack/prompts`. Everything the menu does that
+ * touches a terminal goes through `MenuDeps`, so tests drive both the
+ * interactive and non-interactive branches without emulating a TTY — the same
+ * shape as the doctor's injectable `ConfirmFn`.
+ *
+ * @module
+ */
+/**
+ * Cancellation sentinel, owned by this module.
+ *
+ * Deliberately *not* a re-export: `@clack/prompts` exports no symbol at all. Its
+ * cancel value is a private `Symbol("clack:cancel")` that is not
+ * `Symbol.for`-registered, so it can be neither imported nor reconstructed —
+ * only the `isCancel()` predicate is public, which is why every call site in
+ * this package uses that. The clack-backed adapters below translate, so injected
+ * test doubles return exactly what production returns.
+ */
+export declare const CANCEL: unique symbol;
+export interface SelectRequest {
+    message: string;
+    options: {
+        value: string;
+        label: string;
+        hint?: string;
+    }[];
+}
+export interface TextRequest {
+    message: string;
+    placeholder?: string;
+    /**
+     * Return a message to reject the value and re-prompt.
+     *
+     * The value is optional because clack passes `undefined` before the field has
+     * been touched — which is exactly the empty case that must be rejected.
+     */
+    validate?: (value: string | undefined) => string | undefined;
+}
+export type SelectFn = (req: SelectRequest) => Promise<string | typeof CANCEL>;
+export type TextFn = (req: TextRequest) => Promise<string | typeof CANCEL>;
+export interface MenuDeps {
+    select: SelectFn;
+    text: TextFn;
+    /** Whether an interactive prompt can be rendered at all. */
+    interactive: () => boolean;
+    intro: (message: string) => void;
+    outro: (message: string) => void;
+}
+/**
+ * Both streams must be a TTY (interactive-cli-menu/AC-10).
+ *
+ * clack reads keys from stdin and renders to stdout, so either alone is
+ * insufficient: `aidlc | less` has a TTY stdin with a piped stdout and would
+ * paint escape sequences into the pipe, while `echo x | aidlc` has the reverse
+ * and would render a prompt nobody can answer. Both idioms exist in this package
+ * (`commands/cost.ts` keys on stdin, `doctor/context.ts` on stdout), so the
+ * conjunction is stated explicitly rather than inherited from a precedent.
+ */
+export declare function isInteractive(): boolean;
+/**
+ * Reject empty or whitespace-only input for a required positional.
+ *
+ * clack's text prompt yields `''` — not the cancel symbol — when Enter is
+ * pressed on an empty field with no default, so without this the menu would
+ * dispatch a meaningless invocation the user cannot distinguish from a cancel.
+ * Commander would reject a missing `<arg>`; this rejects it earlier, where the
+ * user can still fix it.
+ */
+export declare function requireNonEmpty(label: string): (value: string | undefined) => string | undefined;
+export declare const defaultDeps: MenuDeps;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/menu/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/menu/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,EAAE,OAAO,MAAoC,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,GAAG,OAAO,MAAM,CAAC,CAAC;AAC/E,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,GAAG,OAAO,MAAM,CAAC,CAAC;AAE3E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GACZ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAEnD;AAED,eAAO,MAAM,WAAW,EAAE,QAMzB,CAAC"}

package/dist/menu/prompt.js

@@ -0,0 +1,71 @@
+/**
+ * Prompt seam for the interactive menu (interactive-cli-menu/AC-12,
+ * interactive-cli-menu/AC-13, interactive-cli-menu/AC-26).
+ *
+ * The only module that imports `@clack/prompts`. Everything the menu does that
+ * touches a terminal goes through `MenuDeps`, so tests drive both the
+ * interactive and non-interactive branches without emulating a TTY — the same
+ * shape as the doctor's injectable `ConfirmFn`.
+ *
+ * @module
+ */
+import * as clack from '@clack/prompts';
+/**
+ * Cancellation sentinel, owned by this module.
+ *
+ * Deliberately *not* a re-export: `@clack/prompts` exports no symbol at all. Its
+ * cancel value is a private `Symbol("clack:cancel")` that is not
+ * `Symbol.for`-registered, so it can be neither imported nor reconstructed —
+ * only the `isCancel()` predicate is public, which is why every call site in
+ * this package uses that. The clack-backed adapters below translate, so injected
+ * test doubles return exactly what production returns.
+ */
+export const CANCEL = Symbol('aidlc:menu:cancel');
+/**
+ * Both streams must be a TTY (interactive-cli-menu/AC-10).
+ *
+ * clack reads keys from stdin and renders to stdout, so either alone is
+ * insufficient: `aidlc | less` has a TTY stdin with a piped stdout and would
+ * paint escape sequences into the pipe, while `echo x | aidlc` has the reverse
+ * and would render a prompt nobody can answer. Both idioms exist in this package
+ * (`commands/cost.ts` keys on stdin, `doctor/context.ts` on stdout), so the
+ * conjunction is stated explicitly rather than inherited from a precedent.
+ */
+export function isInteractive() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+const clackSelect = async (req) => {
+    const value = await clack.select({
+        message: req.message,
+        options: req.options,
+    });
+    return clack.isCancel(value) ? CANCEL : value;
+};
+const clackText = async (req) => {
+    const value = await clack.text({
+        message: req.message,
+        placeholder: req.placeholder,
+        validate: req.validate,
+    });
+    return clack.isCancel(value) ? CANCEL : value;
+};
+/**
+ * Reject empty or whitespace-only input for a required positional.
+ *
+ * clack's text prompt yields `''` — not the cancel symbol — when Enter is
+ * pressed on an empty field with no default, so without this the menu would
+ * dispatch a meaningless invocation the user cannot distinguish from a cancel.
+ * Commander would reject a missing `<arg>`; this rejects it earlier, where the
+ * user can still fix it.
+ */
+export function requireNonEmpty(label) {
+    return (value) => ((value ?? '').trim() === '' ? `${label} is required` : undefined);
+}
+export const defaultDeps = {
+    select: clackSelect,
+    text: clackText,
+    interactive: isInteractive,
+    intro: (message) => clack.intro(message),
+    outro: (message) => clack.outro(message),
+};
+//# sourceMappingURL=prompt.js.map

package/dist/menu/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/menu/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AAExC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,MAAM,GAAkB,MAAM,CAAC,mBAAmB,CAAC,CAAC;AA+BjE;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AACvE,CAAC;AAED,MAAM,WAAW,GAAa,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,KAAgB,CAAC;AAC5D,CAAC,CAAC;AAEF,MAAM,SAAS,GAAW,KAAK,EAAE,GAAG,EAAE,EAAE;IACtC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC;QAC7B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,KAAgB,CAAC;AAC5D,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAa;IAEb,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAa;IACnC,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;IACxC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;CACzC,CAAC"}

package/dist/menu/resolve.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Roster → commander resolution (interactive-cli-menu/AC-16,
+ * interactive-cli-menu/AC-17, interactive-cli-menu/AC-34).
+ *
+ * Pure functions over a commander program. Required positionals are derived
+ * structurally from `registeredArguments` rather than restated in the roster, so
+ * the prompt set cannot go stale when a command's signature changes.
+ *
+ * @module
+ */
+import type { Argument, Command } from 'commander';
+import { type MenuEntry } from './roster.js';
+/**
+ * Walk an entry's path from the program root to its leaf command.
+ *
+ * @returns the leaf `Command`, or `null` if any segment is unregistered.
+ */
+export declare function resolveEntry(program: Command, entry: MenuEntry): Command | null;
+/**
+ * Required positional arguments of a command, in declaration order
+ * (interactive-cli-menu/AC-34).
+ *
+ * `registeredArguments` is public commander API. Across the roster only
+ * `review <instance> <artifact>` and `knowledge query <term>` have any.
+ */
+export declare function requiredArgs(cmd: Command): readonly Argument[];
+/**
+ * Secondary hint text for an entry: the leaf command's own description
+ * (interactive-cli-menu/AC-16). Never used as the label.
+ */
+export declare function hintFor(cmd: Command): string;
+/**
+ * Top-level command names on the program.
+ *
+ * Deliberately performs no hidden-command *detection*: `program.commands`
+ * already contains hidden commands (verified with the deprecated `setup`
+ * alias), `Command` exposes no public `hidden` accessor — the `hidden: boolean`
+ * in commander's typings belongs to `Option` — and the private `_hidden` must
+ * not be relied on. Commander's synthetic `help` command is absent from
+ * `program.commands` and needs no entry.
+ */
+export declare function allTopLevelNames(program: Command): string[];
+/**
+ * Top-level names the roster accounts for — first path segments only.
+ *
+ * A nested entry such as `['knowledge','query']` accounts for nothing beyond
+ * `knowledge`'s appearance as a *rostered* name, which is why `knowledge` is
+ * also carried in `EXCLUSIONS`: the parent itself is not on the menu.
+ */
+export declare function rosterTopLevelNames(roster?: readonly MenuEntry[]): string[];
+/**
+ * Top-level commands accounted for by neither the roster nor the exclusion list
+ * (interactive-cli-menu/AC-17). A non-empty result is a contract violation: a
+ * command was registered and nobody decided whether it belongs on the menu.
+ */
+export declare function unaccountedCommands(program: Command, roster?: readonly MenuEntry[], exclusions?: Readonly<Record<string, string>>): string[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/menu/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/menu/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI,CAQ/E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,QAAQ,EAAE,CAE9D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,SAAS,SAAS,EAAW,GAAG,MAAM,EAAE,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,SAAS,SAAS,EAAW,EACrC,UAAU,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAc,GACxD,MAAM,EAAE,CAOV"}

package/dist/menu/resolve.js

@@ -0,0 +1,76 @@
+/**
+ * Roster → commander resolution (interactive-cli-menu/AC-16,
+ * interactive-cli-menu/AC-17, interactive-cli-menu/AC-34).
+ *
+ * Pure functions over a commander program. Required positionals are derived
+ * structurally from `registeredArguments` rather than restated in the roster, so
+ * the prompt set cannot go stale when a command's signature changes.
+ *
+ * @module
+ */
+import { EXCLUSIONS, ROSTER } from './roster.js';
+/**
+ * Walk an entry's path from the program root to its leaf command.
+ *
+ * @returns the leaf `Command`, or `null` if any segment is unregistered.
+ */
+export function resolveEntry(program, entry) {
+    let current = program;
+    for (const segment of entry.path) {
+        const next = current.commands.find((child) => child.name() === segment);
+        if (!next)
+            return null;
+        current = next;
+    }
+    return current === program ? null : current;
+}
+/**
+ * Required positional arguments of a command, in declaration order
+ * (interactive-cli-menu/AC-34).
+ *
+ * `registeredArguments` is public commander API. Across the roster only
+ * `review <instance> <artifact>` and `knowledge query <term>` have any.
+ */
+export function requiredArgs(cmd) {
+    return cmd.registeredArguments.filter((arg) => arg.required);
+}
+/**
+ * Secondary hint text for an entry: the leaf command's own description
+ * (interactive-cli-menu/AC-16). Never used as the label.
+ */
+export function hintFor(cmd) {
+    return cmd.description();
+}
+/**
+ * Top-level command names on the program.
+ *
+ * Deliberately performs no hidden-command *detection*: `program.commands`
+ * already contains hidden commands (verified with the deprecated `setup`
+ * alias), `Command` exposes no public `hidden` accessor — the `hidden: boolean`
+ * in commander's typings belongs to `Option` — and the private `_hidden` must
+ * not be relied on. Commander's synthetic `help` command is absent from
+ * `program.commands` and needs no entry.
+ */
+export function allTopLevelNames(program) {
+    return program.commands.map((cmd) => cmd.name());
+}
+/**
+ * Top-level names the roster accounts for — first path segments only.
+ *
+ * A nested entry such as `['knowledge','query']` accounts for nothing beyond
+ * `knowledge`'s appearance as a *rostered* name, which is why `knowledge` is
+ * also carried in `EXCLUSIONS`: the parent itself is not on the menu.
+ */
+export function rosterTopLevelNames(roster = ROSTER) {
+    return roster.map((entry) => entry.path[0]);
+}
+/**
+ * Top-level commands accounted for by neither the roster nor the exclusion list
+ * (interactive-cli-menu/AC-17). A non-empty result is a contract violation: a
+ * command was registered and nobody decided whether it belongs on the menu.
+ */
+export function unaccountedCommands(program, roster = ROSTER, exclusions = EXCLUSIONS) {
+    const rostered = new Set(roster.filter((entry) => entry.path.length === 1).map((entry) => entry.path[0]));
+    return allTopLevelNames(program).filter((name) => !rostered.has(name) && !(name in exclusions));
+}
+//# sourceMappingURL=resolve.js.map

package/dist/menu/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/menu/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,KAAgB;IAC7D,IAAI,OAAO,GAAY,OAAO,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC/D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAA+B,MAAM;IACvE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,SAA+B,MAAM,EACrC,aAA+C,UAAU;IAEzD,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CACjF,CAAC;IACF,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,UAAU,CAAC,CACvD,CAAC;AACJ,CAAC"}

package/dist/menu/roster.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The menu roster — the single declaration site for what the menu offers
+ * (interactive-cli-menu/AC-32, interactive-cli-menu/AC-33,
+ * interactive-cli-menu/AC-15, interactive-cli-menu/AC-16).
+ *
+ * Data only, no logic. Two properties are pinned by tests rather than by
+ * convention: array order IS display order, and every top-level command on the
+ * program appears in exactly one of `ROSTER` (by first path segment) or
+ * `EXCLUSIONS`.
+ *
+ * Labels are curated here rather than read from commander. Several
+ * `.description()` strings read poorly as menu labels — `doctor`'s is 76
+ * characters, and `add`/`knowledge` describe a group rather than an action — so
+ * descriptions serve as secondary hint text only.
+ *
+ * @module
+ */
+/** Lifecycle stage an entry belongs to; drives visual grouping only. */
+export type MenuBucket = 'setup' | 'begin' | 'resume' | 'inspect' | 'maintain';
+export interface MenuEntry {
+    /** Command path from the program root: `['start']`, `['knowledge','query']`. */
+    readonly path: readonly string[];
+    /** Curated label — never commander's `.description()`. */
+    readonly label: string;
+    readonly bucket: MenuBucket;
+    /**
+     * Skip menu-side prompting for required positionals and let the command run
+     * its own wizard. `start` only (interactive-cli-menu/AC-35).
+     */
+    readonly delegatesArgs?: true;
+}
+/**
+ * The 12 menu entries, in display order: setup → begin → resume → inspect →
+ * maintain (interactive-cli-menu/AC-32).
+ */
+export declare const ROSTER: readonly MenuEntry[];
+/**
+ * Every top-level command deliberately kept out of the menu, with its reason
+ * (interactive-cli-menu/AC-33). Excluded commands stay fully usable by typing
+ * them; there is no "more" entry.
+ *
+ * The exclusion criterion is **not** whether a command is a group — it is
+ * whether its bare invocation does something useful. `cost` is a group *and* a
+ * useful bare report, so it is rostered. `knowledge` must be listed even though
+ * `knowledge query` is rostered, because the contract test compares top-level
+ * names and `knowledge` is one.
+ */
+export declare const EXCLUSIONS: Readonly<Record<string, string>>;
+/** Bucket order for grouping; matches the order entries appear in `ROSTER`. */
+export declare const BUCKET_ORDER: readonly MenuBucket[];
+//# sourceMappingURL=roster.d.ts.map

package/dist/menu/roster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../../src/menu/roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,SAAS,EAatC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUvD,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAM7C,CAAC"}

package/dist/menu/roster.js

@@ -0,0 +1,65 @@
+/**
+ * The menu roster — the single declaration site for what the menu offers
+ * (interactive-cli-menu/AC-32, interactive-cli-menu/AC-33,
+ * interactive-cli-menu/AC-15, interactive-cli-menu/AC-16).
+ *
+ * Data only, no logic. Two properties are pinned by tests rather than by
+ * convention: array order IS display order, and every top-level command on the
+ * program appears in exactly one of `ROSTER` (by first path segment) or
+ * `EXCLUSIONS`.
+ *
+ * Labels are curated here rather than read from commander. Several
+ * `.description()` strings read poorly as menu labels — `doctor`'s is 76
+ * characters, and `add`/`knowledge` describe a group rather than an action — so
+ * descriptions serve as secondary hint text only.
+ *
+ * @module
+ */
+/**
+ * The 12 menu entries, in display order: setup → begin → resume → inspect →
+ * maintain (interactive-cli-menu/AC-32).
+ */
+export const ROSTER = [
+    { path: ['init'], bucket: 'setup', label: 'Set up AIDLC in this project' },
+    { path: ['doctor'], bucket: 'setup', label: 'Run health checks' },
+    { path: ['update'], bucket: 'setup', label: 'Update AIDLC' },
+    { path: ['start'], bucket: 'begin', label: 'Begin new work', delegatesArgs: true },
+    { path: ['discover'], bucket: 'begin', label: 'Explore the codebase' },
+    { path: ['continue'], bucket: 'resume', label: 'Resume work' },
+    { path: ['status'], bucket: 'inspect', label: 'Show progress' },
+    { path: ['cost'], bucket: 'inspect', label: 'Cost report' },
+    { path: ['metrics'], bucket: 'inspect', label: 'Project metrics' },
+    { path: ['knowledge', 'query'], bucket: 'inspect', label: 'Search project knowledge' },
+    { path: ['review'], bucket: 'inspect', label: 'Review an artifact' },
+    { path: ['docs'], bucket: 'maintain', label: 'Generate onboarding docs' },
+];
+/**
+ * Every top-level command deliberately kept out of the menu, with its reason
+ * (interactive-cli-menu/AC-33). Excluded commands stay fully usable by typing
+ * them; there is no "more" entry.
+ *
+ * The exclusion criterion is **not** whether a command is a group — it is
+ * whether its bare invocation does something useful. `cost` is a group *and* a
+ * useful bare report, so it is rostered. `knowledge` must be listed even though
+ * `knowledge query` is rostered, because the contract test compares top-level
+ * names and `knowledge` is one.
+ */
+export const EXCLUSIONS = {
+    gate: 'CI/automation surface — consumed by scripts, not people',
+    transition: 'CI/automation surface; the phase skills drive it',
+    claim: 'session plumbing, not a user task',
+    release: 'session plumbing, not a user task',
+    add: 'bare `aidlc add` exits 1 with help on stderr — no useful bare form',
+    knowledge: 'bare `aidlc knowledge` exits 1; its useful leaf `knowledge query` is a roster entry',
+    setup: 'hidden deprecated alias of `init`',
+    menu: 'itself',
+};
+/** Bucket order for grouping; matches the order entries appear in `ROSTER`. */
+export const BUCKET_ORDER = [
+    'setup',
+    'begin',
+    'resume',
+    'inspect',
+    'maintain',
+];
+//# sourceMappingURL=roster.js.map

package/dist/menu/roster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster.js","sourceRoot":"","sources":["../../src/menu/roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAkBH;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAyB;IAC1C,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,8BAA8B,EAAE;IAC1E,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACjE,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE;IAC5D,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,IAAI,EAAE;IAClF,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,sBAAsB,EAAE;IACtE,EAAE,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE;IAC9D,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE;IAC/D,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE;IAC3D,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAClE,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,0BAA0B,EAAE;IACtF,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,EAAE;IACpE,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,0BAA0B,EAAE;CAC1E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAqC;IAC1D,IAAI,EAAE,yDAAyD;IAC/D,UAAU,EAAE,kDAAkD;IAC9D,KAAK,EAAE,mCAAmC;IAC1C,OAAO,EAAE,mCAAmC;IAC5C,GAAG,EAAE,oEAAoE;IACzE,SAAS,EACP,qFAAqF;IACvF,KAAK,EAAE,mCAAmC;IAC1C,IAAI,EAAE,QAAQ;CACf,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,OAAO;IACP,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;CACX,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasensio/aidlc",
-  "version": "1.9.1",
+  "version": "1.10.1",
   "description": "AI Development Lifecycle Framework — structured lifecycle guidance for AI coding agents across platforms",
   "type": "module",
   "main": "dist/cli.js",
@@ -24,7 +24,7 @@
     "commander": "15.0.0",
     "picomatch": "4.0.5",
     "yaml": "2.9.0",
-    "@rasensio/aidlc-content": "1.9.1"
+    "@rasensio/aidlc-content": "1.10.1"
   },
   "devDependencies": {
     "@types/node": "22.15.32",