@cleocode/cleo 2026.4.9 → 2026.4.11

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;AA+EnE,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,CA2HrE;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,208 @@
+/**
+ * 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) {
+        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;
+    // 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.
+ * 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/lafs-validator.d.ts

@@ -0,0 +1,97 @@
+/**
+ * LAFS envelope validator middleware (Phase 6).
+ *
+ * Every CLI envelope emitted by `cliOutput()` flows through this module
+ * before hitting stdout. The middleware delegates to the canonical LAFS
+ * validators where they exist and adds a thin shape check for the agent-
+ * optimized **minimal envelope** format that the canonical schema does
+ * not cover.
+ *
+ * **SSoT alignment** (post-review):
+ *   - Full envelopes (`{$schema, _meta, success, result}`) are validated
+ *     by `validateEnvelope()` from `@cleocode/lafs`, which uses the
+ *     `lafs-napi` Rust binding (with AJV fallback) and the canonical
+ *     schema at `packages/lafs/schemas/v1/envelope.schema.json`.
+ *   - Minimal envelopes (`{ok, r, _m}`) are agent-optimized and not part
+ *     of the public LAFS schema. We validate their shape locally with
+ *     the lightweight invariant check below.
+ *
+ * Validation invariants enforced HERE (minimal envelopes only):
+ *   - Envelope MUST be a JSON object (parseable from a string)
+ *   - Envelope MUST have exactly one of {`ok`, `success`}
+ *   - The success indicator MUST be a boolean
+ *   - On success, `r` / `result` MUST exist (may be null)
+ *   - On failure, `error` MUST exist with at least `code` and `message`
+ *   - `_m` / `_meta` MUST be present in some form
+ *
+ * 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
+ * @see packages/lafs/src/validateEnvelope.ts — canonical full-envelope validator
+ * @see packages/lafs/schemas/v1/envelope.schema.json — canonical full-envelope schema
+ * @see crates/lafs-core — Rust embed of the canonical schema
+ */
+import { ExitCode } from '@cleocode/contracts';
+/**
+ * The minimum shape invariants for a LAFS envelope, compatible with both
+ * minimal (`{ok, r, _m}`) and full (`{success, result, _meta}`) formats.
+ */
+export interface LafsShapeViolation {
+    /** True iff the input is a well-formed JSON object. */
+    isObject: boolean;
+    /** True iff the envelope has exactly one success-indicator field. */
+    hasSuccessField: boolean;
+    /** True iff the success-indicator is a boolean. */
+    successIsBoolean: boolean;
+    /** True iff a metadata field (`_m` or `_meta`) is present. */
+    hasMeta: boolean;
+    /** True iff the result/error invariants hold for the indicated success value. */
+    resultOrErrorValid: boolean;
+    /** Human-readable reasons the envelope failed validation (empty = valid). */
+    reasons: string[];
+}
+/**
+ * Validate a LAFS envelope shape and report violations.
+ *
+ * Full envelopes are delegated to `@cleocode/lafs.validateEnvelope()` (which
+ * uses the canonical schema via lafs-napi/AJV). Minimal envelopes are
+ * checked against the lightweight invariants in this module.
+ *
+ * @param envelope - The candidate envelope (serialized string or 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,kBAAkB,EAAE,OAAO,CAAC;IAC5B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAoBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,kBAAkB,CAwHvE;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,CAmB/D"}

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

@@ -0,0 +1,229 @@
+/**
+ * LAFS envelope validator middleware (Phase 6).
+ *
+ * Every CLI envelope emitted by `cliOutput()` flows through this module
+ * before hitting stdout. The middleware delegates to the canonical LAFS
+ * validators where they exist and adds a thin shape check for the agent-
+ * optimized **minimal envelope** format that the canonical schema does
+ * not cover.
+ *
+ * **SSoT alignment** (post-review):
+ *   - Full envelopes (`{$schema, _meta, success, result}`) are validated
+ *     by `validateEnvelope()` from `@cleocode/lafs`, which uses the
+ *     `lafs-napi` Rust binding (with AJV fallback) and the canonical
+ *     schema at `packages/lafs/schemas/v1/envelope.schema.json`.
+ *   - Minimal envelopes (`{ok, r, _m}`) are agent-optimized and not part
+ *     of the public LAFS schema. We validate their shape locally with
+ *     the lightweight invariant check below.
+ *
+ * Validation invariants enforced HERE (minimal envelopes only):
+ *   - Envelope MUST be a JSON object (parseable from a string)
+ *   - Envelope MUST have exactly one of {`ok`, `success`}
+ *   - The success indicator MUST be a boolean
+ *   - On success, `r` / `result` MUST exist (may be null)
+ *   - On failure, `error` MUST exist with at least `code` and `message`
+ *   - `_m` / `_meta` MUST be present in some form
+ *
+ * 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
+ * @see packages/lafs/src/validateEnvelope.ts — canonical full-envelope validator
+ * @see packages/lafs/schemas/v1/envelope.schema.json — canonical full-envelope schema
+ * @see crates/lafs-core — Rust embed of the canonical schema
+ */
+import { ExitCode } from '@cleocode/contracts';
+const ENVELOPE_OK_KEY_MINIMAL = 'ok';
+const ENVELOPE_OK_KEY_FULL = 'success';
+const ENVELOPE_RESULT_KEY_MINIMAL = 'r';
+const ENVELOPE_RESULT_KEY_FULL = 'result';
+const ENVELOPE_META_KEYS = ['_m', '_meta'];
+/**
+ * Detect whether a parsed envelope is a "full" or "minimal" LAFS shape.
+ *
+ * Full shape uses {`success`, `result`, `_meta`}; minimal shape uses
+ * {`ok`, `r`, `_m`}. Returns 'unknown' when neither indicator is present.
+ */
+function detectEnvelopeFlavor(obj) {
+    if ('success' in obj || '_meta' in obj || '$schema' in obj)
+        return 'full';
+    if ('ok' in obj || '_m' in obj)
+        return 'minimal';
+    return 'unknown';
+}
+/**
+ * Validate a LAFS envelope shape and report violations.
+ *
+ * Full envelopes are delegated to `@cleocode/lafs.validateEnvelope()` (which
+ * uses the canonical schema via lafs-napi/AJV). Minimal envelopes are
+ * checked against the lightweight invariants in this module.
+ *
+ * @param envelope - The candidate envelope (serialized string or 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;
+    // SSoT delegation: full envelopes go through @cleocode/lafs.validateEnvelope
+    // which validates against the canonical packages/lafs/schemas/v1/envelope.schema.json
+    // (via the lafs-napi Rust binding when available, AJV fallback otherwise).
+    // We only inspect minimal envelopes locally because they're an internal
+    // agent-optimized format that the canonical schema does not cover.
+    const flavor = detectEnvelopeFlavor(obj);
+    if (flavor === 'full') {
+        try {
+            // Lazy require to avoid pulling lafs into the cli bundle's hot path.
+            // The package exports validateEnvelope() at the package root.
+            // biome-ignore lint/suspicious/noExplicitAny: dynamic import shape
+            const lafs = require('@cleocode/lafs');
+            const result = lafs.validateEnvelope(obj);
+            report.hasSuccessField = true;
+            report.successIsBoolean = true;
+            report.hasMeta = true;
+            report.resultOrErrorValid = result.valid;
+            if (!result.valid) {
+                for (const err of result.errors) {
+                    report.reasons.push(`canonical validator: ${err}`);
+                }
+            }
+            return report;
+        }
+        catch (loadErr) {
+            // Fall through to the local minimal-shape check if @cleocode/lafs
+            // can't be loaded for any reason — better than failing closed.
+            report.reasons.push(`Could not load canonical LAFS validator (${loadErr instanceof Error ? loadErr.message : String(loadErr)}); falling back to local shape check`);
+            // continue to the minimal-shape path below
+        }
+    }
+    // Success-indicator field presence
+    const hasMinimal = ENVELOPE_OK_KEY_MINIMAL in obj;
+    const hasFull = ENVELOPE_OK_KEY_FULL in obj;
+    if (!hasMinimal && !hasFull) {
+        report.reasons.push(`Envelope missing success indicator — expected one of: ${ENVELOPE_OK_KEY_MINIMAL}, ${ENVELOPE_OK_KEY_FULL}`);
+        return report;
+    }
+    report.hasSuccessField = true;
+    const successValue = hasMinimal ? obj[ENVELOPE_OK_KEY_MINIMAL] : obj[ENVELOPE_OK_KEY_FULL];
+    if (typeof successValue !== 'boolean') {
+        report.reasons.push(`Envelope success field must be boolean, got ${typeof successValue}`);
+        return report;
+    }
+    report.successIsBoolean = true;
+    // Metadata presence
+    report.hasMeta = ENVELOPE_META_KEYS.some((key) => key in obj);
+    if (!report.hasMeta) {
+        report.reasons.push(`Envelope missing metadata — expected one of: ${ENVELOPE_META_KEYS.join(', ')}`);
+    }
+    // Success / error invariants
+    if (successValue === true) {
+        const hasResult = ENVELOPE_RESULT_KEY_MINIMAL in obj || ENVELOPE_RESULT_KEY_FULL in obj;
+        if (!hasResult) {
+            report.reasons.push(`Successful envelope missing result field (${ENVELOPE_RESULT_KEY_MINIMAL} | ${ENVELOPE_RESULT_KEY_FULL})`);
+        }
+        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) {
+    const envelope = {
+        ok: false,
+        error: {
+            code: 'E_LAFS_VIOLATION',
+            message: err.message,
+            category: 'internal',
+            details: {
+                exitCode: ExitCode.LAFS_VIOLATION,
+                report: err.report,
+            },
+        },
+        _m: {
+            op: 'cli.lafs-validator',
+            rid: 'lafs-validator-emit',
+        },
+    };
+    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"}