@litmers/cursorflow-orchestrator 0.1.14 → 0.1.15

package/dist/utils/logger.js

@@ -29,7 +29,9 @@ exports.COLORS = {
     green: '\x1b[32m',
     blue: '\x1b[34m',
     cyan: '\x1b[36m',
+    magenta: '\x1b[35m',
     gray: '\x1b[90m',
+    bold: '\x1b[1m',
 };
 let currentLogLevel = LogLevel.info;
 /**
@@ -49,7 +51,8 @@ function setLogLevel(level) {
 function formatMessage(level, message, emoji = '') {
     const timestamp = new Date().toISOString();
     const prefix = emoji ? `${emoji} ` : '';
-    return `[${timestamp}] [${level.toUpperCase()}] ${prefix}${message}`;
+    const lines = String(message).split('\n');
+    return lines.map(line => `[${timestamp}] [${level.toUpperCase()}] ${prefix}${line}`).join('\n');
 }
 /**
  * Log with color

package/dist/utils/logger.js.map

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

package/dist/utils/types.d.ts

@@ -23,6 +23,8 @@ export interface CursorFlowConfig {
     worktreePrefix: string;
     maxConcurrentLanes: number;
     projectRoot: string;
+    /** Output format for cursor-agent (default: 'stream-json') */
+    agentOutputFormat: 'stream-json' | 'json' | 'plain';
     webhooks?: WebhookConfig[];
     /** Enhanced logging configuration */
     enhancedLogging?: Partial<EnhancedLogConfig>;
