Files
cleveragents-core/.opencode/opencode.json
T
drew 016b348117 feat(controller): grooming gate (Phase 0 + Phase 1 worker-shape dispatch)
Phase 0 (foundation):
- Cause enum (controller_events.cause) for action attribution
- Schema: grooming_decisions audit table; workflows gains
  grooming_evaluated_at + deferred_reason + deferred_at +
  deferred_target_workflow_id; pulls gains touched_files
- audit_comments: CLOSE / DEFER templates + render_comment_template
- forgejo_writes: close_issue + defer_issue 5-step crash-safe protocol
  (fingerprint dedup, error matrix, dry-run)
- patch_pr_state callback in forgejo_http
- grooming_config: 22-env-var frozen-dataclass config + log_effective
- pulls.touched_files cache extension (_pipeline_cache.py schema v8)
- reaper.reap_grooming_decisions audit-retention sweep
- reconciliation RESUME guard (deferred_reason)

Phase 1 (worker-queue shape, 2026-05-25):
- New state: GROOMING. New events: grooming_started, groom_verdict_
  {proceed,defer,close}. 5 new transitions; all invariants still clean
- GroomingInputV1 + GroomingOutputV1 Pydantic contracts
- outcomes._map_grooming_outcome routes verdicts to state-machine events
- prefetch.build_grooming_stage_b_input + list_open_prs callback
- scheduler GROOMING -> grooming_stage_b role
- promote: cfg-gated DISCOVERED -> GROOMING when CONTROLLER_GROOMING_
  ENABLED=true; issues skip grooming
- forgejo_writes decomposed: close_act/defer_act (Forgejo writes only;
  state-machine already transitioned) + close_decide_and_act/
  defer_decide_and_act (Phase 0 callers); _apply_workflow_transition
  is underscore-private
- grooming.py library: tokenization, suspicion scoring (Jaccard +
  weighted overlap), deterministic checks, action -> verdict mapping
- mcp/grooming_builder.py: 14-tool FastMCP server emits GroomingOutputV1
- .opencode/agents/grooming-stage-b.md: duplicate-detection agent
  prompt (claude-haiku-4-5)
- grooming_side_effects.run_grooming_side_effects_tick: per-state tick
  performs Forgejo writes after groom_verdict_{defer,close} fires.
  Filters on event_type='transition' + payload.event (centralizes the
  convention pending Phase 2's latest_transition_event helper)
- GroomingCallbacks frozen dataclass; loop.py + __main__.py wired

Worker role registry (single source of truth):
- worker/roles.py: WORKER_ROLES + WorkerRoleSpec + default_roles_csv
  + output_filename_for. agent_runner.ROLE_TO_MCP_MODULE / ROLE_TO_
  OUTPUT_MODEL derive from it; opencode_session.agent_name_for reads
  it for flat cases; all 6 prompt builders use output_filename_for;
  worker --roles default = default_roles_csv(); launcher script
  derives --roles via shell substitution. Cross-site invariant test
  enforces alignment across 5 sites + opencode.json MCP registry.

Phase 0 silent-bug fix:
- reconciliation.py RESUME guard SELECT now includes deferred_reason
  (was missing since Phase 0; guard was a silent no-op). Tightened
  from getattr to attribute access to fail fast on future omissions.

Tests (1456 total, +91 grooming-specific):
- test_grooming_phase0.py: 34 tests (orchestrator matrix, crash
  recovery, idempotency, dry-run)
- test_grooming_phase1.py: 60 tests (library, contracts, state
  machine, outcomes, scheduler, promote, prefetch, act-variants
  with signature parity, side-effect tick incl. natural-idempotency
  + executed-flag-skip + verdict-mismatch + reconciliation RESUME)
- test_mcp_builders.py TestGroomingBuilder: 29 tests (happy paths
  + 22 validation rules + Pydantic round-trip + master-tick-read-
  path companion)
- test_worker_agent_runner.py TestRoleMaps: cross-role wiring
  alignment + agent-prompt-vs-worker-fallback filename contract +
  inspect.signature equality (close_act/defer_act vs
  close_issue/defer_issue)
- test_state_machine.py: transition count 51 -> 56 +
  events_from_grooming

Live-validated end-to-end on 4 staged sentinel PRs (#55-#58) in
dry_run: agent emits verdicts via MCP, state-machine transitions
fire, side-effect tick writes audit row, deferred_reason gates
reconciliation RESUME correctly.

Deferred refinements + Phase 2 prerequisite (latest_transition_event
helper) tracked in .drew/regressions-plan.md "Phase 1 follow-up
backlog".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-25 15:05:29 -04:00

134 lines
3.7 KiB
JSON

{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"graphify": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"/home/drew/repos/cleveragents-core/tools/mcp_graphify_server.py"
],
"environment": {
"GRAPHIFY_OUT_DIR": "/home/drew/repos/cleveragents-core/graphify-out",
"GRAPHIFY_BIN": "/home/drew/.local/bin/graphify"
}
},
"ci": {
"type": "local",
"enabled": true,
"timeout": 1860000,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"/home/drew/repos/cleveragents-core/tools/mcp_ci_server.py"
],
"environment": {
"CI_GATE_SCRIPT": "/home/drew/repos/cleveragents-core/tools/local_ci_gate.sh"
}
},
"forgejo": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"/home/drew/repos/cleveragents-core/tools/mcp_forgejo_server.py"
]
},
"git": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"/home/drew/repos/cleveragents-core/tools/mcp_git_server.py"
]
},
"handoff": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"/home/drew/repos/cleveragents-core/tools/mcp_handoff_server.py"
]
},
"block_store": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"/home/drew/repos/cleveragents-core/tools/mcp_block_store_server.py"
]
},
"implementer-response-builder": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"-m",
"tools.controller.mcp.implementer_builder"
],
"environment": {
"PYTHONPATH": "/home/drew/repos/cleveragents-core"
}
},
"reviewer-response-builder": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"-m",
"tools.controller.mcp.reviewer_builder"
],
"environment": {
"PYTHONPATH": "/home/drew/repos/cleveragents-core"
}
},
"estimator-response-builder": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"-m",
"tools.controller.mcp.estimator_builder"
],
"environment": {
"PYTHONPATH": "/home/drew/repos/cleveragents-core"
}
},
"conflict-resolver-response-builder": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"-m",
"tools.controller.mcp.conflict_resolver_builder"
],
"environment": {
"PYTHONPATH": "/home/drew/repos/cleveragents-core"
}
},
"summarizer-response-builder": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"-m",
"tools.controller.mcp.summarizer_builder"
],
"environment": {
"PYTHONPATH": "/home/drew/repos/cleveragents-core"
}
},
"grooming-builder": {
"type": "local",
"enabled": true,
"command": [
"/home/drew/repos/cleveragents-core/.venv/bin/python",
"-m",
"tools.controller.mcp.grooming_builder"
],
"environment": {
"PYTHONPATH": "/home/drew/repos/cleveragents-core"
}
}
}
}