feature-296-bugbot-autofix: Add support for configurable verify commands after autofix, enhance bugbot context loading, and improve documentation for bugbot autofix functionality.

Author: efraespada

.cursor/rules/architecture.mdc

@@ -29,6 +29,7 @@ alwaysApply: true
 | Steps (commit) | `src/usecase/steps/commit/` | notify commit, check size |
 | Steps (issue comment) | `src/usecase/steps/issue_comment/` | check_issue_comment_language (translation) |
 | Steps (PR review comment) | `src/usecase/steps/pull_request_review_comment/` | check_pull_request_comment_language (translation) |
+| Bugbot autofix | `src/usecase/steps/commit/bugbot/` | detect_bugbot_fix_intent_use_case (OpenCode decides if user asks to fix findings), bugbot_autofix_use_case (build agent applies fixes), bugbot_autofix_commit (verify + git commit/push). Intent via OpenCode plan agent; fix via build agent; no diff API. |
 | Manager (content) | `src/manager/` | description handlers, configuration_handler, markdown_content_hotfix_handler (PR description, hotfix changelog content) |
 | Models | `src/data/model/` | Execution, Issue, PullRequest, SingleAction, etc. |
 | Repos | `src/data/repository/` | branch_repository, issue_repository, workflow_repository, ai_repository (OpenCode), file_repository, project_repository |

.github/workflows/copilot_issue_comment.yml

@@ -8,6 +8,8 @@ jobs:
   copilot-issues:
     name: Copilot - Issue Comment
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v4
@@ -19,3 +21,4 @@ jobs:
           opencode-model: ${{ vars.OPENCODE_MODEL }}
           project-ids: ${{ vars.PROJECT_IDS }}
           token: ${{ secrets.PAT }}
+          bugbot-fix-verify-commands: ${{ vars.BUGBOT_AUTOFIX_VERIFY_COMMANDS }}

.github/workflows/copilot_pull_request_comment.yml

@@ -8,6 +8,8 @@ jobs:
   copilot-pull-requests:
     name: Copilot - Pull Request Comment
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v4
@@ -19,4 +21,4 @@ jobs:
           opencode-model: ${{ vars.OPENCODE_MODEL }}
           project-ids: ${{ vars.PROJECT_IDS }}
           token: ${{ secrets.PAT }}
-
+          bugbot-fix-verify-commands: ${{ vars.BUGBOT_AUTOFIX_VERIFY_COMMANDS }}

action.yml

@@ -417,6 +417,9 @@ inputs:
   bugbot-comment-limit:
     description: "Maximum number of potential-problem findings to publish as individual comments on the issue and PR. Extra findings are summarized in a single overflow comment."
     default: "20"
+  bugbot-fix-verify-commands:
+    description: "Comma-separated commands to run after bugbot autofix (e.g. npm run build, npm test, npm run lint). OpenCode runs these in its workspace; the runner can re-run them before commit. If empty, only OpenCode's run is used."
+    default: ""
 runs:
   using: "node20"
   main: "build/github_action/index.js"

build/cli/index.js

@@ -12,7 +12,8 @@ export declare class Ai {
     private aiIncludeReasoning;
     private bugbotMinSeverity;
     private bugbotCommentLimit;
-    constructor(opencodeServerUrl: string, opencodeModel: string, aiPullRequestDescription: boolean, aiMembersOnly: boolean, aiIgnoreFiles: string[], aiIncludeReasoning: boolean, bugbotMinSeverity: string, bugbotCommentLimit: number);
+    private bugbotFixVerifyCommands;
+    constructor(opencodeServerUrl: string, opencodeModel: string, aiPullRequestDescription: boolean, aiMembersOnly: boolean, aiIgnoreFiles: string[], aiIncludeReasoning: boolean, bugbotMinSeverity: string, bugbotCommentLimit: number, bugbotFixVerifyCommands?: string[]);
     getOpencodeServerUrl(): string;
     getOpencodeModel(): string;
     getAiPullRequestDescription(): boolean;
@@ -21,6 +22,7 @@ export declare class Ai {
     getAiIncludeReasoning(): boolean;
     getBugbotMinSeverity(): string;
     getBugbotCommentLimit(): number;
+    getBugbotFixVerifyCommands(): string[];
     /**
      * Parse "provider/model-id" into { providerID, modelID } for OpenCode session.prompt.
      * Uses OPENCODE_DEFAULT_MODEL when no model is set (e.g. opencode/kimi-k2.5-free).

build/cli/src/data/model/ai.d.ts

@@ -23,5 +23,7 @@ export declare class PullRequest {
     get commentBody(): string;
     get commentAuthor(): string;
     get commentUrl(): string;
+    /** When the comment is a reply, the id of the parent review comment (for bugbot: include parent body in intent prompt). */
+    get commentInReplyToId(): number | undefined;
     constructor(desiredAssigneesCount: number, desiredReviewersCount: number, mergeTimeout: number, inputs?: any | undefined);
 }

build/cli/src/data/model/pull_request.d.ts

@@ -4,6 +4,12 @@ export declare class PullRequestRepository {
      * Used to sync size/progress labels from the issue to PRs when they are updated on push.
      */
     getOpenPullRequestNumbersByHeadBranch: (owner: string, repository: string, headBranch: string, token: string) => Promise<number[]>;
+    /**
+     * Returns the head branch of the first open PR that references the given issue number
+     * (e.g. body contains "#123" or head ref contains "123" as in feature/123-...).
+     * Used for issue_comment events where commit.branch is empty.
+     */
+    getHeadBranchForIssue: (owner: string, repository: string, issueNumber: number, token: string) => Promise<string | undefined>;
     isLinked: (pullRequestUrl: string) => Promise<boolean>;
     updateBaseBranch: (owner: string, repository: string, pullRequestNumber: number, branch: string, token: string) => Promise<void>;
     updateDescription: (owner: string, repository: string, pullRequestNumber: number, description: string, token: string) => Promise<void>;
@@ -48,6 +54,11 @@ export declare class PullRequestRepository {
         line?: number;
         node_id?: string;
     }>>;
+    /**
+     * Fetches a single PR review comment by id (e.g. parent comment when user replied in thread).
+     * Returns the comment body or null if not found.
+     */
+    getPullRequestReviewCommentBody: (owner: string, repository: string, _pullNumber: number, commentId: number, token: string) => Promise<string | null>;
     /**
      * Resolve a PR review thread (GraphQL only). Finds the thread that contains the given comment and marks it resolved.
      * Uses repository.pullRequest.reviewThreads because the field pullRequestReviewThread on PullRequestReviewComment was removed from the API.

build/cli/src/data/repository/pull_request_repository.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Unit tests for buildBugbotFixIntentPrompt.
+ */
+export {};

build/cli/src/usecase/steps/commit/bugbot/__tests__/build_bugbot_fix_intent_prompt.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Unit tests for buildBugbotFixPrompt.
+ */
+export {};