@generacy-ai/orchestrator 0.0.0-preview-20260304013206

package/dist/worker/label-manager.d.ts

@@ -0,0 +1,89 @@
+import type { GitHubClient } from '@generacy-ai/workflow-engine';
+import type { WorkflowPhase, Logger } from './types.js';
+/**
+ * Manages label transitions on GitHub issues throughout the worker's phase loop.
+ *
+ * Each phase transition updates labels to reflect the current workflow state:
+ * - `phase:<name>` — the phase currently being executed
+ * - `completed:<name>` — a phase that finished successfully
+ * - `waiting-for:<gate>` — the workflow is paused at a review gate
+ * - `agent:paused` — the agent is waiting for human input
+ * - `agent:error` — the agent encountered an error
+ * - `agent:in-progress` — the agent is actively processing
+ */
+export declare class LabelManager {
+    private readonly github;
+    private readonly owner;
+    private readonly repo;
+    private readonly issueNumber;
+    private readonly logger;
+    constructor(github: GitHubClient, owner: string, repo: string, issueNumber: number, logger: Logger);
+    /**
+     * Called when a phase begins execution.
+     *
+     * Adds `phase:<current>` label and removes any previous `phase:*` labels.
+     */
+    onPhaseStart(phase: WorkflowPhase): Promise<void>;
+    /**
+     * Called when a phase completes successfully.
+     *
+     * Adds `completed:<current>` label and removes `phase:<current>` label.
+     */
+    onPhaseComplete(phase: WorkflowPhase): Promise<void>;
+    /**
+     * Called when a gate is hit and the workflow must pause for human review.
+     *
+     * Adds `waiting-for:<gate>` and `agent:paused` labels, removes `phase:<current>`.
+     */
+    onGateHit(phase: WorkflowPhase, gateLabel: string): Promise<void>;
+    /**
+     * Called when an error occurs during phase execution.
+     *
+     * Adds `agent:error` label and removes `phase:<current>`.
+     */
+    onError(phase: WorkflowPhase): Promise<void>;
+    /**
+     * Called when the entire workflow completes (all phases finished).
+     *
+     * Removes the `agent:in-progress` label.
+     */
+    onWorkflowComplete(): Promise<void>;
+    /**
+     * Called at the start of a resume (continue command) before the phase loop.
+     *
+     * Removes stale `waiting-for:*` and `agent:paused` labels that were set
+     * when the workflow paused at a gate, and adds `agent:in-progress` to
+     * reflect the active workflow state.
+     */
+    onResumeStart(): Promise<void>;
+    /**
+     * Ensures `agent:in-progress` and any lingering `phase:*` labels are removed.
+     *
+     * Designed to be called from `finally` blocks and reaper loops — this method
+     * never throws. If the GitHub API call fails after retries, the error is logged
+     * at `warn` level and swallowed.
+     *
+     * Safe to call when labels have already been removed (idempotent):
+     * `removeLabels()` in `gh-cli.ts` checks for "not found" in stderr and
+     * silently ignores it, so removing an already-absent label is a no-op.
+     * This also means `onWorkflowComplete()` is idempotent — calling it when
+     * `agent:in-progress` has already been removed will not throw.
+     */
+    ensureCleanup(): Promise<void>;
+    /**
+     * Fetch current labels on the issue and return those matching the `phase:*` pattern.
+     */
+    private getCurrentPhaseLabels;
+    /**
+     * Retry an async operation with exponential backoff.
+     *
+     * Attempts the operation up to 3 times with delays of 1000ms, 2000ms, and 4000ms
+     * between attempts. The final attempt's error is re-thrown.
+     */
+    private retryWithBackoff;
+    /**
+     * Sleep for the given number of milliseconds.
+     */
+    private sleep;
+}
+//# sourceMappingURL=label-manager.d.ts.map

