@cleocode/cleo 2026.3.56 → 2026.3.58

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

@@ -0,0 +1,59 @@
+/**
+ * Central output dispatch for V2 CLI commands.
+ *
+ * Provides cliOutput() which replaces `console.log(formatSuccess(data))`.
+ * Checks the resolved format (JSON/human/quiet) and dispatches to either
+ * the LAFS JSON envelope (formatSuccess) or a human-readable renderer.
+ *
+ * Commands call:
+ *   cliOutput(data, { command: 'show', message, operation, page })
+ *
+ * @task T4665
+ * @task T4666
+ * @task T4813
+ * @epic T4663
+ */
+import { type FormatOptions } from '@cleocode/core';
+export interface CliOutputOptions {
+    /** Command name (used to pick the correct human renderer). */
+    command: string;
+    /** Optional success message for JSON envelope. */
+    message?: string;
+    /** Operation name for LAFS _meta. */
+    operation?: string;
+    /** Pagination for LAFS envelope. */
+    page?: FormatOptions['page'];
+    /** Extra LAFS extensions. */
+    extensions?: Record<string, unknown>;
+}
+/**
+ * Output data to stdout in the resolved format (JSON or human-readable).
+ *
+ * Replaces `console.log(formatSuccess(data))` in all V2 commands.
+ * When format is 'human', normalizes the data shape then dispatches to
+ * the appropriate renderer.
+ * When format is 'json', delegates to existing formatSuccess().
+ *
+ * @task T4665
+ * @task T4666
+ * @task T4813
+ */
+export declare function cliOutput(data: unknown, opts: CliOutputOptions): void;
+/**
+ * Error details for structured error output.
+ */
+export interface CliErrorDetails {
+    name?: string;
+    details?: unknown;
+    fix?: unknown;
+}
+/**
+ * Output an error in the resolved format.
+ * For JSON: delegates to formatError (already handled in command catch blocks).
+ * For human: prints a plain error message to stderr.
+ *
+ * @task T4666
+ * @task T4813
+ */
+export declare function cliError(message: string, code?: number | string, _details?: CliErrorDetails): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/renderers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAC;AA8EnE,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAmGrE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EACtB,QAAQ,CAAC,EAAE,eAAe,GACzB,IAAI,CAeN"}

package/dist/cli/renderers/index.js

