@rasensio/aidlc 1.9.0 → 1.10.1

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.0",
+  "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.0"
+    "@rasensio/aidlc-content": "1.10.1"
   },
   "devDependencies": {
     "@types/node": "22.15.32",