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

Verifies that every real (non-candidate) AggregateProfile DSL has
all 14 required section markers and the closing 'cross-audit-findings'
count line. That's it.

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_SECTIONS: 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",
)


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
 aggregates_dir = input_dir / "aggregates"
 if not aggregates_dir.exists():
  print(f"ERROR: aggregates dir does not exist: {aggregates_dir}")
  return 1
 violations: list[str] = []
 files_checked = 0
 for dsl_path in sorted(aggregates_dir.glob("*.dsl")):
  content = dsl_path.read_text(encoding="utf-8")
  if " true is-candidate" in content:
   continue
  files_checked += 1
  for section in REQUIRED_SECTIONS:
   marker_prefix = f"\\ === {section}"
   if marker_prefix not in content:
    violations.append(f"{dsl_path.name}: missing section '{section}'")
  if " cross-audit-findings" not in content:
   violations.append(f"{dsl_path.name}: missing 'N cross-audit-findings' count line")
 if violations:
  print(f"Meta-audit: {len(violations)} violations ({files_checked} real profiles checked)")
  for v in violations:
   print(f" - {v}")
  if args.strict:
   return 1
  return 0
 print(f"Meta-audit: 0 violations ({files_checked} real profiles checked)")
 return 0


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