@generacy-ai/orchestrator 0.0.0-preview-20260304013206

package/dist/worker/pr-feedback-handler.js

@@ -0,0 +1,391 @@
+import { createGitHubClient } from '@generacy-ai/workflow-engine';
+import { OutputCapture } from './output-capture.js';
+import { RepoCheckout } from './repo-checkout.js';
+/**
+ * Handles the `address-pr-feedback` command.
+ *
+ * Processing flow:
+ *  1. Extract PR number from queue item metadata
+ *  2. Fetch the PR to get the branch name
+ *  3. Switch to the PR branch (not default branch)
+ *  4. Fetch fresh unresolved review threads
+ *  5. Build a structured prompt with all unresolved comments
+ *  6. Spawn Claude CLI to address the feedback
+ *  7. Stage, commit, and push changes to the PR branch
+ *  8. Reply to each review thread (never resolve)
+ *  9. Remove the `waiting-for:address-pr-feedback` label
+ *
+ * Error handling strategy (T019):
+ *
+ * **FR-013: Timeout handling**
+ * - If CLI times out: push any partial changes that were made
+ * - Keep `waiting-for:address-pr-feedback` label (don't remove)
+ * - Label retention ensures the task will be retried on next detection cycle
+ * - Log timeout warning with structured context
+ *
+ * **FR-007: Reply failure handling**
+ * - If posting replies fails for some threads: still remove label
+ * - Log warnings for each failed reply
+ * - Partial reply success is acceptable (code changes were pushed successfully)
+ * - Handler does not throw on reply failures
+ *
+ * **SC-006: Thread resolution prevention**
+ * - Only use `replyToPRComment()` API — never call any thread-resolve API
+ * - Human reviewer will resolve threads after verifying changes
+ * - Comments in code explicitly reference SC-006 for clarity
+ *
+ * **Structured logging**
+ * - All operations logged with structured context (prNumber, issueNumber, owner, repo)
+ * - Error logs include full error messages and relevant context
+ * - Success/failure states clearly logged for observability
+ * - All FR/SC references included in log messages for traceability
+ *
+ * **Critical operation failures**
+ * - PR fetch failure: throw (cannot proceed without PR details)
+ * - Branch switch failure: throw (wrong branch would cause issues)
+ * - Comment fetch failure: throw (cannot address unknown feedback)
+ * - Push failure: log error but don't throw (allows retry via label)
+ *
+ * **Non-critical operation failures**
+ * - No unresolved threads: remove label, early return (success case)
+ * - Reply posting: log warning, continue (FR-007)
+ * - Label removal: log warning, continue (non-fatal)
+ */
+export class PrFeedbackHandler {
+    config;
+    logger;
+    processFactory;
+    sseEmitter;
+    repoCheckout;
+    constructor(config, logger, processFactory, sseEmitter) {
+        this.config = config;
+        this.logger = logger;
+        this.processFactory = processFactory;
+        this.sseEmitter = sseEmitter;
+        this.repoCheckout = new RepoCheckout(config.workspaceDir, logger);
+    }
+    /**
+     * Process a PR feedback addressing task.
+     *
+     * @param item - Queue item with `command: 'address-pr-feedback'`
+     * @param checkoutPath - Path to the already-checked-out repository
+     */
+    async handle(item, checkoutPath) {
+        const { owner, repo, issueNumber } = item;
+        const metadata = item.metadata;
+        if (!metadata?.prNumber) {
+            throw new Error('Missing prNumber in metadata for address-pr-feedback command');
+        }
+        const { prNumber } = metadata;
+        const workflowId = `${owner}/${repo}#${issueNumber}`;
+        this.logger.info({ prNumber, issueNumber, owner, repo }, 'Starting PR feedback addressing');
+        // Create GitHub client scoped to checkout path
+        const github = createGitHubClient(checkoutPath);
+        try {
+            // 1. Fetch the PR to get branch name
+            let pr;
+            try {
+                pr = await github.getPullRequest(owner, repo, prNumber);
+            }
+            catch (error) {
+                this.logger.error({ error: String(error), prNumber, owner, repo }, 'Failed to fetch PR details');
+                throw new Error(`Failed to fetch PR #${prNumber}: ${String(error)}`);
+            }
+            const branchName = pr.head.ref;
+            this.logger.info({ prNumber, branchName }, 'PR branch identified');
+            // 2. Switch to the PR branch
+            try {
+                await this.repoCheckout.switchBranch(checkoutPath, branchName);
+            }
+            catch (error) {
+                this.logger.error({ error: String(error), prNumber, branchName, checkoutPath }, 'Failed to switch to PR branch');
+                throw new Error(`Failed to switch to branch ${branchName}: ${String(error)}`);
+            }
+            // 3. Fetch fresh unresolved review threads
+            let allComments;
+            let unresolvedComments;
+            try {
+                allComments = await github.getPRComments(owner, repo, prNumber);
+                unresolvedComments = allComments.filter((c) => c.resolved === false);
+                this.logger.info({ prNumber, totalComments: allComments.length, unresolved: unresolvedComments.length }, 'Fetched PR review comments');
+            }
+            catch (error) {
+                this.logger.error({ error: String(error), prNumber, owner, repo }, 'Failed to fetch PR review comments');
+                throw new Error(`Failed to fetch review comments for PR #${prNumber}: ${String(error)}`);
+            }
+            // 4. If no unresolved threads, remove label and return early
+            if (unresolvedComments.length === 0) {
+                this.logger.info({ prNumber, issueNumber }, 'No unresolved threads found — removing label and exiting');
+                await this.removeFeedbackLabel(github, owner, repo, issueNumber);
+                return;
+            }
+            // 5. Build structured prompt
+            const prompt = this.buildFeedbackPrompt(unresolvedComments, prNumber, issueNumber);
+            // 6. Spawn Claude CLI to address feedback
+            const success = await this.spawnClaudeForFeedback(checkoutPath, prompt, workflowId);
+            // 7. Commit and push changes (even on timeout — partial completion strategy)
+            // FR-013: Push partial changes on timeout to preserve work and enable retry
+            let hasChanges = false;
+            try {
+                hasChanges = await this.commitAndPushChanges(github, checkoutPath, branchName, prNumber, issueNumber);
+                if (hasChanges) {
+                    this.logger.info({ prNumber, issueNumber, success }, 'Successfully pushed changes to PR branch');
+                }
+            }
+            catch (error) {
+                this.logger.error({ error: String(error), prNumber, issueNumber, branchName }, 'Failed to commit and push changes — partial work may be lost');
+                // Don't throw here — we want to continue with reply attempt and label management
+                // The label will be kept for retry if success=false
+            }
+            if (!hasChanges && !success) {
+                this.logger.warn({ prNumber, issueNumber }, 'No changes made and CLI did not complete successfully — will retry');
+            }
+            // 8. Reply to review threads (only if CLI completed successfully)
+            // FR-007: Partial reply failure is acceptable — we still remove the label
+            if (success) {
+                try {
+                    await this.replyToThreads(github, owner, repo, prNumber, unresolvedComments);
+                }
+                catch (error) {
+                    // FR-007: Even if reply posting fails, we consider the task complete
+                    // and remove the label. The code changes were pushed successfully.
+                    this.logger.warn({ error: String(error), prNumber, issueNumber }, 'Failed to post some or all thread replies — partial success acceptable');
+                    // Continue to label removal
+                }
+            }
+            else {
+                this.logger.warn({ prNumber, issueNumber }, 'Skipping thread replies due to CLI timeout or failure — will retry on next cycle');
+            }
+            // 9. Remove label (only if successful, otherwise keep for retry)
+            // FR-013: Keep label on timeout/failure to enable retry
+            if (success) {
+                await this.removeFeedbackLabel(github, owner, repo, issueNumber);
+                this.logger.info({ prNumber, issueNumber }, 'PR feedback addressing completed successfully');
+            }
+            else {
+                this.logger.info({ prNumber, issueNumber, hasChanges }, 'Keeping waiting-for:address-pr-feedback label for retry (CLI did not complete successfully)');
+            }
+        }
+        catch (error) {
+            this.logger.error({ error: String(error), prNumber, issueNumber, owner, repo }, 'Error processing PR feedback — task failed');
+            throw error;
+        }
+    }
+    /**
+     * Build a structured prompt containing all unresolved review comments.
+     *
+     * The prompt instructs Claude to:
+     * - Read each review comment
+     * - Make the necessary code changes
+     * - Commit the changes
+     * - NOT resolve any threads (human reviewer will resolve)
+     */
+    buildFeedbackPrompt(comments, prNumber, issueNumber) {
+        const commentList = comments
+            .map((c, idx) => {
+            const location = c.path && c.line
+                ? `${c.path}:${c.line}`
+                : c.path || 'general comment';
+            return `${idx + 1}. **${c.author}** (${location}):\n   ${c.body}`;
+        })
+            .join('\n\n');
+        return `You are addressing PR review feedback for PR #${prNumber} (linked to issue #${issueNumber}).
+
+The following unresolved review comments need to be addressed:
+
+${commentList}
+
+**Instructions:**
+1. Read and understand each review comment above
+2. Make the necessary code changes to address each comment
+3. The changes will be automatically committed and pushed to the PR branch
+4. Do NOT resolve any review threads — the human reviewer will resolve them after verifying your changes
+
+Please proceed with addressing the feedback.`;
+    }
+    /**
+     * Spawn Claude CLI to address PR feedback.
+     *
+     * Returns true if the CLI completed successfully, false on timeout or failure.
+     * FR-013: On timeout, partial changes are pushed and label is kept for retry.
+     */
+    async spawnClaudeForFeedback(checkoutPath, prompt, workflowId) {
+        const args = [
+            '--headless',
+            '--output', 'json',
+            '--print', 'all',
+            '--max-turns', String(this.config.maxTurns),
+            '--prompt', prompt,
+        ];
+        this.logger.info({ cwd: checkoutPath, maxTurns: this.config.maxTurns, timeoutMs: this.config.phaseTimeoutMs }, 'Spawning Claude CLI for PR feedback');
+        let child;
+        try {
+            child = this.processFactory.spawn('claude', args, {
+                cwd: checkoutPath,
+                env: {},
+            });
+        }
+        catch (error) {
+            this.logger.error({ error: String(error), cwd: checkoutPath }, 'Failed to spawn Claude CLI process');
+            return false;
+        }
+        // Set up output capture for SSE events
+        const outputCapture = new OutputCapture(workflowId, this.logger, this.sseEmitter);
+        // Capture stdout
+        if (child.stdout) {
+            child.stdout.on('data', (data) => {
+                outputCapture.processChunk(typeof data === 'string' ? data : data.toString('utf-8'));
+            });
+        }
+        // Capture stderr for error diagnostics
+        if (child.stderr) {
+            let stderrBuffer = '';
+            child.stderr.on('data', (data) => {
+                stderrBuffer += typeof data === 'string' ? data : data.toString('utf-8');
+            });
+            // Log stderr on process exit if non-empty
+            child.exitPromise.finally(() => {
+                if (stderrBuffer.trim()) {
+                    this.logger.debug({ stderr: stderrBuffer.trim() }, 'Claude CLI stderr output');
+                }
+            });
+        }
+        // Set up timeout
+        // FR-013: On timeout, we return false and the caller will push partial changes
+        let timedOut = false;
+        const timeoutTimer = setTimeout(() => {
+            timedOut = true;
+            this.logger.warn({ pid: child.pid, timeoutMs: this.config.phaseTimeoutMs }, 'PR feedback CLI timed out (FR-013) — sending SIGTERM, partial changes will be pushed');
+            child.kill('SIGTERM');
+            // Force kill after grace period
+            setTimeout(() => {
+                if (child.pid) {
+                    this.logger.warn({ pid: child.pid, gracePeriodMs: this.config.shutdownGracePeriodMs }, 'Grace period expired, sending SIGKILL');
+                    child.kill('SIGKILL');
+                }
+            }, this.config.shutdownGracePeriodMs);
+        }, this.config.phaseTimeoutMs);
+        try {
+            const exitCode = await child.exitPromise;
+            clearTimeout(timeoutTimer);
+            outputCapture.flush();
+            const success = exitCode === 0;
+            if (timedOut) {
+                // FR-013: Timeout scenario — partial completion strategy
+                this.logger.warn({ exitCode, timeoutMs: this.config.phaseTimeoutMs }, 'CLI timed out — returning false to trigger partial completion strategy (push changes, keep label)');
+                return false;
+            }
+            if (!success) {
+                this.logger.warn({ exitCode }, 'CLI exited with non-zero code — returning false to keep label for retry');
+            }
+            else {
+                this.logger.info({ exitCode }, 'CLI completed successfully');
+            }
+            return success;
+        }
+        catch (error) {
+            clearTimeout(timeoutTimer);
+            this.logger.error({ error: String(error), timedOut }, 'Error waiting for CLI process — returning false');
+            return false;
+        }
+    }
+    /**
+     * Stage all changes, commit, and push to the PR branch.
+     *
+     * Returns true if there were changes to commit, false otherwise.
+     */
+    async commitAndPushChanges(github, checkoutPath, branchName, prNumber, issueNumber) {
+        let status;
+        try {
+            status = await github.getStatus();
+        }
+        catch (error) {
+            this.logger.error({ error: String(error), checkoutPath }, 'Failed to get git status');
+            throw new Error(`Failed to get git status: ${String(error)}`);
+        }
+        if (!status.has_changes) {
+            this.logger.info({ prNumber, issueNumber }, 'No changes to commit — skipping commit/push');
+            return false;
+        }
+        this.logger.info({ prNumber, staged: status.staged.length, unstaged: status.unstaged.length, untracked: status.untracked.length }, 'Staging and committing changes');
+        // Stage all changes
+        try {
+            await github.stageAll();
+        }
+        catch (error) {
+            this.logger.error({ error: String(error), prNumber }, 'Failed to stage changes');
+            throw new Error(`Failed to stage changes: ${String(error)}`);
+        }
+        // Commit with clear message
+        const commitMessage = `Address PR #${prNumber} review feedback
+
+Automated feedback addressing for issue #${issueNumber}.
+
+Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>`;
+        try {
+            await github.commit(commitMessage);
+        }
+        catch (error) {
+            this.logger.error({ error: String(error), prNumber }, 'Failed to commit changes');
+            throw new Error(`Failed to commit changes: ${String(error)}`);
+        }
+        // Push to PR branch
+        this.logger.info({ prNumber, branch: branchName }, 'Pushing changes to PR branch');
+        try {
+            await github.push('origin', branchName);
+        }
+        catch (error) {
+            this.logger.error({ error: String(error), prNumber, branch: branchName }, 'Failed to push changes to PR branch');
+            throw new Error(`Failed to push to branch ${branchName}: ${String(error)}`);
+        }
+        this.logger.info({ prNumber, branch: branchName }, 'Successfully pushed changes');
+        return true;
+    }
+    /**
+     * Post a reply to each unresolved review thread.
+     *
+     * SC-006: Never resolves threads — that's left to the human reviewer.
+     * FR-007: Partial failure is acceptable: if some replies fail, log warnings but continue.
+     *         The handler will still remove the label even if some replies fail.
+     */
+    async replyToThreads(github, owner, repo, prNumber, comments) {
+        this.logger.info({ prNumber, threadCount: comments.length }, 'Posting replies to review threads');
+        let successCount = 0;
+        let failureCount = 0;
+        for (const comment of comments) {
+            try {
+                // SC-006: Only reply, never resolve — human reviewer will resolve after verification
+                const replyBody = `I've addressed this feedback in the latest commit. Please review the changes.`;
+                await github.replyToPRComment(owner, repo, prNumber, comment.id, replyBody);
+                this.logger.debug({ prNumber, commentId: comment.id, path: comment.path, line: comment.line }, 'Posted reply to review thread');
+                successCount++;
+            }
+            catch (error) {
+                // FR-007: Continue processing other threads even if this one fails
+                failureCount++;
+                this.logger.warn({ error: String(error), prNumber, commentId: comment.id, path: comment.path, line: comment.line }, 'Failed to post reply to review thread — continuing with remaining threads');
+            }
+        }
+        if (failureCount > 0) {
+            this.logger.warn({ prNumber, successCount, failureCount, total: comments.length }, 'Some thread replies failed — partial success (acceptable per FR-007)');
+        }
+        else {
+            this.logger.info({ prNumber, successCount, total: comments.length }, 'Successfully posted all thread replies');
+        }
+        // FR-007: Even if all replies fail, we don't throw — the caller will still remove the label
+        // because the code changes were pushed successfully
+    }
+    /**
+     * Remove the `waiting-for:address-pr-feedback` label from the linked issue.
+     */
+    async removeFeedbackLabel(github, owner, repo, issueNumber) {
+        try {
+            await github.removeLabels(owner, repo, issueNumber, ['waiting-for:address-pr-feedback']);
+            this.logger.info({ issueNumber }, 'Removed waiting-for:address-pr-feedback label');
+        }
+        catch (error) {
+            this.logger.warn({ error: String(error), issueNumber }, 'Failed to remove waiting-for:address-pr-feedback label — non-fatal');
+        }
+    }
+}
+//# sourceMappingURL=pr-feedback-handler.js.map

