@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/ui/overlay/impl/arch-type-overlay-v2.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Architecture Type Selection Overlay V2
+ *
+ * Shows options for what type of architecture documentation to create.
+ * Uses BaseOverlayV2 for TerminalUI integration.
+ *
+ * Has two "screens":
+ * - Select: Choose from predefined doc types
+ * - Custom input: Enter a custom topic
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+export type ArchDocType = 'adr' | 'diagram' | 'data-model' | 'api' | 'custom';
+export interface ArchTypeChoiceV2 {
+    type: ArchDocType;
+    customTopic?: string;
+}
+type ScreenMode = 'select' | 'custom-input';
+interface ArchTypeState {
+    mode: ScreenMode;
+    selectedIndex: number;
+    inputBuffer: string;
+    inputCursorPos: number;
+}
+export declare class ArchTypeOverlayV2 extends BaseOverlayV2<ArchTypeState, ArchTypeChoiceV2 | null> {
+    readonly type: "inline";
+    readonly id = "arch-type-overlay-v2";
+    constructor();
+    protected renderContent(context: RenderContext): string[];
+    private renderSelectScreen;
+    private renderCustomInputScreen;
+    handleKey(key: KeyEvent): OverlayAction<ArchTypeChoiceV2 | null>;
+    private handleSelectKey;
+    private handleCustomInputKey;
+    getCloseSummary(result: ArchTypeChoiceV2 | null): string | null;
+}
+export {};

package/dist/ui/overlay/impl/arch-type-overlay-v2.js

