mcp-agent-foundry 1.0.0

package/dist/router/role-resolver.js

@@ -0,0 +1,95 @@
+/**
+ * Role Resolver
+ *
+ * Maps role names to their configured agent settings by merging
+ * role-specific configuration with default values.
+ */
+/**
+ * RoleResolver maps role names to fully resolved AgentConfig objects.
+ *
+ * It handles:
+ * - Looking up role configurations by name
+ * - Merging role-specific overrides with defaults
+ * - Providing helpful error messages for unknown roles
+ * - Hot reload support via updateConfig()
+ */
+export class RoleResolver {
+    roles;
+    defaults;
+    /**
+     * Create a new RoleResolver with the given configuration.
+     *
+     * @param config - The full AgentRouter configuration
+     */
+    constructor(config) {
+        this.roles = new Map(Object.entries(config.roles));
+        this.defaults = config.defaults;
+    }
+    /**
+     * Resolve a role name to its full agent configuration.
+     *
+     * Merges the role's specific settings with default values, where
+     * role-specific values take precedence over defaults.
+     *
+     * @param role - The role name to resolve (e.g., "coder", "critic")
+     * @returns The fully resolved AgentConfig
+     * @throws Error if the role is not found in configuration
+     */
+    resolve(role) {
+        const roleConfig = this.roles.get(role);
+        if (!roleConfig) {
+            const availableRoles = this.listRoles();
+            const roleList = availableRoles.length > 0
+                ? availableRoles.join(', ')
+                : '(none configured)';
+            throw new Error(`Unknown role: "${role}". Available roles: ${roleList}`);
+        }
+        // Merge role config with defaults
+        // Role-specific values take precedence over defaults
+        const agentConfig = {
+            provider: roleConfig.provider,
+            model: roleConfig.model,
+            temperature: roleConfig.temperature ?? this.defaults.temperature,
+            max_tokens: roleConfig.max_tokens ?? this.defaults.max_tokens,
+            timeout_ms: roleConfig.timeout_ms ?? this.defaults.timeout_ms,
+        };
+        // Only add optional properties if they are defined
+        // This respects exactOptionalPropertyTypes
+        if (roleConfig.system_prompt !== undefined) {
+            agentConfig.system_prompt = roleConfig.system_prompt;
+        }
+        if (roleConfig.fallback !== undefined) {
+            agentConfig.fallback = roleConfig.fallback;
+        }
+        return agentConfig;
+    }
+    /**
+     * Check if a role exists in the configuration.
+     *
+     * @param role - The role name to check
+     * @returns true if the role exists, false otherwise
+     */
+    hasRole(role) {
+        return this.roles.has(role);
+    }
+    /**
+     * Get a list of all configured role names.
+     *
+     * @returns Array of role names
+     */
+    listRoles() {
+        return Array.from(this.roles.keys());
+    }
+    /**
+     * Update the resolver with a new configuration.
+     *
+     * Used for hot reload when the config file changes.
+     *
+     * @param config - The new configuration to use
+     */
+    updateConfig(config) {
+        this.roles = new Map(Object.entries(config.roles));
+        this.defaults = config.defaults;
+    }
+}
+//# sourceMappingURL=role-resolver.js.map

package/dist/router/role-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-resolver.js","sourceRoot":"","sources":["../../src/router/role-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,CAA0B;IAC/B,QAAQ,CAAgB;IAEhC;;;;OAIG;IACH,YAAY,MAAc;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAY;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,GAAG,CAAC;gBACxC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3B,CAAC,CAAC,mBAAmB,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,kBAAkB,IAAI,uBAAuB,QAAQ,EAAE,CACxD,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,qDAAqD;QACrD,MAAM,WAAW,GAAgB;YAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW;YAChE,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU;YAC7D,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU;SAC9D,CAAC;QAEF,mDAAmD;QACnD,2CAA2C;QAC3C,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YAC3C,WAAW,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;QACvD,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACtC,WAAW,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QAC7C,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;CACF"}

