@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/ui/overlay/impl/dashboard-overlay-v2.d.ts

@@ -27,6 +27,8 @@ interface DashboardState {
         completed: number;
         total: number;
     } | null;
+    /** Timestamp of first 'q' press for double-tap exit confirmation */
+    quitPendingAt: number | null;
 }
 export interface DashboardOverlayV2Result {
     /** The action to take after closing the overlay */

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

@@ -52,6 +52,7 @@ export class DashboardOverlayV2 extends BaseOverlayV2 {
             currentProject: current,
             recentProjects: filteredRecent,
             progress,
+            quitPendingAt: null,
         });
     }
     // ===========================================================================
@@ -239,8 +240,13 @@ export class DashboardOverlayV2 extends BaseOverlayV2 {
     }
     renderDashboardFooter(context) {
         const s = context.styles;
+        if (this.state.quitPendingAt) {
+            return [
+                s.warning('  Press q again to quit'),
+            ];
+        }
         return [
-            s.muted('  ↑↓/jk Navigate   Enter Select   q Quit'),
+            s.muted('  ↑↓/jk Navigate   Enter Select   qq Quit'),
         ];
     }
     shortenPath(fullPath) {
@@ -257,9 +263,26 @@ export class DashboardOverlayV2 extends BaseOverlayV2 {
         const data = key.raw;
         const char = data.toString();
         const items = this.getItems();
-        // Only q exits - Escape does nothing on dashboard (it's the home screen)
+        // Double-tap q to exit — prevents accidental quit
         if (char === 'q') {
-            return this.close({ action: 'exit' });
+            const now = Date.now();
+            if (this.state.quitPendingAt && now - this.state.quitPendingAt < 1500) {
+                return this.close({ action: 'exit' });
+            }
+            this.state.quitPendingAt = now;
+            // Auto-clear after 1.5s
+            setTimeout(() => {
+                if (this.state.quitPendingAt) {
+                    this.state.quitPendingAt = null;
+                    this.requestRender();
+                }
+            }, 1500);
+            return this.rerender();
+        }
+        // Any other key clears quit confirmation
+        if (this.state.quitPendingAt) {
+            this.state.quitPendingAt = null;
+            // Fall through to normal key handling (will re-render via the action below)
         }
         // Escape and Ctrl+C just do nothing on dashboard
         if (isEscape(data) || isCtrlC(data)) {

package/dist/ui/overlay/impl/delegations-overlay-v2.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Delegations Overlay V2 - View delegation status and history
+ *
+ * Shows delegations from the coordinator to background specialists.
+ * List view with detail drill-down, clear completed, status indicators.
+ */
+import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../index.js';
+interface DelegationsOverlayState {
+    selectedIndex: number;
+    screen: 'list' | 'detail';
+    detailId: string | null;
+}
+export declare class DelegationsOverlayV2 extends BaseOverlayV2<DelegationsOverlayState> {
+    readonly type: "inline";
+    readonly id = "delegations-overlay";
+    constructor();
+    protected renderContent(context: RenderContext): string[];
+    private renderList;
+    private formatDelegationLine;
+    private renderDetail;
+    handleKey(key: KeyEvent): OverlayAction<void>;
+    private handleListKey;
+    private getSortedDelegations;
+    private getStatusStyle;
+    private formatDuration;
+}
+export {};

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

@@ -0,0 +1,279 @@
+/**
+ * Delegations Overlay V2 - View delegation status and history
+ *
+ * Shows delegations from the coordinator to background specialists.
+ * List view with detail drill-down, clear completed, status indicators.
+ */
+import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
+import { wrapText, truncate } from '../../base/render-utils.js';
+import { getDelegationTracker, } from '../../../multi-agent/delegation-tracker.js';
+export class DelegationsOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'delegations-overlay';
+    constructor() {
+        super({
+            selectedIndex: 0,
+            screen: 'list',
+            detailId: null,
+        });
+    }
+    renderContent(context) {
+        this.minHeight = this.state.screen === 'detail' ? 18 : 14;
+        if (this.state.screen === 'detail') {
+            return this.renderDetail(context);
+        }
+        return this.renderList(context);
+    }
+    // ===========================================================================
+    // List View
+    // ===========================================================================
+    renderList(context) {
+        const s = context.styles;
+        const lines = [];
+        const innerWidth = context.width - 4;
+        lines.push(...this.renderHeader('Delegations'));
+        const tracker = getDelegationTracker();
+        const delegations = this.getSortedDelegations();
+        const stats = tracker.getStats();
+        // Stats line
+        const statParts = [];
+        if (stats.pending > 0 || stats.running > 0) {
+            statParts.push(s.warning(`Active: ${String(stats.pending + stats.running)}`));
+        }
+        if (stats.completed > 0) {
+            statParts.push(s.success(`Completed: ${String(stats.completed)}`));
+        }
+        if (stats.failed > 0) {
+            statParts.push(s.error(`Failed: ${String(stats.failed)}`));
+        }
+        if (statParts.length > 0) {
+            lines.push(`  ${statParts.join('  ')}`);
+            lines.push('');
+        }
+        // Ensure selected index is valid
+        if (this.state.selectedIndex >= delegations.length) {
+            this.state.selectedIndex = Math.max(0, delegations.length - 1);
+        }
+        if (delegations.length === 0) {
+            lines.push(s.muted('  No delegations yet.'));
+            lines.push('');
+            lines.push(s.muted('  The coordinator uses delegate_background to'));
+            lines.push(s.muted('  assign tasks to specialist agents.'));
+            lines.push('');
+        }
+        else {
+            for (let i = 0; i < delegations.length; i++) {
+                const d = delegations[i];
+                const isSelected = i === this.state.selectedIndex;
+                const line = this.formatDelegationLine(d, innerWidth - 4, s);
+                if (isSelected) {
+                    lines.push(s.selected(` ${s.primary('›')} ${line} `));
+                }
+                else {
+                    lines.push(`   ${line}`);
+                }
+            }
+            lines.push('');
+        }
+        // Footer
+        if (delegations.length > 0) {
+            lines.push(...this.renderFooter('↑↓ navigate · Enter details · c clear done · q close'));
+        }
+        else {
+            lines.push(...this.renderFooter('q close'));
+        }
+        return lines;
+    }
+    formatDelegationLine(d, maxWidth, s) {
+        const { icon, colorFn } = this.getStatusStyle(d.status, s);
+        const duration = this.formatDuration(d.createdAt, d.completedAt);
+        const agent = `$${d.targetAgentId}`;
+        // Columns: icon(2) + id(12) + agent(8) + task(flex) + status/duration(12)
+        const fixedWidth = 2 + 12 + 8 + 12;
+        const taskMaxLen = Math.max(10, maxWidth - fixedWidth);
+        const task = truncate(d.task, taskMaxLen);
+        const statusText = d.status === 'completed' || d.status === 'failed'
+            ? duration
+            : d.status;
+        return `${colorFn(icon)} ${s.muted(d.id.padEnd(12))}${s.secondary(agent.padEnd(8))}${task.padEnd(taskMaxLen)}${s.muted(statusText)}`;
+    }
+    // ===========================================================================
+    // Detail View
+    // ===========================================================================
+    renderDetail(context) {
+        const s = context.styles;
+        const lines = [];
+        const innerWidth = context.width - 4;
+        const tracker = getDelegationTracker();
+        const d = this.state.detailId ? tracker.get(this.state.detailId) : undefined;
+        lines.push(...this.renderHeader(this.state.detailId ?? 'Delegation'));
+        if (!d) {
+            lines.push(s.error('  Delegation not found.'));
+            lines.push('');
+            lines.push(...this.renderFooter('Esc back'));
+            return lines;
+        }
+        const { icon, colorFn } = this.getStatusStyle(d.status, s);
+        // Info fields
+        lines.push(`  ${s.primaryBold('Status:')}    ${colorFn(`${icon} ${d.status}`)}`);
+        lines.push(`  ${s.primaryBold('Agent:')}     ${s.secondary(`$${d.targetAgentId}`)}`);
+        lines.push(`  ${s.primaryBold('Created:')}   ${s.muted(d.createdAt.toLocaleTimeString())}`);
+        lines.push(`  ${s.primaryBold('Duration:')}  ${s.muted(this.formatDuration(d.createdAt, d.completedAt))}`);
+        if (d.todoIndex !== undefined) {
+            lines.push(`  ${s.primaryBold('Todo:')}      ${s.muted(`#${String(d.todoIndex)}`)}`);
+        }
+        lines.push('');
+        // Task
+        lines.push(`  ${s.primaryBold('Task:')}`);
+        const taskLines = wrapText(d.task, innerWidth - 4);
+        for (const tl of taskLines) {
+            lines.push(`    ${tl}`);
+        }
+        if (d.expectedOutput) {
+            lines.push('');
+            lines.push(`  ${s.primaryBold('Expected Output:')}`);
+            const expectedLines = wrapText(d.expectedOutput, innerWidth - 4);
+            for (const el of expectedLines) {
+                lines.push(`    ${s.muted(el)}`);
+            }
+        }
+        // Result
+        lines.push('');
+        if (d.result) {
+            lines.push(`  ${s.primaryBold('Result:')}`);
+            const summaryLines = wrapText(d.result.summary, innerWidth - 4);
+            for (const sl of summaryLines) {
+                lines.push(`    ${d.result.success ? s.success(sl) : s.error(sl)}`);
+            }
+            if (d.result.artifactIds.length > 0) {
+                lines.push(`  ${s.primaryBold('Artifacts:')} ${s.muted(d.result.artifactIds.join(', '))}`);
+            }
+            if (d.result.error) {
+                lines.push(`  ${s.primaryBold('Error:')}     ${s.error(d.result.error)}`);
+            }
+        }
+        else {
+            lines.push(`  ${s.muted('(still running)')}`);
+        }
+        lines.push('');
+        lines.push(...this.renderFooter('Esc back · q close'));
+        return lines;
+    }
+    // ===========================================================================
+    // Key Handling
+    // ===========================================================================
+    handleKey(key) {
+        if (this.isCloseKey(key)) {
+            if (this.state.screen === 'detail') {
+                this.state.screen = 'list';
+                this.state.detailId = null;
+                return this.rerender();
+            }
+            return this.close(undefined);
+        }
+        if (this.state.screen === 'detail') {
+            return this.noAction();
+        }
+        return this.handleListKey(key);
+    }
+    handleListKey(key) {
+        const delegations = this.getSortedDelegations();
+        if (this.isUpKey(key)) {
+            if (this.state.selectedIndex > 0) {
+                this.state.selectedIndex--;
+            }
+            return this.rerender();
+        }
+        if (this.isDownKey(key)) {
+            if (this.state.selectedIndex < delegations.length - 1) {
+                this.state.selectedIndex++;
+            }
+            return this.rerender();
+        }
+        if (this.isEnterKey(key)) {
+            if (delegations.length > 0 && delegations[this.state.selectedIndex]) {
+                this.state.screen = 'detail';
+                this.state.detailId = delegations[this.state.selectedIndex].id;
+            }
+            return this.rerender();
+        }
+        // 'c' for clear completed/failed/cancelled
+        if (key.name === 'c') {
+            const tracker = getDelegationTracker();
+            const all = tracker.getAll();
+            for (const d of all) {
+                if (d.status === 'completed' || d.status === 'failed' || d.status === 'cancelled') {
+                    // Remove from tracker by clearing and re-adding actives
+                    // DelegationTracker doesn't have a remove method, so we clear all
+                    // Note: This is a simplification — only clear if there are no active delegations
+                }
+            }
+            // For now, clear the entire tracker if no active delegations remain
+            const stats = tracker.getStats();
+            if (stats.pending === 0 && stats.running === 0) {
+                tracker.clear();
+            }
+            this.state.selectedIndex = 0;
+            return this.rerender();
+        }
+        return this.noAction();
+    }
+    // ===========================================================================
+    // Helpers
+    // ===========================================================================
+    getSortedDelegations() {
+        const tracker = getDelegationTracker();
+        const delegations = tracker.getAll();
+        // Sort: running first, then pending, then completed/failed by time desc
+        delegations.sort((a, b) => {
+            const statusOrder = (status) => {
+                switch (status) {
+                    case 'running': return 0;
+                    case 'pending': return 1;
+                    case 'completed': return 2;
+                    case 'failed': return 3;
+                    case 'cancelled': return 4;
+                    default: return 5;
+                }
+            };
+            const orderDiff = statusOrder(a.status) - statusOrder(b.status);
+            if (orderDiff !== 0)
+                return orderDiff;
+            // Within same status, newest first
+            return b.createdAt.getTime() - a.createdAt.getTime();
+        });
+        return delegations;
+    }
+    getStatusStyle(status, s) {
+        switch (status) {
+            case 'running':
+                return { icon: '●', colorFn: s.warning };
+            case 'pending':
+                return { icon: '●', colorFn: s.muted };
+            case 'completed':
+                return { icon: '✓', colorFn: s.success };
+            case 'failed':
+                return { icon: '✗', colorFn: s.error };
+            case 'cancelled':
+                return { icon: '⊘', colorFn: s.muted };
+            default:
+                return { icon: '?', colorFn: s.muted };
+        }
+    }
+    formatDuration(from, to) {
+        const endTime = to ?? new Date();
+        const ms = endTime.getTime() - from.getTime();
+        const seconds = Math.floor(ms / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        if (hours > 0) {
+            return `${String(hours)}h ${String(minutes % 60)}m`;
+        }
+        else if (minutes > 0) {
+            return `${String(minutes)}m ${String(seconds % 60)}s`;
+        }
+        else {
+            return `${String(seconds)}s`;
+        }
+    }
+}

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

@@ -13,22 +13,20 @@
 import { TabbedListOverlayV2 } from '../../base/tabbed-list-overlay-v2.js';
 import { documentRepository } from '../../../db/repositories/document-repository.js';
 import { getActiveProject } from '../../../tools/project-db.js';
+import { DOC_TYPE_LABELS, PLAN_STATUS_ICONS } from '../../constants/labels.js';
 // =============================================================================
 // Constants
 // =============================================================================
 const PAGE_SIZE = 10;
-const DOC_TYPE_LABELS = {
-    'prd': 'PRD',
-    'architecture': 'ARCH',
-    'design': 'DESIGN',
-    'notes': 'NOTES',
-};
+// Status badges for plans (icon-only for compact list view)
+const PLAN_STATUS_LABELS = PLAN_STATUS_ICONS;
 const TABS = [
     { id: 'all', label: 'All' },
     { id: 'prd', label: 'PRD' },
     { id: 'architecture', label: 'ARCH' },
     { id: 'design', label: 'DESIGN' },
     { id: 'notes', label: 'NOTES' },
+    { id: 'plan', label: 'PLANS' },
 ];
 // =============================================================================
 // Docs Overlay V2
@@ -67,11 +65,16 @@ export class DocsOverlayV2 extends TabbedListOverlayV2 {
             renderItem: (doc, isSelected, styles) => {
                 const prefix = isSelected ? styles.primary('❯ ') : '  ';
                 const typeLabel = (DOC_TYPE_LABELS[doc.docType] || doc.docType).padEnd(8);
-                const title = doc.title.slice(0, 50);
+                // For plans, show status badge before title
+                let titleDisplay = doc.title.slice(0, 50);
+                if (doc.docType === 'plan' && doc.status) {
+                    const statusBadge = PLAN_STATUS_LABELS[doc.status] || '?';
+                    titleDisplay = `${statusBadge} ${titleDisplay}`;
+                }
                 if (isSelected) {
-                    return `${prefix}${styles.primaryBold(typeLabel)}  ${styles.primary(title)}`;
+                    return `${prefix}${styles.primaryBold(typeLabel)}  ${styles.primary(titleDisplay)}`;
                 }
-                return `${prefix}${styles.muted(typeLabel)}  ${styles.secondary(title)}`;
+                return `${prefix}${styles.muted(typeLabel)}  ${styles.secondary(titleDisplay)}`;
             },
             showCount: true,
             emptyMessage: resolvedProjectId === null

package/dist/ui/overlay/impl/document-detail-overlay-v2.d.ts

@@ -14,6 +14,7 @@
 import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
 import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
 import { type ProjectDocument } from '../../../db/repositories/document-repository.js';
+import type { PlanStatus } from '../../../db/schema.js';
 export interface DocumentDetailResult {
     /** Whether to go back to the document list */
     goBack: boolean;
@@ -30,6 +31,10 @@ interface DocumentDetailState {
     originalContent: string;
     showSavePrompt: boolean;
     saveMessage: string | null;
+    planStatus: PlanStatus | null;
+    showStatusMenu: boolean;
+    statusMenuIndex: number;
+    availableStatuses: PlanStatus[];
 }
 /**
  * Fullscreen document viewer and editor overlay.
@@ -61,6 +66,8 @@ export declare class DocumentDetailOverlayV2 extends BaseOverlayV2<DocumentDetai
     private handleViewModeKey;
     private handleEditModeKey;
     private handleSavePromptKey;
+    private handleStatusMenuKey;
+    private changeStatus;
     private moveCursorUp;
     private moveCursorDown;
     private moveCursorLeft;