@litmers/cursorflow-orchestrator 0.1.2 → 0.1.5

package/dist/utils/state.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * State management utilities for CursorFlow
+ */
+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.saveState = saveState;
+exports.loadState = loadState;
+exports.appendLog = appendLog;
+exports.readLog = readLog;
+exports.createLaneState = createLaneState;
+exports.updateLaneState = updateLaneState;
+exports.createConversationEntry = createConversationEntry;
+exports.createGitLogEntry = createGitLogEntry;
+exports.createEventEntry = createEventEntry;
+exports.getLatestRunDir = getLatestRunDir;
+exports.listLanesInRun = listLanesInRun;
+exports.getLaneStateSummary = getLaneStateSummary;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Save state to JSON file
+ */
+function saveState(statePath, state) {
+    const stateDir = path.dirname(statePath);
+    if (!fs.existsSync(stateDir)) {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf8');
+}
+/**
+ * Load state from JSON file
+ */
+function loadState(statePath) {
+    if (!fs.existsSync(statePath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(statePath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.warn(`Warning: Failed to parse state file ${statePath}: ${error.message}`);
+        return null;
+    }
+}
+/**
+ * Append to JSONL log file
+ */
+function appendLog(logPath, entry) {
+    const logDir = path.dirname(logPath);
+    if (!fs.existsSync(logDir)) {
+        fs.mkdirSync(logDir, { recursive: true });
+    }
+    const line = JSON.stringify(entry) + '\n';
+    fs.appendFileSync(logPath, line, 'utf8');
+}
+/**
+ * Read JSONL log file
+ */
+function readLog(logPath) {
+    if (!fs.existsSync(logPath)) {
+        return [];
+    }
+    try {
+        const content = fs.readFileSync(logPath, 'utf8');
+        return content
+            .split('\n')
+            .filter(line => line.trim())
+            .map(line => JSON.parse(line));
+    }
+    catch (error) {
+        console.warn(`Warning: Failed to parse log file ${logPath}: ${error.message}`);
+        return [];
+    }
+}
+/**
+ * Create initial lane state
+ */
+function createLaneState(laneName, config) {
+    return {
+        label: laneName,
+        status: 'pending',
+        currentTaskIndex: 0,
+        totalTasks: config.tasks ? config.tasks.length : 0,
+        worktreeDir: null,
+        pipelineBranch: null,
+        startTime: Date.now(),
+        endTime: null,
+        error: null,
+        dependencyRequest: null,
+    };
+}
+/**
+ * Update lane state
+ */
+function updateLaneState(state, updates) {
+    return {
+        ...state,
+        ...updates,
+        updatedAt: Date.now(),
+    };
+}
+/**
+ * Create conversation log entry
+ */
+function createConversationEntry(role, text, options = {}) {
+    return {
+        timestamp: new Date().toISOString(),
+        role,
+        task: options.task || null,
+        fullText: text,
+        textLength: text.length,
+        model: options.model || null,
+    };
+}
+/**
+ * Create git operation log entry
+ */
+function createGitLogEntry(operation, details = {}) {
+    return {
+        timestamp: new Date().toISOString(),
+        operation,
+        ...details,
+    };
+}
+/**
+ * Create event log entry
+ */
+function createEventEntry(event, data = {}) {
+    return {
+        timestamp: new Date().toISOString(),
+        event,
+        ...data,
+    };
+}
+/**
+ * Get latest run directory
+ */
+function getLatestRunDir(logsDir) {
+    if (!fs.existsSync(logsDir)) {
+        return null;
+    }
+    const runs = fs.readdirSync(logsDir)
+        .filter(f => fs.statSync(path.join(logsDir, f)).isDirectory())
+        .sort()
+        .reverse();
+    if (runs.length === 0) {
+        return null;
+    }
+    return path.join(logsDir, runs[0]);
+}
+/**
+ * List all lanes in a run directory
+ */
+function listLanesInRun(runDir) {
+    if (!fs.existsSync(runDir)) {
+        return [];
+    }
+    return fs.readdirSync(runDir)
+        .filter(f => fs.statSync(path.join(runDir, f)).isDirectory())
+        .map(laneName => ({
+        name: laneName,
+        dir: path.join(runDir, laneName),
+        statePath: path.join(runDir, laneName, 'state.json'),
+    }));
+}
+/**
+ * Get lane state summary
+ */
+function getLaneStateSummary(statePath) {
+    const state = loadState(statePath);
+    if (!state) {
+        return { status: 'unknown', progress: '-' };
+    }
+    const progress = `${(state.currentTaskIndex || 0) + 1}/${state.totalTasks || '?'}`;
+    return {
+        status: state.status || 'unknown',
+        progress,
+        label: state.label,
+        error: state.error,
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/utils/state.js.map

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

package/dist/utils/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Shared type definitions for CursorFlow
+ */
+export interface LaneConfig {
+    devPort: number;
+    autoCreatePr: boolean;
+}
+export interface CursorFlowConfig {
+    tasksDir: string;
+    logsDir: string;
+    baseBranch: string;
+    branchPrefix: string;
+    executor: 'cursor-agent' | 'cloud';
+    pollInterval: number;
+    allowDependencyChange: boolean;
+    lockfileReadOnly: boolean;
+    enableReview: boolean;
+    reviewModel: string;
+    maxReviewIterations: number;
+    defaultLaneConfig: LaneConfig;
+    logLevel: string;
+    verboseGit: boolean;
+    worktreePrefix: string;
+    maxConcurrentLanes: number;
+    projectRoot: string;
+}
+export interface DependencyPolicy {
+    allowDependencyChange: boolean;
+    lockfileReadOnly: boolean;
+}
+export interface Task {
+    name: string;
+    prompt: string;
+    model?: string;
+}
+export interface RunnerConfig {
+    tasks: Task[];
+    pipelineBranch?: string;
+    branchPrefix?: string;
+    worktreeRoot?: string;
+    baseBranch?: string;
+    model?: string;
+    dependencyPolicy: DependencyPolicy;
+    reviewModel?: string;
+    maxReviewIterations?: number;
+    acceptanceCriteria?: string[];
+}
+export interface DependencyRequestPlan {
+    reason: string;
+    changes: string[];
+    commands: string[];
+    notes?: string;
+}
+export interface TaskExecutionResult {
+    taskName: string;
+    taskBranch: string;
+    status: 'FINISHED' | 'ERROR' | 'BLOCKED_DEPENDENCY';
+    error?: string;
+    dependencyRequest?: DependencyRequestPlan | null;
+}
+export interface AgentSendResult {
+    ok: boolean;
+    exitCode: number;
+    error?: string;
+    sessionId?: string;
+    resultText?: string;
+}
+export interface ReviewIssue {
+    severity: 'critical' | 'major' | 'minor';
+    description: string;
+    file?: string;
+    suggestion?: string;
+}
+export interface ReviewResult {
+    status: 'approved' | 'needs_changes';
+    buildSuccess: boolean;
+    issues: ReviewIssue[];
+    suggestions: string[];
+    summary: string;
+    raw: string;
+}
+export interface TaskResult {
+    taskName: string;
+    taskBranch: string;
+    [key: string]: any;
+}
+export interface LaneState {
+    label: string;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'paused' | 'waiting' | 'reviewing';
+    currentTaskIndex: number;
+    totalTasks: number;
+    worktreeDir: string | null;
+    pipelineBranch: string | null;
+    startTime: number;
+    endTime: number | null;
+    error: string | null;
+    dependencyRequest: DependencyRequestPlan | null;
+    updatedAt?: number;
+}
+export interface ConversationEntry {
+    timestamp: string;
+    role: 'user' | 'assistant' | 'reviewer' | 'system';
+    task: string | null;
+    fullText: string;
+    textLength: number;
+    model: string | null;
+}
+export interface GitLogEntry {
+    timestamp: string;
+    operation: string;
+    [key: string]: any;
+}
+export interface EventEntry {
+    timestamp: string;
+    event: string;
+    [key: string]: any;
+}

package/dist/utils/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Shared type definitions for CursorFlow
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/examples/README.md

@@ -0,0 +1,155 @@
+# CursorFlow Examples
+
+This directory contains example projects and configurations to help you get started with CursorFlow.
+
+## 📁 Available Examples
+
+### 1. Demo Project (`demo-project/`)
+
+A complete demonstration of CursorFlow's core features.
+
+**What it includes:**
+- 2 parallel tasks (create utils + add tests)
+- Real LLM execution with Claude 3.5 Sonnet
+- Complete documentation
+- Expected time: ~2-4 minutes
+
+**Best for:**
+- First-time users
+- Understanding the basics
+- Testing your setup
+
+**Quick start:**
+```bash
+# See demo-project/README.md for detailed instructions
+cd your-project
+cursorflow init
+cp -r path/to/cursorflow/examples/demo-project/_cursorflow/tasks/demo-test _cursorflow/tasks/
+cursorflow run _cursorflow/tasks/demo-test/
+```
+
+## 🎯 How to Use Examples
+
+### Option 1: Copy to Your Project
+
+1. Initialize CursorFlow in your project:
+   ```bash
+   cd your-project
+   cursorflow init
+   ```
+
+2. Copy example tasks:
+   ```bash
+   cp -r examples/demo-project/_cursorflow/tasks/demo-test _cursorflow/tasks/
+   ```
+
+3. Run the example:
+   ```bash
+   cursorflow run _cursorflow/tasks/demo-test/
+   ```
+
+### Option 2: Use as Reference
+
+Browse the example files to understand:
+- Task JSON structure
+- Prompt engineering best practices
+- Configuration options
+- Expected outcomes
+
+## 📚 Example Structure
+
+Each example includes:
+
+- **Task configurations** (`*.json`) - Defines what the AI will do
+- **README.md** - Detailed instructions and explanations
+- **Expected results** - What you should see after running
+
+## 🔍 What's in a Task File?
+
+```json
+{
+  "baseBranch": "main",
+  "branchPrefix": "cursorflow/demo-",
+  "executor": "cursor-agent",
+  "dependencyPolicy": {
+    "allowDependencyChange": false,
+    "lockfileReadOnly": true
+  },
+  "tasks": [
+    {
+      "name": "task-name",
+      "model": "claude-3.5-sonnet",
+      "prompt": "Detailed instructions for the AI..."
+    }
+  ]
+}
+```
+
+## 🚀 Prerequisites
+
+Before running examples:
+
+1. **Install CursorFlow**
+   ```bash
+   npm install -g @litmers/cursorflow-orchestrator
+   ```
+
+2. **Install cursor-agent**
+   ```bash
+   npm install -g @cursor/agent
+   ```
+
+3. **Authenticate Cursor**
+   - Open Cursor IDE
+   - Sign in to your account
+   - Verify AI features work
+
+4. **Check authentication** (optional)
+   ```bash
+   node test-auth.js
+   ```
+
+## 💡 Tips
+
+- **Start with demo-project** - It's the simplest example
+- **Monitor execution** - Use `cursorflow monitor --watch` to see real-time progress
+- **Check logs** - Inspect `_cursorflow/logs/` after execution
+- **Experiment** - Modify prompts to test different scenarios
+- **Clean up** - Remove worktrees and branches after testing
+
+## 📖 Learn More
+
+- **Main Documentation**: [README.md](../README.md)
+- **Configuration Guide**: Check `cursorflow.config.js` in your project
+- **Task Format**: See individual example task files
+- **Monitoring**: [Monitor Command](../commands/cursorflow-monitor.md)
+
+## 🐛 Troubleshooting
+
+If you encounter issues:
+
+1. Check prerequisites are installed
+2. Verify Cursor authentication
+3. Ensure you're in a Git repository
+4. Check you have at least one commit
+5. See example README for specific troubleshooting
+
+## 🤝 Contributing Examples
+
+Have a useful example? Contributions are welcome!
+
+Please include:
+- Complete task configurations
+- Detailed README
+- Expected results documentation
+- Troubleshooting tips
+
+## 📝 Notes
+
+- Examples use real LLM API calls
+- Small API usage will occur
+- Internet connection required
+- Make sure you have Cursor subscription active
+
+Happy learning! 🎉
+