@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/ui/projects-overlay.js

@@ -0,0 +1,484 @@
+/**
+ * Projects Overlay
+ *
+ * Interactive overlay for viewing and managing projects.
+ * Uses TabbedListOverlay for consistent tabbed list behavior.
+ *
+ * Features:
+ * - Tabbed filtering by status (All, Active, Paused, Completed, Archived)
+ * - Paginated list with search
+ * - Project detail preview
+ * - Archive/Restore workflow
+ * - Delete workflow with path validation
+ * - Keyboard navigation (vim-style + arrows)
+ */
+import * as fs from 'fs';
+import * as terminal from './terminal.js';
+import { TabbedListOverlay, BaseScreen, stay, popScreen, closeOverlay, isEnter, isCtrlC, isEscape, isBackspace, isClose, renderBorder, } from './base/index.js';
+import { projectRepository, workItemRepository } from '../db/repositories/index.js';
+import { clearActiveProject, getActiveProject } from '../tools/project-db.js';
+import { validateDeletePath } from '../utils/path-safety.js';
+import { getAllowedDeletePaths } from '../settings/paths.js';
+import { clearProjectAnchors } from '../anchors/index.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const PAGE_SIZE = 10;
+const TABS = [
+    { id: 'all', label: 'All' },
+    { id: 'active', label: 'Active' },
+    { id: 'paused', label: 'Paused' },
+    { id: 'completed', label: 'Complete' },
+    { id: 'archived', label: 'Archived' },
+];
+const STATUS_ICONS = {
+    active: '●',
+    paused: '◐',
+    completed: '✓',
+    archived: '◌',
+};
+const STATUS_LABELS = {
+    active: 'Active',
+    paused: 'Paused',
+    completed: 'Complete',
+    archived: 'Archived',
+};
+// =============================================================================
+// Helper Functions
+// =============================================================================
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 3) + '...';
+}
+function renderProgressBar(percent, width, s) {
+    const filled = Math.round((percent / 100) * width);
+    const empty = width - filled;
+    return s.primary('█'.repeat(filled)) + s.muted('░'.repeat(empty));
+}
+// =============================================================================
+// Archive Confirm Screen
+// =============================================================================
+class ArchiveConfirmScreen extends BaseScreen {
+    confirmState;
+    styles;
+    onComplete;
+    constructor(confirmState, styles, onComplete) {
+        super();
+        this.confirmState = confirmState;
+        this.styles = styles;
+        this.onComplete = onComplete;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const project = this.confirmState.targetProject;
+        const lines = [];
+        if (!project) {
+            lines.push(border);
+            lines.push(s.error('  No project selected'));
+            lines.push(border);
+            return lines;
+        }
+        const isArchived = project.status === 'archived';
+        const action = isArchived ? 'RESTORE' : 'ARCHIVE';
+        lines.push(border);
+        lines.push(`  ${s.primaryBold(action + ' PROJECT')}`);
+        lines.push('');
+        if (isArchived) {
+            lines.push(`  ${s.foreground('Restore this project?')}`);
+            lines.push('');
+            lines.push(s.muted('  Project: ') + project.displayName);
+            lines.push('');
+            lines.push(s.foreground('  The project will be marked as "active" and visible again.'));
+        }
+        else {
+            lines.push(`  ${s.warning('Archive this project?')}`);
+            lines.push('');
+            lines.push(s.muted('  Project: ') + project.displayName);
+            lines.push('');
+            lines.push(s.foreground('  The project will be hidden from the active view.'));
+            lines.push(s.foreground('  You can restore it later from the Archived tab.'));
+        }
+        lines.push('');
+        lines.push(border);
+        lines.push(s.muted('  Enter Confirm · Esc Cancel'));
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        if (isCtrlC(data)) {
+            return closeOverlay({ action: 'cancel' });
+        }
+        if (isEscape(data)) {
+            this.confirmState.targetProject = null;
+            return popScreen();
+        }
+        if (isEnter(data)) {
+            const project = this.confirmState.targetProject;
+            if (!project)
+                return popScreen();
+            const isArchived = project.status === 'archived';
+            const newStatus = isArchived ? 'active' : 'archived';
+            projectRepository.update(project.id, { status: newStatus });
+            // Clear as active if archiving the active project
+            if (!isArchived && getActiveProject()?.id === project.id) {
+                clearActiveProject();
+            }
+            this.onComplete();
+            this.confirmState.targetProject = null;
+            return popScreen();
+        }
+        return stay(false);
+    }
+}
+// =============================================================================
+// Delete Confirm Screen
+// =============================================================================
+class DeleteConfirmScreen extends BaseScreen {
+    confirmState;
+    styles;
+    onComplete;
+    constructor(confirmState, styles, onComplete) {
+        super();
+        this.confirmState = confirmState;
+        this.styles = styles;
+        this.onComplete = onComplete;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const project = this.confirmState.targetProject;
+        const validation = this.confirmState.deleteValidation;
+        const lines = [];
+        if (!project) {
+            lines.push(border);
+            lines.push(s.error('  No project selected'));
+            lines.push(border);
+            return lines;
+        }
+        lines.push(border);
+        lines.push(`  ${s.error('DELETE PROJECT')}`);
+        lines.push('');
+        // If validation failed, show error state
+        if (validation && !validation.valid) {
+            lines.push(s.error('  CANNOT DELETE: Path validation failed'));
+            lines.push('');
+            lines.push(s.muted('  Project: ') + project.displayName);
+            lines.push(s.muted('  Path:    ') + project.path);
+            lines.push('');
+            lines.push(s.error(`  Error: ${validation.reason || 'Unknown error'}`));
+            lines.push('');
+            lines.push(s.foreground('  Allowed directories:'));
+            for (const allowed of getAllowedDeletePaths()) {
+                lines.push(s.muted(`    • ${allowed}`));
+            }
+            lines.push('');
+            lines.push(s.foreground('  Options:'));
+            lines.push(s.muted('    1. Move the project to an allowed directory'));
+            lines.push(s.muted('    2. Add path to allowedPaths in /config'));
+            lines.push(s.muted('    3. Delete files manually and remove from database only'));
+            lines.push('');
+            lines.push(border);
+            lines.push(s.muted('  Esc Back'));
+            lines.push(border);
+            return lines;
+        }
+        lines.push(s.warning('  WARNING: This action cannot be undone!'));
+        lines.push('');
+        lines.push(s.muted('  Project: ') + project.displayName);
+        lines.push(s.muted('  Name:    ') + project.name);
+        lines.push(s.muted('  Path:    ') + project.path);
+        lines.push('');
+        // Show validation status
+        if (validation && validation.valid) {
+            if (fs.existsSync(project.path + '/.compilr')) {
+                lines.push(s.success('  ✓ Path is within allowed directory'));
+                lines.push(s.success('  ✓ Project has .compilr marker'));
+            }
+            else if (fs.existsSync(project.path + '/.git')) {
+                lines.push(s.success('  ✓ Path is within allowed directory'));
+                lines.push(s.success('  ✓ Project has .git repository'));
+            }
+            else if (fs.existsSync(project.path + '/package.json')) {
+                lines.push(s.success('  ✓ Path is within allowed directory'));
+                lines.push(s.success('  ✓ Project has package.json'));
+            }
+            else {
+                lines.push(s.success('  ✓ Path is within allowed directory'));
+            }
+            if (validation.warnings && validation.warnings.length > 0) {
+                lines.push('');
+                for (const warning of validation.warnings) {
+                    lines.push(s.warning(`  ⚠ ${warning}`));
+                }
+            }
+            lines.push('');
+        }
+        lines.push(s.foreground('  This will permanently delete:'));
+        lines.push(s.muted('    • Database record (project, work items, documents)'));
+        lines.push(s.muted('    • Project files on disk'));
+        if (project.status !== 'archived') {
+            lines.push('');
+            lines.push(s.warning('  Note: Project will be archived first, then deleted.'));
+        }
+        lines.push('');
+        lines.push(s.muted('  ' + '─'.repeat(cols - 4)));
+        lines.push('');
+        lines.push(s.foreground('  Type the project name to confirm deletion:'));
+        lines.push('');
+        lines.push(`  > ${this.confirmState.deleteConfirmInput}█`);
+        if (this.confirmState.deleteError) {
+            lines.push('');
+            lines.push(s.error(`  ${this.confirmState.deleteError}`));
+        }
+        lines.push('');
+        lines.push(border);
+        lines.push(s.muted('  Enter Confirm · Esc Cancel'));
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        const char = data.length === 1 && data[0] >= 0x20 && data[0] < 0x7f
+            ? String.fromCharCode(data[0])
+            : null;
+        if (isCtrlC(data)) {
+            return closeOverlay({ action: 'cancel' });
+        }
+        if (isEscape(data)) {
+            this.confirmState.targetProject = null;
+            this.confirmState.deleteConfirmInput = '';
+            this.confirmState.deleteError = null;
+            this.confirmState.deleteValidation = null;
+            return popScreen();
+        }
+        if (isBackspace(data)) {
+            this.confirmState.deleteConfirmInput = this.confirmState.deleteConfirmInput.slice(0, -1);
+            this.confirmState.deleteError = null;
+            return stay();
+        }
+        if (char) {
+            this.confirmState.deleteConfirmInput += char;
+            this.confirmState.deleteError = null;
+            return stay();
+        }
+        if (isEnter(data)) {
+            const project = this.confirmState.targetProject;
+            if (!project)
+                return popScreen();
+            // If validation failed, don't allow Enter to proceed
+            if (this.confirmState.deleteValidation && !this.confirmState.deleteValidation.valid) {
+                return stay(false);
+            }
+            if (this.confirmState.deleteConfirmInput !== project.name) {
+                this.confirmState.deleteError = `Type "${project.name}" exactly to confirm`;
+                return stay();
+            }
+            // Archive first if not already archived
+            if (project.status !== 'archived') {
+                projectRepository.update(project.id, { status: 'archived' });
+            }
+            // Delete from database
+            projectRepository.delete(project.id);
+            // Clear project-specific anchors
+            clearProjectAnchors(String(project.id));
+            // Clear as active project if needed
+            if (getActiveProject()?.id === project.id) {
+                clearActiveProject();
+            }
+            // Delete filesystem folder (only if validation passed and path exists)
+            const projectPath = project.path;
+            const validation = this.confirmState.deleteValidation;
+            if (projectPath && validation?.valid && fs.existsSync(projectPath)) {
+                try {
+                    fs.rmSync(projectPath, { recursive: true, force: true });
+                }
+                catch {
+                    // Ignore delete errors - DB is already cleaned up
+                }
+            }
+            this.onComplete();
+            this.confirmState.targetProject = null;
+            this.confirmState.deleteConfirmInput = '';
+            this.confirmState.deleteError = null;
+            this.confirmState.deleteValidation = null;
+            return popScreen();
+        }
+        return stay(false);
+    }
+}
+// =============================================================================
+// Projects Overlay
+// =============================================================================
+class ProjectsOverlay extends TabbedListOverlay {
+    /** State for confirmation screens */
+    confirmState = {
+        targetProject: null,
+        deleteConfirmInput: '',
+        deleteError: null,
+        deleteValidation: null,
+    };
+    constructor() {
+        // Load projects from database
+        const { projects } = projectRepository.list({ status: 'all' });
+        const config = {
+            title: 'Projects',
+            tabs: TABS,
+            items: projects,
+            pageSize: PAGE_SIZE,
+            filterByTab: (project, tabId) => {
+                if (tabId === 'all') {
+                    // 'all' shows everything except archived
+                    return project.status !== 'archived';
+                }
+                return project.status === tabId;
+            },
+            getSearchText: (project) => `${project.displayName} ${project.name} ${project.path} ${project.type}`,
+            renderItem: (project, isSelected, s) => {
+                const cols = terminal.getTerminalWidth();
+                const nameW = Math.min(24, Math.floor(cols * 0.25));
+                const typeW = 10;
+                const statusW = 12;
+                const pathW = Math.max(20, cols - nameW - typeW - statusW - 12);
+                const cursor = isSelected ? s.primary('❯ ') : '  ';
+                const statusIcon = STATUS_ICONS[project.status];
+                const statusLabel = `${statusIcon} ${STATUS_LABELS[project.status]}`;
+                const row = [
+                    truncate(project.displayName, nameW - 1).padEnd(nameW),
+                    project.type.padEnd(typeW),
+                    statusLabel.padEnd(statusW),
+                    truncate(project.path, pathW - 1),
+                ].join('');
+                if (isSelected) {
+                    return `${cursor}${s.primary(row)}`;
+                }
+                return `${cursor}${row}`;
+            },
+            showCount: true,
+            emptyMessage: 'No projects found. Use /new to create one.',
+            noResultsMessage: 'No projects match the search.',
+            footerHints: (searchMode) => {
+                if (searchMode) {
+                    return 'Type to filter · ↑↓/jk Navigate · Enter Open · Esc Exit search';
+                }
+                return '↑↓/jk Navigate · ←→/hl Tabs · / Search · Enter Open · x Archive · d Delete · q/Esc Close';
+            },
+            renderSelectedPreview: (project, s) => {
+                const lines = [];
+                lines.push(s.muted('  ' + '─'.repeat(60)));
+                // Last activity
+                const lastActivity = project.lastActivityAt
+                    ? new Date(project.lastActivityAt).toLocaleDateString('en-US', {
+                        year: 'numeric',
+                        month: 'short',
+                        day: 'numeric',
+                        hour: '2-digit',
+                        minute: '2-digit',
+                    })
+                    : 'Never';
+                lines.push(`  ${s.muted('Last Activity:')} ${lastActivity}`);
+                // Work items progress
+                const { items: workItems, total } = workItemRepository.query({ project_id: project.id });
+                const completed = workItems.filter(w => w.status === 'completed').length;
+                if (total > 0) {
+                    const percent = Math.round((completed / total) * 100);
+                    const progressBar = renderProgressBar(percent, 20, s);
+                    lines.push(`  ${s.muted('Work Items:')} ${progressBar} ${String(completed)}/${String(total)} (${String(percent)}%)`);
+                }
+                else {
+                    lines.push(`  ${s.muted('Work Items:')} ${s.muted('None')}`);
+                }
+                return lines;
+            },
+        };
+        super(config);
+    }
+    /**
+     * No detail screen - we handle Enter to close with result instead
+     */
+    createDetailScreen(_project) {
+        return null;
+    }
+    /**
+     * Refresh projects from database after archive/delete
+     */
+    refreshProjects() {
+        const { projects } = projectRepository.list({ status: 'all' });
+        this.state.items = projects;
+        // Re-apply tab filter
+        const tabId = TABS[this.state.currentTab]?.id ?? 'all';
+        let filtered = projects.filter((p) => {
+            if (tabId === 'all')
+                return p.status !== 'archived';
+            return p.status === tabId;
+        });
+        // Re-apply search filter
+        if (this.state.searchQuery) {
+            const query = this.state.searchQuery.toLowerCase();
+            filtered = filtered.filter((p) => p.displayName.toLowerCase().includes(query) ||
+                p.name.toLowerCase().includes(query) ||
+                p.path.toLowerCase().includes(query));
+        }
+        this.state.filteredItems = filtered;
+        this.state.selectedIndex = Math.min(this.state.selectedIndex, Math.max(0, filtered.length - 1));
+    }
+    /**
+     * Override to intercept custom keys before TabbedListOverlay handles them
+     */
+    handleKey(data) {
+        const char = data.length === 1 && data[0] >= 0x20 && data[0] < 0x7f
+            ? String.fromCharCode(data[0])
+            : null;
+        // Only intercept when on the main list screen (screen stack size = 1)
+        if (this.screenStack.size() === 1) {
+            // Ctrl+C always closes with cancel result
+            if (isCtrlC(data)) {
+                this.close({ action: 'cancel' });
+                return;
+            }
+            // Don't intercept if in search mode
+            if (!this.state.searchMode) {
+                // q/Esc closes with cancel result
+                if (isClose(data)) {
+                    this.close({ action: 'cancel' });
+                    return;
+                }
+                // Enter opens workflow (instead of detail view)
+                if (isEnter(data) && this.state.filteredItems.length > 0) {
+                    const selected = this.state.filteredItems[this.state.selectedIndex];
+                    this.close({ action: 'open-workflow', projectId: selected.id });
+                    return;
+                }
+                // 'x' archive/restore
+                if ((char === 'x' || char === 'X') && this.state.filteredItems.length > 0) {
+                    const project = this.state.filteredItems[this.state.selectedIndex];
+                    this.confirmState.targetProject = project;
+                    this.screenStack.push(new ArchiveConfirmScreen(this.confirmState, this.styles, () => { this.refreshProjects(); }));
+                    this.update();
+                    return;
+                }
+                // 'd' delete
+                if ((char === 'd' || char === 'D') && this.state.filteredItems.length > 0) {
+                    const project = this.state.filteredItems[this.state.selectedIndex];
+                    this.confirmState.targetProject = project;
+                    this.confirmState.deleteConfirmInput = '';
+                    this.confirmState.deleteError = null;
+                    this.confirmState.deleteValidation = validateDeletePath(project.path);
+                    this.screenStack.push(new DeleteConfirmScreen(this.confirmState, this.styles, () => { this.refreshProjects(); }));
+                    this.update();
+                    return;
+                }
+            }
+        }
+        // Let TabbedListOverlay handle everything else
+        super.handleKey(data);
+    }
+}
+// =============================================================================
+// Export Function (Backward Compatible)
+// =============================================================================
+export async function showProjectsOverlay() {
+    return new ProjectsOverlay().show();
+}