@@ -0,0 +1,240 @@
+/**
+ * Architecture Type Selection Overlay V2
+ *
+ * Shows options for what type of architecture documentation to create.
+ * Uses BaseOverlayV2 for TerminalUI integration.
+ *
+ * Has two "screens":
+ * - Select: Choose from predefined doc types
+ * - Custom input: Enter a custom topic
+ */
+import { BaseOverlayV2, renderBorder } from '../../base/index.js';
+const ARCH_OPTIONS = [
+    { type: 'adr', label: 'Decision Record (ADR)', description: '"Why we chose X over Y"' },
+    { type: 'diagram', label: 'System Diagram', description: 'Mermaid component diagram' },
+    { type: 'data-model', label: 'Data Model', description: 'Entities and relationships' },
+    { type: 'api', label: 'API Design', description: 'Endpoints and contracts' },
+    { type: 'custom', label: 'Custom topic...', description: 'Specify your own' },
+];
+// =============================================================================
+// Overlay Implementation
+// =============================================================================
+export class ArchTypeOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'arch-type-overlay-v2';
+    constructor() {
+        super({
+            mode: 'select',
+            selectedIndex: 0,
+            inputBuffer: '',
+            inputCursorPos: 0,
+        });
+        this.minHeight = 14; // Prevent jitter between screens
+    }
+    // ===========================================================================
+    // Rendering
+    // ===========================================================================
+    renderContent(context) {
+        if (this.state.mode === 'select') {
+            return this.renderSelectScreen(context);
+        }
+        else {
+            return this.renderCustomInputScreen(context);
+        }
+    }
+    renderSelectScreen(context) {
+        const s = context.styles;
+        const lines = [];
+        const border = renderBorder(context.width, s);
+        // Header
+        lines.push(border);
+        lines.push(' ' + s.primary('Architecture Documentation'));
+        lines.push('');
+        // Question
+        lines.push(' What would you like to document?');
+        lines.push('');
+        // Options
+        const maxLabelLen = Math.max(...ARCH_OPTIONS.map((o) => o.label.length));
+        for (let i = 0; i < ARCH_OPTIONS.length; i++) {
+            const opt = ARCH_OPTIONS[i];
+            const isCursor = this.state.selectedIndex === i;
+            const prefix = isCursor ? ' > ' : '   ';
+            const paddedLabel = opt.label.padEnd(maxLabelLen + 2);
+            if (isCursor) {
+                lines.push(s.primary(`${prefix}${paddedLabel}`) + s.muted(opt.description));
+            }
+            else {
+                lines.push(s.muted(`${prefix}${paddedLabel}${opt.description}`));
+            }
+        }
+        // Footer
+        lines.push('');
+        lines.push(s.muted(' Up/Down Navigate | Enter Select | q/Esc Cancel'));
+        lines.push(border);
+        return lines;
+    }
+    renderCustomInputScreen(context) {
+        const s = context.styles;
+        const lines = [];
+        const border = renderBorder(context.width, s);
+        // Header
+        lines.push(border);
+        lines.push(' ' + s.primary('Custom Architecture Topic'));
+        lines.push('');
+        // Input field
+        lines.push(' Enter the topic you want to document:');
+        lines.push('');
+        // Render input with cursor
+        const displayValue = this.state.inputBuffer || s.muted('e.g., Security Architecture');
+        if (this.state.inputBuffer) {
+            // Show cursor position
+            const before = this.state.inputBuffer.slice(0, this.state.inputCursorPos);
+            const after = this.state.inputBuffer.slice(this.state.inputCursorPos);
+            lines.push(` > ${before}|${after}`);
+        }
+        else {
+            lines.push(` > |${displayValue}`);
+        }
+        lines.push('');
+        // Footer
+        lines.push(s.muted(' Enter Confirm | Esc Back | Left/Right Move cursor'));
+        lines.push(border);
+        return lines;
+    }
+    // ===========================================================================
+    // Key Handling
+    // ===========================================================================
+    handleKey(key) {
+        // Ctrl+C always cancels
+        if (this.isInterruptKey(key)) {
+            return this.close(null);
+        }
+        if (this.state.mode === 'select') {
+            return this.handleSelectKey(key);
+        }
+        else {
+            return this.handleCustomInputKey(key);
+        }
+    }
+    handleSelectKey(key) {
+        // Close keys (q or Escape)
+        if (this.isCloseKey(key)) {
+            return this.close(null);
+        }
+        // Navigation up
+        if (this.isUpKey(key)) {
+            this.state.selectedIndex = Math.max(0, this.state.selectedIndex - 1);
+            return this.rerender();
+        }
+        // Navigation down
+        if (this.isDownKey(key)) {
+            this.state.selectedIndex = Math.min(ARCH_OPTIONS.length - 1, this.state.selectedIndex + 1);
+            return this.rerender();
+        }
+        // Enter - select option
+        if (this.isEnterKey(key)) {
+            const selected = ARCH_OPTIONS[this.state.selectedIndex];
+            if (selected.type === 'custom') {
+                // Switch to custom input screen
+                this.state.mode = 'custom-input';
+                this.state.inputBuffer = '';
+                this.state.inputCursorPos = 0;
+                return this.rerender();
+            }
+            return this.close({ type: selected.type });
+        }
+        return this.noAction();
+    }
+    handleCustomInputKey(key) {
+        // Escape goes back to select screen
+        if (key.name === 'escape') {
+            this.state.mode = 'select';
+            return this.rerender();
+        }
+        // Enter confirms input
+        if (this.isEnterKey(key)) {
+            const value = this.state.inputBuffer.trim();
+            if (value) {
+                return this.close({ type: 'custom', customTopic: value });
+            }
+            // Don't allow empty - just ignore enter
+            return this.noAction();
+        }
+        // Backspace
+        if (key.name === 'backspace') {
+            if (this.state.inputCursorPos > 0) {
+                const before = this.state.inputBuffer.slice(0, this.state.inputCursorPos - 1);
+                const after = this.state.inputBuffer.slice(this.state.inputCursorPos);
+                this.state.inputBuffer = before + after;
+                this.state.inputCursorPos--;
+                return this.rerender();
+            }
+            return this.noAction();
+        }
+        // Delete
+        if (key.name === 'delete') {
+            if (this.state.inputCursorPos < this.state.inputBuffer.length) {
+                const before = this.state.inputBuffer.slice(0, this.state.inputCursorPos);
+                const after = this.state.inputBuffer.slice(this.state.inputCursorPos + 1);
+                this.state.inputBuffer = before + after;
+                return this.rerender();
+            }
+            return this.noAction();
+        }
+        // Left arrow - move cursor
+        if (key.name === 'left') {
+            if (this.state.inputCursorPos > 0) {
+                this.state.inputCursorPos--;
+                return this.rerender();
+            }
+            return this.noAction();
+        }
+        // Right arrow - move cursor
+        if (key.name === 'right') {
+            if (this.state.inputCursorPos < this.state.inputBuffer.length) {
+                this.state.inputCursorPos++;
+                return this.rerender();
+            }
+            return this.noAction();
+        }
+        // Home - move to start
+        if (key.name === 'home') {
+            this.state.inputCursorPos = 0;
+            return this.rerender();
+        }
+        // End - move to end
+        if (key.name === 'end') {
+            this.state.inputCursorPos = this.state.inputBuffer.length;
+            return this.rerender();
+        }
+        // Regular character input
+        if (key.char && key.char.length === 1 && key.char >= ' ' && key.char <= '~') {
+            const before = this.state.inputBuffer.slice(0, this.state.inputCursorPos);
+            const after = this.state.inputBuffer.slice(this.state.inputCursorPos);
+            this.state.inputBuffer = before + key.char + after;
+            this.state.inputCursorPos++;
+            return this.rerender();
+        }
+        return this.noAction();
+    }
+    // ===========================================================================
+    // Close Summary
+    // ===========================================================================
+    getCloseSummary(result) {
+        const s = this.getStyles();
+        if (!result) {
+            return s.muted('Arch: ') + s.warning('Cancelled');
+        }
+        if (result.customTopic) {
+            return s.muted('Arch: ') + s.primary(`Custom: ${result.customTopic}`);
+        }
+        const labels = {
+            'adr': 'ADR',
+            'diagram': 'Diagram',
+            'data-model': 'Data Model',
+            'api': 'API Design',
+            'custom': 'Custom',
+        };
+        return s.muted('Arch: ') + s.primary(labels[result.type]);
+    }
+}

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

@@ -0,0 +1,43 @@
+/**
+ * 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 { BaseOverlayV2 } from '../../base/overlay-base-v2.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+import type { Artifact } from '../../../multi-agent/index.js';
+export interface ArtifactDetailOverlayV2Result {
+    /** Whether user pressed Esc/q to go back to list */
+    goBack: boolean;
+}
+interface ArtifactDetailState {
+    renderedLines: string[];
+    scrollOffset: number;
+    maxScroll: number;
+}
+export declare class ArtifactDetailOverlayV2 extends BaseOverlayV2<ArtifactDetailState, ArtifactDetailOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "artifact-detail-overlay-v2";
+    readonly usesAlternateScreen = true;
+    private readonly artifact;
+    constructor(artifact: Artifact);
+    /**
+     * Enter alternate screen buffer when overlay mounts.
+     */
+    onMount(): void;
+    /**
+     * Exit alternate screen buffer when overlay unmounts.
+     */
+    onUnmount(): void;
+    protected renderContent(context: RenderContext): string[];
+    /**
+     * Handle key events
+     */
+    handleKey(key: KeyEvent): OverlayAction<ArtifactDetailOverlayV2Result>;
+}
+export {};

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>;
+}