@cleocode/cleo 2026.4.161 → 2026.5.1

package/dist/cli/renderers/normalizer.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.js","sourceRoot":"","sources":["../../../src/cli/renderers/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,IAA6B;IAE7B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEpC,KAAK,MAAM,CAAC;QACZ,KAAK,IAAI;YACP,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAEjC,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEpC,KAAK,KAAK;YACR,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEpC,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEpC,KAAK,UAAU,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAEpC,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAErC,KAAK,SAAS;YACZ,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAEtC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAA6B;IACzD,IAAI,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACjD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAA6B;IACtD,IAAI,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAA6B;IACzD,IAAI,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,IAA6B;IAC1D,IAAI,IAAI,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,IAA6B;IAC3D,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC3E,OAAO;YACL,GAAG,IAAI;YACP,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC;YAC/B,aAAa,EAAG,IAAI,CAAC,SAAS,CAA0B,EAAE,GAAG,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;SACxF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

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

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