@cleocode/cleo 2026.4.11 → 2026.4.12

package/dist/cli/commands/schema.js

@@ -0,0 +1,160 @@
+/**
+ * CLI `schema` command — operation introspection for agents.
+ *
+ * Allows agents to inspect the full parameter signature and declared precondition
+ * gates for any CLEO operation before calling it, replacing trial-and-error.
+ *
+ * Usage:
+ *   cleo schema <domain.operation>
+ *   cleo schema tasks.add
+ *   cleo schema tasks.add --format human
+ *   cleo schema tasks.add --include-examples
+ *
+ * @task T340
+ * @epic T335
+ */
+import { describeOperation } from '@cleocode/lafs';
+import { OPERATIONS } from '../../dispatch/registry.js';
+import { cliError, cliOutput } from '../renderers/index.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the target `OperationDef` from a `"domain.operation"` key.
+ *
+ * @param operationArg - The user-supplied string (e.g. `"tasks.add"`).
+ * @returns The matching `OperationDef`, or `null` if not found.
+ *
+ * @remarks
+ * The first dot separates domain from operation, so dotted operation names
+ * like `"complexity.estimate"` are handled correctly.
+ */
+function resolveOperationDef(operationArg) {
+    const dotIdx = operationArg.indexOf('.');
+    if (dotIdx === -1) {
+        // No domain separator — search all domains for unambiguous match
+        const matches = OPERATIONS.filter((op) => op.operation === operationArg);
+        if (matches.length === 1) {
+            return matches[0] ?? null;
+        }
+        return null;
+    }
+    const domain = operationArg.slice(0, dotIdx);
+    const operation = operationArg.slice(dotIdx + 1);
+    return OPERATIONS.find((op) => op.domain === domain && op.operation === operation) ?? null;
+}
+/**
+ * Format an `OperationSchema` as a human-readable summary table.
+ *
+ * @param schema - The operation schema to render.
+ * @returns Multi-line human-readable string.
+ */
+function renderSchemaHuman(schema) {
+    const lines = [];
+    lines.push(`Operation : ${schema.operation}`);
+    lines.push(`Gateway   : ${schema.gateway}`);
+    lines.push(`Description: ${schema.description}`);
+    lines.push('');
+    lines.push('Parameters:');
+    if (schema.params.length === 0) {
+        lines.push('  (none declared)');
+    }
+    else {
+        for (const p of schema.params) {
+            const req = p.required ? '[required]' : '[optional]';
+            const enumStr = p.enum ? `  enum: ${p.enum.join(' | ')}` : '';
+            let cliStr = '';
+            if (p.cli) {
+                const parts = [];
+                if (p.cli.positional)
+                    parts.push('positional');
+                if (p.cli.short)
+                    parts.push(`short: ${p.cli.short}`);
+                if (p.cli.flag)
+                    parts.push(`flag: --${p.cli.flag}`);
+                if (parts.length > 0)
+                    cliStr = `  cli: ${parts.join(', ')}`;
+            }
+            lines.push(`  ${p.name} (${p.type}) ${req}`);
+            lines.push(`    ${p.description}${enumStr}${cliStr}`);
+        }
+    }
+    if (schema.gates !== undefined) {
+        lines.push('');
+        lines.push('Gates:');
+        if (schema.gates.length === 0) {
+            lines.push('  (none declared — see note on static gate table)');
+        }
+        else {
+            for (const g of schema.gates) {
+                lines.push(`  ${g.name} → ${g.errorCode}`);
+                lines.push(`    ${g.description}`);
+                for (const t of g.triggers) {
+                    lines.push(`    - ${t}`);
+                }
+            }
+        }
+    }
+    if (schema.examples !== undefined && schema.examples.length > 0) {
+        lines.push('');
+        lines.push('Examples:');
+        for (const ex of schema.examples) {
+            lines.push(`  ${ex.command}`);
+            lines.push(`    ${ex.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Register the `cleo schema <operation>` command.
+ *
+ * @param program - The root ShimCommand to register against.
+ *
+ * @remarks
+ * Does NOT dispatch through the main dispatcher — schema introspection is
+ * pure metadata over the registry and does not require a live session or DB.
+ */
+export function registerSchemaCommand(program) {
+    program
+        .command('schema <operation>')
+        .description('Introspect a CLEO operation: show params, types, enums, and declared gates')
+        .option('--format <format>', 'Output format: json (default) or human (pretty table)', 'json')
+        .option('--include-gates', 'Include precondition gates in output (default: true)')
+        .option('--no-include-gates', 'Exclude precondition gates from output')
+        .option('--include-examples', 'Include usage examples in output (default: false)')
+        .action(async (operationArg, opts) => {
+        const format = opts.format ?? 'json';
+        // When --no-include-gates is passed, Commander sets includeGates=false
+        const includeGates = opts.includeGates !== false;
+        const includeExamples = opts.includeExamples === true;
+        // Resolve operation from registry
+        const def = resolveOperationDef(operationArg);
+        if (def === null) {
+            cliError(`Unknown operation: "${operationArg}". Run \`cleo schema --list\` to see all operations.`, 4, {
+                name: 'E_NOT_FOUND',
+                fix: 'cleo schema --list',
+            });
+            process.exit(4);
+            return;
+        }
+        // Build schema via LAFS discovery
+        const schema = describeOperation(def, {
+            includeGates,
+            includeExamples,
+        });
+        if (format === 'human') {
+            console.log(renderSchemaHuman(schema));
+            return;
+        }
+        // JSON output — go through cliOutput for LAFS envelope compliance
+        cliOutput(schema, {
+            command: 'schema',
+            operation: `schema.${operationArg}`,
+            message: `Schema for ${schema.operation}`,
+        });
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/cli/commands/schema.js.map

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

package/dist/cli/commands/show.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO1D"}
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAmBnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa1D"}

package/dist/cli/commands/show.js

@@ -4,16 +4,36 @@
  * @epic T4454
  */
 import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+import { applyParamDefsToCommand, buildOperationHelp } from '../help-generator.js';
+// ---------------------------------------------------------------------------
+// ParamDef array for tasks.show
+//
+// Mirrors STATIC_PARAMS_TABLE in packages/lafs/src/operation-gates.ts.
+// Will be upstreamed into registry.ts during the T4897 migration.
+// ---------------------------------------------------------------------------
+const SHOW_PARAMS = [
+    {
+        name: 'taskId',
+        type: 'string',
+        required: true,
+        description: 'ID of the task to retrieve',
+        cli: { positional: true },
+    },
+];
 /**
  * Register the show command.
  * @task T4460
  * @task T4666
  */
 export function registerShowCommand(program) {
-    program
-        .command('show <taskId>')
-        .description('Show full task details by ID')
-        .action(async (taskId) => {
+    const cmd = program
+        .command('show')
+        .description(buildOperationHelp('tasks.show', 'Show full task details by ID', SHOW_PARAMS));
+    // Auto-generate the <taskId> positional arg from the ParamDef registry.
+    // Replaces the previous hard-coded 'show <taskId>' in the command name string
+    // and surfaces the task-exists gate in --help output.
+    applyParamDefsToCommand(cmd, SHOW_PARAMS, 'tasks.show');
+    cmd.action(async (taskId) => {
         await dispatchFromCli('query', 'tasks', 'show', { taskId }, { command: 'show' });
     });
 }

package/dist/cli/commands/show.js.map

@@ -1 +1 @@
-{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAC/B,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/cli/commands/show.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,8EAA8E;AAC9E,gCAAgC;AAChC,EAAE;AACF,uEAAuE;AACvE,kEAAkE;AAClE,8EAA8E;AAC9E,MAAM,WAAW,GAAwB;IACvC;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,4BAA4B;QACzC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;KAC1B;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kBAAkB,CAAC,YAAY,EAAE,8BAA8B,EAAE,WAAW,CAAC,CAAC,CAAC;IAE9F,wEAAwE;IACxE,8EAA8E;IAC9E,sDAAsD;IACtD,uBAAuB,CAAC,GAAG,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAExD,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;QAClC,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/help-generator.d.ts

@@ -0,0 +1,74 @@
+/**
+ * ParamDef-driven Commander help generator.
+ *
+ * Provides two functions:
+ *  - `buildOperationHelp()` — emits a multi-section help string (Description,
+ *    USAGE, ARGUMENTS, OPTIONS, PRECONDITIONS) from a ParamDef array and the
+ *    static LAFS gate table.
+ *  - `applyParamDefsToCommand()` — replaces hand-written `.option()` chains on
+ *    a ShimCommand with generated calls derived from the same ParamDef array.
+ *
+ * Both functions read exactly the same source of truth that the dispatch
+ * registry and `cleo schema` use, eliminating the duplication that caused
+ * missing enum values, absent required indicators, and hidden gate docs.
+ *
+ * Gate lookup uses `describeOperation()` from `@cleocode/lafs`, which is the
+ * public API over the static LAFS gate table in `operation-gates.ts`.
+ *
+ * @module
+ * @epic T335
+ * @task T339
+ */
+import type { ParamDef } from '../dispatch/types.js';
+import type { ShimCommand } from './commander-shim.js';
+/**
+ * Build a multi-section Commander-compatible help string from a ParamDef
+ * array and the static LAFS gate table.
+ *
+ * Sections emitted:
+ * - `Description:` — one-line operation summary
+ * - `USAGE:` — positional args listed in required/optional angle/square brackets
+ * - `ARGUMENTS:` — positional params with descriptions (omitted when none)
+ * - `OPTIONS:` — flag params with type, enum values, and required indicator
+ * - `PRECONDITIONS:` — gates sourced from `packages/lafs/src/operation-gates.ts`
+ *   via `describeOperation()` (omitted when the gate table has no entry for
+ *   this operation key)
+ * - `Examples:` — pre-canned examples for the five seeded operations
+ *
+ * @param operationKey - Fully-qualified operation key, e.g. `"tasks.add"`.
+ * @param description - One-line summary of the operation.
+ * @param params - ParamDef array for the operation.
+ * @returns Multi-line help string.
+ */
+export declare function buildOperationHelp(operationKey: string, description: string, params: readonly ParamDef[]): string;
+/**
+ * Register Commander options and positional arguments on a ShimCommand from
+ * a ParamDef array.
+ *
+ * Replaces hand-written `.option(...)` chains with a single call.
+ *
+ * Handles:
+ * - Positional args (`cli.positional === true`) → `.argument()`
+ * - Short aliases (`cli.short`) → `-s, --flag <type>`
+ * - Flag name overrides (`cli.flag`) → `--custom-flag`
+ * - Boolean flags (type === `'boolean'`) → no value placeholder
+ * - Custom parse functions (`cli.parse`) → forwarded to `.option()`
+ * - Enum constraints surfaced in the option description
+ * - Required vs optional indicators appended to the description
+ *
+ * **Note:** The caller is still responsible for the `.action(...)` callback
+ * because action bodies are command-specific and cannot be auto-generated.
+ *
+ * **Hybrid pattern:** Some commands keep hand-written `.option()` calls after
+ * this call for options that have no ParamDef entry (e.g. `--dry-run`,
+ * `--field`, `--format`, `--desc`). That is intentional — those options are
+ * CLI-surface-only and do not belong in the dispatch registry.
+ *
+ * @param command - The ShimCommand returned by `.command(nameAndArgs)`.
+ * @param params - The ParamDef array for this operation.
+ * @param operationKey - `"tasks.add"` etc. Reserved for future hook or tracing
+ *   use; currently not mutated on the shim since ShimCommand has no first-class
+ *   help-text override API.
+ */
+export declare function applyParamDefsToCommand(command: ShimCommand, params: readonly ParamDef[], operationKey: string): void;
+//# sourceMappingURL=help-generator.d.ts.map

package/dist/cli/help-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-generator.d.ts","sourceRoot":"","sources":["../../src/cli/help-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAsEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,QAAQ,EAAE,GAC1B,MAAM,CAwFR;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,SAAS,QAAQ,EAAE,EAC3B,YAAY,EAAE,MAAM,GACnB,IAAI,CAmCN"}

package/dist/cli/help-generator.js

@@ -0,0 +1,229 @@
+/**
+ * ParamDef-driven Commander help generator.
+ *
+ * Provides two functions:
+ *  - `buildOperationHelp()` — emits a multi-section help string (Description,
+ *    USAGE, ARGUMENTS, OPTIONS, PRECONDITIONS) from a ParamDef array and the
+ *    static LAFS gate table.
+ *  - `applyParamDefsToCommand()` — replaces hand-written `.option()` chains on
+ *    a ShimCommand with generated calls derived from the same ParamDef array.
+ *
+ * Both functions read exactly the same source of truth that the dispatch
+ * registry and `cleo schema` use, eliminating the duplication that caused
+ * missing enum values, absent required indicators, and hidden gate docs.
+ *
+ * Gate lookup uses `describeOperation()` from `@cleocode/lafs`, which is the
+ * public API over the static LAFS gate table in `operation-gates.ts`.
+ *
+ * @module
+ * @epic T335
+ * @task T339
+ */
+import { describeOperation } from '@cleocode/lafs';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert a camelCase identifier to kebab-case CLI flag name.
+ *
+ * @param name - camelCase string (e.g. `"dryRun"`)
+ * @returns kebab-case string (e.g. `"dry-run"`)
+ */
+function toKebab(name) {
+    return name.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}
+/**
+ * Retrieve precondition gates for an operation key using the public
+ * `describeOperation()` API from `@cleocode/lafs`.
+ *
+ * Parses `"tasks.add"` → `{ domain: "tasks", operation: "add" }` and calls
+ * `describeOperation` with the minimum required fields so that the static
+ * LAFS gate table lookup succeeds.
+ *
+ * @param operationKey - Fully-qualified operation key, e.g. `"tasks.add"`.
+ * @param params - ParamDef array for the operation (may be empty).
+ * @returns Array of {@link OperationGateSchema} entries, possibly empty.
+ */
+function getGatesForOperation(operationKey, params) {
+    const dotIdx = operationKey.indexOf('.');
+    if (dotIdx === -1)
+        return [];
+    const domain = operationKey.slice(0, dotIdx);
+    const operation = operationKey.slice(dotIdx + 1);
+    const schema = describeOperation({
+        gateway: 'query',
+        domain,
+        operation,
+        description: '',
+        params: params,
+        requiredParams: [],
+    }, { includeGates: true });
+    return schema.gates ?? [];
+}
+// ---------------------------------------------------------------------------
+// buildOperationHelp
+// ---------------------------------------------------------------------------
+/**
+ * Build a multi-section Commander-compatible help string from a ParamDef
+ * array and the static LAFS gate table.
+ *
+ * Sections emitted:
+ * - `Description:` — one-line operation summary
+ * - `USAGE:` — positional args listed in required/optional angle/square brackets
+ * - `ARGUMENTS:` — positional params with descriptions (omitted when none)
+ * - `OPTIONS:` — flag params with type, enum values, and required indicator
+ * - `PRECONDITIONS:` — gates sourced from `packages/lafs/src/operation-gates.ts`
+ *   via `describeOperation()` (omitted when the gate table has no entry for
+ *   this operation key)
+ * - `Examples:` — pre-canned examples for the five seeded operations
+ *
+ * @param operationKey - Fully-qualified operation key, e.g. `"tasks.add"`.
+ * @param description - One-line summary of the operation.
+ * @param params - ParamDef array for the operation.
+ * @returns Multi-line help string.
+ */
+export function buildOperationHelp(operationKey, description, params) {
+    // Derive the CLI noun from the operation key ("tasks.add" → "add")
+    const cliName = operationKey.split('.').slice(1).join('.');
+    const positionals = params.filter((p) => p.cli?.positional && !p.hidden);
+    const flags = params.filter((p) => !p.cli?.positional && !p.hidden);
+    // --- USAGE line ---
+    const argTokens = positionals.map((p) => (p.required ? `<${p.name}>` : `[${p.name}]`)).join(' ');
+    const usageLine = `USAGE: cleo ${cliName}` +
+        (flags.length > 0 ? ' [OPTIONS]' : '') +
+        (argTokens ? ` ${argTokens}` : '');
+    const lines = [];
+    lines.push(`Description: ${description}`);
+    lines.push('');
+    lines.push(usageLine);
+    // --- ARGUMENTS section ---
+    if (positionals.length > 0) {
+        lines.push('');
+        lines.push('ARGUMENTS:');
+        for (const p of positionals) {
+            const indicator = p.required ? '(required)' : '(optional)';
+            const namePad = p.name.padEnd(16);
+            lines.push(`  ${namePad} ${p.description}  ${indicator}`);
+        }
+    }
+    // --- OPTIONS section ---
+    if (flags.length > 0) {
+        lines.push('');
+        lines.push('OPTIONS:');
+        for (const p of flags) {
+            const flagName = p.cli?.flag ?? toKebab(p.name);
+            const short = p.cli?.short;
+            const typeLabel = p.type !== 'boolean' ? ` <${p.type}>` : '';
+            const flagStr = short
+                ? `${short}, --${flagName}${typeLabel}`
+                : `    --${flagName}${typeLabel}`;
+            const enumSuffix = p.enum && p.enum.length > 0 ? `  [enum: ${p.enum.join('|')}]` : '';
+            const reqSuffix = p.required ? '  [required]' : '';
+            lines.push(`  ${flagStr.padEnd(32)} ${p.description}${enumSuffix}${reqSuffix}`);
+        }
+    }
+    // --- PRECONDITIONS section ---
+    const gates = getGatesForOperation(operationKey, params);
+    if (gates.length > 0) {
+        lines.push('');
+        lines.push('PRECONDITIONS (gates that may fire):');
+        for (const gate of gates) {
+            lines.push(`  - ${gate.errorCode} [${gate.name}]: ${gate.description}`);
+            for (const trigger of gate.triggers) {
+                lines.push(`      * ${trigger}`);
+            }
+        }
+    }
+    // --- Examples section ---
+    const EXAMPLES = {
+        'tasks.add': [
+            "  cleo add 'My task title'",
+            "  cleo add 'My task' --priority high --parent T100",
+            "  cleo add 'Fix login bug' --type bug --size small --acceptance 'Reproducer passes|CI green'",
+        ],
+        'tasks.complete': [
+            '  cleo complete T123',
+            '  cleo complete T123 --force',
+            "  cleo complete T123 --verification-note 'All ACs verified in PR #456'",
+        ],
+        'tasks.show': ['  cleo show T123'],
+        'tasks.find': ['  cleo find "auth"', '  cleo find --status active --limit 10'],
+        'tasks.list': ['  cleo list --parent T100', '  cleo list --status active --priority high'],
+    };
+    const examples = EXAMPLES[operationKey];
+    if (examples && examples.length > 0) {
+        lines.push('');
+        lines.push('Examples:');
+        for (const ex of examples) {
+            lines.push(ex);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// applyParamDefsToCommand
+// ---------------------------------------------------------------------------
+/**
+ * Register Commander options and positional arguments on a ShimCommand from
+ * a ParamDef array.
+ *
+ * Replaces hand-written `.option(...)` chains with a single call.
+ *
+ * Handles:
+ * - Positional args (`cli.positional === true`) → `.argument()`
+ * - Short aliases (`cli.short`) → `-s, --flag <type>`
+ * - Flag name overrides (`cli.flag`) → `--custom-flag`
+ * - Boolean flags (type === `'boolean'`) → no value placeholder
+ * - Custom parse functions (`cli.parse`) → forwarded to `.option()`
+ * - Enum constraints surfaced in the option description
+ * - Required vs optional indicators appended to the description
+ *
+ * **Note:** The caller is still responsible for the `.action(...)` callback
+ * because action bodies are command-specific and cannot be auto-generated.
+ *
+ * **Hybrid pattern:** Some commands keep hand-written `.option()` calls after
+ * this call for options that have no ParamDef entry (e.g. `--dry-run`,
+ * `--field`, `--format`, `--desc`). That is intentional — those options are
+ * CLI-surface-only and do not belong in the dispatch registry.
+ *
+ * @param command - The ShimCommand returned by `.command(nameAndArgs)`.
+ * @param params - The ParamDef array for this operation.
+ * @param operationKey - `"tasks.add"` etc. Reserved for future hook or tracing
+ *   use; currently not mutated on the shim since ShimCommand has no first-class
+ *   help-text override API.
+ */
+export function applyParamDefsToCommand(command, params, operationKey) {
+    // operationKey is reserved for future tracing/hook use.
+    void operationKey;
+    for (const p of params) {
+        // Hidden params have no CLI surface — skip entirely.
+        if (p.hidden)
+            continue;
+        if (p.cli?.positional) {
+            // Positional arguments are registered via .argument()
+            const spec = p.required ? `<${p.name}>` : `[${p.name}]`;
+            command.argument(spec, p.description);
+            continue;
+        }
+        // Build the flag string
+        const flagName = p.cli?.flag ?? toKebab(p.name);
+        const short = p.cli?.short;
+        const typeLabel = p.type !== 'boolean' ? ` <${p.type}>` : '';
+        const flagPart = short ? `${short}, --${flagName}${typeLabel}` : `--${flagName}${typeLabel}`;
+        // Augment description with enum hint so agents see allowed values in --help
+        const enumHint = p.enum && p.enum.length > 0 ? ` (${p.enum.join('|')})` : '';
+        const reqHint = p.required ? ' [required]' : '';
+        const fullDescription = `${p.description}${enumHint}${reqHint}`;
+        if (p.required && p.type !== 'boolean') {
+            // Use requiredOption for non-boolean required flags
+            command.requiredOption(flagPart, fullDescription);
+        }
+        else if (p.cli?.parse) {
+            command.option(flagPart, fullDescription, p.cli.parse);
+        }
+        else {
+            command.option(flagPart, fullDescription);
+        }
+    }
+}
+//# sourceMappingURL=help-generator.js.map

package/dist/cli/help-generator.js.map

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