package/dist/worker/pr-feedback-handler.js.map

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

package/dist/worker/pr-linker.d.ts

@@ -0,0 +1,69 @@
+import type { GitHubClient } from '@generacy-ai/workflow-engine';
+import type { PrToIssueLink } from '../types/monitor.js';
+import type { Logger } from './types.js';
+/**
+ * Input subset of a PullRequest needed for linking.
+ * Avoids coupling to the full PullRequest type.
+ */
+export interface PrLinkInput {
+    number: number;
+    body: string;
+    head: {
+        ref: string;
+    };
+}
+/**
+ * Utility class that resolves the link between a pull request and its
+ * orchestrated issue.
+ *
+ * Resolution strategy (first match wins):
+ *   1. Parse closing keywords in the PR body (`Closes #42`, `Fixes #7`, etc.)
+ *   2. Parse the leading issue number from the branch name (`42-feature-name`)
+ *
+ * After a candidate issue number is found, the class verifies that the issue
+ * exists and carries an `agent:*` label (i.e. it is orchestrated). PRs that
+ * are not linked to an orchestrated issue return `null`.
+ */
+export declare class PrLinker {
+    private readonly logger;
+    /**
+     * Closing-keyword pattern (case-insensitive, word-boundary aware).
+     * Matches: close/closes/closed/fix/fixes/fixed/resolve/resolves/resolved #N
+     *
+     * NOTE: We use a function to return a fresh regex each time because
+     * RegExp objects with the `g` flag are stateful (they track `lastIndex`).
+     */
+    private static closingRegex;
+    /**
+     * Branch-name pattern: leading digits followed by a hyphen.
+     * Matches: `42-feature-name` → 42
+     */
+    private static readonly BRANCH_REGEX;
+    constructor(logger: Logger);
+    /**
+     * Extract the first referenced issue number from a PR body using
+     * GitHub closing keywords.
+     *
+     * @returns The issue number, or `null` if no keyword match is found.
+     */
+    parsePrBody(body: string): number | null;
+    /**
+     * Extract an issue number from a branch name of the form `{N}-{description}`.
+     *
+     * @returns The issue number, or `null` if the branch doesn't match.
+     */
+    parseBranchName(branch: string): number | null;
+    /**
+     * Attempt to link a PR to an orchestrated issue.
+     *
+     * Resolution order:
+     *   1. PR body closing keywords  (e.g. `Fixes #42`)
+     *   2. Branch name prefix         (e.g. `42-feature-name`)
+     *
+     * After resolving a candidate, the linked issue is fetched to verify it
+     * exists and carries an `agent:*` label. Returns `null` when no valid
+     * link can be established.
+     */
+    linkPrToIssue(github: GitHubClient, owner: string, repo: string, pr: PrLinkInput): Promise<PrToIssueLink | null>;
+}
+//# sourceMappingURL=pr-linker.d.ts.map

