@trac3er/oh-my-god 1.0.2

package/scripts/check-omc-contract-snapshot.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+"""Legacy wrapper for OMG compatibility snapshot checker."""
+from __future__ import annotations
+
+import runpy
+from pathlib import Path
+
+
+if __name__ == "__main__":
+    target = Path(__file__).resolve().with_name("check-omg-compat-contract-snapshot.py")
+    runpy.run_path(str(target), run_name="__main__")
+

package/scripts/check-omg-compat-contract-snapshot.py

@@ -0,0 +1,137 @@
+#!/usr/bin/env python3
+"""Validate committed OMG compatibility snapshot against runtime contracts."""
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+ROOT = Path(__file__).resolve().parents[1]
+if str(ROOT) not in sys.path:
+    sys.path.insert(0, str(ROOT))
+
+from runtime.compat import (  # noqa: E402
+    CONTRACT_SNAPSHOT_SCHEMA,
+    CONTRACT_SNAPSHOT_VERSION,
+    DEFAULT_CONTRACT_SNAPSHOT_PATH,
+    LEGACY_CONTRACT_SNAPSHOT_PATH,
+    build_contract_snapshot_payload,
+    migrate_contract_snapshot_payload,
+)
+
+
+def _load_snapshot(path: Path) -> dict:
+    with open(path, "r", encoding="utf-8") as f:
+        payload = json.load(f)
+    if not isinstance(payload, dict):
+        raise ValueError("snapshot must be a JSON object")
+    return payload
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Check OMG compatibility contract snapshot drift")
+    parser.add_argument("--snapshot", default="")
+    parser.add_argument("--strict-version", action="store_true")
+    args = parser.parse_args()
+
+    if args.snapshot:
+        snapshot_path = Path(args.snapshot)
+    else:
+        primary = ROOT / DEFAULT_CONTRACT_SNAPSHOT_PATH
+        legacy = ROOT / LEGACY_CONTRACT_SNAPSHOT_PATH
+        snapshot_path = primary if primary.exists() else legacy
+
+    if not snapshot_path.exists():
+        print(
+            json.dumps(
+                {"status": "error", "message": f"snapshot not found: {snapshot_path}"},
+                indent=2,
+            )
+        )
+        return 2
+
+    try:
+        current = _load_snapshot(snapshot_path)
+    except Exception as exc:
+        print(json.dumps({"status": "error", "message": f"invalid snapshot json: {exc}"}, indent=2))
+        return 2
+
+    migrated, migrations = migrate_contract_snapshot_payload(current)
+    expected = build_contract_snapshot_payload(include_generated_at=False)
+
+    if migrated.get("schema") != CONTRACT_SNAPSHOT_SCHEMA:
+        print(
+            json.dumps(
+                {
+                    "status": "error",
+                    "message": "snapshot schema mismatch",
+                    "expected_schema": CONTRACT_SNAPSHOT_SCHEMA,
+                    "actual_schema": migrated.get("schema"),
+                },
+                indent=2,
+            )
+        )
+        return 3
+
+    if args.strict_version and current.get("contract_version") != CONTRACT_SNAPSHOT_VERSION:
+        print(
+            json.dumps(
+                {
+                    "status": "error",
+                    "message": "snapshot contract_version mismatch (strict)",
+                    "expected_version": CONTRACT_SNAPSHOT_VERSION,
+                    "actual_version": current.get("contract_version"),
+                },
+                indent=2,
+            )
+        )
+        return 3
+
+    if migrated.get("contract_version") != CONTRACT_SNAPSHOT_VERSION:
+        print(
+            json.dumps(
+                {
+                    "status": "error",
+                    "message": "snapshot contract_version unsupported",
+                    "expected_version": CONTRACT_SNAPSHOT_VERSION,
+                    "actual_version": migrated.get("contract_version"),
+                },
+                indent=2,
+            )
+        )
+        return 3
+
+    if migrated.get("count") != expected.get("count") or migrated.get("contracts") != expected.get("contracts"):
+        print(
+            json.dumps(
+                {
+                    "status": "error",
+                    "message": "snapshot drift detected",
+                    "expected_count": expected.get("count"),
+                    "actual_count": migrated.get("count"),
+                    "migrations_applied": migrations,
+                },
+                indent=2,
+            )
+        )
+        return 3
+
+    print(
+        json.dumps(
+            {
+                "status": "ok",
+                "message": "snapshot matches runtime contracts",
+                "contract_version": CONTRACT_SNAPSHOT_VERSION,
+                "migrations_applied": migrations,
+                "snapshot": str(snapshot_path),
+            },
+            indent=2,
+        )
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
+

package/scripts/check-omg-standalone-clean.py

@@ -0,0 +1,102 @@
+#!/usr/bin/env python3
+"""Check that standalone/OMG-first naming rules are preserved."""
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+import sys
+
+ROOT = Path(__file__).resolve().parents[1]
+
+# Paths where legacy aliases are explicitly allowed.
+ALLOW_OMC_CLI = {
+    ROOT / "commands" / "OMG:omc-compat.md",
+    ROOT / "tests" / "scripts" / "test_omg_cli.py",
+    ROOT / "tests" / "scripts" / "test_standalone_clean_check.py",
+    ROOT / "scripts" / "check-omg-standalone-clean.py",
+}
+
+ALLOW_LEGACY_MIGRATOR = {
+    ROOT / "scripts" / "omc_to_omg_migrate.py",
+    ROOT / "tests" / "e2e" / "test_standalone_ga.py",
+    ROOT / "scripts" / "check-omg-standalone-clean.py",
+}
+
+ALLOW_LEGACY_SNAPSHOT_CHECKER = {
+    ROOT / "scripts" / "check-omc-contract-snapshot.py",
+    ROOT / "tests" / "scripts" / "test_compat_snapshot_check.py",
+    ROOT / "scripts" / "check-omg-standalone-clean.py",
+}
+
+ALLOW_LEGACY_RUNTIME_IMPORT = {
+    ROOT / "tests" / "scripts" / "test_standalone_clean_check.py",
+    ROOT / "scripts" / "check-omg-standalone-clean.py",
+}
+
+SCAN_GLOBS = [
+    "README.md",
+    "OMG-setup.sh",
+    "install.sh",
+    "runtime/**/*.py",
+    "hooks/**/*.py",
+    "scripts/**/*.py",
+    "commands/**/*.md",
+    ".github/workflows/**/*.yml",
+    "tests/**/*.py",
+]
+
+
+def _iter_files(root: Path) -> list[Path]:
+    files: list[Path] = []
+    for pattern in SCAN_GLOBS:
+        files.extend(p for p in root.glob(pattern) if p.is_file())
+    # deterministic order
+    return sorted(set(files))
+
+
+def _contains(path: Path, token: str) -> bool:
+    return token in path.read_text(encoding="utf-8")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Check OMG standalone naming hygiene")
+    parser.add_argument("--root", default=str(ROOT))
+    args = parser.parse_args()
+    root = Path(args.root).resolve()
+
+    violations: list[str] = []
+
+    deprecated_workflow = root / ".github" / "workflows" / "omc-compat-gate.yml"
+    if deprecated_workflow.exists():
+        violations.append(f"deprecated workflow exists: {deprecated_workflow.relative_to(root)}")
+
+    for path in _iter_files(root):
+        rel = path.relative_to(root)
+
+        if _contains(path, "python3 scripts/omg.py omc "):
+            if path not in ALLOW_OMC_CLI:
+                violations.append(f"{rel}: legacy CLI namespace used outside allowlist")
+
+        if _contains(path, "omc_to_omg_migrate.py"):
+            if path not in ALLOW_LEGACY_MIGRATOR:
+                violations.append(f"{rel}: legacy migrator path reference outside allowlist")
+
+        if _contains(path, "check-omc-contract-snapshot.py"):
+            if path not in ALLOW_LEGACY_SNAPSHOT_CHECKER:
+                violations.append(f"{rel}: legacy snapshot checker reference outside allowlist")
+
+        if _contains(path, "runtime.legacy_compat"):
+            if path not in ALLOW_LEGACY_RUNTIME_IMPORT:
+                violations.append(f"{rel}: legacy runtime import outside allowlist")
+
+    if violations:
+        print(json.dumps({"status": "error", "violations": violations}, indent=2))
+        return 1
+
+    print(json.dumps({"status": "ok", "message": "standalone naming check passed"}, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/scripts/legacy_to_omg_migrate.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+"""CLI utility: migrate legacy state into canonical `.omg` layout."""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+if str(ROOT) not in sys.path:
+    sys.path.insert(0, str(ROOT))
+
+from hooks.state_migration import migrate_legacy_to_omg  # noqa: E402
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Migrate legacy state to .omg")
+    parser.add_argument("--project-dir", default=os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd()))
+    args = parser.parse_args()
+
+    report = migrate_legacy_to_omg(args.project_dir)
+    print(json.dumps(report, indent=2))
+    return 0 if report.get("result") in {"ok", "no_legacy"} else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())