package/dist/server.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AgentRouter MCP Server
+ * Creates and configures the MCP server with tool capabilities
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StateStore } from "./persistence/state-store.js";
+/**
+ * Creates and configures the MCP server
+ * @returns Promise resolving to configured MCP Server instance
+ */
+export declare function createServer(): Promise<McpServer>;
+/**
+ * Starts the server with stdio transport
+ * @param server - The MCP server instance to start
+ */
+export declare function startServer(server: McpServer): Promise<void>;
+/**
+ * Gets the active state store (if initialized).
+ * @returns The StateStore instance or undefined if not initialized
+ */
+export declare function getStateStore(): StateStore | undefined;
+/**
+ * Gets the active repository path (if initialized).
+ * @returns The repository path or undefined if not initialized
+ */
+export declare function getRepoPath(): string | undefined;
+/**
+ * Gracefully shuts down the server, persisting final state.
+ * Call this before process exit to ensure no state is lost.
+ */
+export declare function shutdownServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBpE,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAW1D;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAgLvD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,SAAS,CAEtD;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAEhD;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAUpD"}

package/dist/server.js

@@ -0,0 +1,223 @@
+/**
+ * AgentRouter MCP Server
+ * Creates and configures the MCP server with tool capabilities
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { DEFAULT_CONFIG } from "./config/defaults.js";
+import { ConfigManager } from "./config/manager.js";
+import { registerTools } from "./mcp/tools/index.js";
+import { createStdioTransport } from "./mcp/transport/stdio.js";
+import { Logger } from "./observability/logger.js";
+import { AnthropicProvider } from "./providers/anthropic.js";
+import { GeminiProvider } from "./providers/gemini.js";
+import { ProviderManager } from "./providers/manager.js";
+import { OllamaProvider } from "./providers/ollama.js";
+import { OpenAIProvider } from "./providers/openai.js";
+import { ZAIProvider } from "./providers/zai.js";
+import { KimiProvider } from "./providers/kimi.js";
+import { RouterEngine } from "./router/engine.js";
+import { TaskCoordinator, PipelineManager } from "./tasks/index.js";
+import { WorktreeManager } from "./worktrees/manager.js";
+import { mergeWorktreeConfig } from "./config/worktree-defaults.js";
+import { initializeWithRecovery, shutdown } from "./startup.js";
+// Module-level state for shutdown handling
+let activeStateStore;
+let activeRepoPath;
+const SERVER_NAME = "agent-router";
+const SERVER_VERSION = "3.0.2";
+/**
+ * Creates and configures the MCP server
+ * @returns Promise resolving to configured MCP Server instance
+ */
+export async function createServer() {
+    // Create logger
+    const logger = new Logger({ name: SERVER_NAME });
+    logger.info("Creating AgentRouter MCP server", {
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    // Load configuration (with fallback to defaults on error)
+    let config;
+    let configManager;
+    try {
+        configManager = await ConfigManager.load({
+            watch: true,
+            allowMissingEnv: true, // Allow missing env vars, will fail at runtime if needed
+        });
+        config = configManager.get();
+        logger.info("Configuration loaded", {
+            version: config.version,
+            roleCount: Object.keys(config.roles).length,
+            providerCount: Object.keys(config.providers).length,
+            loadedPaths: configManager.getLoadedPaths(),
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.warn("Failed to load configuration, using defaults", {
+            errorMessage,
+        });
+        config = structuredClone(DEFAULT_CONFIG);
+    }
+    // Create ProviderManager and register all provider factories
+    const providers = new ProviderManager();
+    // Register provider factories
+    providers.registerFactory("anthropic", (providerConfig) => new AnthropicProvider(providerConfig));
+    providers.registerFactory("openai", (providerConfig) => new OpenAIProvider(providerConfig));
+    providers.registerFactory("google", (providerConfig) => new GeminiProvider(providerConfig));
+    providers.registerFactory("ollama", (providerConfig) => new OllamaProvider(providerConfig));
+    // zai (GLM) uses dedicated ZAI provider (OpenAI-compatible API with correct name)
+    providers.registerFactory("zai", (providerConfig) => new ZAIProvider(providerConfig));
+    // kimi (Moonshot AI) uses dedicated Kimi provider (OpenAI-compatible API with correct name)
+    providers.registerFactory("kimi", (providerConfig) => new KimiProvider(providerConfig));
+    logger.debug("Provider factories registered", {
+        providers: providers.listProviders(),
+    });
+    // Update provider configurations from loaded config
+    providers.updateConfig(config.providers);
+    logger.debug("Provider configurations updated", {
+        configuredProviders: providers.listConfigured(),
+    });
+    // Create RouterEngine
+    const router = new RouterEngine(config, providers, logger);
+    logger.debug("RouterEngine created", {
+        availableRoles: router.listRoles(),
+    });
+    // Create task integration modules if enabled
+    let taskCoordinator;
+    let pipelineManager;
+    let worktreeManager;
+    const tasksConfig = config.tasks;
+    if (tasksConfig?.enabled) {
+        logger.info("Tasks integration enabled, creating task modules");
+        taskCoordinator = new TaskCoordinator(logger);
+        pipelineManager = new PipelineManager(logger);
+        // Create worktree manager if worktree support is enabled
+        const worktreeConfig = config.worktrees;
+        const mergedWorktreeConfig = mergeWorktreeConfig(worktreeConfig);
+        if (mergedWorktreeConfig.enabled) {
+            try {
+                // Get the current working directory as the repo path
+                const repoPath = process.cwd();
+                activeRepoPath = repoPath;
+                // Initialize with recovery - loads persisted state and reconciles with physical worktrees
+                let startupResult;
+                try {
+                    startupResult = await initializeWithRecovery({
+                        repoPath,
+                        worktreeBaseDir: mergedWorktreeConfig.baseDir,
+                        branchPattern: mergedWorktreeConfig.git.branchPattern,
+                        autoRecover: true,
+                        autoCleanOrphans: mergedWorktreeConfig.cleanup.autoCleanup,
+                    });
+                    activeStateStore = startupResult.stateStore;
+                    // Log any warnings from recovery
+                    if (startupResult.warnings.length > 0) {
+                        for (const warning of startupResult.warnings) {
+                            logger.warn(warning);
+                        }
+                    }
+                    if (startupResult.recoveryResult) {
+                        const recovery = startupResult.recoveryResult;
+                        logger.info("Recovery complete", {
+                            recoveredWorktrees: recovery.recoveredWorktrees.length,
+                            orphanedWorktrees: recovery.orphanedWorktrees.length,
+                            orphanedTasks: recovery.orphanedTasks.length,
+                            stuckWorktrees: recovery.stuckWorktrees.length,
+                            cleanedUp: recovery.cleanedUp.length,
+                        });
+                    }
+                }
+                catch (recoveryError) {
+                    const recoveryErrorMessage = recoveryError instanceof Error ? recoveryError.message : String(recoveryError);
+                    logger.warn("Recovery initialization failed, continuing without persistence", {
+                        errorMessage: recoveryErrorMessage,
+                    });
+                }
+                worktreeManager = new WorktreeManager(repoPath, mergedWorktreeConfig);
+                await worktreeManager.initialize();
+                logger.info("WorktreeManager initialized", {
+                    repoPath,
+                    baseDir: mergedWorktreeConfig.baseDir,
+                    maxWorktrees: mergedWorktreeConfig.limits.maxWorktrees,
+                });
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                logger.warn("Failed to initialize WorktreeManager, worktree support disabled", {
+                    errorMessage,
+                });
+                worktreeManager = undefined;
+            }
+        }
+    }
+    // Create MCP server with capabilities
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    // Register all tools
+    registerTools(server, router, logger, taskCoordinator, pipelineManager, worktreeManager);
+    // Setup config change listener for hot reload
+    if (configManager) {
+        configManager.on("change", (newConfig) => {
+            logger.info("Configuration changed, reloading...", {
+                version: newConfig.version,
+            });
+            // Update router configuration
+            router.updateConfig(newConfig);
+            // Update provider configurations
+            providers.updateConfig(newConfig.providers);
+            logger.info("Configuration reloaded successfully");
+        });
+        configManager.on("error", (error, path) => {
+            logger.error("Configuration reload failed", {
+                errorMessage: error.message,
+                path,
+            });
+        });
+    }
+    logger.info("MCP server created successfully");
+    return server;
+}
+/**
+ * Starts the server with stdio transport
+ * @param server - The MCP server instance to start
+ */
+export async function startServer(server) {
+    const logger = new Logger({ name: SERVER_NAME });
+    const transport = createStdioTransport();
+    logger.info("Connecting to stdio transport...");
+    await server.connect(transport);
+    logger.info("AgentRouter MCP server is running");
+}
+/**
+ * Gets the active state store (if initialized).
+ * @returns The StateStore instance or undefined if not initialized
+ */
+export function getStateStore() {
+    return activeStateStore;
+}
+/**
+ * Gets the active repository path (if initialized).
+ * @returns The repository path or undefined if not initialized
+ */
+export function getRepoPath() {
+    return activeRepoPath;
+}
+/**
+ * Gracefully shuts down the server, persisting final state.
+ * Call this before process exit to ensure no state is lost.
+ */
+export async function shutdownServer() {
+    const logger = new Logger({ name: SERVER_NAME });
+    if (activeStateStore && activeRepoPath) {
+        logger.info("Shutting down, saving final state...");
+        await shutdown(activeStateStore, activeRepoPath);
+        logger.info("State saved, shutdown complete");
+    }
+    else {
+        logger.debug("No state store active, nothing to persist");
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/startup.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Startup Coordinator
+ *
+ * Handles server initialization including:
+ * - State persistence loading
+ * - Recovery from previous crashes
+ * - Component initialization in correct order
+ */
+import { StateStore } from './persistence/state-store.js';
+import { type ReconciliationResult } from './worktrees/recovery.js';
+/**
+ * Configuration for startup initialization.
+ */
+export interface StartupConfig {
+    /** Path to the git repository root */
+    repoPath: string;
+    /** Base directory for worktrees (relative to repoPath) */
+    worktreeBaseDir?: string;
+    /** Branch name pattern for task branches */
+    branchPattern?: string;
+    /** Whether to run recovery on startup (default: true) */
+    autoRecover?: boolean;
+    /** Whether to automatically clean up orphaned resources (default: false) */
+    autoCleanOrphans?: boolean;
+}
+/**
+ * Result of the startup initialization process.
+ */
+export interface StartupResult {
+    /** The initialized state store */
+    stateStore: StateStore;
+    /** Result of the recovery process (if recovery was run) */
+    recoveryResult?: ReconciliationResult;
+    /** Warnings encountered during startup */
+    warnings: string[];
+}
+/**
+ * Initialize Agent Foundry with state persistence and recovery.
+ *
+ * Call this early in the server startup process to:
+ * 1. Load persisted state from disk
+ * 2. Reconcile state with physical worktrees
+ * 3. Clean up orphaned resources (if autoCleanOrphans is true)
+ *
+ * @param config - Startup configuration options
+ * @returns Promise resolving to the startup result
+ *
+ * @example
+ * ```typescript
+ * const { stateStore, recoveryResult, warnings } = await initializeWithRecovery({
+ *   repoPath: process.cwd(),
+ *   autoRecover: true,
+ * });
+ *
+ * if (warnings.length > 0) {
+ *   console.warn('Startup warnings:', warnings);
+ * }
+ * ```
+ */
+export declare function initializeWithRecovery(config: StartupConfig): Promise<StartupResult>;
+/**
+ * Gracefully shutdown the state store, ensuring final state is persisted.
+ *
+ * Call this before process exit to ensure no state is lost.
+ *
+ * @param stateStore - The state store to shutdown
+ * @param repoPath - Path to the repository root
+ *
+ * @example
+ * ```typescript
+ * process.on('SIGINT', async () => {
+ *   await shutdown(stateStore, repoPath);
+ *   process.exit(0);
+ * });
+ * ```
+ */
+export declare function shutdown(stateStore: StateStore, repoPath: string): Promise<void>;
+//# sourceMappingURL=startup.d.ts.map

package/dist/startup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../src/startup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AASrF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAgE1F;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtF"}

package/dist/startup.js

@@ -0,0 +1,107 @@
+/**
+ * Startup Coordinator
+ *
+ * Handles server initialization including:
+ * - State persistence loading
+ * - Recovery from previous crashes
+ * - Component initialization in correct order
+ */
+import { createLogger } from './observability/logger.js';
+import { StateStore } from './persistence/state-store.js';
+import { RecoveryManager } from './worktrees/recovery.js';
+const logger = createLogger({ name: 'startup' });
+// ============================================================================
+// Initialization
+// ============================================================================
+/**
+ * Initialize Agent Foundry with state persistence and recovery.
+ *
+ * Call this early in the server startup process to:
+ * 1. Load persisted state from disk
+ * 2. Reconcile state with physical worktrees
+ * 3. Clean up orphaned resources (if autoCleanOrphans is true)
+ *
+ * @param config - Startup configuration options
+ * @returns Promise resolving to the startup result
+ *
+ * @example
+ * ```typescript
+ * const { stateStore, recoveryResult, warnings } = await initializeWithRecovery({
+ *   repoPath: process.cwd(),
+ *   autoRecover: true,
+ * });
+ *
+ * if (warnings.length > 0) {
+ *   console.warn('Startup warnings:', warnings);
+ * }
+ * ```
+ */
+export async function initializeWithRecovery(config) {
+    const { repoPath, worktreeBaseDir = '.agent-foundry/worktrees', branchPattern = 'task/', autoRecover = true, autoCleanOrphans = false, } = config;
+    const warnings = [];
+    logger.info('Starting initialization', { repoPath, autoRecover });
+    // Step 1: Initialize state store
+    const stateStore = new StateStore();
+    await stateStore.initialize(repoPath);
+    const result = {
+        stateStore,
+        warnings,
+    };
+    // Step 2: Run recovery if enabled
+    if (autoRecover) {
+        const recoveryManager = new RecoveryManager(repoPath, worktreeBaseDir, branchPattern);
+        const persistedState = stateStore.getState();
+        // Only run recovery if we have a state with worktrees or tasks
+        const hasState = persistedState.worktrees.length > 0 || persistedState.tasks.length > 0;
+        const recoveryResult = await recoveryManager.recoverOnStartup(hasState ? persistedState : null, {
+            autoCleanOrphans,
+            preserveUncommittedChanges: true,
+            dryRun: false,
+        });
+        result.recoveryResult = recoveryResult;
+        // Log warnings for issues found
+        if (recoveryResult.orphanedWorktrees.length > 0) {
+            warnings.push(`Found ${recoveryResult.orphanedWorktrees.length} orphaned worktree(s)`);
+        }
+        if (recoveryResult.orphanedTasks.length > 0) {
+            warnings.push(`Found ${recoveryResult.orphanedTasks.length} orphaned task(s)`);
+        }
+        if (recoveryResult.stuckWorktrees.length > 0) {
+            warnings.push(`Found ${recoveryResult.stuckWorktrees.length} stuck worktree(s)`);
+        }
+        if (recoveryResult.errors.length > 0) {
+            warnings.push(`Recovery encountered ${recoveryResult.errors.length} error(s)`);
+        }
+        logger.info('Recovery complete', {
+            recovered: recoveryResult.recoveredWorktrees.length,
+            orphanedWorktrees: recoveryResult.orphanedWorktrees.length,
+            orphanedTasks: recoveryResult.orphanedTasks.length,
+            cleanedUp: recoveryResult.cleanedUp.length,
+        });
+    }
+    return result;
+}
+// ============================================================================
+// Shutdown
+// ============================================================================
+/**
+ * Gracefully shutdown the state store, ensuring final state is persisted.
+ *
+ * Call this before process exit to ensure no state is lost.
+ *
+ * @param stateStore - The state store to shutdown
+ * @param repoPath - Path to the repository root
+ *
+ * @example
+ * ```typescript
+ * process.on('SIGINT', async () => {
+ *   await shutdown(stateStore, repoPath);
+ *   process.exit(0);
+ * });
+ * ```
+ */
+export async function shutdown(stateStore, repoPath) {
+    logger.info('Shutting down, saving final state');
+    await stateStore.shutdown(repoPath);
+}
+//# sourceMappingURL=startup.js.map

package/dist/startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.js","sourceRoot":"","sources":["../src/startup.ts"],"names":[],"mappings":"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"}