@@ -0,0 +1,184 @@
+/**
+ * Central output dispatch for V2 CLI commands.
+ *
+ * Provides cliOutput() which replaces `console.log(formatSuccess(data))`.
+ * Checks the resolved format (JSON/human/quiet) and dispatches to either
+ * the LAFS JSON envelope (formatSuccess) or a human-readable renderer.
+ *
+ * Commands call:
+ *   cliOutput(data, { command: 'show', message, operation, page })
+ *
+ * @task T4665
+ * @task T4666
+ * @task T4813
+ * @epic T4663
+ */
+import { formatSuccess } from '@cleocode/core';
+import { applyFieldFilter, extractFieldFromResult } from '@cleocode/lafs-protocol';
+import { getFieldContext } from '../field-context.js';
+import { getFormatContext } from '../format-context.js';
+import { normalizeForHuman } from './normalizer.js';
+// System renderers
+import { renderBlockers, renderCurrent, renderDoctor, renderGeneric, renderNext, renderPlan, renderSession, renderStart, renderStats, renderStop, renderTree, renderVersion, } from './system.js';
+// Task renderers
+import { renderAdd, renderArchive, renderComplete, renderDelete, renderFind, renderList, renderRestore, renderShow, renderUpdate, } from './tasks.js';
+const renderers = {
+    // Task CRUD
+    show: renderShow,
+    list: renderList,
+    ls: renderList,
+    find: renderFind,
+    search: renderFind,
+    add: renderAdd,
+    update: renderUpdate,
+    complete: renderComplete,
+    done: renderComplete,
+    delete: renderDelete,
+    rm: renderDelete,
+    archive: renderArchive,
+    restore: renderRestore,
+    // Task work
+    start: renderStart,
+    stop: renderStop,
+    current: renderCurrent,
+    // System
+    doctor: renderDoctor,
+    stats: renderStats,
+    next: renderNext,
+    plan: renderPlan,
+    blockers: renderBlockers,
+    tree: renderTree,
+    depends: renderTree,
+    deps: renderTree,
+    session: renderSession,
+    version: renderVersion,
+};
+// ---------------------------------------------------------------------------
+// Main output function
+// ---------------------------------------------------------------------------
+/**
+ * Output data to stdout in the resolved format (JSON or human-readable).
+ *
+ * Replaces `console.log(formatSuccess(data))` in all V2 commands.
+ * When format is 'human', normalizes the data shape then dispatches to
+ * the appropriate renderer.
+ * When format is 'json', delegates to existing formatSuccess().
+ *
+ * @task T4665
+ * @task T4666
+ * @task T4813
+ */
+export function cliOutput(data, opts) {
+    const ctx = getFormatContext();
+    const fieldCtx = getFieldContext();
+    if (ctx.format === 'human') {
+        let dataToRender = data;
+        // §5.4.1 filter-then-render: apply --field extraction BEFORE human rendering
+        let fieldExtracted = false;
+        if (fieldCtx.field) {
+            const extracted = extractFieldFromResult(data, fieldCtx.field);
+            if (extracted === undefined) {
+                cliError(`Field "${fieldCtx.field}" not found`, 4, { name: 'E_NOT_FOUND' });
+                process.exit(4);
+            }
+            // If extracted is a primitive, render directly
+            if (typeof extracted !== 'object' || extracted === null) {
+                console.log(String(extracted));
+                return;
+            }
+            // If extracted is an array, wrap it for renderGeneric
+            if (Array.isArray(extracted)) {
+                dataToRender = { [fieldCtx.field]: extracted };
+            }
+            else {
+                dataToRender = extracted;
+            }
+            fieldExtracted = true;
+        }
+        const normalized = normalizeForHuman(opts.command, dataToRender);
+        // After field extraction, use renderGeneric — command-specific renderers
+        // expect the full data structure, not a filtered subset (§5.4.1)
+        const renderer = fieldExtracted ? renderGeneric : (renderers[opts.command] ?? renderGeneric);
+        const text = renderer(normalized, ctx.quiet);
+        if (text) {
+            console.log(text);
+        }
+        return;
+    }
+    // --field: single-field plain text extraction (scripting / agent use).
+    // Centralised here so ALL commands (dispatchFromCli and dispatchRaw) honour the flag.
+    if (fieldCtx.field) {
+        const value = extractFieldFromResult(data, fieldCtx.field);
+        if (value === undefined) {
+            cliError(`Field "${fieldCtx.field}" not found`, 4, { name: 'E_NOT_FOUND' });
+            process.exit(4);
+        }
+        const out = value !== null && typeof value === 'object' ? JSON.stringify(value) : String(value);
+        process.stdout.write(out + '\n');
+        return;
+    }
+    // JSON format (default): apply --fields filter, then emit LAFS envelope.
+    // Centralised here so ALL commands honour the flag without per-command wiring.
+    // applyFieldFilter can throw on unusual mixed-type arrays (e.g. changes: ['status']).
+    // In that case we fall back to unfiltered output rather than crashing.
+    let filteredData = data;
+    if (fieldCtx.fields?.length && data !== undefined && data !== null) {
+        try {
+            const stub = {
+                $schema: 'https://lafs.dev/schemas/v1/envelope.schema.json',
+                _meta: {
+                    specVersion: '',
+                    schemaVersion: '',
+                    timestamp: '',
+                    operation: '',
+                    requestId: '',
+                    transport: 'cli',
+                    strict: false,
+                    mvi: 'standard',
+                    contextVersion: 0,
+                },
+                success: true,
+                result: data,
+            };
+            const filtered = applyFieldFilter(stub, fieldCtx.fields);
+            filteredData = filtered.result;
+        }
+        catch {
+            // applyFieldFilter limitation: mixed-type arrays (strings inside arrays) are not
+            // supported. Fall through to emit the full unfiltered result.
+        }
+    }
+    // Per LAFS §9.1 (v1.5.0 clarification): _meta MUST always be present.
+    // --mvi minimal governs result contents only; mvi level is reflected in _meta.mvi.
+    const formatOpts = {};
+    if (opts.operation)
+        formatOpts.operation = opts.operation;
+    if (opts.page)
+        formatOpts.page = opts.page;
+    if (opts.extensions)
+        formatOpts.extensions = opts.extensions;
+    if (fieldCtx.mvi)
+        formatOpts.mvi = fieldCtx.mvi;
+    console.log(formatSuccess(filteredData, opts.message, Object.keys(formatOpts).length > 0 ? formatOpts : opts.operation));
+}
+/**
+ * Output an error in the resolved format.
+ * For JSON: delegates to formatError (already handled in command catch blocks).
+ * For human: prints a plain error message to stderr.
+ *
+ * @task T4666
+ * @task T4813
+ */
+export function cliError(message, code, _details) {
+    const ctx = getFormatContext();
+    if (ctx.format === 'human') {
+        console.error(`Error: ${message}${code ? ` (${code})` : ''}`);
+        return;
+    }
+    // JSON envelope always goes to stdout for consistent machine-readable output
+    console.log(JSON.stringify({
+        success: false,
+        error: { code: code ?? 1, message },
+    }));
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * CLI Rendering Normalizer — safety net for human-readable output.
+ *
+ * Ensures data passed to human renderers has the expected shape,
+ * regardless of whether the engine layer has been fully fixed.
+ * Only called for human format — JSON output is untouched.
+ *
+ * Detection is idempotent: if data already has the expected key,
+ * it passes through unchanged.
+ *
+ * @task T4813
+ */
+/**
+ * Normalize data shape for human renderers.
+ *
+ * Each command expects data with specific named keys (e.g., `data.task`
+ * for 'show', `data.tasks` for 'list'). This function detects and
+ * corrects flat/array data from the engine layer.
+ */
+export declare function normalizeForHuman(command: string, data: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=normalizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../src/cli/renderers/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB"}

package/dist/cli/renderers/normalizer.js

@@ -0,0 +1,106 @@
+/**
+ * CLI Rendering Normalizer — safety net for human-readable output.
+ *
+ * Ensures data passed to human renderers has the expected shape,
+ * regardless of whether the engine layer has been fully fixed.
+ * Only called for human format — JSON output is untouched.
+ *
+ * Detection is idempotent: if data already has the expected key,
+ * it passes through unchanged.
+ *
+ * @task T4813
+ */
+/**
+ * Normalize data shape for human renderers.
+ *
+ * Each command expects data with specific named keys (e.g., `data.task`
+ * for 'show', `data.tasks` for 'list'). This function detects and
+ * corrects flat/array data from the engine layer.
+ */
+export function normalizeForHuman(command, data) {
+    switch (command) {
+        case 'show':
+            return normalizeTaskWrapper(data);
+        case 'list':
+        case 'ls':
+            return normalizeTaskList(data);
+        case 'find':
+        case 'search':
+            return normalizeFindResults(data);
+        case 'add':
+            return normalizeTaskWrapper(data);
+        case 'update':
+            return normalizeTaskWrapper(data);
+        case 'complete':
+        case 'done':
+            return normalizeTaskWrapper(data);
+        case 'delete':
+        case 'rm':
+            return normalizeDeleteResult(data);
+        case 'archive':
+            return normalizeArchiveResult(data);
+        default:
+            return data;
+    }
+}
+/**
+ * Wrap a flat task record as { task: ... } if not already wrapped.
+ * Detects flat tasks by the presence of 'id' without 'task'.
+ */
+function normalizeTaskWrapper(data) {
+    if (data['task'])
+        return data;
+    if (data['id'] && typeof data['id'] === 'string') {
+        return { task: data };
+    }
+    return data;
+}
+/**
+ * Wrap a raw array as { tasks: [...], total: N } if not already wrapped.
+ */
+function normalizeTaskList(data) {
+    if (data['tasks'])
+        return data;
+    if (Array.isArray(data)) {
+        return { tasks: data, total: data.length };
+    }
+    return data;
+}
+/**
+ * Wrap a raw array as { results: [...], total: N } if not already wrapped.
+ */
+function normalizeFindResults(data) {
+    if (data['results'])
+        return data;
+    if (Array.isArray(data)) {
+        return { results: data, total: data.length };
+    }
+    return data;
+}
+/**
+ * Normalize delete result: ensure deletedTask exists.
+ */
+function normalizeDeleteResult(data) {
+    if (data['deletedTask'])
+        return data;
+    if (data['taskId']) {
+        return { ...data, deletedTask: { id: data['taskId'] } };
+    }
+    return data;
+}
+/**
+ * Normalize archive result: ensure archivedCount exists.
+ */
+function normalizeArchiveResult(data) {
+    if (data['archivedCount'] !== undefined)
+        return data;
+    if (data['archived'] !== undefined && typeof data['archived'] === 'number') {
+        return {
+            ...data,
+            archivedCount: data['archived'],
+            archivedTasks: data['taskIds']?.map((id) => ({ id })),
+        };
+    }
+    return data;
+}
+//# sourceMappingURL=normalizer.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Human-readable renderers for system/utility CLI commands.
+ *
+ * Covers: doctor, stats, next, blockers, tree, start, stop, current, session, version.
+ *
+ * @task T4666
+ * @epic T4663
+ */
+export declare function renderDoctor(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderStats(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderNext(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderBlockers(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderTree(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderStart(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderStop(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderCurrent(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderSession(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderVersion(data: Record<string, unknown>, quiet: boolean): string;
+export declare function renderPlan(data: Record<string, unknown>, quiet: boolean): string;
+/**
+ * Generic human renderer for commands that don't have a specific renderer.
+ * Renders data as indented key-value pairs.
+ */
+export declare function renderGeneric(data: Record<string, unknown>, quiet: boolean): string;
+//# sourceMappingURL=system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/cli/renderers/system.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAiClF;AAMD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAsBjF;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAuChF;AAMD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CA6BpF;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBhF;AAuCD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CASjF;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAUhF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAcnF;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAsCnF;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAInF;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CA+FhF;AAgBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAiCnF"}