@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/ui/overlay/impl/ask-user-simple-overlay-v2.js

@@ -0,0 +1,204 @@
+/**
+ * Ask User Simple Overlay V2
+ *
+ * Simplified modal overlay for single-question input.
+ * Uses BaseOverlayV2 for TerminalUI integration.
+ *
+ * Features:
+ * - Single question (no tabs, no navigation)
+ * - Options to select from with arrow keys
+ * - Custom text input option
+ * - Simple, clean UI
+ */
+import chalk from 'chalk';
+import { BaseOverlayV2, renderBorder } from '../../base/index.js';
+// =============================================================================
+// Overlay Implementation
+// =============================================================================
+export class AskUserSimpleOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'ask-user-simple-overlay-v2';
+    question;
+    choices;
+    allowCustom;
+    constructor(options) {
+        // Determine initial state
+        const choices = options.options ?? [];
+        const allowCustom = options.allowCustom ?? true;
+        const autoTyping = choices.length === 0 && allowCustom;
+        super({
+            selectedIndex: 0,
+            inputBuffer: '',
+            isTypingCustom: autoTyping,
+        });
+        this.question = options.question;
+        this.choices = choices;
+        this.allowCustom = allowCustom;
+        this.minHeight = 10; // Prevent jitter
+    }
+    renderContent(context) {
+        const s = context.styles;
+        const lines = [];
+        const border = renderBorder(context.width, s);
+        // Header
+        lines.push(border);
+        lines.push(' ' + s.primaryBold('Question'));
+        lines.push('');
+        // Question
+        lines.push(chalk.bold(` ${this.question}`));
+        lines.push('');
+        // Options
+        const customIndex = this.choices.length;
+        for (let i = 0; i < this.choices.length; i++) {
+            const isCursor = this.state.selectedIndex === i && !this.state.isTypingCustom;
+            const prefix = isCursor ? ' > ' : '   ';
+            const num = `${String(i + 1)}. `;
+            if (isCursor) {
+                lines.push(s.primary(prefix + num + this.choices[i]));
+            }
+            else {
+                lines.push(s.muted(prefix + num + this.choices[i]));
+            }
+        }
+        // Custom input option (if allowed)
+        if (this.allowCustom) {
+            const isCursor = this.state.selectedIndex === customIndex && !this.state.isTypingCustom;
+            const prefix = isCursor ? ' > ' : '   ';
+            const num = `${String(this.choices.length + 1)}. `;
+            if (this.state.isTypingCustom) {
+                // Show input field with cursor
+                lines.push(s.primary(prefix + num + 'Custom: ') + s.primaryBold(this.state.inputBuffer + '_'));
+            }
+            else if (isCursor) {
+                lines.push(s.primary(prefix + num + 'Type something else...'));
+            }
+            else {
+                lines.push(s.muted(prefix + num + 'Type something else...'));
+            }
+        }
+        // Footer
+        lines.push('');
+        if (this.state.isTypingCustom) {
+            lines.push(s.muted(' Enter Submit | Esc Cancel'));
+        }
+        else {
+            lines.push(s.muted(' Up/Down Navigate | Enter Select | s Skip | Esc Cancel'));
+        }
+        // Bottom border
+        lines.push(border);
+        return lines;
+    }
+    handleKey(key) {
+        const customIndex = this.choices.length;
+        const optionCount = this.allowCustom ? this.choices.length + 1 : this.choices.length;
+        // Ctrl+C always cancels
+        if (key.ctrl && key.name === 'c') {
+            return this.close({ answer: '', skipped: true });
+        }
+        // If typing custom input
+        if (this.state.isTypingCustom) {
+            if (key.name === 'escape') {
+                // Cancel custom input, return to navigation
+                this.state.isTypingCustom = false;
+                this.state.inputBuffer = '';
+                return this.rerender();
+            }
+            if (key.name === 'up' && this.choices.length > 0) {
+                // Exit typing mode and navigate up (only if there are other options)
+                this.state.isTypingCustom = false;
+                this.state.inputBuffer = '';
+                this.state.selectedIndex = Math.max(0, this.state.selectedIndex - 1);
+                return this.rerender();
+            }
+            if (key.name === 'down') {
+                // Custom is last option, down arrow does nothing
+                return this.noAction();
+            }
+            if (key.name === 'return') {
+                // Submit custom input
+                const custom = this.state.inputBuffer.trim();
+                if (custom) {
+                    return this.close({ answer: custom, skipped: false });
+                }
+                // Empty - stay in custom mode
+                return this.noAction();
+            }
+            if (key.name === 'backspace') {
+                this.state.inputBuffer = this.state.inputBuffer.slice(0, -1);
+                return this.rerender();
+            }
+            // Printable character
+            if (key.char && key.char.length === 1 && !key.ctrl && !key.meta) {
+                this.state.inputBuffer += key.char;
+                return this.rerender();
+            }
+            return this.noAction();
+        }
+        // Navigation mode
+        if (key.name === 'escape') {
+            return this.close({ answer: '', skipped: true });
+        }
+        // Skip question (s key)
+        if (key.char === 's' || key.char === 'S') {
+            return this.close({ answer: '', skipped: true });
+        }
+        if (key.name === 'up') {
+            this.state.selectedIndex = Math.max(0, this.state.selectedIndex - 1);
+            // Auto-enable typing when navigating to custom option
+            if (this.allowCustom && this.state.selectedIndex === customIndex) {
+                this.state.isTypingCustom = true;
+            }
+            return this.rerender();
+        }
+        if (key.name === 'down') {
+            this.state.selectedIndex = Math.min(optionCount - 1, this.state.selectedIndex + 1);
+            // Auto-enable typing when navigating to custom option
+            if (this.allowCustom && this.state.selectedIndex === customIndex) {
+                this.state.isTypingCustom = true;
+            }
+            return this.rerender();
+        }
+        if (key.name === 'return') {
+            if (this.state.selectedIndex < this.choices.length) {
+                // Selected a predefined option
+                return this.close({ answer: this.choices[this.state.selectedIndex], skipped: false });
+            }
+            else if (this.allowCustom && this.state.selectedIndex === customIndex) {
+                // Enter custom input mode
+                this.state.isTypingCustom = true;
+                return this.rerender();
+            }
+        }
+        // Number keys 1-9
+        if (key.char && key.char >= '1' && key.char <= '9') {
+            const numIndex = parseInt(key.char, 10) - 1; // 0-indexed
+            if (numIndex < optionCount) {
+                if (numIndex < this.choices.length) {
+                    // Select predefined option directly
+                    return this.close({ answer: this.choices[numIndex], skipped: false });
+                }
+                else if (this.allowCustom && numIndex === customIndex) {
+                    // Enter custom mode
+                    this.state.selectedIndex = customIndex;
+                    this.state.isTypingCustom = true;
+                    return this.rerender();
+                }
+            }
+        }
+        return this.noAction();
+    }
+    /**
+     * Summary shown after overlay closes.
+     */
+    getCloseSummary(result) {
+        const s = this.getStyles();
+        if (result.skipped) {
+            return s.muted('Question: ') + s.warning('Skipped');
+        }
+        // Truncate long answers
+        const displayAnswer = result.answer.length > 50
+            ? result.answer.substring(0, 47) + '...'
+            : result.answer;
+        return s.muted('Question: ') + s.success(displayAnswer);
+    }
+}

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

