wingfoil 0.2.1 → 0.3.0

package/dist/cli/program.js

@@ -31,20 +31,25 @@ exports.buildProgram = buildProgram;
  * `tsconfig.test.json` and transforms `commander`'s ESM on the way in, see `jest.config.js` — and
  * black-box by `test/cli/program.integration.test.ts`, which spawns the compiled `dist/` and so
  * exercises the real ESM `import()` this file actually ships with.
- * `buildCliCommands`/`listRegisteredCliCommands` (`./registrar.ts`) still carry 100% of the
- * AC-relevant behavior; this file adds no logic of its own beyond Commander's own API calls.
+ * `buildCliCommands`/`listRegisteredCliCommands` (`./registrar.ts`) still carry the dispatch
+ * behaviour. What this file adds of its own is presentation: how `--help` renders the declaration each
+ * command carries (task-120 — the positional's name and required-ness, `(required)` on an option, the
+ * example and exit-code footer), covered by `test/cli/help-describes-every-command.test.ts`.
  */
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const registry_1 = require("../core/registry");
 // Direct module import, not the `../core` barrel — the same path `./registrar.ts` already uses for the
 // other two exit-code mappings (task-101; keeps this file out of the barrel's merge surface).
 const exit_code_1 = require("../core/exit-code");
+const storage_1 = require("../storage");
 const registrar_1 = require("./registrar");
 const init_command_1 = require("./init-command");
 const mcp_command_1 = require("./mcp-command");
 const error_1 = require("./error");
 const exit_1 = require("./exit");
 const output_1 = require("./output");
