Remove all Matrix/Dendrite infrastructure: - Delete lib/matrix_listener.sh (long-poll daemon), lib/matrix_listener.service (systemd unit), lib/hooks/on-stop-matrix.sh (response streaming hook) - Remove matrix_send() and matrix_send_ctx() from lib/env.sh - Remove MATRIX_HOMESERVER auto-detection, MATRIX_THREAD_MAP from lib/env.sh - Remove [matrix] section parsing from lib/load-project.sh - Remove Matrix hook installation from lib/agent-session.sh - Remove notify/notify_ctx helpers and Matrix thread tracking from dev/dev-agent.sh and action/action-agent.sh - Remove all matrix_send calls from dev-poll.sh, phase-handler.sh, action-poll.sh, vault-poll.sh, vault-fire.sh, vault-reject.sh, review-poll.sh, review-pr.sh, supervisor-poll.sh, formula-session.sh - Remove Matrix listener startup from docker/agents/entrypoint.sh - Remove append_dendrite_compose() and setup_matrix() from bin/disinto - Remove --matrix flag from disinto init - Clean Matrix references from .env.example, projects/*.toml.example, formulas/*.toml, AGENTS.md, BOOTSTRAP.md, README.md, RESOURCES.md, PHASE-PROTOCOL.md, and all agent AGENTS.md/PROMPT.md files Status visibility now via Codeberg PR/issue activity. Human interaction via vault items through forge. Proactive alerts via OpenClaw heartbeats. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.6 KiB
Gardener Agent
Role: Backlog grooming — detect duplicate issues, missing acceptance
criteria, oversized issues, stale issues, and circular dependencies. Enforces
the quality gate: strips the backlog label from issues that lack acceptance
criteria checkboxes (- [ ]) or an ## Affected files section. Invokes
Claude to fix what it can; files vault items for what it cannot.
Trigger: gardener-run.sh runs 4x/day via cron. Sources lib/guard.sh and
calls check_active gardener first — skips if $FACTORY_ROOT/state/.gardener-active
is absent. Then creates a tmux session with claude --model sonnet, injects
formulas/run-gardener.toml as context, monitors the phase file, and cleans up
on completion or timeout (2h max session). No action issues — the gardener runs
directly from cron like the planner, predictor, and supervisor.
Key files:
gardener/gardener-run.sh— Cron wrapper + orchestrator: lock, memory guard, sources disinto project config, creates tmux session, injects formula prompt, monitors phase file via custom_gardener_on_phase_changecallback (passed torun_formula_and_monitor). Stays alive through CI/review/merge cycle afterPHASE:awaiting_ci— injects CI results and review feedback, re-signalsPHASE:awaiting_ciafter fixes, signalsPHASE:awaiting_reviewon CI pass. Executes pending-actions manifest after PR merge.formulas/run-gardener.toml— Execution spec: preflight, grooming, dust-bundling, blocked-review, agents-update, commit-and-prgardener/pending-actions.json— Manifest of deferred repo actions (label changes, closures, comments, issue creation). Written during grooming steps, committed to the PR, reviewed alongside AGENTS.md changes, executed by gardener-run.sh after merge.
Environment variables consumed:
FORGE_TOKEN,FORGE_REPO,FORGE_API,PROJECT_NAME,PROJECT_REPO_ROOTPRIMARY_BRANCH,CLAUDE_MODEL(set to sonnet by gardener-run.sh)
Lifecycle: gardener-run.sh (cron 0,6,12,18) → check_active gardener → lock + memory guard →
load formula + context → create tmux session →
Claude grooms backlog (writes proposed actions to manifest), bundles dust,
reviews blocked issues, updates AGENTS.md, commits manifest + docs to PR →
PHASE:awaiting_ci (stays alive) → CI pass → PHASE:awaiting_review →
review feedback → address + re-signal → merge → gardener-run.sh executes
manifest actions via API → PHASE:done. When blocked on external resources
or human decisions, files a vault item instead of escalating.