149211c78d
- dev/AGENTS.md: document two-tier priority queue (priority+backlog first, then plain backlog); note do_merge() HTTP 405 already-merged detection - gardener/AGENTS.md: document merge-through protocol (stay alive through CI/review/merge); note session kill on PHASE:escalate - lib/AGENTS.md: add ensure_priority_label() to ci-helpers.sh entry; document optional CALLBACK param in run_formula_and_monitor() - predictor/AGENTS.md: update watermark (content already current from v2 PR) - Update watermarks for action, planner, review, supervisor, vault, root Grooming actions: - #574: added ## Affected files section (lib/parse-deps.sh) to meet quality gate - #568: escalated — needs human decision on guard/merge architecture - #466: escalated — dep #393 closed; needs decision on external vs in-repo example Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
<!-- last-reviewed: c9bf9fe5281c4037fd3f2219fde093dcbb053e00 -->
|
|
# Review Agent
|
|
|
|
**Role**: AI-powered PR review — post structured findings and formal
|
|
approve/request-changes verdicts to Codeberg.
|
|
|
|
**Trigger**: `review-poll.sh` runs every 10 min via cron. It scans open PRs
|
|
whose CI has passed and that lack a review for the current HEAD SHA, then
|
|
spawns `review-pr.sh <pr-number>`.
|
|
|
|
**Key files**:
|
|
- `review/review-poll.sh` — Cron scheduler: finds unreviewed PRs with passing CI
|
|
- `review/review-pr.sh` — Creates/reuses a tmux session (`review-{project}-{pr}`), injects PR diff, waits for Claude to write structured JSON output, posts markdown review + formal Codeberg review, auto-creates follow-up issues for pre-existing tech debt
|
|
|
|
**Environment variables consumed**:
|
|
- `CODEBERG_TOKEN` — Dev-agent token (must not be the same account as REVIEW_BOT_TOKEN)
|
|
- `REVIEW_BOT_TOKEN` — Review-agent token for approvals (use human/admin account; branch protection: in approvals whitelist)
|
|
- `CODEBERG_REPO`, `CODEBERG_API`, `PROJECT_NAME`, `PROJECT_REPO_ROOT`
|
|
- `PRIMARY_BRANCH`, `WOODPECKER_REPO_ID`
|
|
- `MATRIX_TOKEN`, `MATRIX_ROOM_ID`, `MATRIX_HOMESERVER`
|