@cleocode/cleo 2026.4.10 → 2026.4.12

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

@@ -0,0 +1,87 @@
+/**
+ * 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';
+import type { CliMeta } from '@cleocode/lafs';
+export interface CliOutputOptions {
+    /** Command name (used to pick the correct human renderer). */
+    command: string;
+    /** Optional success message for JSON envelope (attached to `meta.message`). */
+    message?: string;
+    /** Operation name for canonical envelope `meta.operation` (e.g. `"tasks.show"`). */
+    operation?: string;
+    /** Pagination metadata for canonical envelope `page` field. */
+    page?: FormatOptions['page'];
+    /** Extra metadata extensions merged into `meta`. */
+    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.
+ *
+ * Carries the full LAFS-compatible error context forwarded by the dispatch
+ * adapter from {@link DispatchError}. All fields are optional — only present
+ * fields are emitted in the output envelope.
+ *
+ * @see packages/cleo/src/dispatch/types.ts DispatchError
+ */
+export interface CliErrorDetails {
+    /** Machine-readable error code name (e.g. `E_NOT_FOUND`). */
+    name?: string;
+    /** Additional structured details from the error. */
+    details?: unknown;
+    /** Copy-paste fix hint for the operator or agent. */
+    fix?: unknown;
+    /** Alternative actions the caller can try. */
+    alternatives?: Array<{
+        action: string;
+        command: string;
+    }>;
+}
+/**
+ * Output an error in the resolved format.
+ *
+ * In JSON format (default / agent mode): emits a canonical `CliEnvelope` error
+ * envelope to stdout. The envelope always includes `meta` (ADR-039).
+ * All optional fields (`codeName`, `fix`, `alternatives`, `details`) are
+ * included only when they are actually present — no `undefined` keys are emitted.
+ *
+ * In human format: prints a plain error line to stderr and, when
+ * `details.fix` is a string, appends a `Fix: <hint>` line.
+ *
+ * @param message - Human-readable error message.
+ * @param code    - Numeric exit code or string error code.
+ * @param details - Optional structured details (codeName, fix, alternatives, …).
+ * @param meta    - Optional partial meta to merge into the error envelope.
+ *
+ * @task T4666
+ * @task T4813
+ * @task T336
+ * @task T338
+ */
+export declare function cliError(message: string, code?: number | string, details?: CliErrorDetails, meta?: Partial<CliMeta>): 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":"AAYA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAe,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA8E3D,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,oDAAoD;IACpD,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,CAsIrE;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,8CAA8C;IAC9C,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EACtB,OAAO,CAAC,EAAE,eAAe,EACzB,IAAI,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GACtB,IAAI,CA0CN"}

package/dist/cli/renderers/index.js