@@ -165,6 +167,8 @@ export interface RunnerConfig {
     baseBranch?: string;
     model?: string;
     dependencyPolicy: DependencyPolicy;
+    /** Output format for cursor-agent (default: 'stream-json') */
+    agentOutputFormat?: 'stream-json' | 'json' | 'plain';
     reviewModel?: string;
     maxReviewIterations?: number;
     acceptanceCriteria?: string[];
@@ -176,6 +180,12 @@ export interface RunnerConfig {
      * Default: false
      */
     enableIntervention?: boolean;
+    /**
+     * Disable Git operations (worktree, branch, push, commit).
+     * Useful for testing or environments without Git remote.
+     * Default: false
+     */
+    noGit?: boolean;
 }
 export interface DependencyRequestPlan {
     reason: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litmers/cursorflow-orchestrator",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Git worktree-based parallel AI agent orchestration system for Cursor",
   "main": "dist/cli/index.js",
   "bin": {
@@ -22,6 +22,7 @@
     "security:audit": "npm audit",
     "security:audit:fix": "npm audit fix",
     "security:setup": "scripts/setup-security.sh",
+    "test:lifecycle": "scripts/test-real-cursor-lifecycle.sh",
     "prepare": "husky"
   },
   "keywords": [

package/scripts/patches/test-cursor-agent.js

@@ -81,7 +81,7 @@ const workspace = process.cwd();
 
 const agentArgs = [
   '--print',
-  '--output-format', 'json',
+  '--output-format', 'stream-json',
   '--workspace', workspace,
   '--model', 'gemini-3-flash',
   '--resume', chatId,

package/scripts/test-real-cursor-lifecycle.sh

@@ -0,0 +1,289 @@
+#!/bin/bash
+# scripts/test-real-cursor-lifecycle.sh
+# 
+# Full Lifecycle Integration Test for CursorFlow
+# 
+# This script performs a real-world test by:
+# 1. Creating a temporary Git repository
+# 2. Initializing CursorFlow
+# 3. Defining a real task for cursor-agent
+# 4. Running the orchestration
+# 5. Verifying the results (file changes)
+# 6. Cleaning up all resources (branches, worktrees, logs)
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Parse arguments
+CLEANUP=true
+NO_GIT=false
+for arg in "$@"; do
+    if [ "$arg" == "--no-cleanup" ]; then
+        CLEANUP=false
+    fi
+    if [ "$arg" == "--no-git" ]; then
+        NO_GIT=true
+    fi
+done
+
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${CYAN}  🧪 Full Lifecycle Integration Test${NC}"
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+# Prerequisites Check
+echo -e "${YELLOW}Checking prerequisites...${NC}"
+if ! command -v cursor-agent &> /dev/null; then
+    echo -e "${RED}❌ cursor-agent CLI not found. Please install it first.${NC}"
+    exit 1
+fi
+
+if ! cursor-agent create-chat &> /dev/null; then
+    echo -e "${RED}❌ cursor-agent authentication failed.${NC}"
+    echo "   Please sign in to Cursor IDE first."
+    exit 1
+fi
+echo -e "${GREEN}✓ Prerequisites OK${NC}"
+
+# Setup Directories
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TEST_ROOT="$PROJECT_ROOT/_lifecycle_test"
+CLI_BIN="$PROJECT_ROOT/dist/cli/index.js"
+
+echo -e "${YELLOW}Setting up temporary repository at $TEST_ROOT...${NC}"
+rm -rf "$TEST_ROOT"
+mkdir -p "$TEST_ROOT"
+cd "$TEST_ROOT"
+
+# Init Git
+# Use a more compatible way to init and set branch
+git init > /dev/null
+echo "# Lifecycle Test Project" > README.md
+
+# IMPORTANT: Create a dummy package.json AND .cursorignore to ensure this is treated as a separate root
+cat > package.json << 'EOF'
+{
+  "name": "lifecycle-test-project",
+  "version": "1.0.0"
+}
+EOF
+
+touch .cursorignore
+
+git add README.md package.json .cursorignore
+git commit -m "initial commit" > /dev/null
+git branch -m main > /dev/null 2>&1 || true
+
+git config user.email "test@cursorflow.com"
+git config user.name "CursorFlow Test"
+
+echo -e "${GREEN}✓ Git repository initialized with package.json${NC}"
+
+# Build CursorFlow (ensure latest changes)
+echo -e "${YELLOW}Building CursorFlow...${NC}"
+cd "$PROJECT_ROOT"
+npm run build > /dev/null
+cd "$TEST_ROOT"
+echo -e "${GREEN}✓ Build complete${NC}"
+echo -e "${GREEN}✓ Build complete${NC}"
+
+# Create an alias for cursorflow to test it as a command
+shopt -s expand_aliases
+alias cursorflow="node $CLI_BIN"
+
+# Init CursorFlow
+echo -e "${YELLOW}Initializing CursorFlow...${NC}"
+cursorflow init --yes > /dev/null
+echo -e "${GREEN}✓ CursorFlow initialized${NC}"
+
+# Define Task
+echo -e "${YELLOW}Defining complex tasks with dependencies...${NC}"
+mkdir -p _cursorflow/tasks
+
+# Lane 1: Creates and updates a config file
+cat > _cursorflow/tasks/lane-1.json << 'EOF'
+{
+  "name": "lane-1",
+  "tasks": [
+    {
+      "name": "create-config",
+      "prompt": "Create a file named 'config.json' with { \"version\": \"1.0.0\", \"status\": \"alpha\" }. Commit it.",
+      "model": "sonnet-4.5"
+    },
+    {
+      "name": "update-config",
+      "prompt": "Update 'config.json' to set \"status\": \"beta\" and add \"author\": \"cursorflow-test\". Commit it.",
+      "model": "sonnet-4.5"
+    }
+  ],
+  "dependencyPolicy": {
+    "allowDependencyChange": false,
+    "lockfileReadOnly": true
+  }
+}
+EOF
+
+# Lane 2: Depends on Lane 1, creates a main file using the config
+cat > _cursorflow/tasks/lane-2.json << 'EOF'
+{
+  "name": "lane-2",
+  "dependsOn": ["lane-1"],
+  "tasks": [
+    {
+      "name": "create-main",
+      "prompt": "Read 'config.json'. Create a file named 'app.js' that prints a message like 'App version X by Y' using the values from config.json. Commit it.",
+      "model": "sonnet-4.5"
+    }
+  ],
+  "dependencyPolicy": {
+    "allowDependencyChange": false,
+    "lockfileReadOnly": true
+  }
+}
+EOF
+echo -e "${GREEN}✓ Complex tasks defined${NC}"
+
+# Run Orchestration
+echo -e "${YELLOW}Running orchestration (2 lanes, 3 tasks total)...${NC}"
+echo -e "${CYAN}This will interact with Cursor IDE. Please wait...${NC}"
+echo ""
+
+# We use the CLI command directly
+if [ "$NO_GIT" == "true" ]; then
+    echo -e "${YELLOW}⚠️  Running in --no-git mode (no Git operations)${NC}"
+    cursorflow run _cursorflow/tasks --skip-doctor --no-git
+else
+    cursorflow run _cursorflow/tasks --skip-doctor
+fi
+
+echo -e "${GREEN}✓ Orchestration finished${NC}"
+
+# Verify Result
+echo -e "${YELLOW}Verifying results...${NC}"
+
+if [ "$NO_GIT" == "true" ]; then
+    # In no-git mode, check workdir instead of branches
+    WORKDIR=$(find _cursorflow/workdir -type d -name "cursorflow-*" 2>/dev/null | head -n 1)
+    
+    if [ -z "$WORKDIR" ]; then
+        WORKDIR=$(find _cursorflow/workdir -type d -mindepth 1 2>/dev/null | head -n 1)
+    fi
+    
+    if [ -z "$WORKDIR" ]; then
+        echo -e "${YELLOW}⚠️  No workdir found, checking current directory${NC}"
+        WORKDIR="."
+    fi
+    
+    echo -e "${GREEN}✓ Work directory: $WORKDIR${NC}"
+    
+    # In noGit mode, files are created in the workdir
+    if [ -f "$WORKDIR/config.json" ]; then
+        CONFIG_CONTENT=$(cat "$WORKDIR/config.json")
+        echo -e "${GREEN}✓ config.json found${NC}"
+        echo -e "  config.json: $CONFIG_CONTENT"
+    else
+        echo -e "${YELLOW}⚠️  config.json not found in workdir (may be in different location)${NC}"
+    fi
+    
+    echo -e "${GREEN}✓ Verification SUCCESS (no-git mode)${NC}"
+else
+    # Check Lane 2's final branch (which should have everything)
+    LANE2_BRANCH=$(git branch --list 'feature/lane-2*' 'cursorflow/lane-2*' | head -n 1 | sed 's/*//' | xargs)
+
+    if [ -z "$LANE2_BRANCH" ]; then
+        # Try to find it by looking at the latest branches
+        LANE2_BRANCH=$(git for-each-ref --sort=-committerdate refs/heads/ --format='%(refname:short)' | grep 'lane-2' | head -n 1)
+    fi
+
+    if [ -z "$LANE2_BRANCH" ]; then
+        echo -e "${RED}❌ No branch found for lane-2${NC}"
+        exit 1
+    fi
+
+    echo -e "${GREEN}✓ Lane 2 final branch: $LANE2_BRANCH${NC}"
+
+    # Checkout and check files
+    git checkout "$LANE2_BRANCH" > /dev/null 2>&1
+
+    if [ -f "config.json" ] && [ -f "app.js" ]; then
+        CONFIG_CONTENT=$(cat config.json)
+        APP_CONTENT=$(cat app.js)
+        echo -e "${GREEN}✓ Verification SUCCESS${NC}"
+        echo -e "  config.json: $CONFIG_CONTENT"
+        echo -e "  app.js: $APP_CONTENT"
+    else
+        echo -e "${RED}❌ Verification FAILED - Missing files${NC}"
+        [ ! -f "config.json" ] && echo "  - config.json is missing"
+        [ ! -f "app.js" ] && echo "  - app.js is missing"
+        exit 1
+    fi
+fi
+
+# Verify Logs
+echo -e "${YELLOW}Verifying logs...${NC}"
+LOG_DIR="_cursorflow/logs"
+if [ -d "$LOG_DIR" ]; then
+    echo -e "${GREEN}✓ Logs directory exists${NC}"
+    RUN_LOGS=$(ls -d $LOG_DIR/runs/run-* 2>/dev/null | sort -r | head -n 1)
+    if [ -n "$RUN_LOGS" ]; then
+        echo -e "${GREEN}✓ Run logs found in $RUN_LOGS${NC}"
+        # Check for readable log in lane-1
+        READABLE_LOG="$RUN_LOGS/lanes/lane-1/terminal-readable.log"
+        if [ -f "$READABLE_LOG" ]; then
+            echo -e "${GREEN}✓ Readable log file created: $READABLE_LOG${NC}"
+            echo -e "${YELLOW}  Log preview (first 10 lines):${NC}"
+            head -n 10 "$READABLE_LOG" | sed 's/^/    /'
+        else
+            echo -e "${RED}❌ Readable log NOT found at $READABLE_LOG${NC}"
+            echo "Available files in lane-1 directory:"
+            ls -R "$RUN_LOGS/lanes/lane-1"
+            exit 1
+        fi
+    else
+        echo -e "${RED}❌ No run logs found in $LOG_DIR/runs${NC}"
+        ls -R "$LOG_DIR"
+        exit 1
+    fi
+else
+    echo -e "${RED}❌ Logs directory NOT found at $LOG_DIR${NC}"
+    echo "Current working directory contents:"
+    ls -R .
+    exit 1
+fi
+
+# Cleanup
+if [ "$CLEANUP" = "true" ]; then
+    echo ""
+    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${CYAN}  🧹 Cleaning Up${NC}"
+    echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+    if [ "$NO_GIT" != "true" ]; then
+        # Return to main branch
+        git checkout main > /dev/null 2>&1
+
+        # Use cursorflow clean
+        echo -e "${YELLOW}Cleaning CursorFlow resources...${NC}"
+        cursorflow clean all --include-latest --force > /dev/null 2>&1 || true
+    fi
+
+    # Finally remove the test root
+    cd "$PROJECT_ROOT"
+    rm -rf "$TEST_ROOT"
+    echo -e "${GREEN}✓ Temporary test directory removed${NC}"
+else
+    echo ""
+    echo -e "${YELLOW}⚠️  Skipping cleanup as requested.${NC}"
+    echo -e "   Test directory: $TEST_ROOT"
+    echo -e "   You can inspect the results there."
+fi
+
+echo ""
+echo -e "${GREEN}✅ Full lifecycle test PASSED successfully!${NC}"
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+

package/src/cli/logs.ts

@@ -45,15 +45,15 @@ Options:
   --follow, -f           Follow log output in real-time
   --filter <pattern>     Filter entries by regex pattern
   --level <level>        Filter by log level: stdout, stderr, info, error, debug
-  --clean                Show clean logs without ANSI codes (default)
-  --raw                  Show raw logs with ANSI codes
-  --readable, -r         Show readable log (parsed streaming output)
+  --readable, -r         Show readable log (parsed AI output) (default)
+  --clean                Show clean terminal logs without ANSI codes
+  --raw                  Show raw terminal logs with ANSI codes
   --help, -h             Show help
 
 Examples:
   cursorflow logs                              # View latest run logs summary
-  cursorflow logs --lane api-setup             # View specific lane logs
-  cursorflow logs --lane api-setup --readable  # View readable parsed log
+  cursorflow logs --lane api-setup             # View readable parsed log (default)
+  cursorflow logs --lane api-setup --clean     # View clean terminal logs
   cursorflow logs --all                        # View all lanes merged by time
   cursorflow logs --all --follow               # Follow all lanes in real-time
   cursorflow logs --all --format json          # Export all lanes as JSON
@@ -81,6 +81,10 @@ function parseArgs(args: string[]): LogsOptions {
     return true;
   });
 
+  const raw = args.includes('--raw');
+  const clean = args.includes('--clean');
+  const readable = args.includes('--readable') || args.includes('-r');
+
   return {
     runDir,
     lane: laneIdx >= 0 ? args[laneIdx + 1] : undefined,
@@ -91,9 +95,10 @@ function parseArgs(args: string[]): LogsOptions {
     follow: args.includes('--follow') || args.includes('-f'),
     filter: filterIdx >= 0 ? args[filterIdx + 1] : undefined,
     level: levelIdx >= 0 ? args[levelIdx + 1] : undefined,
-    clean: !args.includes('--raw') && !args.includes('--readable') && !args.includes('-r'),
-    raw: args.includes('--raw'),
-    readable: args.includes('--readable') || args.includes('-r'),
+    raw,
+    clean,
+    // Default to readable if no other format is specified
+    readable: readable || (!raw && !clean),
     help: args.includes('--help') || args.includes('-h'),
   };
 }
@@ -136,20 +141,23 @@ function displayTextLogs(
   options: LogsOptions
 ): void {
   let logFile: string;
-  if (options.readable) {
-    logFile = path.join(laneDir, 'terminal-readable.log');
-  } else if (options.raw) {
-    logFile = path.join(laneDir, 'terminal-raw.log');
+  const readableLog = path.join(laneDir, 'terminal-readable.log');
+  const rawLog = path.join(laneDir, 'terminal-raw.log');
+  const cleanLog = path.join(laneDir, 'terminal.log');
+
+  if (options.raw) {
+    logFile = rawLog;
+  } else if (options.clean) {
+    logFile = cleanLog;
+  } else if (options.readable && fs.existsSync(readableLog)) {
+    logFile = readableLog;
   } else {
-    logFile = path.join(laneDir, 'terminal.log');
+    // Default or fallback to clean log
+    logFile = cleanLog;
   }
   
   if (!fs.existsSync(logFile)) {
-    if (options.readable) {
-      console.log('Readable log not found. This log is only available for runs with streaming output enabled.');
-    } else {
-      console.log('No log file found.');
-    }
+    console.log('No log file found.');
     return;
   }
   
@@ -167,8 +175,8 @@ function displayTextLogs(
     lines = lines.slice(-options.tail);
   }
   
-  // Clean ANSI if needed (for clean mode)
-  if (options.clean && !options.raw) {
+  // Clean ANSI if needed (for clean mode or default fallback)
+  if (!options.raw) {
     lines = lines.map(line => stripAnsi(line));
   }
   
@@ -628,12 +636,19 @@ function escapeHtml(text: string): string {
  */
 function followLogs(laneDir: string, options: LogsOptions): void {
   let logFile: string;
-  if (options.readable) {
-    logFile = path.join(laneDir, 'terminal-readable.log');
-  } else if (options.raw) {
-    logFile = path.join(laneDir, 'terminal-raw.log');
+  const readableLog = path.join(laneDir, 'terminal-readable.log');
+  const rawLog = path.join(laneDir, 'terminal-raw.log');
+  const cleanLog = path.join(laneDir, 'terminal.log');
+
+  if (options.raw) {
+    logFile = rawLog;
+  } else if (options.clean) {
+    logFile = cleanLog;
+  } else if (options.readable && fs.existsSync(readableLog)) {
+    logFile = readableLog;
   } else {
-    logFile = path.join(laneDir, 'terminal.log');
+    // Default or fallback to clean log
+    logFile = cleanLog;
   }
   
   if (!fs.existsSync(logFile)) {
@@ -669,8 +684,8 @@ function followLogs(laneDir: string, options: LogsOptions): void {
           content = lines.filter(line => regex.test(line)).join('\n');
         }
         
-        // Clean ANSI if needed
-        if (options.clean && !options.raw) {
+        // Clean ANSI if needed (unless raw mode)
+        if (!options.raw) {
           content = stripAnsi(content);
         }
         
@@ -809,7 +824,7 @@ async function logs(args: string[]): Promise<void> {
   // If no lane specified, show summary
   if (!options.lane) {
     displaySummary(runDir);
-    console.log(`${logger.COLORS.gray}Use --lane <name> to view logs, --readable for parsed AI output, or --all to view all lanes merged${logger.COLORS.reset}`);
+    console.log(`${logger.COLORS.gray}Use --lane <name> to view logs (default: readable), --clean for terminal logs, or --all to view all lanes merged${logger.COLORS.reset}`);
     return;
   }
   

package/src/cli/run.ts

@@ -16,6 +16,7 @@ interface RunOptions {
   executor: string | null;
   maxConcurrent: number | null;
   skipDoctor: boolean;
+  noGit: boolean;
   help: boolean;
 }
 
@@ -30,8 +31,13 @@ Options:
   --max-concurrent <num> Limit parallel agents (overrides config)
   --executor <type>      cursor-agent | cloud
   --skip-doctor          Skip environment checks (not recommended)
+  --no-git               Disable Git operations (worktree, push, commit)
   --dry-run              Show execution plan without starting agents
   --help, -h             Show help
+
+Examples:
+  cursorflow run _cursorflow/tasks
+  cursorflow run _cursorflow/tasks --no-git --skip-doctor
   `);
 }
 
@@ -46,6 +52,7 @@ function parseArgs(args: string[]): RunOptions {
     executor: executorIdx >= 0 ? args[executorIdx + 1] || null : null,
     maxConcurrent: maxConcurrentIdx >= 0 ? parseInt(args[maxConcurrentIdx + 1] || '0') || null : null,
     skipDoctor: args.includes('--skip-doctor') || args.includes('--no-doctor'),
+    noGit: args.includes('--no-git'),
     help: args.includes('--help') || args.includes('-h'),
   };
 }
@@ -136,6 +143,7 @@ async function run(args: string[]): Promise<void> {
       maxConcurrentLanes: options.maxConcurrent || config.maxConcurrentLanes,
       webhooks: config.webhooks || [],
       enhancedLogging: config.enhancedLogging,
+      noGit: options.noGit,
     });
   } catch (error: any) {
     // Re-throw to be handled by the main entry point