@cleocode/cleo 2026.4.9 → 2026.4.11

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

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

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

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

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

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

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

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

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

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

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

package/dist/cli/progress.js

@@ -0,0 +1,169 @@
+/**
+ * Progress indicator utilities for CLI commands.
+ * Provides human-friendly progress output for long-running operations.
+ *
+ * @task T5243
+ */
+import { stderr, stdout } from 'node:process';
+/**
+ * Simple progress tracker for CLI operations.
+ */
+export class ProgressTracker {
+    enabled;
+    prefix;
+    currentStep = 0;
+    totalSteps;
+    steps;
+    constructor(options) {
+        this.enabled = options.enabled;
+        this.prefix = options.prefix ?? 'CLEO';
+        this.steps = options.steps;
+        this.totalSteps = options.steps.length;
+    }
+    /**
+     * Start the progress tracker.
+     */
+    start() {
+        if (!this.enabled)
+            return;
+        this.currentStep = 0;
+        stderr.write(`\n${this.prefix}: Starting...\n`);
+    }
+    /**
+     * Update to a specific step.
+     */
+    step(index, message) {
+        if (!this.enabled)
+            return;
+        this.currentStep = index;
+        const stepName = this.steps[index] ?? message ?? 'Working...';
+        const progress = `[${index + 1}/${this.totalSteps}]`;
+        stderr.write(`  ${progress} ${stepName}...\n`);
+    }
+    /**
+     * Move to next step.
+     */
+    next(message) {
+        this.step(this.currentStep + 1, message);
+    }
+    /**
+     * Mark as complete with optional summary.
+     */
+    complete(summary) {
+        if (!this.enabled)
+            return;
+        if (summary) {
+            stdout.write(`\n${this.prefix}: ✓ ${summary}\n\n`);
+        }
+        else {
+            stdout.write(`\n${this.prefix}: ✓ Complete\n\n`);
+        }
+    }
+    /**
+     * Report an error.
+     */
+    error(message) {
+        if (!this.enabled)
+            return;
+        stderr.write(`\n${this.prefix}: ✗ ${message}\n\n`);
+    }
+}
+/**
+ * Simple spinner for indeterminate progress.
+ */
+export class Spinner {
+    enabled;
+    message;
+    timer = null;
+    frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    frameIndex = 0;
+    constructor(options) {
+        this.enabled = options.enabled;
+        this.message = options.message;
+    }
+    /**
+     * Start the spinner.
+     */
+    start() {
+        if (!this.enabled)
+            return;
+        this.timer = setInterval(() => {
+            const frame = this.frames[this.frameIndex];
+            stderr.write(`\r${frame} ${this.message}`);
+            this.frameIndex = (this.frameIndex + 1) % this.frames.length;
+        }, 80);
+    }
+    /**
+     * Stop the spinner.
+     */
+    stop(finalMessage) {
+        if (!this.enabled)
+            return;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (finalMessage) {
+            stderr.write(`\r✓ ${finalMessage}\n`);
+        }
+        else {
+            stderr.write('\r'.padEnd(this.message.length + 2) + '\r');
+        }
+    }
+    /**
+     * Update the spinner message.
+     */
+    update(message) {
+        this.message = message;
+    }
+}
+/**
+ * Create a progress tracker for self-update operations.
+ */
+export function createSelfUpdateProgress(enabled) {
+    return new ProgressTracker({
+        enabled,
+        prefix: 'CLEO',
+        steps: [
+            'Detecting installation type',
+            'Checking current version',
+            'Querying npm registry',
+            'Comparing versions',
+            'Running post-update checks',
+            'Finalizing',
+        ],
+    });
+}
+/**
+ * Create a progress tracker for doctor operations.
+ */
+export function createDoctorProgress(enabled) {
+    return new ProgressTracker({
+        enabled,
+        prefix: 'CLEO Doctor',
+        steps: [
+            'Checking CLEO directory',
+            'Verifying tasks database',
+            'Checking configuration',
+            'Validating schemas',
+            'Running health checks',
+        ],
+    });
+}
+/**
+ * Create a progress tracker for upgrade operations.
+ */
+export function createUpgradeProgress(enabled) {
+    return new ProgressTracker({
+        enabled,
+        prefix: 'CLEO Upgrade',
+        steps: [
+            'Analyzing current state',
+            'Checking storage migration needs',
+            'Validating schemas',
+            'Applying fixes',
+            'Verifying results',
+        ],
+    });
+}
+//# sourceMappingURL=progress.js.map

package/dist/cli/progress.js.map

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

package/dist/cli/renderers/colors.d.ts