@@ -0,0 +1,40 @@
+/**
+ * Background Agents Overlay V2
+ *
+ * Modal overlay for viewing and managing background agents.
+ * Users can see status, bring to foreground, or kill agents.
+ *
+ * Phase 3c: Background Agents
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../index.js';
+import type { BackgroundSessionInfo } from '../../../multi-agent/types.js';
+export type BackgroundOverlayResult = {
+    type: 'closed';
+} | {
+    type: 'foreground';
+    agentId: string;
+} | {
+    type: 'kill';
+    agentId: string;
+};
+interface BackgroundOverlayState {
+    /** Currently selected agent index */
+    selectedIndex: number;
+    /** Sessions snapshot */
+    sessions: BackgroundSessionInfo[];
+}
+export interface BackgroundOverlayOptions {
+    /** Function to get current background sessions */
+    getSessions: () => BackgroundSessionInfo[];
+}
+export declare class BackgroundOverlayV2 extends BaseOverlayV2<BackgroundOverlayState, BackgroundOverlayResult> {
+    readonly type: "inline";
+    readonly id = "background-overlay-v2";
+    private readonly getSessions;
+    constructor(options: BackgroundOverlayOptions);
+    protected renderContent(context: RenderContext): string[];
+    handleKey(key: KeyEvent): OverlayAction<BackgroundOverlayResult>;
+    getCloseSummary(result: BackgroundOverlayResult): string | null;
+}
+export {};

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

