@cleocode/cleo 2026.5.4 → 2026.5.5

package/dist/cli/renderers/normalizer.js

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

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

@@ -1,110 +0,0 @@
-/**
- * Human-readable renderers for system/utility CLI commands.
- *
- * Covers: doctor, stats, next, blockers, tree, start, stop, current, session, version.
- *
- * Tree and wave rendering is delegated to the pure core formatters
- * (`@cleocode/core/formatters`) via a CLI-specific `colorize` adapter that
- * injects ANSI escape codes.  This keeps all presentation logic in core and
- * the CLI renderers as thin adapters.
- *
- * @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;
-/**
- * Output mode for {@link renderWaves}.
- *
- * - `'rich'`     — Full terminal output with ANSI colors, wave headers,
- *                  status badges, priority colors, and blocker indicators.
- * - `'json'`     — Passthrough: returns `JSON.stringify({ waves })` so the
- *                  caller receives machine-readable data.
- * - `'markdown'` — GitHub-flavored Markdown: `## Wave N — status\n- [status] ID Title`
- * - `'quiet'`    — One `<waveNumber>\t<taskId>` line per task (script-extractable).
- */
-export type RenderWavesMode = 'rich' | 'json' | 'markdown' | 'quiet';
-/**
- * Options for {@link renderWaves}.
- */
-export interface RenderWavesOptions {
-    /**
-     * Output mode.
-     *
-     * @defaultValue `'rich'`
-     */
-    mode?: RenderWavesMode;
-    /** Epic ID displayed in the rich-mode header (e.g. `"T100"`). */
-    epicId?: string;
-    /** Total number of waves, used in the rich-mode header. */
-    totalWaves?: number;
-    /** Total number of tasks, used in the rich-mode header. */
-    totalTasks?: number;
-}
-/**
- * Render wave data from `orchestrate.waves` / `deps waves` output.
- *
- * Supports four output modes controlled by `opts.mode`:
- *
- * - **rich** (default): Terminal-friendly output with wave headers, ANSI
- *   status badges, priority-colored titles, and blocker indicators.
- * - **json**: Returns `JSON.stringify({ waves })` — a raw passthrough for
- *   machine-readable consumers that have already obtained the data payload.
- * - **markdown**: GitHub-flavored Markdown suitable for issue comments or
- *   documentation. Format: `## Wave N — status\n- [status] TID Title\n`.
- * - **quiet**: One `<waveNumber>\t<taskId>` line per task across all waves,
- *   with no decoration — safe for `awk` / `cut` / shell pipelines.
- *
- * The function is the canonical wave renderer. {@link renderTree} delegates
- * to it when `data.waves` is present.
- *
- * @param data - Normalized response payload containing `data.waves`.
- * @param opts - Rendering options.
- */
-export declare function renderWaves(data: Record<string, unknown>, opts?: RenderWavesOptions): string;
-/**
- * Render the task dependency tree or wave plan.
- *
- * Handles three data shapes returned by the `deps`/`tree` dispatcher:
- * - `data.waves`  — enriched wave array from `orchestrate.waves`
- * - `data.tree`   — recursive `FlatTreeNode[]` from `tasks.tree`
- * - `data.tasks`  — flat `Task[]` fallback
- *
- * When `data.waves` is present, delegates to {@link renderWaves}.
- *
- * @param data  - Normalised response payload.
- * @param quiet - When true, emit only IDs with no decoration.
- */
-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;
-/**
- * Render a {@link SessionBriefing} payload as readable text.
- *
- * Source of truth is TASKS + BRAIN (`tasks.db` + `brain.db`); this renderer
- * is a pure formatter that NEVER touches the filesystem. Sections render
- * only when their backing data is non-empty so a quiet briefing stays quiet.
- *
- * Sections (in order):
- * 1. Last session — handoff note, completed/created tasks, decisions
- * 2. Current task
- * 3. Active blockers
- * 4. Next suggested
- * 5. Open epics
- * 6. Recent decisions / observations from BRAIN
- *
- * @task T1593
- */
-export declare function renderBriefing(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

@@ -1 +0,0 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/cli/renderers/system.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqEH,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;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAQ5F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CA8ChF;AAWD,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;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAuJpF;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAiCnF"}