@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/ui/subagent-renderer.js

@@ -20,6 +20,7 @@
  */
 import { getStyles } from '../themes/index.js';
 import { debugRender } from '../utils/debug-log.js';
+import { formatTokens, truncate } from './base/index.js';
 // =============================================================================
 // Formatting Helpers
 // =============================================================================
@@ -35,29 +36,12 @@ function formatDuration(ms) {
     const remainingSeconds = Math.floor(seconds % 60);
     return `${String(minutes)}m ${String(remainingSeconds)}s`;
 }
-/**
- * Format token count (e.g., "18.1k", "500")
- */
-function formatTokens(tokens) {
-    if (tokens >= 1000) {
-        return `${(tokens / 1000).toFixed(1)}k`;
-    }
-    return tokens.toString();
-}
 /**
  * Capitalize first letter
  */
 function capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1);
 }
-/**
- * Truncate string to max length with ellipsis
- */
-function truncate(str, maxLen) {
-    if (str.length <= maxLen)
-        return str;
-    return str.slice(0, maxLen - 1) + '…';
-}
 // =============================================================================
 // Tree Characters (Unicode box drawing)
 // =============================================================================
@@ -264,7 +248,7 @@ export class SubagentRenderer {
             if (agent.toolCount > 1) {
                 lines.push(s.muted(`     +${String(agent.toolCount - 1)} more tool uses (ctrl+o to expand)`));
             }
-            lines.push(s.muted('     ctrl+b to run in background'));
+            // ctrl+b background: coming soon
         }
         return lines;
     }
@@ -317,7 +301,7 @@ export class SubagentRenderer {
         }
         // Footer hint for running agents
         if (counts.running > 0) {
-            lines.push(s.muted('     ctrl+b to run in background'));
+            // ctrl+b background: coming soon
         }
         return lines;
     }

package/dist/ui/terminal-autocomplete-utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Standalone utility functions for input text formatting and autocomplete.
+ *
+ * Extracted from terminal-ui.ts for modularity.
+ * These are pure functions with no class dependencies.
+ */
+import type { CommandOption } from './types.js';
+/**
+ * Format input text with syntax highlighting for special prefixes.
+ * - $agent references: bold + secondary color
+ * - @path references: secondary color
+ * - /commands: primary color
+ */
+export declare function formatInputText(text: string): string;
+/**
+ * Calculate fuzzy match score for a query against a target string.
+ * Higher score = better match. Returns -1 if no match.
+ */
+export declare function fuzzyMatchScore(query: string, target: string): number;
+/**
+ * Filter and rank commands matching input using fuzzy matching
+ */
+export declare function filterCommands(input: string, commands: CommandOption[]): CommandOption[];

package/dist/ui/terminal-autocomplete-utils.js

