@cleocode/cleo 2026.4.13 → 2026.4.15

package/dist/cli/format-context.d.ts

@@ -1,32 +0,0 @@
-/**
- * CLI output format resolution context.
- *
- * Singleton that holds the resolved output format for the current CLI invocation.
- * Set once in the Commander.js preAction hook; read by cliOutput() and renderers.
- *
- * @task T4665
- * @epic T4663
- */
-import type { FlagResolution } from '@cleocode/lafs';
-/**
- * Set the resolved format for this CLI invocation.
- * Called once from the preAction hook in src/cli/index.ts.
- */
-export declare function setFormatContext(resolution: FlagResolution): void;
-/**
- * Get the current resolved format.
- */
-export declare function getFormatContext(): FlagResolution;
-/**
- * Check if output should be JSON format.
- */
-export declare function isJsonFormat(): boolean;
-/**
- * Check if output should be human-readable format.
- */
-export declare function isHumanFormat(): boolean;
-/**
- * Check if quiet mode is enabled (suppress non-essential output).
- */
-export declare function isQuiet(): boolean;
-//# sourceMappingURL=format-context.d.ts.map

package/dist/cli/format-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"format-context.d.ts","sourceRoot":"","sources":["../../src/cli/format-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAYrD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAEjD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC"}

package/dist/cli/format-context.js

@@ -1,50 +0,0 @@
-/**
- * CLI output format resolution context.
- *
- * Singleton that holds the resolved output format for the current CLI invocation.
- * Set once in the Commander.js preAction hook; read by cliOutput() and renderers.
- *
- * @task T4665
- * @epic T4663
- */
-/**
- * Current resolved format for this CLI invocation.
- * Defaults to JSON (agent-first) until resolved by preAction hook.
- */
-let currentResolution = {
-    format: 'json',
-    source: 'default',
-    quiet: false,
-};
-/**
- * Set the resolved format for this CLI invocation.
- * Called once from the preAction hook in src/cli/index.ts.
- */
-export function setFormatContext(resolution) {
-    currentResolution = resolution;
-}
-/**
- * Get the current resolved format.
- */
-export function getFormatContext() {
-    return currentResolution;
-}
-/**
- * Check if output should be JSON format.
- */
-export function isJsonFormat() {
-    return currentResolution.format === 'json';
-}
-/**
- * Check if output should be human-readable format.
- */
-export function isHumanFormat() {
-    return currentResolution.format === 'human';
-}
-/**
- * Check if quiet mode is enabled (suppress non-essential output).
- */
-export function isQuiet() {
-    return currentResolution.quiet;
-}
-//# sourceMappingURL=format-context.js.map

package/dist/cli/format-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"format-context.js","sourceRoot":"","sources":["../../src/cli/format-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,IAAI,iBAAiB,GAAmB;IACtC,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,KAAK;CACb,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA0B;IACzD,iBAAiB,GAAG,UAAU,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,iBAAiB,CAAC,MAAM,KAAK,MAAM,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,iBAAiB,CAAC,MAAM,KAAK,OAAO,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,iBAAiB,CAAC,KAAK,CAAC;AACjC,CAAC"}

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

@@ -1,74 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,229 +0,0 @@
-/**
- * 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

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

package/dist/cli/index.d.ts

@@ -1,9 +0,0 @@
-/**
- * CLEO CLI - Main entry point
- *
- * Bridges commander-shim commands to citty for execution.
- *
- * TODO: Migrate all 89 commands to native citty pattern (epic T5730)
- */
-export {};
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/cli/logger-bootstrap.d.ts

@@ -1,6 +0,0 @@
-import type { LoggerConfig } from '@cleocode/core';
-/**
- * Initialize CLI logger with optional projectHash correlation context.
- */
-export declare function initCliLogger(cwd: string, loggingConfig: LoggerConfig): void;
-//# sourceMappingURL=logger-bootstrap.d.ts.map

package/dist/cli/logger-bootstrap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger-bootstrap.d.ts","sourceRoot":"","sources":["../../src/cli/logger-bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,GAAG,IAAI,CAG5E"}

package/dist/cli/logger-bootstrap.js

@@ -1,10 +0,0 @@
-import { join } from 'node:path';
-import { getProjectInfoSync, initLogger } from '@cleocode/core';
-/**
- * Initialize CLI logger with optional projectHash correlation context.
- */
-export function initCliLogger(cwd, loggingConfig) {
-    const projectInfo = getProjectInfoSync(cwd);
-    initLogger(join(cwd, '.cleo'), loggingConfig, projectInfo?.projectHash);
-}
-//# sourceMappingURL=logger-bootstrap.js.map

package/dist/cli/logger-bootstrap.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger-bootstrap.js","sourceRoot":"","sources":["../../src/cli/logger-bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,aAA2B;IACpE,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5C,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAC1E,CAAC"}

package/dist/cli/middleware/output-format.d.ts

