helixmind 0.1.0

package/dist/cli/ui/command-suggest.js

@@ -0,0 +1,115 @@
+/**
+ * Intelligent command suggestion engine.
+ * Shows completions as user types slash commands.
+ */
+import chalk from 'chalk';
+const COMMANDS = [
+    { cmd: '/help', description: 'Show all commands' },
+    { cmd: '/clear', description: 'Clear conversation history' },
+    { cmd: '/model', description: 'Switch LLM model' },
+    { cmd: '/keys', description: 'Manage API keys' },
+    { cmd: '/brain', description: 'Brain scope & 3D visualization' },
+    { cmd: '/brain local', description: 'Switch to project-local brain' },
+    { cmd: '/brain global', description: 'Switch to global brain' },
+    { cmd: '/spiral', description: 'Show spiral memory status' },
+    { cmd: '/feed', description: 'Feed files into spiral' },
+    { cmd: '/context', description: 'Show context & embeddings info' },
+    { cmd: '/compact', description: 'Trigger spiral evolution' },
+    { cmd: '/tokens', description: 'Show token usage & memory' },
+    { cmd: '/helix', description: 'Command Center + Brain (auto-start local)' },
+    { cmd: '/helixlocal', description: 'Command Center + Brain (local scope)' },
+    { cmd: '/helixglobal', description: 'Command Center + Brain (global scope)' },
+    { cmd: '/undo', description: 'Undo file changes' },
+    { cmd: '/diff', description: 'Show git diff' },
+    { cmd: '/git', description: 'Show git status' },
+    { cmd: '/project', description: 'Show project info' },
+    { cmd: '/export', description: 'Export spiral as ZIP' },
+    { cmd: '/yolo', description: 'Toggle YOLO mode' },
+    { cmd: '/skip-permissions', description: 'Toggle skip-permissions' },
+    { cmd: '/auto', description: 'Autonomous mode \u2014 find & fix issues' },
+    { cmd: '/stop', description: 'Stop autonomous mode' },
+    { cmd: '/security', description: 'Run security audit (background)' },
+    { cmd: '/sessions', description: 'List all sessions & tabs' },
+    { cmd: '/session close', description: 'Close a session by ID' },
+    { cmd: '/session stop', description: 'Stop a running session' },
+    { cmd: '/local', description: 'Local LLM setup (Ollama)' },
+    { cmd: '/validation', description: 'Validation Matrix status' },
+    { cmd: '/validation on', description: 'Enable output validation' },
+    { cmd: '/validation off', description: 'Disable output validation' },
+    { cmd: '/validation verbose', description: 'Toggle verbose validation' },
+    { cmd: '/validation strict', description: 'Toggle strict mode' },
+    { cmd: '/validation stats', description: 'Show validation statistics' },
+    { cmd: '/login', description: 'Log in to HelixMind web platform' },
+    { cmd: '/logout', description: 'Log out and revoke API key' },
+    { cmd: '/whoami', description: 'Show account & plan info' },
+    { cmd: '/exit', description: 'Exit HelixMind' },
+    { cmd: '/quit', description: 'Exit HelixMind' },
+];
+/**
+ * Get matching command suggestions for a partial input.
+ */
+export function getSuggestions(partial, max = 5) {
+    if (!partial || !partial.startsWith('/') || partial.length < 2)
+        return [];
+    const lower = partial.toLowerCase();
+    // Don't suggest if it's an exact match
+    const exact = COMMANDS.find(c => c.cmd === lower);
+    if (exact)
+        return [];
+    // Prefix match first
+    const prefixed = COMMANDS.filter(c => c.cmd.startsWith(lower));
+    if (prefixed.length > 0)
+        return prefixed.slice(0, max);
+    // Fuzzy: contains the typed chars (without /)
+    const chars = lower.slice(1);
+    const fuzzy = COMMANDS.filter(c => c.cmd.slice(1).includes(chars));
+    return fuzzy.slice(0, max);
+}
+/**
+ * Get the best single suggestion for Tab completion.
+ */
+export function getBestCompletion(partial) {
+    const suggestions = getSuggestions(partial, 1);
+    if (suggestions.length === 0)
+        return null;
+    return suggestions[0].cmd;
+}
+/**
+ * Write command suggestions as overlay above the status bar.
+ * Uses ANSI cursor positioning to avoid disturbing readline.
+ */
+export function writeSuggestions(suggestions) {
+    if (suggestions.length === 0)
+        return;
+    if (!process.stdout.isTTY)
+        return;
+    const termHeight = process.stdout.rows || 24;
+    const count = suggestions.length;
+    // Suggestions go above status bar (last row)
+    const startRow = termHeight - count;
+    process.stdout.write('\x1b7'); // Save cursor
+    for (let i = 0; i < count; i++) {
+        const row = startRow + i;
+        const s = suggestions[i];
+        const text = `  ${chalk.cyan(s.cmd)} ${chalk.dim('\u2014')} ${chalk.dim(s.description)}`;
+        process.stdout.write(`\x1b[${row};0H\x1b[2K${text}`);
+    }
+    process.stdout.write('\x1b8'); // Restore cursor
+}
+/**
+ * Clear previously rendered suggestions.
+ */
+export function clearSuggestions(count) {
+    if (count === 0)
+        return;
+    if (!process.stdout.isTTY)
+        return;
+    const termHeight = process.stdout.rows || 24;
+    const startRow = termHeight - count;
+    process.stdout.write('\x1b7'); // Save cursor
+    for (let i = 0; i < count; i++) {
+        process.stdout.write(`\x1b[${startRow + i};0H\x1b[2K`);
+    }
+    process.stdout.write('\x1b8'); // Restore cursor
+}
+//# sourceMappingURL=command-suggest.js.map

