@compilr-dev/cli 0.4.0

package/dist/agents/registry.js

@@ -0,0 +1,238 @@
+/**
+ * Agent Registry
+ *
+ * Handles loading, saving, and managing agent definitions.
+ * Loads from both project (.compilr-dev/agents/) and user (~/.compilr-dev/agents/) directories.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { BUILTIN_AGENTS, PROJECT_AGENTS_DIR, USER_AGENTS_DIR, isValidAgentName, isBuiltinAgentName, } from './types.js';
+/**
+ * Parse a markdown file with YAML frontmatter
+ */
+function parseAgentFile(content) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        return null;
+    }
+    const yamlContent = frontmatterMatch[1];
+    const markdownContent = frontmatterMatch[2].trim();
+    // Simple YAML parsing (key: value)
+    const frontmatter = {};
+    for (const line of yamlContent.split('\n')) {
+        const match = line.match(/^(\w+):\s*(.*)$/);
+        if (match) {
+            frontmatter[match[1]] = match[2].trim();
+        }
+    }
+    return {
+        frontmatter: frontmatter,
+        content: markdownContent,
+    };
+}
+/**
+ * Generate markdown content for an agent
+ */
+function generateAgentFile(agent) {
+    return `---
+name: ${agent.name}
+description: ${agent.description}
+model: ${agent.model}
+---
+
+${agent.systemPrompt}
+`;
+}
+// =============================================================================
+// Agent Loading
+// =============================================================================
+/**
+ * Load agents from a directory
+ */
+function loadAgentsFromDir(dir, location) {
+    const agents = [];
+    if (!fs.existsSync(dir)) {
+        return agents;
+    }
+    const files = fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const parsed = parseAgentFile(content);
+            if (!parsed) {
+                console.warn(`Invalid agent file (no frontmatter): ${filePath}`);
+                continue;
+            }
+            const { frontmatter, content: systemPrompt } = parsed;
+            if (!frontmatter.name || !frontmatter.description) {
+                console.warn(`Invalid agent file (missing fields): ${filePath}`);
+                continue;
+            }
+            if (!isValidAgentName(frontmatter.name)) {
+                console.warn(`Invalid agent name: ${frontmatter.name} in ${filePath}`);
+                continue;
+            }
+            const model = (['sonnet', 'opus', 'haiku', 'inherit'].includes(frontmatter.model || '')
+                ? frontmatter.model
+                : 'inherit');
+            agents.push({
+                name: frontmatter.name,
+                description: frontmatter.description,
+                model,
+                systemPrompt,
+                location,
+                filePath,
+            });
+        }
+        catch (error) {
+            console.warn(`Failed to load agent file: ${filePath}`, error);
+        }
+    }
+    return agents;
+}
+// =============================================================================
+// Registry Class
+// =============================================================================
+export class AgentRegistry {
+    projectDir;
+    userDir;
+    customAgents = [];
+    constructor(projectRoot = process.cwd()) {
+        this.projectDir = path.join(projectRoot, PROJECT_AGENTS_DIR);
+        this.userDir = USER_AGENTS_DIR;
+    }
+    /**
+     * Load all custom agents from project and user directories
+     */
+    load() {
+        const projectAgents = loadAgentsFromDir(this.projectDir, 'project');
+        const userAgents = loadAgentsFromDir(this.userDir, 'personal');
+        // Project agents take precedence over user agents with same name
+        const seen = new Set();
+        this.customAgents = [];
+        for (const agent of projectAgents) {
+            if (!seen.has(agent.name)) {
+                this.customAgents.push(agent);
+                seen.add(agent.name);
+            }
+        }
+        for (const agent of userAgents) {
+            if (!seen.has(agent.name)) {
+                this.customAgents.push(agent);
+                seen.add(agent.name);
+            }
+        }
+    }
+    /**
+     * Get all built-in agents
+     */
+    getBuiltinAgents() {
+        return [...BUILTIN_AGENTS];
+    }
+    /**
+     * Get all custom agents
+     */
+    getCustomAgents() {
+        return [...this.customAgents];
+    }
+    /**
+     * Get all agents (built-in + custom)
+     */
+    getAllAgents() {
+        return [...BUILTIN_AGENTS, ...this.customAgents];
+    }
+    /**
+     * Get an agent by name
+     */
+    getAgent(name) {
+        // Check custom first (they can override built-in in the future)
+        const custom = this.customAgents.find((a) => a.name === name);
+        if (custom)
+            return custom;
+        return BUILTIN_AGENTS.find((a) => a.name === name);
+    }
+    /**
+     * Check if an agent name exists
+     */
+    hasAgent(name) {
+        return this.getAgent(name) !== undefined;
+    }
+    /**
+     * Save a new custom agent
+     */
+    saveAgent(agent, location) {
+        // Validate name
+        if (!isValidAgentName(agent.name)) {
+            throw new Error(`Invalid agent name: ${agent.name}. Use lowercase letters, numbers, and hyphens.`);
+        }
+        if (isBuiltinAgentName(agent.name)) {
+            throw new Error(`Cannot use built-in agent name: ${agent.name}`);
+        }
+        // Determine directory
+        const dir = location === 'project' ? this.projectDir : this.userDir;
+        // Ensure directory exists
+        fs.mkdirSync(dir, { recursive: true });
+        // Generate file content
+        const content = generateAgentFile(agent);
+        const filePath = path.join(dir, `${agent.name}.md`);
+        // Check if already exists
+        if (fs.existsSync(filePath)) {
+            throw new Error(`Agent already exists: ${filePath}`);
+        }
+        // Write file
+        fs.writeFileSync(filePath, content, 'utf-8');
+        // Reload to update internal state
+        this.load();
+        return filePath;
+    }
+    /**
+     * Delete a custom agent
+     */
+    deleteAgent(name) {
+        const agent = this.customAgents.find((a) => a.name === name);
+        if (!agent || !agent.filePath) {
+            return false;
+        }
+        try {
+            fs.unlinkSync(agent.filePath);
+            this.load();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get the project agents directory
+     */
+    getProjectDir() {
+        return this.projectDir;
+    }
+    /**
+     * Get the user agents directory
+     */
+    getUserDir() {
+        return this.userDir;
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let registryInstance = null;
+/**
+ * Get the global agent registry instance
+ */
+export function getAgentRegistry() {
+    if (!registryInstance) {
+        registryInstance = new AgentRegistry();
+        registryInstance.load();
+    }
+    return registryInstance;
+}
+/**
+ * Reset the registry (for testing)
+ */
+export function resetAgentRegistry() {
+    registryInstance = null;
+}

package/dist/agents/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Agent Type Definitions
+ *
+ * Types for built-in and custom agent configurations.
+ */
+export type AgentModel = 'sonnet' | 'opus' | 'haiku' | 'inherit';
+export type AgentLocation = 'project' | 'personal' | 'builtin';
+export interface AgentDefinition {
+    /** Unique identifier (lowercase, hyphens allowed) */
+    name: string;
+    /** Description of when to use this agent */
+    description: string;
+    /** Model to use */
+    model: AgentModel;
+    /** System prompt (for custom agents) */
+    systemPrompt?: string;
+    /** Where this agent is defined */
+    location: AgentLocation;
+    /** File path (for custom agents) */
+    filePath?: string;
+}
+/**
+ * Built-in agents from the @compilr-dev/agents library.
+ * These are available via the Task tool.
+ */
+export declare const BUILTIN_AGENTS: AgentDefinition[];
+/** Project-level agents folder */
+export declare const PROJECT_AGENTS_DIR = ".compilr-dev/agents";
+/** User-level agents folder */
+export declare const USER_AGENTS_DIR: string;
+/** Valid agent name pattern: lowercase letters, numbers, hyphens */
+export declare const AGENT_NAME_PATTERN: RegExp;
+/**
+ * Validate an agent name
+ */
+export declare function isValidAgentName(name: string): boolean;
+/**
+ * Check if a name conflicts with built-in agents
+ */
+export declare function isBuiltinAgentName(name: string): boolean;

package/dist/agents/types.js

@@ -0,0 +1,94 @@
+/**
+ * Agent Type Definitions
+ *
+ * Types for built-in and custom agent configurations.
+ */
+// =============================================================================
+// Built-in Agents
+// =============================================================================
+/**
+ * Built-in agents from the @compilr-dev/agents library.
+ * These are available via the Task tool.
+ */
+export const BUILTIN_AGENTS = [
+    {
+        name: 'explore',
+        description: 'Fast codebase exploration and search',
+        model: 'haiku',
+        location: 'builtin',
+    },
+    {
+        name: 'code-review',
+        description: 'Review code for bugs and best practices',
+        model: 'sonnet',
+        location: 'builtin',
+    },
+    {
+        name: 'general',
+        description: 'General-purpose multi-step tasks',
+        model: 'sonnet',
+        location: 'builtin',
+    },
+    {
+        name: 'plan',
+        description: 'Create implementation plans',
+        model: 'inherit',
+        location: 'builtin',
+    },
+    {
+        name: 'test-runner',
+        description: 'Run and analyze test suites',
+        model: 'sonnet',
+        location: 'builtin',
+    },
+    {
+        name: 'doc-lookup',
+        description: 'Search documentation',
+        model: 'haiku',
+        location: 'builtin',
+    },
+    {
+        name: 'refactor',
+        description: 'Refactor code for clarity',
+        model: 'sonnet',
+        location: 'builtin',
+    },
+    {
+        name: 'security-audit',
+        description: 'Security vulnerability analysis',
+        model: 'sonnet',
+        location: 'builtin',
+    },
+    {
+        name: 'debug',
+        description: 'Debug and fix issues',
+        model: 'sonnet',
+        location: 'builtin',
+    },
+];
+// =============================================================================
+// Folder Paths
+// =============================================================================
+import * as os from 'os';
+import * as path from 'path';
+/** Project-level agents folder */
+export const PROJECT_AGENTS_DIR = '.compilr-dev/agents';
+/** User-level agents folder */
+export const USER_AGENTS_DIR = path.join(os.homedir(), '.compilr-dev', 'agents');
+// =============================================================================
+// Validation
+// =============================================================================
+/** Valid agent name pattern: lowercase letters, numbers, hyphens */
+export const AGENT_NAME_PATTERN = /^[a-z][a-z0-9-]{1,49}$/;
+/**
+ * Validate an agent name
+ */
+export function isValidAgentName(name) {
+    return AGENT_NAME_PATTERN.test(name);
+}
+/**
+ * Check if a name conflicts with built-in agents
+ */
+export function isBuiltinAgentName(name) {
+    return BUILTIN_AGENTS.some((agent) => agent.name === name);
+}

package/dist/commands/custom-registry.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Custom Command Registry
+ *
+ * Handles loading, saving, and managing custom command definitions.
+ * Loads from both project (.compilr-dev/commands/) and user (~/.compilr-dev/commands/) directories.
+ */
+import { CustomCommand } from './types.js';
+/**
+ * Expand a command prompt with arguments
+ *
+ * Supports:
+ * - $1, $2, $3... - Positional arguments
+ * - $ARGUMENTS - All arguments as a single string
+ */
+export declare function expandArguments(prompt: string, args: string[]): string;
+export declare class CustomCommandRegistry {
+    private readonly projectDir;
+    private readonly userDir;
+    private commands;
+    constructor(projectRoot?: string);
+    /**
+     * Load all custom commands from project and user directories
+     */
+    load(): void;
+    /**
+     * Get all custom commands
+     */
+    getAll(): CustomCommand[];
+    /**
+     * Get a command by name
+     */
+    get(name: string): CustomCommand | undefined;
+    /**
+     * Check if a command exists
+     */
+    has(name: string): boolean;
+    /**
+     * Expand a command with arguments
+     */
+    expand(name: string, args: string[]): string | undefined;
+    /**
+     * Save a new custom command
+     */
+    save(command: {
+        name: string;
+        description: string;
+        prompt: string;
+    }, location: 'project' | 'personal'): string;
+    /**
+     * Delete a custom command
+     */
+    delete(name: string): boolean;
+    /**
+     * Get the project commands directory
+     */
+    getProjectDir(): string;
+    /**
+     * Get the user commands directory
+     */
+    getUserDir(): string;
+}
+/**
+ * Get the global custom command registry instance
+ */
+export declare function getCustomCommandRegistry(): CustomCommandRegistry;
+/**
+ * Reset the registry (for testing)
+ */
+export declare function resetCustomCommandRegistry(): void;

package/dist/commands/custom-registry.js

@@ -0,0 +1,246 @@
+/**
+ * Custom Command Registry
+ *
+ * Handles loading, saving, and managing custom command definitions.
+ * Loads from both project (.compilr-dev/commands/) and user (~/.compilr-dev/commands/) directories.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { PROJECT_COMMANDS_DIR, USER_COMMANDS_DIR, isValidCommandName, } from './types.js';
+/**
+ * Parse a markdown file with optional YAML frontmatter
+ */
+function parseCommandFile(content) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        // No frontmatter, treat entire content as prompt
+        return {
+            frontmatter: {},
+            content: content.trim(),
+        };
+    }
+    const yamlContent = frontmatterMatch[1];
+    const markdownContent = frontmatterMatch[2].trim();
+    // Simple YAML parsing (key: value)
+    const frontmatter = {};
+    for (const line of yamlContent.split('\n')) {
+        const match = line.match(/^(\w+):\s*["']?(.*)["']?$/);
+        if (match) {
+            // Remove surrounding quotes if present
+            frontmatter[match[1]] = match[2].replace(/^["']|["']$/g, '').trim();
+        }
+    }
+    return {
+        frontmatter: frontmatter,
+        content: markdownContent,
+    };
+}
+/**
+ * Generate markdown content for a command
+ */
+function generateCommandFile(command) {
+    return `---
+description: "${command.description}"
+---
+
+${command.prompt}
+`;
+}
+// =============================================================================
+// Argument Substitution
+// =============================================================================
+/**
+ * Expand a command prompt with arguments
+ *
+ * Supports:
+ * - $1, $2, $3... - Positional arguments
+ * - $ARGUMENTS - All arguments as a single string
+ */
+export function expandArguments(prompt, args) {
+    let result = prompt;
+    // Replace $ARGUMENTS with all args joined
+    result = result.replace(/\$ARGUMENTS/g, args.join(' '));
+    // Replace $1, $2, etc. with positional args
+    for (let i = 0; i < args.length; i++) {
+        result = result.replace(new RegExp(`\\$${String(i + 1)}`, 'g'), args[i]);
+    }
+    // Remove unreplaced positional args (e.g., $3 when only 2 args given)
+    result = result.replace(/\$\d+/g, '');
+    return result.trim();
+}
+// =============================================================================
+// Command Loading
+// =============================================================================
+/**
+ * Load commands from a directory
+ */
+function loadCommandsFromDir(dir, location) {
+    const commands = [];
+    if (!fs.existsSync(dir)) {
+        return commands;
+    }
+    const files = fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const parsed = parseCommandFile(content);
+            // Name from filename (without .md extension)
+            const name = path.basename(file, '.md');
+            if (!isValidCommandName(name)) {
+                console.warn(`Invalid command name: ${name} in ${filePath}`);
+                continue;
+            }
+            if (!parsed.content) {
+                console.warn(`Empty command file: ${filePath}`);
+                continue;
+            }
+            commands.push({
+                name,
+                description: parsed.frontmatter.description || 'No description',
+                prompt: parsed.content,
+                location,
+                filePath,
+            });
+        }
+        catch (error) {
+            console.warn(`Failed to load command file: ${filePath}`, error);
+        }
+    }
+    return commands;
+}
+// =============================================================================
+// Registry Class
+// =============================================================================
+export class CustomCommandRegistry {
+    projectDir;
+    userDir;
+    commands = [];
+    constructor(projectRoot = process.cwd()) {
+        this.projectDir = path.join(projectRoot, PROJECT_COMMANDS_DIR);
+        this.userDir = USER_COMMANDS_DIR;
+    }
+    /**
+     * Load all custom commands from project and user directories
+     */
+    load() {
+        const projectCommands = loadCommandsFromDir(this.projectDir, 'project');
+        const userCommands = loadCommandsFromDir(this.userDir, 'personal');
+        // Project commands take precedence over user commands with same name
+        const seen = new Set();
+        this.commands = [];
+        for (const command of projectCommands) {
+            if (!seen.has(command.name)) {
+                this.commands.push(command);
+                seen.add(command.name);
+            }
+        }
+        for (const command of userCommands) {
+            if (!seen.has(command.name)) {
+                this.commands.push(command);
+                seen.add(command.name);
+            }
+        }
+    }
+    /**
+     * Get all custom commands
+     */
+    getAll() {
+        return [...this.commands];
+    }
+    /**
+     * Get a command by name
+     */
+    get(name) {
+        return this.commands.find((c) => c.name === name);
+    }
+    /**
+     * Check if a command exists
+     */
+    has(name) {
+        return this.get(name) !== undefined;
+    }
+    /**
+     * Expand a command with arguments
+     */
+    expand(name, args) {
+        const command = this.get(name);
+        if (!command)
+            return undefined;
+        return expandArguments(command.prompt, args);
+    }
+    /**
+     * Save a new custom command
+     */
+    save(command, location) {
+        // Validate name
+        if (!isValidCommandName(command.name)) {
+            throw new Error(`Invalid command name: ${command.name}. Use lowercase letters, numbers, and hyphens (2-30 chars, must start with letter).`);
+        }
+        // Determine directory
+        const dir = location === 'project' ? this.projectDir : this.userDir;
+        // Ensure directory exists
+        fs.mkdirSync(dir, { recursive: true });
+        // Generate file content
+        const content = generateCommandFile(command);
+        const filePath = path.join(dir, `${command.name}.md`);
+        // Check if already exists
+        if (fs.existsSync(filePath)) {
+            throw new Error(`Command already exists: ${filePath}`);
+        }
+        // Write file
+        fs.writeFileSync(filePath, content, 'utf-8');
+        // Reload to update internal state
+        this.load();
+        return filePath;
+    }
+    /**
+     * Delete a custom command
+     */
+    delete(name) {
+        const command = this.commands.find((c) => c.name === name);
+        if (!command || !command.filePath) {
+            return false;
+        }
+        try {
+            fs.unlinkSync(command.filePath);
+            this.load();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get the project commands directory
+     */
+    getProjectDir() {
+        return this.projectDir;
+    }
+    /**
+     * Get the user commands directory
+     */
+    getUserDir() {
+        return this.userDir;
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let registryInstance = null;
+/**
+ * Get the global custom command registry instance
+ */
+export function getCustomCommandRegistry() {
+    if (!registryInstance) {
+        registryInstance = new CustomCommandRegistry();
+        registryInstance.load();
+    }
+    return registryInstance;
+}
+/**
+ * Reset the registry (for testing)
+ */
+export function resetCustomCommandRegistry() {
+    registryInstance = null;
+}

package/dist/commands/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Custom Commands Module
+ *
+ * Exports custom command types and registry.
+ */
+export { CustomCommand, CommandLocation, PROJECT_COMMANDS_DIR, USER_COMMANDS_DIR, isValidCommandName, } from './types.js';
+export { CustomCommandRegistry, getCustomCommandRegistry, resetCustomCommandRegistry, expandArguments, } from './custom-registry.js';

package/dist/commands/index.js

@@ -0,0 +1,7 @@
+/**
+ * Custom Commands Module
+ *
+ * Exports custom command types and registry.
+ */
+export { PROJECT_COMMANDS_DIR, USER_COMMANDS_DIR, isValidCommandName, } from './types.js';
+export { CustomCommandRegistry, getCustomCommandRegistry, resetCustomCommandRegistry, expandArguments, } from './custom-registry.js';