"""Meta-audit for src.code_path_audit v2 output schema.

Verifies that every AggregateProfile produced by the v2 audit
has all 14 required top-level fields, that the
cross_audit_findings has 5 audit scripts, that the
decomposition_cost has the 8 fields, etc. The convention: any
new audit must have a corresponding schema-validator script.

Usage:
 uv run python scripts/audit_code_path_audit_coverage.py
 uv run python scripts/audit_code_path_audit_coverage.py --strict
"""
from __future__ import annotations
import argparse
import sys
from pathlib import Path

REQUIRED_PROFILE_FIELDS: tuple[str, ...] = (
 "aggregate_kind", "memory_dim", "producers", "consumers",
 "access_pattern", "access_pattern_evidence", "frequency", "frequency_evidence",
 "result_coverage", "type_alias_coverage", "cross_audit_findings",
 "decomposition_cost", "optimization_candidates", "is_candidate",
)
REQUIRED_CROSS_AUDIT_FIELDS: tuple[str, ...] = (
 "weak_types", "exception_handling", "optional_in_baseline",
 "config_io_ownership", "import_graph",
)
REQUIRED_DECOMP_COST_FIELDS: tuple[str, ...] = (
 "current_cost_estimate", "componentize_savings", "unify_savings",
 "recommended_direction", "recommended_rationale", "batch_size",
 "struct_field_count", "struct_frozen",
)

def main() -> int:
 parser = argparse.ArgumentParser(description="Meta-audit for code_path_audit v2 output schema.")
 parser.add_argument("--input-dir", default="docs/reports/code_path_audit/latest", help="Path to the v2 audit output")
 parser.add_argument("--strict", action="store_true", help="Exit 1 on any violation")
 args = parser.parse_args()
 input_dir = Path(args.input_dir)
 if not input_dir.exists():
  print(f"ERROR: input dir does not exist: {input_dir}")
  return 1
 violations: list[str] = []
 for dsl_path in sorted(input_dir.glob("aggregates/*.dsl")):
  content = dsl_path.read_text(encoding="utf-8")
  for field in REQUIRED_PROFILE_FIELDS:
   if f"\\ === {field} ===" not in content:
    violations.append(f"{dsl_path.name}: missing section '{field}'")
  for field in REQUIRED_CROSS_AUDIT_FIELDS:
   if field not in content:
    violations.append(f"{dsl_path.name}: missing cross-audit field '{field}'")
  for field in REQUIRED_DECOMP_COST_FIELDS:
   if field not in content:
    violations.append(f"{dsl_path.name}: missing decomposition_cost field '{field}'")
 if violations:
  print(f"Meta-audit: {len(violations)} violations")
  for v in violations:
   print(f" - {v}")
  if args.strict:
   return 1
  return 0
 print("Meta-audit: 0 violations")
 return 0

if __name__ == "__main__":
 sys.exit(main())