nexus-engine

End-to-end PR loop. Opens PR, waits CI, waits CodeRabbit, triages, fixes, replies, resolves, re-runs CI, merges. The mastermind invokes this and walks away. Triggers: babysit pr, drive pr, ship pr end to end.

Branch naming, base branch, draft policy, auto-merge policy, force-push policy. Short, table-driven. Triggers: branch naming, branch policy, where to branch from.

When and how to evolve .coderabbit.yaml — enable new tools, switch profile, add path-instructions for new doc subtrees, tune tone. Triggers: update coderabbit config, tune cr, edit coderabbit yaml.

Post threaded replies to CodeRabbit review threads via GraphQL addPullRequestReviewThreadReply (or REST fallback). For wrong/opinion threads include principle citation. Triggers: reply coderabbit, post cr reply.

Mark review threads resolved via GraphQL resolveReviewThread mutation. Paginated, dry-run, batch. REST cannot do this. Triggers: resolve cr threads, mark resolved, close review threads.

Fetch all coderabbitai[bot] review threads via GraphQL, classify each (bug/nit/suggestion/opinion/wrong), emit accept/reject/discuss plan. Triggers: triage coderabbit, classify cr comments, cr plan.

For each accepted CR thread, locate file, route to right subagent, apply fix, build, run scoped tests, push, then resolve threads. Triggers: fix cr, apply coderabbit, address review comments.

Reusable gh api graphql snippets — list PR threads, list bot comments, resolve thread, add reply, enable auto-merge, request reviewer, dismiss review. Single source of truth for other skills. Triggers: graphql gh, gh api recipes, github graphql.

Open a PR from current branch with conventional-commits title, spec/contract refs, scenario tests, benchmark deltas. Marks draft until CI green. Triggers: open pr, create pr, ship branch, gh pr create.

Generate CHANGELOG.md entry for merged PR from Conventional Commits title. Spec reference required. Keep-a-Changelog format. Triggers: changelog, generate changelog, release note.

Squash-merge with conventional commit message, delete branch, post release-note line. Refuses if any CR thread unresolved or any law violation. Triggers: merge pr, land pr, squash merge.

Rebase PR branch on main when CI fails on stale base or main moves. Conflict heuristics. Force-push. Restart wait-for-ci. Triggers: rebase pr, recover ci, fix stale branch.

CodeRabbit chat-command cheat sheet — when to invoke @coderabbitai resolve/pause/ignore/summary/full review. Triggers: cr command, coderabbit command, talk to coderabbit.

Poll gh pr checks --watch until all required checks finish. Distinguishes required vs optional, handles flaky reruns, enforces timeout. Triggers: wait for ci, watch checks, ci status.

Block until coderabbitai[bot] posts its review on a PR. Detects in-progress vs complete markers. Retriggers via @coderabbitai review if missing past threshold. Triggers: wait for coderabbit, wait cr, cr review status.