hadara 0.1.0-rc.0

package/dist/tui/snapshot.js

@@ -0,0 +1,434 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTuiSnapshot = renderTuiSnapshot;
+exports.getTuiDocumentScrollBounds = getTuiDocumentScrollBounds;
+const constants_1 = require("./constants");
+const layout_1 = require("./layout");
+const markdown_1 = require("./markdown");
+const theme_1 = require("./theme");
+const DEFAULT_WIDTH = 100;
+const DEFAULT_HEIGHT = 32;
+const MOCKUP_MIN_WIDTH = 78;
+const MOCKUP_MIN_HEIGHT = 24;
+const COMPACT_MIN_WIDTH = 40;
+const COMPACT_MIN_HEIGHT = 10;
+function renderTuiSnapshot(model, options = {}) {
+    const terminal = resolveTerminalSize(options);
+    const panel = options.panel ?? 'overview';
+    const theme = (0, theme_1.normalizeTuiThemeName)(options.theme, 'none');
+    const hitboxes = [];
+    const rawLines = renderFrame(model, panel, (0, constants_1.resolveTuiDocumentTab)(options.document), terminal.width, terminal.height, hitboxes, {
+        includeGeneratedAt: Boolean(options.includeGeneratedAt),
+        theme,
+        loading: options.loading === true,
+        loadingTick: options.loadingTick ?? 0,
+        logLine: options.logLine,
+        selectedTaskId: options.selectedTaskId ?? model.selectedTaskId,
+        taskSearch: options.taskSearch ?? '',
+        taskSearchActive: options.taskSearchActive === true,
+        taskListScroll: Math.max(0, Math.floor(options.taskListScroll ?? 0)),
+        documentScroll: Math.max(0, Math.floor(options.documentScroll ?? 0))
+    });
+    const truncated = rawLines.length > terminal.height;
+    const lines = rawLines.slice(0, terminal.height).map((line) => (theme === 'none' ? (0, layout_1.fit)(line, terminal.width) : (0, layout_1.fitAnsi)(line, terminal.width)));
+    while (lines.length < terminal.height)
+        lines.push(''.padEnd(terminal.width));
+    return {
+        schemaVersion: 'hadara.tui.snapshot.internal.v1',
+        command: 'tui.snapshot',
+        panel,
+        terminal: {
+            width: terminal.width,
+            height: terminal.height,
+            color: (0, theme_1.tuiColorEnabled)(theme),
+            theme
+        },
+        text: lines.join('\n'),
+        lines,
+        hitboxes,
+        truncated
+    };
+}
+function resolveTerminalSize(options) {
+    const policy = options.widthPolicy ?? 'mockup';
+    const minWidth = policy === 'compact' ? COMPACT_MIN_WIDTH : MOCKUP_MIN_WIDTH;
+    const minHeight = policy === 'compact' ? COMPACT_MIN_HEIGHT : MOCKUP_MIN_HEIGHT;
+    return {
+        width: Math.max(minWidth, Math.floor(options.width ?? DEFAULT_WIDTH)),
+        height: Math.max(minHeight, Math.floor(options.height ?? DEFAULT_HEIGHT))
+    };
+}
+function getTuiDocumentScrollBounds(model, options = {}) {
+    const terminal = resolveTerminalSize(options);
+    const document = (0, constants_1.resolveTuiDocumentTab)(options.document);
+    const availableRows = Math.max(1, terminal.height - 8);
+    const panelWidth = terminal.width >= 104 ? terminal.width - 25 : terminal.width - 2;
+    const docRows = (0, constants_1.tuiDetailDocumentRowsForAvailableRows)(availableRows);
+    const docText = model.selectedTask?.detail.files?.[document.file] ?? '';
+    const renderedDoc = docText ? (0, markdown_1.renderMarkdownDocument)(docText, Math.max(12, panelWidth - 4)) : [`${document.file} unavailable.`];
+    return {
+        maxScroll: Math.max(0, renderedDoc.length - docRows),
+        renderedRows: renderedDoc.length,
+        visibleRows: docRows
+    };
+}
+function renderFrame(model, panel, document, width, height, hitboxes, options) {
+    const raw = renderHeader(model, document, width, options);
+    const availableRows = Math.max(1, height - raw.length - 3);
+    if (width >= 104) {
+        const navWidth = 22;
+        const mainWidth = width - navWidth - 3;
+        const contentStartY = raw.length + 1;
+        const mainStartX = navWidth + 4;
+        const main = renderPanel(model, panel, document, mainWidth, availableRows, options, hitboxes, mainStartX, contentStartY);
+        const nav = renderNav(panel, navWidth, options.theme, hitboxes, 1, contentStartY);
+        const rows = Math.min(Math.max(nav.length, main.length), availableRows);
+        for (let index = 0; index < rows; index += 1) {
+            raw.push(`${(0, layout_1.padAnsi)(nav[index] ?? '', navWidth)} ${(0, theme_1.tuiFg)(options.theme, 'border', '│')} ${(0, layout_1.padAnsi)(main[index] ?? '', mainWidth)}`);
+        }
+    }
+    else {
+        const tabY = raw.length + 1;
+        raw.push(renderTabBar(panel, width, options.theme, hitboxes, tabY));
+        raw.push(colorDivider(width, options.theme));
+        const panelStartY = raw.length + 1;
+        raw.push(...renderPanel(model, panel, document, width - 2, availableRows, options, hitboxes, 1, panelStartY).slice(0, availableRows));
+    }
+    raw.push(colorDivider(width, options.theme));
+    raw.push(renderStatusBar(width, options));
+    return raw;
+}
+function renderHeader(model, document, width, options) {
+    const selected = model.selectedTask;
+    const projectLine = options.includeGeneratedAt
+        ? `branch ${model.overview.branch}  mode local  generated ${model.generatedAt}`
+        : `branch ${model.overview.branch}  mode local`;
+    const title = `${(0, theme_1.tuiFg)(options.theme, 'gold2', 'HADARA')} ${(0, theme_1.tuiFg)(options.theme, 'text', 'Work Console')} ${(0, theme_1.tuiFg)(options.theme, 'muted', '·')} ${colorBadge(String(model.overview.health).toUpperCase(), statusThemeRole(model.overview.health), options.theme)} ${colorBadge('READ ONLY', 'pass', options.theme)}`;
+    return [
+        colorDivider(width, options.theme),
+        (0, layout_1.fitAnsi)(title, width),
+        colorTextLine(projectLine, width, options.theme, 'muted'),
+        (0, layout_1.fitAnsi)(`${(0, theme_1.tuiFg)(options.theme, 'muted', options.loading ? 'loading' : 'task')} ${(0, theme_1.tuiFg)(options.theme, 'gold2', model.selectedTaskId ?? '-')} ${(0, theme_1.tuiFg)(options.theme, 'text2', selected?.summary.title ?? 'no task')}  ${(0, theme_1.tuiFg)(options.theme, 'muted', 'doc')} ${(0, theme_1.tuiFg)(options.theme, 'teal2', document.file)}`, width),
+        colorDivider(width, options.theme)
+    ];
+}
+function renderNav(activePanel, width, theme, hitboxes, startX, startY) {
+    return [
+        (0, theme_1.tuiFg)(theme, 'muted', ' WORK'),
+        ...constants_1.TUI_PANEL_IDS.map((panel, index) => {
+            const marker = panel === activePanel ? '>' : ' ';
+            const line = (0, layout_1.fit)(`${marker} ${index + 1} ${constants_1.TUI_PANEL_LABELS[panel]}`, width);
+            addHitbox(hitboxes, startX, startY + index + 1, width, 1, 'panel', panel);
+            return panel === activePanel ? (0, theme_1.tuiBg)(theme, 'panel2', (0, theme_1.tuiFg)(theme, 'gold2', line)) : (0, theme_1.tuiFg)(theme, 'text2', line);
+        })
+    ];
+}
+function renderTabBar(activePanel, width, theme, hitboxes, y) {
+    let cursor = 1;
+    const text = constants_1.TUI_PANEL_IDS.map((panel, index) => {
+        const plain = panel === activePanel ? `[${index + 1} ${constants_1.TUI_PANEL_LABELS[panel]}]` : ` ${index + 1} ${constants_1.TUI_PANEL_LABELS[panel]} `;
+        addHitbox(hitboxes, cursor, y, (0, layout_1.visibleWidth)(plain), 1, 'panel', panel);
+        cursor += (0, layout_1.visibleWidth)(plain) + 1;
+        return panel === activePanel ? (0, theme_1.tuiBg)(theme, 'panel2', (0, theme_1.tuiFg)(theme, 'gold2', plain)) : (0, theme_1.tuiFg)(theme, 'muted', plain);
+    }).join(' ');
+    return (0, layout_1.fitAnsi)(text, width);
+}
+function renderPanel(model, panel, document, width, availableRows, options, hitboxes, startX, startY) {
+    if (options.loading)
+        return renderLoadingPanel(constants_1.TUI_PANEL_LABELS[panel], width, options);
+    if (panel === 'tasks')
+        return renderTasks(model, width, availableRows, options, hitboxes, startX, startY);
+    if (panel === 'detail')
+        return renderDetail(model, document, width, availableRows, options, hitboxes, startX, startY);
+    if (panel === 'help')
+        return renderHelp(width, options.theme);
+    return renderOverview(model, width, options.theme);
+}
+function renderOverview(model, width, theme) {
+    const current = model.overview.currentWork;
+    const previous = model.overview.previousWork;
+    const columnGap = 2;
+    const leftWidth = width >= 96 ? Math.max(20, Math.floor((width - columnGap) * 0.52)) : width;
+    const rightWidth = width >= 96 ? Math.max(20, width - columnGap - leftWidth) : width;
+    const currentCard = colorCard('Current Work', workSummaryLines(model, current, model.overview.currentDetail, 'LIVE', theme, Math.max(8, leftWidth - 4), true), leftWidth, theme, 'teal');
+    const previousCard = colorCard('Previous Work', workSummaryLines(model, previous, model.overview.previousDetail, previous ? 'FILE' : 'ROUTE', theme, Math.max(8, rightWidth - 4), false), rightWidth, theme, 'violet');
+    const top = width >= 96 ? (0, layout_1.columns)(currentCard, previousCard, width) : [...currentCard, '', ...previousCard];
+    const signals = [
+        `health ${model.overview.health}  tasks done ${model.status.tasks.counts.done} partial ${model.status.tasks.counts.partial} unknown ${model.status.tasks.counts.unknown}`,
+        `validation ${(0, layout_1.trimFit)(model.status.validation.latestFullCheck ?? '-', Math.max(12, width - 18))}`
+    ];
+    return [...top, '', ...colorCard('Resume Signals', signals, width, theme, 'gold'), ...nextRecommendedCard(model, width, theme)];
+}
+function renderTasks(model, width, availableRows, options, hitboxes, startX, startY) {
+    const theme = options.theme;
+    const query = options.taskSearch.trim().toLowerCase();
+    const visible = query
+        ? model.tasks.tasks.filter((task) => [task.id, task.title, task.status, task.capsule].some((value) => String(value ?? '').toLowerCase().includes(query)))
+        : model.tasks.tasks;
+    const rowsAll = [...visible].reverse();
+    if (!rowsAll.length) {
+        return colorCard('Tasks Empty', [`${colorBadge('ROUTE', 'muted', theme)} no tasks match ${query ? `"${options.taskSearch}"` : 'the current project'}`], width, theme, 'warn');
+    }
+    const visibleRows = (0, constants_1.tuiTaskVisibleRowsForAvailableRows)(availableRows);
+    const selectedIndex = options.selectedTaskId ? rowsAll.findIndex((task) => task.id === options.selectedTaskId) : -1;
+    const windowStart = normalizeTaskWindow(options.taskListScroll, selectedIndex, rowsAll.length, visibleRows);
+    const rows = rowsAll.slice(windowStart, windowStart + visibleRows).map((task, localIndex) => {
+        const marker = options.selectedTaskId === task.id ? '>' : ' ';
+        const titleWidth = Math.max(10, width - 44);
+        const markerText = marker === '>' ? (0, theme_1.tuiFg)(theme, 'gold2', marker) : (0, theme_1.tuiFg)(theme, 'dim', marker);
+        const line = `${markerText} ${colorBadge(task.status, statusThemeRole(task.status), theme)} ${(0, theme_1.tuiFg)(theme, 'gold2', (0, layout_1.pad)(task.id, 8))} ${(0, layout_1.fit)(task.title, titleWidth)} ${(0, theme_1.tuiFg)(theme, 'muted', (0, layout_1.trimFit)(task.capsule, 22))}`;
+        addHitbox(hitboxes, startX, startY + localIndex + 1, width, 1, 'task', task.id);
+        return marker === '>' ? (0, theme_1.tuiBg)(theme, 'panel2', line) : line;
+    });
+    const searchHint = options.taskSearchActive
+        ? `search: ${options.taskSearch}_`
+        : query
+            ? `search: ${options.taskSearch}`
+            : '/ search id/title/status';
+    return [
+        colorTextLine('Status      ID       Title                                                    Capsule', width, theme, 'muted'),
+        ...rows,
+        '',
+        (0, layout_1.fit)(`${searchHint} · Showing ${windowStart + 1}-${windowStart + rows.length} of ${rowsAll.length}/${model.tasks.count}. Enter/click opens Detail.`, width)
+    ];
+}
+function renderDetail(model, document, width, availableRows, options, hitboxes, startX, startY) {
+    const theme = options.theme;
+    if (!model.selectedTask) {
+        return colorCard('Detail Empty', [`${colorBadge('ROUTE', 'muted', theme)} no selected task detail is available`], width, theme, 'warn');
+    }
+    const task = model.selectedTask.summary;
+    const docText = model.selectedTask.detail.files?.[document.file] ?? '';
+    const docAvailable = Boolean(docText);
+    let tabCursor = startX + 2;
+    const tabs = constants_1.TUI_DOCUMENT_TABS.map((tab) => {
+        const plain = tab.file === document.file ? `[${tab.key.toUpperCase()} ${tab.shortLabel}]` : ` ${tab.key} ${tab.shortLabel} `;
+        addHitbox(hitboxes, tabCursor, startY + 4, (0, layout_1.visibleWidth)(plain), 1, 'document', tab.file);
+        tabCursor += (0, layout_1.visibleWidth)(plain) + 1;
+        return tab.file === document.file ? (0, theme_1.tuiFg)(theme, 'gold2', plain) : (0, theme_1.tuiFg)(theme, 'muted', plain);
+    }).join(' ');
+    const meta = [
+        `${colorBadge('LIVE', 'pass', theme)} ${(0, theme_1.tuiFg)(theme, 'gold2', task.id)} ${task.title}`,
+        `${(0, theme_1.tuiFg)(theme, 'muted', 'status')} ${(0, theme_1.tuiFg)(theme, statusThemeRole(task.status), task.status)}  ${(0, theme_1.tuiFg)(theme, 'muted', 'capsule')} ${(0, layout_1.trimFit)(task.capsule || '-', Math.max(12, width - 34))}`,
+        `${(0, theme_1.tuiFg)(theme, 'muted', 'detail')} ${model.selectedTask.detail.schemaVersion}  ${(0, theme_1.tuiFg)(theme, 'muted', 'document')} ${colorBadge(docAvailable ? 'LIVE' : 'PLANNED', docAvailable ? 'pass' : 'warn', theme)} ${document.file}`,
+        (0, layout_1.fitAnsi)(tabs, Math.max(12, width - 4))
+    ];
+    const docRows = (0, constants_1.tuiDetailDocumentRowsForAvailableRows)(availableRows);
+    const renderedDoc = docAvailable ? (0, markdown_1.renderMarkdownDocument)(docText, Math.max(12, width - 4)) : [`${document.file} unavailable.`];
+    const maxScroll = Math.max(0, renderedDoc.length - docRows);
+    const scroll = Math.min(Math.max(0, options.documentScroll), maxScroll);
+    const lines = colorizeDetailDocument(renderedDoc.slice(scroll, scroll + docRows), theme);
+    while (lines.length < docRows)
+        lines.push('');
+    const title = maxScroll > 0 ? `Document Viewer ${document.file} ${scroll + 1}-${Math.min(renderedDoc.length, scroll + docRows)}/${renderedDoc.length}` : `Document Viewer ${document.file}`;
+    return [...colorCard('Task Detail', meta, width, theme, 'gold'), '', ...colorCard(title, lines, width, theme, docAvailable ? 'teal' : 'warn')];
+}
+function renderHelp(width, theme) {
+    return colorCard('Controls', [
+        '1-4 switch panels',
+        'Up/Down select task or scroll document',
+        '/ search tasks by id, title, or status',
+        'Esc clear task search',
+        'Enter open detail',
+        't/p/d/a/e/h/f/k/s switch Task Detail document',
+        'r refresh project state',
+        '? help',
+        'q quit',
+        '',
+        'Boundary: read-only snapshot; no writes, shell execution, provider calls, or MCP calls.'
+    ], width, theme, 'gold');
+}
+function renderStatusBar(width, options) {
+    const key = (text) => (options.theme === 'none' ? `[${text}]` : (0, theme_1.tuiSwatch)(options.theme, text === '↵' ? 'teal' : 'gold', 'black', ` ${text} `));
+    const left = [
+        `${key('1-4')} panels`,
+        `${key('↑↓')} select`,
+        `${key('↵')} detail`,
+        `${key('/')} search`,
+        `${key('r')} refresh`,
+        `${key('?')} help`,
+        `${key('q')} quit`
+    ].join(options.theme === 'none' ? ' · ' : (0, theme_1.tuiFg)(options.theme, 'dim', ' · '));
+    const log = options.logLine ? `${(0, theme_1.tuiFg)(options.theme, 'dim', 'log')} ${(0, theme_1.tuiFg)(options.theme, 'muted', (0, layout_1.trimFitAnsi)(options.logLine, Math.max(8, width - (0, layout_1.visibleWidth)(left) - 8)))}` : '';
+    if (!log)
+        return (0, layout_1.fitAnsi)(left, width);
+    const gap = ' '.repeat(Math.max(1, width - (0, layout_1.visibleWidth)(left) - (0, layout_1.visibleWidth)(log) - 1));
+    return (0, layout_1.fitAnsi)(`${left}${gap}${log}`, width);
+}
+function workSummaryLines(model, task, detail, label, theme, width, includeResumeActions) {
+    if (!task) {
+        return [
+            trimLine(`${colorBadge('ROUTE', 'muted', theme)} - No task exposed`, width),
+            labelValueLine('status', 'muted', '- · capsule -', width, theme),
+            labelValueLine('Goal', 'teal2', 'No summary exposed.', width, theme),
+            labelValueLine('Next', 'gold2', 'Select a task or refresh read models.', width, theme),
+            labelValueLine('Proof', 'pass', 'No evidence exposed.', width, theme)
+        ];
+    }
+    const docs = detail?.files ?? {};
+    const taskText = docs?.['TASK.md'] ?? '';
+    const planText = docs?.['PLAN.md'] ?? '';
+    const acceptanceText = docs?.['ACCEPTANCE.md'] ?? '';
+    const handoffText = docs?.['HANDOFF.md'] ?? '';
+    const evidenceText = docs?.['EVIDENCE.md'] ?? '';
+    const nextActions = includeResumeActions ? model.activeRun.resume.resumePrompt.nextActions : [];
+    const next = firstLine(nextActions, (0, markdown_1.markdownPreview)(handoffText, { headings: ['Next Recommended Step', 'Next'], limit: 2 }), (0, markdown_1.incompleteChecklist)(planText, 2), (0, markdown_1.incompleteChecklist)(acceptanceText, 2), (0, markdown_1.markdownPreview)(planText, { headings: ['Plan'], limit: 2 }), (0, markdown_1.markdownPreview)(acceptanceText, { headings: ['Acceptance'], limit: 2 }), task.status === 'Done' ? 'Completed; use current work as the next operating context.' : '');
+    const latestEvidence = task.id === model.selectedTask?.summary.id && model.selectedTask.evidence.records[0]?.summary
+        ? [model.selectedTask.evidence.records[0].summary]
+        : [];
+    const proof = firstLine(latestEvidence, (0, markdown_1.evidenceFromMarkdown)(evidenceText, 2), (0, markdown_1.markdownPreview)(evidenceText, { limit: 2 }), task.status === 'Done' ? 'Done status exposed by task list.' : '');
+    return [
+        summaryTitleLine(label, task.id, task.title || '-', width, theme),
+        summaryStatusLine(task.status || '-', task.capsule || '-', width, theme),
+        labelValueLine('Goal', 'teal2', firstLine((0, markdown_1.markdownPreview)(taskText, { headings: ['Goal', 'Current', 'Scope', 'Summary'], limit: 2 }), task.title), width, theme),
+        labelValueLine('Next', 'gold2', next, width, theme),
+        labelValueLine('Proof', 'pass', proof, width, theme)
+    ];
+}
+function summaryTitleLine(label, taskId, title, width, theme) {
+    const prefix = `${colorBadge(label, label === 'LIVE' ? 'pass' : 'violet', theme)} ${(0, theme_1.tuiFg)(theme, 'gold2', taskId)} `;
+    return `${prefix}${(0, layout_1.trimFit)(title, Math.max(1, width - (0, layout_1.visibleWidth)(prefix)))}`;
+}
+function summaryStatusLine(status, capsule, width, theme) {
+    const prefix = `${(0, theme_1.tuiFg)(theme, statusThemeRole(status), status)} ${(0, theme_1.tuiFg)(theme, 'muted', '·')} `;
+    return `${prefix}${(0, layout_1.trimFit)(capsule, Math.max(1, width - (0, layout_1.visibleWidth)(prefix)))}`;
+}
+function labelValueLine(label, role, value, width, theme) {
+    const prefix = `${(0, theme_1.tuiFg)(theme, role, label)} `;
+    return `${prefix}${(0, layout_1.trimFit)(value, Math.max(1, width - (0, layout_1.visibleWidth)(prefix)))}`;
+}
+function trimLine(line, width) {
+    return (0, layout_1.trimFitAnsi)(line, width);
+}
+function nextRecommendedCard(model, width, theme) {
+    const next = [
+        model.status.tasks.nextRecommended,
+        ...(model.status.handoff.nextRecommendedStep ?? [])
+    ].filter((line) => Boolean(line));
+    if (!next.length)
+        return [];
+    return ['', ...colorCard('Next Recommended', dedupe(next).slice(0, 4), width, theme, 'gold')];
+}
+function dedupe(items) {
+    const seen = new Set();
+    return items.filter((item) => {
+        if (seen.has(item))
+            return false;
+        seen.add(item);
+        return true;
+    });
+}
+function normalizeTaskWindow(requestedStart, selectedIndex, rowCount, visibleRows) {
+    if (rowCount <= visibleRows)
+        return 0;
+    let start = Math.min(Math.max(0, requestedStart), Math.max(0, rowCount - visibleRows));
+    if (selectedIndex >= 0 && selectedIndex < start)
+        start = selectedIndex;
+    if (selectedIndex >= 0 && selectedIndex >= start + visibleRows)
+        start = selectedIndex - visibleRows + 1;
+    return Math.min(Math.max(0, start), Math.max(0, rowCount - visibleRows));
+}
+function renderLoadingPanel(panel, width, options) {
+    return colorCard(`${panel} Reading`, [
+        ...loaderLines(width, options.theme, options.loadingTick),
+        '',
+        `${colorBadge('READ', 'pass', options.theme)} project state`,
+        `${(0, theme_1.tuiFg)(options.theme, 'muted', 'signal')} selected task and capsule documents requested`
+    ], width, options.theme, 'teal');
+}
+function loaderLines(width, theme, tick) {
+    const innerWidth = 24;
+    const dotCount = 11;
+    const position = Math.abs(tick) % dotCount;
+    const rail = Array.from({ length: dotCount }, (_, index) => (0, theme_1.tuiFg)(theme, index === position ? 'teal2' : 'muted', index === position ? '●' : '·')).join((0, theme_1.tuiFg)(theme, 'muted', ' '));
+    const indent = ' '.repeat(Math.max(0, Math.floor((width - (innerWidth + 2)) / 2)));
+    const boxed = (content) => `${indent}${(0, theme_1.tuiFg)(theme, 'dim', '│')}${(0, layout_1.padAnsi)(content, innerWidth)}${(0, theme_1.tuiFg)(theme, 'dim', '│')}`;
+    return [
+        `${indent}${(0, theme_1.tuiFg)(theme, 'dim', '╭')}${(0, theme_1.tuiFg)(theme, 'dim', '─'.repeat(innerWidth))}${(0, theme_1.tuiFg)(theme, 'dim', '╮')}`,
+        boxed(` ${rail}`),
+        boxed((0, theme_1.tuiFg)(theme, 'gold', ' reading task capsule')),
+        `${indent}${(0, theme_1.tuiFg)(theme, 'dim', '╰')}${(0, theme_1.tuiFg)(theme, 'dim', '─'.repeat(innerWidth))}${(0, theme_1.tuiFg)(theme, 'dim', '╯')}`
+    ];
+}
+function colorCard(title, lines, width, theme, accent = 'gold') {
+    if (theme === 'none')
+        return (0, layout_1.card)(title, lines, width);
+    const inner = Math.max(8, width - 4);
+    const head = ` ${title} `;
+    return [
+        `${(0, theme_1.tuiFg)(theme, accent, '╭─')}${(0, theme_1.tuiFg)(theme, accent, (0, layout_1.fit)(head, Math.min((0, layout_1.visibleWidth)(head), inner)))}${(0, theme_1.tuiFg)(theme, accent, '─'.repeat(Math.max(0, inner - (0, layout_1.visibleWidth)(head))))}${(0, theme_1.tuiFg)(theme, accent, '─╮')}`,
+        ...lines.map((line) => `${(0, theme_1.tuiFg)(theme, 'border', '│')} ${(0, layout_1.padAnsi)(line, inner)} ${(0, theme_1.tuiFg)(theme, 'border', '│')}`),
+        `${(0, theme_1.tuiFg)(theme, 'border', '╰')}${(0, theme_1.tuiFg)(theme, 'border', '─'.repeat(inner + 2))}${(0, theme_1.tuiFg)(theme, 'border', '╯')}`
+    ];
+}
+function colorBadge(text, role, theme) {
+    if (theme === 'none')
+        return (0, layout_1.badge)(text);
+    return (0, theme_1.tuiSwatch)(theme, role, role === 'fail' ? 'white' : 'black', ` ${String(text).toUpperCase()} `);
+}
+function colorDivider(width, theme) {
+    return (0, theme_1.tuiFg)(theme, 'border', (0, layout_1.divider)(width));
+}
+function colorTextLine(text, width, theme, role) {
+    return (0, theme_1.tuiFg)(theme, role, (0, layout_1.fit)(text, width));
+}
+function statusThemeRole(value) {
+    const normalized = String(value ?? '').toLowerCase();
+    if (['ok', 'done', 'passed', 'true', 'read', 'preview'].includes(normalized))
+        return 'pass';
+    if (['warning', 'partial', 'draft', 'medium'].includes(normalized))
+        return 'warn';
+    if (['error', 'failed', 'high', 'disabled', 'blocked'].includes(normalized))
+        return 'fail';
+    return 'teal';
+}
+function colorizeDetailDocument(lines, theme) {
+    if (theme === 'none')
+        return lines;
+    return lines.map((line, index) => {
+        const plain = line.trimEnd();
+        if (!plain)
+            return line;
+        if (/^─{8,}$/.test(plain))
+            return (0, theme_1.tuiFg)(theme, 'border', line);
+        if (/^[-─┼]{8,}$/.test(plain))
+            return (0, theme_1.tuiFg)(theme, 'border', line);
+        if (/^─/.test(lines[index + 1]?.trimEnd() ?? ''))
+            return (0, theme_1.tuiFg)(theme, index === 0 || !lines.slice(0, index).some((candidate) => candidate.trim()) ? 'gold2' : 'teal2', line);
+        if (/^[A-Z0-9][A-Z0-9 _/-]{2,}$/.test(plain) && (0, layout_1.visibleWidth)(plain) <= 48)
+            return (0, theme_1.tuiFg)(theme, 'teal2', line);
+        if (/^\[(DONE|TODO|LIVE|PLANNED|READY|FILE)\]/i.test(plain)) {
+            return line.replace(/^\[([^\]]+)\]/, (_match, label) => colorBadge(label, label.toLowerCase() === 'done' ? 'pass' : 'warn', theme));
+        }
+        if (/^\[[ xX]\]\s+/.test(plain)) {
+            return line.replace(/^\[([ xX])\]\s+/, (_match, mark) => `${colorBadge(mark.trim() ? 'DONE' : 'TODO', mark.trim() ? 'pass' : 'warn', theme)} `);
+        }
+        if (plain.startsWith('•'))
+            return line.replace('•', (0, theme_1.tuiFg)(theme, 'gold', '•'));
+        if (/^\d{2}\s+/.test(plain))
+            return line.replace(/^(\d{2})/, (_match, number) => (0, theme_1.tuiFg)(theme, 'gold', number));
+        if (/^\d+\.\s+/.test(plain))
+            return line.replace(/^(\d+)\./, (_match, number) => (0, theme_1.tuiFg)(theme, 'gold', number.padStart(2, '0')));
+        return (0, theme_1.tuiFg)(theme, 'text2', line);
+    });
+}
+function addHitbox(hitboxes, x, y, width, height, action, payload) {
+    if (width <= 0 || height <= 0)
+        return;
+    hitboxes.push({
+        x1: x,
+        y1: y,
+        x2: x + width - 1,
+        y2: y + height - 1,
+        action,
+        payload
+    });
+}
+function firstLine(...values) {
+    for (const value of values.flat()) {
+        const cleaned = String(value ?? '').trim();
+        if (cleaned)
+            return cleaned;
+    }
+    return 'No concise summary exposed.';
+}

