@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/ui/overlay/impl/projects-overlay-v2.js

@@ -0,0 +1,733 @@
+/**
+ * Projects Overlay V2
+ *
+ * Interactive overlay for viewing and managing projects.
+ * Uses TabbedListOverlayV2 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)
+ * - Opens WorkflowOverlayV2 for selected project (push onto stack)
+ */
+import * as fs from 'fs';
+import { TabbedListOverlayV2 } from '../../base/tabbed-list-overlay-v2.js';
+import { BaseScreen, stay, popScreen, closeOverlay, renderBorder, renderProgressBar, truncate, 
+// Key detection functions (consolidated from ui-core)
+isCtrlC, isEscape, isEnter, isBackspace, extractPrintable, } 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';
+import * as terminal from '../../terminal.js';
+import { WorkflowOverlayV2 } from './workflow-overlay-v2.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
+// =============================================================================
+// Key detection, renderProgressBar, and truncate are imported from '../../base/index.js'
+// =============================================================================
+// 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.confirmState.modified = true;
+            this.onComplete();
+            this.confirmState.targetProject = null;
+            return popScreen();
+        }
+        return stay(false);
+    }
+    getMinHeight() {
+        return 14;
+    }
+}
+// =============================================================================
+// Delete Blocked Screen (project not archived)
+// =============================================================================
+class DeleteBlockedScreen extends BaseScreen {
+    confirmState;
+    styles;
+    constructor(confirmState, styles) {
+        super();
+        this.confirmState = confirmState;
+        this.styles = styles;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const project = this.confirmState.targetProject;
+        const lines = [];
+        lines.push(border);
+        lines.push(`  ${s.error('Cannot Delete Project')}`);
+        lines.push('');
+        if (project) {
+            lines.push(`  ${s.primaryBold(project.displayName)}`);
+            lines.push(`  ${s.muted(`Status: ${project.status}`)}`);
+            lines.push('');
+        }
+        lines.push(`  ${s.warning('Projects must be archived before deletion.')}`);
+        lines.push('');
+        lines.push(`  ${s.muted('This is a safety measure to prevent accidental deletion.')}`);
+        lines.push(`  ${s.muted('Archive the project first (press x), then try deleting again.')}`);
+        lines.push('');
+        lines.push(`  ${s.muted('Press Esc to go back')}`);
+        lines.push('');
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        if (isEscape(data) || isEnter(data) || isCtrlC(data)) {
+            this.confirmState.targetProject = null;
+            this.confirmState.deleteError = null;
+            return popScreen();
+        }
+        return stay(false);
+    }
+    getMinHeight() {
+        return 14;
+    }
+}
+// =============================================================================
+// 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'));
+        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 = extractPrintable(data);
+        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();
+            }
+            // Delete from database (project must already be archived - checked before showing this screen)
+            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.confirmState.modified = true;
+            this.onComplete();
+            this.confirmState.targetProject = null;
+            this.confirmState.deleteConfirmInput = '';
+            this.confirmState.deleteError = null;
+            this.confirmState.deleteValidation = null;
+            return popScreen();
+        }
+        return stay(false);
+    }
+    getMinHeight() {
+        return 28;
+    }
+}
+class ProjectEditScreen extends BaseScreen {
+    editState;
+    styles;
+    onComplete;
+    constructor(editState, styles, onComplete) {
+        super();
+        this.editState = editState;
+        this.styles = styles;
+        this.onComplete = onComplete;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const project = this.editState.targetProject;
+        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.primaryBold('EDIT PROJECT')}`);
+        lines.push('');
+        lines.push(s.muted(`  ID: ${String(project.id)} · Name: ${project.name}`));
+        lines.push(s.muted(`  Status: ${STATUS_LABELS[project.status]} · Type: ${project.type}`));
+        lines.push(s.muted(`  Created: ${new Date(project.createdAt).toLocaleDateString()}`));
+        lines.push('');
+        lines.push(s.muted('  ' + '─'.repeat(cols - 6)));
+        lines.push('');
+        // Render fields
+        for (let i = 0; i < this.editState.fields.length; i++) {
+            const field = this.editState.fields[i];
+            const isSelected = i === this.editState.selectedFieldIndex;
+            const isEditing = isSelected && this.editState.editingField;
+            const cursor = isSelected ? s.primary('❯ ') : '  ';
+            const label = field.label.padEnd(14);
+            if (isEditing) {
+                // Show input buffer with cursor
+                const inputDisplay = this.editState.inputBuffer || '';
+                lines.push(`${cursor}${s.muted(label)} ${s.primary(inputDisplay)}█`);
+            }
+            else {
+                const value = field.value || s.muted(field.placeholder || '(not set)');
+                if (isSelected) {
+                    lines.push(`${cursor}${s.primary(label)} ${value}`);
+                }
+                else {
+                    lines.push(`${cursor}${s.muted(label)} ${value}`);
+                }
+            }
+        }
+        if (this.editState.error) {
+            lines.push('');
+            lines.push(s.error(`  ${this.editState.error}`));
+        }
+        lines.push('');
+        lines.push(border);
+        if (this.editState.editingField) {
+            lines.push(s.muted('  Enter Save field · Esc Cancel edit'));
+        }
+        else {
+            lines.push(s.muted('  ↑↓/jk Navigate · Enter Edit field · s Save & close · Esc Cancel'));
+        }
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        const char = extractPrintable(data);
+        if (isCtrlC(data)) {
+            return closeOverlay({ action: 'cancel' });
+        }
+        // Handle field editing mode
+        if (this.editState.editingField) {
+            if (isEscape(data)) {
+                // Cancel field edit - restore original value
+                const field = this.editState.fields[this.editState.selectedFieldIndex];
+                this.editState.inputBuffer = field.value;
+                this.editState.editingField = false;
+                return stay();
+            }
+            if (isEnter(data)) {
+                // Save field value
+                const field = this.editState.fields[this.editState.selectedFieldIndex];
+                field.value = this.editState.inputBuffer;
+                this.editState.editingField = false;
+                this.editState.modified = true;
+                return stay();
+            }
+            if (isBackspace(data)) {
+                this.editState.inputBuffer = this.editState.inputBuffer.slice(0, -1);
+                return stay();
+            }
+            if (char) {
+                this.editState.inputBuffer += char;
+                return stay();
+            }
+            return stay(false);
+        }
+        // Handle navigation mode
+        if (isEscape(data)) {
+            // Cancel without saving
+            this.editState.targetProject = null;
+            this.editState.error = null;
+            return popScreen();
+        }
+        // Navigate up
+        if (data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x41) {
+            // Up arrow
+            if (this.editState.selectedFieldIndex > 0) {
+                this.editState.selectedFieldIndex--;
+            }
+            return stay();
+        }
+        if (char === 'k') {
+            if (this.editState.selectedFieldIndex > 0) {
+                this.editState.selectedFieldIndex--;
+            }
+            return stay();
+        }
+        // Navigate down
+        if (data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x42) {
+            // Down arrow
+            if (this.editState.selectedFieldIndex < this.editState.fields.length - 1) {
+                this.editState.selectedFieldIndex++;
+            }
+            return stay();
+        }
+        if (char === 'j') {
+            if (this.editState.selectedFieldIndex < this.editState.fields.length - 1) {
+                this.editState.selectedFieldIndex++;
+            }
+            return stay();
+        }
+        // Enter to edit field
+        if (isEnter(data)) {
+            const field = this.editState.fields[this.editState.selectedFieldIndex];
+            this.editState.inputBuffer = field.value;
+            this.editState.editingField = true;
+            return stay();
+        }
+        // 's' to save and close
+        if (char === 's' || char === 'S') {
+            return this.saveAndClose();
+        }
+        return stay(false);
+    }
+    saveAndClose() {
+        const project = this.editState.targetProject;
+        if (!project)
+            return popScreen();
+        // Build update object from fields
+        const updates = {};
+        for (const field of this.editState.fields) {
+            if (field.key === 'displayName') {
+                updates.display_name = field.value || undefined;
+            }
+            else if (field.key === 'description') {
+                updates.description = field.value || undefined;
+            }
+            else if (field.key === 'gitRemote') {
+                updates.git_remote = field.value || undefined;
+            }
+            else if (field.key === 'gitBranch') {
+                updates.git_branch = field.value || undefined;
+            }
+            else {
+                // field.key === 'path'
+                updates.path = field.value || undefined;
+            }
+        }
+        try {
+            projectRepository.update(project.id, updates);
+            this.editState.modified = true;
+            this.onComplete();
+        }
+        catch (err) {
+            this.editState.error = err.message;
+            return stay();
+        }
+        this.editState.targetProject = null;
+        this.editState.error = null;
+        return popScreen();
+    }
+    getMinHeight() {
+        return 22;
+    }
+}
+// =============================================================================
+// Projects Overlay V2
+// =============================================================================
+export class ProjectsOverlayV2 extends TabbedListOverlayV2 {
+    type = 'inline';
+    id = 'projects-overlay-v2';
+    confirmState = {
+        targetProject: null,
+        deleteConfirmInput: '',
+        deleteError: null,
+        deleteValidation: null,
+        modified: false,
+    };
+    editState = {
+        targetProject: null,
+        fields: [],
+        selectedFieldIndex: 0,
+        editingField: false,
+        inputBuffer: '',
+        error: null,
+        modified: false,
+    };
+    constructor() {
+        // Load projects from database
+        const { projects } = projectRepository.list({ status: 'all' });
+        super({
+            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 · e Edit · 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 / 100, 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;
+            },
+        });
+        this.minHeight = 22;
+    }
+    /**
+     * 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 handleKey to add custom behavior (Enter opens workflow, x archive, d delete)
+     */
+    handleKey(key) {
+        // Ctrl+C always closes
+        if (this.isInterruptKey(key)) {
+            return this.close({ action: 'cancel' });
+        }
+        // q or Esc closes (only if not in search mode)
+        if (this.isCloseKey(key) && !this.state.searchMode) {
+            return this.close({ action: 'cancel' });
+        }
+        // Only handle custom keys when on main list (screen stack size = 1)
+        if (this.screenStack.size() === 1 && !this.state.searchMode) {
+            // Enter opens workflow overlay (pushed onto V2 overlay stack)
+            if (this.isEnterKey(key) && this.state.filteredItems.length > 0) {
+                const project = this.state.filteredItems[this.state.selectedIndex];
+                return this.push(new WorkflowOverlayV2(project.id));
+            }
+            // 'e' edit project
+            if ((key.char === 'e' || key.char === 'E') && this.state.filteredItems.length > 0) {
+                const project = this.state.filteredItems[this.state.selectedIndex];
+                this.editState.targetProject = project;
+                this.editState.selectedFieldIndex = 0;
+                this.editState.editingField = false;
+                this.editState.inputBuffer = '';
+                this.editState.error = null;
+                this.editState.fields = [
+                    { key: 'displayName', label: 'Display Name', value: project.displayName, placeholder: 'Project display name' },
+                    { key: 'description', label: 'Description', value: project.description || '', placeholder: 'Brief description' },
+                    { key: 'path', label: 'Path', value: project.path || '', placeholder: '/path/to/project' },
+                    { key: 'gitRemote', label: 'Git Remote', value: project.gitRemote || '', placeholder: 'https://github.com/...' },
+                    { key: 'gitBranch', label: 'Git Branch', value: project.gitBranch || '', placeholder: 'main' },
+                ];
+                this.screenStack.push(new ProjectEditScreen(this.editState, this.getStyles(), () => { this.refreshProjects(); }));
+                return this.rerender();
+            }
+            // 'x' archive/restore
+            if ((key.char === 'x' || key.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.getStyles(), () => { this.refreshProjects(); }));
+                return this.rerender();
+            }
+            // 'd' delete (only for archived projects)
+            if ((key.char === 'd' || key.char === 'D') && this.state.filteredItems.length > 0) {
+                const project = this.state.filteredItems[this.state.selectedIndex];
+                // Block deletion of non-archived projects
+                if (project.status !== 'archived') {
+                    this.confirmState.targetProject = project;
+                    this.confirmState.deleteError = 'Archive the project first (press x), then delete';
+                    this.screenStack.push(new DeleteBlockedScreen(this.confirmState, this.getStyles()));
+                    return this.rerender();
+                }
+                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.getStyles(), () => { this.refreshProjects(); }));
+                return this.rerender();
+            }
+        }
+        // Let parent handle everything else
+        const result = super.handleKey(key);
+        // Convert close result to our result type
+        if (result.type === 'close') {
+            return this.close({ action: 'cancel' });
+        }
+        // Safe to return other actions (render, none, etc.)
+        return result;
+    }
+}