@litmers/cursorflow-orchestrator 0.1.18 → 0.1.26

package/dist/utils/types.d.ts

@@ -1,274 +1,5 @@
 /**
  * Shared type definitions for CursorFlow
+ * Re-exports from central types directory for backward compatibility
  */
-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;
-    reviewAllTasks?: boolean;
-    maxReviewIterations: number;
-    defaultLaneConfig: LaneConfig;
-    logLevel: string;
-    verboseGit: boolean;
-    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>;
-}
-export interface WebhookConfig {
-    enabled?: boolean;
-    url: string;
-    secret?: string;
-    events?: string[];
-    headers?: Record<string, string>;
-    retries?: number;
-    timeoutMs?: number;
-}
-/**
- * Enhanced logging configuration
- */
-export interface EnhancedLogConfig {
-    /** Enable enhanced logging features (default: true) */
-    enabled: boolean;
-    /** Strip ANSI escape codes from clean logs (default: true) */
-    stripAnsi: boolean;
-    /** Add timestamps to each line (default: true) */
-    addTimestamps: boolean;
-    /** Maximum size in bytes before rotation (default: 50MB) */
-    maxFileSize: number;
-    /** Number of rotated files to keep (default: 5) */
-    maxFiles: number;
-    /** Write raw output with ANSI codes to separate file (default: true) */
-    keepRawLogs: boolean;
-    /** Write structured JSON log entries (default: true) */
-    writeJsonLog: boolean;
-    /** Timestamp format: 'iso' | 'relative' | 'short' (default: 'iso') */
-    timestampFormat: 'iso' | 'relative' | 'short';
-}
-export interface CursorFlowEvent<T = Record<string, any>> {
-    id: string;
-    type: string;
-    timestamp: string;
-    runId: string;
-    payload: T;
-}
-export type EventHandler<T = any> = (event: CursorFlowEvent<T>) => void | Promise<void>;
-export interface OrchestrationStartedPayload {
-    runId: string;
-    tasksDir: string;
-    laneCount: number;
-    runRoot: string;
-}
-export interface OrchestrationCompletedPayload {
-    runId: string;
-    laneCount: number;
-    completedCount: number;
-    failedCount: number;
-}
-export interface OrchestrationFailedPayload {
-    error: string;
-    blockedLanes?: string[];
-}
-export interface LaneStartedPayload {
-    laneName: string;
-    pid?: number;
-    logPath: string;
-}
-export interface LaneCompletedPayload {
-    laneName: string;
-    exitCode: number;
-}
-export interface LaneFailedPayload {
-    laneName: string;
-    exitCode: number;
-    error: string;
-}
-export interface LaneDependencyRequestedPayload {
-    laneName: string;
-    dependencyRequest: DependencyRequestPlan;
-}
-export interface TaskStartedPayload {
-    taskName: string;
-    taskBranch: string;
-    index: number;
-}
-export interface TaskCompletedPayload {
-    taskName: string;
-    taskBranch: string;
-    status: string;
-}
-export interface TaskFailedPayload {
-    taskName: string;
-    taskBranch: string;
-    error: string;
-}
-export interface AgentPromptSentPayload {
-    taskName: string;
-    model: string;
-    promptLength: number;
-}
-export interface AgentResponseReceivedPayload {
-    taskName: string;
-    ok: boolean;
-    duration: number;
-    responseLength: number;
-    error?: string;
-}
-export interface ReviewStartedPayload {
-    taskName: string;
-    taskBranch: string;
-}
-export interface ReviewCompletedPayload {
-    taskName: string;
-    status: 'approved' | 'needs_changes';
-    issueCount: number;
-    summary: string;
-}
-export interface ReviewApprovedPayload {
-    taskName: string;
-    iterations: number;
-}
-export interface ReviewRejectedPayload {
-    taskName: string;
-    reason: string;
-    iterations: number;
-}
-export interface DependencyPolicy {
-    allowDependencyChange: boolean;
-    lockfileReadOnly: boolean;
-}
-export interface Task {
-    name: string;
-    prompt: string;
-    model?: string;
-    /** Acceptance criteria for the AI reviewer to validate */
-    acceptanceCriteria?: string[];
-    /** Task-level dependencies (format: "lane:task") */
-    dependsOn?: string[];
-    /** Task execution timeout in milliseconds. Overrides lane-level timeout. */
-    timeout?: number;
-}
-export interface RunnerConfig {
-    tasks: Task[];
-    dependsOn?: string[];
-    pipelineBranch?: string;
-    branchPrefix?: string;
-    worktreeRoot?: string;
-    baseBranch?: string;
-    model?: string;
-    dependencyPolicy: DependencyPolicy;
-    enableReview?: boolean;
-    /** Output format for cursor-agent (default: 'stream-json') */
-    agentOutputFormat?: 'stream-json' | 'json' | 'plain';
-    reviewModel?: string;
-    reviewAllTasks?: boolean;
-    maxReviewIterations?: number;
-    acceptanceCriteria?: string[];
-    /** Task execution timeout in milliseconds. Default: 600000 (10 minutes) */
-    timeout?: number;
-    /**
-     * Enable intervention feature (stdin piping for message injection).
-     * Warning: May cause stdout buffering issues on some systems.
-     * 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;
-    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;
-    acceptanceCriteria?: 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;
-    tasksFile?: string;
-    dependsOn?: string[];
-    pid?: number;
-    /** List of completed task names in this lane */
-    completedTasks?: string[];
-    /** Task-level dependencies currently being waited for (format: "lane:task") */
-    waitingFor?: string[];
-}
-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;
-}
+export * from '../types';

