@litmers/cursorflow-orchestrator 0.1.18 → 0.1.26

package/dist/utils/run-service.js

@@ -0,0 +1,412 @@
+"use strict";
+/**
+ * RunService - Manages CursorFlow run history and active processes
+ *
+ * Provides:
+ * - List all runs (with filtering by status)
+ * - Get detailed run information
+ * - Stop running processes
+ * - Delete run resources
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunService = void 0;
+exports.createRunService = createRunService;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger = __importStar(require("./logger"));
+class RunService {
+    logsDir;
+    runsDir;
+    constructor(logsDir) {
+        this.logsDir = logsDir;
+        this.runsDir = path.join(logsDir, 'runs');
+    }
+    /**
+     * List all runs with optional filtering
+     */
+    listRuns(filter = {}) {
+        const { status, limit, taskName } = filter;
+        if (!fs.existsSync(this.runsDir)) {
+            return [];
+        }
+        const runDirs = fs.readdirSync(this.runsDir)
+            .filter(name => name.startsWith('run-'))
+            .sort((a, b) => b.localeCompare(a)); // Most recent first
+        let runs = [];
+        for (const runId of runDirs) {
+            const runInfo = this.getRunInfo(runId);
+            if (!runInfo)
+                continue;
+            // Apply filters
+            if (status && runInfo.status !== status)
+                continue;
+            if (taskName && !runInfo.taskName.toLowerCase().includes(taskName.toLowerCase()))
+                continue;
+            runs.push(runInfo);
+            if (limit && runs.length >= limit)
+                break;
+        }
+        return runs;
+    }
+    /**
+     * Get detailed information about a specific run
+     */
+    getRunInfo(runId) {
+        const runPath = path.join(this.runsDir, runId);
+        if (!fs.existsSync(runPath)) {
+            return null;
+        }
+        try {
+            // Read orchestrator state
+            const statePath = path.join(runPath, 'state.json');
+            let taskName = 'Unknown';
+            let lanes = [];
+            let branches = [];
+            let worktrees = [];
+            if (fs.existsSync(statePath)) {
+                const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+                taskName = state.taskName || this.extractTaskNameFromRunId(runId);
+                // Extract lane info from state
+                if (state.lanes) {
+                    for (const [laneName, laneState] of Object.entries(state.lanes)) {
+                        const ls = laneState;
+                        lanes.push({
+                            name: laneName,
+                            status: ls.status,
+                            currentTask: ls.currentTaskIndex,
+                            totalTasks: ls.totalTasks,
+                            pid: ls.pid,
+                            pipelineBranch: ls.pipelineBranch || undefined,
+                        });
+                        if (ls.pipelineBranch) {
+                            branches.push(ls.pipelineBranch);
+                        }
+                        if (ls.worktreeDir) {
+                            worktrees.push(ls.worktreeDir);
+                        }
+                    }
+                }
+            }
+            // Alternatively, scan lanes directory
+            const lanesDir = path.join(runPath, 'lanes');
+            if (fs.existsSync(lanesDir) && lanes.length === 0) {
+                const laneDirs = fs.readdirSync(lanesDir);
+                for (const laneName of laneDirs) {
+                    const laneStatePath = path.join(lanesDir, laneName, 'state.json');
+                    if (fs.existsSync(laneStatePath)) {
+                        try {
+                            const laneState = JSON.parse(fs.readFileSync(laneStatePath, 'utf-8'));
+                            lanes.push({
+                                name: laneName,
+                                status: laneState.status,
+                                currentTask: laneState.currentTaskIndex,
+                                totalTasks: laneState.totalTasks,
+                                pid: laneState.pid,
+                                pipelineBranch: laneState.pipelineBranch || undefined,
+                            });
+                            if (laneState.pipelineBranch) {
+                                branches.push(laneState.pipelineBranch);
+                            }
+                            if (laneState.worktreeDir) {
+                                worktrees.push(laneState.worktreeDir);
+                            }
+                        }
+                        catch {
+                            // Skip invalid state files
+                        }
+                    }
+                }
+            }
+            // Calculate run status and timing
+            const status = this.calculateRunStatus(lanes);
+            const startTime = this.extractTimestampFromRunId(runId);
+            const endTime = this.getRunEndTime(runPath, lanes);
+            const duration = endTime ? endTime - startTime : Date.now() - startTime;
+            return {
+                id: runId,
+                path: runPath,
+                taskName,
+                status,
+                startTime,
+                endTime,
+                duration,
+                lanes,
+                branches: [...new Set(branches)],
+                worktrees: [...new Set(worktrees)],
+            };
+        }
+        catch (error) {
+            logger.debug(`Failed to read run info for ${runId}: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Get currently active (running) runs
+     */
+    getActiveRuns() {
+        return this.listRuns({ status: 'running' });
+    }
+    /**
+     * Calculate overall run status based on lane statuses
+     */
+    calculateRunStatus(lanes) {
+        if (lanes.length === 0)
+            return 'pending';
+        const statuses = lanes.map(l => l.status);
+        // If any lane is running, the run is running
+        if (statuses.some(s => s === 'running' || s === 'reviewing')) {
+            return 'running';
+        }
+        // If all lanes are completed, the run is completed
+        if (statuses.every(s => s === 'completed')) {
+            return 'completed';
+        }
+        // If any lane failed and none are running, check for partial completion
+        if (statuses.some(s => s === 'failed')) {
+            const hasCompleted = statuses.some(s => s === 'completed');
+            return hasCompleted ? 'partial' : 'failed';
+        }
+        // If some are pending and some completed
+        if (statuses.some(s => s === 'pending' || s === 'waiting')) {
+            return statuses.some(s => s === 'completed') ? 'partial' : 'pending';
+        }
+        return 'pending';
+    }
+    /**
+     * Extract timestamp from run ID (format: run-TIMESTAMP)
+     */
+    extractTimestampFromRunId(runId) {
+        const match = runId.match(/run-(\d+)/);
+        return match ? parseInt(match[1], 10) : Date.now();
+    }
+    /**
+     * Extract task name from run ID or directory structure
+     */
+    extractTaskNameFromRunId(runId) {
+        // Try to read from any lane's tasks file reference
+        const runPath = path.join(this.runsDir, runId);
+        const lanesDir = path.join(runPath, 'lanes');
+        if (fs.existsSync(lanesDir)) {
+            const laneDirs = fs.readdirSync(lanesDir);
+            for (const laneName of laneDirs) {
+                const statePath = path.join(lanesDir, laneName, 'state.json');
+                if (fs.existsSync(statePath)) {
+                    try {
+                        const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+                        if (state.tasksFile) {
+                            const taskDir = path.basename(path.dirname(state.tasksFile));
+                            // Extract feature name from timestamp_FeatureName format
+                            const parts = taskDir.split('_');
+                            if (parts.length >= 2) {
+                                return parts.slice(1).join('_');
+                            }
+                            return taskDir;
+                        }
+                    }
+                    catch {
+                        // Continue to next lane
+                    }
+                }
+            }
+        }
+        return 'Unknown';
+    }
+    /**
+     * Get run end time from lane states
+     */
+    getRunEndTime(runPath, lanes) {
+        const terminalStatuses = ['completed', 'failed'];
+        if (!lanes.every(l => terminalStatuses.includes(l.status))) {
+            return undefined; // Still running
+        }
+        // Find the latest end time from lane states
+        const lanesDir = path.join(runPath, 'lanes');
+        let latestEndTime = 0;
+        if (fs.existsSync(lanesDir)) {
+            const laneDirs = fs.readdirSync(lanesDir);
+            for (const laneName of laneDirs) {
+                const statePath = path.join(lanesDir, laneName, 'state.json');
+                if (fs.existsSync(statePath)) {
+                    try {
+                        const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+                        if (state.endTime && state.endTime > latestEndTime) {
+                            latestEndTime = state.endTime;
+                        }
+                    }
+                    catch {
+                        // Skip
+                    }
+                }
+            }
+        }
+        return latestEndTime > 0 ? latestEndTime : undefined;
+    }
+    /**
+     * Get resources linked to a run (branches, worktrees)
+     */
+    getLinkedResources(runId) {
+        const runInfo = this.getRunInfo(runId);
+        if (!runInfo) {
+            return { branches: [], worktrees: [], logSize: 0 };
+        }
+        // Calculate log size
+        let logSize = 0;
+        try {
+            logSize = this.getDirectorySize(runInfo.path);
+        }
+        catch {
+            // Ignore size calculation errors
+        }
+        return {
+            branches: runInfo.branches,
+            worktrees: runInfo.worktrees,
+            logSize,
+        };
+    }
+    /**
+     * Stop a running workflow
+     */
+    stopRun(runId) {
+        const runInfo = this.getRunInfo(runId);
+        if (!runInfo || runInfo.status !== 'running') {
+            return false;
+        }
+        let stopped = false;
+        for (const lane of runInfo.lanes) {
+            if (lane.pid && lane.status === 'running') {
+                try {
+                    process.kill(lane.pid, 'SIGTERM');
+                    stopped = true;
+                    logger.info(`Stopped lane ${lane.name} (PID: ${lane.pid})`, { context: runId });
+                }
+                catch (error) {
+                    logger.debug(`Failed to stop lane ${lane.name}: ${error}`);
+                }
+            }
+        }
+        return stopped;
+    }
+    /**
+     * Stop all running workflows
+     */
+    stopAllRuns() {
+        const activeRuns = this.getActiveRuns();
+        let stoppedCount = 0;
+        for (const run of activeRuns) {
+            if (this.stopRun(run.id)) {
+                stoppedCount++;
+            }
+        }
+        return stoppedCount;
+    }
+    /**
+     * Delete a run and optionally its associated resources
+     */
+    deleteRun(runId, options = {}) {
+        const runInfo = this.getRunInfo(runId);
+        if (!runInfo) {
+            throw new Error(`Run not found: ${runId}`);
+        }
+        // Don't delete running runs
+        if (runInfo.status === 'running') {
+            throw new Error(`Cannot delete running run: ${runId}. Stop it first.`);
+        }
+        // Delete log directory
+        if (fs.existsSync(runInfo.path)) {
+            fs.rmSync(runInfo.path, { recursive: true, force: true });
+            logger.success(`Deleted run logs: ${runId}`);
+        }
+        // Note: Branch and worktree deletion should be handled by clean command
+        // as it requires git operations
+    }
+    /**
+     * Calculate directory size in bytes
+     */
+    getDirectorySize(dirPath) {
+        let size = 0;
+        const files = fs.readdirSync(dirPath);
+        for (const file of files) {
+            const filePath = path.join(dirPath, file);
+            const stat = fs.statSync(filePath);
+            if (stat.isDirectory()) {
+                size += this.getDirectorySize(filePath);
+            }
+            else {
+                size += stat.size;
+            }
+        }
+        return size;
+    }
+    /**
+     * Format duration for display
+     */
+    static formatDuration(ms) {
+        const seconds = Math.floor(ms / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        if (hours > 0) {
+            return `${hours}h ${minutes % 60}m`;
+        }
+        else if (minutes > 0) {
+            return `${minutes}m ${seconds % 60}s`;
+        }
+        else {
+            return `${seconds}s`;
+        }
+    }
+    /**
+     * Format bytes for display
+     */
+    static formatBytes(bytes) {
+        if (bytes < 1024)
+            return `${bytes} B`;
+        if (bytes < 1024 * 1024)
+            return `${(bytes / 1024).toFixed(1)} KB`;
+        if (bytes < 1024 * 1024 * 1024)
+            return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+        return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+    }
+}
+exports.RunService = RunService;
+/**
+ * Create a RunService instance with default paths
+ */
+function createRunService(projectRoot) {
+    const root = projectRoot || process.cwd();
+    const logsDir = path.join(root, '_cursorflow', 'logs');
+    return new RunService(logsDir);
+}
+//# sourceMappingURL=run-service.js.map

package/dist/utils/run-service.js.map

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

package/dist/utils/state.d.ts

@@ -1,16 +1,72 @@
 /**
  * State management utilities for CursorFlow
+ *
+ * Features:
+ * - Atomic writes to prevent corruption
+ * - State validation and repair
+ * - Versioned state with conflict detection
  */
 import { LaneState, ConversationEntry, GitLogEntry, EventEntry, RunnerConfig } from './types';
+import { LockOptions } from './lock';
 export { LaneState, ConversationEntry, GitLogEntry, EventEntry };
 /**
- * Save state to JSON file
+ * Extended state with metadata for versioning
+ */
+export interface VersionedState<T> {
+    _version: number;
+    _updatedAt: number;
+    _pid: number;
+    data: T;
+}
+/**
+ * State validation result
+ */
+export interface StateValidationResult {
+    valid: boolean;
+    issues: string[];
+    repaired: boolean;
+    repairedState?: LaneState;
+}
+/**
+ * Save state to JSON file with atomic write
  */
 export declare function saveState(statePath: string, state: any): void;
 /**
- * Load state from JSON file
+ * Save state with file lock to prevent race conditions
+ */
+export declare function saveStateWithLock(statePath: string, state: any, lockOptions?: LockOptions): void;
+/**
+ * Load state from JSON file with corruption recovery
  */
 export declare function loadState<T = any>(statePath: string): T | null;
+/**
+ * Load state with automatic backup creation
+ */
+export declare function loadStateWithBackup<T = any>(statePath: string): T | null;
+/**
+ * Update state with optimistic locking
+ */
+export declare function updateStateAtomic(statePath: string, updater: (state: LaneState | null) => LaneState): LaneState;
+/**
+ * Validate lane state and check for inconsistencies
+ */
+export declare function validateLaneState(statePath: string, options?: {
+    checkWorktree?: boolean;
+    checkBranch?: boolean;
+    autoRepair?: boolean;
+}): StateValidationResult;
+/**
+ * Repair lane state by resetting inconsistent values
+ */
+export declare function repairLaneState(statePath: string): LaneState | null;
+/**
+ * Check if state needs recovery (e.g., after crash)
+ */
+export declare function stateNeedsRecovery(statePath: string): boolean;
+/**
+ * Clean up temp files from incomplete writes
+ */
+export declare function cleanupTempFiles(stateDir: string): number;
 /**
  * Append to JSONL log file
  */
@@ -22,7 +78,10 @@ export declare function readLog<T = any>(logPath: string): T[];
 /**
  * Create initial lane state
  */
-export declare function createLaneState(laneName: string, config: RunnerConfig): LaneState;
+export declare function createLaneState(laneName: string, config: RunnerConfig, tasksFile?: string, options?: {
+    pipelineBranch?: string;
+    worktreeDir?: string;
+}): LaneState;
 /**
  * Update lane state
  */