@@ -0,0 +1,83 @@
+/**
+ * Standalone utility functions for input text formatting and autocomplete.
+ *
+ * Extracted from terminal-ui.ts for modularity.
+ * These are pure functions with no class dependencies.
+ */
+import { Chalk } from 'chalk';
+import { getStyles } from '../themes/index.js';
+// Force color output (level 3 = 24-bit true color)
+const chalk = new Chalk({ level: 3 });
+// =============================================================================
+// Input Text Formatting
+// =============================================================================
+/**
+ * Format input text with syntax highlighting for special prefixes.
+ * - $agent references: bold + secondary color
+ * - @path references: secondary color
+ * - /commands: primary color
+ */
+export function formatInputText(text) {
+    const s = getStyles();
+    let result = text;
+    // Format $agent references - bold + secondary
+    // Match $word at word boundaries (not inside other text)
+    result = result.replace(/(?<![$\w])\$([a-zA-Z_][a-zA-Z0-9_]*)\b/g, (_match, agentId) => chalk.bold(s.secondary(`$${agentId}`)));
+    // Format @path references - secondary (not bold, paths can be long)
+    // Match @word or @path/to/file patterns
+    result = result.replace(/(?<![@\w])@([\w./-]+)/g, (_match, path) => s.secondary(`@${path}`));
+    // Format /commands at start of input - primary color
+    // Only match at start of line (after optional whitespace)
+    result = result.replace(/^(\s*)(\/[a-zA-Z][a-zA-Z0-9_-]*)/g, (_match, space, cmd) => space + s.primary(cmd));
+    return result;
+}
+// =============================================================================
+// Fuzzy Matching
+// =============================================================================
+/**
+ * Calculate fuzzy match score for a query against a target string.
+ * Higher score = better match. Returns -1 if no match.
+ */
+export function fuzzyMatchScore(query, target) {
+    const queryLower = query.toLowerCase();
+    const targetLower = target.toLowerCase();
+    // Exact prefix match - highest priority (score 1000+)
+    if (targetLower.startsWith(queryLower)) {
+        return 1000 + (100 - target.length); // Shorter commands rank higher
+    }
+    // Contiguous substring match - high priority (score 500+)
+    if (targetLower.includes(queryLower)) {
+        const index = targetLower.indexOf(queryLower);
+        return 500 + (100 - index); // Earlier matches rank higher
+    }
+    // Fuzzy match - characters appear in order (score 100+)
+    let queryIdx = 0;
+    let consecutiveBonus = 0;
+    let lastMatchIdx = -1;
+    for (let i = 0; i < targetLower.length && queryIdx < queryLower.length; i++) {
+        if (targetLower[i] === queryLower[queryIdx]) {
+            if (lastMatchIdx === i - 1) {
+                consecutiveBonus += 10;
+            }
+            lastMatchIdx = i;
+            queryIdx++;
+        }
+    }
+    if (queryIdx === queryLower.length) {
+        return 100 + consecutiveBonus + (100 - target.length);
+    }
+    return -1;
+}
+/**
+ * Filter and rank commands matching input using fuzzy matching
+ */
+export function filterCommands(input, commands) {
+    const scored = commands
+        .map((cmd) => ({
+        cmd,
+        score: fuzzyMatchScore(input, cmd.command),
+    }))
+        .filter((item) => item.score >= 0);
+    scored.sort((a, b) => b.score - a.score);
+    return scored.map((item) => item.cmd);
+}

package/dist/ui/terminal-line-builders.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Pure line-building utility functions for TerminalUI.
+ *
+ * Extracted from terminal-ui.ts for modularity.
+ * These are pure functions with no class dependencies.
+ */
+import type { TodoItem } from './types.js';
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ * e.g. 5000 → "5s", 90000 → "1m 30s"
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Build a single todo line with task number prefix, icon, content,
+ * optional owner badge, and blocked-by suffix.
+ */
+export declare function buildTodoLine(todo: TodoItem, taskNumber?: number): string;

package/dist/ui/terminal-line-builders.js

