mcp-agent-foundry 1.0.0

package/dist/worktrees/recovery.js

@@ -0,0 +1,371 @@
+/**
+ * Recovery Manager
+ *
+ * Handles startup recovery by reconciling persisted state with physical worktrees.
+ * Detects orphans, unlocks stuck worktrees, and cleans up abandoned resources.
+ */
+import { simpleGit } from 'simple-git';
+import path from 'path';
+import { promises as fs } from 'fs';
+import { createLogger } from '../observability/logger.js';
+const DEFAULT_OPTIONS = {
+    autoCleanOrphans: false,
+    maxStaleAgeMs: 24 * 60 * 60 * 1000, // 24 hours
+    preserveUncommittedChanges: true,
+    dryRun: false,
+};
+// ============================================================================
+// Recovery Manager
+// ============================================================================
+export class RecoveryManager {
+    repoPath;
+    worktreeBaseDir;
+    branchPattern;
+    git;
+    logger;
+    constructor(repoPath, worktreeBaseDir = '.agent-foundry/worktrees', branchPattern = 'task/') {
+        this.repoPath = repoPath;
+        this.worktreeBaseDir = worktreeBaseDir;
+        this.branchPattern = new RegExp(`^${branchPattern}`);
+        this.git = simpleGit(repoPath);
+        this.logger = createLogger({ name: 'recovery-manager' });
+    }
+    /**
+     * Main recovery entry point - call on server startup
+     */
+    async recoverOnStartup(persistedState, options = {}) {
+        const opts = { ...DEFAULT_OPTIONS, ...options };
+        this.logger.info('Starting recovery process', { dryRun: opts.dryRun });
+        const result = {
+            orphanedWorktrees: [],
+            orphanedTasks: [],
+            orphanedBranches: [],
+            recoveredWorktrees: [],
+            recoveredTasks: [],
+            stuckWorktrees: [],
+            cleanedUp: [],
+            errors: [],
+        };
+        try {
+            // Step 1: Discover physical state
+            const physicalWorktrees = await this.discoverPhysicalWorktrees();
+            const taskBranches = await this.discoverTaskBranches();
+            this.logger.info('Discovered physical state', {
+                physicalWorktrees: physicalWorktrees.size,
+                taskBranches: taskBranches.size,
+                persistedWorktrees: persistedState?.worktrees.length ?? 0,
+                persistedTasks: persistedState?.tasks.length ?? 0,
+            });
+            // Step 2: Reconcile if we have persisted state
+            if (persistedState) {
+                await this.reconcileWithPersistedState(persistedState, physicalWorktrees, taskBranches, result, opts);
+            }
+            else {
+                // No persisted state - all physical worktrees are orphans
+                await this.handleNoPersistedState(physicalWorktrees, taskBranches, result, opts);
+            }
+            // Step 3: Auto-cleanup if enabled
+            if (opts.autoCleanOrphans && !opts.dryRun) {
+                await this.cleanupOrphans(result, opts);
+            }
+            this.logger.info('Recovery complete', {
+                orphanedWorktrees: result.orphanedWorktrees.length,
+                orphanedTasks: result.orphanedTasks.length,
+                orphanedBranches: result.orphanedBranches.length,
+                recovered: result.recoveredWorktrees.length + result.recoveredTasks.length,
+                cleanedUp: result.cleanedUp.length,
+                errors: result.errors.length,
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.logger.error('Recovery failed', { error: err });
+            result.errors.push({
+                resource: 'recovery',
+                error: err.message,
+            });
+        }
+        return result;
+    }
+    /**
+     * Discover all physical worktrees in the worktree directory
+     */
+    async discoverPhysicalWorktrees() {
+        const worktrees = new Map();
+        const fullWorktreeDir = path.join(this.repoPath, this.worktreeBaseDir);
+        try {
+            const entries = await fs.readdir(fullWorktreeDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const worktreePath = path.join(fullWorktreeDir, entry.name);
+                try {
+                    const info = await this.getPhysicalWorktreeInfo(entry.name, worktreePath);
+                    worktrees.set(entry.name, info);
+                }
+                catch (error) {
+                    this.logger.warn('Failed to inspect worktree', { worktree: entry.name, error });
+                }
+            }
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+            // Directory doesn't exist - no worktrees
+        }
+        return worktrees;
+    }
+    async getPhysicalWorktreeInfo(id, worktreePath) {
+        const worktreeGit = simpleGit(worktreePath);
+        let branch = '';
+        let hasUncommittedChanges = false;
+        let lastCommitDate;
+        try {
+            const branchResult = await worktreeGit.revparse(['--abbrev-ref', 'HEAD']);
+            branch = branchResult.trim();
+            const status = await worktreeGit.status();
+            hasUncommittedChanges = !status.isClean();
+            const log = await worktreeGit.log(['-1', '--format=%ci']);
+            if (log.latest) {
+                lastCommitDate = new Date(log.latest.date);
+            }
+        }
+        catch (error) {
+            this.logger.debug('Failed to get worktree git info', { id, error });
+        }
+        return {
+            id,
+            path: worktreePath,
+            branch,
+            hasUncommittedChanges,
+            lastCommitDate,
+        };
+    }
+    /**
+     * Discover all task branches in the repository
+     */
+    async discoverTaskBranches() {
+        const branches = new Map();
+        try {
+            const branchList = await this.git.branch(['-a']);
+            for (const branchName of branchList.all) {
+                // Skip remote tracking branches for now
+                if (branchName.startsWith('remotes/'))
+                    continue;
+                if (this.branchPattern.test(branchName)) {
+                    try {
+                        const log = await this.git.log(['-1', '--format=%ci', branchName]);
+                        branches.set(branchName, {
+                            name: branchName,
+                            lastCommitDate: log.latest ? new Date(log.latest.date) : undefined,
+                        });
+                    }
+                    catch {
+                        branches.set(branchName, { name: branchName });
+                    }
+                }
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to list branches', { error });
+        }
+        return branches;
+    }
+    /**
+     * Reconcile persisted state with physical reality
+     */
+    async reconcileWithPersistedState(state, physicalWorktrees, taskBranches, result, _options) {
+        const persistedWorktreeIds = new Set(state.worktrees.map((w) => w.id));
+        // Check persisted worktrees against physical state
+        for (const persistedWorktree of state.worktrees) {
+            const physical = physicalWorktrees.get(persistedWorktree.id);
+            if (!physical) {
+                // Persisted worktree no longer exists physically
+                if (persistedWorktree.taskId) {
+                    const task = state.tasks.find((t) => t.taskId === persistedWorktree.taskId);
+                    result.orphanedTasks.push({
+                        taskId: persistedWorktree.taskId,
+                        role: task?.role ?? 'unknown',
+                        status: task?.status ?? 'unknown',
+                        reason: 'worktree_missing',
+                        worktreeId: persistedWorktree.id,
+                    });
+                }
+                continue;
+            }
+            // Check for stuck states
+            if (this.isStuckState(persistedWorktree.status)) {
+                result.stuckWorktrees.push(persistedWorktree.id);
+            }
+            // Worktree exists - mark as recovered
+            result.recoveredWorktrees.push(persistedWorktree.id);
+        }
+        // Check physical worktrees not in persisted state
+        for (const [id, physical] of physicalWorktrees) {
+            if (!persistedWorktreeIds.has(id)) {
+                result.orphanedWorktrees.push({
+                    id,
+                    path: physical.path,
+                    branch: physical.branch,
+                    reason: 'unknown_state',
+                    physicalExists: true,
+                    branchExists: taskBranches.has(physical.branch),
+                    hasUncommittedChanges: physical.hasUncommittedChanges,
+                });
+            }
+        }
+        // Check for orphaned branches
+        for (const [branchName, info] of taskBranches) {
+            const hasWorktree = Array.from(physicalWorktrees.values()).some((w) => w.branch === branchName);
+            if (!hasWorktree) {
+                result.orphanedBranches.push({
+                    name: branchName,
+                    reason: 'no_worktree',
+                    lastCommitDate: info.lastCommitDate,
+                });
+            }
+        }
+        // Check persisted tasks for orphans
+        for (const task of state.tasks) {
+            if (task.worktreeId && !physicalWorktrees.has(task.worktreeId)) {
+                // Already handled above
+                continue;
+            }
+            if (task.status === 'running' && !task.worktreeId) {
+                result.orphanedTasks.push({
+                    taskId: task.taskId,
+                    role: task.role,
+                    status: task.status,
+                    reason: 'no_worktree',
+                });
+            }
+        }
+    }
+    /**
+     * Handle case where we have no persisted state
+     */
+    async handleNoPersistedState(physicalWorktrees, taskBranches, result, _options) {
+        this.logger.warn('No persisted state found - all physical worktrees are orphans');
+        // All physical worktrees are orphans
+        for (const [id, physical] of physicalWorktrees) {
+            result.orphanedWorktrees.push({
+                id,
+                path: physical.path,
+                branch: physical.branch,
+                reason: 'no_task',
+                physicalExists: true,
+                branchExists: taskBranches.has(physical.branch),
+                hasUncommittedChanges: physical.hasUncommittedChanges,
+            });
+        }
+        // All task branches without worktrees are orphans
+        for (const [branchName, info] of taskBranches) {
+            const hasWorktree = Array.from(physicalWorktrees.values()).some((w) => w.branch === branchName);
+            if (!hasWorktree) {
+                result.orphanedBranches.push({
+                    name: branchName,
+                    reason: 'no_worktree',
+                    lastCommitDate: info.lastCommitDate,
+                });
+            }
+        }
+    }
+    isStuckState(status) {
+        // These are transitional states that shouldn't persist across restarts
+        return status === 'assigned' || status === 'completing';
+    }
+    /**
+     * Clean up orphaned resources
+     */
+    async cleanupOrphans(result, options) {
+        for (const orphan of result.orphanedWorktrees) {
+            if (options.preserveUncommittedChanges && orphan.hasUncommittedChanges) {
+                this.logger.info('Preserving orphan with uncommitted changes', { id: orphan.id });
+                continue;
+            }
+            try {
+                await this.removeWorktree(orphan.id, orphan.path, orphan.branch);
+                result.cleanedUp.push(orphan.id);
+            }
+            catch (error) {
+                result.errors.push({
+                    resource: orphan.id,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        for (const orphan of result.orphanedBranches) {
+            try {
+                await this.git.deleteLocalBranch(orphan.name, true);
+                result.cleanedUp.push(`branch:${orphan.name}`);
+                this.logger.info('Deleted orphan branch', { branch: orphan.name });
+            }
+            catch (error) {
+                result.errors.push({
+                    resource: `branch:${orphan.name}`,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    async removeWorktree(id, worktreePath, branch) {
+        this.logger.info('Removing orphan worktree', { id, branch });
+        // Remove the worktree
+        await this.git.raw(['worktree', 'remove', '--force', worktreePath]);
+        // Delete the branch
+        try {
+            await this.git.deleteLocalBranch(branch, true);
+        }
+        catch {
+            // Branch may already be deleted
+        }
+    }
+    /**
+     * Unlock worktrees stuck in transitional states
+     */
+    async unlockStuckWorktrees(stuckIds, worktrees) {
+        const unlocked = [];
+        for (const id of stuckIds) {
+            const worktree = worktrees.get(id);
+            if (!worktree)
+                continue;
+            // Reset to available if assigned, or stale if completing
+            const newStatus = worktree.status === 'assigned' ? 'available' : 'stale';
+            worktree.status = newStatus;
+            worktree.lastActivityAt = Date.now();
+            unlocked.push(id);
+            this.logger.info('Unlocked stuck worktree', {
+                id,
+                oldStatus: worktree.status,
+                newStatus,
+            });
+        }
+        return unlocked;
+    }
+    /**
+     * Prune worktrees that have been stale too long
+     */
+    async pruneStaleWorktrees(worktrees, maxAgeMs = DEFAULT_OPTIONS.maxStaleAgeMs) {
+        const now = Date.now();
+        const pruned = [];
+        for (const [id, worktree] of worktrees) {
+            if (worktree.status !== 'stale')
+                continue;
+            const age = now - worktree.lastActivityAt;
+            if (age > maxAgeMs) {
+                try {
+                    await this.removeWorktree(id, worktree.path, worktree.branch);
+                    worktrees.delete(id);
+                    pruned.push(id);
+                }
+                catch (error) {
+                    const err = error instanceof Error ? error : new Error(String(error));
+                    this.logger.error('Failed to prune stale worktree', { id, error: err });
+                }
+            }
+        }
+        return pruned;
+    }
+}
+//# sourceMappingURL=recovery.js.map

package/dist/worktrees/recovery.js.map

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

package/dist/worktrees/resource-manager.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Resource Manager
+ *
+ * Manages worktree resource limits including count, disk usage,
+ * stale detection, and automatic cleanup.
+ */
+import type { WorktreeManager } from "./manager.js";
+import type { ResourceLimits, ResourceUsage, WorktreeMetrics, ResourceReport, Worktree, WorktreeStatus } from "../types.js";
+export declare class ResourceManager {
+    private readonly worktreeManager;
+    private readonly limits;
+    private readonly logger;
+    constructor(worktreeManager: WorktreeManager, limits?: Partial<ResourceLimits>);
+    /**
+     * Get current resource usage.
+     */
+    getCurrentUsage(): Promise<ResourceUsage>;
+    /**
+     * Check if a new worktree can be allocated.
+     */
+    canAllocate(): Promise<{
+        allowed: boolean;
+        reason?: string;
+    }>;
+    /**
+     * Get detailed metrics for all worktrees.
+     */
+    getAllWorktreeMetrics(): Promise<WorktreeMetrics[]>;
+    /**
+     * Get metrics for a specific worktree.
+     */
+    getWorktreeMetrics(worktreeId: string): Promise<WorktreeMetrics | null>;
+    /**
+     * Find stale worktrees (idle beyond threshold).
+     */
+    findStaleWorktrees(maxIdleTimeMs?: number): Worktree[];
+    /**
+     * Check if cleanup should be triggered.
+     */
+    shouldTriggerCleanup(): Promise<boolean>;
+    /**
+     * Cleanup stale worktrees.
+     */
+    cleanupStale(maxIdleTimeMs?: number): Promise<string[]>;
+    /**
+     * Cleanup worktrees by status.
+     */
+    cleanupByStatus(status: WorktreeStatus): Promise<string[]>;
+    /**
+     * Force cleanup specific worktrees.
+     */
+    forceCleanup(worktreeIds: string[]): Promise<{
+        cleaned: string[];
+        failed: string[];
+    }>;
+    /**
+     * Get full resource report.
+     */
+    getReport(): Promise<ResourceReport>;
+    /**
+     * Calculate disk usage for a path in MB.
+     *
+     * Note: Uses execSync with shell for the du command. The dirPath parameter
+     * is system-controlled (comes from WorktreeManager internal state) and is
+     * quoted to prevent any injection. This is safe as worktree paths are
+     * generated internally and not from user input.
+     */
+    private calculateDiskUsage;
+    /**
+     * Get the configured limits.
+     */
+    getLimits(): ResourceLimits;
+}
+//# sourceMappingURL=resource-manager.d.ts.map

package/dist/worktrees/resource-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-manager.d.ts","sourceRoot":"","sources":["../../src/worktrees/resource-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,EACd,QAAQ,EACR,cAAc,EACf,MAAM,aAAa,CAAC;AASrB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAGtB,eAAe,EAAE,eAAe,EAChC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAOlC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC;IAuB/C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBnE;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAoBzD;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgB7E;;OAEG;IACH,kBAAkB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE;IAatD;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;IAK9C;;OAEG;IACG,YAAY,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuB7D;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBhE;;OAEG;IACG,YAAY,CAChB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAoBnD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IAc1C;;;;;;;OAOG;YACW,kBAAkB;IAehC;;OAEG;IACH,SAAS,IAAI,cAAc;CAG5B"}