Skip to content

Release Prep

Reference

Release-prep's public surface is the ReleasePrepTeamWorkflow (CLI / registry adapter) and the ReleasePrepTeam coordinator, both importable from attune.agents.release.

ReleasePrepTeamWorkflowattune.agents.release

Symbol Purpose
ReleasePrepTeamWorkflow(quality_gates=None, **kwargs) Construct the registry adapter. quality_gates overrides thresholds.
ReleasePrepTeamWorkflow.execute(path=".", context=None, **kwargs) Async. Run the gate. Maps targetpath for CLI/VSCode. Returns a WorkflowResult.
ReleasePrepTeamWorkflow.name The canonical slug, "release-prep" (synonym release-gate).
ReleasePrepTeamWorkflow.stages ["triage", "parallel-validation", "synthesis", "decision"].

ReleasePrepTeamattune.agents.release

Symbol Purpose
ReleasePrepTeam(quality_gates=None, redis_url=None) Construct the coordinator. Optional Redis URL for coordination (graceful no-op when unavailable).
ReleasePrepTeam.assess_readiness(codebase_path=".") Async. Run the four agents in parallel and return a ReleaseReadinessReport.
ReleasePrepTeam.get_total_cost() Total LLM cost across agents ($0 in the default rule-based mode).

Default quality gates

Gate Key Default Critical
Security max_critical_issues 0 Yes
Test Coverage min_coverage 80.0 Yes
Code Quality min_quality_score 7.0 Yes
Documentation min_doc_coverage 80.0 No

The four agents

Agent Tool Score basis
SecurityAuditorAgent bandit (JSON, severity ≥ medium) Severity-weighted; critical_issues = CRITICAL + HIGH.
TestCoverageAgent pytest collect + pytest --cov TOTAL coverage %; heuristic estimate as fallback.
CodeQualityAgent ruff check --statistics 0–10 by violation count.
DocumentationAgent AST docstring walk Public-function docstring coverage %.

WorkflowResult fields read after a run

Field Type Meaning
success bool Whether the assessment ran (always True on a completed run — not the verdict).
final_output dict The serialized WorkflowReport (verdict callout, gate table, per-agent breakdown, blockers, warnings, next steps).
summary str Executive summary — approval status and the failed gates.
metadata dict approved (bool) and confidence (high / medium / low).

Entry points

Surface Invocation
CLI attune workflow run release-gate [--path <p>] [--json] (canonical slug release-prep).
Python await ReleasePrepTeamWorkflow().execute(path=<p>) or await ReleasePrepTeam().assess_readiness(codebase_path=<p>).

There is no MCP tool for the gate — it is CLI / Python only.