ai-sdlc 0.3.0-alpha.18 → 0.3.0-alpha.19

package/dist/core/agent-executor.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Agent Executor - Child process entry point for concurrent story execution
+ *
+ * This script is spawned as a child process by the orchestrator to execute
+ * a single story in isolation. It runs in its own worktree and communicates
+ * with the parent process via IPC.
+ *
+ * Usage: node agent-executor.js <storyId>
+ * Environment: AI_SDLC_STORY_ID must be set
+ */
+export {};
+//# sourceMappingURL=agent-executor.d.ts.map

package/dist/core/agent-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-executor.d.ts","sourceRoot":"","sources":["../../src/core/agent-executor.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/core/agent-executor.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+/**
+ * Agent Executor - Child process entry point for concurrent story execution
+ *
+ * This script is spawned as a child process by the orchestrator to execute
+ * a single story in isolation. It runs in its own worktree and communicates
+ * with the parent process via IPC.
+ *
+ * Usage: node agent-executor.js <storyId>
+ * Environment: AI_SDLC_STORY_ID must be set
+ */
+/**
+ * Send IPC message to parent process
+ */
+function sendToParent(message) {
+    if (process.send) {
+        process.send(message);
+    }
+}
+/**
+ * Send status update to parent
+ */
+function sendStatus(storyId, status, progress) {
+    sendToParent({
+        type: 'status_update',
+        storyId,
+        timestamp: Date.now(),
+        payload: { progress },
+    });
+}
+/**
+ * Send error report to parent
+ */
+function sendError(storyId, error) {
+    sendToParent({
+        type: 'error',
+        storyId,
+        timestamp: Date.now(),
+        payload: { error },
+    });
+}
+/**
+ * Send completion message to parent
+ */
+function sendComplete(storyId, success, exitCode) {
+    sendToParent({
+        type: 'complete',
+        storyId,
+        timestamp: Date.now(),
+        payload: {
+            result: {
+                storyId,
+                success,
+                exitCode,
+                signal: null,
+                duration: Date.now() - startTime,
+            },
+        },
+    });
+}
+/**
+ * Handle IPC messages from parent
+ */
+function setupIPCHandlers(storyId) {
+    process.on('message', (msg) => {
+        if (!msg || typeof msg !== 'object')
+            return;
+        const message = msg;
+        switch (message.type) {
+            case 'health_check':
+                // Respond to health check
+                sendToParent({
+                    type: 'health_response',
+                    storyId,
+                    timestamp: Date.now(),
+                });
+                break;
+            case 'shutdown':
+                // Graceful shutdown requested
+                console.log(`[${storyId}] Received shutdown signal, exiting...`);
+                process.exit(0);
+                break;
+        }
+    });
+}
+/**
+ * Handle graceful shutdown on SIGTERM
+ */
+function setupShutdownHandlers(storyId) {
+    const shutdown = (signal) => {
+        console.log(`[${storyId}] Received ${signal}, shutting down gracefully...`);
+        sendToParent({
+            type: 'shutdown',
+            storyId,
+            timestamp: Date.now(),
+        });
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+}
+// Track execution start time
+const startTime = Date.now();
+/**
+ * Main entry point
+ */
+async function main() {
+    // Get story ID from arguments or environment
+    const storyId = process.argv[2] || process.env.AI_SDLC_STORY_ID;
+    if (!storyId) {
+        console.error('Error: Story ID not provided');
+        console.error('Usage: node agent-executor.js <storyId>');
+        console.error('Or set AI_SDLC_STORY_ID environment variable');
+        process.exit(1);
+    }
+    // Setup IPC and shutdown handlers
+    setupIPCHandlers(storyId);
+    setupShutdownHandlers(storyId);
+    console.log(`[${storyId}] Agent executor started in worktree: ${process.cwd()}`);
+    sendStatus(storyId, 'starting');
+    try {
+        // Import and execute the run command
+        // This reuses the existing single-story execution logic
+        const { run } = await import('../cli/commands.js');
+        sendStatus(storyId, 'running');
+        // Execute the story with auto mode and no-worktree flag
+        // (since we're already in an isolated worktree)
+        await run({
+            story: storyId,
+            auto: true,
+            worktree: false, // --no-worktree: already in a worktree
+        });
+        // Execution succeeded
+        console.log(`[${storyId}] Story execution completed successfully`);
+        sendComplete(storyId, true, 0);
+        process.exit(0);
+    }
+    catch (error) {
+        // Execution failed
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        console.error(`[${storyId}] Story execution failed:`, errorMsg);
+        sendError(storyId, errorMsg);
+        sendComplete(storyId, false, 1);
+        process.exit(1);
+    }
+}
+// Run main with error handling
+main().catch((error) => {
+    console.error('Fatal error in agent executor:', error);
+    process.exit(1);
+});
+export {};
+//# sourceMappingURL=agent-executor.js.map

package/dist/core/agent-executor.js.map

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

package/dist/core/orchestrator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Multi-Process Orchestrator
+ *
+ * Manages concurrent execution of multiple stories via isolated child processes.
+ * Each story runs in its own git worktree with its own Node.js process.
+ *
+ * Key Features:
+ * - Spawns child processes with concurrency limiting
+ * - IPC communication for status updates and health checks
+ * - Graceful shutdown with SIGTERM → SIGKILL fallback
+ * - Error isolation (child crash doesn't affect parent or siblings)
+ * - Worktree lifecycle management
+ */
+import type { ProcessOrchestratorOptions, ProcessExecutionResult, Story } from '../types/index.js';
+/**
+ * Multi-Process Orchestrator
+ *
+ * Coordinates concurrent story execution across isolated child processes.
+ * Uses a manual queue pattern (similar to epic-processor) for concurrency control.
+ */
+export declare class Orchestrator {
+    private options;
+    private children;
+    private results;
+    private shuttingDown;
+    private worktreeService;
+    private processManager;
+    constructor(options: ProcessOrchestratorOptions);
+    /**
+     * Execute multiple stories concurrently with concurrency limiting
+     */
+    execute(stories: Story[]): Promise<ProcessExecutionResult[]>;
+    /**
+     * Execute a single story in an isolated child process
+     */
+    private executeStory;
+    /**
+     * Spawn child process for story execution
+     */
+    private spawnChild;
+    /**
+     * Graceful shutdown: SIGTERM → wait → SIGKILL
+     * Note: Signal handlers are managed by ProcessManager globally
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+    /**
+     * Generate URL-safe slug from title
+     */
+    private generateSlug;
+    /**
+     * Get current execution results
+     */
+    getResults(): ProcessExecutionResult[];
+    /**
+     * Get count of active child processes
+     */
+    getActiveCount(): number;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/core/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EACV,0BAA0B,EAC1B,sBAAsB,EAEtB,KAAK,EACN,MAAM,mBAAmB,CAAC;AAK3B;;;;;GAKG;AACH,qBAAa,YAAY;IAOX,OAAO,CAAC,OAAO;IAN3B,OAAO,CAAC,QAAQ,CAA4C;IAC5D,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,cAAc,CAAiB;gBAEnB,OAAO,EAAE,0BAA0B;IAOvD;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAyDlE;;OAEG;YACW,YAAY;IA0D1B;;OAEG;YACW,UAAU;IA2HxB;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA0C/B;;OAEG;YACW,OAAO;IAOrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,UAAU,IAAI,sBAAsB,EAAE;IAItC;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/dist/core/orchestrator.js

@@ -0,0 +1,320 @@
+/**
+ * Multi-Process Orchestrator
+ *
+ * Manages concurrent execution of multiple stories via isolated child processes.
+ * Each story runs in its own git worktree with its own Node.js process.
+ *
+ * Key Features:
+ * - Spawns child processes with concurrency limiting
+ * - IPC communication for status updates and health checks
+ * - Graceful shutdown with SIGTERM → SIGKILL fallback
+ * - Error isolation (child crash doesn't affect parent or siblings)
+ * - Worktree lifecycle management
+ */
+import { spawn } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { GitWorktreeService } from './worktree.js';
+import { ProcessManager } from './process-manager.js';
+import { getSdlcRoot } from './config.js';
+/**
+ * Multi-Process Orchestrator
+ *
+ * Coordinates concurrent story execution across isolated child processes.
+ * Uses a manual queue pattern (similar to epic-processor) for concurrency control.
+ */
+export class Orchestrator {
+    options;
+    children = new Map();
+    results = [];
+    shuttingDown = false;
+    worktreeService;
+    processManager;
+    constructor(options) {
+        this.options = options;
+        const sdlcRoot = getSdlcRoot();
+        const worktreeBasePath = options.worktreeBasePath || path.join(sdlcRoot, '.ai-sdlc', 'worktrees');
+        this.worktreeService = new GitWorktreeService(sdlcRoot, worktreeBasePath);
+        this.processManager = ProcessManager.getInstance();
+    }
+    /**
+     * Execute multiple stories concurrently with concurrency limiting
+     */
+    async execute(stories) {
+        if (stories.length === 0) {
+            return [];
+        }
+        console.log(`🚀 Starting orchestrator with ${stories.length} stories (concurrency: ${this.options.concurrency})`);
+        try {
+            // Use manual queue pattern (same as epic-processor)
+            const queue = [...stories];
+            const active = new Set();
+            while (queue.length > 0 || active.size > 0) {
+                // Fill up to maxConcurrent
+                while (active.size < this.options.concurrency && queue.length > 0 && !this.shuttingDown) {
+                    const story = queue.shift();
+                    const promise = this.executeStory(story);
+                    active.add(promise);
+                    // Remove from active and collect result when done
+                    promise.then((result) => {
+                        active.delete(promise);
+                        this.results.push(result);
+                    }, (error) => {
+                        active.delete(promise);
+                        // Error should not happen as executeStory catches all errors
+                        console.error('Unexpected error in executeStory:', error);
+                    });
+                }
+                if (active.size > 0) {
+                    // Wait for at least one to complete
+                    await Promise.race(active);
+                    // If shutdown requested, cancel queued stories
+                    if (this.shuttingDown) {
+                        console.log(`⚠️  Shutdown in progress, canceling ${queue.length} queued stories`);
+                        break;
+                    }
+                }
+            }
+            // Wait for all active processes to complete
+            if (active.size > 0) {
+                await Promise.all(active);
+            }
+            return this.results;
+        }
+        finally {
+            await this.cleanup();
+        }
+    }
+    /**
+     * Execute a single story in an isolated child process
+     */
+    async executeStory(story) {
+        const storyId = story.frontmatter.id;
+        const startTime = Date.now();
+        try {
+            // Create worktree for story
+            const slug = this.generateSlug(story.frontmatter.title || storyId);
+            const worktreePath = this.worktreeService.getWorktreePath(storyId, slug);
+            console.log(`📝 [${storyId}] Creating worktree: ${worktreePath}`);
+            try {
+                this.worktreeService.create({
+                    storyId,
+                    slug,
+                    baseBranch: 'main',
+                });
+            }
+            catch (error) {
+                // Worktree creation failure - skip story
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                console.error(`❌ [${storyId}] Worktree creation failed: ${errorMsg}`);
+                return {
+                    storyId,
+                    success: false,
+                    exitCode: null,
+                    signal: null,
+                    duration: Date.now() - startTime,
+                    error: `Worktree creation failed: ${errorMsg}`,
+                };
+            }
+            // Spawn child process
+            const result = await this.spawnChild(storyId, worktreePath, startTime);
+            // Cleanup worktree if not keeping
+            if (!this.options.keepWorktrees) {
+                try {
+                    this.worktreeService.remove(worktreePath, false);
+                }
+                catch (cleanupError) {
+                    console.warn(`⚠️  [${storyId}] Failed to cleanup worktree: ${cleanupError}`);
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            console.error(`❌ [${storyId}] Execution failed: ${errorMsg}`);
+            return {
+                storyId,
+                success: false,
+                exitCode: null,
+                signal: null,
+                duration: Date.now() - startTime,
+                error: errorMsg,
+            };
+        }
+    }
+    /**
+     * Spawn child process for story execution
+     */
+    async spawnChild(storyId, worktreePath, startTime) {
+        return new Promise((resolve) => {
+            // Spawn agent-executor as child process entry point
+            // Determine the path to agent-executor (could be in dist/ or src/ depending on build state)
+            const currentFilePath = fileURLToPath(import.meta.url);
+            const agentExecutorPath = path.join(path.dirname(currentFilePath), 'agent-executor.js');
+            const proc = spawn(process.execPath, [agentExecutorPath, storyId], {
+                cwd: worktreePath,
+                stdio: ['ignore', 'pipe', 'pipe', 'ipc'], // Enable IPC channel
+                shell: false,
+                env: {
+                    ...process.env,
+                    AI_SDLC_STORY_ID: storyId,
+                },
+            });
+            // Track child process
+            if (proc.pid) {
+                this.children.set(storyId, {
+                    storyId,
+                    pid: proc.pid,
+                    worktreePath,
+                    startTime,
+                });
+                this.processManager.registerChild(proc);
+            }
+            // Capture stdout/stderr
+            let stdout = '';
+            let stderr = '';
+            proc.stdout?.on('data', (data) => {
+                stdout += data.toString();
+                // Echo to parent console with prefix
+                const lines = data.toString().split('\n').filter((l) => l.trim());
+                lines.forEach((line) => console.log(`  [${storyId}] ${line}`));
+            });
+            proc.stderr?.on('data', (data) => {
+                stderr += data.toString();
+                // Echo to parent console with prefix
+                const lines = data.toString().split('\n').filter((l) => l.trim());
+                lines.forEach((line) => console.error(`  [${storyId}] ${line}`));
+            });
+            // Handle IPC messages from child
+            proc.on('message', (msg) => {
+                if (!msg || typeof msg !== 'object')
+                    return;
+                const message = msg;
+                switch (message.type) {
+                    case 'status_update':
+                        // Log status updates from child
+                        console.log(`  [${storyId}] Status update:`, message.payload);
+                        break;
+                    case 'health_response':
+                        // Child responded to health check
+                        console.log(`  [${storyId}] Health check OK`);
+                        break;
+                    case 'error':
+                        // Child reported an error
+                        console.error(`  [${storyId}] Error:`, message.payload);
+                        break;
+                    case 'complete':
+                        // Child reported completion
+                        console.log(`  [${storyId}] Complete:`, message.payload);
+                        break;
+                }
+            });
+            // Handle process exit
+            proc.on('close', (code, signal) => {
+                this.children.delete(storyId);
+                const duration = Date.now() - startTime;
+                const success = code === 0;
+                if (success) {
+                    console.log(`✅ [${storyId}] Completed successfully (${duration}ms)`);
+                }
+                else {
+                    console.error(`❌ [${storyId}] Failed with code ${code} (${duration}ms)`);
+                }
+                resolve({
+                    storyId,
+                    success,
+                    exitCode: code,
+                    signal,
+                    duration,
+                    error: success ? undefined : stderr || `Process exited with code ${code}`,
+                });
+            });
+            // Handle spawn errors
+            proc.on('error', (err) => {
+                this.children.delete(storyId);
+                console.error(`❌ [${storyId}] Process error: ${err.message}`);
+                resolve({
+                    storyId,
+                    success: false,
+                    exitCode: null,
+                    signal: null,
+                    duration: Date.now() - startTime,
+                    error: err.message,
+                });
+            });
+        });
+    }
+    /**
+     * Graceful shutdown: SIGTERM → wait → SIGKILL
+     * Note: Signal handlers are managed by ProcessManager globally
+     */
+    async shutdown() {
+        if (this.children.size === 0)
+            return;
+        console.log(`⏳ Shutting down ${this.children.size} child processes...`);
+        const shutdownTimeout = this.options.shutdownTimeout || 10000;
+        // Send SIGTERM to all children
+        for (const [storyId, info] of this.children.entries()) {
+            try {
+                process.kill(info.pid, 'SIGTERM');
+                console.log(`  [${storyId}] Sent SIGTERM`);
+            }
+            catch (error) {
+                // Process may already be dead
+            }
+        }
+        // Wait for graceful shutdown
+        const waitStart = Date.now();
+        const checkInterval = 100;
+        while (this.children.size > 0 && Date.now() - waitStart < shutdownTimeout) {
+            await new Promise((resolve) => setTimeout(resolve, checkInterval));
+        }
+        // Force kill remaining processes
+        if (this.children.size > 0) {
+            console.warn(`⚠️  Force killing ${this.children.size} unresponsive processes`);
+            for (const [storyId, info] of this.children.entries()) {
+                try {
+                    process.kill(info.pid, 'SIGKILL');
+                    console.log(`  [${storyId}] Sent SIGKILL`);
+                }
+                catch (error) {
+                    // Process may already be dead
+                }
+            }
+            this.children.clear();
+        }
+        console.log('✅ All child processes terminated');
+    }
+    /**
+     * Cleanup resources
+     */
+    async cleanup() {
+        // Ensure all children are terminated
+        if (this.children.size > 0) {
+            await this.shutdown();
+        }
+    }
+    /**
+     * Generate URL-safe slug from title
+     */
+    generateSlug(title) {
+        return title
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '')
+            .substring(0, 50);
+    }
+    /**
+     * Get current execution results
+     */
+    getResults() {
+        return [...this.results];
+    }
+    /**
+     * Get count of active child processes
+     */
+    getActiveCount() {
+        return this.children.size;
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/core/orchestrator.js.map

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

package/dist/index.js

@@ -75,6 +75,7 @@ program
     .option('--batch <story-ids>', 'Process multiple stories sequentially (comma-separated list, e.g., S-001,S-002,S-003)')
     .option('--epic <epic-id>', 'Process all stories labeled epic-{epic-id} with parallel execution (e.g., --epic ticketing matches epic-ticketing)')
     .option('--max-concurrent <n>', 'Maximum parallel stories for --epic (default: 3)', '3')
+    .option('--concurrent <n>', 'Run N ready stories concurrently in isolated worktrees (default: 1)', '1')
     .option('--step <phase>', 'Run a specific phase (refine, research, plan, implement, review) - cannot be combined with --auto --story')
     .option('--max-iterations <number>', 'Maximum retry iterations (default: infinite)')
     .option('--watch', 'Run in daemon mode, continuously processing backlog')
@@ -154,12 +155,36 @@ program
         console.log(c.error('Error: --clean requires --story flag'));
         process.exit(1);
     }
-    // Validate --keep-worktrees with --epic
-    if (options.keepWorktrees && !options.epic) {
+    // Validate --keep-worktrees with --epic or --concurrent
+    const concurrentValue = options.concurrent ? parseInt(options.concurrent, 10) : 1;
+    if (options.keepWorktrees && !options.epic && concurrentValue <= 1) {
         const c = getThemedChalk(config);
-        console.log(c.error('Error: --keep-worktrees requires --epic flag'));
+        console.log(c.error('Error: --keep-worktrees requires --epic or --concurrent > 1 flag'));
         process.exit(1);
     }
+    // Validate --concurrent mutual exclusivity
+    if (options.concurrent && parseInt(options.concurrent, 10) > 1) {
+        if (options.story) {
+            const c = getThemedChalk(config);
+            console.log(c.error('Error: --concurrent cannot be used with --story'));
+            process.exit(1);
+        }
+        if (options.epic) {
+            const c = getThemedChalk(config);
+            console.log(c.error('Error: --concurrent cannot be used with --epic'));
+            process.exit(1);
+        }
+        if (options.batch) {
+            const c = getThemedChalk(config);
+            console.log(c.error('Error: --concurrent cannot be used with --batch'));
+            process.exit(1);
+        }
+        if (options.watch) {
+            const c = getThemedChalk(config);
+            console.log(c.error('Error: --concurrent cannot be used with --watch'));
+            process.exit(1);
+        }
+    }
     return run(options);
 });
 program