package/dist/worker/label-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-manager.d.ts","sourceRoot":"","sources":["../../src/worker/label-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAJN,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM;IAGjC;;;;OAIG;IACG,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBvD;;;;OAIG;IACG,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvE;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAazC;;;;;;OAMG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BpC;;;;;;;;;;;;OAYG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBpC;;OAEG;YACW,qBAAqB;IAOnC;;;;;OAKG;YACW,gBAAgB;IA8B9B;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/worker/label-manager.js

@@ -0,0 +1,200 @@
+/**
+ * Manages label transitions on GitHub issues throughout the worker's phase loop.
+ *
+ * Each phase transition updates labels to reflect the current workflow state:
+ * - `phase:<name>` — the phase currently being executed
+ * - `completed:<name>` — a phase that finished successfully
+ * - `waiting-for:<gate>` — the workflow is paused at a review gate
+ * - `agent:paused` — the agent is waiting for human input
+ * - `agent:error` — the agent encountered an error
+ * - `agent:in-progress` — the agent is actively processing
+ */
+export class LabelManager {
+    github;
+    owner;
+    repo;
+    issueNumber;
+    logger;
+    constructor(github, owner, repo, issueNumber, logger) {
+        this.github = github;
+        this.owner = owner;
+        this.repo = repo;
+        this.issueNumber = issueNumber;
+        this.logger = logger;
+    }
+    /**
+     * Called when a phase begins execution.
+     *
+     * Adds `phase:<current>` label and removes any previous `phase:*` labels.
+     */
+    async onPhaseStart(phase) {
+        await this.retryWithBackoff(async () => {
+            const currentLabels = await this.getCurrentPhaseLabels();
+            const phaseLabel = `phase:${phase}`;
+            // Remove any existing phase labels that aren't the new one
+            const labelsToRemove = currentLabels.filter((l) => l !== phaseLabel);
+            if (labelsToRemove.length > 0) {
+                this.logger.info({ labels: labelsToRemove, issue: this.issueNumber }, `Removing previous phase labels: ${labelsToRemove.join(', ')}`);
+                await this.github.removeLabels(this.owner, this.repo, this.issueNumber, labelsToRemove);
+            }
+            // Add the new phase label
+            this.logger.info({ label: phaseLabel, issue: this.issueNumber }, `Adding phase label: ${phaseLabel}`);
+            await this.github.addLabels(this.owner, this.repo, this.issueNumber, [phaseLabel]);
+        });
+    }
+    /**
+     * Called when a phase completes successfully.
+     *
+     * Adds `completed:<current>` label and removes `phase:<current>` label.
+     */
+    async onPhaseComplete(phase) {
+        await this.retryWithBackoff(async () => {
+            const phaseLabel = `phase:${phase}`;
+            const completedLabel = `completed:${phase}`;
+            this.logger.info({ phase, issue: this.issueNumber }, `Phase complete: removing ${phaseLabel}, adding ${completedLabel}`);
+            await this.github.removeLabels(this.owner, this.repo, this.issueNumber, [phaseLabel]);
+            await this.github.addLabels(this.owner, this.repo, this.issueNumber, [completedLabel]);
+        });
+    }
+    /**
+     * Called when a gate is hit and the workflow must pause for human review.
+     *
+     * Adds `waiting-for:<gate>` and `agent:paused` labels, removes `phase:<current>`.
+     */
+    async onGateHit(phase, gateLabel) {
+        await this.retryWithBackoff(async () => {
+            const phaseLabel = `phase:${phase}`;
+            const completedLabel = `completed:${phase}`;
+            this.logger.info({ phase, gateLabel, issue: this.issueNumber }, `Gate hit: removing ${phaseLabel} and ${completedLabel}, adding ${gateLabel} and agent:paused`);
+            await this.github.removeLabels(this.owner, this.repo, this.issueNumber, [
+                phaseLabel,
+                completedLabel,
+            ]);
+            await this.github.addLabels(this.owner, this.repo, this.issueNumber, [
+                gateLabel,
+                'agent:paused',
+            ]);
+        });
+    }
+    /**
+     * Called when an error occurs during phase execution.
+     *
+     * Adds `agent:error` label and removes `phase:<current>`.
+     */
+    async onError(phase) {
+        await this.retryWithBackoff(async () => {
+            const phaseLabel = `phase:${phase}`;
+            this.logger.info({ phase, issue: this.issueNumber }, `Error in phase: removing ${phaseLabel} and agent:in-progress, adding agent:error`);
+            await this.github.removeLabels(this.owner, this.repo, this.issueNumber, [
+                phaseLabel,
+                'agent:in-progress',
+            ]);
+            await this.github.addLabels(this.owner, this.repo, this.issueNumber, ['agent:error']);
+        });
+    }
+    /**
+     * Called when the entire workflow completes (all phases finished).
+     *
+     * Removes the `agent:in-progress` label.
+     */
+    async onWorkflowComplete() {
+        await this.retryWithBackoff(async () => {
+            this.logger.info({ issue: this.issueNumber }, 'Workflow complete: removing agent:in-progress');
+            await this.github.removeLabels(this.owner, this.repo, this.issueNumber, [
+                'agent:in-progress',
+            ]);
+        });
+    }
+    /**
+     * Called at the start of a resume (continue command) before the phase loop.
+     *
+     * Removes stale `waiting-for:*` and `agent:paused` labels that were set
+     * when the workflow paused at a gate, and adds `agent:in-progress` to
+     * reflect the active workflow state.
+     */
+    async onResumeStart() {
+        await this.retryWithBackoff(async () => {
+            const issue = await this.github.getIssue(this.owner, this.repo, this.issueNumber);
+            const currentLabels = issue.labels.map((l) => typeof l === 'string' ? l : l.name);
+            const labelsToRemove = currentLabels.filter((l) => l.startsWith('waiting-for:') || l === 'agent:paused');
+            if (labelsToRemove.length > 0) {
+                this.logger.info({ labels: labelsToRemove, issue: this.issueNumber }, 'Resume: removing waiting-for and agent:paused labels');
+                await this.github.removeLabels(this.owner, this.repo, this.issueNumber, labelsToRemove);
+            }
+            // Add agent:in-progress to reflect active workflow state
+            this.logger.info({ issue: this.issueNumber }, 'Resume: adding agent:in-progress label');
+            await this.github.addLabels(this.owner, this.repo, this.issueNumber, ['agent:in-progress']);
+        });
+    }
+    /**
+     * Ensures `agent:in-progress` and any lingering `phase:*` labels are removed.
+     *
+     * Designed to be called from `finally` blocks and reaper loops — this method
+     * never throws. If the GitHub API call fails after retries, the error is logged
+     * at `warn` level and swallowed.
+     *
+     * Safe to call when labels have already been removed (idempotent):
+     * `removeLabels()` in `gh-cli.ts` checks for "not found" in stderr and
+     * silently ignores it, so removing an already-absent label is a no-op.
+     * This also means `onWorkflowComplete()` is idempotent — calling it when
+     * `agent:in-progress` has already been removed will not throw.
+     */
+    async ensureCleanup() {
+        try {
+            const currentLabels = await this.getCurrentPhaseLabels();
+            const labelsToRemove = ['agent:in-progress', ...currentLabels];
+            if (labelsToRemove.length > 0) {
+                this.logger.info({ labels: labelsToRemove, issue: this.issueNumber }, 'Ensuring cleanup: removing agent:in-progress and phase labels');
+                await this.retryWithBackoff(async () => {
+                    await this.github.removeLabels(this.owner, this.repo, this.issueNumber, labelsToRemove);
+                });
+            }
+        }
+        catch (error) {
+            // Never throw from cleanup — log and move on
+            this.logger.warn({ error: String(error), issue: this.issueNumber }, 'Failed to ensure label cleanup (non-fatal)');
+        }
+    }
+    /**
+     * Fetch current labels on the issue and return those matching the `phase:*` pattern.
+     */
+    async getCurrentPhaseLabels() {
+        const issue = await this.github.getIssue(this.owner, this.repo, this.issueNumber);
+        return issue.labels
+            .map((label) => (typeof label === 'string' ? label : label.name))
+            .filter((name) => name.startsWith('phase:'));
+    }
+    /**
+     * Retry an async operation with exponential backoff.
+     *
+     * Attempts the operation up to 3 times with delays of 1000ms, 2000ms, and 4000ms
+     * between attempts. The final attempt's error is re-thrown.
+     */
+    async retryWithBackoff(fn) {
+        const maxAttempts = 3;
+        const delays = [1000, 2000, 4000];
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                if (attempt === maxAttempts) {
+                    this.logger.error({ attempt, error: String(error), issue: this.issueNumber }, `Label operation failed after ${maxAttempts} attempts`);
+                    throw error;
+                }
+                const delay = delays[attempt - 1];
+                this.logger.warn({ attempt, delay, error: String(error), issue: this.issueNumber }, `Label operation failed (attempt ${attempt}/${maxAttempts}), retrying in ${delay}ms`);
+                await this.sleep(delay);
+            }
+        }
+        // Unreachable, but satisfies TypeScript
+        throw new Error('retryWithBackoff: unexpected exit');
+    }
+    /**
+     * Sleep for the given number of milliseconds.
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=label-manager.js.map

package/dist/worker/label-manager.js.map

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

package/dist/worker/output-capture.d.ts

@@ -0,0 +1,58 @@
+import type { OutputChunk, Logger } from './types.js';
+/**
+ * Callback for SSE event emission
+ */
+export type SSEEventEmitter = (event: {
+    type: 'workflow:started' | 'step:started' | 'step:completed' | 'workflow:completed' | 'workflow:failed';
+    workflowId: string;
+    data: Record<string, unknown>;
+}) => void;
+/**
+ * Parses newline-delimited JSON from Claude CLI stdout and emits SSE events.
+ *
+ * Claude CLI outputs one JSON object per line. This class accumulates raw
+ * string chunks (which may arrive mid-line), splits on newline boundaries,
+ * parses each complete line, and optionally emits SSE events for key
+ * lifecycle moments.
+ */
+export declare class OutputCapture {
+    private readonly workflowId;
+    private readonly logger;
+    private readonly emitter?;
+    private buffer;
+    private lineBuffer;
+    /** Session ID extracted from the Claude CLI `init` event (if present). */
+    private _sessionId;
+    constructor(workflowId: string, logger: Logger, emitter?: SSEEventEmitter | undefined);
+    /**
+     * Get the Claude CLI session ID captured from the `init` event.
+     * Returns undefined if no session ID has been received yet.
+     */
+    get sessionId(): string | undefined;
+    /**
+     * Process a chunk of stdout data from Claude CLI.
+     * Parses newline-delimited JSON lines.
+     */
+    processChunk(chunk: string): void;
+    /**
+     * Flush any remaining data in the line buffer.
+     */
+    flush(): void;
+    /**
+     * Get all captured output chunks.
+     */
+    getOutput(): OutputChunk[];
+    /**
+     * Clear the output buffer.
+     */
+    clear(): void;
+    /**
+     * Parse a single line of JSON and push the resulting OutputChunk.
+     */
+    private parseLine;
+    /**
+     * Emit SSE events based on the chunk type.
+     */
+    private emitSSEEvent;
+}
+//# sourceMappingURL=output-capture.d.ts.map