@@ -0,0 +1,42 @@
+/**
+ * Pure line-building utility functions for TerminalUI.
+ *
+ * Extracted from terminal-ui.ts for modularity.
+ * These are pure functions with no class dependencies.
+ */
+import { getStyles } from '../themes/index.js';
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ * e.g. 5000 → "5s", 90000 → "1m 30s"
+ */
+export function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60) {
+        return `${String(seconds)}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return `${String(minutes)}m ${String(remainingSeconds)}s`;
+}
+/**
+ * Build a single todo line with task number prefix, icon, content,
+ * optional owner badge, and blocked-by suffix.
+ */
+export function buildTodoLine(todo, taskNumber) {
+    const s = getStyles();
+    const icon = todo.status === 'completed' ? '✓' :
+        todo.status === 'in_progress' ? '→' : '☐';
+    const style = todo.status === 'completed' ? s.muted :
+        todo.status === 'in_progress' ? s.info : s.muted;
+    // Task number prefix (e.g., "#1 ")
+    const prefix = taskNumber != null ? `#${String(taskNumber)} ` : '';
+    // Owner badge (skip for completed items)
+    const ownerBadge = todo.owner && todo.status !== 'completed'
+        ? s.muted(` @${todo.owner}`)
+        : '';
+    // Blocked-by suffix (skip for completed items)
+    const blockedSuffix = todo.blockedBy && todo.blockedBy.length > 0 && todo.status !== 'completed'
+        ? s.muted(` › blocked by ${todo.blockedBy.map((n) => `#${String(n)}`).join(', ')}`)
+        : '';
+    return style(`${prefix}${icon} ${todo.content}`) + ownerBadge + blockedSuffix;
+}

package/dist/ui/terminal-render-item.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Render a single PrintableItem to the console.
+ *
+ * Extracted from terminal-ui.ts for modularity.
+ * This is a nearly-pure function — the only side effect is console.log output.
+ * The 'interrupted' case returns a suggestion string instead of calling setSuggestion().
+ */
+import type { PrintableItem, TerminalUIConfig } from './terminal-types.js';
+/**
+ * Render a single item to the console.
+ * Config-aware: respects verbose, showMascot settings.
+ *
+ * @returns suggestion string for 'interrupted' items, null otherwise.
+ *          Caller should pass the suggestion to setSuggestion() if non-null.
+ */
+export declare function renderItem(item: PrintableItem, config: TerminalUIConfig): string | null;

package/dist/ui/terminal-render-item.js

@@ -0,0 +1,267 @@
+/**
+ * Render a single PrintableItem to the console.
+ *
+ * Extracted from terminal-ui.ts for modularity.
+ * This is a nearly-pure function — the only side effect is console.log output.
+ * The 'interrupted' case returns a suggestion string instead of calling setSuggestion().
+ */
+import * as terminal from './terminal.js';
+import { getStyles } from '../themes/index.js';
+import { renderMarkdown } from './conversation.js';
+import { MASCOT } from './terminal-types.js';
+/**
+ * Render a single item to the console.
+ * Config-aware: respects verbose, showMascot settings.
+ *
+ * @returns suggestion string for 'interrupted' items, null otherwise.
+ *          Caller should pass the suggestion to setSuggestion() if non-null.
+ */
+export function renderItem(item, config) {
+    const s = getStyles();
+    switch (item.type) {
+        case 'user-message':
+            console.log('');
+            console.log(s.primaryBold('> ') + item.text);
+            console.log(''); // Trailing blank for separation
+            break;
+        case 'agent-text': {
+            // Render markdown for proper formatting (headers, lists, bold, code, etc.)
+            const rendered = renderMarkdown(item.text);
+            // Prefix agent messages with mascot expression (if enabled)
+            if (config.showMascot) {
+                // Expression can be a key ('success', 'neutral') or a direct mascot string ('[◈_◈]')
+                let expr;
+                if (!item.expression) {
+                    expr = MASCOT.neutral;
+                }
+                else if (item.expression.startsWith('[')) {
+                    // Direct mascot string from team agent
+                    expr = item.expression;
+                }
+                else if (item.expression in MASCOT) {
+                    // Key lookup in MASCOT object
+                    expr = MASCOT[item.expression];
+                }
+                else {
+                    // Unknown expression key, use neutral
+                    expr = MASCOT.neutral;
+                }
+                // Only prefix the first line with mascot
+                const lines = rendered.split('\n');
+                if (lines.length > 0) {
+                    console.log(s.primary(expr) + s.muted(' > ') + lines[0]);
+                    for (let i = 1; i < lines.length; i++) {
+                        console.log(lines[i]);
+                    }
+                }
+            }
+            else {
+                console.log(rendered);
+            }
+            console.log(''); // Trailing blank for separation
+            break;
+        }
+        case 'thinking':
+            // Only show thinking in verbose mode
+            if (config.verbose) {
+                console.log(s.muted(`∴ Thinking…`));
+                console.log('');
+                // Indent thinking text
+                const lines = item.text.split('\n');
+                for (const line of lines) {
+                    console.log(s.muted(`  ${line}`));
+                }
+                console.log('');
+            }
+            // If not verbose, skip entirely (but still stored in history)
+            break;
+        case 'tool-start': {
+            // Truncate long params (e.g., long bash commands)
+            const maxLen = Math.min(60, terminal.getTerminalWidth() - 15);
+            let params = item.params;
+            // Handle multi-line params
+            const nlIdx = params.indexOf('\n');
+            if (nlIdx !== -1) {
+                const first = params.slice(0, nlIdx).trim();
+                const count = params.split('\n').length;
+                params = first.length > 0 ? `${first}… (${String(count)} lines)` : `(${String(count)} line script)`;
+            }
+            // Truncate if still too long
+            if (params.length > maxLen) {
+                params = params.slice(0, maxLen) + '…';
+            }
+            console.log(s.info(`● ${item.name}`) + s.muted(`(${params})`));
+            break;
+        }
+        case 'tool-result': {
+            // Truncate long params (e.g., long bash commands)
+            const maxParamsLen = Math.min(60, terminal.getTerminalWidth() - 15);
+            let paramsDisplay = item.params;
+            // Handle multi-line params (show first line + count)
+            const newlineIdx = paramsDisplay.indexOf('\n');
+            if (newlineIdx !== -1) {
+                const firstLine = paramsDisplay.slice(0, newlineIdx).trim();
+                const lineCount = paramsDisplay.split('\n').length;
+                paramsDisplay = firstLine.length > 0
+                    ? `${firstLine}… (${String(lineCount)} lines)`
+                    : `(${String(lineCount)} line script)`;
+            }
+            // Truncate if still too long
+            if (paramsDisplay.length > maxParamsLen) {
+                paramsDisplay = paramsDisplay.slice(0, maxParamsLen) + '…';
+            }
+            console.log(s.info(`● ${item.name}`) + s.muted(`(${paramsDisplay})`));
+            // Diff lines: render directly (already ANSI-formatted by diff.ts)
+            if (item.diffLines && item.diffLines.length > 0) {
+                const maxDiffPreview = 10;
+                if (config.verbose || item.diffLines.length <= maxDiffPreview) {
+                    for (const line of item.diffLines) {
+                        console.log(`     ${line}`);
+                    }
+                }
+                else {
+                    for (let i = 0; i < maxDiffPreview; i++) {
+                        console.log(`     ${item.diffLines[i]}`);
+                    }
+                    const hidden = item.diffLines.length - maxDiffPreview;
+                    console.log(s.muted(`     … +${String(hidden)} lines (ctrl+o to expand)`));
+                }
+            }
+            else if (item.content) {
+                const contentLines = item.content.split('\n').filter((l) => l.length > 0);
+                const maxPreviewLines = 3;
+                if (config.verbose) {
+                    // Verbose: show all lines
+                    for (const line of contentLines) {
+                        console.log(s.muted(`  ⎿  ${line}`));
+                    }
+                }
+                else if (contentLines.length > 0) {
+                    // Compact: show first few lines + hidden count
+                    const previewLines = contentLines.slice(0, maxPreviewLines);
+                    const hiddenCount = contentLines.length - maxPreviewLines;
+                    for (let i = 0; i < previewLines.length; i++) {
+                        if (i === 0) {
+                            console.log(s.muted(`  ⎿  ${previewLines[i]}`));
+                        }
+                        else {
+                            console.log(s.muted(`     ${previewLines[i]}`));
+                        }
+                    }
+                    if (hiddenCount > 0) {
+                        console.log(s.muted(`     … +${String(hiddenCount)} lines`) + s.muted(' (ctrl+o to expand)'));
+                    }
+                }
+                else {
+                    // No output lines
+                    const expandHint = s.muted(' (ctrl+o to expand)');
+                    if (item.success === false) {
+                        console.log(s.error(`  ⎿  ${item.summary}`) + expandHint);
+                    }
+                    else {
+                        console.log(s.muted(`  ⎿  ${item.summary}`) + expandHint);
+                    }
+                }
+            }
+            else {
+                // No content, just show summary
+                if (item.success === false) {
+                    console.log(s.error(`  ⎿  ${item.summary}`));
+                }
+                else {
+                    console.log(s.muted(`  ⎿  ${item.summary}`));
+                }
+            }
+            console.log('');
+            break;
+        }
+        case 'tool-error': {
+            // Truncate long params
+            const maxErrLen = Math.min(60, terminal.getTerminalWidth() - 15);
+            let errParams = item.params;
+            const errNlIdx = errParams.indexOf('\n');
+            if (errNlIdx !== -1) {
+                const errFirst = errParams.slice(0, errNlIdx).trim();
+                const errCount = errParams.split('\n').length;
+                errParams = errFirst.length > 0 ? `${errFirst}… (${String(errCount)} lines)` : `(${String(errCount)} line script)`;
+            }
+            if (errParams.length > maxErrLen) {
+                errParams = errParams.slice(0, maxErrLen) + '…';
+            }
+            console.log(s.info(`● ${item.name}`) + s.muted(`(${errParams})`));
+            console.log(s.error(`  ⎿  Error: ${item.error}`));
+            console.log('');
+            break;
+        }
+        case 'interrupted': {
+            // Show what was ongoing (if provided)
+            if (item.action) {
+                console.log(s.info(`● ${item.action}`));
+            }
+            else {
+                // No action means interrupted right after user message.
+                // Move cursor up to consume the trailing blank from user-message.
+                //
+                // ⚠️ WARNING: This cursor manipulation is fragile!
+                // It assumes the previous item was user-message which adds a trailing blank.
+                // If we add items that don't add trailing blanks, or if the rendering
+                // order changes, this could cause visual artifacts (overwriting content).
+                // If issues arise, consider tracking the last printed item type instead.
+                process.stdout.write('\x1b[1A'); // Move up one line
+            }
+            // Show interrupted line with mascot
+            const suggestion = item.suggestion ?? 'What should I do instead?';
+            console.log(s.warning(`  ⎿  ${MASCOT.confused} Interrupted - ${suggestion}`));
+            console.log('');
+            // Return suggestion so caller can set it as ghost text
+            return suggestion;
+        }
+        case 'error':
+            console.log(s.error(`${MASCOT.error} ${item.message}`));
+            console.log('');
+            break;
+        case 'success':
+            console.log(s.success(`${MASCOT.success} ${item.message}`));
+            console.log('');
+            break;
+        case 'info':
+            console.log(s.info(item.message));
+            console.log('');
+            break;
+        case 'warning':
+            console.log(s.warning(item.message));
+            console.log('');
+            break;
+        case 'turn-summary': {
+            // Compact summary line: ── 45s · ↓ 2.3k ↑ 1.1k · 5 tools ──
+            const line = s.muted(`── ${item.parts.join(' · ')} ──`);
+            console.log(line);
+            console.log('');
+            break;
+        }
+        case 'raw':
+            console.log(item.text);
+            break;
+        case 'raw-lines':
+            for (const line of item.lines) {
+                console.log(line);
+            }
+            break;
+        case 'background-agent': {
+            // Background agent output with mascot label
+            // Format: [◈_◈] $arch: text - mascot followed by agent reference
+            const bgLabel = s.muted(`${item.mascot} $${item.agentId}:`);
+            // Render markdown for proper formatting
+            const bgRendered = renderMarkdown(item.text);
+            const bgLines = bgRendered.split('\n');
+            if (bgLines.length > 0) {
+                console.log(`${bgLabel} ${bgLines[0]}`);
+                for (let i = 1; i < bgLines.length; i++) {
+                    console.log(bgLines[i]);
+                }
+            }
+            break;
+        }
+    }
+    return null;
+}

package/dist/ui/terminal-renderer.d.ts

@@ -1,16 +1,15 @@
 /**
+ * @deprecated DEAD CODE — This class is never instantiated. Do NOT modify this file.
+ *
+ * The active render pipeline is in TerminalUI (src/ui/terminal-ui.ts).
+ * TerminalUI handles all rendering, keyboard input, overlays, and footer display.
+ * All UI changes should go there.
+ *
+ * --- Original description ---
  * Terminal Renderer
  *
  * Single point of terminal output. All rendering goes through this class.
  * Eliminates race conditions by ensuring only one writer.
- *
- * Key responsibilities:
- * - Manage render modes (MENU, REPL, OVERLAY)
- * - Set up and manage scroll regions (REPL mode)
- * - Collect content from providers
- * - Write to terminal (single writer)
- * - Handle resize events
- * - Route keyboard input
  */
 import { EventEmitter } from 'events';
 import { RenderMode, type ModeTransition } from './render-modes.js';

package/dist/ui/terminal-renderer.js

@@ -1,16 +1,15 @@
 /**
+ * @deprecated DEAD CODE — This class is never instantiated. Do NOT modify this file.
+ *
+ * The active render pipeline is in TerminalUI (src/ui/terminal-ui.ts).
+ * TerminalUI handles all rendering, keyboard input, overlays, and footer display.
+ * All UI changes should go there.
+ *
+ * --- Original description ---
  * Terminal Renderer
  *
  * Single point of terminal output. All rendering goes through this class.
  * Eliminates race conditions by ensuring only one writer.
- *
- * Key responsibilities:
- * - Manage render modes (MENU, REPL, OVERLAY)
- * - Set up and manage scroll regions (REPL mode)
- * - Collect content from providers
- * - Write to terminal (single writer)
- * - Handle resize events
- * - Route keyboard input
  */
 import { EventEmitter } from 'events';
 import { RenderMode, isValidTransition } from './render-modes.js';