package/dist/tui/state.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTuiInteractionState = createTuiInteractionState;
+exports.reduceTuiInteractionState = reduceTuiInteractionState;
+exports.getTuiTaskRows = getTuiTaskRows;
+exports.tuiStateToReadModelOptions = tuiStateToReadModelOptions;
+exports.tuiStateToSnapshotOptions = tuiStateToSnapshotOptions;
+const constants_1 = require("./constants");
+const DEFAULT_PAGE_SIZE = 8;
+const DEFAULT_TASK_VISIBLE_ROWS = 12;
+function createTuiInteractionState(model, options = {}) {
+    const panel = resolvePanel(options.panel, 'overview');
+    const document = (0, constants_1.resolveTuiDocumentTab)(options.document).file;
+    const taskSearch = options.taskSearch ?? '';
+    const rows = filterTaskRows(getTaskRows(model), taskSearch);
+    const requestedTaskId = options.selectedTaskId ?? model.selectedTaskId;
+    const selectedTaskIndex = resolveTaskIndex(rows, requestedTaskId);
+    const selectedTask = selectedTaskIndex >= 0 ? rows[selectedTaskIndex] : null;
+    const taskListVisibleRows = normalizeVisibleRows(options.taskListVisibleRows);
+    return {
+        activePanel: panel,
+        selectedTaskId: selectedTask?.id ?? null,
+        selectedTaskIndex,
+        taskSearch,
+        searchActive: Boolean(options.searchActive),
+        documentFile: document,
+        documentScroll: 0,
+        taskListScroll: normalizeTaskOffset(0, selectedTaskIndex, rows.length, taskListVisibleRows),
+        refreshRequested: false,
+        quitRequested: false,
+        detailRefreshRequested: false
+    };
+}
+function reduceTuiInteractionState(state, model, key, options = {}) {
+    const normalized = normalizeKey(key);
+    const taskListVisibleRows = normalizeVisibleRows(options.taskListVisibleRows);
+    if (normalized === 'refresh-complete' || normalized === 'refresh-failed')
+        return { ...state, refreshRequested: false };
+    if (normalized === 'detail-refresh-complete' || normalized === 'detail-refresh-failed')
+        return { ...state, detailRefreshRequested: false };
+    if (normalized === 'ctrl-c' || normalized === 'q' || normalized === 'ㅂ')
+        return { ...state, quitRequested: true };
+    if (state.searchActive) {
+        if (normalized === 'enter')
+            return { ...state, searchActive: false };
+        if (normalized === 'escape')
+            return reconcileTaskSelection({ ...state, searchActive: false, taskSearch: '', taskListScroll: 0 }, model, taskListVisibleRows);
+        if (normalized === 'backspace') {
+            return reconcileTaskSelection({ ...state, taskSearch: state.taskSearch.slice(0, -1), taskListScroll: 0 }, model, taskListVisibleRows);
+        }
+        if (isSearchCharacter(key)) {
+            return reconcileTaskSelection({ ...state, taskSearch: `${state.taskSearch}${key}`, taskListScroll: 0 }, model, taskListVisibleRows);
+        }
+    }
+    if (normalized === 'r')
+        return { ...state, refreshRequested: true };
+    if (normalized === '?')
+        return { ...state, activePanel: 'help' };
+    if (normalized === 'tab' || normalized === 'right')
+        return { ...state, activePanel: nextPanel(state.activePanel, 1), searchActive: false };
+    if (normalized === 'shift-tab' || normalized === 'left')
+        return { ...state, activePanel: nextPanel(state.activePanel, -1), searchActive: false };
+    const panel = panelForKey(normalized);
+    if (panel)
+        return { ...state, activePanel: panel, searchActive: panel === 'tasks' ? state.searchActive : false };
+    if (normalized === '/')
+        return reconcileTaskSelection({ ...state, activePanel: 'tasks', searchActive: true, taskSearch: '', taskListScroll: 0 }, model, taskListVisibleRows);
+    if (normalized === 'escape')
+        return reconcileTaskSelection({ ...state, searchActive: false, taskSearch: '', taskListScroll: 0 }, model, taskListVisibleRows);
+    const document = documentForKey(normalized);
+    if (document)
+        return { ...state, activePanel: 'detail', documentFile: document.file, documentScroll: 0, searchActive: false };
+    if (normalized === 'enter' && state.activePanel === 'tasks' && state.selectedTaskId) {
+        return {
+            ...state,
+            activePanel: 'detail',
+            searchActive: false,
+            documentScroll: 0,
+            detailRefreshRequested: model.selectedTaskId !== state.selectedTaskId
+        };
+    }
+    if (state.activePanel === 'tasks' && (normalized === 'up' || normalized === 'down')) {
+        return moveTaskSelection(state, model, normalized === 'down' ? 1 : -1, taskListVisibleRows);
+    }
+    if (state.activePanel === 'tasks') {
+        if (normalized === 'pageup')
+            return moveTaskSelection(state, model, -taskListVisibleRows, taskListVisibleRows);
+        if (normalized === 'pagedown')
+            return moveTaskSelection(state, model, taskListVisibleRows, taskListVisibleRows);
+        if (normalized === 'home')
+            return moveTaskSelectionToEdge(state, model, 'start', taskListVisibleRows);
+        if (normalized === 'end')
+            return moveTaskSelectionToEdge(state, model, 'end', taskListVisibleRows);
+    }
+    if (state.activePanel === 'detail') {
+        const maxScroll = normalizeDocumentMaxScroll(options.documentMaxScroll);
+        if (normalized === 'up')
+            return { ...state, documentScroll: Math.max(0, clampDocumentScroll(state.documentScroll, maxScroll) - 1) };
+        if (normalized === 'down')
+            return { ...state, documentScroll: clampDocumentScroll(state.documentScroll + 1, maxScroll) };
+        if (normalized === 'pageup')
+            return { ...state, documentScroll: Math.max(0, clampDocumentScroll(state.documentScroll, maxScroll) - DEFAULT_PAGE_SIZE) };
+        if (normalized === 'pagedown')
+            return { ...state, documentScroll: clampDocumentScroll(state.documentScroll + DEFAULT_PAGE_SIZE, maxScroll) };
+        if (normalized === 'home')
+            return { ...state, documentScroll: 0 };
+        if (normalized === 'end')
+            return { ...state, documentScroll: maxScroll ?? Number.MAX_SAFE_INTEGER };
+    }
+    return state;
+}
+function normalizeDocumentMaxScroll(value) {
+    if (value === undefined)
+        return null;
+    return Math.max(0, Math.floor(value));
+}
+function clampDocumentScroll(value, maxScroll) {
+    const next = Math.max(0, Math.floor(value));
+    return maxScroll === null ? next : Math.min(next, maxScroll);
+}
+function moveTaskSelectionToEdge(state, model, edge, visibleRows) {
+    const rows = getTuiTaskRows(model, state);
+    if (!rows.length)
+        return { ...state, selectedTaskId: null, selectedTaskIndex: -1, taskListScroll: 0 };
+    const nextIndex = edge === 'start' ? 0 : rows.length - 1;
+    return {
+        ...state,
+        selectedTaskId: rows[nextIndex]?.id ?? null,
+        selectedTaskIndex: nextIndex,
+        taskListScroll: normalizeTaskOffset(state.taskListScroll, nextIndex, rows.length, visibleRows)
+    };
+}
+function getTuiTaskRows(model, state) {
+    return filterTaskRows(getTaskRows(model), state.taskSearch);
+}
+function tuiStateToReadModelOptions(state) {
+    return state.selectedTaskId ? { selectedTaskId: state.selectedTaskId } : {};
+}
+function tuiStateToSnapshotOptions(state, options = {}) {
+    return {
+        ...options,
+        panel: state.activePanel,
+        document: state.documentFile,
+        selectedTaskId: state.selectedTaskId,
+        taskSearch: state.taskSearch,
+        taskSearchActive: state.searchActive,
+        taskListScroll: state.taskListScroll,
+        documentScroll: state.documentScroll
+    };
+}
+function getTaskRows(model) {
+    return [...model.tasks.tasks].reverse();
+}
+function filterTaskRows(tasks, search) {
+    const query = search.trim().toLowerCase();
+    if (!query)
+        return tasks;
+    return tasks.filter((task) => [task.id, task.title, task.status, task.capsule].some((value) => String(value ?? '').toLowerCase().includes(query)));
+}
+function reconcileTaskSelection(state, model, visibleRows) {
+    const rows = getTuiTaskRows(model, state);
+    const index = resolveTaskIndex(rows, state.selectedTaskId);
+    const fallbackIndex = index >= 0 ? index : rows.length ? 0 : -1;
+    const selectedTask = fallbackIndex >= 0 ? rows[fallbackIndex] : null;
+    return {
+        ...state,
+        selectedTaskId: selectedTask?.id ?? null,
+        selectedTaskIndex: fallbackIndex,
+        taskListScroll: normalizeTaskOffset(state.taskListScroll, fallbackIndex, rows.length, visibleRows)
+    };
+}
+function moveTaskSelection(state, model, delta, visibleRows) {
+    const rows = getTuiTaskRows(model, state);
+    if (!rows.length)
+        return { ...state, selectedTaskId: null, selectedTaskIndex: -1, taskListScroll: 0 };
+    const nextIndex = Math.min(rows.length - 1, Math.max(0, state.selectedTaskIndex + delta));
+    return {
+        ...state,
+        selectedTaskId: rows[nextIndex]?.id ?? null,
+        selectedTaskIndex: nextIndex,
+        taskListScroll: normalizeTaskOffset(state.taskListScroll, nextIndex, rows.length, visibleRows)
+    };
+}
+function resolveTaskIndex(tasks, selectedTaskId) {
+    if (selectedTaskId) {
+        const selectedIndex = tasks.findIndex((task) => task.id === selectedTaskId);
+        if (selectedIndex >= 0)
+            return selectedIndex;
+    }
+    return tasks.length ? 0 : -1;
+}
+function normalizeTaskOffset(requestedStart, selectedIndex, rowCount, visibleRows) {
+    if (rowCount <= visibleRows || selectedIndex < 0)
+        return 0;
+    let start = Math.min(Math.max(0, requestedStart), Math.max(0, rowCount - visibleRows));
+    if (selectedIndex < start)
+        start = selectedIndex;
+    if (selectedIndex >= start + visibleRows)
+        start = selectedIndex - visibleRows + 1;
+    return Math.min(Math.max(0, start), Math.max(0, rowCount - visibleRows));
+}
+function normalizeVisibleRows(value) {
+    return Math.max(1, Math.floor(value ?? DEFAULT_TASK_VISIBLE_ROWS));
+}
+function panelForKey(key) {
+    const numeric = Number(key);
+    if (Number.isInteger(numeric) && numeric >= 1 && numeric <= constants_1.TUI_PANEL_IDS.length)
+        return constants_1.TUI_PANEL_IDS[numeric - 1] ?? null;
+    return null;
+}
+function nextPanel(current, delta) {
+    const index = constants_1.TUI_PANEL_IDS.findIndex((panel) => panel === current);
+    return constants_1.TUI_PANEL_IDS[(index + delta + constants_1.TUI_PANEL_IDS.length) % constants_1.TUI_PANEL_IDS.length] ?? current;
+}
+function documentForKey(key) {
+    return constants_1.TUI_DOCUMENT_TABS.find((tab) => tab.key === key || tab.file.toLowerCase() === key || tab.shortLabel.toLowerCase() === key) ?? null;
+}
+function resolvePanel(value, fallback) {
+    const normalized = String(value ?? '').toLowerCase();
+    return constants_1.TUI_PANEL_IDS.find((panel) => panel === normalized) ?? fallback;
+}
+function normalizeKey(key) {
+    if (key.length === 1)
+        return key.toLowerCase();
+    return key.toLowerCase();
+}
+function isSearchCharacter(key) {
+    return typeof key === 'string' && key.length === 1 && key >= ' ' && key !== '\x7f';
+}