@@ -0,0 +1,32 @@
+export declare const BOLD: string;
+export declare const DIM: string;
+export declare const NC: string;
+export declare const RED: string;
+export declare const GREEN: string;
+export declare const YELLOW: string;
+export declare const BLUE: string;
+export declare const MAGENTA: string;
+export declare const CYAN: string;
+/** Map task status to a display symbol. Falls back to '?' for unknown values. */
+export declare function statusSymbol(status: string): string;
+/** Map task status to a color escape. */
+export declare function statusColor(status: string): string;
+/** Map task priority to a display symbol. */
+export declare function prioritySymbol(priority: string): string;
+/** Map task priority to a color escape. */
+export declare function priorityColor(priority: string): string;
+export declare const BOX: {
+    tl: string;
+    tr: string;
+    bl: string;
+    br: string;
+    h: string;
+    v: string;
+    ml: string;
+    mr: string;
+};
+/** Create a horizontal rule with box-drawing characters. */
+export declare function hRule(width?: number): string;
+/** Format a date string as YYYY-MM-DD. */
+export declare function shortDate(isoDate: string | null | undefined): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/cli/renderers/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/cli/renderers/colors.ts"],"names":[],"mappings":"AAyCA,eAAO,MAAM,IAAI,QAAkB,CAAC;AACpC,eAAO,MAAM,GAAG,QAAkB,CAAC;AACnC,eAAO,MAAM,EAAE,QAAkB,CAAC;AAClC,eAAO,MAAM,GAAG,QAAqB,CAAC;AACtC,eAAO,MAAM,KAAK,QAAqB,CAAC;AACxC,eAAO,MAAM,MAAM,QAAqB,CAAC;AACzC,eAAO,MAAM,IAAI,QAAqB,CAAC;AACvC,eAAO,MAAM,OAAO,QAAqB,CAAC;AAC1C,eAAO,MAAM,IAAI,QAAqB,CAAC;AAMvC,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBlD;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2BvD;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAatD;AAMD,eAAO,MAAM,GAAG;;;;;;;;;CAW4D,CAAC;AAE7E,4DAA4D;AAC5D,wBAAgB,KAAK,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,CAEhD;AAED,0CAA0C;AAC1C,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGpE"}

package/dist/cli/renderers/colors.js

@@ -0,0 +1,141 @@
+/**
+ * Terminal color and symbol utilities for human-readable CLI output.
+ *
+ * Respects NO_COLOR (https://no-color.org) and FORCE_COLOR env vars.
+ * Falls back to plain ASCII when color is not supported.
+ *
+ * Status symbols are sourced from the registry (TASK_STATUS_SYMBOLS_UNICODE /
+ * TASK_STATUS_SYMBOLS_ASCII) to keep icon definitions co-located with the
+ * status values they describe.
+ *
+ * @task T4666
+ * @epic T4663
+ */
+import { TASK_STATUS_SYMBOLS_ASCII, TASK_STATUS_SYMBOLS_UNICODE, } from '@cleocode/contracts';
+/** Whether ANSI color escape codes should be used. */
+const colorsEnabled = (() => {
+    if (process.env['NO_COLOR'] !== undefined)
+        return false;
+    if (process.env['FORCE_COLOR'] !== undefined)
+        return true;
+    return process.stdout.isTTY === true;
+})();
+/** Whether Unicode box-drawing and emoji are supported. */
+const unicodeEnabled = (() => {
+    const lang = process.env['LANG'] ?? '';
+    if (lang === 'C' || lang === 'POSIX')
+        return false;
+    return lang.includes('UTF') || process.platform === 'darwin';
+})();
+// ---------------------------------------------------------------------------
+// ANSI escape helpers
+// ---------------------------------------------------------------------------
+function ansi(code) {
+    return colorsEnabled ? code : '';
+}
+export const BOLD = ansi('\x1b[1m');
+export const DIM = ansi('\x1b[2m');
+export const NC = ansi('\x1b[0m'); // reset
+export const RED = ansi('\x1b[0;31m');
+export const GREEN = ansi('\x1b[0;32m');
+export const YELLOW = ansi('\x1b[1;33m');
+export const BLUE = ansi('\x1b[0;34m');
+export const MAGENTA = ansi('\x1b[0;35m');
+export const CYAN = ansi('\x1b[0;36m');
+// ---------------------------------------------------------------------------
+// Status symbols and colors
+// ---------------------------------------------------------------------------
+/** Map task status to a display symbol. Falls back to '?' for unknown values. */
+export function statusSymbol(status) {
+    const map = unicodeEnabled ? TASK_STATUS_SYMBOLS_UNICODE : TASK_STATUS_SYMBOLS_ASCII;
+    return map[status] ?? '?';
+}
+/** Map task status to a color escape. */
+export function statusColor(status) {
+    switch (status) {
+        case 'pending':
+            return CYAN;
+        case 'active':
+            return GREEN;
+        case 'blocked':
+            return RED;
+        case 'done':
+            return DIM;
+        case 'cancelled':
+            return DIM;
+        case 'archived':
+            return DIM;
+        default:
+            return '';
+    }
+}
+/** Map task priority to a display symbol. */
+export function prioritySymbol(priority) {
+    if (unicodeEnabled) {
+        switch (priority) {
+            case 'critical':
+                return '\uD83D\uDD34'; // red circle emoji
+            case 'high':
+                return '\uD83D\uDFE1'; // yellow circle emoji
+            case 'medium':
+                return '\uD83D\uDD35'; // blue circle emoji
+            case 'low':
+                return '\u26AA'; // white circle emoji
+            default:
+                return '';
+        }
+    }
+    switch (priority) {
+        case 'critical':
+            return '!';
+        case 'high':
+            return 'H';
+        case 'medium':
+            return 'M';
+        case 'low':
+            return 'L';
+        default:
+            return '';
+    }
+}
+/** Map task priority to a color escape. */
+export function priorityColor(priority) {
+    switch (priority) {
+        case 'critical':
+            return RED;
+        case 'high':
+            return YELLOW;
+        case 'medium':
+            return BLUE;
+        case 'low':
+            return DIM;
+        default:
+            return '';
+    }
+}
+// ---------------------------------------------------------------------------
+// Box drawing
+// ---------------------------------------------------------------------------
+export const BOX = unicodeEnabled
+    ? {
+        tl: '\u256D',
+        tr: '\u256E',
+        bl: '\u2570',
+        br: '\u256F',
+        h: '\u2500',
+        v: '\u2502',
+        ml: '\u251C',
+        mr: '\u2524',
+    }
+    : { tl: '+', tr: '+', bl: '+', br: '+', h: '-', v: '|', ml: '+', mr: '+' };
+/** Create a horizontal rule with box-drawing characters. */
+export function hRule(width = 65) {
+    return BOX.h.repeat(width);
+}
+/** Format a date string as YYYY-MM-DD. */
+export function shortDate(isoDate) {
+    if (!isoDate)
+        return '';
+    return isoDate.split('T')[0] ?? isoDate;
+}
+//# sourceMappingURL=colors.js.map