package/dist/utils/types.js

@@ -1,6 +1,22 @@
 "use strict";
 /**
  * Shared type definitions for CursorFlow
+ * Re-exports from central types directory for backward compatibility
  */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../types"), exports);
 //# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

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

package/package.json

@@ -1,32 +1,12 @@
 {
   "name": "@litmers/cursorflow-orchestrator",
-  "version": "0.1.18",
+  "version": "0.1.26",
   "description": "Git worktree-based parallel AI agent orchestration system for Cursor",
   "main": "dist/cli/index.js",
   "bin": {
     "cursorflow": "dist/cli/index.js",
     "cursorflow-setup": "dist/cli/setup-commands.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "watch": "tsc -w",
-    "test": "jest",
-    "prepublishOnly": "npm run build && npm run validate",
-    "postinstall": "node scripts/postinstall.js",
-    "validate": "npm pack --dry-run",
-    "release": "scripts/release.sh",
-    "release:patch": "scripts/release.sh patch",
-    "release:minor": "scripts/release.sh minor",
-    "release:major": "scripts/release.sh major",
-    "security:check": "scripts/local-security-gate.sh",
-    "security:audit": "npm audit",
-    "security:audit:fix": "npm audit fix",
-    "security:setup": "scripts/setup-security.sh",
-    "verify": "scripts/verify-and-fix.sh",
-    "test:lifecycle": "tests/scripts/test-real-cursor-lifecycle.sh",
-    "test:comprehensive": "tests/scripts/test-comprehensive-lifecycle.sh",
-    "prepare": "husky"
-  },
   "keywords": [
     "cursor",
     "cursor-ide",
@@ -70,5 +50,40 @@
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -w",
+    "test": "jest",
+    "postinstall": "node scripts/postinstall.js",
+    "validate": "pnpm pack",
+    "release": "scripts/release.sh",
+    "release:patch": "scripts/release.sh patch",
+    "release:minor": "scripts/release.sh minor",
+    "release:major": "scripts/release.sh major",
+    "security:check": "scripts/local-security-gate.sh",
+    "security:audit": "pnpm audit",
+    "security:audit:fix": "pnpm audit --fix",
+    "security:setup": "scripts/setup-security.sh",
+    "verify": "scripts/verify-and-fix.sh",
+    "monitor": "scripts/monitor-lanes.sh",
+    "monitor:watch": "scripts/monitor-lanes.sh --watch",
+    "monitor:stream": "scripts/stream-logs.sh",
+    "cf": "node dist/cli/index.js",
+    "cf:init": "node dist/cli/index.js init",
+    "cf:setup": "node dist/cli/index.js setup",
+    "cf:prepare": "node dist/cli/index.js prepare",
+    "cf:run": "node dist/cli/index.js run",
+    "cf:monitor": "node dist/cli/index.js monitor",
+    "cf:clean": "node dist/cli/index.js clean",
+    "cf:stop": "node dist/cli/index.js stop",
+    "cf:resume": "node dist/cli/index.js resume",
+    "cf:doctor": "node dist/cli/index.js doctor",
+    "cf:signal": "node dist/cli/index.js signal",
+    "cf:logs": "node dist/cli/index.js logs",
+    "cf:runs": "node dist/cli/index.js runs",
+    "cf:models": "node dist/cli/index.js models",
+    "test:lifecycle": "tests/scripts/test-real-cursor-lifecycle.sh",
+    "test:comprehensive": "tests/scripts/test-comprehensive-lifecycle.sh"
+  }
+}

