@litmers/cursorflow-orchestrator 0.1.5 → 0.1.6

package/dist/utils/doctor.js.map

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

package/dist/utils/types.d.ts

@@ -96,6 +96,7 @@ export interface LaneState {
     error: string | null;
     dependencyRequest: DependencyRequestPlan | null;
     updatedAt?: number;
+    tasksFile?: string;
 }
 export interface ConversationEntry {
     timestamp: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litmers/cursorflow-orchestrator",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Git worktree-based parallel AI agent orchestration system for Cursor",
   "main": "dist/cli/index.js",
   "bin": {

package/src/cli/doctor.ts

@@ -0,0 +1,127 @@
+/**
+ * CursorFlow doctor command
+ *
+ * Usage:
+ *   cursorflow doctor [options]
+ *
+ * Options:
+ *   --json                 Output machine-readable JSON
+ *   --tasks-dir <path>     Also validate lane files (run preflight)
+ *   --executor <type>      cursor-agent | cloud
+ *   --no-cursor            Skip Cursor Agent install/auth checks
+ *   --help, -h             Show help
+ */
+
+import * as logger from '../utils/logger';
+import { runDoctor } from '../utils/doctor';
+
+interface DoctorCliOptions {
+  json: boolean;
+  tasksDir: string | null;
+  executor: string | null;
+  includeCursorAgentChecks: boolean;
+}
+
+function printHelp(): void {
+  console.log(`
+Usage: cursorflow doctor [options]
+
+Verify your environment is ready for CursorFlow runs.
+
+Options:
+  --json                 Output machine-readable JSON
+  --tasks-dir <path>     Also validate lane files (run preflight)
+  --executor <type>      cursor-agent | cloud
+  --no-cursor            Skip Cursor Agent install/auth checks
+  --help, -h             Show help
+
+Examples:
+  cursorflow doctor
+  cursorflow doctor --tasks-dir _cursorflow/tasks/demo-test/
+  cursorflow doctor --json
+  `);
+}
+
+function parseArgs(args: string[]): DoctorCliOptions {
+  const tasksDirIdx = args.indexOf('--tasks-dir');
+  const executorIdx = args.indexOf('--executor');
+
+  const options: DoctorCliOptions = {
+    json: args.includes('--json'),
+    tasksDir: tasksDirIdx >= 0 ? (args[tasksDirIdx + 1] || null) : null,
+    executor: executorIdx >= 0 ? (args[executorIdx + 1] || null) : null,
+    includeCursorAgentChecks: !args.includes('--no-cursor'),
+  };
+
+  if (args.includes('--help') || args.includes('-h')) {
+    printHelp();
+    process.exit(0);
+  }
+
+  return options;
+}
+
+function printHumanReport(report: ReturnType<typeof runDoctor>): void {
+  logger.section('🩺 CursorFlow Doctor');
+  logger.info(`cwd: ${report.context.cwd}`);
+  if (report.context.repoRoot) logger.info(`repo: ${report.context.repoRoot}`);
+  if (report.context.tasksDir) logger.info(`tasks: ${report.context.tasksDir}`);
+
+  if (report.issues.length === 0) {
+    logger.success('All checks passed');
+    return;
+  }
+
+  for (const issue of report.issues) {
+    const header = `${issue.title} (${issue.id})`;
+    if (issue.severity === 'error') {
+      logger.error(header, '❌');
+    } else {
+      logger.warn(header, '⚠️');
+    }
+
+    console.log(`   ${issue.message}`);
+
+    if (issue.details) {
+      console.log(`   Details: ${issue.details}`);
+    }
+
+    if (issue.fixes && issue.fixes.length > 0) {
+      console.log('   Fix:');
+      for (const fix of issue.fixes) {
+        console.log(`     - ${fix}`);
+      }
+    }
+
+    console.log('');
+  }
+
+  if (report.ok) {
+    logger.success('Doctor completed with warnings');
+  } else {
+    logger.error('Doctor found blocking issues');
+  }
+}
+
+async function doctor(args: string[]): Promise<void> {
+  const options = parseArgs(args);
+
+  const report = runDoctor({
+    cwd: process.cwd(),
+    tasksDir: options.tasksDir || undefined,
+    executor: options.executor || undefined,
+    includeCursorAgentChecks: options.includeCursorAgentChecks,
+  });
+
+  if (options.json) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    printHumanReport(report);
+  }
+
+  process.exit(report.ok ? 0 : 1);
+}
+
+export = doctor;
+
+

package/src/cli/index.ts

@@ -14,6 +14,8 @@ const COMMANDS: Record<string, CommandFn> = {
   monitor: require('./monitor'),
   clean: require('./clean'),
   resume: require('./resume'),
+  doctor: require('./doctor'),
+  signal: require('./signal'),
 };
 
 function printHelp(): void {
@@ -28,6 +30,8 @@ Commands:
   monitor [run-dir] [options] Monitor lane execution
   clean <type> [options]      Clean branches/worktrees/logs
   resume <lane> [options]     Resume interrupted lane
+  doctor [options]            Check environment and preflight
+  signal <lane> <msg>         Directly intervene in a running lane
 
 Global Options:
   --config <path>             Config file path
@@ -39,6 +43,7 @@ Examples:
   cursorflow run _cursorflow/tasks/MyFeature/
   cursorflow monitor --watch
   cursorflow clean branches --all
+  cursorflow doctor
 
 Documentation:
   https://github.com/eungjin-cigro/cursorflow#readme

package/src/cli/resume.ts

@@ -1,37 +1,119 @@
 /**
- * CursorFlow resume command (stub)
+ * CursorFlow resume command
  */
 
+import * as path from 'path';
+import * as fs from 'fs';
+import { spawn } from 'child_process';
 import * as logger from '../utils/logger';
+import { loadConfig, getLogsDir } from '../utils/config';
+import { loadState } from '../utils/state';
+import { LaneState } from '../utils/types';
 
 interface ResumeOptions {
-  lane?: string;
+  lane: string | null;
   runDir: string | null;
   clean: boolean;
   restart: boolean;
 }
 
 function parseArgs(args: string[]): ResumeOptions {
+  const runDirIdx = args.indexOf('--run-dir');
+  
   return {
-    lane: args[0],
-    runDir: null,
+    lane: args.find(a => !a.startsWith('--')) || null,
+    runDir: runDirIdx >= 0 ? args[runDirIdx + 1] || null : null,
     clean: args.includes('--clean'),
     restart: args.includes('--restart'),
   };
 }
 
-async function resume(args: string[]): Promise<void> {
-  logger.section('🔁 Resuming Lane');
+/**
+ * Find the latest run directory
+ */
+function findLatestRunDir(logsDir: string): string | null {
+  const runsDir = path.join(logsDir, 'runs');
+  if (!fs.existsSync(runsDir)) return null;
   
+  const runs = fs.readdirSync(runsDir)
+    .filter(d => d.startsWith('run-'))
+    .sort()
+    .reverse();
+    
+  return runs.length > 0 ? path.join(runsDir, runs[0]!) : null;
+}
+
+async function resume(args: string[]): Promise<void> {
   const options = parseArgs(args);
+  const config = loadConfig();
+  const logsDir = getLogsDir(config);
+  
+  if (!options.lane) {
+    throw new Error('Lane name required (e.g., cursorflow resume lane-1)');
+  }
+  
+  let runDir = options.runDir;
+  if (!runDir) {
+    runDir = findLatestRunDir(logsDir);
+  }
+  
+  if (!runDir || !fs.existsSync(runDir)) {
+    throw new Error(`Run directory not found: ${runDir || 'latest'}`);
+  }
+  
+  const laneDir = path.join(runDir, 'lanes', options.lane);
+  const statePath = path.join(laneDir, 'state.json');
+  
+  if (!fs.existsSync(statePath)) {
+    throw new Error(`Lane state not found at ${statePath}. Is the lane name correct?`);
+  }
+  
+  const state = loadState<LaneState>(statePath);
+  if (!state) {
+    throw new Error(`Failed to load state from ${statePath}`);
+  }
+  
+  if (!state.tasksFile || !fs.existsSync(state.tasksFile)) {
+    throw new Error(`Original tasks file not found: ${state.tasksFile}. Resume impossible without task definition.`);
+  }
+  
+  logger.section(`🔁 Resuming Lane: ${options.lane}`);
+  logger.info(`Run: ${path.basename(runDir)}`);
+  logger.info(`Tasks: ${state.tasksFile}`);
+  logger.info(`Starting from task index: ${options.restart ? 0 : state.currentTaskIndex}`);
+  
+  const runnerPath = require.resolve('../core/runner');
+  const runnerArgs = [
+    runnerPath,
+    state.tasksFile,
+    '--run-dir', laneDir,
+    '--start-index', options.restart ? '0' : String(state.currentTaskIndex),
+  ];
+  
+  logger.info(`Spawning runner process...`);
   
-  logger.info('This command will be fully implemented in the next phase');
-  logger.info(`Lane: ${options.lane}`);
-  logger.info(`Clean: ${options.clean}`);
-  logger.info(`Restart: ${options.restart}`);
+  const child = spawn('node', runnerArgs, {
+    stdio: 'inherit',
+    env: process.env,
+  });
   
-  logger.warn('\n⚠️  Implementation pending');
-  logger.info('This will resume interrupted lanes');
+  return new Promise((resolve, reject) => {
+    child.on('exit', (code) => {
+      if (code === 0) {
+        logger.success(`Lane ${options.lane} completed successfully`);
+        resolve();
+      } else if (code === 2) {
+        logger.warn(`Lane ${options.lane} blocked on dependency change`);
+        resolve();
+      } else {
+        reject(new Error(`Lane ${options.lane} failed with exit code ${code}`));
+      }
+    });
+    
+    child.on('error', (error) => {
+      reject(new Error(`Failed to start runner: ${error.message}`));
+    });
+  });
 }
 
 export = resume;

package/src/cli/run.ts

@@ -6,12 +6,15 @@ import * as path from 'path';
 import * as fs from 'fs';
 import * as logger from '../utils/logger';
 import { orchestrate } from '../core/orchestrator';
-import { loadConfig } from '../utils/config';
+import { getLogsDir, loadConfig } from '../utils/config';
+import { runDoctor } from '../utils/doctor';
+import { areCommandsInstalled, setupCommands } from './setup-commands';
 
 interface RunOptions {
   tasksDir?: string;
   dryRun: boolean;
   executor: string | null;
+  skipDoctor: boolean;
 }
 
 function parseArgs(args: string[]): RunOptions {
@@ -22,28 +25,80 @@ function parseArgs(args: string[]): RunOptions {
     tasksDir,
     dryRun: args.includes('--dry-run'),
     executor: executorIdx >= 0 ? args[executorIdx + 1] || null : null,
+    skipDoctor: args.includes('--skip-doctor') || args.includes('--no-doctor'),
   };
 }
 
 async function run(args: string[]): Promise<void> {
   const options = parseArgs(args);
   
+  // Auto-setup Cursor commands if missing or outdated
+  if (!areCommandsInstalled()) {
+    logger.info('Installing missing or outdated Cursor IDE commands...');
+    try {
+      setupCommands({ silent: true });
+    } catch (e) {
+      // Non-blocking
+    }
+  }
+
   if (!options.tasksDir) {
     console.log('\nUsage: cursorflow run <tasks-dir> [options]');
     throw new Error('Tasks directory required');
   }
   
-  if (!fs.existsSync(options.tasksDir)) {
-    throw new Error(`Tasks directory not found: ${options.tasksDir}`);
-  }
-  
   const config = loadConfig();
+  const logsDir = getLogsDir(config);
+
+  // Resolve tasks dir:
+  // - Prefer the exact path if it exists relative to cwd
+  // - Otherwise, fall back to projectRoot-relative path for better ergonomics
+  const tasksDir =
+    path.isAbsolute(options.tasksDir)
+      ? options.tasksDir
+      : (fs.existsSync(options.tasksDir)
+        ? path.resolve(process.cwd(), options.tasksDir)
+        : path.join(config.projectRoot, options.tasksDir));
+
+  if (!fs.existsSync(tasksDir)) {
+    throw new Error(`Tasks directory not found: ${tasksDir}`);
+  }
+
+  // Preflight checks (doctor)
+  if (!options.skipDoctor) {
+    const report = runDoctor({
+      cwd: process.cwd(),
+      tasksDir,
+      executor: options.executor || config.executor,
+      includeCursorAgentChecks: true,
+    });
+
+    if (!report.ok) {
+      logger.section('🛑 Pre-flight check failed');
+      for (const issue of report.issues) {
+        const header = `${issue.title} (${issue.id})`;
+        if (issue.severity === 'error') {
+          logger.error(header, '❌');
+        } else {
+          logger.warn(header, '⚠️');
+        }
+        console.log(`   ${issue.message}`);
+        if (issue.details) console.log(`   Details: ${issue.details}`);
+        if (issue.fixes?.length) {
+          console.log('   Fix:');
+          for (const fix of issue.fixes) console.log(`     - ${fix}`);
+        }
+        console.log('');
+      }
+      throw new Error('Pre-flight checks failed. Run `cursorflow doctor` for details.');
+    }
+  }
   
   try {
-    await orchestrate(options.tasksDir, {
+    await orchestrate(tasksDir, {
       executor: options.executor || config.executor,
       pollInterval: config.pollInterval * 1000,
-      runDir: path.join(config.logsDir, 'runs', `run-${Date.now()}`),
+      runDir: path.join(logsDir, 'runs', `run-${Date.now()}`),
     });
   } catch (error: any) {
     // Re-throw to be handled by the main entry point

package/src/cli/setup-commands.ts

@@ -183,6 +183,25 @@ export function uninstallCommands(options: SetupOptions = {}): { removed: number
   return { removed };
 }
 
+/**
+ * Check if commands are already installed
+ */
+export function areCommandsInstalled(): boolean {
+  const projectRoot = findProjectRoot();
+  const targetDir = path.join(projectRoot, '.cursor', 'commands', 'cursorflow');
+  const sourceDir = getCommandsSourceDir();
+  
+  if (!fs.existsSync(targetDir) || !fs.existsSync(sourceDir)) {
+    return false;
+  }
+  
+  const sourceFiles = fs.readdirSync(sourceDir).filter(f => f.endsWith('.md'));
+  const targetFiles = fs.readdirSync(targetDir).filter(f => f.endsWith('.md'));
+  
+  // Basic check: do we have all the files from source in target?
+  return sourceFiles.every(f => targetFiles.includes(f));
+}
+
 async function main(args: string[]): Promise<any> {
   const options = parseArgs(args);
   

package/src/cli/signal.ts

@@ -0,0 +1,89 @@
+/**
+ * CursorFlow signal command
+ * 
+ * Send a direct message to a running lane
+ */
+
+import * as path from 'path';
+import * as fs from 'fs';
+import * as logger from '../utils/logger';
+import { loadConfig, getLogsDir } from '../utils/config';
+import { appendLog, createConversationEntry } from '../utils/state';
+
+interface SignalOptions {
+  lane: string | null;
+  message: string | null;
+  runDir: string | null;
+}
+
+function parseArgs(args: string[]): SignalOptions {
+  const runDirIdx = args.indexOf('--run-dir');
+  
+  // First non-option is lane, second (or rest joined) is message
+  const nonOptions = args.filter(a => !a.startsWith('--'));
+  
+  return {
+    lane: nonOptions[0] || null,
+    message: nonOptions.slice(1).join(' ') || null,
+    runDir: runDirIdx >= 0 ? args[runDirIdx + 1] || null : null,
+  };
+}
+
+function findLatestRunDir(logsDir: string): string | null {
+  const runsDir = path.join(logsDir, 'runs');
+  if (!fs.existsSync(runsDir)) return null;
+  
+  const runs = fs.readdirSync(runsDir)
+    .filter(d => d.startsWith('run-'))
+    .sort()
+    .reverse();
+    
+  return runs.length > 0 ? path.join(runsDir, runs[0]!) : null;
+}
+
+async function signal(args: string[]): Promise<void> {
+  const options = parseArgs(args);
+  const config = loadConfig();
+  const logsDir = getLogsDir(config);
+  
+  if (!options.lane) {
+    throw new Error('Lane name required: cursorflow signal <lane> "<message>"');
+  }
+  
+  if (!options.message) {
+    throw new Error('Message required: cursorflow signal <lane> "<message>"');
+  }
+  
+  let runDir = options.runDir;
+  if (!runDir) {
+    runDir = findLatestRunDir(logsDir);
+  }
+  
+  if (!runDir || !fs.existsSync(runDir)) {
+    throw new Error(`Run directory not found: ${runDir || 'latest'}`);
+  }
+  
+  const convoPath = path.join(runDir, 'lanes', options.lane, 'conversation.jsonl');
+  
+  if (!fs.existsSync(convoPath)) {
+    throw new Error(`Conversation log not found at ${convoPath}. Is the lane running?`);
+  }
+  
+  logger.info(`Sending signal to lane: ${options.lane}`);
+  logger.info(`Message: "${options.message}"`);
+  
+  // Append as a "commander" role message
+  // Note: We cast to 'system' or similar if 'commander' isn't in the enum, 
+  // but let's use 'reviewer' or 'system' which agents usually respect, 
+  // or update the type definition.
+  const entry = createConversationEntry('system', `[COMMANDER INTERVENTION]\n${options.message}`, {
+    task: 'DIRECT_SIGNAL'
+  });
+  
+  appendLog(convoPath, entry);
+  
+  logger.success('Signal sent successfully. The agent will see this message in its next turn or via file monitoring.');
+}
+
+export = signal;
+