package/dist/worker/output-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-capture.d.ts","sourceRoot":"","sources":["../../src/worker/output-capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AActD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE;IACpC,IAAI,EAAE,kBAAkB,GAAG,cAAc,GAAG,gBAAgB,GAAG,oBAAoB,GAAG,iBAAiB,CAAC;IACxG,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,KAAK,IAAI,CAAC;AAEX;;;;;;;GAOG;AACH,qBAAa,aAAa;IAQtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAT3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAAM;IAExB,0EAA0E;IAC1E,OAAO,CAAC,UAAU,CAAqB;gBAGpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,YAAA;IAG5C;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkBjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,SAAS,IAAI,WAAW,EAAE;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,SAAS;IA4CjB;;OAEG;IACH,OAAO,CAAC,YAAY;CAkCrB"}

package/dist/worker/output-capture.js

@@ -0,0 +1,153 @@
+/**
+ * Valid OutputChunk type values recognized from Claude CLI JSON output.
+ */
+const KNOWN_TYPES = new Set([
+    'init',
+    'tool_use',
+    'tool_result',
+    'text',
+    'complete',
+    'error',
+]);
+/**
+ * Parses newline-delimited JSON from Claude CLI stdout and emits SSE events.
+ *
+ * Claude CLI outputs one JSON object per line. This class accumulates raw
+ * string chunks (which may arrive mid-line), splits on newline boundaries,
+ * parses each complete line, and optionally emits SSE events for key
+ * lifecycle moments.
+ */
+export class OutputCapture {
+    workflowId;
+    logger;
+    emitter;
+    buffer = [];
+    lineBuffer = '';
+    /** Session ID extracted from the Claude CLI `init` event (if present). */
+    _sessionId;
+    constructor(workflowId, logger, emitter) {
+        this.workflowId = workflowId;
+        this.logger = logger;
+        this.emitter = emitter;
+    }
+    /**
+     * Get the Claude CLI session ID captured from the `init` event.
+     * Returns undefined if no session ID has been received yet.
+     */
+    get sessionId() {
+        return this._sessionId;
+    }
+    /**
+     * Process a chunk of stdout data from Claude CLI.
+     * Parses newline-delimited JSON lines.
+     */
+    processChunk(chunk) {
+        this.lineBuffer += chunk;
+        const lines = this.lineBuffer.split('\n');
+        // The last element is either an empty string (if chunk ended with \n)
+        // or an incomplete line that we keep in the buffer.
+        this.lineBuffer = lines.pop() ?? '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0) {
+                continue;
+            }
+            this.parseLine(trimmed);
+        }
+    }
+    /**
+     * Flush any remaining data in the line buffer.
+     */
+    flush() {
+        const remaining = this.lineBuffer.trim();
+        this.lineBuffer = '';
+        if (remaining.length === 0) {
+            return;
+        }
+        this.parseLine(remaining);
+    }
+    /**
+     * Get all captured output chunks.
+     */
+    getOutput() {
+        return [...this.buffer];
+    }
+    /**
+     * Clear the output buffer.
+     */
+    clear() {
+        this.buffer = [];
+    }
+    /**
+     * Parse a single line of JSON and push the resulting OutputChunk.
+     */
+    parseLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            this.logger.debug({ line }, 'Non-JSON line from Claude CLI, treating as text');
+            const chunk = {
+                type: 'text',
+                data: { text: line },
+                timestamp: new Date().toISOString(),
+            };
+            this.buffer.push(chunk);
+            return;
+        }
+        const rawType = typeof parsed.type === 'string' ? parsed.type : 'text';
+        const type = KNOWN_TYPES.has(rawType)
+            ? rawType
+            : 'text';
+        // Extract metadata from tool_result chunks (e.g., filePath)
+        let metadata;
+        if (type === 'tool_result' && typeof parsed.filePath === 'string') {
+            metadata = { filePath: parsed.filePath };
+        }
+        const chunk = {
+            type,
+            data: parsed,
+            ...(metadata ? { metadata } : {}),
+            timestamp: new Date().toISOString(),
+        };
+        // Extract session_id from init events for conversation resume support
+        if (type === 'init' && typeof parsed.session_id === 'string') {
+            this._sessionId = parsed.session_id;
+            this.logger.debug({ sessionId: this._sessionId }, 'Captured Claude CLI session ID');
+        }
+        this.buffer.push(chunk);
+        this.emitSSEEvent(chunk);
+    }
+    /**
+     * Emit SSE events based on the chunk type.
+     */
+    emitSSEEvent(chunk) {
+        if (!this.emitter) {
+            return;
+        }
+        switch (chunk.type) {
+            case 'init':
+                this.emitter({
+                    type: 'step:started',
+                    workflowId: this.workflowId,
+                    data: { timestamp: chunk.timestamp, output: chunk.data },
+                });
+                break;
+            case 'complete':
+                this.emitter({
+                    type: 'step:completed',
+                    workflowId: this.workflowId,
+                    data: { timestamp: chunk.timestamp, output: chunk.data },
+                });
+                break;
+            case 'error':
+                this.logger.warn({ workflowId: this.workflowId, error: chunk.data }, 'Error chunk received from Claude CLI');
+                break;
+            default:
+                // No SSE event for other chunk types
+                break;
+        }
+    }
+}
+//# sourceMappingURL=output-capture.js.map