package/dist/cli/ui/command-suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-suggest.js","sourceRoot":"","sources":["../../../src/cli/ui/command-suggest.ts"],"names":[],"mappings":"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"}

package/dist/cli/ui/logo.d.ts

@@ -0,0 +1,3 @@
+export declare function renderLogo(): string;
+export declare function renderVersion(version: string): string;
+//# sourceMappingURL=logo.d.ts.map

package/dist/cli/ui/logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/logo.ts"],"names":[],"mappings":"AAKA,wBAAgB,UAAU,IAAI,MAAM,CAiBnC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/cli/ui/logo.js

@@ -0,0 +1,25 @@
+import figlet from 'figlet';
+import gradient from 'gradient-string';
+const HELIX_GRADIENT = gradient(['#00d4ff', '#4169e1', '#8a2be2']);
+export function renderLogo() {
+    try {
+        const ascii = figlet.textSync('HELIX', {
+            font: 'ANSI Shadow',
+            horizontalLayout: 'default',
+        });
+        const lines = [];
+        lines.push('');
+        lines.push(HELIX_GRADIENT(ascii));
+        lines.push(HELIX_GRADIENT('  ─── Mind ───'));
+        lines.push('');
+        return lines.join('\n');
+    }
+    catch {
+        // Fallback if figlet fails
+        return HELIX_GRADIENT('\n  ╦ ╦╔═╗╦  ╦═╗ ╦\n  ╠═╣║╣ ║  ║╠╦╝ ║\n  ╩ ╩╚═╝╩═╝╩╩╚  ╩  Mind\n');
+    }
+}
+export function renderVersion(version) {
+    return `  ${gradient(['#00d4ff', '#4169e1'])(`v${version}`)}`;
+}
+//# sourceMappingURL=logo.js.map

package/dist/cli/ui/logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logo.js","sourceRoot":"","sources":["../../../src/cli/ui/logo.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAEnE,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE;YACrC,IAAI,EAAE,aAAa;YACnB,gBAAgB,EAAE,SAAS;SAC5B,CAAC,CAAC;QAEH,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;QAC3B,OAAO,cAAc,CAAC,kEAAkE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,CAAC;AAChE,CAAC"}

package/dist/cli/ui/progress.d.ts

@@ -0,0 +1,21 @@
+import type { FeedProgress } from '../feed/pipeline.js';
+export declare function renderFeedProgress(progress: FeedProgress): void;
+export declare function renderFeedSummary(result: {
+    filesScanned: number;
+    filesRead: number;
+    nodesCreated: number;
+    relationsCreated: number;
+    modules: Array<{
+        name: string;
+        files: string[];
+        description: string;
+    }>;
+    architecture: string;
+    techStack: string[];
+    webEnrichment?: {
+        topics: string[];
+        nodesStored: number;
+        duration_ms: number;
+    };
+}): void;
+//# sourceMappingURL=progress.d.ts.map

