@cleocode/cleo 2026.4.12 → 2026.4.14

package/dist/cli/renderers/index.js

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

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

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

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

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

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

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

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