Skip to content

audit — AgentTeamsModule

Post-generation audit for agent team files.

Performs two types of checks after the emit phase: static structural checks (conflict detection and presupposition validation, always available) and AI-powered review via the standalone copilot CLI (optional, requires authentication).

Source: agentteams/audit.py

Classes

AuditFinding

Source: agentteams/audit.py

A single audit finding.

Attributes:

  • category (str) — 'CONFLICT', 'PRESUPPOSITION', or 'WARNING'.
  • code (str) — Short machine-readable code (e.g., 'AR_UNRESOLVED_PLACEHOLDER').
  • severity (str) — 'error', 'warning', or 'info'.
  • file (str) — Relative path or '(team)' for team-level findings.
  • description (str) — Human-readable description of the finding.

AuditResult

Source: agentteams/audit.py

Aggregated result of a post-generation audit.

Attributes:

  • static_findings (list[AuditFinding]) — Findings from static structural checks.
  • agent_refactor_findings (list[AuditFinding]) — Findings from agent-refactor checks (CH-14 inline data, etc.).
  • code_hygiene_findings (list[AuditFinding]) — Findings from code hygiene checks (CH-20 contradictions, etc.).
  • ai_report (str | None) — Raw text of the AI-powered audit report, or None if not run.
  • ai_available (bool) — True if the copilot CLI was detected and available.

Properties:

  • has_errors (bool) — True if any finding across all phases has severity 'error'.
  • has_warnings (bool) — True if any finding across all phases has severity 'warning'.
  • is_clean (bool) — True if all phases are clean and AI audit (if run) reported no issues.

Functions

run_post_audit(output_dir, manifest, *, run_ai=True)

Source: agentteams/audit.py

Run a post-generation audit on the agent files in output_dir.

Args:

  • output_dir (Path) — Path to the .github/agents/ directory.
  • manifest (dict[str, Any]) — Team manifest from analyze.build_manifest().
  • run_ai (bool, keyword-only) — If True and copilot CLI is available, run the AI-powered review. Default: True.

Returns: AuditResult

Source: agentteams/audit.py

Print a human-readable audit report to stdout.

Args:

  • result (AuditResult) — Result from run_post_audit().