package/dist/cli/ui/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/progress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAyBxD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAmC/D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,GAAG,IAAI,CAsDP"}

package/dist/cli/ui/progress.js

@@ -0,0 +1,125 @@
+import { theme } from './theme.js';
+import { visibleLength } from './statusbar.js';
+const STAGES = {
+    scanning: 'Scanning',
+    reading: 'Reading',
+    parsing: 'Parsing',
+    analyzing: 'Understanding',
+    spiraling: 'Spiraling',
+    enriching: '\u{1F310} Web Research',
+    done: 'Done',
+};
+const BAR_WIDTH = 20;
+/** Get usable terminal width (with small margin) */
+function termWidth() {
+    return (process.stdout.columns || 80) - 4;
+}
+/** Truncate a plain string to maxLen, adding ellipsis if needed */
+function truncText(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 1) + '\u2026';
+}
+export function renderFeedProgress(progress) {
+    const tw = termWidth();
+    const label = STAGES[progress.stage] ?? progress.stage;
+    const pct = progress.total > 0
+        ? Math.round((progress.current / progress.total) * 100)
+        : 0;
+    const filled = Math.round((pct / 100) * BAR_WIDTH);
+    const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(BAR_WIDTH - filled);
+    let line = `  ${label.padEnd(16)} ${theme.primary(bar)} ${String(pct).padStart(3)}%`;
+    // Calculate remaining space for detail/file info
+    const baseLen = visibleLength(line);
+    const remaining = tw - baseLen;
+    if (remaining > 10 && progress.detail) {
+        const detail = truncText(progress.detail, remaining - 4);
+        line += `  ${theme.dim(detail)}`;
+    }
+    const afterDetail = visibleLength(line);
+    const remaining2 = tw - afterDetail;
+    if (remaining2 > 10 && progress.currentFile) {
+        const file = truncText(progress.currentFile, remaining2 - 4);
+        line += `  ${theme.dim(file)}`;
+    }
+    // Use carriage return to overwrite the line
+    process.stdout.write(`\r\x1b[K${line}`);
+    if (progress.stage === 'done') {
+        process.stdout.write('\n');
+    }
+}
+export function renderFeedSummary(result) {
+    const tw = termWidth();
+    const indent = '  ';
+    const moduleIndent = '     ';
+    process.stdout.write('\n');
+    process.stdout.write(`${theme.accent('\u{1F300}')} ${theme.bold('Feed Complete!')}\n\n`);
+    process.stdout.write(`${indent}${theme.primary('\u{1F4C1}')} Scanned: ${result.filesScanned} files (${result.filesRead} relevant)\n`);
+    process.stdout.write(`${indent}${theme.primary('\u{1F9E0}')} Created: ${result.nodesCreated} context nodes\n`);
+    process.stdout.write(`${indent}${theme.primary('\u{1F517}')} Relations: ${result.relationsCreated} connections\n`);
+    if (result.modules.length > 0) {
+        process.stdout.write(`${indent}${theme.primary('\u{1F4CA}')} Modules detected:\n`);
+        for (let i = 0; i < result.modules.length; i++) {
+            const mod = result.modules[i];
+            const isLast = i === result.modules.length - 1;
+            const prefix = isLast ? '\u2514\u2500' : '\u251C\u2500';
+            // Header line: "├─ moduleName (N files)"
+            const header = `${moduleIndent}${prefix} ${mod.name} (${mod.files.length} files)`;
+            process.stdout.write(`${theme.bold(header)}\n`);
+            // Description parts on separate indented lines, each truncated
+            const descParts = mod.description.split(' \u2014 ').filter(Boolean);
+            const descIndent = moduleIndent + (isLast ? '   ' : '\u2502  ');
+            for (const part of descParts) {
+                // Skip the redundant "N files" part (already in header)
+                if (/^\d+ files$/.test(part.trim()))
+                    continue;
+                const truncated = truncText(part.trim(), tw - descIndent.length);
+                process.stdout.write(`${descIndent}${theme.dim(truncated)}\n`);
+            }
+        }
+    }
+    // Architecture — truncate to fit
+    const archPrefix = `${indent}${theme.primary('\u{1F3D7}\uFE0F')}  Architecture: `;
+    const archText = truncText(result.architecture, tw - 24);
+    process.stdout.write(`${archPrefix}${archText}\n`);
+    // Tech stack — wrap into multiple lines if needed
+    const stackPrefix = `${indent}${theme.primary('\u{1F527}')} Stack: `;
+    const stackPrefixLen = 12; // "  🔧 Stack: " visible length
+    writeWrappedList(result.techStack, stackPrefix, stackPrefixLen, tw, indent + '         ');
+    if (result.webEnrichment && result.webEnrichment.nodesStored > 0) {
+        process.stdout.write(`${indent}${theme.primary('\u{1F310}')} Web Knowledge: +${result.webEnrichment.nodesStored} nodes from internet research\n`);
+        if (result.webEnrichment.topics.length > 0) {
+            const topicText = truncText(result.webEnrichment.topics.join(', '), tw - moduleIndent.length);
+            process.stdout.write(`${moduleIndent}${theme.dim(topicText)}\n`);
+        }
+    }
+    process.stdout.write('\n');
+    process.stdout.write(`${indent}${theme.dim('Your spiral now deeply understands this project.')}\n\n`);
+}
+/** Write a comma-separated list with word-wrapping at terminal width */
+function writeWrappedList(items, prefix, prefixVisibleLen, maxWidth, wrapIndent) {
+    if (items.length === 0) {
+        process.stdout.write(`${prefix}\n`);
+        return;
+    }
+    let line = prefix;
+    let lineLen = prefixVisibleLen;
+    let firstItem = true;
+    for (const item of items) {
+        const separator = firstItem ? '' : ', ';
+        const addition = separator + item;
+        if (!firstItem && lineLen + addition.length > maxWidth) {
+            // Wrap to next line
+            process.stdout.write(`${line}\n`);
+            line = wrapIndent + item;
+            lineLen = wrapIndent.length + item.length;
+        }
+        else {
+            line += addition;
+            lineLen += addition.length;
+        }
+        firstItem = false;
+    }
+    process.stdout.write(`${line}\n`);
+}
+//# sourceMappingURL=progress.js.map