package/dist/ui/providers/types.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Content Provider Interfaces
+ *
+ * Components implement these interfaces to provide content for rendering.
+ * The TerminalRenderer collects lines from providers and writes to terminal.
+ *
+ * Key principle: Providers return string[], never write to terminal directly.
+ */
+/**
+ * Base interface for all content providers.
+ * Returns lines to render. Empty array = nothing to show.
+ */
+export interface ContentProvider {
+    /** Returns lines to render. Empty array = nothing to show */
+    getLines(): string[];
+    /** Optional: get cursor position within this component's content */
+    getCursorPosition?(): CursorPosition | null;
+    /** Optional: does this provider need keyboard input? */
+    hasKeyboardFocus?(): boolean;
+}
+/**
+ * Cursor position within rendered content
+ */
+export interface CursorPosition {
+    /** Row within the provider's content (0-indexed) */
+    row: number;
+    /** Column within the row (0-indexed) */
+    col: number;
+}
+/**
+ * Menu options available in startup menu
+ */
+export type MenuOption = 'init' | 'projects' | 'continue' | 'chat' | 'config' | 'help' | 'exit';
+/**
+ * Actions from menu keyboard handling
+ */
+export type MenuAction = 'up' | 'down' | 'select' | 'exit' | null;
+/**
+ * Provider for the startup menu (MENU mode)
+ */
+export interface MenuProvider extends ContentProvider {
+    /** Returns full menu screen content */
+    getLines(): string[];
+    /** Handle keyboard input, return action taken */
+    handleKey(key: Buffer): MenuAction;
+    /** Get currently selected menu option */
+    getSelectedOption(): MenuOption;
+    /** Get highlighted index (for rendering) */
+    getHighlightedIndex(): number;
+}
+/**
+ * Provider for subagent status display
+ */
+export interface SubagentProvider extends ContentProvider {
+    /** Returns subagent status lines (empty if no active subagents) */
+    getLines(): string[];
+    /** Check if any subagent is currently active */
+    hasActiveSubagent(): boolean;
+}
+/**
+ * Provider for spinner/progress display
+ */
+export interface SpinnerProvider extends ContentProvider {
+    /** Returns spinner line when agent is running (empty when idle) */
+    getLines(): string[];
+    /** Check if agent is currently running */
+    isAgentRunning(): boolean;
+}
+/**
+ * Provider for todo list display
+ */
+export interface TodoProvider extends ContentProvider {
+    /** Returns todo list (empty when agent running or no todos) */
+    getLines(): string[];
+    /** Get count of todos */
+    getTodoCount(): number;
+}
+/**
+ * Provider for queued messages display
+ */
+export interface QueueProvider extends ContentProvider {
+    /** Returns queued messages (empty if none) */
+    getLines(): string[];
+    /** Get count of queued messages */
+    getQueueCount(): number;
+}
+/**
+ * Actions from input keyboard handling
+ */
+export type InputAction = {
+    type: 'submit';
+    value: string;
+} | {
+    type: 'command';
+    value: string;
+} | {
+    type: 'cancel';
+} | {
+    type: 'change';
+} | {
+    type: 'escape';
+} | null;
+/**
+ * Provider for input prompt
+ */
+export interface InputProvider extends ContentProvider {
+    /** Returns separator + input prompt lines (may be multi-line) */
+    getLines(): string[];
+    /** Get cursor position within input content */
+    getCursorPosition(): CursorPosition;
+    /** Handle keyboard input, return action taken */
+    handleKey(key: Buffer): InputAction;
+    /** Get current input value */
+    getValue(): string;
+    /** Set input value programmatically */
+    setValue(value: string): void;
+    /** Clear input */
+    clear(): void;
+    /** Is input in queue mode (typing queued while agent runs) */
+    isQueueMode(): boolean;
+}
+/**
+ * Provider for mode indicator line
+ */
+export interface ModeProvider extends ContentProvider {
+    /** Returns mode indicator line */
+    getLines(): string[];
+    /** Get current mode name */
+    getModeName(): string;
+}
+/**
+ * Actions from overlay keyboard handling
+ */
+export type OverlayAction = {
+    type: 'close';
+} | {
+    type: 'close';
+    result: unknown;
+} | {
+    type: 'navigate';
+    direction: 'up' | 'down' | 'left' | 'right';
+} | {
+    type: 'select';
+} | {
+    type: 'scroll';
+    direction: 'up' | 'down';
+} | {
+    type: 'tab';
+    direction: 'next' | 'prev';
+} | null;
+/**
+ * Provider for full-screen overlays
+ */
+export interface OverlayProvider extends ContentProvider {
+    /** Returns full overlay content */
+    getLines(): string[];
+    /** Check if overlay is active */
+    isActive(): boolean;
+    /** Handle keyboard input, return action taken */
+    handleKey(key: Buffer): OverlayAction;
+    /** Get cursor position if overlay needs visible cursor */
+    getCursorPosition(): CursorPosition | null;
+    /** Get overlay title (for header) */
+    getTitle(): string;
+}
+/**
+ * All providers needed by TerminalRenderer
+ */
+export interface ProviderRegistry {
+    menu?: MenuProvider;
+    subagent?: SubagentProvider;
+    spinner?: SpinnerProvider;
+    todo?: TodoProvider;
+    queue?: QueueProvider;
+    input?: InputProvider;
+    mode?: ModeProvider;
+    overlay?: OverlayProvider;
+}

package/dist/ui/providers/types.js

@@ -0,0 +1,9 @@
+/**
+ * Content Provider Interfaces
+ *
+ * Components implement these interfaces to provide content for rendering.
+ * The TerminalRenderer collects lines from providers and writes to terminal.
+ *
+ * Key principle: Providers return string[], never write to terminal directly.
+ */
+export {};