@compilr-dev/cli 0.4.0

package/dist/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tool Registry Setup
+ *
+ * Configures all available tools from @compilr-dev/agents
+ * and @compilr-dev/agents-coding packages.
+ */
+/**
+ * Creates the tool registry with all available tools.
+ * Returns tools as-is - the Agent.registerTools() method handles typing.
+ */
+export declare function createToolRegistry(): unknown[];
+/**
+ * Returns a minimal set of tools for basic testing.
+ */
+export declare function createMinimalToolRegistry(): unknown[];

package/dist/tools.js

@@ -0,0 +1,121 @@
+/**
+ * Tool Registry Setup
+ *
+ * Configures all available tools from @compilr-dev/agents
+ * and @compilr-dev/agents-coding packages.
+ */
+import { readFileTool, writeFileTool, createBashTool, bashOutputTool, killShellTool, grepTool, globTool, editTool, todoWriteTool as originalTodoWriteTool, todoReadTool, defineTool, } from '@compilr-dev/agents';
+const todoWriteTool = defineTool({
+    name: 'todo_write',
+    description: 'Update the task list. Provide the complete list of todos. ' +
+        'Use this to track progress on multi-step tasks.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            todos: {
+                type: 'array',
+                description: 'The complete list of todos',
+                items: {
+                    type: 'object',
+                    properties: {
+                        content: {
+                            type: 'string',
+                            description: 'Task description (imperative form, e.g., "Fix bug in login")',
+                        },
+                        status: {
+                            type: 'string',
+                            enum: ['pending', 'in_progress', 'completed'],
+                            description: 'Task status',
+                        },
+                        activeForm: {
+                            type: 'string',
+                            description: 'Active form (present continuous, e.g., "Fixing bug in login")',
+                        },
+                        priority: {
+                            type: 'number',
+                            description: 'Priority (higher = more important)',
+                        },
+                    },
+                    required: ['content', 'status'],
+                },
+            },
+        },
+        required: ['todos'],
+    },
+    execute: async (input) => {
+        // Normalize todos - accept alternative property names
+        const normalizedTodos = input.todos.map((todo) => ({
+            content: (todo.content || todo.title || todo.description || todo.task || todo.text || '').trim(),
+            status: todo.status,
+            activeForm: todo.activeForm,
+            priority: todo.priority,
+        }));
+        // Filter out empty todos and provide fallback
+        const validTodos = normalizedTodos.map((todo) => ({
+            ...todo,
+            content: todo.content || 'Untitled task',
+        }));
+        // Debug: log what we're sending (can be removed later)
+        // console.error('[DEBUG todo_write] Input:', JSON.stringify(input, null, 2));
+        // console.error('[DEBUG todo_write] Normalized:', JSON.stringify(validTodos, null, 2));
+        // Call the original tool with normalized input
+        const result = await originalTodoWriteTool.execute({ todos: validTodos });
+        // Debug: log result
+        // console.error('[DEBUG todo_write] Result:', JSON.stringify(result, null, 2));
+        return result;
+    },
+});
+// Create bash tool with longer timeout (2 minutes instead of 30 seconds)
+const bashTool = createBashTool({
+    timeout: 120000, // 2 minutes
+});
+import { gitStatusTool, gitDiffTool, gitLogTool, gitCommitTool, gitBranchTool, detectProjectTool, findProjectRootTool, runTestsTool, runLintTool, } from '@compilr-dev/agents-coding';
+// Local tools
+import { backlogReadTool, backlogWriteTool } from './tools/backlog.js';
+import { askUserTool } from './tools/ask-user.js';
+import { askUserSimpleTool } from './tools/ask-user-simple.js';
+/**
+ * Creates the tool registry with all available tools.
+ * Returns tools as-is - the Agent.registerTools() method handles typing.
+ */
+export function createToolRegistry() {
+    return [
+        // Built-in tools from @compilr-dev/agents
+        readFileTool,
+        writeFileTool,
+        bashTool,
+        bashOutputTool, // Monitor background processes
+        killShellTool, // Terminate background processes
+        grepTool,
+        globTool,
+        editTool,
+        todoWriteTool,
+        todoReadTool,
+        // Coding tools from @compilr-dev/agents-coding
+        gitStatusTool,
+        gitDiffTool,
+        gitLogTool,
+        gitCommitTool,
+        gitBranchTool,
+        detectProjectTool,
+        findProjectRootTool,
+        runTestsTool,
+        runLintTool,
+        // Local tools
+        backlogReadTool,
+        backlogWriteTool,
+        askUserTool,
+        askUserSimpleTool,
+    ];
+}
+/**
+ * Returns a minimal set of tools for basic testing.
+ */
+export function createMinimalToolRegistry() {
+    return [
+        readFileTool,
+        writeFileTool,
+        bashTool,
+        globTool,
+    ];
+}

