@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/ui/overlay/impl/artifact-detail-overlay-v2.js

@@ -0,0 +1,232 @@
+/**
+ * Artifact Detail Overlay V2
+ *
+ * Fullscreen markdown artifact viewer with vim-style navigation.
+ *
+ * Features:
+ * - Full-screen artifact viewing with markdown rendering
+ * - Vim-style navigation (j/k, g/G, PgUp/PgDn)
+ * - Metadata display (type, agent, version, timestamps)
+ */
+import chalk from 'chalk';
+import { marked } from 'marked';
+import { markedTerminal } from 'marked-terminal';
+import { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
+import { getCurrentTheme } from '../../../themes/index.js';
+import * as terminal from '../../terminal.js';
+import { ARTIFACT_TYPE_LABELS } from '../../constants/labels.js';
+// =============================================================================
+// Alternate Screen Buffer Management
+// =============================================================================
+let inAlternateScreen = false;
+function enterAlternateScreen() {
+    if (inAlternateScreen)
+        return;
+    process.stdout.write('\x1b[?1049h'); // Switch to alternate screen
+    process.stdout.write('\x1b[H'); // Move cursor to home
+    inAlternateScreen = true;
+}
+function exitAlternateScreen() {
+    if (!inAlternateScreen)
+        return;
+    process.stdout.write('\x1b[?1049l'); // Switch back to main screen
+    inAlternateScreen = false;
+}
+// Ensure we exit alternate screen on process termination
+function setupAlternateScreenCleanup() {
+    const cleanup = () => {
+        exitAlternateScreen();
+    };
+    process.on('exit', cleanup);
+    process.on('SIGINT', () => {
+        cleanup();
+        process.exit(130);
+    });
+    process.on('SIGTERM', () => {
+        cleanup();
+        process.exit(143);
+    });
+}
+setupAlternateScreenCleanup();
+// =============================================================================
+// Constants
+// =============================================================================
+const TYPE_LABELS = ARTIFACT_TYPE_LABELS;
+// =============================================================================
+// Markdown Rendering Helper
+// =============================================================================
+function getThemedMarkedOptions(termWidth) {
+    const theme = getCurrentTheme();
+    const primaryColor = chalk.hex(theme.colors.primary);
+    const secondaryColor = chalk.hex(theme.colors.secondary || theme.colors.primary);
+    const mutedColor = chalk.hex(theme.colors.muted);
+    const borderColor = chalk.hex(theme.colors.border);
+    const fgColor = chalk.hex(theme.colors.foreground);
+    return {
+        showSectionPrefix: false,
+        reflowText: false,
+        width: Math.min(100, termWidth - 4),
+        unescape: true,
+        tab: 2,
+        heading: primaryColor.bold,
+        firstHeading: primaryColor.bold,
+        strong: fgColor.bold,
+        em: fgColor.italic,
+        link: secondaryColor,
+        href: secondaryColor.underline,
+        blockquote: mutedColor.italic,
+        del: mutedColor.strikethrough,
+        hr: borderColor,
+        codespan: secondaryColor,
+        code: secondaryColor,
+        html: mutedColor,
+        table: fgColor,
+        listitem: fgColor,
+        paragraph: fgColor,
+    };
+}
+function renderMarkdownSync(content, termWidth) {
+    const options = getThemedMarkedOptions(termWidth);
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any
+    marked.use(markedTerminal(options));
+    const rendered = marked.parse(content, { async: false });
+    return rendered.split('\n');
+}
+// =============================================================================
+// Artifact Detail Overlay V2
+// =============================================================================
+export class ArtifactDetailOverlayV2 extends BaseOverlayV2 {
+    // Use 'inline' type so terminal-ui doesn't clear screen - we manage alternate screen ourselves
+    type = 'inline';
+    id = 'artifact-detail-overlay-v2';
+    // Tell terminal-ui we manage our own screen buffer - skip clearing on close
+    usesAlternateScreen = true;
+    artifact;
+    constructor(artifact) {
+        // Build header with metadata
+        const theme = getCurrentTheme();
+        const termWidth = terminal.getTerminalWidth();
+        const header = [];
+        header.push(chalk.bold.hex(theme.colors.primary)(`"${artifact.name}"`));
+        header.push('');
+        const typeLabel = TYPE_LABELS[artifact.type] || artifact.type;
+        const meta = [
+            `Type: ${chalk.bold(typeLabel)}`,
+            `Agent: ${chalk.bold(`$${artifact.agent}`)}`,
+            `Version: ${String(artifact.version)}`,
+        ];
+        header.push(meta.join('  |  '));
+        const created = artifact.createdAt.toLocaleString();
+        const updated = artifact.updatedAt.toLocaleString();
+        header.push(chalk.hex(theme.colors.muted)(`Created: ${created}  |  Updated: ${updated}`));
+        header.push('');
+        if (artifact.summary) {
+            header.push(chalk.hex(theme.colors.muted)(`Summary: ${artifact.summary}`));
+            header.push('');
+        }
+        header.push(chalk.hex(theme.colors.muted)('─'.repeat(termWidth - 4)));
+        header.push('');
+        // Render markdown content
+        const contentLines = renderMarkdownSync(artifact.content, termWidth);
+        // Combine header and content
+        const renderedLines = [...header, ...contentLines];
+        super({
+            renderedLines,
+            scrollOffset: 0,
+            maxScroll: 0,
+        });
+        this.artifact = artifact;
+    }
+    /**
+     * Enter alternate screen buffer when overlay mounts.
+     */
+    onMount() {
+        enterAlternateScreen();
+        terminal.hideCursor();
+    }
+    /**
+     * Exit alternate screen buffer when overlay unmounts.
+     */
+    onUnmount() {
+        exitAlternateScreen();
+        terminal.showCursor();
+    }
+    renderContent(context) {
+        const s = context.styles;
+        const cols = context.width;
+        const rows = context.height;
+        // Calculate visible area (reserve 2 lines for footer)
+        const contentHeight = rows - 2;
+        this.state.maxScroll = Math.max(0, this.state.renderedLines.length - contentHeight + 2);
+        // Build output
+        const output = [];
+        // Render visible content lines
+        for (let i = 0; i < contentHeight; i++) {
+            const lineIndex = this.state.scrollOffset + i;
+            if (lineIndex < this.state.renderedLines.length) {
+                const line = this.state.renderedLines[lineIndex];
+                // Truncate to terminal width
+                output.push(line.slice(0, cols));
+            }
+            else {
+                output.push('');
+            }
+        }
+        // Render footer
+        const scrollInfo = this.state.maxScroll > 0
+            ? ` [${String(this.state.scrollOffset + 1)}-${String(Math.min(this.state.scrollOffset + contentHeight, this.state.renderedLines.length))}/${String(this.state.renderedLines.length)}]`
+            : '';
+        output.push(s.inverse(` q/Esc: back  j/k: scroll  g/G: top/bottom  PgUp/PgDn: page ${scrollInfo} `.padEnd(cols)));
+        return output;
+    }
+    /**
+     * Handle key events
+     */
+    handleKey(key) {
+        const termHeight = terminal.getTerminalHeight();
+        const pageSize = termHeight - 4;
+        // Scroll down: j, Down
+        if (key.name === 'j' || key.name === 'down') {
+            if (this.state.scrollOffset < this.state.maxScroll) {
+                this.state.scrollOffset++;
+            }
+            return this.rerender();
+        }
+        // Scroll up: k, Up
+        if (key.name === 'k' || key.name === 'up') {
+            if (this.state.scrollOffset > 0) {
+                this.state.scrollOffset--;
+            }
+            return this.rerender();
+        }
+        // Page down: PgDn, Space, Ctrl+d
+        if (key.name === 'pagedown' || key.name === 'space' || (key.name === 'd' && key.ctrl)) {
+            this.state.scrollOffset = Math.min(this.state.maxScroll, this.state.scrollOffset + pageSize);
+            return this.rerender();
+        }
+        // Page up: PgUp, Ctrl+b
+        if (key.name === 'pageup' || (key.name === 'b' && key.ctrl)) {
+            this.state.scrollOffset = Math.max(0, this.state.scrollOffset - pageSize);
+            return this.rerender();
+        }
+        // Go to top: g, Home
+        if (key.name === 'g' || key.name === 'home') {
+            this.state.scrollOffset = 0;
+            return this.rerender();
+        }
+        // Go to bottom: G (shift+g), End
+        if ((key.name === 'g' && key.shift) || key.name === 'end') {
+            this.state.scrollOffset = this.state.maxScroll;
+            return this.rerender();
+        }
+        // Ctrl+C: exit completely
+        if (this.isInterruptKey(key)) {
+            return this.close({ goBack: false });
+        }
+        // q, Esc: go back to list
+        if (this.isCloseKey(key)) {
+            return this.close({ goBack: true });
+        }
+        return this.noAction();
+    }
+}

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

@@ -0,0 +1,40 @@
+/**
+ * Artifact Overlay V2
+ *
+ * Browse and manage team artifacts.
+ * Uses TabbedListOverlayV2 for consistent list/tab/search behavior.
+ *
+ * Features:
+ * - Tabbed filtering by artifact type
+ * - Search with / toggle
+ * - Paginated list
+ * - Returns selected artifact for viewing in separate fullscreen overlay
+ */
+import { TabbedListOverlayV2 } from '../../base/tabbed-list-overlay-v2.js';
+import type { OverlayAction, KeyEvent } from '../types.js';
+import { type Artifact } from '../../../multi-agent/index.js';
+export interface ArtifactOverlayV2Result {
+    /** Selected artifact to view (if any) */
+    selectedArtifact?: Artifact;
+    /** Whether user cancelled (Ctrl+C or Esc) */
+    cancelled: boolean;
+}
+export declare class ArtifactOverlayV2 extends TabbedListOverlayV2<Artifact, ArtifactOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "artifact-overlay-v2";
+    private readonly projectName;
+    constructor();
+    /**
+     * Override to render project name in header
+     */
+    protected renderHeader(title: string, subtitle?: string): string[];
+    /**
+     * Override to handle item selection.
+     * Returns the selected artifact so the command handler can show it in a fullscreen overlay.
+     */
+    protected onItemSelected(artifact: Artifact): ArtifactOverlayV2Result | undefined;
+    /**
+     * Override to handle custom keys (delete)
+     */
+    handleKey(key: KeyEvent): OverlayAction<ArtifactOverlayV2Result>;
+}

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

