a66bd91721
- Add setup_forge() to bin/disinto: provisions Forgejo via Docker, creates admin + bot users (dev-bot, review-bot), generates API tokens, creates repo, and pushes code — all automated - Rename env vars: CODEBERG_TOKEN→FORGE_TOKEN, REVIEW_BOT_TOKEN→ FORGE_REVIEW_TOKEN, CODEBERG_REPO→FORGE_REPO, CODEBERG_API→ FORGE_API, CODEBERG_WEB→FORGE_WEB, CODEBERG_BOT_USERNAMES→ FORGE_BOT_USERNAMES (with backwards-compat fallbacks) - Rename API helpers: codeberg_api()→forge_api(), codeberg_api_all() →forge_api_all() (with compat aliases) - Add forge_url field to project TOML; load-project.sh derives FORGE_API/FORGE_WEB from forge_url + repo - Update parse_repo_slug() to accept any host URL, not just codeberg - Forgejo data stored under ~/.disinto/forgejo/ (not in factory repo) - Update all 58 files: agent scripts, formulas, docs, site HTML Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
32 lines
2.1 KiB
Markdown
32 lines
2.1 KiB
Markdown
<!-- last-reviewed: eb7e24cb1df028c6061f47ddfdf9b4ebec33e1cf -->
|
|
# Dev Agent
|
|
|
|
**Role**: Implement issues autonomously — write code, push branches, address
|
|
CI failures and review feedback.
|
|
|
|
**Trigger**: `dev-poll.sh` runs every 10 min via cron. It performs a direct-merge
|
|
scan first (approved + CI green PRs — including chore/gardener PRs without issue
|
|
numbers), then checks the agent lock and scans for ready issues using a two-tier
|
|
priority queue: (1) `priority`+`backlog` issues first (FIFO within tier), then
|
|
(2) plain `backlog` issues (FIFO). Orphaned in-progress issues are also picked up.
|
|
The direct-merge scan runs before the lock check so approved PRs get merged even
|
|
while a dev-agent session is active on another issue.
|
|
|
|
**Key files**:
|
|
- `dev/dev-poll.sh` — Cron scheduler: finds next ready issue, handles merge/rebase of approved PRs, tracks CI fix attempts
|
|
- `dev/dev-agent.sh` — Orchestrator: claims issue, creates worktree + tmux session with interactive `claude`, monitors phase file, injects CI results and review feedback, merges on approval
|
|
- `dev/phase-handler.sh` — Phase callback functions: `post_refusal_comment()`, `_on_phase_change()`, `build_phase_protocol_prompt()`. `do_merge()` detects already-merged PRs on HTTP 405 (race with dev-poll's pre-lock scan) and returns success instead of escalating
|
|
- `dev/phase-test.sh` — Integration test for the phase protocol
|
|
|
|
**Environment variables consumed** (via `lib/env.sh` + project TOML):
|
|
- `FORGE_TOKEN` — Dev-agent token (push, PR creation, merge) — use the dedicated bot account
|
|
- `FORGE_REPO`, `FORGE_API` — Target repository
|
|
- `PROJECT_NAME`, `PROJECT_REPO_ROOT` — Local checkout path
|
|
- `PRIMARY_BRANCH` — Branch to merge into (e.g. `main`, `master`)
|
|
- `WOODPECKER_REPO_ID` — CI pipeline lookups
|
|
- `CLAUDE_TIMEOUT` — Max seconds for a Claude session (default 7200)
|
|
- `MATRIX_TOKEN`, `MATRIX_ROOM_ID`, `MATRIX_HOMESERVER` — Notifications (optional)
|
|
|
|
**Lifecycle**: dev-poll.sh → dev-agent.sh → create Matrix thread + export
|
|
`MATRIX_THREAD_ID` (streams Claude output to thread via Stop hook) → tmux
|
|
`dev-{project}-{issue}` → phase file drives CI/review loop → merge → close issue.
|