usecase-flows

Use case flows (schematic)

Entry point: mainRun(execution) in src/actions/common_action.ts. After execution.setup() and optionally waitForPreviousRuns, the dispatch is:

mainRun
├── runnedByToken && singleAction → SingleActionUseCase (only if validSingleAction)
├── issueNumber === -1 → SingleActionUseCase (only if isSingleActionWithoutIssue) or skip
├── welcome → log boxen and continue
└── try:
    ├── isSingleAction        → SingleActionUseCase
    ├── isIssue                → issue.isIssueComment ? IssueCommentUseCase : IssueUseCase
    ├── isPullRequest          → pullRequest.isPullRequestReviewComment ? PullRequestReviewCommentUseCase : PullRequestUseCase
    ├── isPush                 → CommitUseCase
    └── else                   → core.setFailed

---

1. IssueUseCase (on: issues, not a comment)

Step order:

1. CheckPermissionsUseCase → if it fails (not allowed): CloseNotAllowedIssueUseCase and return.
2. RemoveIssueBranchesUseCase (only if cleanIssueBranches).
3. AssignMemberToIssueUseCase
4. UpdateTitleUseCase
5. UpdateIssueTypeUseCase
6. LinkIssueProjectUseCase
7. CheckPriorityIssueSizeUseCase
8. PrepareBranchesUseCase (if isBranched) or RemoveIssueBranchesUseCase (if not).
9. RemoveNotNeededBranchesUseCase
10. DeployAddedUseCase (deploy label)
11. DeployedAddedUseCase (deployed label)
12. If issue.opened:
    • If not release and not question/help → RecommendStepsUseCase
    • If question or help → AnswerIssueHelpUseCase

---

2. IssueCommentUseCase (on: issue_comment)

Step order:

1. CheckIssueCommentLanguageUseCase (translation)
2. DetectBugbotFixIntentUseCase → payload: isFixRequest, isDoRequest, targetFindingIds, context, branchOverride
3. ProjectRepository.isActorAllowedToModifyFiles(owner, actor, token) (permission to modify files)
4. Branch A – if runAutofix && allowed:
   • BugbotAutofixUseCase → runBugbotAutofixCommitAndPush → if committed: markFindingsResolved
5. Branch B – if !runAutofix && canRunDoUserRequest && allowed:
   • DoUserRequestUseCase → runUserRequestCommitAndPush
6. If no file-modifying action ran → ThinkUseCase