package/dist/cli/ui/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/cli/ui/progress.ts"],"names":[],"mappings":"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"}

package/dist/cli/ui/select-menu.d.ts

@@ -0,0 +1,22 @@
+export interface MenuItem {
+    label: string;
+    description?: string;
+    key?: string;
+    marker?: string;
+    disabled?: boolean;
+}
+export interface SelectMenuOptions {
+    title?: string;
+    cancelLabel?: string;
+    pageSize?: number;
+}
+/**
+ * Interactive arrow-key menu. Returns the selected index or -1 if cancelled.
+ * Works in raw mode — no readline needed.
+ */
+export declare function selectMenu(items: MenuItem[], opts?: SelectMenuOptions): Promise<number>;
+/**
+ * Convenience: show a yes/no confirmation prompt with arrow keys.
+ */
+export declare function confirmMenu(question: string, defaultYes?: boolean): Promise<boolean>;
+//# sourceMappingURL=select-menu.d.ts.map

package/dist/cli/ui/select-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-menu.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/select-menu.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA0JjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAYlF"}

package/dist/cli/ui/select-menu.js

@@ -0,0 +1,152 @@
+import chalk from 'chalk';
+import { theme } from './theme.js';
+/**
+ * Interactive arrow-key menu. Returns the selected index or -1 if cancelled.
+ * Works in raw mode — no readline needed.
+ */
+export function selectMenu(items, opts = {}) {
+    const { title, cancelLabel = 'Back', pageSize = 10 } = opts;
+    const enabledIndices = items.map((item, i) => item.disabled ? -1 : i).filter(i => i >= 0);
+    if (enabledIndices.length === 0)
+        return Promise.resolve(-1);
+    let cursor = enabledIndices[0];
+    let scrollOffset = 0;
+    const visibleCount = Math.min(pageSize, items.length);
+    function render(clear) {
+        if (clear) {
+            // Move cursor up to overwrite previous render
+            const linesToClear = (title ? 1 : 0) + visibleCount + (items.length > visibleCount ? 1 : 0) + 2;
+            process.stdout.write(`\x1b[${linesToClear}A\x1b[J`);
+        }
+        if (title) {
+            process.stdout.write(`  ${theme.bold(title)}\n`);
+        }
+        // Adjust scroll window
+        if (cursor < scrollOffset)
+            scrollOffset = cursor;
+        if (cursor >= scrollOffset + visibleCount)
+            scrollOffset = cursor - visibleCount + 1;
+        for (let vi = 0; vi < visibleCount; vi++) {
+            const i = scrollOffset + vi;
+            if (i >= items.length)
+                break;
+            const item = items[i];
+            const isSelected = i === cursor;
+            const prefix = isSelected ? theme.primary('  ❯ ') : '    ';
+            const label = isSelected ? chalk.white.bold(item.label) : (item.disabled ? chalk.dim(item.label) : item.label);
+            const desc = item.description ? (isSelected ? chalk.white(` — ${item.description}`) : chalk.dim(` — ${item.description}`)) : '';
+            const marker = item.marker ? ` ${item.marker}` : '';
+            const keyHint = item.key ? chalk.dim(` [${item.key}]`) : '';
+            process.stdout.write(`${prefix}${label}${desc}${marker}${keyHint}\n`);
+        }
+        // Scroll indicator
+        if (items.length > visibleCount) {
+            const above = scrollOffset > 0 ? '↑' : ' ';
+            const below = scrollOffset + visibleCount < items.length ? '↓' : ' ';
+            process.stdout.write(chalk.dim(`    ${above} ${scrollOffset + 1}-${Math.min(scrollOffset + visibleCount, items.length)} of ${items.length} ${below}\n`));
+        }
+        process.stdout.write(chalk.dim(`\n  ↑↓ navigate · Enter select · Esc ${cancelLabel}\n`));
+    }
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        const wasRaw = stdin.isRaw;
+        if (stdin.isTTY) {
+            stdin.setRawMode(true);
+        }
+        stdin.resume();
+        let firstRender = true;
+        function draw() {
+            render(!firstRender);
+            firstRender = false;
+        }
+        function cleanup(result) {
+            stdin.removeListener('data', onData);
+            if (stdin.isTTY && wasRaw !== undefined) {
+                stdin.setRawMode(wasRaw);
+            }
+            resolve(result);
+        }
+        function moveCursor(direction) {
+            const currentPos = enabledIndices.indexOf(cursor);
+            if (currentPos === -1)
+                return;
+            const nextPos = currentPos + direction;
+            if (nextPos >= 0 && nextPos < enabledIndices.length) {
+                cursor = enabledIndices[nextPos];
+            }
+        }
+        function onData(data) {
+            const key = data.toString();
+            // ESC (alone)
+            if (key === '\x1b' || key === '\x1b\x1b') {
+                cleanup(-1);
+                return;
+            }
+            // Ctrl+C
+            if (key === '\x03') {
+                cleanup(-1);
+                return;
+            }
+            // Enter
+            if (key === '\r' || key === '\n') {
+                cleanup(cursor);
+                return;
+            }
+            // Arrow up
+            if (key === '\x1b[A') {
+                moveCursor(-1);
+                draw();
+                return;
+            }
+            // Arrow down
+            if (key === '\x1b[B') {
+                moveCursor(1);
+                draw();
+                return;
+            }
+            // Home / Page Up
+            if (key === '\x1b[H' || key === '\x1b[5~') {
+                cursor = enabledIndices[0];
+                draw();
+                return;
+            }
+            // End / Page Down
+            if (key === '\x1b[F' || key === '\x1b[6~') {
+                cursor = enabledIndices[enabledIndices.length - 1];
+                draw();
+                return;
+            }
+            // Shortcut key match
+            const char = key.toLowerCase();
+            if (char.length === 1) {
+                const matchIdx = items.findIndex((item) => !item.disabled && item.key === char);
+                if (matchIdx >= 0) {
+                    cleanup(matchIdx);
+                    return;
+                }
+            }
+            // 'q' as cancel shortcut
+            if (char === 'q') {
+                cleanup(-1);
+                return;
+            }
+        }
+        stdin.on('data', onData);
+        draw();
+    });
+}
+/**
+ * Convenience: show a yes/no confirmation prompt with arrow keys.
+ */
+export function confirmMenu(question, defaultYes = false) {
+    process.stdout.write(`\n  ${question}\n`);
+    return selectMenu([
+        { label: 'Yes' },
+        { label: 'No' },
+    ], { cancelLabel: 'Cancel' }).then((idx) => {
+        if (idx === -1)
+            return false;
+        return idx === 0;
+    });
+}
+//# sourceMappingURL=select-menu.js.map