package/scripts/ai-security-check.js

@@ -6,7 +6,6 @@
  */
 
 const fs = require('fs');
-const path = require('path');
 const { spawnSync } = require('child_process');
 
 // 색상 정의

package/scripts/monitor-lanes.sh

@@ -0,0 +1,94 @@
+#!/bin/bash
+
+# CursorFlow Lane Monitor
+# Displays the latest logs from all active lanes in the current or latest run.
+
+# Colors for output
+BLUE='\033[0;34m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+BOLD='\033[1m'
+
+LOGS_DIR_BASE="${1:-.}"
+LOGS_DIR="${LOGS_DIR_BASE}/_cursorflow/logs/runs"
+
+# Shift arguments if path was provided
+if [[ -d "$1" && "$1" != "-w" && "$1" != "--watch" ]]; then
+    shift
+fi
+
+# Ensure we are in the root of the project or target dir
+if [ ! -d "$LOGS_DIR" ]; then
+    echo -e "${RED}Error: ${LOGS_DIR} directory not found.${NC}"
+    echo "Please run this script from the root of the CursorFlow project or provide a path."
+    exit 1
+fi
+
+# Find the latest run directory
+LATEST_RUN=$(ls -td ${LOGS_DIR}/run-* 2>/dev/null | head -n 1)
+
+if [ -z "$LATEST_RUN" ]; then
+    echo -e "${YELLOW}No runs found in ${LOGS_DIR}${NC}"
+    exit 1
+fi
+
+RUN_ID=$(basename "$LATEST_RUN")
+
+# Clear screen if requested or if using watch
+show_summary() {
+    echo -e "${BOLD}CursorFlow Lane Monitor${NC} - Run: ${GREEN}${RUN_ID}${NC}"
+    echo -e "Time: $(date '+%Y-%m-%d %H:%M:%S')"
+    echo "--------------------------------------------------------------------------------"
+
+    for lane_dir in "${LATEST_RUN}/lanes"/*; do
+        if [ -d "$lane_dir" ]; then
+            lane_name=$(basename "$lane_dir")
+            log_file="${lane_dir}/terminal-readable.log"
+            
+            # Extract status if possible (last line of log often contains status info)
+            if [ -f "$log_file" ]; then
+                # Get the last few lines
+                LAST_LOG=$(tail -n 1 "$log_file")
+                
+                # Check for completion or errors
+                STATUS="${BLUE}RUNNING${NC}"
+                if grep -q "✅ Pipeline completed" "$log_file" 2>/dev/null; then
+                     STATUS="${GREEN}SUCCESS${NC}"
+                elif grep -q "❌ Pipeline failed" "$log_file" 2>/dev/null; then
+                     STATUS="${RED}ERROR${NC}"
+                elif grep -q "❌ Task failed" "$log_file" 2>/dev/null; then
+                     STATUS="${RED}ERROR${NC}"
+                elif grep -q "✅ ✓ Configuration valid" "$log_file" 2>/dev/null; then
+                     STATUS="${BLUE}ACTIVE${NC}"
+                fi
+                
+                echo -e "[${STATUS}] ${BOLD}${lane_name}${NC}"
+                echo -e "   ${LAST_LOG:0:100}"
+                echo ""
+            else
+                echo -e "[${YELLOW}WAITING${NC}] ${BOLD}${lane_name}${NC}"
+                echo "   (No logs yet)"
+                echo ""
+            fi
+        fi
+    done
+}
+
+# Check for watch mode
+if [[ "$1" == "-w" || "$1" == "--watch" ]]; then
+    # Use simple loop to avoid argument passing issues with 'watch' command
+    while true; do
+        clear
+        show_summary
+        echo "Press Ctrl+C to stop..."
+        sleep 2
+    done
+else
+    show_summary
+    echo -e "${NC}Tip: Use ${BOLD}$0 --watch${NC} to monitor in real-time."
+fi
+
+exit 0
+

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

@@ -15,7 +15,6 @@
  */
 
 const { spawn, spawnSync } = require('child_process');
-const path = require('path');
 
 // Parse args
 const args = process.argv.slice(2);

package/scripts/stream-logs.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+
+# CursorFlow All Lanes Log Streamer
+# Replicates the output of 'cursorflow run' by streaming logs from all lanes.
+
+BLUE='\033[0;34m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+BOLD='\033[1m'
+
+LOGS_DIR_BASE="${1:-.}"
+LOGS_DIR="${LOGS_DIR_BASE}/_cursorflow/logs/runs"
+
+if [ ! -d "$LOGS_DIR" ]; then
+    echo -e "${RED}Error: ${LOGS_DIR} directory not found.${NC}"
+    exit 1
+fi
+
+LATEST_RUN=$(ls -td ${LOGS_DIR}/run-* 2>/dev/null | head -n 1)
+
+if [ -z "$LATEST_RUN" ]; then
+    echo -e "${YELLOW}No runs found in ${LOGS_DIR}${NC}"
+    exit 1
+fi
+
+RUN_ID=$(basename "$LATEST_RUN")
+echo -e "${BOLD}Streaming logs for Run: ${GREEN}${RUN_ID}${NC}"
+echo "--------------------------------------------------------------------------------"
+
+# Function to stream a single log file with a prefix
+stream_log() {
+    local lane_name=$1
+    local log_file=$2
+    local color=$3
+    
+    # Check if file exists, if not wait for it
+    until [ -f "$log_file" ]; do
+        sleep 1
+    done
+
+    # Tail the file and prefix each line
+    tail -n +1 -f "$log_file" | while IFS= read -r line; do
+        echo -e "${color}[${lane_name}]${NC} ${line}"
+    done
+}
+
+# Colors to rotate through
+COLORS=('\033[0;32m' '\033[0;34m' '\033[0;35m' '\033[0;36m' '\033[1;32m' '\033[1;34m' '\033[1;35m' '\033[1;36m')
+color_idx=0
+
+# Clean up background processes on exit
+trap 'kill $(jobs -p) 2>/dev/null' EXIT
+
+# Find all lanes and start streaming
+for lane_dir in "${LATEST_RUN}/lanes"/*; do
+    if [ -d "$lane_dir" ]; then
+        lane_name=$(basename "$lane_dir")
+        log_file="${lane_dir}/terminal-readable.log"
+        color=${COLORS[$color_idx]}
+        
+        # Start streaming in background
+        stream_log "$lane_name" "$log_file" "$color" &
+        
+        color_idx=$(( (color_idx + 1) % ${#COLORS[@]} ))
+    fi
+done
+
+# Wait for all background processes
+wait
+