@compilr-dev/cli 0.5.0 → 0.5.1

package/dist/settings/mcp-config.d.ts

@@ -0,0 +1,76 @@
+/**
+ * MCP Configuration Loader
+ *
+ * Loads MCP server configs from:
+ *   1. Global: ~/.compilr-dev/mcp.json
+ *   2. Per-project: <projectRoot>/.compilr-dev/mcp.json
+ *
+ * Project config overrides global config (by server name).
+ * Format is compatible with Claude Desktop / Gemini CLI.
+ */
+/**
+ * Single MCP server entry in the config file.
+ * If `command` is present → stdio transport.
+ * If `url` is present → HTTP transport.
+ */
+export interface MCPServerEntry {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    disabled?: boolean;
+    timeout?: number;
+}
+/**
+ * Shape of the mcp.json config file.
+ */
+export interface MCPConfigFile {
+    mcpServers: Record<string, MCPServerEntry>;
+}
+/**
+ * Resolved MCP server config ready for MCPManager.
+ * Uses the MCPServerConfig shape from @compilr-dev/agents.
+ */
+export interface ResolvedMCPServer {
+    name: string;
+    transport: 'stdio' | 'http';
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * Get the global MCP config file path.
+ */
+export declare function getMCPConfigPath(): string;
+/**
+ * Get the per-project MCP config file path.
+ */
+export declare function getProjectMCPConfigPath(projectRoot: string): string;
+/**
+ * Load MCP server configs from global and project-level config files.
+ * Project configs override global by server name.
+ *
+ * @param projectRoot - Optional project root for per-project config
+ * @returns Array of resolved MCP server configs
+ */
+export declare function loadMCPConfig(projectRoot?: string): ResolvedMCPServer[];
+/**
+ * Get existing server names from all config files.
+ * Useful for validating uniqueness when adding a new server.
+ */
+export declare function getExistingServerNames(projectRoot?: string): Set<string>;
+/**
+ * Save a new MCP server entry to the config file.
+ *
+ * @param name - Server name (unique identifier)
+ * @param entry - Server configuration entry
+ * @param scope - 'global' or 'project'
+ * @param projectRoot - Required when scope is 'project'
+ */
+export declare function saveMCPServer(name: string, entry: MCPServerEntry, scope: 'global' | 'project', projectRoot?: string): void;

package/dist/settings/mcp-config.js

@@ -0,0 +1,143 @@
+/**
+ * MCP Configuration Loader
+ *
+ * Loads MCP server configs from:
+ *   1. Global: ~/.compilr-dev/mcp.json
+ *   2. Per-project: <projectRoot>/.compilr-dev/mcp.json
+ *
+ * Project config overrides global config (by server name).
+ * Format is compatible with Claude Desktop / Gemini CLI.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import * as path from 'path';
+import { getDataPath } from './paths.js';
+// =============================================================================
+// Config Loading
+// =============================================================================
+/**
+ * Get the global MCP config file path.
+ */
+export function getMCPConfigPath() {
+    return path.join(getDataPath(), 'mcp.json');
+}
+/**
+ * Get the per-project MCP config file path.
+ */
+export function getProjectMCPConfigPath(projectRoot) {
+    return path.join(projectRoot, '.compilr-dev', 'mcp.json');
+}
+/**
+ * Read and parse an mcp.json file. Returns empty servers on any error.
+ */
+function readMCPConfigFile(filePath) {
+    try {
+        if (!existsSync(filePath)) {
+            return {};
+        }
+        const data = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(data);
+        if (parsed.mcpServers && typeof parsed.mcpServers === 'object') {
+            return parsed.mcpServers;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Convert an MCPServerEntry to a ResolvedMCPServer.
+ * Returns null if the entry is invalid (neither command nor url).
+ */
+function resolveEntry(name, entry) {
+    if (entry.disabled) {
+        return null;
+    }
+    if (entry.command) {
+        return {
+            name,
+            transport: 'stdio',
+            command: entry.command,
+            args: entry.args,
+            env: entry.env,
+            cwd: entry.cwd,
+            timeout: entry.timeout,
+        };
+    }
+    if (entry.url) {
+        return {
+            name,
+            transport: 'http',
+            url: entry.url,
+            headers: entry.headers,
+            timeout: entry.timeout,
+        };
+    }
+    // Neither command nor url — invalid entry
+    return null;
+}
+/**
+ * Load MCP server configs from global and project-level config files.
+ * Project configs override global by server name.
+ *
+ * @param projectRoot - Optional project root for per-project config
+ * @returns Array of resolved MCP server configs
+ */
+export function loadMCPConfig(projectRoot) {
+    // 1. Load global config
+    const globalServers = readMCPConfigFile(getMCPConfigPath());
+    // 2. Load project config (overrides global by name)
+    const projectServers = projectRoot
+        ? readMCPConfigFile(getProjectMCPConfigPath(projectRoot))
+        : {};
+    // 3. Merge: project overrides global
+    const merged = { ...globalServers, ...projectServers };
+    // 4. Resolve each entry
+    const resolved = [];
+    for (const [name, entry] of Object.entries(merged)) {
+        const server = resolveEntry(name, entry);
+        if (server) {
+            resolved.push(server);
+        }
+    }
+    return resolved;
+}
+/**
+ * Get existing server names from all config files.
+ * Useful for validating uniqueness when adding a new server.
+ */
+export function getExistingServerNames(projectRoot) {
+    const globalServers = readMCPConfigFile(getMCPConfigPath());
+    const projectServers = projectRoot
+        ? readMCPConfigFile(getProjectMCPConfigPath(projectRoot))
+        : {};
+    return new Set([...Object.keys(globalServers), ...Object.keys(projectServers)]);
+}
+/**
+ * Save a new MCP server entry to the config file.
+ *
+ * @param name - Server name (unique identifier)
+ * @param entry - Server configuration entry
+ * @param scope - 'global' or 'project'
+ * @param projectRoot - Required when scope is 'project'
+ */
+export function saveMCPServer(name, entry, scope, projectRoot) {
+    const configPath = scope === 'project' && projectRoot
+        ? getProjectMCPConfigPath(projectRoot)
+        : getMCPConfigPath();
+    // Read existing config (or empty)
+    let config = { mcpServers: {} };
+    try {
+        const raw = readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        config = { mcpServers: parsed.mcpServers ?? {} };
+    }
+    catch {
+        // File doesn't exist or invalid — start fresh
+    }
+    // Add/overwrite server entry
+    config.mcpServers[name] = entry;
+    // Ensure directory exists, write file
+    mkdirSync(path.dirname(configPath), { recursive: true });
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}

package/dist/settings/paths.d.ts

@@ -100,6 +100,10 @@ export declare function getCredentialsPath(): string;
  * Get the settings file path
  */
 export declare function getSettingsPath(): string;
+/**
+ * Get the sessions directory path (for session checkpointing)
+ */
+export declare function getSessionsPath(): string;
 /**
  * Ensure data directory exists
  */

package/dist/settings/paths.js

@@ -244,6 +244,12 @@ export function getCredentialsPath() {
 export function getSettingsPath() {
     return path.join(getDataPath(), 'settings.json');
 }
+/**
+ * Get the sessions directory path (for session checkpointing)
+ */
+export function getSessionsPath() {
+    return path.join(getDataPath(), 'sessions');
+}
 /**
  * Ensure data directory exists
  */

package/dist/shared-handlers.d.ts

@@ -61,3 +61,65 @@ export declare function setOverlayActive(active: boolean): void;
  * Check if an overlay is currently active.
  */
 export declare function isOverlayActive(): boolean;
+export interface DelegateInput {
+    /** Target agent ID (e.g., 'arch', 'dev-1') */
+    agentId: string;
+    /** Task description for the specialist */
+    task: string;
+    /** Optional reason for delegation (shown to user) */
+    reason?: string;
+}
+export interface DelegateResult {
+    /** True if delegation was approved and switch occurred */
+    success: boolean;
+    /** True if user declined the delegation */
+    declined: boolean;
+    /** Error message if delegation failed */
+    error?: string;
+}
+export type DelegateHandler = (input: DelegateInput) => Promise<DelegateResult>;
+/**
+ * Register the delegate handler. Called during app initialization.
+ */
+export declare function registerDelegateHandler(handler: DelegateHandler): void;
+/**
+ * Get the registered delegate handler. Called by the delegate tool.
+ */
+export declare function getDelegateHandler(): DelegateHandler | undefined;
+export interface DelegateBackgroundInput {
+    /** Target specialist agent ID */
+    agentId: string;
+    /** Task description for the specialist */
+    task: string;
+    /** Optional todo index to associate with this delegation */
+    todoIndex?: number;
+    /** What the specialist should produce */
+    expectedOutput?: string;
+}
+export interface DelegateBackgroundResult {
+    /** Unique delegation ID for tracking */
+    delegationId: string;
+    /** Current status: running or queued */
+    status: 'running' | 'queued';
+    /** Error message if delegation failed */
+    error?: string;
+}
+export type DelegateBackgroundHandler = (input: DelegateBackgroundInput) => Promise<DelegateBackgroundResult>;
+/**
+ * Register the delegate_background handler. Called during app initialization.
+ */
+export declare function registerDelegateBackgroundHandler(handler: DelegateBackgroundHandler): void;
+/**
+ * Get the registered delegate_background handler.
+ */
+export declare function getDelegateBackgroundHandler(): DelegateBackgroundHandler | undefined;
+/** Handoff uses the same shape as delegation */
+export type HandoffHandler = (input: DelegateInput) => Promise<DelegateResult>;
+/**
+ * Register the handoff handler. Called during app initialization.
+ */
+export declare function registerHandoffHandler(handler: HandoffHandler): void;
+/**
+ * Get the registered handoff handler. Called by the handoff tool.
+ */
+export declare function getHandoffHandler(): HandoffHandler | undefined;

package/dist/shared-handlers.js

@@ -55,3 +55,51 @@ export function setOverlayActive(active) {
 export function isOverlayActive() {
     return overlayActive;
 }
+// =============================================================================
+// Delegate Handler Registry
+// =============================================================================
+let delegateHandler;
+/**
+ * Register the delegate handler. Called during app initialization.
+ */
+export function registerDelegateHandler(handler) {
+    delegateHandler = handler;
+}
+/**
+ * Get the registered delegate handler. Called by the delegate tool.
+ */
+export function getDelegateHandler() {
+    return delegateHandler;
+}
+// =============================================================================
+// Delegate Background Handler Registry
+// =============================================================================
+let delegateBackgroundHandler;
+/**
+ * Register the delegate_background handler. Called during app initialization.
+ */
+export function registerDelegateBackgroundHandler(handler) {
+    delegateBackgroundHandler = handler;
+}
+/**
+ * Get the registered delegate_background handler.
+ */
+export function getDelegateBackgroundHandler() {
+    return delegateBackgroundHandler;
+}
+// =============================================================================
+// Handoff Handler Registry
+// =============================================================================
+let handoffHandler;
+/**
+ * Register the handoff handler. Called during app initialization.
+ */
+export function registerHandoffHandler(handler) {
+    handoffHandler = handler;
+}
+/**
+ * Get the registered handoff handler. Called by the handoff tool.
+ */
+export function getHandoffHandler() {
+    return handoffHandler;
+}

package/dist/system-prompt/builder.d.ts

@@ -0,0 +1,5 @@
+/**
+ * System Prompt Builder — re-exported from @compilr-dev/sdk
+ */
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, } from '@compilr-dev/sdk';
+export type { SystemPromptContext, BuildResult } from '@compilr-dev/sdk';

package/dist/system-prompt/builder.js

@@ -0,0 +1,4 @@
+/**
+ * System Prompt Builder — re-exported from @compilr-dev/sdk
+ */
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, } from '@compilr-dev/sdk';

package/dist/system-prompt/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Modular System Prompt — re-exported from @compilr-dev/sdk
+ *
+ * Usage:
+ * ```typescript
+ * import { SystemPromptBuilder, buildSystemPrompt } from './system-prompt/index.js';
+ *
+ * // Simple usage
+ * const prompt = buildSystemPrompt({ hasGit: true, enableMetaTools: true });
+ *
+ * // Builder pattern for more control
+ * const builder = new SystemPromptBuilder({ hasGit: true });
+ * builder.setContext({ enableMetaTools: true, projectContext: '...' });
+ * const result = builder.build();
+ * ```
+ */
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, type SystemPromptContext, type BuildResult, } from './builder.js';
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, type SystemPromptModule, type ModuleConditions, } from './modules.js';

package/dist/system-prompt/index.js

@@ -0,0 +1,18 @@
+/**
+ * Modular System Prompt — re-exported from @compilr-dev/sdk
+ *
+ * Usage:
+ * ```typescript
+ * import { SystemPromptBuilder, buildSystemPrompt } from './system-prompt/index.js';
+ *
+ * // Simple usage
+ * const prompt = buildSystemPrompt({ hasGit: true, enableMetaTools: true });
+ *
+ * // Builder pattern for more control
+ * const builder = new SystemPromptBuilder({ hasGit: true });
+ * builder.setContext({ enableMetaTools: true, projectContext: '...' });
+ * const result = builder.build();
+ * ```
+ */
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, } from './builder.js';
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './modules.js';

package/dist/system-prompt/modules.d.ts

@@ -0,0 +1,5 @@
+/**
+ * System Prompt Modules — re-exported from @compilr-dev/sdk
+ */
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from '@compilr-dev/sdk';
+export type { SystemPromptModule, ModuleConditions } from '@compilr-dev/sdk';

package/dist/system-prompt/modules.js

@@ -0,0 +1,4 @@
+/**
+ * System Prompt Modules — re-exported from @compilr-dev/sdk
+ */
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from '@compilr-dev/sdk';

package/dist/tabbed-menu.js

@@ -6,6 +6,7 @@
  */
 import pc from 'picocolors';
 import { getCustomCommandRegistry } from './commands/index.js';
+import { truncate } from './ui/base/index.js';
 // ANSI escape codes
 const ANSI = {
     HIDE_CURSOR: '\x1B[?25l',
@@ -151,7 +152,7 @@ function renderCustomCommandsTab() {
     else {
         for (const cmd of commands) {
             const name = `/${cmd.name}`.padEnd(20);
-            const desc = cmd.description.slice(0, 40) + (cmd.description.length > 40 ? '...' : '');
+            const desc = truncate(cmd.description, 40);
             const location = ` (${cmd.location})`;
             lines.push(' ' + pc.cyan(name) + pc.dim(desc) + pc.dim(location));
         }

package/dist/templates/compilr-md-import.d.ts

@@ -0,0 +1,16 @@
+/**
+ * COMPILR.md Template Generator for Imported Projects
+ *
+ * Generates the AI assistant context file for existing projects that are being imported.
+ * Different from the new project template - acknowledges existing codebase structure.
+ */
+import type { DetectedProject } from '../utils/project-detection.js';
+export interface ImportProjectConfig {
+    name: string;
+    displayName: string;
+    description?: string;
+    path: string;
+    detected: DetectedProject;
+    workflowMode: 'flexible' | 'guided';
+}
+export declare function generateCompilrMdForImport(config: ImportProjectConfig): string;