"""
R208 node runtime policy guard.
"""

from __future__ import annotations

import json
import unittest
from pathlib import Path

REPO_ROOT = Path(__file__).resolve().parents[1]


class TestR208NodeRuntimePolicy(unittest.TestCase):
    def test_package_engine_stays_aligned_with_openclaw_sop(self):
        package = json.loads((REPO_ROOT / "package.json").read_text(encoding="utf-8"))
        test_sop = (REPO_ROOT / "tests" / "TEST_SOP.md").read_text(encoding="utf-8")
        e2e_sop = (REPO_ROOT / "tests" / "E2E_TESTING_SOP.md").read_text(
            encoding="utf-8"
        )

        self.assertEqual(package["engines"]["node"], ">=18.0.0")
        self.assertIn("Node.js 18+", test_sop)
        self.assertIn("CI uses 20", test_sop)
        self.assertIn("Node.js 18+", e2e_sop)
        self.assertNotEqual(package["engines"]["node"], ">=25 <26")

    def test_compatibility_matrix_documents_host_frontend_engine_boundary(self):
        matrix = (REPO_ROOT / "docs" / "release" / "compatibility_matrix.md").read_text(
            encoding="utf-8"
        )

        self.assertIn("## Residual Host-Contract Decisions", matrix)
        self.assertIn("`node >=25 <26`", matrix)
        self.assertIn("`>=18.0.0`", matrix)
        self.assertIn("tests/TEST_SOP.md", matrix)
        self.assertIn("tests/E2E_TESTING_SOP.md", matrix)
        self.assertIn("does not build the host frontend workspace", matrix)
        self.assertNotIn("reference/", matrix)
        self.assertNotIn(".planning/", matrix)


if __name__ == "__main__":
    unittest.main()