@@ -1,30 +0,0 @@
-/**
- * Shared CLI middleware for resolving output format from --human/--json/--quiet flags.
- *
- * Delegates to LAFS protocol's resolveOutputFormat() for canonical flag resolution,
- * and provides a Commander.js-compatible helper to extract flag values from opts.
- *
- * @task T4703
- * @epic T4663
- */
-import { type FlagResolution } from '@cleocode/lafs';
-export type { FlagResolution };
-/**
- * Resolve output format from Commander.js option values.
- *
- * Reads --json, --human, and --quiet flags and delegates to
- * the canonical LAFS resolveOutputFormat(). Project/user defaults
- * can be passed via the optional `defaults` parameter.
- *
- * @param opts - Commander.js parsed options object
- * @param defaults - Optional project/user defaults
- * @returns Resolved format with source provenance
- *
- * @task T4703
- * @epic T4663
- */
-export declare function resolveFormat(opts: Record<string, unknown>, defaults?: {
-    projectDefault?: 'json' | 'human';
-    userDefault?: 'json' | 'human';
-}): FlagResolution;
-//# sourceMappingURL=output-format.d.ts.map

package/dist/cli/middleware/output-format.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"output-format.d.ts","sourceRoot":"","sources":["../../../src/cli/middleware/output-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAkB,KAAK,cAAc,EAAuB,MAAM,gBAAgB,CAAC;AAE1F,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC/E,cAAc,CAUhB"}

package/dist/cli/middleware/output-format.js

@@ -1,35 +0,0 @@
-/**
- * Shared CLI middleware for resolving output format from --human/--json/--quiet flags.
- *
- * Delegates to LAFS protocol's resolveOutputFormat() for canonical flag resolution,
- * and provides a Commander.js-compatible helper to extract flag values from opts.
- *
- * @task T4703
- * @epic T4663
- */
-import { resolveOutputFormat } from '@cleocode/lafs';
-/**
- * Resolve output format from Commander.js option values.
- *
- * Reads --json, --human, and --quiet flags and delegates to
- * the canonical LAFS resolveOutputFormat(). Project/user defaults
- * can be passed via the optional `defaults` parameter.
- *
- * @param opts - Commander.js parsed options object
- * @param defaults - Optional project/user defaults
- * @returns Resolved format with source provenance
- *
- * @task T4703
- * @epic T4663
- */
-export function resolveFormat(opts, defaults) {
-    const input = {
-        jsonFlag: opts['json'] === true,
-        humanFlag: opts['human'] === true,
-        quiet: opts['quiet'] === true,
-        projectDefault: defaults?.projectDefault,
-        userDefault: defaults?.userDefault,
-    };
-    return resolveOutputFormat(input);
-}
-//# sourceMappingURL=output-format.js.map

package/dist/cli/middleware/output-format.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"output-format.js","sourceRoot":"","sources":["../../../src/cli/middleware/output-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAuC,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAI1F;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA6B,EAC7B,QAAgF;IAEhF,MAAM,KAAK,GAAc;QACvB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI;QAC/B,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;QACjC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI;QAC7B,cAAc,EAAE,QAAQ,EAAE,cAAc;QACxC,WAAW,EAAE,QAAQ,EAAE,WAAW;KACnC,CAAC;IAEF,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/cli/progress.d.ts

@@ -1,84 +0,0 @@
-/**
- * Progress indicator utilities for CLI commands.
- * Provides human-friendly progress output for long-running operations.
- *
- * @task T5243
- */
-export interface ProgressOptions {
-    /** Whether to show progress (true for human mode, false for JSON mode) */
-    enabled: boolean;
-    /** Prefix for progress messages */
-    prefix?: string;
-}
-/**
- * Simple progress tracker for CLI operations.
- */
-export declare class ProgressTracker {
-    private enabled;
-    private prefix;
-    private currentStep;
-    private totalSteps;
-    private steps;
-    constructor(options: ProgressOptions & {
-        steps: string[];
-    });
-    /**
-     * Start the progress tracker.
-     */
-    start(): void;
-    /**
-     * Update to a specific step.
-     */
-    step(index: number, message?: string): void;
-    /**
-     * Move to next step.
-     */
-    next(message?: string): void;
-    /**
-     * Mark as complete with optional summary.
-     */
-    complete(summary?: string): void;
-    /**
-     * Report an error.
-     */
-    error(message: string): void;
-}
-/**
- * Simple spinner for indeterminate progress.
- */
-export declare class Spinner {
-    private enabled;
-    private message;
-    private timer;
-    private frames;
-    private frameIndex;
-    constructor(options: {
-        enabled: boolean;
-        message: string;
-    });
-    /**
-     * Start the spinner.
-     */
-    start(): void;
-    /**
-     * Stop the spinner.
-     */
-    stop(finalMessage?: string): void;
-    /**
-     * Update the spinner message.
-     */
-    update(message: string): void;
-}
-/**
- * Create a progress tracker for self-update operations.
- */
-export declare function createSelfUpdateProgress(enabled: boolean): ProgressTracker;
-/**
- * Create a progress tracker for doctor operations.
- */
-export declare function createDoctorProgress(enabled: boolean): ProgressTracker;
-/**
- * Create a progress tracker for upgrade operations.
- */
-export declare function createUpgradeProgress(enabled: boolean): ProgressTracker;
-//# sourceMappingURL=progress.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/cli/progress.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAW;gBAEZ,OAAO,EAAE,eAAe,GAAG;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE;IAO1D;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ3C;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAShC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI7B;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAK1D;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAajC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG9B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAa1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAYtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAYvE"}