package/dist/worker/pr-linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-linker.d.ts","sourceRoot":"","sources":["../../src/worker/pr-linker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,QAAQ;IAkBP,OAAO,CAAC,QAAQ,CAAC,MAAM;IAjBnC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAa;gBAEpB,MAAM,EAAE,MAAM;IAE3C;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASxC;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAS9C;;;;;;;;;;OAUG;IACG,aAAa,CACjB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,WAAW,GACd,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;CAqDjC"}

package/dist/worker/pr-linker.js

@@ -0,0 +1,108 @@
+/**
+ * Utility class that resolves the link between a pull request and its
+ * orchestrated issue.
+ *
+ * Resolution strategy (first match wins):
+ *   1. Parse closing keywords in the PR body (`Closes #42`, `Fixes #7`, etc.)
+ *   2. Parse the leading issue number from the branch name (`42-feature-name`)
+ *
+ * After a candidate issue number is found, the class verifies that the issue
+ * exists and carries an `agent:*` label (i.e. it is orchestrated). PRs that
+ * are not linked to an orchestrated issue return `null`.
+ */
+export class PrLinker {
+    logger;
+    /**
+     * Closing-keyword pattern (case-insensitive, word-boundary aware).
+     * Matches: close/closes/closed/fix/fixes/fixed/resolve/resolves/resolved #N
+     *
+     * NOTE: We use a function to return a fresh regex each time because
+     * RegExp objects with the `g` flag are stateful (they track `lastIndex`).
+     */
+    static closingRegex() {
+        return /\b(?:close|closes|closed|fix|fixes|fixed|resolve|resolves|resolved)\s#(\d+)/gi;
+    }
+    /**
+     * Branch-name pattern: leading digits followed by a hyphen.
+     * Matches: `42-feature-name` → 42
+     */
+    static BRANCH_REGEX = /^(\d+)-/;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Extract the first referenced issue number from a PR body using
+     * GitHub closing keywords.
+     *
+     * @returns The issue number, or `null` if no keyword match is found.
+     */
+    parsePrBody(body) {
+        if (!body)
+            return null;
+        const match = PrLinker.closingRegex().exec(body);
+        if (!match?.[1])
+            return null;
+        return parseInt(match[1], 10);
+    }
+    /**
+     * Extract an issue number from a branch name of the form `{N}-{description}`.
+     *
+     * @returns The issue number, or `null` if the branch doesn't match.
+     */
+    parseBranchName(branch) {
+        if (!branch)
+            return null;
+        const match = PrLinker.BRANCH_REGEX.exec(branch);
+        if (!match?.[1])
+            return null;
+        return parseInt(match[1], 10);
+    }
+    /**
+     * Attempt to link a PR to an orchestrated issue.
+     *
+     * Resolution order:
+     *   1. PR body closing keywords  (e.g. `Fixes #42`)
+     *   2. Branch name prefix         (e.g. `42-feature-name`)
+     *
+     * After resolving a candidate, the linked issue is fetched to verify it
+     * exists and carries an `agent:*` label. Returns `null` when no valid
+     * link can be established.
+     */
+    async linkPrToIssue(github, owner, repo, pr) {
+        // 1. Try PR body keywords first
+        let issueNumber = this.parsePrBody(pr.body);
+        let linkMethod = 'pr-body';
+        // 2. Fallback to branch name
+        if (issueNumber === null) {
+            issueNumber = this.parseBranchName(pr.head.ref);
+            linkMethod = 'branch-name';
+        }
+        if (issueNumber === null) {
+            this.logger.debug({ prNumber: pr.number, owner, repo }, 'No issue link found in PR body or branch name');
+            return null;
+        }
+        // 3. Verify the issue exists and is orchestrated (has agent:* label)
+        let issueAssignees;
+        try {
+            const issue = await github.getIssue(owner, repo, issueNumber);
+            const isOrchestrated = issue.labels.some((l) => l.name.startsWith('agent:'));
+            issueAssignees = issue.assignees;
+            if (!isOrchestrated) {
+                this.logger.debug({ prNumber: pr.number, issueNumber, owner, repo }, 'Linked issue does not have an agent:* label — skipping non-orchestrated issue');
+                return null;
+            }
+        }
+        catch (error) {
+            this.logger.warn({ prNumber: pr.number, issueNumber, owner, repo, err: error }, 'Failed to fetch linked issue — it may not exist');
+            return null;
+        }
+        this.logger.info({ prNumber: pr.number, issueNumber, linkMethod, owner, repo }, `Linked PR #${pr.number} to issue #${issueNumber} via ${linkMethod}`);
+        return {
+            prNumber: pr.number,
+            issueNumber,
+            linkMethod,
+            assignees: issueAssignees,
+        };
+    }
+}
+//# sourceMappingURL=pr-linker.js.map

