openhands 149211c78d chore: gardener housekeeping 2026-03-23

- 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>

2026-03-23 00:23:02 +00:00

2.2 KiB

Raw Blame History

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):

CODEBERG_TOKEN — Dev-agent token (push, PR creation, merge) — use the dedicated bot account
CODEBERG_REPO, CODEBERG_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.

2.2 KiB Raw Blame History

Dev Agent

2.2 KiB

Raw Blame History