@@ -0,0 +1,147 @@
+/**
+ * Background Agents Overlay V2
+ *
+ * Modal overlay for viewing and managing background agents.
+ * Users can see status, bring to foreground, or kill agents.
+ *
+ * Phase 3c: Background Agents
+ */
+import chalk from 'chalk';
+import { getStyles } from '../../../themes/index.js';
+import { BaseOverlayV2 } from '../../base/index.js';
+import * as terminal from '../../terminal.js';
+// =============================================================================
+// Background Overlay V2 Class
+// =============================================================================
+export class BackgroundOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'background-overlay-v2';
+    getSessions;
+    constructor(options) {
+        const sessions = options.getSessions();
+        super({
+            selectedIndex: 0,
+            sessions,
+        });
+        this.getSessions = options.getSessions;
+        this.minHeight = 10;
+    }
+    renderContent(context) {
+        const s = context.styles;
+        const lines = [];
+        const cols = terminal.getTerminalWidth();
+        const border = s.muted('─'.repeat(Math.max(1, cols - 1)));
+        // Refresh sessions each render
+        this.state.sessions = this.getSessions();
+        // Header
+        lines.push(border);
+        lines.push(' ' + chalk.bold('Background Agents') + s.muted(` (${String(this.state.sessions.length)} running)`));
+        lines.push(border);
+        lines.push('');
+        if (this.state.sessions.length === 0) {
+            lines.push(s.muted('  No background agents running.'));
+            lines.push('');
+            lines.push(s.muted('  Start an agent in background with:'));
+            lines.push(s.info('    $agent message &'));
+            lines.push(s.muted('  or:'));
+            lines.push(s.info('    message &'));
+            lines.push('');
+        }
+        else {
+            // Render each agent
+            for (let i = 0; i < this.state.sessions.length; i++) {
+                const session = this.state.sessions[i];
+                const isSelected = i === this.state.selectedIndex;
+                const prefix = isSelected ? ' ❯ ' : '   ';
+                // Agent header: [mascot] $agent (displayName)
+                const header = `${session.mascot} $${session.agentId} (${session.displayName})`;
+                if (isSelected) {
+                    lines.push(s.primary(prefix + header));
+                }
+                else {
+                    lines.push(s.muted(prefix + header));
+                }
+                // Status line
+                let statusText;
+                if (session.isBlocked) {
+                    statusText = s.warning(`Status: blocked`) + s.muted(` · ${String(session.pendingCount)} pending request${session.pendingCount !== 1 ? 's' : ''}`);
+                }
+                else if (session.currentAction) {
+                    statusText = s.success('Status: running') + s.muted(` · ${session.currentAction}`);
+                }
+                else {
+                    statusText = s.success('Status: running');
+                }
+                // Add queue count if there are queued messages
+                if (session.queuedCount > 0) {
+                    statusText += s.muted(` · ${String(session.queuedCount)} queued`);
+                }
+                lines.push('      ' + statusText);
+                // Actions line (only for selected)
+                if (isSelected) {
+                    lines.push(s.info('      [f]oreground · [k]ill'));
+                }
+                else {
+                    lines.push('');
+                }
+                lines.push('');
+            }
+        }
+        // Footer
+        lines.push(border);
+        if (this.state.sessions.length > 0) {
+            lines.push(s.muted(' ↑↓ Navigate · f Foreground · k Kill · Esc Close'));
+        }
+        else {
+            lines.push(s.muted(' Esc Close'));
+        }
+        return lines;
+    }
+    handleKey(key) {
+        // Escape or Ctrl+C = close
+        if (key.name === 'escape' || (key.ctrl && key.name === 'c')) {
+            return this.close({ type: 'closed' });
+        }
+        // No sessions - just allow closing
+        if (this.state.sessions.length === 0) {
+            return this.rerender();
+        }
+        const keyStr = key.char?.toLowerCase() ?? '';
+        // Arrow navigation
+        if (key.name === 'up') {
+            this.state.selectedIndex = Math.max(0, this.state.selectedIndex - 1);
+            return this.rerender();
+        }
+        if (key.name === 'down') {
+            this.state.selectedIndex = Math.min(this.state.sessions.length - 1, this.state.selectedIndex + 1);
+            return this.rerender();
+        }
+        // Bring to foreground
+        if (keyStr === 'f') {
+            const session = this.state.sessions[this.state.selectedIndex];
+            if (session) {
+                return this.close({ type: 'foreground', agentId: session.agentId });
+            }
+        }
+        // Kill agent
+        if (keyStr === 'k') {
+            const session = this.state.sessions[this.state.selectedIndex];
+            if (session) {
+                return this.close({ type: 'kill', agentId: session.agentId });
+            }
+        }
+        return this.rerender();
+    }
+    getCloseSummary(result) {
+        if (result.type === 'foreground' || result.type === 'kill') {
+            // Action taken, no summary needed (action will print its own message)
+            return null;
+        }
+        const s = getStyles();
+        const count = this.state.sessions.length;
+        if (count > 0) {
+            return s.muted(`Background agents: ${String(count)} running`);
+        }
+        return null;
+    }
+}

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