package/dist/worker/pr-linker.js.map

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

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

@@ -0,0 +1,61 @@
+import type { GitHubClient } from '@generacy-ai/workflow-engine';
+import type { WorkflowPhase, Logger } from './types.js';
+/**
+ * Manages draft PR creation and git commit/push operations between workflow phases.
+ *
+ * After each phase completes:
+ * 1. Commits any changed files with a phase-specific message
+ * 2. Pushes the branch to the remote
+ * 3. Creates a draft PR (if one doesn't already exist)
+ *
+ * This ensures the PR is created early (after specify) and updated incrementally.
+ */
+export declare class PrManager {
+    private readonly github;
+    private readonly owner;
+    private readonly repo;
+    private readonly issueNumber;
+    private readonly logger;
+    private prUrl;
+    private prNumber;
+    constructor(github: GitHubClient, owner: string, repo: string, issueNumber: number, logger: Logger);
+    /**
+     * Get the current PR URL (if a PR has been created).
+     */
+    getPrUrl(): string | undefined;
+    /**
+     * Commit any changes, push to remote, and ensure a draft PR exists.
+     *
+     * Safe to call after every phase — handles "nothing to commit" and
+     * "PR already exists" gracefully.
+     *
+     * @returns The PR URL if one exists/was created, undefined otherwise.
+     */
+    commitPushAndEnsurePr(phase: WorkflowPhase): Promise<string | undefined>;
+    /**
+     * Commit all changed files and push to the remote.
+     *
+     * Handles "nothing to commit" gracefully by checking git status first.
+     */
+    private commitAndPush;
+    /**
+     * Ensure a draft PR exists for the current branch.
+     *
+     * On first call: creates a new draft PR linked to the issue.
+     * On subsequent calls: returns the existing PR URL (no-op).
+     *
+     * @returns The PR URL, or undefined if creation failed.
+     */
+    private ensureDraftPr;
+    /**
+     * Mark the draft PR as ready for review.
+     *
+     * Should be called after the workflow completes successfully (all phases done).
+     * If no PR exists or the PR number is unknown, this is a no-op.
+     *
+     * The underlying GitHub API call is idempotent — calling it on a non-draft PR
+     * has no effect.
+     */
+    markReadyForReview(): Promise<void>;
+}
+//# sourceMappingURL=pr-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pr-manager.d.ts","sourceRoot":"","sources":["../../src/worker/pr-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;;;;;;;;;GASG;AACH,qBAAa,SAAS;IAKlB,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;IARzB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,QAAQ,CAAqB;gBAGlB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM;IAGjC;;OAEG;IACH,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B;;;;;;;OAOG;IACG,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK9E;;;;OAIG;YACW,aAAa;IAoC3B;;;;;;;OAOG;YACW,aAAa;IAkD3B;;;;;;;;OAQG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB1C"}