@litmers/cursorflow-orchestrator 0.1.13 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litmers/cursorflow-orchestrator",
-  "version": "0.1.13",
+  "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/simple-logging-test.sh

@@ -0,0 +1,97 @@
+#!/bin/bash
+#
+# Simple Real Logging Test
+# This test runs cursor-agent directly and verifies log capture
+#
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+echo "🧪 Simple Cursor-Agent Logging Test"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+
+# Check cursor-agent
+if ! command -v cursor-agent &> /dev/null; then
+    echo "❌ cursor-agent not found"
+    exit 1
+fi
+
+cd "$PROJECT_ROOT"
+
+# Build
+echo "Building..."
+npm run build > /dev/null 2>&1
+
+# Setup test dir
+TEST_DIR="$PROJECT_ROOT/_test-logs"
+rm -rf "$TEST_DIR"
+mkdir -p "$TEST_DIR"
+
+# Create a very simple task
+cat > "$TEST_DIR/task.json" << 'EOF'
+{
+  "baseBranch": "main",
+  "branchPrefix": "test/log-",
+  "timeout": 30000,
+  "tasks": [
+    {
+      "name": "echo-test",
+      "prompt": "Say 'test complete' and nothing else.",
+      "model": "sonnet-4.5"
+    }
+  ]
+}
+EOF
+
+# Run with node directly
+echo ""
+echo "Running cursor-agent via runner..."
+echo ""
+
+LANE_DIR="$TEST_DIR/lane"
+mkdir -p "$LANE_DIR"
+
+# Run runner.js directly
+timeout 60 node dist/core/runner.js "$TEST_DIR/task.json" \
+  --run-dir "$LANE_DIR" \
+  --executor cursor-agent \
+  --start-index 0 || true
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📋 Log Files Created:"
+echo ""
+
+ls -la "$LANE_DIR"/*.log "$LANE_DIR"/*.jsonl 2>/dev/null || echo "No log files found"
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📝 terminal.log content:"
+echo ""
+
+if [ -f "$LANE_DIR/terminal.log" ]; then
+    head -50 "$LANE_DIR/terminal.log"
+else
+    echo "No terminal.log"
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📝 terminal.jsonl (first 3 entries):"
+echo ""
+
+if [ -f "$LANE_DIR/terminal.jsonl" ]; then
+    head -3 "$LANE_DIR/terminal.jsonl"
+else
+    echo "No terminal.jsonl"
+fi
+
+# Cleanup git branches
+git branch -D test/log-* 2>/dev/null || true
+git worktree remove _cursorflow/worktrees/test/log-* --force 2>/dev/null || true
+
+echo ""
+echo "✅ Test finished"
+

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/scripts/test-real-logging.sh

@@ -0,0 +1,289 @@
+#!/bin/bash
+#
+# Real Integration Test for Enhanced Logging
+# 
+# This script runs an actual cursor-agent task and verifies that:
+# 1. terminal.log is created with clean output
+# 2. terminal-raw.log contains raw output
+# 3. terminal.jsonl has structured entries
+# 4. ANSI codes are properly stripped in clean log
+# 5. Timestamps are added correctly
+#
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${CYAN}  🧪 Real Integration Test for Enhanced Logging${NC}"
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+
+# Check if cursor-agent is available
+if ! command -v cursor-agent &> /dev/null; then
+    echo -e "${RED}❌ cursor-agent not found. Please install it first.${NC}"
+    echo "   npm install -g @anthropic-ai/claude-code"
+    exit 1
+fi
+
+# Check cursor-agent auth
+echo -e "${YELLOW}Checking cursor-agent authentication...${NC}"
+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}✓ cursor-agent authenticated${NC}"
+
+# Setup test directory
+TEST_DIR="$PROJECT_ROOT/_cursorflow/test-real-logging"
+TASKS_DIR="$TEST_DIR/tasks"
+LOGS_DIR="$TEST_DIR/logs"
+
+echo ""
+echo -e "${YELLOW}Setting up test environment...${NC}"
+
+# Clean previous test
+rm -rf "$TEST_DIR"
+mkdir -p "$TASKS_DIR"
+mkdir -p "$LOGS_DIR"
+
+# Create a simple test task
+# This task should complete quickly (just echo something)
+cat > "$TASKS_DIR/logging-test.json" << 'EOF'
+{
+  "baseBranch": "main",
+  "branchPrefix": "test/logging-",
+  "timeout": 60000,
+  "dependencyPolicy": {
+    "allowDependencyChange": false,
+    "lockfileReadOnly": true
+  },
+  "tasks": [
+    {
+      "name": "simple-echo",
+      "prompt": "Please just respond with 'Hello from cursor-agent! The logging test is working.' and nothing else. Do not make any file changes.",
+      "model": "sonnet-4.5"
+    }
+  ]
+}
+EOF
+
+echo -e "${GREEN}✓ Test task created${NC}"
+
+# Build the project
+echo ""
+echo -e "${YELLOW}Building project...${NC}"
+cd "$PROJECT_ROOT"
+npm run build > /dev/null 2>&1
+echo -e "${GREEN}✓ Build complete${NC}"
+
+# Run the orchestrator with enhanced logging
+echo ""
+echo -e "${YELLOW}Running orchestration with enhanced logging...${NC}"
+echo -e "${CYAN}This will execute cursor-agent - please wait...${NC}"
+echo ""
+
+# Run orchestrator
+RUN_DIR="$LOGS_DIR/runs/run-$(date +%s)"
+mkdir -p "$RUN_DIR/lanes/logging-test"
+
+# Use node directly to run with enhanced logging config
+node -e "
+const { spawnLane, waitChild } = require('./dist/core/orchestrator');
+const path = require('path');
+const fs = require('fs');
+
+const tasksFile = '$TASKS_DIR/logging-test.json';
+const laneRunDir = '$RUN_DIR/lanes/logging-test';
+
+console.log('Starting lane with enhanced logging...');
+
+const result = spawnLane({
+  laneName: 'logging-test',
+  tasksFile: tasksFile,
+  laneRunDir: laneRunDir,
+  executor: 'cursor-agent',
+  startIndex: 0,
+  enhancedLogConfig: {
+    enabled: true,
+    stripAnsi: true,
+    addTimestamps: true,
+    keepRawLogs: true,
+    writeJsonLog: true,
+    timestampFormat: 'iso',
+  },
+});
+
+console.log('Lane spawned, waiting for completion...');
+console.log('PID:', result.child.pid);
+
+// Set timeout
+const timeout = setTimeout(() => {
+  console.log('Timeout reached, killing process...');
+  result.child.kill('SIGTERM');
+}, 120000); // 2 minute timeout
+
+waitChild(result.child).then((exitCode) => {
+  clearTimeout(timeout);
+  console.log('');
+  console.log('Lane completed with exit code:', exitCode);
+  
+  // Close log manager
+  if (result.logManager) {
+    result.logManager.close();
+  }
+  
+  process.exit(exitCode === 0 ? 0 : 1);
+}).catch((err) => {
+  clearTimeout(timeout);
+  console.error('Error:', err);
+  process.exit(1);
+});
+"
+
+EXIT_CODE=$?
+
+echo ""
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${CYAN}  📋 Verifying Log Files${NC}"
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+
+LANE_DIR="$RUN_DIR/lanes/logging-test"
+ERRORS=0
+
+# Check terminal.log
+if [ -f "$LANE_DIR/terminal.log" ]; then
+    SIZE=$(wc -c < "$LANE_DIR/terminal.log")
+    echo -e "${GREEN}✓ terminal.log exists (${SIZE} bytes)${NC}"
+    
+    # Check for ANSI codes in clean log (should NOT be there)
+    if grep -qP '\x1b\[' "$LANE_DIR/terminal.log" 2>/dev/null; then
+        echo -e "${RED}  ❌ ANSI codes found in clean log (should be stripped)${NC}"
+        ERRORS=$((ERRORS + 1))
+    else
+        echo -e "${GREEN}  ✓ No ANSI codes in clean log${NC}"
+    fi
+    
+    # Check for timestamps
+    if grep -qE '\[\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}' "$LANE_DIR/terminal.log"; then
+        echo -e "${GREEN}  ✓ Timestamps present${NC}"
+    else
+        echo -e "${YELLOW}  ⚠ No ISO timestamps found${NC}"
+    fi
+    
+    # Check for session header
+    if grep -q "CursorFlow Session Log" "$LANE_DIR/terminal.log"; then
+        echo -e "${GREEN}  ✓ Session header present${NC}"
+    else
+        echo -e "${RED}  ❌ Session header missing${NC}"
+        ERRORS=$((ERRORS + 1))
+    fi
+else
+    echo -e "${RED}❌ terminal.log NOT found${NC}"
+    ERRORS=$((ERRORS + 1))
+fi
+
+# Check terminal-raw.log
+if [ -f "$LANE_DIR/terminal-raw.log" ]; then
+    SIZE=$(wc -c < "$LANE_DIR/terminal-raw.log")
+    echo -e "${GREEN}✓ terminal-raw.log exists (${SIZE} bytes)${NC}"
+else
+    echo -e "${RED}❌ terminal-raw.log NOT found${NC}"
+    ERRORS=$((ERRORS + 1))
+fi
+
+# Check terminal.jsonl
+if [ -f "$LANE_DIR/terminal.jsonl" ]; then
+    SIZE=$(wc -c < "$LANE_DIR/terminal.jsonl")
+    ENTRIES=$(wc -l < "$LANE_DIR/terminal.jsonl")
+    echo -e "${GREEN}✓ terminal.jsonl exists (${SIZE} bytes, ${ENTRIES} entries)${NC}"
+    
+    # Check JSON validity
+    if head -1 "$LANE_DIR/terminal.jsonl" | jq . > /dev/null 2>&1; then
+        echo -e "${GREEN}  ✓ Valid JSON format${NC}"
+    else
+        echo -e "${RED}  ❌ Invalid JSON format${NC}"
+        ERRORS=$((ERRORS + 1))
+    fi
+    
+    # Check for required fields
+    if head -1 "$LANE_DIR/terminal.jsonl" | jq -e '.timestamp and .level and .message' > /dev/null 2>&1; then
+        echo -e "${GREEN}  ✓ Required fields present (timestamp, level, message)${NC}"
+    else
+        echo -e "${RED}  ❌ Missing required fields${NC}"
+        ERRORS=$((ERRORS + 1))
+    fi
+else
+    echo -e "${RED}❌ terminal.jsonl NOT found${NC}"
+    ERRORS=$((ERRORS + 1))
+fi
+
+echo ""
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${CYAN}  📝 Log Content Preview${NC}"
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+
+echo -e "${YELLOW}terminal.log (first 30 lines):${NC}"
+echo "─────────────────────────────────────────────────────────"
+if [ -f "$LANE_DIR/terminal.log" ]; then
+    head -30 "$LANE_DIR/terminal.log"
+fi
+echo "─────────────────────────────────────────────────────────"
+
+echo ""
+echo -e "${YELLOW}terminal.jsonl (first 5 entries):${NC}"
+echo "─────────────────────────────────────────────────────────"
+if [ -f "$LANE_DIR/terminal.jsonl" ]; then
+    head -5 "$LANE_DIR/terminal.jsonl" | jq -c '.'
+fi
+echo "─────────────────────────────────────────────────────────"
+
+echo ""
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+
+# Test the logs CLI command
+echo ""
+echo -e "${YELLOW}Testing 'cursorflow logs' command...${NC}"
+echo ""
+
+node dist/cli/index.js logs "$RUN_DIR" 2>&1 || true
+
+echo ""
+node dist/cli/index.js logs "$RUN_DIR" --lane logging-test --tail 20 2>&1 || true
+
+echo ""
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo -e "${CYAN}  📊 Test Summary${NC}"
+echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""
+
+if [ $ERRORS -eq 0 ] && [ $EXIT_CODE -eq 0 ]; then
+    echo -e "${GREEN}✅ All tests passed!${NC}"
+    echo ""
+    echo "Log files are at: $LANE_DIR"
+    exit 0
+elif [ $EXIT_CODE -ne 0 ]; then
+    echo -e "${YELLOW}⚠️  cursor-agent execution had issues (exit code: $EXIT_CODE)${NC}"
+    echo -e "${YELLOW}   This might be expected if auth or network issues occurred.${NC}"
+    echo -e "${YELLOW}   Check if log files were still created correctly.${NC}"
+    echo ""
+    echo "Log files are at: $LANE_DIR"
+    exit 1
+else
+    echo -e "${RED}❌ $ERRORS error(s) found in logging verification${NC}"
+    echo ""
+    echo "Log files are at: $LANE_DIR"
+    exit 1
+fi
+