package/dist/cli/ui/select-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-menu.js","sourceRoot":"","sources":["../../../src/cli/ui/select-menu.ts"],"names":[],"mappings":"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"}

package/dist/cli/ui/spinner.d.ts

@@ -0,0 +1,3 @@
+export declare function createThinkingSpinner(): import("nanospinner").Spinner;
+export declare function createLoadingSpinner(text: string): import("nanospinner").Spinner;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/cli/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/spinner.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,kCAMpC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,iCAIhD"}

package/dist/cli/ui/spinner.js

@@ -0,0 +1,14 @@
+import { createSpinner } from 'nanospinner';
+export function createThinkingSpinner() {
+    return createSpinner('Thinking...', {
+        color: 'cyan',
+        frames: ['◐', '◓', '◑', '◒'],
+        interval: 100,
+    });
+}
+export function createLoadingSpinner(text) {
+    return createSpinner(text, {
+        color: 'cyan',
+    });
+}
+//# sourceMappingURL=spinner.js.map

package/dist/cli/ui/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../../src/cli/ui/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,UAAU,qBAAqB;IACnC,OAAO,aAAa,CAAC,aAAa,EAAE;QAClC,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;QAC5B,QAAQ,EAAE,GAAG;KACd,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,aAAa,CAAC,IAAI,EAAE;QACzB,KAAK,EAAE,MAAM;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/ui/statusbar.d.ts