@@ -0,0 +1,262 @@
+import { randomUUID } from 'node:crypto';
+/**
+ * Generate a request UUID for error envelopes.
+ * Extracted to keep the hot path synchronous.
+ *
+ * @internal
+ */
+function generateRequestId() {
+    return randomUUID();
+}
+/**
+ * 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';
+import { getFieldContext } from '../field-context.js';
+import { getFormatContext } from '../format-context.js';
+import { emitLafsViolation, LafsViolationError, validateLafsShape } from './lafs-validator.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) {
+        // extractFieldFromResult operates on the data payload (not the envelope).
+        // Cast to the proto-envelope result type for the SDK call.
+        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 canonical CLI 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 {
+            // Build a proto-envelope stub to drive the SDK field filter (ADR-039 bridge).
+            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.
+        }
+    }
+    // Build FormatOptions for formatSuccess (now emits canonical CliEnvelope shape).
+    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;
+    // Phase 6 — LAFS envelope validation middleware.
+    // Every CLI output flows through `formatSuccess()` → string. We parse the
+    // string, assert the shape invariants, and only emit if validation passes.
+    // A shape violation is a CLEO developer bug, so we:
+    //   1. Emit a valid LAFS error envelope to stderr describing the violation
+    //   2. Set process.exitCode to ExitCode.LAFS_VIOLATION (104)
+    //   3. Still emit the (invalid) original to stdout so operators can inspect
+    // This is a safety net — it never SILENTLY swallows output.
+    const envelopeString = formatSuccess(filteredData, opts.message, Object.keys(formatOpts).length > 0 ? formatOpts : opts.operation);
+    if (process.env['CLEO_LAFS_VALIDATE'] !== 'off') {
+        try {
+            const report = validateLafsShape(envelopeString);
+            if (report.reasons.length > 0) {
+                emitLafsViolation(new LafsViolationError(`cliOutput: envelope failed LAFS shape validation`, report));
+            }
+        }
+        catch (err) {
+            if (err instanceof LafsViolationError) {
+                emitLafsViolation(err);
+            }
+            // Non-validator errors — re-raise so tests can see them
+        }
+    }
+    console.log(envelopeString);
+}
+/**
+ * Output an error in the resolved format.
+ *
+ * In JSON format (default / agent mode): emits a canonical `CliEnvelope` error
+ * envelope to stdout. The envelope always includes `meta` (ADR-039).
+ * All optional fields (`codeName`, `fix`, `alternatives`, `details`) are
+ * included only when they are actually present — no `undefined` keys are emitted.
+ *
+ * In human format: prints a plain error line to stderr and, when
+ * `details.fix` is a string, appends a `Fix: <hint>` line.
+ *
+ * @param message - Human-readable error message.
+ * @param code    - Numeric exit code or string error code.
+ * @param details - Optional structured details (codeName, fix, alternatives, …).
+ * @param meta    - Optional partial meta to merge into the error envelope.
+ *
+ * @task T4666
+ * @task T4813
+ * @task T336
+ * @task T338
+ */
+export function cliError(message, code, details, meta) {
+    const ctx = getFormatContext();
+    if (ctx.format === 'human') {
+        console.error(`Error: ${message}${code ? ` (${code})` : ''}`);
+        if (typeof details?.fix === 'string') {
+            console.error(`Fix: ${details.fix}`);
+        }
+        return;
+    }
+    // JSON envelope always goes to stdout for consistent machine-readable output.
+    // Build the error object incrementally so that absent optional fields are
+    // never serialised as `undefined` (which JSON.stringify would strip anyway,
+    // but being explicit keeps the intent clear and avoids lint warnings).
+    const errorObj = {
+        code: code ?? 1,
+        message,
+    };
+    if (details?.name !== undefined)
+        errorObj['codeName'] = details.name;
+    if (details?.fix !== undefined)
+        errorObj['fix'] = details.fix;
+    if (details?.alternatives !== undefined)
+        errorObj['alternatives'] = details.alternatives;
+    if (details?.details !== undefined)
+        errorObj['details'] = details.details;
+    // Canonical error envelope: {success, error, meta} — meta is ALWAYS present.
+    // Merge caller-supplied meta with defaults (ADR-039).
+    const errorMeta = {
+        operation: meta?.operation ?? 'cli.error',
+        requestId: meta?.requestId ?? generateRequestId(),
+        duration_ms: meta?.duration_ms ?? 0,
+        timestamp: meta?.timestamp ?? new Date().toISOString(),
+        ...meta,
+    };
+    const envelope = {
+        success: false,
+        error: errorObj,
+        meta: errorMeta,
+    };
+    console.log(JSON.stringify(envelope));
+}
+//# 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/lafs-validator.d.ts

@@ -0,0 +1,91 @@
+/**
+ * CLI envelope validator middleware (Phase 6 / ADR-039 update).
+ *
+ * Every CLI envelope emitted by `cliOutput()` flows through this module
+ * before hitting stdout. Validates the **canonical CLI envelope** shape
+ * (`{success, data?, error?, meta, page?}`) as defined in ADR-039.
+ *
+ * The canonical shape replaces the three legacy shapes:
+ *   - `{ok, r, _m}` (minimal MVI — removed)
+ *   - `{$schema, _meta, success, result}` (full LAFS — migrated)
+ *   - `{success, result}` (observe command — migrated)
+ *
+ * Validation invariants:
+ *   - Envelope MUST be a JSON object
+ *   - `success` MUST be present and boolean
+ *   - On success, `data` MUST exist (may be null)
+ *   - On failure, `error` MUST exist with at least `code` and `message`
+ *   - `meta` MUST be present (always — success and failure)
+ *
+ * When a violation is detected, the validator:
+ *   1. Wraps the malformed output in a valid error envelope
+ *   2. Sets the process exit code to `ExitCode.LAFS_VIOLATION` (104)
+ *   3. Emits the wrapped envelope to stderr for diagnostic tooling
+ *
+ * @task Phase 6 — LAFS formalization + schema consolidation
+ * @task T338 — ADR-039 canonical envelope unification
+ */
+import { ExitCode } from '@cleocode/contracts';
+/**
+ * Shape violation report for a canonical CLI envelope.
+ *
+ * Carries the individual invariant results so diagnostic tooling can
+ * report exactly which invariants were violated.
+ */
+export interface LafsShapeViolation {
+    /** True iff the input is a well-formed JSON object. */
+    isObject: boolean;
+    /** True iff `success` is present. */
+    hasSuccessField: boolean;
+    /** True iff `success` is a boolean. */
+    successIsBoolean: boolean;
+    /** True iff `meta` is present (always required — ADR-039). */
+    hasMeta: boolean;
+    /** True iff the data/error invariants hold for the indicated success value. */
+    resultOrErrorValid: boolean;
+    /** Human-readable reasons the envelope failed validation (empty = valid). */
+    reasons: string[];
+}
+/**
+ * Validate a canonical CLI envelope shape and report violations.
+ *
+ * Validates the unified `{success, data?, error?, meta, page?}` shape
+ * defined in ADR-039. All three legacy shapes (`{ok,r,_m}`,
+ * `{$schema,_meta,success,result}`, `{success,result}`) are now invalid
+ * and will produce violation reports.
+ *
+ * @param envelope - The candidate envelope (serialized string or parsed object).
+ * @returns A `LafsShapeViolation` report. `.reasons.length === 0` when valid.
+ */
+export declare function validateLafsShape(envelope: unknown): LafsShapeViolation;
+/**
+ * Assert that a LAFS envelope conforms to the shape contract, throwing
+ * an error with a LAFS-shaped diagnostic if it does not.
+ *
+ * Used by the renderer middleware to fail LOUDLY when CLEO itself emits
+ * a malformed envelope — this is a developer bug, not an operator issue.
+ *
+ * @param envelope - The candidate envelope
+ * @throws `LafsViolationError` if the envelope fails any shape invariant
+ */
+export declare function assertLafsShape(envelope: unknown): void;
+/**
+ * Error thrown by `assertLafsShape` when an envelope fails validation.
+ *
+ * Carries the full `LafsShapeViolation` report so diagnostic tooling can
+ * report which specific invariants were violated.
+ */
+export declare class LafsViolationError extends Error {
+    readonly code = ExitCode.LAFS_VIOLATION;
+    readonly report: LafsShapeViolation;
+    constructor(message: string, report: LafsShapeViolation);
+}
+/**
+ * Emit a LAFS-shaped error envelope describing a validation failure and
+ * set `process.exitCode` to `ExitCode.LAFS_VIOLATION`.
+ *
+ * Called by the renderer middleware as a recovery path when a previously-
+ * emitted envelope turns out to be malformed.
+ */
+export declare function emitLafsViolation(err: LafsViolationError): void;
+//# sourceMappingURL=lafs-validator.d.ts.map