package/dist/worker/output-capture.js.map

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

package/dist/worker/phase-loop.d.ts

@@ -0,0 +1,64 @@
+import type { WorkerContext, PhaseResult, Logger, WorkflowPhase } from './types.js';
+import type { WorkerConfig } from './config.js';
+import type { LabelManager } from './label-manager.js';
+import type { StageCommentManager } from './stage-comment-manager.js';
+import type { GateChecker } from './gate-checker.js';
+import type { CliSpawner } from './cli-spawner.js';
+import type { OutputCapture } from './output-capture.js';
+import type { PrManager } from './pr-manager.js';
+/**
+ * Dependencies injected into the PhaseLoop.
+ */
+export interface PhaseLoopDeps {
+    labelManager: LabelManager;
+    stageCommentManager: StageCommentManager;
+    gateChecker: GateChecker;
+    cliSpawner: CliSpawner;
+    outputCapture: OutputCapture;
+    prManager: PrManager;
+}
+/**
+ * Result of a complete phase loop execution.
+ */
+export interface PhaseLoopResult {
+    /** All phase results from the loop */
+    results: PhaseResult[];
+    /** Whether the entire loop completed successfully */
+    completed: boolean;
+    /** The last phase that was executed */
+    lastPhase: string;
+    /** Whether the loop was stopped by a gate */
+    gateHit: boolean;
+}
+/**
+ * Iterates through workflow phases from the starting phase to completion.
+ *
+ * For each phase the loop:
+ * 1. Updates labels to reflect the current phase
+ * 2. Spawns the Claude CLI (or runs the validate command)
+ * 3. Marks the phase as completed
+ * 4. Checks for review gates
+ * 5. Updates the stage comment with progress
+ *
+ * The loop stops on:
+ * - Gate hit (workflow paused for human review)
+ * - Phase failure (error)
+ * - Abort signal
+ * - All phases completed
+ */
+export declare class PhaseLoop {
+    private readonly logger;
+    constructor(logger: Logger);
+    /**
+     * Execute the phase loop from the starting phase through to completion.
+     *
+     * @param phaseSequence - Optional workflow-specific phase sequence.
+     *   Defaults to the global PHASE_SEQUENCE for backward compatibility.
+     */
+    executeLoop(context: WorkerContext, config: WorkerConfig, deps: PhaseLoopDeps, phaseSequence?: WorkflowPhase[]): Promise<PhaseLoopResult>;
+    /**
+     * Build a phase progress array for stage comment updates.
+     */
+    private buildPhaseProgress;
+}
+//# sourceMappingURL=phase-loop.d.ts.map

package/dist/worker/phase-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-loop.d.ts","sourceRoot":"","sources":["../../src/worker/phase-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE3C;;;;;OAKG;IACG,WAAW,CACf,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,aAAa,EACnB,aAAa,CAAC,EAAE,aAAa,EAAE,GAC9B,OAAO,CAAC,eAAe,CAAC;IA+K3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAwB3B"}