@@ -0,0 +1,115 @@
+/**
+ * Artifact Overlay V2
+ *
+ * Browse and manage team artifacts.
+ * Uses TabbedListOverlayV2 for consistent list/tab/search behavior.
+ *
+ * Features:
+ * - Tabbed filtering by artifact type
+ * - Search with / toggle
+ * - Paginated list
+ * - Returns selected artifact for viewing in separate fullscreen overlay
+ */
+import { TabbedListOverlayV2 } from '../../base/tabbed-list-overlay-v2.js';
+import { getTeamCheckpointer, } from '../../../multi-agent/index.js';
+import { getCurrentProject } from '../../../tools/project-db.js';
+import { ARTIFACT_TYPE_LABELS } from '../../constants/labels.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const PAGE_SIZE = 10;
+const TYPE_LABELS = ARTIFACT_TYPE_LABELS;
+const TYPE_ICONS = {
+    'design': '◇', // Diamond - architecture
+    'plan': '◆', // Filled diamond - task breakdown
+    'review': '○', // Circle - feedback
+    'decision': '●', // Filled circle - decisions
+    'note': '□', // Square - general notes
+};
+const TABS = [
+    { id: 'all', label: 'All' },
+    { id: 'design', label: 'Design' },
+    { id: 'plan', label: 'Plan' },
+    { id: 'review', label: 'Review' },
+    { id: 'decision', label: 'Decision' },
+    { id: 'note', label: 'Note' },
+];
+// =============================================================================
+// Artifact Overlay V2
+// =============================================================================
+export class ArtifactOverlayV2 extends TabbedListOverlayV2 {
+    type = 'inline';
+    id = 'artifact-overlay-v2';
+    projectName;
+    constructor() {
+        const activeProject = getCurrentProject();
+        const projectId = activeProject?.id ?? null;
+        const projectName = activeProject?.displayName ?? null;
+        // Load artifacts from checkpointer
+        const checkpointer = getTeamCheckpointer();
+        const store = checkpointer.getArtifactStore(projectId);
+        const artifacts = store.list();
+        // Sort by most recently updated
+        artifacts.sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+        super({
+            title: 'Artifacts',
+            tabs: TABS,
+            items: artifacts,
+            pageSize: PAGE_SIZE,
+            filterByTab: (artifact, tabId) => {
+                if (tabId === 'all')
+                    return true;
+                return artifact.type === tabId;
+            },
+            getSearchText: (artifact) => `${artifact.name} ${artifact.type} ${artifact.agent} ${artifact.summary}`,
+            renderItem: (artifact, isSelected, styles) => {
+                const prefix = isSelected ? styles.primary('> ') : '  ';
+                const icon = TYPE_ICONS[artifact.type] || '?';
+                const typeLabel = (TYPE_LABELS[artifact.type] || artifact.type).padEnd(9);
+                // Format: [icon] TYPE     "Name" by $agent (v2)
+                const name = artifact.name.slice(0, 35);
+                const agent = `$${artifact.agent}`;
+                const version = artifact.version > 1 ? ` (v${String(artifact.version)})` : '';
+                if (isSelected) {
+                    return `${prefix}${icon} ${styles.primaryBold(typeLabel)} ${styles.primary(`"${name}"`)} ${styles.muted(`by ${agent}${version}`)}`;
+                }
+                return `${prefix}${icon} ${styles.muted(typeLabel)} ${styles.secondary(`"${name}"`)} ${styles.muted(`by ${agent}${version}`)}`;
+            },
+            showCount: true,
+            emptyMessage: projectId === null
+                ? 'No active project. Use /projects to select one.'
+                : 'No artifacts yet. Use artifact_save to create one.',
+            noResultsMessage: 'No artifacts match the search.',
+        });
+        this.projectName = projectName;
+        this.minHeight = 18;
+    }
+    /**
+     * Override to render project name in header
+     */
+    renderHeader(title, subtitle) {
+        const displaySubtitle = this.projectName || subtitle;
+        return super.renderHeader(title, displaySubtitle);
+    }
+    /**
+     * Override to handle item selection.
+     * Returns the selected artifact so the command handler can show it in a fullscreen overlay.
+     */
+    onItemSelected(artifact) {
+        return { selectedArtifact: artifact, cancelled: false };
+    }
+    /**
+     * Override to handle custom keys (delete)
+     */
+    handleKey(key) {
+        // Check for close keys first
+        if (this.isInterruptKey(key)) {
+            return this.close({ cancelled: true });
+        }
+        if (this.isCloseKey(key) && !this.state.searchMode) {
+            return this.close({ cancelled: true });
+        }
+        // Let parent handle everything else (including Enter → onItemSelected)
+        return super.handleKey(key);
+    }
+}

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

