@cleocode/cleo 2026.4.161 → 2026.5.0

package/dist/cli/renderers/system.js

@@ -0,0 +1,662 @@
+/**
+ * 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
+ */
+import { formatTree, formatWaves } from '@cleocode/core/formatters';
+import { getTreeContext } from '../tree-context.js';
+import { BLUE, BOLD, CYAN, DIM, GREEN, MAGENTA, NC, priorityColor, RED, statusColor, statusSymbol, YELLOW, } from './colors.js';
+// ---------------------------------------------------------------------------
+// CLI colorize adapter — maps core ColorStyle tokens to ANSI escape codes
+// ---------------------------------------------------------------------------
+/**
+ * Wrap `text` with the ANSI escape code for `style`, followed by a reset.
+ *
+ * This adapter is passed as the `colorize` option to {@link formatTree} and
+ * {@link formatWaves} so that all ANSI concerns stay in the CLI package while
+ * the core formatters remain presentation-agnostic.
+ *
+ * When ANSI is disabled (e.g. `NO_COLOR` is set, or stdout is not a TTY),
+ * the ANSI constants exported by `colors.ts` are empty strings, so this
+ * function effectively returns `text` unchanged — output is identical to
+ * the plain-text modes used by core tests.
+ *
+ * @param text  - The text to colorize.
+ * @param style - A {@link ColorStyle} token produced by the core formatter.
+ */
+function cliColorize(text, style) {
+    switch (style) {
+        case 'bold':
+            return `${BOLD}${text}${NC}`;
+        case 'dim':
+            return `${DIM}${text}${NC}`;
+        case 'red':
+            return `${RED}${text}${NC}`;
+        case 'green':
+            return `${GREEN}${text}${NC}`;
+        case 'yellow':
+            return `${YELLOW}${text}${NC}`;
+        case 'blue':
+            return `${BLUE}${text}${NC}`;
+        case 'magenta':
+            return `${MAGENTA}${text}${NC}`;
+        case 'cyan':
+            return `${CYAN}${text}${NC}`;
+        case 'reset':
+            return `${NC}${text}`;
+        default:
+            return text;
+    }
+}
+// ---------------------------------------------------------------------------
+// doctor: diagnostic checks
+// ---------------------------------------------------------------------------
+export function renderDoctor(data, quiet) {
+    const healthy = data['healthy'];
+    const errors = data['errors'];
+    const warnings = data['warnings'];
+    const checks = data['checks'];
+    if (quiet) {
+        return healthy ? 'healthy' : 'unhealthy';
+    }
+    const lines = [];
+    const statusText = healthy ? `${GREEN}${BOLD}HEALTHY${NC}` : `${RED}${BOLD}UNHEALTHY${NC}`;
+    lines.push(`System Status: ${statusText}`);
+    if ((errors ?? 0) > 0)
+        lines.push(`  ${RED}Errors: ${errors}${NC}`);
+    if ((warnings ?? 0) > 0)
+        lines.push(`  ${YELLOW}Warnings: ${warnings}${NC}`);
+    lines.push('');
+    if (checks) {
+        for (const check of checks) {
+            const status = check['status'];
+            const message = check['message'];
+            const icon = status === 'ok'
+                ? `${GREEN}\u2713${NC}`
+                : status === 'warning'
+                    ? `${YELLOW}\u26A0${NC}`
+                    : `${RED}\u2717${NC}`;
+            lines.push(`  ${icon} ${message}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// stats: project statistics
+// ---------------------------------------------------------------------------
+export function renderStats(data, quiet) {
+    if (quiet) {
+        const total = data['totalTasks'];
+        return String(total ?? 0);
+    }
+    const lines = [];
+    lines.push(`${BOLD}Project Statistics${NC}`);
+    lines.push('');
+    for (const [key, val] of Object.entries(data)) {
+        if (typeof val === 'object' && val !== null && !Array.isArray(val)) {
+            lines.push(`  ${BOLD}${formatLabel(key)}:${NC}`);
+            for (const [subKey, subVal] of Object.entries(val)) {
+                lines.push(`    ${DIM}${formatLabel(subKey)}:${NC} ${String(subVal)}`);
+            }
+        }
+        else {
+            lines.push(`  ${DIM}${formatLabel(key)}:${NC} ${String(val)}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// next: task suggestion
+// ---------------------------------------------------------------------------
+export function renderNext(data, quiet) {
+    const suggestion = data['suggestion'];
+    const suggestions = data['suggestions'];
+    const totalCandidates = data['totalCandidates'];
+    // Single suggestion
+    if (suggestion !== undefined) {
+        if (suggestion === null) {
+            return quiet ? '' : 'No pending tasks with satisfied dependencies.';
+        }
+        if (quiet)
+            return String(suggestion['id']);
+        const pCol = priorityColor(String(suggestion['priority'] ?? ''));
+        const lines = [
+            `${BOLD}Next:${NC} ${BOLD}${suggestion['id']}${NC} ${pCol}[${suggestion['priority']}]${NC} ${suggestion['title']}`,
+        ];
+        if (suggestion['phase'])
+            lines.push(`  ${DIM}Phase:${NC} ${suggestion['phase']}`);
+        if (suggestion['reasons']) {
+            const reasons = suggestion['reasons'];
+            for (const r of reasons)
+                lines.push(`  ${DIM}${r}${NC}`);
+        }
+        if (totalCandidates)
+            lines.push(`  ${DIM}(${totalCandidates} candidates)${NC}`);
+        return lines.join('\n');
+    }
+    // Multiple suggestions
+    if (suggestions) {
+        if (quiet)
+            return suggestions.map((s) => String(s['id'])).join('\n');
+        const lines = [];
+        lines.push(`${BOLD}Top suggestions:${NC}  ${DIM}(${totalCandidates} candidates)${NC}`);
+        for (const s of suggestions) {
+            const pCol = priorityColor(String(s['priority'] ?? ''));
+            lines.push(`  ${BOLD}${s['id']}${NC} ${pCol}[${s['priority']}]${NC} ${s['title']}  ${DIM}score: ${s['score']}${NC}`);
+        }
+        return lines.join('\n');
+    }
+    return 'No suggestions available.';
+}
+// ---------------------------------------------------------------------------
+// blockers: blocked tasks
+// ---------------------------------------------------------------------------
+export function renderBlockers(data, quiet) {
+    const blockers = data['blockers'];
+    const tasks = data['tasks'];
+    const items = blockers ?? tasks;
+    if (!items || items.length === 0) {
+        return quiet ? '' : 'No blocked tasks.';
+    }
+    if (quiet) {
+        return items
+            .map((b) => String(b['id'] ?? b.id))
+            .join('\n');
+    }
+    const lines = [];
+    lines.push(`${RED}${BOLD}Blocked Tasks (${items.length})${NC}`);
+    lines.push('');
+    for (const item of items) {
+        const t = item;
+        const id = t.id ?? String(t['id']);
+        const title = t.title ?? String(t['title']);
+        const blockedBy = t.blockedBy ?? String(t['blockedBy'] ?? '');
+        lines.push(`  ${RED}\u2297${NC} ${BOLD}${id}${NC} ${title}`);
+        if (blockedBy)
+            lines.push(`    ${DIM}Blocked by: ${blockedBy}${NC}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * 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 function renderWaves(data, opts) {
+    // Delegate to the core formatter, injecting the CLI ANSI colorize adapter.
+    // The data shape is compatible: waves.ts accepts { waves?: EnrichedWave[] }
+    // and data has the same structure (waves key).
+    return formatWaves(data, {
+        mode: opts?.mode ?? 'rich',
+        colorize: cliColorize,
+    });
+}
+/**
+ * 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 function renderTree(data, quiet) {
+    const waves = data['waves'];
+    const tree = data['tree'];
+    const tasks = data['tasks'];
+    if (waves) {
+        const epicId = data['epicId'];
+        const totalWaves = data['totalWaves'];
+        const totalTasks = data['totalTasks'];
+        if (quiet) {
+            return renderWaves(data, { mode: 'quiet' });
+        }
+        const header = epicId
+            ? `${BOLD}Waves for ${epicId}${NC}  ${DIM}(${totalWaves ?? waves.length} waves, ${totalTasks ?? '?'} tasks)${NC}`
+            : `${BOLD}Execution Waves${NC}`;
+        const body = renderWaves(data, { mode: 'rich', epicId, totalWaves, totalTasks });
+        return `${header}\n\n${body}`;
+    }
+    if (tree) {
+        // Delegate to core formatTree, injecting the CLI ANSI colorize adapter.
+        // withDeps and withBlockers are read from the tree context set by treeCommand
+        // (T1205 / T1206).
+        const { withDeps, withBlockers } = getTreeContext();
+        return formatTree(tree, {
+            mode: quiet ? 'quiet' : 'rich',
+            colorize: cliColorize,
+            withDeps,
+            withBlockers,
+        });
+    }
+    // Fallback: flat task list rendered as indented tree
+    if (tasks) {
+        if (quiet)
+            return tasks.map((t) => t.id).join('\n');
+        return tasks
+            .map((t) => {
+            const sSym = statusSymbol(t.status);
+            return `  ${sSym} ${BOLD}${t.id}${NC} ${t.title}`;
+        })
+            .join('\n');
+    }
+    return quiet ? '' : 'No tree data.';
+}
+// ---------------------------------------------------------------------------
+// Note: blockerIndicator and renderTreeNodes were removed in T1204.
+// This logic now lives in @cleocode/core/formatters (tree.ts) and is
+// invoked via formatTree() with the cliColorize adapter above.
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// start / stop / current: task work commands
+// ---------------------------------------------------------------------------
+export function renderStart(data, quiet) {
+    const task = data['task'];
+    const taskId = data['taskId'];
+    const id = task?.id ?? taskId ?? String(data['currentTask'] ?? '');
+    const title = task?.title ?? String(data['title'] ?? '');
+    if (quiet)
+        return id;
+    return `${GREEN}\u25B6 Started:${NC} ${BOLD}${id}${NC} ${title}`;
+}
+export function renderStop(data, quiet) {
+    const task = data['task'];
+    const taskId = data['taskId'];
+    const previousTask = data['previousTask'];
+    const id = task?.id ?? taskId ?? previousTask ?? '';
+    if (quiet)
+        return id;
+    if (!id)
+        return 'No task was active.';
+    return `${YELLOW}\u25A0 Stopped:${NC} ${BOLD}${id}${NC}${task?.title ? ` ${task.title}` : ''}`;
+}
+export function renderCurrent(data, quiet) {
+    const task = data['task'];
+    const currentTask = data['currentTask'];
+    const id = task?.id ?? currentTask ?? '';
+    if (!id) {
+        return quiet ? '' : 'No task currently active.';
+    }
+    if (quiet)
+        return id;
+    const sCol = statusColor(task?.status ?? 'active');
+    const sSym = statusSymbol(task?.status ?? 'active');
+    return `${BOLD}Current:${NC} ${sCol}${sSym}${NC} ${BOLD}${id}${NC}${task?.title ? ` ${task.title}` : ''}`;
+}
+// ---------------------------------------------------------------------------
+// session: session info
+// ---------------------------------------------------------------------------
+export function renderSession(data, quiet) {
+    const sessionId = data['sessionId'];
+    const status = data['status'];
+    const sessions = data['sessions'];
+    // Session list
+    if (sessions) {
+        if (quiet)
+            return sessions.map((s) => String(s['id'])).join('\n');
+        const lines = [];
+        lines.push(`${BOLD}Sessions (${sessions.length})${NC}`);
+        for (const s of sessions) {
+            const active = s['active'];
+            const icon = active ? `${GREEN}\u25CF${NC}` : `${DIM}\u25CB${NC}`;
+            lines.push(`  ${icon} ${BOLD}${s['id']}${NC}${active ? ' (active)' : ''}`);
+        }
+        return lines.join('\n');
+    }
+    // Single session
+    if (!sessionId) {
+        return quiet ? '' : 'No active session.';
+    }
+    if (quiet)
+        return sessionId;
+    const lines = [];
+    lines.push(`${BOLD}Session:${NC} ${sessionId}`);
+    if (status)
+        lines.push(`  ${DIM}Status:${NC} ${status}`);
+    // Render any other fields
+    for (const [key, val] of Object.entries(data)) {
+        if (key === 'sessionId' || key === 'status')
+            continue;
+        if (typeof val === 'string' || typeof val === 'number' || typeof val === 'boolean') {
+            lines.push(`  ${DIM}${formatLabel(key)}:${NC} ${String(val)}`);
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// version
+// ---------------------------------------------------------------------------
+export function renderVersion(data, quiet) {
+    const version = data['version'];
+    if (quiet)
+        return version ?? '';
+    return `Cleo v${version}`;
+}
+// ---------------------------------------------------------------------------
+// plan: composite planning view
+// ---------------------------------------------------------------------------
+export function renderPlan(data, quiet) {
+    if (quiet) {
+        const readyCount = data['ready']?.length ?? 0;
+        return String(readyCount);
+    }
+    const lines = [];
+    lines.push(`${BOLD}Planning View${NC}`);
+    lines.push('');
+    // In-Progress Epics
+    const inProgress = data['inProgress'];
+    if (inProgress && inProgress.length > 0) {
+        lines.push(`${BOLD}In-Progress Epics (${inProgress.length})${NC}`);
+        for (const epic of inProgress) {
+            const completion = epic['completionPercent'];
+            const completionBar = renderCompletionBar(completion);
+            lines.push(`  ${BOLD}${epic['epicId']}${NC} ${epic['epicTitle']}`);
+            lines.push(`    ${completionBar} ${completion}% (${epic['activeTasks']} active)`);
+        }
+        lines.push('');
+    }
+    // Ready Tasks
+    const ready = data['ready'];
+    if (ready && ready.length > 0) {
+        lines.push(`${BOLD}Ready Tasks (${ready.length})${NC}  ${DIM}ordered by leverage score${NC}`);
+        for (const task of ready.slice(0, 10)) {
+            const pCol = priorityColor(String(task['priority'] ?? 'medium'));
+            lines.push(`  ${BOLD}${task['id']}${NC} ${pCol}[${task['priority']}]${NC} ${task['title']}`);
+            lines.push(`    ${DIM}leverage:${NC} ${task['leverage']}  ${DIM}score:${NC} ${task['score']}`);
+            const reasons = task['reasons'];
+            if (reasons && reasons.length > 0) {
+                lines.push(`    ${DIM}${reasons.join(', ')}${NC}`);
+            }
+        }
+        if (ready.length > 10) {
+            lines.push(`  ${DIM}... and ${ready.length - 10} more${NC}`);
+        }
+        lines.push('');
+    }
+    // Blocked Tasks
+    const blocked = data['blocked'];
+    if (blocked && blocked.length > 0) {
+        lines.push(`${RED}${BOLD}Blocked Tasks (${blocked.length})${NC}`);
+        for (const task of blocked.slice(0, 10)) {
+            lines.push(`  ${RED}⊗${NC} ${BOLD}${task['id']}${NC} ${task['title']}`);
+            const blockedBy = task['blockedBy'];
+            if (blockedBy && blockedBy.length > 0) {
+                lines.push(`    ${DIM}Blocked by: ${blockedBy.join(', ')}${NC}`);
+            }
+            if (task['blocksCount'] > 0) {
+                lines.push(`    ${DIM}Blocks: ${task['blocksCount']} task(s)${NC}`);
+            }
+        }
+        if (blocked.length > 10) {
+            lines.push(`  ${DIM}... and ${blocked.length - 10} more${NC}`);
+        }
+        lines.push('');
+    }
+    // Open Bugs
+    const openBugs = data['openBugs'];
+    if (openBugs && openBugs.length > 0) {
+        lines.push(`${RED}${BOLD}Open Bugs (${openBugs.length})${NC}`);
+        for (const bug of openBugs.slice(0, 10)) {
+            const pCol = priorityColor(String(bug['priority'] ?? 'medium'));
+            lines.push(`  ${RED}●${NC} ${BOLD}${bug['id']}${NC} ${pCol}[${bug['priority']}]${NC} ${bug['title']}`);
+        }
+        if (openBugs.length > 10) {
+            lines.push(`  ${DIM}... and ${openBugs.length - 10} more${NC}`);
+        }
+        lines.push('');
+    }
+    // Metrics
+    const metrics = data['metrics'];
+    if (metrics) {
+        lines.push(`${BOLD}Metrics${NC}`);
+        lines.push(`  ${DIM}Total Epics:${NC} ${metrics['totalEpics']} (${metrics['activeEpics']} active)`);
+        lines.push(`  ${DIM}Total Tasks:${NC} ${metrics['totalTasks']}`);
+        lines.push(`  ${DIM}Actionable:${NC} ${metrics['actionable']}  ${DIM}Blocked:${NC} ${metrics['blocked']}  ${DIM}Open Bugs:${NC} ${metrics['openBugs']}`);
+        lines.push(`  ${DIM}Avg Leverage:${NC} ${metrics['avgLeverage']}`);
+    }
+    return lines.join('\n');
+}
+/** Render a simple ASCII progress bar for completion percentage. */
+function renderCompletionBar(percent) {
+    const width = 20;
+    const filled = Math.round((percent / 100) * width);
+    const empty = width - filled;
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+    const color = percent >= 75 ? GREEN : percent >= 50 ? YELLOW : '';
+    return `${color}[${bar}]${NC}`;
+}
+// ---------------------------------------------------------------------------
+// briefing: composite session-start context (T1593)
+// ---------------------------------------------------------------------------
+/**
+ * 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 function renderBriefing(data, quiet) {
+    if (quiet) {
+        // Quiet mode: emit only IDs of next-suggested tasks (one per line).
+        const next = data['nextTasks'] ?? [];
+        return next.map((t) => String(t['id'] ?? '')).join('\n');
+    }
+    const lines = [];
+    lines.push(`${BOLD}CLEO Session Briefing${NC}  ${DIM}(source: tasks.db + brain.db)${NC}`);
+    lines.push('');
+    // 1. Last session
+    const lastSession = data['lastSession'];
+    if (lastSession) {
+        const handoff = lastSession['handoff'] ?? {};
+        const endedAt = String(lastSession['endedAt'] ?? '');
+        const duration = lastSession['duration'];
+        lines.push(`${BOLD}Last Session${NC}`);
+        if (endedAt)
+            lines.push(`  ${DIM}Ended:${NC} ${endedAt}`);
+        if (typeof duration === 'number')
+            lines.push(`  ${DIM}Duration:${NC} ${duration} min`);
+        const completed = handoff['tasksCompleted'] ?? [];
+        const created = handoff['tasksCreated'] ?? [];
+        if (completed.length > 0) {
+            lines.push(`  ${DIM}Completed:${NC} ${completed.length} task(s) — ${completed.join(', ')}`);
+        }
+        if (created.length > 0) {
+            lines.push(`  ${DIM}Created:${NC} ${created.length} task(s) — ${created.join(', ')}`);
+        }
+        const decisions = handoff['decisionsRecorded'];
+        if (typeof decisions === 'number' && decisions > 0) {
+            lines.push(`  ${DIM}Decisions recorded:${NC} ${decisions}`);
+        }
+        if (handoff['note']) {
+            lines.push(`  ${DIM}Note:${NC} ${String(handoff['note'])}`);
+        }
+        if (handoff['nextAction']) {
+            lines.push(`  ${DIM}Next action:${NC} ${String(handoff['nextAction'])}`);
+        }
+        lines.push('');
+    }
+    else {
+        lines.push(`${BOLD}Last Session${NC}  ${DIM}(none — fresh session)${NC}`);
+        lines.push('');
+    }
+    // 2. Current task
+    const currentTask = data['currentTask'];
+    if (currentTask) {
+        const sCol = statusColor(String(currentTask['status'] ?? ''));
+        const sSym = statusSymbol(String(currentTask['status'] ?? ''));
+        lines.push(`${BOLD}Current Task:${NC} ${sCol}${sSym}${NC} ${BOLD}${currentTask['id']}${NC} ${currentTask['title'] ?? ''}`);
+        const blockedBy = currentTask['blockedBy'];
+        if (blockedBy && blockedBy.length > 0) {
+            lines.push(`  ${RED}Blocked by:${NC} ${blockedBy.join(', ')}`);
+        }
+        lines.push('');
+    }
+    // 3. Active blockers
+    const blockedTasks = data['blockedTasks'] ?? [];
+    if (blockedTasks.length > 0) {
+        lines.push(`${RED}${BOLD}Active Blockers (${blockedTasks.length})${NC}`);
+        for (const t of blockedTasks.slice(0, 10)) {
+            const bb = (t['blockedBy'] ?? []).join(', ');
+            lines.push(`  ${RED}⊗${NC} ${BOLD}${t['id']}${NC} ${t['title'] ?? ''}`);
+            if (bb)
+                lines.push(`    ${DIM}Blocked by: ${bb}${NC}`);
+        }
+        if (blockedTasks.length > 10) {
+            lines.push(`  ${DIM}... and ${blockedTasks.length - 10} more${NC}`);
+        }
+        lines.push('');
+    }
+    // 4. Next suggested
+    const nextTasks = data['nextTasks'] ?? [];
+    if (nextTasks.length > 0) {
+        lines.push(`${BOLD}Next Suggested (${nextTasks.length})${NC}  ${DIM}leverage-scored${NC}`);
+        for (const t of nextTasks) {
+            lines.push(`  ${BOLD}${t['id']}${NC} ${t['title'] ?? ''}  ${DIM}leverage: ${t['leverage'] ?? 0}, score: ${t['score'] ?? 0}${NC}`);
+        }
+        lines.push('');
+    }
+    // 5. Open epics
+    const activeEpics = data['activeEpics'] ?? [];
+    if (activeEpics.length > 0) {
+        lines.push(`${BOLD}Open Epics (${activeEpics.length})${NC}`);
+        for (const e of activeEpics) {
+            const pct = e['completionPercent'] ?? 0;
+            lines.push(`  ${BOLD}${e['id']}${NC} ${e['title'] ?? ''}  ${DIM}(${pct}% complete)${NC}`);
+        }
+        lines.push('');
+    }
+    // 6. Open bugs
+    const openBugs = data['openBugs'] ?? [];
+    if (openBugs.length > 0) {
+        lines.push(`${RED}${BOLD}Open Bugs (${openBugs.length})${NC}`);
+        for (const b of openBugs.slice(0, 10)) {
+            const pCol = priorityColor(String(b['priority'] ?? 'medium'));
+            lines.push(`  ${RED}●${NC} ${BOLD}${b['id']}${NC} ${pCol}[${b['priority']}]${NC} ${b['title'] ?? ''}`);
+        }
+        lines.push('');
+    }
+    // 7. Memory context (recent decisions + observations from BRAIN)
+    const memoryContext = data['memoryContext'];
+    if (memoryContext) {
+        const recentDecisions = memoryContext['recentDecisions'] ?? [];
+        const recentObservations = memoryContext['recentObservations'] ?? [];
+        if (recentDecisions.length > 0) {
+            lines.push(`${BOLD}Recent Decisions (${recentDecisions.length})${NC}  ${DIM}from BRAIN${NC}`);
+            for (const d of recentDecisions.slice(0, 5)) {
+                lines.push(`  ${BOLD}${d['id']}${NC} ${d['title'] ?? ''}  ${DIM}(${d['date'] ?? ''})${NC}`);
+            }
+            lines.push('');
+        }
+        if (recentObservations.length > 0) {
+            lines.push(`${BOLD}Recent Observations (${recentObservations.length})${NC}  ${DIM}from BRAIN${NC}`);
+            for (const o of recentObservations.slice(0, 5)) {
+                lines.push(`  ${BOLD}${o['id']}${NC} ${o['title'] ?? ''}  ${DIM}(${o['date'] ?? ''})${NC}`);
+            }
+            lines.push('');
+        }
+    }
+    // 8. Warnings
+    const warnings = data['warnings'];
+    if (warnings && warnings.length > 0) {
+        lines.push(`${YELLOW}${BOLD}Warnings${NC}`);
+        for (const w of warnings)
+            lines.push(`  ${YELLOW}!${NC} ${w}`);
+        lines.push('');
+    }
+    lines.push(`${DIM}Tip: pass --json for the full structured payload. All fields read from tasks.db + brain.db.${NC}`);
+    return lines
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trimEnd();
+}
+// ---------------------------------------------------------------------------
+// Generic fallback renderer
+// ---------------------------------------------------------------------------
+/**
+ * Generic human renderer for commands that don't have a specific renderer.
+ * Renders data as indented key-value pairs.
+ */
+export function renderGeneric(data, quiet) {
+    if (quiet)
+        return '';
+    const lines = [];
+    for (const [key, val] of Object.entries(data)) {
+        if (val === null || val === undefined)
+            continue;
+        if (Array.isArray(val)) {
+            lines.push(`${BOLD}${formatLabel(key)}:${NC} (${val.length})`);
+            for (const item of val.slice(0, 20)) {
+                if (typeof item === 'object' && item !== null) {
+                    const obj = item;
+                    const id = obj['id'] ?? '';
+                    const title = obj['title'] ?? obj['name'] ?? '';
+                    lines.push(`  ${id}${title ? ` ${title}` : ''}`);
+                }
+                else {
+                    lines.push(`  ${String(item)}`);
+                }
+            }
+            if (val.length > 20) {
+                lines.push(`  ${DIM}... and ${val.length - 20} more${NC}`);
+            }
+        }
+        else if (typeof val === 'object') {
+            lines.push(`${BOLD}${formatLabel(key)}:${NC}`);
+            for (const [subKey, subVal] of Object.entries(val)) {
+                lines.push(`  ${DIM}${formatLabel(subKey)}:${NC} ${String(subVal)}`);
+            }
+        }
+        else {
+            lines.push(`${DIM}${formatLabel(key)}:${NC} ${String(val)}`);
+        }
+    }
+    return lines.join('\n') || 'OK';
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Convert camelCase to Title Case for display. */
+function formatLabel(key) {
+    return key
+        .replace(/([A-Z])/g, ' $1')
+        .replace(/^./, (s) => s.toUpperCase())
+        .trim();
+}
+//# sourceMappingURL=system.js.map