package/dist/cli/renderers/colors.js.map

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

package/dist/cli/renderers/error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Structured markdown error renderer for CLI output.
+ *
+ * Renders CleoError instances as human-readable markdown for terminal display.
+ *
+ * @task T5240
+ */
+import type { CleoError } from '@cleocode/core';
+/**
+ * Render a CleoError as structured markdown for CLI display.
+ */
+export declare function renderErrorMarkdown(error: CleoError): string;
+//# sourceMappingURL=error.d.ts.map

package/dist/cli/renderers/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/cli/renderers/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAkC5D"}

package/dist/cli/renderers/error.js

@@ -0,0 +1,42 @@
+/**
+ * Structured markdown error renderer for CLI output.
+ *
+ * Renders CleoError instances as human-readable markdown for terminal display.
+ *
+ * @task T5240
+ */
+import { getExitCodeName } from '@cleocode/contracts';
+import { getErrorDefinition } from '@cleocode/core';
+/**
+ * Render a CleoError as structured markdown for CLI display.
+ */
+export function renderErrorMarkdown(error) {
+    const def = getErrorDefinition(error.code);
+    const name = getExitCodeName(error.code);
+    const lines = [];
+    lines.push(`**Error ${error.code}**: ${name}`);
+    lines.push('');
+    lines.push(error.message);
+    if (def?.category) {
+        lines.push('');
+        lines.push(`Category: ${def.category}`);
+    }
+    const fix = error.fix ?? def?.fix;
+    if (fix) {
+        lines.push('');
+        lines.push(`**Fix**: ${fix}`);
+    }
+    if (error.alternatives && error.alternatives.length > 0) {
+        lines.push('');
+        lines.push('**Alternatives**:');
+        for (const alt of error.alternatives) {
+            lines.push(`  - ${alt.action}: \`${alt.command}\``);
+        }
+    }
+    if (def?.recoverable) {
+        lines.push('');
+        lines.push('This error is recoverable -- retrying may succeed.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=error.js.map

package/dist/cli/renderers/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/cli/renderers/error.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,MAAM,GAAG,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,OAAO,IAAI,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE1B,IAAI,GAAG,EAAE,QAAQ,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,CAAC;IAClC,IAAI,GAAG,EAAE,CAAC;QACR,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,OAAO,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}