@generacy-ai/orchestrator 0.0.0-preview-20260304013206

package/dist/worker/claude-cli-worker.d.ts

@@ -0,0 +1,61 @@
+import type { QueueItem } from '../types/index.js';
+import type { ProcessFactory, Logger } from './types.js';
+import type { WorkerConfig } from './config.js';
+import type { SSEEventEmitter } from './output-capture.js';
+/**
+ * Dependencies that can be injected for testing.
+ */
+export interface ClaudeCliWorkerDeps {
+    processFactory?: ProcessFactory;
+    sseEmitter?: SSEEventEmitter;
+}
+/**
+ * Top-level worker class that composes all sub-components to process
+ * a QueueItem through the full speckit phase loop or route to specialized handlers.
+ *
+ * This class implements the WorkerHandler signature:
+ *   `(item: QueueItem) => Promise<void>`
+ *
+ * It orchestrates:
+ * - Repository checkout
+ * - Command routing (address-pr-feedback → PrFeedbackHandler)
+ * - Phase resolution from issue labels (for process/continue commands)
+ * - Phase loop execution (CLI spawning, label management, gate checking)
+ * - SSE event emission for dashboard streaming
+ * - Error handling with structured label reporting
+ */
+export declare class ClaudeCliWorker {
+    private readonly config;
+    private readonly logger;
+    private readonly processFactory;
+    private readonly sseEmitter?;
+    private readonly repoCheckout;
+    private readonly phaseResolver;
+    constructor(config: WorkerConfig, logger: Logger, deps?: ClaudeCliWorkerDeps);
+    /**
+     * Process a queue item through the full phase loop or route to specialized handlers.
+     *
+     * This is the entry point invoked by the WorkerDispatcher.
+     *
+     * Command routing (T020):
+     * - `address-pr-feedback`: Routes to PrFeedbackHandler for PR review feedback
+     * - `process` / `continue`: Standard phase loop processing
+     *
+     * For phase loop processing:
+     * - Creates a WorkerContext
+     * - Resolves the starting phase from issue labels
+     * - Runs the phase loop to completion (or gate/error)
+     */
+    handle(item: QueueItem): Promise<void>;
+    /**
+     * Find the feature branch for an issue by checking for an existing PR.
+     *
+     * When resuming a workflow, the feature branch was created during the first
+     * run's setup phase. We find it by searching for an open draft PR that
+     * references the issue number.
+     *
+     * @returns The branch name, or undefined if no feature branch was found.
+     */
+    private resolveFeatureBranch;
+}
+//# sourceMappingURL=claude-cli-worker.d.ts.map

package/dist/worker/claude-cli-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-cli-worker.d.ts","sourceRoot":"","sources":["../../src/worker/claude-cli-worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAiB,cAAc,EAAsB,MAAM,EAAE,MAAM,YAAY,CAAC;AAE5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAyC3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAOxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAG3B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EAC/B,IAAI,GAAE,mBAAwB;IAQhC;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAiT5C;;;;;;;;OAQG;YACW,oBAAoB;CA2BnC"}

package/dist/worker/claude-cli-worker.js

