@litmers/cursorflow-orchestrator 0.1.20 → 0.1.28

package/dist/cli/stop.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * CursorFlow stop command - Stop running workflows or specific lanes
+ */
+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;
+    };
+})();
+const readline = __importStar(require("readline"));
+const logger = __importStar(require("../utils/logger"));
+const config_1 = require("../utils/config");
+const run_service_1 = require("../utils/run-service");
+const process_manager_1 = require("../utils/process-manager");
+const path_1 = require("../utils/path");
+function printHelp() {
+    console.log(`
+Usage: cursorflow stop [run-id] [options]
+
+Stop running workflows or specific lanes.
+
+Options:
+  [run-id]               Stop a specific run
+  --lane <name>          Stop only a specific lane
+  --force                Use SIGKILL instead of SIGTERM
+  --yes, -y              Skip confirmation prompt
+  --help, -h             Show help
+
+Examples:
+  cursorflow stop              # Stop all running workflows
+  cursorflow stop run-123      # Stop run-123
+  cursorflow stop --lane api   # Stop only the 'api' lane in the latest run
+  cursorflow stop --force      # Force stop all workflows
+  `);
+}
+function parseArgs(args) {
+    const laneIdx = args.indexOf('--lane');
+    // Find run ID (first non-option argument)
+    const runId = args.find((arg, i) => {
+        if (arg.startsWith('--') || arg.startsWith('-'))
+            return false;
+        // Skip values for options
+        const prevArg = args[i - 1];
+        if (prevArg && ['--lane'].includes(prevArg)) {
+            return false;
+        }
+        return true;
+    });
+    return {
+        runId,
+        lane: laneIdx >= 0 ? args[laneIdx + 1] : undefined,
+        force: args.includes('--force'),
+        yes: args.includes('--yes') || args.includes('-y'),
+        help: args.includes('--help') || args.includes('-h'),
+    };
+}
+/**
+ * Prompt user for confirmation
+ */
+async function confirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${message} [y/N]: `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+}
+async function stop(args) {
+    const options = parseArgs(args);
+    if (options.help) {
+        printHelp();
+        return;
+    }
+    const config = (0, config_1.loadConfig)();
+    const logsDir = (0, config_1.getLogsDir)(config);
+    const runsDir = (0, path_1.safeJoin)(logsDir, 'runs');
+    const runService = new run_service_1.RunService(runsDir);
+    const signal = options.force ? 'SIGKILL' : 'SIGTERM';
+    // Case 1: Stop specific lane in specific run (or latest if runId not provided)
+    if (options.lane) {
+        let runId = options.runId;
+        if (!runId) {
+            const activeRuns = runService.getActiveRuns();
+            if (activeRuns.length === 0) {
+                logger.info('No active runs found.');
+                return;
+            }
+            runId = activeRuns[0].id;
+        }
+        const run = runService.getRunInfo(runId);
+        if (!run) {
+            throw new Error(`Run not found: ${runId}`);
+        }
+        const lane = run.lanes.find(l => l.name === options.lane);
+        if (!lane) {
+            throw new Error(`Lane '${options.lane}' not found in run '${runId}'`);
+        }
+        if (!lane.pid) {
+            logger.info(`Lane '${options.lane}' is not currently running (no PID).`);
+            return;
+        }
+        if (!options.yes) {
+            const ok = await confirm(`⚠️  Stop lane '${options.lane}' in run '${runId}'?`);
+            if (!ok)
+                return;
+        }
+        logger.info(`🛑 Stopping lane '${options.lane}' (PID ${lane.pid})...`);
+        if (process_manager_1.ProcessManager.killProcess(lane.pid, signal)) {
+            logger.success(`✓ lane '${options.lane}' stopped.`);
+        }
+        else {
+            logger.error(`Failed to stop lane '${options.lane}'.`);
+        }
+        return;
+    }
+    // Case 2: Stop specific run
+    if (options.runId) {
+        const run = runService.getRunInfo(options.runId);
+        if (!run) {
+            throw new Error(`Run not found: ${options.runId}`);
+        }
+        if (run.status !== 'running') {
+            logger.info(`Run '${options.runId}' is not currently running (Status: ${run.status}).`);
+            return;
+        }
+        if (!options.yes) {
+            const ok = await confirm(`⚠️  Stop run '${options.runId}' (${run.taskName})?`);
+            if (!ok)
+                return;
+        }
+        logger.info(`🛑 Stopping run '${options.runId}'...`);
+        let stoppedCount = 0;
+        for (const lane of run.lanes) {
+            if (lane.pid && process_manager_1.ProcessManager.killProcess(lane.pid, signal)) {
+                logger.info(`  ✓ lane '${lane.name}' (PID ${lane.pid}) stopped`);
+                stoppedCount++;
+            }
+        }
+        if (stoppedCount > 0) {
+            logger.success(`✅ Run '${options.runId}' stopped.`);
+        }
+        else {
+            logger.info('No active lanes were stopped.');
+        }
+        return;
+    }
+    // Case 3: Stop all running workflows
+    const activeRuns = runService.getActiveRuns();
+    if (activeRuns.length === 0) {
+        logger.info('No active runs found.');
+        return;
+    }
+    if (!options.yes) {
+        console.log('\n⚠️  Stop all running workflows?\n');
+        console.log('Currently running:');
+        for (const run of activeRuns) {
+            const activeLanes = run.lanes.filter(l => l.pid).length;
+            console.log(`  - ${run.id} (${run.taskName}): ${activeLanes} lanes active`);
+        }
+        console.log('');
+        const ok = await confirm('Continue?');
+        if (!ok)
+            return;
+    }
+    logger.info('🛑 Stopping all workflows...');
+    let totalStopped = 0;
+    for (const run of activeRuns) {
+        for (const lane of run.lanes) {
+            if (lane.pid && process_manager_1.ProcessManager.killProcess(lane.pid, signal)) {
+                logger.info(`  ✓ lane '${lane.name}' (PID ${lane.pid}) stopped`);
+                totalStopped++;
+            }
+        }
+    }
+    if (totalStopped > 0) {
+        logger.success(`\n✅ All workflows stopped (${totalStopped} lanes).`);
+    }
+    else {
+        logger.info('\nNo active lanes were stopped.');
+    }
+}
+module.exports = stop;
+//# sourceMappingURL=stop.js.map

package/dist/cli/stop.js.map

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

package/dist/cli/tasks.d.ts

@@ -0,0 +1,10 @@
+/**
+ * CursorFlow tasks command
+ *
+ * Usage:
+ *   cursorflow tasks              # List all tasks
+ *   cursorflow tasks --validate   # List all tasks with validation
+ *   cursorflow tasks <name>       # Show detailed task info
+ */
+declare function tasks(args: string[]): Promise<void>;
+export = tasks;

package/dist/cli/tasks.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * CursorFlow tasks command
+ *
+ * Usage:
+ *   cursorflow tasks              # List all tasks
+ *   cursorflow tasks --validate   # List all tasks with validation
+ *   cursorflow tasks <name>       # Show detailed task info
+ */
+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;
+    };
+})();
+const logger = __importStar(require("../utils/logger"));
+const task_service_1 = require("../utils/task-service");
+const config_1 = require("../utils/config");
+const COLORS = logger.COLORS;
+function printHelp() {
+    console.log(`
+Usage: cursorflow tasks [options] [task-name]
+
+Manage and view prepared tasks in _cursorflow/tasks/.
+
+Options:
+  --validate             Run validation on all tasks before listing
+  --help, -h             Show help
+
+Examples:
+  cursorflow tasks
+  cursorflow tasks --validate
+  cursorflow tasks 2412221530_AuthSystem
+  `);
+}
+function parseArgs(args) {
+    const options = {
+        validate: args.includes('--validate'),
+        taskName: null,
+    };
+    const nameArg = args.find(arg => !arg.startsWith('-'));
+    if (nameArg) {
+        options.taskName = nameArg;
+    }
+    if (args.includes('--help') || args.includes('-h')) {
+        printHelp();
+        process.exit(0);
+    }
+    return options;
+}
+function formatDate(date) {
+    const months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+    return `${months[date.getMonth()]} ${date.getDate()}`;
+}
+function getStatusLabel(info) {
+    const status = info.validationStatus;
+    const icon = status === 'valid' ? '✅' : status === 'warnings' ? '⚠️' : status === 'errors' ? '❌' : '❓';
+    if (status === 'valid')
+        return `${icon} Valid`;
+    if (status === 'warnings')
+        return `${icon} Warnings`;
+    if (status === 'errors')
+        return `${icon} Errors`;
+    return `${icon} Unknown`;
+}
+function printTasksList(tasks) {
+    if (tasks.length === 0) {
+        logger.info('No tasks found in _cursorflow/tasks/');
+        return;
+    }
+    console.log(`${COLORS.bold}Prepared Tasks:${COLORS.reset}`);
+    for (let i = 0; i < tasks.length; i++) {
+        const task = tasks[i];
+        const prefix = i === 0 ? '  ▶' : '   ';
+        const name = task.name.padEnd(30);
+        const lanes = `${task.lanes.length} lane${task.lanes.length > 1 ? 's' : ''}`.padEnd(10);
+        const status = getStatusLabel(task).padEnd(14);
+        const date = formatDate(task.timestamp);
+        let color = COLORS.reset;
+        if (task.validationStatus === 'errors')
+            color = COLORS.red;
+        else if (task.validationStatus === 'warnings')
+            color = COLORS.yellow;
+        else if (task.validationStatus === 'valid')
+            color = COLORS.green;
+        console.log(`${color}${prefix} ${name} ${lanes} ${status} ${date}${COLORS.reset}`);
+    }
+}
+function printTaskDetail(info) {
+    console.log(`${COLORS.bold}Task: ${info.name}${COLORS.reset}`);
+    console.log(`${COLORS.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${COLORS.reset}`);
+    if (info.lanes.length === 0) {
+        console.log('No lanes defined.');
+    }
+    else {
+        console.log(`${COLORS.bold}Lanes:${COLORS.reset}`);
+        for (const lane of info.lanes) {
+            const fileName = lane.fileName.padEnd(18);
+            const preset = `[${lane.preset}]`.padEnd(10);
+            const flow = lane.taskFlow;
+            const depends = lane.dependsOn.length > 0 ? ` ${COLORS.gray}(depends: ${lane.dependsOn.join(', ')})${COLORS.reset}` : '';
+            console.log(`  ${fileName} ${COLORS.blue}${preset}${COLORS.reset} ${flow}${depends}`);
+        }
+    }
+}
+async function tasks(args) {
+    const options = parseArgs(args);
+    const projectRoot = (0, config_1.findProjectRoot)();
+    const config = (0, config_1.loadConfig)(projectRoot);
+    const tasksDir = (0, config_1.getTasksDir)(config);
+    const taskService = new task_service_1.TaskService(tasksDir);
+    if (options.taskName) {
+        const info = taskService.getTaskDirInfo(options.taskName);
+        if (!info) {
+            logger.error(`Task not found: ${options.taskName}`);
+            process.exit(1);
+        }
+        // Always validate for detail view to have report
+        taskService.validateTaskDir(options.taskName);
+        const updatedInfo = taskService.getTaskDirInfo(options.taskName);
+        printTaskDetail(updatedInfo);
+    }
+    else {
+        let taskList = taskService.listTaskDirs();
+        if (options.validate) {
+            const spinner = logger.createSpinner('Validating tasks...');
+            spinner.start();
+            for (const task of taskList) {
+                taskService.validateTaskDir(task.name);
+            }
+            spinner.succeed('Validation complete');
+            taskList = taskService.listTaskDirs();
+        }
+        printTasksList(taskList);
+    }
+}
+module.exports = tasks;
+//# sourceMappingURL=tasks.js.map

package/dist/cli/tasks.js.map

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

package/dist/core/auto-recovery.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Auto-Recovery Module
+ *
+ * Automatic recovery strategies for common orchestration failures:
+ * - Agent idle/no response detection with escalating interventions
+ * - Guidance messages for git conflicts and push failures
+ * - Process health monitoring with restart capabilities
+ * - Doctor integration for persistent failures
+ * - POF (Post-mortem of Failure) saving for failed recoveries
+ */
+import { ChildProcess } from 'child_process';
+import { LaneState } from '../utils/types';
+/** Recovery stages for escalating interventions */
+export declare enum RecoveryStage {
+    /** Normal operation - monitoring */
+    NORMAL = 0,
+    /** First intervention - send continue signal */
+    CONTINUE_SIGNAL = 1,
+    /** Second intervention - send stronger prompt */
+    STRONGER_PROMPT = 2,
+    /** Third intervention - kill and restart process */
+    RESTART_PROCESS = 3,
+    /** Final stage - run doctor and report */
+    DIAGNOSE = 4,
+    /** No more recovery possible */
+    ABORT = 5
+}
+/** Configuration for auto-recovery behavior */
+export interface AutoRecoveryConfig {
+    /** Time without activity before sending continue signal (default: 2 minutes) */
+    idleTimeoutMs: number;
+    /** Time to wait after continue signal before escalating (default: 2 minutes) */
+    continueGraceMs: number;
+    /** Time to wait after stronger prompt before escalating (default: 2 minutes) */
+    strongerPromptGraceMs: number;
+    /** Maximum number of restarts before aborting (default: 2) */
+    maxRestarts: number;
+    /** Whether to run doctor on persistent failures (default: true) */
+    runDoctorOnFailure: boolean;
+    /** Patterns indicating long-running operations (won't trigger idle) */
+    longOperationPatterns: RegExp[];
+    /** Grace period for long operations (default: 10 minutes) */
+    longOperationGraceMs: number;
+    /** Enable verbose logging */
+    verbose: boolean;
+}
+/** Default auto-recovery configuration */
+export declare const DEFAULT_AUTO_RECOVERY_CONFIG: AutoRecoveryConfig;
+/** State tracking for a single lane's recovery */
+export interface LaneRecoveryState {
+    laneName: string;
+    stage: RecoveryStage;
+    lastActivityTime: number;
+    lastBytesReceived: number;
+    totalBytesReceived: number;
+    lastOutput: string;
+    restartCount: number;
+    continueSignalsSent: number;
+    lastStageChangeTime: number;
+    diagnosticInfo?: DiagnosticInfo;
+    isLongOperation: boolean;
+    failureHistory: FailureRecord[];
+}
+/** Diagnostic information from doctor */
+export interface DiagnosticInfo {
+    timestamp: number;
+    agentHealthy: boolean;
+    authHealthy: boolean;
+    systemHealthy: boolean;
+    suggestedAction: string;
+    details: string;
+}
+/** Recovery action result */
+export interface RecoveryActionResult {
+    success: boolean;
+    action: string;
+    message: string;
+    shouldContinue: boolean;
+    nextStage?: RecoveryStage;
+    diagnostic?: DiagnosticInfo;
+}
+/** Record of a failure for POF */
+export interface FailureRecord {
+    timestamp: number;
+    stage: RecoveryStage;
+    action: string;
+    message: string;
+    idleTimeMs: number;
+    bytesReceived: number;
+    lastOutput: string;
+}
+/** POF (Post-mortem of Failure) entry */
+export interface POFEntry {
+    title: string;
+    runId: string;
+    failureTime: string;
+    detectedAt: string;
+    summary: string;
+    rootCause: {
+        type: string;
+        description: string;
+        symptoms: string[];
+    };
+    affectedLanes: Array<{
+        name: string;
+        status: string;
+        task: string;
+        taskIndex: number;
+        pid?: number;
+        reason: string;
+        recoveryAttempts: FailureRecord[];
+    }>;
+    possibleCauses: string[];
+    recovery: {
+        command: string;
+        description: string;
+        alternativeCommand?: string;
+        alternativeDescription?: string;
+    };
+    previousFailures?: POFEntry[];
+}
+/** Generate guidance message for git push failure */
+export declare function getGitPushFailureGuidance(): string;
+/** Generate guidance message for merge conflict */
+export declare function getMergeConflictGuidance(): string;
+/** Generate guidance message for general git error */
+export declare function getGitErrorGuidance(errorMessage: string): string;
+/**
+ * Manages recovery state for all lanes
+ */
+export declare class AutoRecoveryManager {
+    private config;
+    private laneStates;
+    private eventHandlers;
+    constructor(config?: Partial<AutoRecoveryConfig>);
+    /**
+     * Register a lane for recovery monitoring
+     */
+    registerLane(laneName: string): void;
+    /**
+     * Unregister a lane from recovery monitoring
+     */
+    unregisterLane(laneName: string): void;
+    /**
+     * Record activity for a lane
+     */
+    recordActivity(laneName: string, bytesReceived?: number, output?: string): void;
+    /**
+     * Get current recovery state for a lane
+     */
+    getState(laneName: string): LaneRecoveryState | undefined;
+    /**
+     * Check if a lane needs recovery intervention
+     */
+    needsIntervention(laneName: string): boolean;
+    /**
+     * Get the next recovery action for a lane
+     */
+    getRecoveryAction(laneName: string, laneRunDir: string, child?: ChildProcess): Promise<RecoveryActionResult>;
+    /**
+     * Send a continue signal to the lane
+     */
+    private sendContinueSignal;
+    /**
+     * Send a stronger prompt to nudge the agent
+     */
+    private sendStrongerPrompt;
+    /**
+     * Request process restart
+     */
+    private requestRestart;
+    /**
+     * Run diagnostic checks
+     */
+    private runDiagnosis;
+    /**
+     * Get failure history for a lane
+     */
+    getFailureHistory(laneName: string): FailureRecord[];
+    /**
+     * Get configuration
+     */
+    getConfig(): AutoRecoveryConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<AutoRecoveryConfig>): void;
+}
+/**
+ * Save a POF entry to the pof directory
+ */
+export declare function savePOF(runId: string, pofDir: string, entry: POFEntry): string;
+/**
+ * Create a POF entry from recovery state
+ */
+export declare function createPOFFromRecoveryState(runId: string, runDir: string, laneName: string, state: LaneRecoveryState, laneState: LaneState | null, diagnostic?: DiagnosticInfo): POFEntry;
+/**
+ * Load existing POF entries for a run
+ */
+export declare function loadPOF(pofDir: string, runId: string): POFEntry | null;
+/**
+ * List all POF files in a directory
+ */
+export declare function listPOFs(pofDir: string): string[];
+/**
+ * Get or create the default auto-recovery manager
+ */
+export declare function getAutoRecoveryManager(config?: Partial<AutoRecoveryConfig>): AutoRecoveryManager;
+/**
+ * Reset the default manager (for testing)
+ */
+export declare function resetAutoRecoveryManager(): void;