@@ -0,0 +1,52 @@
+/**
+ * Backlog Overlay V2
+ *
+ * Modal overlay for viewing and managing the project backlog.
+ * Uses TabbedListOverlayV2 for consistent list/tab/search behavior.
+ *
+ * Features:
+ * - Search by title/description
+ * - Filter tabs by type (All/Feature/Bug/Tech-Debt/Chore)
+ * - Pagination for large backlogs
+ * - Quick status toggle with Space
+ * - Add new items with wizard
+ * - Database-backed with project isolation
+ */
+import { TabbedListOverlayV2, BaseScreen } from '../../base/index.js';
+import type { OverlayAction, KeyEvent } from '../types.js';
+import type { WorkItemType, WorkItemPriority } from '../../../db/schema.js';
+export type BacklogType = WorkItemType;
+export type BacklogPriority = WorkItemPriority;
+export type BacklogStatus = '📋' | '🚧' | '✅';
+export interface BacklogItem {
+    id: string;
+    dbId: number;
+    type: BacklogType;
+    status: BacklogStatus;
+    priority: BacklogPriority;
+    title: string;
+    description: string;
+    commit?: string;
+    owner?: string;
+}
+export interface BacklogOverlayV2Result {
+    modified: boolean;
+}
+export declare class BacklogOverlayV2 extends TabbedListOverlayV2<BacklogItem, BacklogOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "backlog-overlay-v2";
+    private readonly editState;
+    private readonly teamAgentIds;
+    /**
+     * @param projectId - Optional project ID to view backlog for.
+     *                    If not provided, uses the active project.
+     *                    Pass this when opening from workflow overlay for a specific project.
+     * @param teamAgentIds - List of agent IDs in the team for owner selection.
+     */
+    constructor(projectId?: number, teamAgentIds?: string[]);
+    protected createDetailScreen(item: BacklogItem): BaseScreen | null;
+    /**
+     * Override handleKey to add custom behavior (Space toggle, 'a' add).
+     */
+    handleKey(key: KeyEvent): OverlayAction<BacklogOverlayV2Result>;
+}