+const suggest_1 = require("./suggest");
 /**
  * The CLI version, read from `package.json` deterministically (REQ-SYS-07 — no wall-clock, no
  * inference): the manifest sits two levels up from this module in both the `src/cli/` source layout
@@ -75,8 +80,9 @@ async function buildProgram(modules, options) {
     // and the process ends through `exitWith`, the single exit seam of `./exit.ts`, like every other
     // outcome.
     //
-    // COMMANDER'S OWN MESSAGES ARE UNAFFECTED: for every error it raises, Commander has already written
-    // its `error: …` line before calling this, so nothing is added on top of it. The ONE outcome where
+    // COMMANDER'S OWN MESSAGES ARE NOT REPEATED: for every error it raises, Commander has already written
+    // its message before calling this — in the active `--format` since task-130, through the
+    // `configureOutput` hooks below — so nothing is added on top of it. The ONE outcome where
     // it writes no error message at all is an invocation it found incomplete — a noun with no verb —
     // where it prints help to stderr and nothing else; `spec-005` §1 requires a non-zero exit to carry
     // an error message *always*, so that outcome (and only that one, flagged by `needsErrorLine`) gets
@@ -92,35 +98,81 @@ async function buildProgram(modules, options) {
     // set before it dispatches) with the global options removed.
     program.exitOverride((error) => {
         const termination = (0, exit_code_1.classifyParseOutcome)(error);
-        if (termination.needsErrorLine)
-            (0, error_1.emitError)(incompleteInvocationReason(program.args), { format: 'console' });
-        (0, exit_1.exitWith)(termination.exitCode);
+        if (termination.needsErrorLine) {
+            const { reason, hint } = incompleteInvocationReason(program.args);
+            (0, error_1.emitError)(reason, { format: activeFormat(program), ...(hint !== undefined ? { hint } : {}) });
+        }
+        const deferred = (0, exit_1.exitWith)(termination.exitCode);
+        // Commander ends the process itself, at ITS code, as soon as this callback returns. When the exit
+        // is waiting for queued output to drain (task-249, `bug-222` — e.g. a long `--help` into a pipe),
+        // returning would let Commander cut that output short at the wrong code; throwing hands control
+        // back to the entry point, which leaves the deferred exit to happen.
+        if (deferred)
+            throw new exit_1.DeferredExit(termination.exitCode);
+    });
+    // Commander's own refusals in the active `--format` (task-130, `bug-114`, spec-005 §3.2). Commander
+    // writes an error through `outputError` and the help it prints for an incomplete invocation through
+    // `writeErr`, so these two hooks are the whole parse path's stderr. Every error goes through
+    // `emitError` (`src/cli/error.ts`) in every format, so it has spec-005 §3's shape: the `error:` line,
+    // then a `hint:` line when a suggestion applies (task-179, `bug-104`; `commanderRefusal`). Under
+    // `json`/`yaml` the message becomes the same `{error, hint?}` object a WingFoil refusal is, and the
+    // help text — which would bury that object — is not written: `--help` itself writes to stdout and is
+    // unaffected.
+    // `--format` is read when the error fires; Commander has parsed the root program's options by then,
+    // wherever on the command line they stand. Installed before the first `.command()`, like the callback
+    // above, because `copyInheritedSettings` copies the output configuration at registration time.
+    program.configureOutput({
+        writeErr: (text) => {
+            if (activeFormat(program) === 'console')
+                process.stderr.write(text);
+        },
+        outputError: (text) => {
+            (0, error_1.emitError)(...commanderRefusal(program, text, activeFormat(program)));
+        },
     });
+    // How a command is listed under its parent (task-120, `bug-128`). Commander's own `subcommandTerm`
+    // renders each registered argument from the flag Commander ENFORCES, which is why every derived verb
+    // used to read `[positionals...]`; this renders the positional the operation declares instead,
+    // `<id>` when core refuses its absence and `[section]` when it does not. Installed before the first
+    // `.command()` for the same reason as the callback above: `copyInheritedSettings` copies the help
+    // configuration at registration time.
+    const declaredPositionals = new Map();
+    program.configureHelp({ subcommandTerm: (command) => subcommandTerm(command, declaredPositionals.get(command)) });
     // Register `-V, --version` so `wingfoil --version` prints the version and exits 0
     // (spec-008-cli-grammar §1, bug-001-cli-version-flag) — Commander handles it before any command.
-    program.version(readPackageVersion());
+    // It prints the build stamp `<semver> (<sha>)`, the value every commit's `WingFoil-Version:` trailer
+    // carries (task-192, `dl-111` Action 3); the MCP server keeps announcing the bare semver below.
+    program.version((0, storage_1.readBuildStamp)());
     program
-        .option('--format <format>', 'output format (console|json|yaml)', 'console')
+        // Until P5.1.4 gives `console` a human rendering (`dl-043`), the help says what the default prints
+        // and that no output is coloured (spec-008 §2, task-156, `bug-152`, `bug-203`).
+        .option('--format <format>', 'output format (console|json|yaml); console prints indented JSON for now, unless the command defines its own', 'console')
         .option('--verbose', 'emit diagnostic logs to stderr')
-        .option('--no-color', 'disable ANSI colors')
+        .option('--no-color', 'disable ANSI colors (accepted; no output is colored yet)')
         .option('--no-interactive', 'fail on missing args instead of prompting');
     // `wingfoil init` is a SPECIAL bootstrap command (task-029, P5.1.1): it runs BEFORE config exists,
     // so it is NOT a `CORE_MODULES` noun-verb op — it is wired directly here and drives `runInit`
     // (./init-command.ts). The wizard/`--template`/prompt-matrix logic is fully unit-tested in
-    // ./init-command.ts; this registration is the same thin, un-unit-tested `commander` seam as the
-    // rest of this file (see the module doc).
+    // ./init-command.ts; this registration is a thin `commander` seam, and `test/cli/program.test.ts`
+    // pins it (the command is registered and drives `runInit` with the resolved options).
     program
         .command('init')
-        .description('initialize WingFoil in the current git repository')
-        .option('--template <name>', 'methodology template to initialize with (non-interactive)')
-        .action(async (localOpts) => {
+        .description('scaffold .wingfoil/ in the current git repository and commit it')
+        // bug-140: the legal values come from the template registry, the same list `--template` resolves
+        // against and the missing-argument error names (./init-command.ts).
+        .option('--template <name>', `methodology template, one of: ${storage_1.TEMPLATE_NAMES.join(', ')} (required without a terminal or with --no-interactive)`)
+        .addHelpText('after', leafHelpFooter(`wingfoil init --template ${storage_1.TEMPLATE_NAMES[0] ?? '<name>'}`))
+        .allowExcessArguments(true)
+        .action(async (localOpts, command) => {
+        if (refusedInvalidFormat(program) || refusedSurplus(program, 'init', command.args))
+            return;
         const globalOpts = program.opts();
         let root;
         try {
             root = options.resolveRoot();
         }
         catch (error) {
-            (0, error_1.emitError)(error instanceof Error ? error.message : String(error), { format: 'console' });
+            (0, error_1.emitError)(error instanceof Error ? error.message : String(error), { format: activeFormat(program) });
             (0, exit_1.exitWith)(1);
             return;
         }
@@ -130,73 +182,228 @@ async function buildProgram(modules, options) {
     // starts the long-running production MCP server over stdio rather than wrapping a `CORE_MODULES`
     // noun-verb op, so — like `init` above — it is wired directly here and drives `runMcp`
     // (./mcp-command.ts). The pre-flight (resolve-root / error / exit 1) is unit-tested in
-    // ./mcp-command.ts with an injected server-start; this registration is the same thin, un-unit-tested
-    // `commander` seam as the rest of this file (see the module doc).
+    // ./mcp-command.ts with an injected server-start; this registration is a thin `commander` seam, and
+    // `test/cli/program.test.ts` pins it (the command is registered and drives `runMcp`).
     program
         .command('mcp')
         .description('start the WingFoil MCP server (read-only Resources and role Prompts) over stdio')
-        .action(async () => {
-        const globalOpts = program.opts();
-        const format = (0, output_1.isValidFormat)(globalOpts.format) ? globalOpts.format : 'console';
-        await (0, mcp_command_1.runMcp)({ resolveRoot: options.resolveRoot, version: readPackageVersion(), format });
+        .addHelpText('after', leafHelpFooter('wingfoil mcp'))
+        .allowExcessArguments(true)
+        .action(async (_localOpts, command) => {
+        if (refusedInvalidFormat(program) || refusedSurplus(program, 'mcp', command.args))
+            return;
+        await (0, mcp_command_1.runMcp)({ resolveRoot: options.resolveRoot, version: readPackageVersion(), format: activeFormat(program) });
     });
     const nounCommands = new Map();
     for (const command of (0, registrar_1.buildCliCommands)(modules, options)) {
         const target = resolveCommandTarget(program, nounCommands, command);
-        // A variadic optional bare positional list (task-025-implement-dna-set's `positionals` seam,
-        // generalizing task-026's single `[positional]`) — registered on every command regardless of how
-        // many positionals its operation reads (harmless if ignored), so `dna show [section]`,
-        // `paths [category]`, `memory approve [id]` and `dna set|add|remove|update <path>` share ONE
-        // positional mechanism. Every one of them now reads at most ONE positional: `dl-082-cli-parameter-shape`
-        // states the rule the nine older commands already followed — a positional carries the identity of
-        // the command's target, an option a named attribute — and task-093 moved `dna set`'s second
-        // positional into `--value` to match. The list stays variadic so an operation can refuse an extra
-        // positional with its own message rather than have Commander refuse it with an arity error.
+        // A flat command IS its noun (`paths`), so only a nested verb's noun takes the module's own line.
+        if (command.verb && command.nounDescription !== undefined)
+            nounCommands.get(command.noun)?.description(command.nounDescription);
+        if (command.description !== undefined)
+            target.description(command.description);
+        // The operand (task-025's `positionals` seam, named by task-120). PARSING is the same for every
+        // derived command whatever it declares: Commander accepts any number of operands and WingFoil
+        // decides what to refuse, with its own message — `dl-082-cli-parameter-shape` gives each command at
+        // most ONE positional, the identity of its target, and `./registrar.ts` refuses a surplus operand,
+        // and a missing required one, at exit `2` before anything is read (task-129, `bug-171`, `bug-131`;
+        // task-179, `bug-180`, `bug-168`), rather than leave it to a Commander arity error, whose wording
+        // would differ from command to command. A declared positional is registered as an OPTIONAL variadic
+        // argument under its declared name: marking it required to Commander would replace WingFoil's
+        // `missing required argument: <id>` with Commander's own refusal, so required-ness is RENDERED here
+        // (the usage line below, `subcommandTerm`) and enforced by the registrar. A command that declares none registers no argument — so `--help` shows
+        // none — and allows excess arguments, so that the surplus reaches the registrar's refusal.
+        if (command.positional) {
+            target.argument(`[${command.positional.name}...]`, command.positional.description);
+            declaredPositionals.set(target, command.positional);
+        }
+        else {
+            target.allowExcessArguments(true);
+        }
         // Plus this command's own `--{flag}` options (task-028-implement-paths-category's
         // `CoreOperation.flags`, e.g. `paths`'s `--list`): Commander rejects an unknown option, so each
         // declared flag must be registered explicitly.
-        target.argument('[positionals...]', 'optional positional arguments (the command target — e.g. a section/category name, a document id, or a `dna` field path)');
-        for (const name of command.flags ?? []) {
-            target.option(`--${name}`, `${name} flag`);
+        for (const flag of command.flags ?? []) {
+            target.option(`--${flag.name}`, flag.description ?? '');
         }
         // Value-bearing `--{name} <value>` options (task-020-implement-memory-add's `memory add
         // --type/--title/--tags`): Commander rejects an unknown option, so each declared option must be
         // registered explicitly with a `<value>` operand (distinguishing it from a boolean `--flag`).
+        // `required` is rendered in the description, not enforced by Commander (`requiredOption` would
+        // replace core's refusal, exactly as for the positional above).
         for (const option of command.options ?? []) {
-            target.option(`--${option.name} <value>`, option.description ?? `${option.name} value`);
+            const flags = `--${option.name} <${option.valueName ?? 'value'}>`;
+            const description = [option.description, option.required === true ? '(required)' : undefined].filter(Boolean).join(' ');
+            // A repeatable option (task-110, `memory add --set`) collects every occurrence in order;
+            // Commander's default for a value option is last-one-wins, which would drop all but one.
+            if (option.repeatable === true) {
+                target.option(flags, description, (value, previous) => [...(previous ?? []), value]);
+            }
+            else {
+                target.option(flags, description);
+            }
         }
-        // Commander's action callback for a `[positionals...]` variadic + options command is
-        // `(positionalsArray, optionsObject, commandObject)`. Forward the whole array (task-025),
-        // collapse this command's declared flags into a `{ name: boolean }` record (task-028) and its
-        // declared value options into a `{ name: value }` record (task-020) for `run`.
-        target.action(async (positionals = [], options = {}) => {
+        target.usage(['[options]', ...positionalTerm(command.positional)].join(' '));
+        if (command.example !== undefined)
+            target.addHelpText('after', leafHelpFooter(command.example));
+        // The action reads the operands and options off the invoked command itself: Commander passes the
+        // declared argument's values first only when one is registered, so the command object — always the
+        // LAST callback argument — is the one shape both kinds of command share. Forward the operands
+        // (task-025), collapse this command's declared flags into a `{ name: boolean }` record (task-028)
+        // and its declared value options into a `{ name: value }` record (task-020) for `run`.
+        target.action(async (...actionArgs) => {
+            const invoked = actionArgs[actionArgs.length - 1];
             const globalOpts = program.opts();
-            await command.run(globalOpts.format, positionals, buildFlagValues(command, options), buildOptionValues(command, options));
+            const options = invoked.opts();
+            await command.run(globalOpts.format, invoked.args, buildFlagValues(command, options), buildOptionValues(command, options));
         });
     }
     return program;
 }
 /**
- * The `error: <reason>` text (spec-005 §3.1) for an invocation Commander found incomplete —
+ * How `--help` shows a declared positional: `<name>` when the operation refuses its absence, `[name]`
+ * when it does not — one element or none, so callers can spread it into a list of terms.
+ */
+function positionalTerm(positional) {
+    if (!positional)
+        return [];
+    return [positional.required === true ? `<${positional.name}>` : `[${positional.name}]`];
+}
+/**
+ * A command's line in its parent's command list — Commander's own term (`name`, then `[options]` when
+ * it has options of its own, then its arguments), with the DECLARED positional in place of the
+ * registered variadic argument (task-120). A command with no declared positional — Commander's own
+ * `help [command]` included — keeps Commander's rendering of whatever it registered.
+ */
+function subcommandTerm(command, positional) {
+    const argumentTerms = positional
+        ? positionalTerm(positional)
+        : command.registeredArguments.map((argument) => {
+            const name = `${argument.name()}${argument.variadic ? '...' : ''}`;
+            return argument.required ? `<${name}>` : `[${name}]`;
+        });
+    return [command.name(), ...(command.options.length > 0 ? ['[options]'] : []), ...argumentTerms].join(' ');
+}
+/**
+ * The text after a command's own help (`spec-008-cli-grammar` §8, `P5.1.4-cli-ux.feature`): one example
+ * invocation, and the three exit codes of `spec-005` §1, the same for every command. Leaf commands
+ * only — a noun's help lists its verbs, and each verb carries its own.
+ */
+function leafHelpFooter(example) {
+    return [
+        '',
+        'Example:',
+        `  $ ${example}`,
+        '',
+        'Exit codes:',
+        '  0  success',
+        '  1  the command line was valid, but the operation failed',
+        '  2  the command line is wrong: unknown command or option, missing or invalid argument',
+    ].join('\n');
+}
+/**
+ * The invalid-`--format` refusal of the two hand-wired bootstrap commands (task-179, `bug-226`): checked
+ * FIRST, before the surplus operand, as the registrar checks it first for every derived command — the
+ * value decides how every later error is rendered, so one order holds for every command
+ * (`spec-008-cli-grammar` §1). Console text at exit `2`, the same {@link invalidFormatReason} line
+ * (`spec-005` §2). `mcp` used to fall back to `console` and start; it is refused like any command.
+ *
+ * @returns `true` when the invocation was refused (the caller returns).
+ */
+function refusedInvalidFormat(program) {
+    const value = program.opts().format;
+    if ((0, output_1.isValidFormat)(value))
+        return false;
+    (0, exit_1.exitWith)(2, `error: ${(0, output_1.invalidFormatReason)(value)}`);
+    return true;
+}
+/**
+ * The surplus-operand refusal of the two hand-wired bootstrap commands (`bug-179`, task-165). `init`
+ * and `mcp` declare no positional, so any operand is a surplus (`spec-008-cli-grammar` §1): refused at
+ * exit `2` with the same {@link extraOperandsReason} wording the registrar gives every `CORE_MODULES`
+ * command (task-129), in the active `--format`, before the project root is resolved — so nothing is
+ * read or written. Both commands allow excess arguments so the surplus reaches this check instead of
+ * Commander's own `too many arguments` refusal, whose wording differs.
+ *
+ * @returns `true` when the invocation was refused (the caller returns), `false` when it had no operand.
+ */
+function refusedSurplus(program, name, operands) {
+    if (operands.length === 0)
+        return false;
+    (0, error_1.emitError)((0, registry_1.extraOperandsReason)(name, undefined, operands.length), { format: activeFormat(program) });
+    (0, exit_1.exitWith)(2);
+    return true;
+}
+/**
+ * The `--format` an error is rendered in: the parsed global option when it is a valid format, else
+ * `console` — an invalid value is itself refused in console text by the registrar (spec-005 §2), and a
+ * parse error can fire before `--format` has a usable value at all (task-130, `bug-114`).
+ */
+function activeFormat(program) {
+    const value = program.getOptionValue('format');
+    return typeof value === 'string' && (0, output_1.isValidFormat)(value) ? value : 'console';
+}
+/**
+ * Commander's error text as {@link emitError} arguments (task-130, `bug-114`; task-179, `bug-104`).
+ * Commander writes `error: <reason>\n`, and for an unknown command or option its closest match on a
+ * line of its own, `(Did you mean <name>?)`. The first line without its `error: ` prefix is the reason.
+ * The `hint` is spec-005 §3.1's `did you mean "<name>"?`:
+ *
+ * - for an **unknown command**, WingFoil's own match (`./suggest.ts`, Levenshtein distance ≤ 2,
+ *   `spec-008` §1) against the commands of the level the token was typed at; Commander's suggestion,
+ *   from a different algorithm, is dropped;
+ * - for an **unknown option**, Commander's match, re-worded into the same `hint:` shape — `spec-008` §1
+ *   fixes the algorithm for commands only, and Commander knows every option a command inherits.
+ *
+ * Any other line is kept, joined to the reason, so nothing Commander said is dropped.
+ */
+function commanderRefusal(program, text, format) {
+    const [first = '', ...rest] = text.split('\n').map((line) => line.trim()).filter((line) => line !== '');
+    const suggestion = /^\(Did you mean (.*)\?\)$/;
+    const reason = [first.replace(/^error: /, ''), ...rest.filter((line) => !suggestion.test(line))].join(' ');
+    const unknownCommand = /^unknown command '(.*)'$/.exec(reason)?.[1];
+    const suggested = unknownCommand !== undefined
+        ? (0, suggest_1.closestCommand)(unknownCommand, commandsBeside(program))
+        : rest.map((line) => suggestion.exec(line)?.[1]).find((match) => match !== undefined);
+    return [reason, { format, ...(suggested !== undefined ? { hint: (0, suggest_1.unknownCommandHint)(suggested) } : {}) }];
+}
+/**
+ * The names (and aliases) of the commands an unknown command was typed among: walk the root program's
+ * operands from the top, descending into each known command, and stop at the first operand no command
+ * at that level answers to — the one Commander refused. The list is the one Commander itself would
+ * consider there (`Help#visibleCommands`, its built-in `help` included).
+ */
+function commandsBeside(program) {
+    let level = program;
+    for (const operand of program.args) {
+        const next = level.commands.find((command) => command.name() === operand || command.aliases().includes(operand));
+        if (next === undefined)
+            break;
+        level = next;
+    }
+    return program
+        .createHelp()
+        .visibleCommands(level)
+        .flatMap((command) => [command.name(), ...command.aliases()]);
+}
+/**
+ * The refusal (spec-005 §3.1) for an invocation Commander found incomplete —
  * task-103-a-missing-verb-exits-2-with-an-error-line (`bug-103`). Commander supplies no message on
  * this path, so the wording is a **ruling**, recorded here rather than left to the reader:
  *
- * - `wingfoil dna`, `wingfoil memory`, and `wingfoil` with no arguments at all →
- *   `missing required argument: wingfoil dna <command>` / `missing required argument: wingfoil
- *   <command>`. The key is the one `spec-005` §1 already lists among its malformed invocations, and
- *   the shape is the one WingFoil already emits for a missing positional (`src/core/index.ts`'s
- *   `missing required argument: wingfoil dna set <path> --value <value>`, task-093): the incomplete
- *   invocation echoed back with the token that would complete it. `<command>` rather than `<verb>`
- *   matches Commander's own placeholder in the usage line printed directly above it.
- * - `wingfoil help nosuchnoun` → `unknown command 'nosuchnoun'`, byte-for-byte what `wingfoil
- *   nosuchnoun` already emits (Commander's `unknownCommand()`), because asking about an unknown noun
- *   through `help` is the same mistake and a script should have one shape to grep. The single quotes
- *   are Commander's; `spec-005` §4's example shows double ones, and reconciling the two spellings
- *   (along with the missing `hint:` suggestion) is `bug-104`'s, which owns both lines at once. Picking
- *   a third spelling here would make that reconciliation harder, not easier.
+ * - `wingfoil dna`, `wingfoil memory`, and `wingfoil` with no arguments at all → the one
+ *   missing-operand shape every command uses (task-179, `bug-168`; `missingOperandReason`):
+ *   `missing required argument: <command>`, with the incomplete invocation and the token that would
+ *   complete it as the `hint:` line, `usage: wingfoil dna <command>`. `<command>` rather than `<verb>`
+ *   matches Commander's own placeholder in the usage line it prints above, under `console`.
+ * - `wingfoil help nosuchnoun` → `unknown command 'nosuchnoun'`, byte-for-byte the reason `wingfoil
+ *   nosuchnoun` emits, because asking about an unknown noun through `help` is the same mistake and a
+ *   script should have one shape to grep. It carries no `hint:` line: the suggestion on this path is
+ *   `bug-115`'s (v0.4), out of task-179's scope.
  *
  * @param operands - the root program's `args`: the invocation's operands, global options already
  *   removed by Commander itself. This function never re-parses argv.
+ * @returns the reason, and the hint when there is one.
  */
 function incompleteInvocationReason(operands) {
     const [first, second] = operands;
@@ -204,8 +411,8 @@ function incompleteInvocationReason(operands) {
     // `Command#_dispatchHelpCommand` falls through to `_dispatchSubcommand`, whose `if (!subCommand)`
     // raises it. `help` alone and `help <known-noun>` exit 0 and never arrive here.
     if (first === 'help' && second !== undefined)
-        return `unknown command '${second}'`;
-    return `missing required argument: ${['wingfoil', ...operands].join(' ')} <command>`;
+        return { reason: `unknown command '${second}'` };
+    return { reason: (0, registry_1.missingOperandReason)('command'), hint: `usage: ${['wingfoil', ...operands, '<command>'].join(' ')}` };
 }
 /**
  * The Commander `Command` a `CliCommand` registers itself on: a flat, no-verb command
@@ -232,12 +439,12 @@ function resolveCommandTarget(program, nounCommands, command) {
  * `CliCommand.run`'s already-optional `flags` parameter.
  */
 function buildFlagValues(command, options) {
-    const flagNames = command.flags ?? [];
+    const flagNames = (command.flags ?? []).map((flag) => flag.name);
     if (flagNames.length === 0)
         return undefined;
     const flagValues = {};
     for (const name of flagNames) {
-        flagValues[name] = Boolean(options[name]);
+        flagValues[name] = Boolean(options[commanderKey(name)]);
     }
     return flagValues;
 }
@@ -246,7 +453,8 @@ function buildFlagValues(command, options) {
  * into a `{ name: value }` record read from Commander's parsed options object (task-020), so
  * `command.run` never has to know Commander's option-object shape. An option the invocation omitted is
  * simply absent from the record (not present-as-`undefined`), so a core op can distinguish "not given"
- * from an empty string. Returns `undefined` when the command declares no value options (every command
+ * from an empty string; a repeatable option (task-110) is the array of its occurrences. Returns
+ * `undefined` when the command declares no value options (every command
  * before task-020-implement-memory-add), matching `CliCommand.run`'s already-optional `options` param.
  */
 function buildOptionValues(command, options) {
@@ -258,6 +466,8 @@ function buildOptionValues(command, options) {
         const value = options[commanderKey(name)];
         if (typeof value === 'string')
             optionValues[name] = value;
+        else if (Array.isArray(value))
+            optionValues[name] = value.filter((item) => typeof item === 'string');
     }
     return optionValues;
 }

package/dist/cli/program.js.map

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

package/dist/cli/registrar.d.ts

@@ -7,7 +7,7 @@
  * operation regardless of `mutates`"). No business logic lives outside `run`: it only (a)
  * validates the global `--format` flag, (b) turns the invocation into typed params via the
  * caller-supplied `buildParams`, (c) calls the one core function, (d) renders the resulting
- * `CoreResult` via `renderSuccess`/`emitError` and terminates via `exitWith` — matching spec-005
+ * `CoreResult` via `renderSuccess` (plus `emitWarnings` for its warnings, task-169)/`emitError` and terminates via `exitWith` — matching spec-005
  * §1's "exactly one process exit call per invocation".
  *
  * Deliberately Commander-independent (see `./program.ts`'s module doc for why): this module owns
@@ -15,7 +15,7 @@
  * unit-testable; wiring this command model onto a real `commander` `Command` tree is a separate,
  * thin, mechanical concern.
  */
-import type { CoreModule, CoreOption, ParamsBuilder } from '../core/registry';
+import type { CoreFlag, CoreModule, CoreOption, CorePositional, ParamsBuilder } from '../core/registry';
 /** Ambient dependencies {@link buildCliCommands} needs: how to resolve the project root and how to shape each operation's params. */
 export interface BuildCommandsOptions {
     /** Resolves the project root a core call needs — an ambient/environment concern, not a CLI flag. */
@@ -32,10 +32,18 @@ export interface CliCommand {
     readonly noun: string;
     readonly verb: string;
     readonly mutates: boolean;
-    /** Copied from `CoreOperation.flags` (`../core/registry.ts`) — the boolean flag names `program.ts`
+    /** Copied from `CoreModule.description` — the noun's one-line summary (task-120). */
+    readonly nounDescription?: string;
+    /** Copied from `CoreOperation.description` — the command's one-line summary (task-120). */
+    readonly description?: string;
+    /** Copied from `CoreOperation.positional` — the operand `--help` names; absent when it reads none (task-120). */
+    readonly positional?: CorePositional;
+    /** Copied from `CoreOperation.example` — the invocation `--help` shows under `Example:` (task-120). */
+    readonly example?: string;
+    /** Copied from `CoreOperation.flags` (`../core/registry.ts`) — the boolean flags `program.ts`
      * registers as Commander `--{name}` options for this command (empty/absent for every command
-     * before task-028-implement-paths-category; `['list']` for `paths`). */
-    readonly flags?: readonly string[];
+     * before task-028-implement-paths-category; `--list` for `paths`). */
+    readonly flags?: readonly CoreFlag[];
     /** Copied from `CoreOperation.options` (`../core/registry.ts`) — the value-bearing `--{name} <value>`
      * options `program.ts` registers for this command (task-020-implement-memory-add; empty/absent for
      * every command before it). */
@@ -47,12 +55,13 @@ export interface CliCommand {
      * `wingfoil dna set project.license --value MIT` -> `['project.license']`, one positional per
      * command since `dl-082-cli-parameter-shape`), this command's own parsed `--{flag}`
      * values (task-028, e.g. `{ list: true }`), and its parsed value-bearing `--{name} <value>` OPTIONS
-     * (task-020, e.g. `{ type: 'decision', title: 'Use PostgreSQL' }`). All are additive/optional — a
+     * (task-020, e.g. `{ type: 'decision', title: 'Use PostgreSQL' }`; a repeatable option's value is
+     * the array of its occurrences, task-110). All are additive/optional — a
      * command that reads no positional and declares no flags/options is still called exactly as before:
      * `run(format)`. The single-positional read ops (`dna show`, `paths`) read `positionals[0]` via
      * `ParamsContext.positional`.
      */
-    readonly run: (formatValue: string, positionals?: readonly string[], flags?: Readonly<Record<string, boolean>>, options?: Readonly<Record<string, string>>) => Promise<void>;
+    readonly run: (formatValue: string, positionals?: readonly string[], flags?: Readonly<Record<string, boolean>>, options?: Readonly<Record<string, string | readonly string[]>>) => Promise<void>;
 }
 /**
  * Derive one `CliCommand` per operation in `modules`, in `enumerateOperations`'s deterministic

package/dist/cli/registrar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registrar.d.ts","sourceRoot":"","sources":["../../src/cli/registrar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAS9E,qIAAqI;AACrI,MAAM,WAAW,oBAAoB;IACnC,oGAAoG;IACpG,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,iHAAiH;IACjH,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;4EAEwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;mCAE+B;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,GAAG,EAAE,CACZ,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACvC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,UAAU,EAAE,CA+D5G;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,EAAE,CAEnF"}
+{"version":3,"file":"registrar.d.ts","sourceRoot":"","sources":["../../src/cli/registrar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAaxG,qIAAqI;AACrI,MAAM,WAAW,oBAAoB;IACnC,oGAAoG;IACpG,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,iHAAiH;IACjH,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,iHAAiH;IACjH,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;IACrC,uGAAuG;IACvG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;0EAEsE;IACtE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC;;mCAE+B;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,GAAG,EAAE,CACZ,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,KAC3D,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,UAAU,EAAE,CA2H5G;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,EAAE,CAEnF"}