Add fire risk QA coverage gate

2026-05-19 12:27:27 -07:00
parent dbb911038a
commit 61548d1153
3 changed files with 131 additions and 1 deletions
@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""Verify fire-risk QA scenarios and supporting gates are documented."""
+
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+QA_DOC = ROOT / "Docs" / "QA" / "FireRiskQACoverage.md"
+ROADMAP = ROOT / "AGRARIAN_DEVELOPMENT_ROADMAP.md"
+
+REQUIRED_SCENARIOS = [
+    "Safe campfire",
+    "Unsafe campfire",
+    "Vegetation spread",
+    "Shelter ignition",
+    "Suppression",
+    "Save/load recovery",
+]
+
+REQUIRED_SCRIPTS = [
+    "verify_unattended_fire_risk.py",
+    "verify_vegetation_ignition_checks.py",
+    "verify_structure_ignition_risk.py",
+    "verify_fire_spread_rules.py",
+    "verify_fire_maintenance_gameplay.py",
+    "verify_fire_suppression_hooks.py",
+    "verify_fire_persistence_state.py",
+    "verify_fire_risk_qa_coverage.py",
+]
+
+
+def main() -> None:
+    doc = QA_DOC.read_text(encoding="utf-8")
+    roadmap = ROADMAP.read_text(encoding="utf-8")
+
+    missing = []
+    for scenario in REQUIRED_SCENARIOS:
+        if scenario not in doc:
+            missing.append(f"QA doc missing scenario {scenario!r}")
+
+    for script in REQUIRED_SCRIPTS:
+        if script not in doc:
+            missing.append(f"QA doc missing script {script!r}")
+        if not (ROOT / "Scripts" / script).exists():
+            missing.append(f"required script does not exist: Scripts/{script}")
+
+    for token in [
+        "`FireRiskScore`",
+        "StructureIgnitionRiskScore",
+        "suppression pressure",
+        "spread radius",
+        "server",
+    ]:
+        if token not in doc:
+            missing.append(f"QA doc missing token {token!r}")
+
+    if "[x] Add QA coverage for safe campfires" not in roadmap:
+        missing.append("roadmap item is not checked off")
+
+    if missing:
+        raise SystemExit("FAILED: " + "; ".join(missing))
+
+    print("OK: fire-risk QA coverage is documented and tied to verifiers.")
+
+
+if __name__ == "__main__":
+    main()