@@ -0,0 +1,330 @@
+import { spawn } from 'node:child_process';
+import { createGitHubClient } from '@generacy-ai/workflow-engine';
+import { getPhaseSequence } from './types.js';
+import { PhaseResolver } from './phase-resolver.js';
+import { LabelManager } from './label-manager.js';
+import { StageCommentManager } from './stage-comment-manager.js';
+import { GateChecker } from './gate-checker.js';
+import { CliSpawner } from './cli-spawner.js';
+import { OutputCapture } from './output-capture.js';
+import { RepoCheckout } from './repo-checkout.js';
+import { PhaseLoop } from './phase-loop.js';
+import { PrManager } from './pr-manager.js';
+import { PrFeedbackHandler } from './pr-feedback-handler.js';
+import { EpicPostTasks } from './epic-post-tasks.js';
+/**
+ * Default ProcessFactory that uses Node's child_process.spawn.
+ */
+const defaultProcessFactory = {
+    spawn(command, args, options) {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: { ...process.env, ...options.env },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const exitPromise = new Promise((resolve) => {
+            child.on('exit', (code) => {
+                resolve(code);
+            });
+            child.on('error', () => {
+                resolve(1);
+            });
+        });
+        return {
+            stdout: child.stdout,
+            stderr: child.stderr,
+            pid: child.pid,
+            kill: (signal) => child.kill(signal),
+            exitPromise,
+        };
+    },
+};
+/**
+ * Top-level worker class that composes all sub-components to process
+ * a QueueItem through the full speckit phase loop or route to specialized handlers.
+ *
+ * This class implements the WorkerHandler signature:
+ *   `(item: QueueItem) => Promise<void>`
+ *
+ * It orchestrates:
+ * - Repository checkout
+ * - Command routing (address-pr-feedback → PrFeedbackHandler)
+ * - Phase resolution from issue labels (for process/continue commands)
+ * - Phase loop execution (CLI spawning, label management, gate checking)
+ * - SSE event emission for dashboard streaming
+ * - Error handling with structured label reporting
+ */
+export class ClaudeCliWorker {
+    config;
+    logger;
+    processFactory;
+    sseEmitter;
+    repoCheckout;
+    phaseResolver;
+    constructor(config, logger, deps = {}) {
+        this.config = config;
+        this.logger = logger;
+        this.processFactory = deps.processFactory ?? defaultProcessFactory;
+        this.sseEmitter = deps.sseEmitter;
+        this.repoCheckout = new RepoCheckout(config.workspaceDir, logger);
+        this.phaseResolver = new PhaseResolver();
+    }
+    /**
+     * Process a queue item through the full phase loop or route to specialized handlers.
+     *
+     * This is the entry point invoked by the WorkerDispatcher.
+     *
+     * Command routing (T020):
+     * - `address-pr-feedback`: Routes to PrFeedbackHandler for PR review feedback
+     * - `process` / `continue`: Standard phase loop processing
+     *
+     * For phase loop processing:
+     * - Creates a WorkerContext
+     * - Resolves the starting phase from issue labels
+     * - Runs the phase loop to completion (or gate/error)
+     */
+    async handle(item) {
+        const workerId = crypto.randomUUID();
+        const workflowId = `${item.owner}/${item.repo}#${item.issueNumber}`;
+        const workerLogger = this.logger.child({
+            workerId,
+            owner: item.owner,
+            repo: item.repo,
+            issue: item.issueNumber,
+            workflowName: item.workflowName,
+        });
+        workerLogger.info('Worker started processing queue item');
+        // Emit SSE workflow:started event
+        this.sseEmitter?.({
+            type: 'workflow:started',
+            workflowId,
+            data: {
+                owner: item.owner,
+                repo: item.repo,
+                issueNumber: item.issueNumber,
+                workflowName: item.workflowName,
+                command: item.command,
+            },
+        });
+        // Create a GitHub client scoped to the checkout directory
+        let checkoutPath;
+        const abortController = new AbortController();
+        let labelManager;
+        let phasesCompleted = false;
+        let gateHit = false;
+        try {
+            // 1. Clone the default branch first (always works, even on first run)
+            const defaultBranch = await this.repoCheckout.getDefaultBranch(item.owner, item.repo);
+            checkoutPath = await this.repoCheckout.ensureCheckout(workerId, item.owner, item.repo, defaultBranch);
+            // Create GitHub client scoped to checkout dir
+            const github = createGitHubClient(checkoutPath);
+            // 2. Route address-pr-feedback command to PrFeedbackHandler (T020)
+            if (item.command === 'address-pr-feedback') {
+                workerLogger.info('Routing to PrFeedbackHandler for PR feedback addressing');
+                const prFeedbackHandler = new PrFeedbackHandler(this.config, workerLogger, this.processFactory, this.sseEmitter);
+                await prFeedbackHandler.handle(item, checkoutPath);
+                workerLogger.info('PR feedback addressing completed');
+                this.sseEmitter?.({
+                    type: 'workflow:completed',
+                    workflowId,
+                    data: {
+                        command: 'address-pr-feedback',
+                        lastPhase: 'address-pr-feedback',
+                        totalPhases: 1,
+                    },
+                });
+                return;
+            }
+            // 3. Get issue labels to resolve starting phase
+            const issue = await github.getIssue(item.owner, item.repo, item.issueNumber);
+            const labels = issue.labels.map((l) => typeof l === 'string' ? l : l.name);
+            // 4. Resolve starting phase (for process/continue commands)
+            const startPhase = this.phaseResolver.resolveStartPhase(labels, item.command, item.workflowName);
+            workerLogger.info({ startPhase, labels }, 'Resolved starting phase');
+            // 5. If resuming (has completed phases), find and checkout the feature branch
+            if (startPhase !== 'specify') {
+                const featureBranch = await this.resolveFeatureBranch(github, item.owner, item.repo, item.issueNumber, workerLogger);
+                if (featureBranch) {
+                    workerLogger.info({ featureBranch }, 'Switching to existing feature branch for resume');
+                    await this.repoCheckout.switchBranch(checkoutPath, featureBranch);
+                }
+            }
+            // 6. Build WorkerContext
+            const context = {
+                workerId,
+                item,
+                startPhase,
+                github,
+                logger: workerLogger,
+                signal: abortController.signal,
+                checkoutPath,
+                issueUrl: `https://github.com/${item.owner}/${item.repo}/issues/${item.issueNumber}`,
+            };
+            // 7. Create sub-components
+            labelManager = new LabelManager(github, item.owner, item.repo, item.issueNumber, workerLogger);
+            const stageCommentManager = new StageCommentManager(github, item.owner, item.repo, item.issueNumber, workerLogger);
+            const gateChecker = new GateChecker(workerLogger);
+            const cliSpawner = new CliSpawner(this.processFactory, workerLogger, this.config.shutdownGracePeriodMs);
+            const outputCapture = new OutputCapture(workflowId, workerLogger, this.sseEmitter);
+            const prManager = new PrManager(github, item.owner, item.repo, item.issueNumber, workerLogger);
+            // 7b. On resume, clean up gate labels before starting the phase loop
+            if (item.command === 'continue') {
+                await labelManager.onResumeStart();
+            }
+            // 7c. Handle tasks-review gate resume for epics (T015)
+            // When an epic resumes after tasks-review approval, run post-tasks directly
+            // instead of re-entering the phase loop. The phase loop already completed
+            // (specify → clarify → plan → tasks); we just need to create child issues.
+            if (item.workflowName === 'speckit-epic' && item.command === 'continue') {
+                if (labels.includes('completed:tasks-review')) {
+                    workerLogger.info('Epic tasks-review gate satisfied — running post-tasks directly');
+                    const epicPostTasks = new EpicPostTasks(workerLogger);
+                    const postTasksResult = await epicPostTasks.execute(context);
+                    if (postTasksResult.success) {
+                        workerLogger.info({ childIssues: postTasksResult.childIssues.length }, 'Epic post-tasks complete after tasks-review resume');
+                    }
+                    else {
+                        workerLogger.error('Epic post-tasks failed after tasks-review resume');
+                    }
+                    this.sseEmitter?.({
+                        type: 'workflow:completed',
+                        workflowId,
+                        data: {
+                            command: item.command,
+                            lastPhase: 'tasks',
+                            totalPhases: 4,
+                        },
+                    });
+                    return;
+                }
+            }
+            // 8. Execute the phase loop
+            const phaseSequence = getPhaseSequence(item.workflowName);
+            const phaseLoop = new PhaseLoop(workerLogger);
+            const loopResult = await phaseLoop.executeLoop(context, this.config, {
+                labelManager,
+                stageCommentManager,
+                gateChecker,
+                cliSpawner,
+                outputCapture,
+                prManager,
+            }, phaseSequence);
+            // 9. Handle completion
+            if (loopResult.completed) {
+                phasesCompleted = true;
+                if (item.workflowName === 'speckit-epic') {
+                    // Epic workflows: create child issues and pause (do NOT complete workflow or mark PR ready)
+                    workerLogger.info('Epic phase loop complete — running post-tasks');
+                    const epicPostTasks = new EpicPostTasks(workerLogger);
+                    const postTasksResult = await epicPostTasks.execute(context);
+                    if (postTasksResult.success) {
+                        workerLogger.info({ childIssues: postTasksResult.childIssues.length }, 'Epic post-tasks complete — epic is now waiting for children');
+                    }
+                    else {
+                        workerLogger.error('Epic post-tasks failed — epic may need manual intervention');
+                    }
+                    this.sseEmitter?.({
+                        type: 'workflow:completed',
+                        workflowId,
+                        data: {
+                            command: item.command,
+                            lastPhase: loopResult.lastPhase,
+                            totalPhases: loopResult.results.length,
+                        },
+                    });
+                }
+                else {
+                    // Non-epic workflows: standard completion flow
+                    await labelManager.onWorkflowComplete();
+                    workerLogger.info('Marking PR as ready for review');
+                    await prManager.markReadyForReview();
+                    workerLogger.info('Workflow completed successfully — all phases done');
+                    this.sseEmitter?.({
+                        type: 'workflow:completed',
+                        workflowId,
+                        data: {
+                            command: item.command,
+                            lastPhase: loopResult.lastPhase,
+                            totalPhases: loopResult.results.length,
+                        },
+                    });
+                }
+            }
+            else if (loopResult.gateHit) {
+                gateHit = true;
+                workerLogger.info({ lastPhase: loopResult.lastPhase }, 'Workflow paused at review gate');
+            }
+            else {
+                // Phase failure
+                workerLogger.error({ lastPhase: loopResult.lastPhase }, 'Workflow stopped due to phase failure');
+                this.sseEmitter?.({
+                    type: 'workflow:failed',
+                    workflowId,
+                    data: {
+                        command: item.command,
+                        lastPhase: loopResult.lastPhase,
+                        totalPhases: loopResult.results.length,
+                    },
+                });
+            }
+        }
+        catch (error) {
+            if (phasesCompleted) {
+                // All phases completed successfully — the failure is in post-completion
+                // work (e.g. markReadyForReview, SSE emission). Log at warn level and
+                // do NOT re-throw, so WorkerDispatcher calls queue.complete() instead
+                // of queue.release().
+                workerLogger.warn({ error: String(error) }, 'Post-completion step failed (all phases completed successfully)');
+            }
+            else {
+                workerLogger.error({ error: String(error) }, 'Worker encountered an unhandled error');
+                this.sseEmitter?.({
+                    type: 'workflow:failed',
+                    workflowId,
+                    data: {
+                        command: item.command,
+                        error: error instanceof Error ? error.message : String(error),
+                    },
+                });
+                throw error;
+            }
+        }
+        finally {
+            // Cleanup: abort any in-flight operations
+            abortController.abort();
+            // Ensure agent:in-progress is cleaned up on every exit path.
+            // This is a no-op if onWorkflowComplete() or onError() already removed it.
+            // Gate hits intentionally leave agent:in-progress — the guard prevents unwanted cleanup.
+            if (labelManager && !gateHit) {
+                await labelManager.ensureCleanup();
+            }
+        }
+    }
+    /**
+     * Find the feature branch for an issue by checking for an existing PR.
+     *
+     * When resuming a workflow, the feature branch was created during the first
+     * run's setup phase. We find it by searching for an open draft PR that
+     * references the issue number.
+     *
+     * @returns The branch name, or undefined if no feature branch was found.
+     */
+    async resolveFeatureBranch(github, owner, repo, issueNumber, logger) {
+        try {
+            // Search remote branches for one starting with the issue number
+            const branches = await github.listBranches(owner, repo);
+            const featureBranch = branches.find((b) => b.startsWith(`${issueNumber}-`));
+            if (featureBranch) {
+                logger.info({ featureBranch, issueNumber }, 'Found feature branch by issue number prefix');
+                return featureBranch;
+            }
+            logger.info({ issueNumber }, 'No feature branch found for issue');
+            return undefined;
+        }
+        catch (error) {
+            logger.warn({ error: String(error), issueNumber }, 'Failed to resolve feature branch (non-fatal)');
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=claude-cli-worker.js.map

package/dist/worker/claude-cli-worker.js.map

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

package/dist/worker/cli-spawner.d.ts

@@ -0,0 +1,42 @@
+import type { CliSpawnOptions, Logger, PhaseResult, ProcessFactory, WorkflowPhase } from './types.js';
+import type { OutputCapture } from './output-capture.js';
+/**
+ * Spawns Claude CLI processes (or shell commands for validation) and manages
+ * their lifecycle: stdout/stderr capture, timeout with SIGTERM then SIGKILL,
+ * and abort signal propagation.
+ */
+export declare class CliSpawner {
+    private readonly processFactory;
+    private readonly logger;
+    private readonly shutdownGracePeriodMs;
+    constructor(processFactory: ProcessFactory, logger: Logger, shutdownGracePeriodMs?: number);
+    /**
+     * Spawn a Claude CLI process for the given workflow phase.
+     *
+     * Builds the command line from PHASE_TO_COMMAND, captures stdout via the
+     * provided OutputCapture, and handles timeout / abort with a
+     * SIGTERM -> grace period -> SIGKILL sequence.
+     */
+    spawnPhase(phase: WorkflowPhase, options: CliSpawnOptions, capture: OutputCapture): Promise<PhaseResult>;
+    /**
+     * Run a shell validation command (e.g., `pnpm test && pnpm build`).
+     *
+     * Unlike `spawnPhase`, this does not invoke the Claude CLI; it runs an
+     * arbitrary shell command via `sh -c`.
+     */
+    runValidatePhase(checkoutPath: string, validateCommand: string, signal: AbortSignal): Promise<PhaseResult>;
+    /**
+     * Manages the full lifecycle of a spawned child process:
+     * - Capture stdout (via OutputCapture if provided) and stderr
+     * - Enforce timeout with SIGTERM -> grace period -> SIGKILL
+     * - Propagate abort signal
+     * - Return a PhaseResult once the process exits
+     */
+    private manageProcess;
+    /**
+     * Send SIGTERM, wait the grace period, then send SIGKILL if the process
+     * is still alive.
+     */
+    private gracefulKill;
+}
+//# sourceMappingURL=cli-spawner.d.ts.map

package/dist/worker/cli-spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-spawner.d.ts","sourceRoot":"","sources":["../../src/worker/cli-spawner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,MAAM,EACN,WAAW,EACX,cAAc,EACd,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD;;;;GAIG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBAFrB,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,MAAM,EACd,qBAAqB,GAAE,MAAa;IAGvD;;;;;;OAMG;IACG,UAAU,CACd,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,WAAW,CAAC;IA2CvB;;;;;OAKG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC;IAqBvB;;;;;;OAMG;YACW,aAAa;IA4G3B;;;OAGG;IACH,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/worker/cli-spawner.js

@@ -0,0 +1,183 @@
+import { PHASE_TO_COMMAND } from './types.js';
+/** Default timeout for the validate phase (10 minutes). */
+const DEFAULT_VALIDATE_TIMEOUT_MS = 600_000;
+/**
+ * Spawns Claude CLI processes (or shell commands for validation) and manages
+ * their lifecycle: stdout/stderr capture, timeout with SIGTERM then SIGKILL,
+ * and abort signal propagation.
+ */
+export class CliSpawner {
+    processFactory;
+    logger;
+    shutdownGracePeriodMs;
+    constructor(processFactory, logger, shutdownGracePeriodMs = 5000) {
+        this.processFactory = processFactory;
+        this.logger = logger;
+        this.shutdownGracePeriodMs = shutdownGracePeriodMs;
+    }
+    /**
+     * Spawn a Claude CLI process for the given workflow phase.
+     *
+     * Builds the command line from PHASE_TO_COMMAND, captures stdout via the
+     * provided OutputCapture, and handles timeout / abort with a
+     * SIGTERM -> grace period -> SIGKILL sequence.
+     */
+    async spawnPhase(phase, options, capture) {
+        const command = PHASE_TO_COMMAND[phase];
+        if (command === null) {
+            throw new Error(`Phase "${phase}" has no CLI command (use runValidatePhase instead)`);
+        }
+        const prompt = `${command} ${options.prompt}`;
+        const args = [
+            '--headless',
+            '--output', 'json',
+            '--print', 'all',
+            '--max-turns', String(options.maxTurns),
+        ];
+        // Resume a previous session to keep MCP servers warm and carry context
+        if (options.resumeSessionId) {
+            args.push('--resume', options.resumeSessionId);
+        }
+        args.push('--prompt', prompt);
+        this.logger.info({
+            phase,
+            cwd: options.cwd,
+            maxTurns: options.maxTurns,
+            timeoutMs: options.timeoutMs,
+            resumeSessionId: options.resumeSessionId ?? null,
+        }, options.resumeSessionId
+            ? 'Resuming Claude CLI session for phase'
+            : 'Spawning new Claude CLI session for phase');
+        const child = this.processFactory.spawn('claude', args, {
+            cwd: options.cwd,
+            env: options.env,
+        });
+        return this.manageProcess(child, phase, options.timeoutMs, options.signal, capture);
+    }
+    /**
+     * Run a shell validation command (e.g., `pnpm test && pnpm build`).
+     *
+     * Unlike `spawnPhase`, this does not invoke the Claude CLI; it runs an
+     * arbitrary shell command via `sh -c`.
+     */
+    async runValidatePhase(checkoutPath, validateCommand, signal) {
+        const phase = 'validate';
+        const timeoutMs = DEFAULT_VALIDATE_TIMEOUT_MS;
+        this.logger.info({ phase, cwd: checkoutPath, validateCommand, timeoutMs }, 'Spawning validation command');
+        const child = this.processFactory.spawn('sh', ['-c', validateCommand], {
+            cwd: checkoutPath,
+            env: {},
+        });
+        return this.manageProcess(child, phase, timeoutMs, signal, undefined);
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Manages the full lifecycle of a spawned child process:
+     * - Capture stdout (via OutputCapture if provided) and stderr
+     * - Enforce timeout with SIGTERM -> grace period -> SIGKILL
+     * - Propagate abort signal
+     * - Return a PhaseResult once the process exits
+     */
+    async manageProcess(child, phase, timeoutMs, signal, capture) {
+        const startTime = Date.now();
+        let stderrBuffer = '';
+        // ---- stdout ----
+        if (child.stdout && capture) {
+            child.stdout.on('data', (data) => {
+                capture.processChunk(typeof data === 'string' ? data : data.toString('utf-8'));
+            });
+        }
+        // For runValidatePhase we still want to capture stdout even without OutputCapture,
+        // so we attach a no-op listener to avoid back-pressure issues.
+        if (child.stdout && !capture) {
+            child.stdout.on('data', () => {
+                // intentionally empty
+            });
+        }
+        // ---- stderr ----
+        if (child.stderr) {
+            child.stderr.on('data', (data) => {
+                stderrBuffer += typeof data === 'string' ? data : data.toString('utf-8');
+            });
+        }
+        // ---- Timeout handling ----
+        let timedOut = false;
+        const timeoutTimer = setTimeout(() => {
+            timedOut = true;
+            this.logger.warn({ phase, pid: child.pid, timeoutMs }, 'Phase timed out, sending SIGTERM');
+            this.gracefulKill(child, phase);
+        }, timeoutMs);
+        // ---- Abort signal handling ----
+        let aborted = false;
+        const onAbort = () => {
+            aborted = true;
+            this.logger.warn({ phase, pid: child.pid }, 'Abort signal received, sending SIGTERM');
+            this.gracefulKill(child, phase);
+        };
+        // Avoid attaching listener if already aborted.
+        if (signal.aborted) {
+            onAbort();
+        }
+        else {
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+        // ---- Wait for exit ----
+        let exitCode;
+        try {
+            exitCode = await child.exitPromise;
+        }
+        finally {
+            clearTimeout(timeoutTimer);
+            signal.removeEventListener('abort', onAbort);
+        }
+        // ---- Flush capture ----
+        if (capture) {
+            capture.flush();
+        }
+        const durationMs = Date.now() - startTime;
+        const resolvedExitCode = exitCode ?? 1;
+        const success = resolvedExitCode === 0;
+        this.logger.info({ phase, exitCode: resolvedExitCode, durationMs, success, timedOut, aborted }, 'Phase process exited');
+        const result = {
+            phase,
+            success,
+            exitCode: resolvedExitCode,
+            durationMs,
+            output: capture ? capture.getOutput() : [],
+            sessionId: capture?.sessionId,
+        };
+        if (!success) {
+            let message = `Phase "${phase}" failed with exit code ${resolvedExitCode}`;
+            if (timedOut) {
+                message = `Phase "${phase}" timed out after ${timeoutMs}ms`;
+            }
+            else if (aborted) {
+                message = `Phase "${phase}" was aborted`;
+            }
+            result.error = {
+                message,
+                stderr: stderrBuffer,
+                phase,
+            };
+        }
+        return result;
+    }
+    /**
+     * Send SIGTERM, wait the grace period, then send SIGKILL if the process
+     * is still alive.
+     */
+    gracefulKill(child, phase) {
+        child.kill('SIGTERM');
+        const killTimer = setTimeout(() => {
+            this.logger.warn({ phase, pid: child.pid }, 'Grace period expired, sending SIGKILL');
+            child.kill('SIGKILL');
+        }, this.shutdownGracePeriodMs);
+        // Clear the SIGKILL timer once the process exits on its own.
+        void child.exitPromise.then(() => {
+            clearTimeout(killTimer);
+        });
+    }
+}
+//# sourceMappingURL=cli-spawner.js.map

package/dist/worker/cli-spawner.js.map

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