package/dist/ui/agents-overlay.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Agents Overlay
+ *
+ * Modal overlay for viewing and managing agent configurations.
+ * - Built-in tab: Lists 9 predefined agent types
+ * - Custom tab: Lists user-defined agents + create new option
+ * - Wizard mode: Step-by-step agent creation
+ */
+/**
+ * Show the agents overlay
+ */
+export declare function showAgentsOverlay(): Promise<void>;

package/dist/ui/agents-overlay.js

@@ -0,0 +1,501 @@
+/**
+ * Agents Overlay
+ *
+ * Modal overlay for viewing and managing agent configurations.
+ * - Built-in tab: Lists 9 predefined agent types
+ * - Custom tab: Lists user-defined agents + create new option
+ * - Wizard mode: Step-by-step agent creation
+ */
+import * as terminal from './terminal.js';
+import { getStyles } from '../themes/index.js';
+import { getAgentRegistry } from '../agents/registry.js';
+const TABS = [
+    { id: 'builtin', label: 'built-in' },
+    { id: 'custom', label: 'custom' },
+];
+// =============================================================================
+// Rendering - List Mode
+// =============================================================================
+function renderListHeader(state) {
+    const s = getStyles();
+    const lines = [];
+    const cols = terminal.getTerminalWidth();
+    lines.push(s.muted('─'.repeat(Math.max(1, cols - 1))));
+    let tabLine = ' ' + s.primaryBold('Agents') + '  ';
+    for (let i = 0; i < TABS.length; i++) {
+        const tab = TABS[i];
+        if (i === state.currentTab) {
+            tabLine += s.selected(` ${tab.label} `) + '  ';
+        }
+        else {
+            tabLine += s.muted(` ${tab.label} `) + '  ';
+        }
+    }
+    tabLine += s.muted('(Tab to switch)');
+    lines.push(tabLine);
+    lines.push('');
+    return lines;
+}
+function renderBuiltinTab(state) {
+    const s = getStyles();
+    const lines = [];
+    const agents = state.registry.getBuiltinAgents();
+    lines.push(s.secondary(' Built-in agents (via Task tool):'));
+    lines.push('');
+    for (let i = 0; i < agents.length; i++) {
+        const agent = agents[i];
+        const isSelected = i === state.selectedIndex;
+        const prefix = isSelected ? s.primary(' ❯ ') : '   ';
+        const name = `${agent.name} · ${agent.model}`;
+        const nameStyled = isSelected ? s.primary(name.padEnd(30)) : s.secondary(name.padEnd(30));
+        const desc = s.muted(agent.description);
+        lines.push(prefix + nameStyled + desc);
+    }
+    lines.push('');
+    lines.push(s.muted(' These agents are available to the LLM via the Task tool.'));
+    return lines;
+}
+function renderCustomTab(state) {
+    const s = getStyles();
+    const lines = [];
+    const agents = state.registry.getCustomAgents();
+    if (agents.length === 0) {
+        lines.push(s.muted(' No custom agents found'));
+        lines.push('');
+        lines.push(state.selectedIndex === 0
+            ? s.primary(' ❯ Create new agent')
+            : s.muted('   Create new agent'));
+        lines.push('');
+        lines.push(s.muted(' Custom agents are stored in:'));
+        lines.push(s.muted(`   ${state.registry.getProjectDir()}/     (project)`));
+        lines.push(s.muted(`   ${state.registry.getUserDir()}/   (personal)`));
+    }
+    else {
+        lines.push(s.secondary(' Custom agents:'));
+        lines.push('');
+        for (let i = 0; i < agents.length; i++) {
+            const agent = agents[i];
+            const isSelected = i === state.selectedIndex;
+            const prefix = isSelected ? s.primary(' ❯ ') : '   ';
+            const name = `${agent.name} · ${agent.model}`;
+            const nameStyled = isSelected ? s.primary(name.padEnd(30)) : s.secondary(name.padEnd(30));
+            const location = s.muted(`(${agent.location})`);
+            lines.push(prefix + nameStyled + location);
+        }
+        lines.push(s.muted(' ──────────────────────────────────'));
+        const createIdx = agents.length;
+        const isCreateSelected = state.selectedIndex === createIdx;
+        lines.push(isCreateSelected
+            ? s.primary(' ❯ Create new agent')
+            : s.muted('   Create new agent'));
+    }
+    return lines;
+}
+function renderListFooter() {
+    const s = getStyles();
+    const lines = [];
+    lines.push('');
+    lines.push(s.muted(' ↑↓ Navigate · Tab Switch · Enter Select · Esc Close'));
+    return lines;
+}
+function buildListLines(state) {
+    const allLines = [];
+    allLines.push(...renderListHeader(state));
+    if (TABS[state.currentTab].id === 'builtin') {
+        allLines.push(...renderBuiltinTab(state));
+    }
+    else {
+        allLines.push(...renderCustomTab(state));
+    }
+    allLines.push(...renderListFooter());
+    return allLines;
+}
+// =============================================================================
+// Rendering - Wizard Mode
+// =============================================================================
+function buildWizardLines(state) {
+    const s = getStyles();
+    const lines = [];
+    const cols = terminal.getTerminalWidth();
+    lines.push(s.muted('─'.repeat(Math.max(1, cols - 1))));
+    lines.push(' ' + s.primaryBold('Create new agent'));
+    lines.push('');
+    switch (state.wizardStep) {
+        case 'location':
+            lines.push(s.secondary(' Choose location'));
+            lines.push('');
+            lines.push(state.wizardSelectedOption === 0
+                ? s.primary(' ❯ 1. Project (.compilr-dev/agents/)')
+                : s.muted('   1. Project (.compilr-dev/agents/)'));
+            lines.push(state.wizardSelectedOption === 1
+                ? s.primary(' ❯ 2. Personal (~/.compilr-dev/agents/)')
+                : s.muted('   2. Personal (~/.compilr-dev/agents/)'));
+            lines.push('');
+            lines.push(s.muted(' Project agents are shared with your team.'));
+            lines.push(s.muted(' Personal agents apply to all your projects.'));
+            break;
+        case 'name':
+            lines.push(s.secondary(' Agent name (identifier)'));
+            lines.push('');
+            lines.push(' Enter a unique identifier:');
+            lines.push(` > ${state.wizardInputBuffer}█`);
+            lines.push('');
+            if (state.wizardError) {
+                lines.push(s.error(` ${state.wizardError}`));
+            }
+            else {
+                lines.push(s.muted(' Use lowercase letters, numbers, hyphens (e.g., code-reviewer)'));
+            }
+            break;
+        case 'prompt':
+            lines.push(s.secondary(' System prompt'));
+            lines.push('');
+            lines.push(' Enter the agent\'s instructions:');
+            lines.push(` > ${state.wizardInputBuffer}█`);
+            lines.push('');
+            lines.push(s.muted(' This defines how the agent behaves.'));
+            lines.push(s.muted(' Press Enter to continue.'));
+            break;
+        case 'description':
+            lines.push(s.secondary(' Description'));
+            lines.push('');
+            lines.push(' When should the LLM use this agent?');
+            lines.push(` > ${state.wizardInputBuffer}█`);
+            lines.push('');
+            lines.push(s.muted(' This helps the LLM know when to invoke this agent.'));
+            break;
+        case 'model': {
+            lines.push(s.secondary(' Select model'));
+            lines.push('');
+            const models = [
+                { id: 'sonnet', label: 'Sonnet', desc: 'Balanced (recommended)' },
+                { id: 'opus', label: 'Opus', desc: 'Most capable' },
+                { id: 'haiku', label: 'Haiku', desc: 'Fast and efficient' },
+                { id: 'inherit', label: 'Inherit', desc: 'Use parent\'s model' },
+            ];
+            for (let i = 0; i < models.length; i++) {
+                const m = models[i];
+                const isSelected = state.wizardSelectedOption === i;
+                const prefix = isSelected ? s.primary(' ❯ ') : '   ';
+                const label = isSelected
+                    ? s.primary(`${String(i + 1)}. ${m.label.padEnd(10)} - ${m.desc}`)
+                    : s.muted(`${String(i + 1)}. ${m.label.padEnd(10)} - ${m.desc}`);
+                lines.push(prefix + label);
+            }
+            break;
+        }
+        case 'confirm':
+            lines.push(s.secondary(' Confirm'));
+            lines.push('');
+            lines.push(` Name:        ${s.primary(state.wizardName)}`);
+            lines.push(` Location:    ${s.primary(state.wizardLocation === 'project' ? '.compilr-dev/agents/' : '~/.compilr-dev/agents/')}${state.wizardName}.md`);
+            lines.push(` Model:       ${s.primary(state.wizardModel)}`);
+            lines.push('');
+            lines.push(s.secondary(' Description:'));
+            lines.push(s.muted(`   ${state.wizardDescription.slice(0, 60)}${state.wizardDescription.length > 60 ? '...' : ''}`));
+            lines.push('');
+            lines.push(s.secondary(' System prompt:'));
+            lines.push(s.muted(`   ${state.wizardPrompt.slice(0, 60)}${state.wizardPrompt.length > 60 ? '...' : ''}`));
+            lines.push('');
+            lines.push(state.wizardSelectedOption === 0
+                ? s.primary(' ❯ Save')
+                : s.muted('   Save'));
+            lines.push(state.wizardSelectedOption === 1
+                ? s.primary(' ❯ Cancel')
+                : s.muted('   Cancel'));
+            break;
+    }
+    lines.push('');
+    lines.push(s.muted(' Esc to go back'));
+    return lines;
+}
+// =============================================================================
+// Unified Rendering
+// =============================================================================
+function buildLines(state) {
+    if (state.mode === 'wizard') {
+        return buildWizardLines(state);
+    }
+    return buildListLines(state);
+}
+function render(state, prevLineCount) {
+    const lines = buildLines(state);
+    // Clear previous content
+    terminal.clearLinesAbove(prevLineCount);
+    // Write new content
+    terminal.write(lines.join('\n'));
+    return lines.length;
+}
+// =============================================================================
+// Main Export
+// =============================================================================
+/**
+ * Show the agents overlay
+ */
+export async function showAgentsOverlay() {
+    const registry = getAgentRegistry();
+    registry.load();
+    const state = {
+        mode: 'list',
+        currentTab: 0,
+        selectedIndex: 0,
+        wizardStep: 'location',
+        wizardLocation: 'project',
+        wizardName: '',
+        wizardPrompt: '',
+        wizardDescription: '',
+        wizardModel: 'sonnet',
+        wizardSelectedOption: 0,
+        wizardInputBuffer: '',
+        wizardError: null,
+        registry,
+    };
+    let lineCount = 0;
+    terminal.writeLine('');
+    terminal.hideCursor();
+    const wasRawMode = process.stdin.isRaw;
+    terminal.enableRawMode();
+    lineCount = render(state, 0);
+    const getMaxIndex = () => {
+        if (TABS[state.currentTab].id === 'builtin') {
+            return state.registry.getBuiltinAgents().length - 1;
+        }
+        else {
+            return state.registry.getCustomAgents().length; // includes "Create new"
+        }
+    };
+    // Reset wizard state for a new creation
+    const resetWizard = () => {
+        state.wizardStep = 'location';
+        state.wizardLocation = 'project';
+        state.wizardName = '';
+        state.wizardPrompt = '';
+        state.wizardDescription = '';
+        state.wizardModel = 'sonnet';
+        state.wizardSelectedOption = 0;
+        state.wizardInputBuffer = '';
+        state.wizardError = null;
+    };
+    // Wizard: advance to next step
+    const wizardNextStep = () => {
+        switch (state.wizardStep) {
+            case 'location':
+                state.wizardLocation = state.wizardSelectedOption === 0 ? 'project' : 'personal';
+                state.wizardStep = 'name';
+                state.wizardInputBuffer = '';
+                break;
+            case 'name':
+                state.wizardName = state.wizardInputBuffer.trim();
+                state.wizardStep = 'prompt';
+                state.wizardInputBuffer = '';
+                break;
+            case 'prompt':
+                state.wizardPrompt = state.wizardInputBuffer.trim();
+                state.wizardStep = 'description';
+                state.wizardInputBuffer = '';
+                break;
+            case 'description':
+                state.wizardDescription = state.wizardInputBuffer.trim();
+                state.wizardStep = 'model';
+                state.wizardSelectedOption = 0;
+                break;
+            case 'model': {
+                const models = ['sonnet', 'opus', 'haiku', 'inherit'];
+                state.wizardModel = models[state.wizardSelectedOption];
+                state.wizardStep = 'confirm';
+                state.wizardSelectedOption = 0;
+                break;
+            }
+            case 'confirm':
+                if (state.wizardSelectedOption === 0) {
+                    // Save
+                    try {
+                        registry.saveAgent({
+                            name: state.wizardName,
+                            description: state.wizardDescription,
+                            model: state.wizardModel,
+                            systemPrompt: state.wizardPrompt,
+                        }, state.wizardLocation);
+                        // Success - go back to list
+                        registry.load();
+                        state.mode = 'list';
+                        state.selectedIndex = 0;
+                        return true; // Created successfully
+                    }
+                    catch (error) {
+                        state.wizardError = error.message;
+                    }
+                }
+                else {
+                    // Cancel - go back to list
+                    state.mode = 'list';
+                }
+                break;
+        }
+        state.wizardError = null;
+        return false;
+    };
+    // Wizard: go back to previous step (or exit wizard)
+    const wizardPrevStep = () => {
+        switch (state.wizardStep) {
+            case 'location':
+                // Exit wizard, go back to list
+                state.mode = 'list';
+                break;
+            case 'name':
+                state.wizardStep = 'location';
+                state.wizardSelectedOption = state.wizardLocation === 'project' ? 0 : 1;
+                break;
+            case 'prompt':
+                state.wizardStep = 'name';
+                state.wizardInputBuffer = state.wizardName;
+                break;
+            case 'description':
+                state.wizardStep = 'prompt';
+                state.wizardInputBuffer = state.wizardPrompt;
+                break;
+            case 'model':
+                state.wizardStep = 'description';
+                state.wizardInputBuffer = state.wizardDescription;
+                break;
+            case 'confirm': {
+                state.wizardStep = 'model';
+                const models = ['sonnet', 'opus', 'haiku', 'inherit'];
+                state.wizardSelectedOption = models.indexOf(state.wizardModel);
+                break;
+            }
+        }
+        state.wizardError = null;
+    };
+    return new Promise((resolve) => {
+        const cleanup = () => {
+            terminal.clearLinesAbove(lineCount);
+            terminal.writeLine('');
+            terminal.showCursor();
+            if (!wasRawMode) {
+                terminal.disableRawMode();
+            }
+            process.stdin.removeListener('data', onData);
+        };
+        const onData = (data) => {
+            const isEscape = data.length === 1 && data[0] === 0x1b;
+            const isTab = data.length === 1 && data[0] === 0x09;
+            const isUpArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x41;
+            const isDownArrow = data.length === 3 && data[0] === 0x1b && data[1] === 0x5b && data[2] === 0x42;
+            const isCtrlC = data.length === 1 && data[0] === 0x03;
+            const isEnter = data.length === 1 && (data[0] === 0x0d || data[0] === 0x0a);
+            const isBackspace = data.length === 1 && (data[0] === 0x7f || data[0] === 0x08);
+            // ===== LIST MODE =====
+            if (state.mode === 'list') {
+                if (isEscape || isCtrlC) {
+                    cleanup();
+                    resolve();
+                    return;
+                }
+                if (isTab) {
+                    state.currentTab = (state.currentTab + 1) % TABS.length;
+                    state.selectedIndex = 0;
+                    lineCount = render(state, lineCount);
+                    return;
+                }
+                if (isUpArrow && state.selectedIndex > 0) {
+                    state.selectedIndex--;
+                    lineCount = render(state, lineCount);
+                    return;
+                }
+                if (isDownArrow && state.selectedIndex < getMaxIndex()) {
+                    state.selectedIndex++;
+                    lineCount = render(state, lineCount);
+                    return;
+                }
+                if (isEnter) {
+                    if (TABS[state.currentTab].id === 'custom') {
+                        const customAgents = state.registry.getCustomAgents();
+                        if (state.selectedIndex === customAgents.length) {
+                            // "Create new agent" selected - enter wizard mode
+                            resetWizard();
+                            state.mode = 'wizard';
+                            lineCount = render(state, lineCount);
+                        }
+                    }
+                    return;
+                }
+                return;
+            }
+            // ===== WIZARD MODE =====
+            // Mode is always 'wizard' at this point since we're in the else block
+            {
+                if (isCtrlC) {
+                    cleanup();
+                    resolve();
+                    return;
+                }
+                if (isEscape) {
+                    wizardPrevStep();
+                    lineCount = render(state, lineCount);
+                    return;
+                }
+                // Input steps: name, prompt, description
+                if (['name', 'prompt', 'description'].includes(state.wizardStep)) {
+                    if (isEnter) {
+                        if (state.wizardInputBuffer.trim()) {
+                            // Validate name
+                            if (state.wizardStep === 'name') {
+                                const name = state.wizardInputBuffer.trim();
+                                if (!/^[a-z][a-z0-9-]{1,49}$/.test(name)) {
+                                    state.wizardError = 'Invalid name. Use lowercase letters, numbers, hyphens.';
+                                    lineCount = render(state, lineCount);
+                                    return;
+                                }
+                                if (registry.hasAgent(name)) {
+                                    state.wizardError = `Agent "${name}" already exists.`;
+                                    lineCount = render(state, lineCount);
+                                    return;
+                                }
+                            }
+                            wizardNextStep();
+                            lineCount = render(state, lineCount);
+                        }
+                        return;
+                    }
+                    if (isBackspace) {
+                        state.wizardInputBuffer = state.wizardInputBuffer.slice(0, -1);
+                        state.wizardError = null;
+                        lineCount = render(state, lineCount);
+                        return;
+                    }
+                    // Regular character input
+                    const char = data.toString('utf-8');
+                    if (char.length === 1 && char.charCodeAt(0) >= 32) {
+                        state.wizardInputBuffer += char;
+                        state.wizardError = null;
+                        lineCount = render(state, lineCount);
+                    }
+                    return;
+                }
+                // Selection steps: location, model, confirm
+                if (['location', 'model', 'confirm'].includes(state.wizardStep)) {
+                    let maxOptions = 2;
+                    if (state.wizardStep === 'model')
+                        maxOptions = 4;
+                    if (isUpArrow && state.wizardSelectedOption > 0) {
+                        state.wizardSelectedOption--;
+                        lineCount = render(state, lineCount);
+                        return;
+                    }
+                    if (isDownArrow && state.wizardSelectedOption < maxOptions - 1) {
+                        state.wizardSelectedOption++;
+                        lineCount = render(state, lineCount);
+                        return;
+                    }
+                    if (isEnter) {
+                        wizardNextStep();
+                        lineCount = render(state, lineCount);
+                        return;
+                    }
+                }
+            }
+        };
+        process.stdin.on('data', onData);
+    });
+}

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

@@ -0,0 +1,20 @@
+/**
+ * Architecture Type Selection Overlay
+ *
+ * Shows options for what type of architecture documentation to create.
+ * User selects from:
+ * - ADR (Architecture Decision Record)
+ * - System Diagram
+ * - Data Model
+ * - API Design
+ * - Custom topic
+ */
+export type ArchDocType = 'adr' | 'diagram' | 'data-model' | 'api' | 'custom';
+export interface ArchTypeChoice {
+    type: ArchDocType;
+    customTopic?: string;
+}
+/**
+ * Show the architecture type selection overlay and return the user's choice.
+ */
+export declare function showArchTypeOverlay(): Promise<ArchTypeChoice | null>;