test(observability): add deploy gate self-test

scripts/check_observability_deploy_gate.py

@@ -30,6 +30,30 @@ TRIGGER_PATTERNS = (
     r"^docs/guides/deployment_sop\.md$",
 )
 
+SELF_TEST_POSITIVE = (
+    "templates/admin/business_intel.html",
+    "templates/ewoooc_base.html",
+    "templates/components/_ewoooc_shell.html",
+    "static/css/observability-system.css",
+    "web/static/css/observability-system.css",
+    "routes/admin_observability_routes.py",
+    "scripts/check_observability_ui.py",
+    "scripts/check_observability_pages.py",
+    "scripts/check_observability_suite.sh",
+    "scripts/observability_contract.py",
+    "scripts/quick_review.sh",
+    "scripts/sync_observability_css.py",
+    "docs/guides/observability_ui_governance.md",
+    "docs/guides/deployment_sop.md",
+)
+
+SELF_TEST_NEGATIVE = (
+    "services/pricing_service.py",
+    "docs/memory/history_logs.md",
+    "README.md",
+    "migrations/099_example.sql",
+)
+
 
 def normalize_paths(raw_paths: list[str]) -> list[str]:
     paths: list[str] = []
@@ -54,10 +78,39 @@ def write_output(output_path: str | None, needed: bool) -> None:
         handle.write(f"needed={'true' if needed else 'false'}\n")
 
 
+def run_self_test() -> int:
+    positive_misses = [
+        path for path in SELF_TEST_POSITIVE
+        if path not in match_paths([path])
+    ]
+    negative_false_positives = [
+        path for path in SELF_TEST_NEGATIVE
+        if path in match_paths([path])
+    ]
+
+    if positive_misses or negative_false_positives:
+        print("observability_deploy_gate_self_test=FAIL")
+        if positive_misses:
+            print("positive_misses:")
+            for path in positive_misses:
+                print(f"- {path}")
+        if negative_false_positives:
+            print("negative_false_positives:")
+            for path in negative_false_positives:
+                print(f"- {path}")
+        return 1
+
+    print("observability_deploy_gate_self_test=PASS")
+    print(f"- positive_cases={len(SELF_TEST_POSITIVE)}")
+    print(f"- negative_cases={len(SELF_TEST_NEGATIVE)}")
+    return 0
+
+
 def main() -> int:
     parser = argparse.ArgumentParser(description="Check observability deploy QA trigger")
     parser.add_argument("paths", nargs="*", help="Changed file paths")
     parser.add_argument("--stdin", action="store_true", help="Read changed paths from stdin")
+    parser.add_argument("--self-test", action="store_true", help="Run built-in trigger tests")
     parser.add_argument(
         "--github-output",
         default=os.environ.get("GITHUB_OUTPUT"),
@@ -65,6 +118,9 @@ def main() -> int:
     )
     args = parser.parse_args()
 
+    if args.self_test:
+        return run_self_test()
+
     raw_paths = list(args.paths)
     if args.stdin:
         import sys

scripts/check_observability_suite.sh

@@ -50,16 +50,18 @@ cd "$PROJECT_ROOT"
 echo "========================================"
 echo "AI Observability QA Suite"
 echo "========================================"
-echo "1/2 Static UI guard"
+echo "1/3 Static UI guard"
 python3 scripts/check_observability_ui.py
+echo "2/3 Deploy gate self-test"
+python3 scripts/check_observability_deploy_gate.py --self-test
 
 if [[ "$SKIP_PRODUCTION" -eq 1 ]]; then
-  echo "2/2 Production smoke skipped"
+  echo "3/3 Production smoke skipped"
   echo "AI Observability QA Suite: PASS"
   exit 0
 fi
 
-echo "2/2 Production 10-page smoke"
+echo "3/3 Production 10-page smoke"
 python3 scripts/check_observability_pages.py --base-url "$BASE_URL"
 
 echo "AI Observability QA Suite: PASS"