@@ -0,0 +1,65 @@
+export interface StatusBarData {
+    spiral: {
+        l1: number;
+        l2: number;
+        l3: number;
+        l4: number;
+        l5: number;
+        l6: number;
+    };
+    sessionTokens: number;
+    tokens: {
+        thisMessage: number;
+        thisSession: number;
+    };
+    tools: {
+        callsThisRound: number;
+    };
+    model: string;
+    git: {
+        branch: string;
+        uncommitted: number;
+    };
+    checkpoints?: number;
+    permissionMode?: 'safe' | 'skip' | 'yolo';
+    autonomous?: boolean;
+    paused?: boolean;
+    plan?: string;
+}
+/**
+ * Render the statusbar string (single line, colored).
+ * Truncates to maxWidth to prevent line wrapping in the terminal.
+ */
+export declare function renderStatusBar(data: StatusBarData, maxWidth?: number): string;
+/**
+ * Write the statusbar to the bottom of the terminal.
+ * Layout (from bottom):
+ *   row N   = statusbar (spiral counts, tokens, model, git)
+ *   row N-1 = hint line (permission mode · shortcuts)
+ *   row N-2 = lower input frame line └───┘
+ * The upper frame line ┌───┐ + prompt │ ❯ are handled by readline (prompt string).
+ */
+/**
+ * Pin statusbar to the bottom row of the terminal.
+ * Uses save/restore cursor so the caller's cursor position is preserved.
+ * Only draws 1 row (the status bar) — separator + hint are drawn inline by showPrompt().
+ */
+export declare function writeStatusBar(data: StatusBarData): void;
+/**
+ * Write status info as normal inline text (scrolls with content).
+ * Safe to call while readline is active — no cursor jumping.
+ * Shows: hint line + status bar as two regular lines.
+ */
+export declare function writeStatusInline(data: StatusBarData): void;
+/**
+ * Get current git info (branch + uncommitted count).
+ */
+export declare function getGitInfo(projectRoot: string): {
+    branch: string;
+    uncommitted: number;
+};
+/** Strip ANSI escape codes to measure visible string width */
+export declare function visibleLength(str: string): number;
+/** Truncate a styled string to fit within maxWidth visible characters */
+export declare function truncateBar(bar: string, maxWidth: number): string;
+//# sourceMappingURL=statusbar.d.ts.map

package/dist/cli/ui/statusbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusbar.d.ts","sourceRoot":"","sources":["../../../src/cli/ui/statusbar.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,EAAE;QACL,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA4F9E;AAED;;;;;;;GAOG;AACH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAaxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAc3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAavF;AAqFD,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBjE"}