package/dist/cli/renderers/lafs-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lafs-validator.d.ts","sourceRoot":"","sources":["../../../src/cli/renderers/lafs-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,+EAA+E;IAC/E,kBAAkB,EAAE,OAAO,CAAC;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,kBAAkB,CAqFvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAQvD;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB;CAKxD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAqB/D"}

package/dist/cli/renderers/lafs-validator.js

@@ -0,0 +1,176 @@
+/**
+ * CLI envelope validator middleware (Phase 6 / ADR-039 update).
+ *
+ * Every CLI envelope emitted by `cliOutput()` flows through this module
+ * before hitting stdout. Validates the **canonical CLI envelope** shape
+ * (`{success, data?, error?, meta, page?}`) as defined in ADR-039.
+ *
+ * The canonical shape replaces the three legacy shapes:
+ *   - `{ok, r, _m}` (minimal MVI — removed)
+ *   - `{$schema, _meta, success, result}` (full LAFS — migrated)
+ *   - `{success, result}` (observe command — migrated)
+ *
+ * Validation invariants:
+ *   - Envelope MUST be a JSON object
+ *   - `success` MUST be present and boolean
+ *   - On success, `data` MUST exist (may be null)
+ *   - On failure, `error` MUST exist with at least `code` and `message`
+ *   - `meta` MUST be present (always — success and failure)
+ *
+ * When a violation is detected, the validator:
+ *   1. Wraps the malformed output in a valid error envelope
+ *   2. Sets the process exit code to `ExitCode.LAFS_VIOLATION` (104)
+ *   3. Emits the wrapped envelope to stderr for diagnostic tooling
+ *
+ * @task Phase 6 — LAFS formalization + schema consolidation
+ * @task T338 — ADR-039 canonical envelope unification
+ */
+import { ExitCode } from '@cleocode/contracts';
+const ENVELOPE_SUCCESS_KEY = 'success';
+const ENVELOPE_DATA_KEY = 'data';
+const ENVELOPE_META_KEY = 'meta';
+/**
+ * Validate a canonical CLI envelope shape and report violations.
+ *
+ * Validates the unified `{success, data?, error?, meta, page?}` shape
+ * defined in ADR-039. All three legacy shapes (`{ok,r,_m}`,
+ * `{$schema,_meta,success,result}`, `{success,result}`) are now invalid
+ * and will produce violation reports.
+ *
+ * @param envelope - The candidate envelope (serialized string or parsed object).
+ * @returns A `LafsShapeViolation` report. `.reasons.length === 0` when valid.
+ */
+export function validateLafsShape(envelope) {
+    const report = {
+        isObject: false,
+        hasSuccessField: false,
+        successIsBoolean: false,
+        hasMeta: false,
+        resultOrErrorValid: false,
+        reasons: [],
+    };
+    // Allow callers to pass either a serialized envelope or a parsed one
+    let parsed = envelope;
+    if (typeof envelope === 'string') {
+        try {
+            parsed = JSON.parse(envelope);
+        }
+        catch {
+            report.reasons.push('Envelope is not valid JSON');
+            return report;
+        }
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        report.reasons.push('Envelope is not a JSON object');
+        return report;
+    }
+    report.isObject = true;
+    const obj = parsed;
+    // Success-indicator field presence (`success`, not legacy `ok`)
+    if (!(ENVELOPE_SUCCESS_KEY in obj)) {
+        report.reasons.push(`Envelope missing success indicator — expected: "${ENVELOPE_SUCCESS_KEY}"`);
+        return report;
+    }
+    report.hasSuccessField = true;
+    const successValue = obj[ENVELOPE_SUCCESS_KEY];
+    if (typeof successValue !== 'boolean') {
+        report.reasons.push(`Envelope "${ENVELOPE_SUCCESS_KEY}" field must be boolean, got ${typeof successValue}`);
+        return report;
+    }
+    report.successIsBoolean = true;
+    // `meta` MUST be present and an object on every envelope (ADR-039)
+    report.hasMeta = ENVELOPE_META_KEY in obj && typeof obj[ENVELOPE_META_KEY] === 'object';
+    if (!report.hasMeta) {
+        report.reasons.push(`Envelope missing required "${ENVELOPE_META_KEY}" object (ADR-039 — every envelope must carry meta)`);
+    }
+    // Success / error invariants
+    if (successValue === true) {
+        // Successful envelopes carry `data` (not legacy `result` or `r`)
+        const hasData = ENVELOPE_DATA_KEY in obj;
+        if (!hasData) {
+            report.reasons.push(`Successful envelope missing "${ENVELOPE_DATA_KEY}" field (legacy "result" / "r" are no longer valid — ADR-039)`);
+        }
+        else {
+            report.resultOrErrorValid = true;
+        }
+    }
+    else {
+        const errorField = obj['error'];
+        if (typeof errorField !== 'object' || errorField === null) {
+            report.reasons.push('Failed envelope missing "error" object');
+        }
+        else {
+            const err = errorField;
+            const hasCode = 'code' in err;
+            const hasMessage = 'message' in err && typeof err['message'] === 'string';
+            if (!hasCode || !hasMessage) {
+                report.reasons.push('Failed envelope "error" object must contain "code" and "message" (string)');
+            }
+            else {
+                report.resultOrErrorValid = true;
+            }
+        }
+    }
+    return report;
+}
+/**
+ * Assert that a LAFS envelope conforms to the shape contract, throwing
+ * an error with a LAFS-shaped diagnostic if it does not.
+ *
+ * Used by the renderer middleware to fail LOUDLY when CLEO itself emits
+ * a malformed envelope — this is a developer bug, not an operator issue.
+ *
+ * @param envelope - The candidate envelope
+ * @throws `LafsViolationError` if the envelope fails any shape invariant
+ */
+export function assertLafsShape(envelope) {
+    const report = validateLafsShape(envelope);
+    if (report.reasons.length > 0) {
+        throw new LafsViolationError(`LAFS envelope shape violation: ${report.reasons.join('; ')}`, report);
+    }
+}
+/**
+ * Error thrown by `assertLafsShape` when an envelope fails validation.
+ *
+ * Carries the full `LafsShapeViolation` report so diagnostic tooling can
+ * report which specific invariants were violated.
+ */
+export class LafsViolationError extends Error {
+    code = ExitCode.LAFS_VIOLATION;
+    report;
+    constructor(message, report) {
+        super(message);
+        this.name = 'LafsViolationError';
+        this.report = report;
+    }
+}
+/**
+ * Emit a LAFS-shaped error envelope describing a validation failure and
+ * set `process.exitCode` to `ExitCode.LAFS_VIOLATION`.
+ *
+ * Called by the renderer middleware as a recovery path when a previously-
+ * emitted envelope turns out to be malformed.
+ */
+export function emitLafsViolation(err) {
+    // Emit canonical CLI envelope shape (ADR-039) even for violation errors
+    const envelope = {
+        success: false,
+        error: {
+            code: ExitCode.LAFS_VIOLATION,
+            codeName: 'E_LAFS_VIOLATION',
+            message: err.message,
+            details: {
+                report: err.report,
+            },
+        },
+        meta: {
+            operation: 'cli.lafs-validator',
+            requestId: 'lafs-validator-emit',
+            duration_ms: 0,
+            timestamp: new Date().toISOString(),
+        },
+    };
+    process.stderr.write(`${JSON.stringify(envelope)}\n`);
+    process.exitCode = ExitCode.LAFS_VIOLATION;
+}
+//# sourceMappingURL=lafs-validator.js.map

package/dist/cli/renderers/lafs-validator.js.map

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