@litmers/cursorflow-orchestrator 0.1.3 → 0.1.6

package/dist/utils/config.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Configuration loader for CursorFlow
+ *
+ * Finds project root and loads user configuration with defaults
+ */
+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.findProjectRoot = findProjectRoot;
+exports.loadConfig = loadConfig;
+exports.getTasksDir = getTasksDir;
+exports.getLogsDir = getLogsDir;
+exports.validateConfig = validateConfig;
+exports.createDefaultConfig = createDefaultConfig;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+/**
+ * Find project root by looking for package.json
+ */
+function findProjectRoot(cwd = process.cwd()) {
+    let current = cwd;
+    while (current !== path.parse(current).root) {
+        const packagePath = path.join(current, 'package.json');
+        if (fs.existsSync(packagePath)) {
+            return current;
+        }
+        current = path.dirname(current);
+    }
+    throw new Error('Cannot find project root with package.json');
+}
+/**
+ * Load configuration with defaults
+ */
+function loadConfig(projectRoot = null) {
+    if (!projectRoot) {
+        projectRoot = findProjectRoot();
+    }
+    const configPath = path.join(projectRoot, 'cursorflow.config.js');
+    // Default configuration
+    const defaults = {
+        // Directories
+        tasksDir: '_cursorflow/tasks',
+        logsDir: '_cursorflow/logs',
+        // Git
+        baseBranch: 'main',
+        branchPrefix: 'feature/',
+        // Execution
+        executor: 'cursor-agent',
+        pollInterval: 60,
+        // Dependencies
+        allowDependencyChange: false,
+        lockfileReadOnly: true,
+        // Review
+        enableReview: false,
+        reviewModel: 'sonnet-4.5-thinking',
+        maxReviewIterations: 3,
+        // Lane defaults
+        defaultLaneConfig: {
+            devPort: 3001,
+            autoCreatePr: false,
+        },
+        // Logging
+        logLevel: 'info',
+        verboseGit: false,
+        // Advanced
+        worktreePrefix: 'cursorflow-',
+        maxConcurrentLanes: 10,
+        // Internal
+        projectRoot,
+    };
+    // Try to load user config
+    if (fs.existsSync(configPath)) {
+        try {
+            const userConfig = require(configPath);
+            return { ...defaults, ...userConfig, projectRoot };
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to load config from ${configPath}: ${error.message}`);
+            console.warn('Using default configuration...');
+        }
+    }
+    return defaults;
+}
+/**
+ * Get absolute path for tasks directory
+ */
+function getTasksDir(config) {
+    return path.join(config.projectRoot, config.tasksDir);
+}
+/**
+ * Get absolute path for logs directory
+ */
+function getLogsDir(config) {
+    return path.join(config.projectRoot, config.logsDir);
+}
+/**
+ * Validate configuration
+ */
+function validateConfig(config) {
+    const errors = [];
+    if (!config.tasksDir) {
+        errors.push('tasksDir is required');
+    }
+    if (!config.logsDir) {
+        errors.push('logsDir is required');
+    }
+    if (!['cursor-agent', 'cloud'].includes(config.executor)) {
+        errors.push('executor must be "cursor-agent" or "cloud"');
+    }
+    if (config.pollInterval < 1) {
+        errors.push('pollInterval must be >= 1');
+    }
+    if (errors.length > 0) {
+        throw new Error(`Configuration validation failed:\n${errors.join('\n')}`);
+    }
+    return true;
+}
+/**
+ * Create default config file
+ */
+function createDefaultConfig(projectRoot, force = false) {
+    const configPath = path.join(projectRoot, 'cursorflow.config.js');
+    if (fs.existsSync(configPath) && !force) {
+        throw new Error(`Config file already exists: ${configPath}`);
+    }
+    const template = `module.exports = {
+  // Directory configuration
+  tasksDir: '_cursorflow/tasks',
+  logsDir: '_cursorflow/logs',
+  
+  // Git configuration
+  baseBranch: 'main',
+  branchPrefix: 'feature/',
+  
+  // Execution configuration
+  executor: 'cursor-agent',  // 'cursor-agent' | 'cloud'
+  pollInterval: 60,          // seconds
+  
+  // Dependency management
+  allowDependencyChange: false,
+  lockfileReadOnly: true,
+  
+  // Review configuration
+  enableReview: false,
+  reviewModel: 'sonnet-4.5-thinking',
+  maxReviewIterations: 3,
+  
+  // Lane configuration
+  defaultLaneConfig: {
+    devPort: 3001,           // 3000 + laneNumber
+    autoCreatePr: false,
+  },
+  
+  // Logging
+  logLevel: 'info',          // 'error' | 'warn' | 'info' | 'debug'
+  verboseGit: false,
+  
+  // Advanced
+  worktreePrefix: 'cursorflow-',
+  maxConcurrentLanes: 10,
+};
+`;
+    fs.writeFileSync(configPath, template, 'utf8');
+    return configPath;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/cursor-agent.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Cursor Agent CLI wrapper and utilities
+ */
+/**
+ * Check if cursor-agent CLI is installed
+ */
+export declare function checkCursorAgentInstalled(): boolean;
+/**
+ * Get cursor-agent version
+ */
+export declare function getCursorAgentVersion(): string | null;
+/**
+ * Ensure cursor-agent is installed, exit with error message if not
+ */
+export declare function ensureCursorAgent(): void;
+/**
+ * Print installation guide
+ */
+export declare function printInstallationGuide(): void;
+/**
+ * Check if CURSOR_API_KEY is set (for cloud execution)
+ */
+export declare function checkCursorApiKey(): boolean;
+/**
+ * Validate cursor-agent setup for given executor type
+ */
+export declare function validateSetup(executor?: string): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get available models (if cursor-agent supports it)
+ */
+export declare function getAvailableModels(): string[];
+/**
+ * Parse model names from cursor-agent output
+ */
+export declare function parseModelsFromOutput(output: string): string[];
+/**
+ * Test cursor-agent with a simple command
+ */
+export declare function testCursorAgent(): {
+    success: boolean;
+    output?: string;
+    error?: string;
+};
+export interface AuthCheckResult {
+    authenticated: boolean;
+    message: string;
+    details?: string;
+    help?: string;
+    error?: string;
+}
+/**
+ * Check cursor-agent authentication
+ */
+export declare function checkCursorAuth(): AuthCheckResult;
+/**
+ * Print authentication help
+ */
+export declare function printAuthHelp(): void;

package/dist/utils/cursor-agent.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * Cursor Agent CLI wrapper and utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkCursorAgentInstalled = checkCursorAgentInstalled;
+exports.getCursorAgentVersion = getCursorAgentVersion;
+exports.ensureCursorAgent = ensureCursorAgent;
+exports.printInstallationGuide = printInstallationGuide;
+exports.checkCursorApiKey = checkCursorApiKey;
+exports.validateSetup = validateSetup;
+exports.getAvailableModels = getAvailableModels;
+exports.parseModelsFromOutput = parseModelsFromOutput;
+exports.testCursorAgent = testCursorAgent;
+exports.checkCursorAuth = checkCursorAuth;
+exports.printAuthHelp = printAuthHelp;
+const child_process_1 = require("child_process");
+/**
+ * Check if cursor-agent CLI is installed
+ */
+function checkCursorAgentInstalled() {
+    try {
+        const result = (0, child_process_1.spawnSync)('cursor-agent', ['--version'], { stdio: 'pipe' });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get cursor-agent version
+ */
+function getCursorAgentVersion() {
+    try {
+        const result = (0, child_process_1.spawnSync)('cursor-agent', ['--version'], {
+            encoding: 'utf8',
+            stdio: 'pipe',
+        });
+        return result.status === 0 ? result.stdout.trim() : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Ensure cursor-agent is installed, exit with error message if not
+ */
+function ensureCursorAgent() {
+    if (!checkCursorAgentInstalled()) {
+        console.error(`
+❌ cursor-agent CLI is not installed
+
+Installation:
+  npm install -g @cursor/agent
+  # or
+  pnpm add -g @cursor/agent
+  # or
+  yarn global add @cursor/agent
+
+More info: https://docs.cursor.com/agent
+    `);
+        process.exit(1);
+    }
+}
+/**
+ * Print installation guide
+ */
+function printInstallationGuide() {
+    console.log(`
+📦 cursor-agent CLI Installation Guide
+
+The cursor-agent CLI is required to run CursorFlow orchestration.
+
+Installation methods:
+
+  npm install -g @cursor/agent
+  pnpm add -g @cursor/agent
+  yarn global add @cursor/agent
+
+Verification:
+
+  cursor-agent --version
+
+Documentation:
+
+  https://docs.cursor.com/agent
+
+After installation, run your command again.
+  `);
+}
+/**
+ * Check if CURSOR_API_KEY is set (for cloud execution)
+ */
+function checkCursorApiKey() {
+    return !!process.env['CURSOR_API_KEY'];
+}
+/**
+ * Validate cursor-agent setup for given executor type
+ */
+function validateSetup(executor = 'cursor-agent') {
+    const errors = [];
+    if (executor === 'cursor-agent') {
+        if (!checkCursorAgentInstalled()) {
+            errors.push('cursor-agent CLI is not installed');
+        }
+    }
+    if (executor === 'cloud') {
+        if (!checkCursorApiKey()) {
+            errors.push('CURSOR_API_KEY environment variable is not set');
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Get available models (if cursor-agent supports it)
+ */
+function getAvailableModels() {
+    try {
+        // This is a placeholder - actual implementation depends on cursor-agent API
+        // execSync('cursor-agent --model invalid "test"', {
+        //   encoding: 'utf8',
+        //   stdio: 'pipe',
+        // });
+        return [];
+    }
+    catch (error) {
+        // Parse from error message
+        const output = (error.stderr || error.stdout || '').toString();
+        // Extract model names from output
+        return parseModelsFromOutput(output);
+    }
+}
+/**
+ * Parse model names from cursor-agent output
+ */
+function parseModelsFromOutput(output) {
+    // This is a placeholder implementation
+    // Actual parsing depends on cursor-agent CLI output format
+    const models = [];
+    // Example parsing logic
+    const lines = output.split('\n');
+    for (const line of lines) {
+        if (line.includes('sonnet') || line.includes('opus') || line.includes('gpt')) {
+            const match = line.match(/['"]([^'"]+)['"]/);
+            if (match) {
+                models.push(match[1]);
+            }
+        }
+    }
+    return models;
+}
+/**
+ * Test cursor-agent with a simple command
+ */
+function testCursorAgent() {
+    try {
+        const result = (0, child_process_1.spawnSync)('cursor-agent', ['--help'], {
+            encoding: 'utf8',
+            stdio: 'pipe',
+        });
+        return {
+            success: result.status === 0,
+            output: result.stdout,
+            error: result.stderr,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * Check cursor-agent authentication
+ */
+function checkCursorAuth() {
+    try {
+        const result = (0, child_process_1.spawnSync)('cursor-agent', ['create-chat'], {
+            encoding: 'utf8',
+            stdio: 'pipe',
+            timeout: 10000, // 10 second timeout
+        });
+        if (result.status === 0 && result.stdout.trim()) {
+            return {
+                authenticated: true,
+                message: 'Cursor authentication OK',
+            };
+        }
+        const errorMsg = (result.stderr?.trim() || result.stdout?.trim() || '').toString();
+        // Check for authentication errors
+        if (errorMsg.includes('not authenticated') ||
+            errorMsg.includes('login') ||
+            errorMsg.includes('auth')) {
+            return {
+                authenticated: false,
+                message: 'Not authenticated with Cursor',
+                details: errorMsg,
+                help: 'Please open Cursor IDE and sign in to your account',
+            };
+        }
+        // Check for network errors
+        if (errorMsg.includes('network') ||
+            errorMsg.includes('connection') ||
+            errorMsg.includes('timeout')) {
+            return {
+                authenticated: false,
+                message: 'Network error',
+                details: errorMsg,
+                help: 'Check your internet connection',
+            };
+        }
+        return {
+            authenticated: false,
+            message: 'Unknown error',
+            details: errorMsg,
+        };
+    }
+    catch (error) {
+        if (error.code === 'ETIMEDOUT') {
+            return {
+                authenticated: false,
+                message: 'Connection timeout',
+                help: 'Check your internet connection',
+            };
+        }
+        return {
+            authenticated: false,
+            message: 'Failed to check authentication',
+            error: error.message,
+        };
+    }
+}
+/**
+ * Print authentication help
+ */
+function printAuthHelp() {
+    console.log(`
+🔐 Cursor Authentication Required
+
+CursorFlow requires an authenticated Cursor session to use AI features.
+
+Steps to authenticate:
+
+  1. Open Cursor IDE
+  2. Sign in to your Cursor account (if not already)
+  3. Verify AI features work in the IDE
+  4. Run your CursorFlow command again
+
+Common issues:
+
+  • Not signed in to Cursor
+  • Subscription expired or inactive
+  • Network connectivity issues
+  • VPN or firewall blocking Cursor API
+
+For more help, visit: https://docs.cursor.com
+  `);
+}
+//# sourceMappingURL=cursor-agent.js.map

package/dist/utils/cursor-agent.js.map

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

package/dist/utils/doctor.d.ts

@@ -0,0 +1,63 @@
+/**
+ * CursorFlow Doctor - environment and preflight checks
+ *
+ * This module provides actionable diagnostics for common run failures:
+ * - Not inside a Git work tree
+ * - Missing `origin` remote (required for pushing lane branches)
+ * - Missing Git worktree support
+ * - Missing base branch referenced by lane task files
+ * - Missing/invalid tasks directory
+ * - Missing Cursor Agent setup (optional)
+ */
+export type DoctorSeverity = 'error' | 'warn';
+export interface DoctorIssue {
+    /**
+     * Stable identifier for machines (NOCC) and tests.
+     */
+    id: string;
+    severity: DoctorSeverity;
+    title: string;
+    message: string;
+    /**
+     * Suggested commands or steps to fix the issue.
+     */
+    fixes?: string[];
+    /**
+     * Optional technical details (stderr, stdout, etc.)
+     */
+    details?: string;
+}
+export interface DoctorContext {
+    cwd: string;
+    repoRoot?: string;
+    tasksDir?: string;
+    executor?: string;
+}
+export interface DoctorReport {
+    ok: boolean;
+    issues: DoctorIssue[];
+    context: DoctorContext;
+}
+export interface DoctorOptions {
+    cwd?: string;
+    /**
+     * Optional tasks directory (used for `cursorflow run` preflight).
+     */
+    tasksDir?: string;
+    /**
+     * Executor type ('cursor-agent' | 'cloud' | ...).
+     */
+    executor?: string;
+    /**
+     * When true (default), include Cursor Agent install/auth checks.
+     */
+    includeCursorAgentChecks?: boolean;
+}
+/**
+ * Run doctor checks.
+ *
+ * If `tasksDir` is provided, additional preflight checks are performed:
+ * - tasks directory existence and JSON validity
+ * - baseBranch referenced by lanes exists locally
+ */
+export declare function runDoctor(options?: DoctorOptions): DoctorReport;