@@ -144,11 +144,8 @@ export class AskUserOverlayV2 extends BaseOverlayV2 {
         const question = this.questions[this.state.currentQuestion];
         const questionIndex = this.state.currentQuestion;
         const totalQuestions = this.questions.length;
-        // Context if provided (only on first question)
-        if (this.context && questionIndex === 0) {
-            lines.push(s.muted(' ' + this.context));
-            lines.push('');
-        }
+        // Note: context field is deprecated - agent explanations should be streamed
+        // before the tool call, not displayed inside the overlay
         // Question number and text
         lines.push(chalk.bold(` [${String(questionIndex + 1)}/${String(totalQuestions)}] ${question.question}`));
         lines.push('');

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

@@ -27,6 +27,7 @@ export interface BacklogItem {
     title: string;
     description: string;
     commit?: string;
+    owner?: string;
 }
 export interface BacklogOverlayV2Result {
     modified: boolean;
@@ -35,12 +36,14 @@ export declare class BacklogOverlayV2 extends TabbedListOverlayV2<BacklogItem, B
     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);
+    constructor(projectId?: number, teamAgentIds?: string[]);
     protected createDetailScreen(item: BacklogItem): BaseScreen | null;
     /**
      * Override handleKey to add custom behavior (Space toggle, 'a' add).