import json import logging import subprocess import sys import unittest from datetime import datetime, timedelta, timezone from pathlib import Path from matrix_core import DeterministicMatrixCore, ENGINE_VERSION FIXED = datetime(2026, 11, 3, 12, tzinfo=timezone.utc) VECTOR = "36e7be60a50a6d846b8b162c199a5e534c612ba171163d9c3406e2f2b12c0651" MODULE = Path(sys.modules[DeterministicMatrixCore.__module__].__file__).resolve() class MatrixCoreTests(unittest.TestCase): def setUp(self): self.core = DeterministicMatrixCore() def test_known_checksum_vector(self): result = self.core.enforce_zero_tolerance_matrix("Evidence before confidence.", FIXED) self.assertEqual(result["matrix_verification_seal"], VECTOR) self.assertEqual(result["seal_date"], "2026-11-03") self.assertEqual(result["engine_version"], ENGINE_VERSION) def test_whitespace_normalization_including_unicode(self): result = self.core.enforce_zero_tolerance_matrix("\tEvidence\u00a0before\n confidence. ", FIXED) self.assertEqual(result["input_payload"], "Evidence before confidence.") self.assertEqual(result["matrix_verification_seal"], VECTOR) def test_invalid_payloads_do_not_receive_checksums(self): for payload in (None, "", " \t\n\u00a0", 0, False, b"text", [], {}): with self.subTest(payload=repr(payload)): result = self.core.enforce_zero_tolerance_matrix(payload, FIXED) self.assertFalse(result["valid"]) self.assertEqual(result["error"], "EMPTY_OR_INVALID_PAYLOAD") self.assertNotIn("matrix_verification_seal", result) def test_fixed_instant_repeats_entire_result(self): expected = self.core.enforce_zero_tolerance_matrix("test", FIXED) for _ in range(25): self.assertEqual(self.core.enforce_zero_tolerance_matrix("test", FIXED), expected) def test_same_utc_day_repeats_checksum_but_not_timestamp(self): first = self.core.enforce_zero_tolerance_matrix("test", FIXED) later = self.core.enforce_zero_tolerance_matrix("test", FIXED + timedelta(hours=1)) self.assertEqual(first["matrix_verification_seal"], later["matrix_verification_seal"]) self.assertNotEqual(first["timestamp"], later["timestamp"]) def test_next_utc_day_changes_checksum(self): first = self.core.enforce_zero_tolerance_matrix("test", FIXED) next_day = self.core.enforce_zero_tolerance_matrix("test", FIXED + timedelta(days=1)) self.assertNotEqual(first["matrix_verification_seal"], next_day["matrix_verification_seal"]) def test_equivalent_timezone_instants_have_identical_results(self): local = datetime(2026, 11, 4, 0, 30, tzinfo=timezone(timedelta(hours=2))) utc = datetime(2026, 11, 3, 22, 30, tzinfo=timezone.utc) result = self.core.enforce_zero_tolerance_matrix("test", local) self.assertEqual(result, self.core.enforce_zero_tolerance_matrix("test", utc)) self.assertEqual(result["seal_date"], "2026-11-03") self.assertTrue(result["timestamp"].endswith("+00:00")) def test_naive_datetime_is_rejected(self): with self.assertRaises(ValueError): self.core.enforce_zero_tolerance_matrix("test", datetime(2026, 11, 3)) def test_wrong_time_types_are_rejected(self): for instant in (0, "2026-11-03", False): with self.subTest(instant=instant), self.assertRaises(TypeError): self.core.enforce_zero_tolerance_matrix("test", instant) def test_default_time_is_aware_utc(self): result = self.core.enforce_zero_tolerance_matrix("test") instant = datetime.fromisoformat(result["timestamp"]) self.assertEqual(instant.utcoffset(), timedelta(0)) self.assertEqual(instant.date().isoformat(), result["seal_date"]) def test_engine_version_is_metadata_not_seal_input(self): first = self.core.enforce_zero_tolerance_matrix("test", FIXED) other = DeterministicMatrixCore("custom").enforce_zero_tolerance_matrix("test", FIXED) self.assertEqual(first["matrix_verification_seal"], other["matrix_verification_seal"]) self.assertNotEqual(first["engine_version"], other["engine_version"]) def test_import_does_not_configure_root_logging(self): code = "import logging; before=list(logging.root.handlers); import matrix_core; assert logging.root.handlers == before" result = subprocess.run([sys.executable, "-B", "-c", code], cwd=MODULE.parent, capture_output=True) self.assertEqual(result.returncode, 0, result.stderr) def cli(self, *arguments): return subprocess.run([sys.executable, "-X", "utf8", "-B", str(MODULE), *arguments], capture_output=True, text=True, encoding="utf-8") def test_cli_is_json_and_matches_vector(self): result = self.cli("Evidence before confidence.", "--at", FIXED.isoformat()) self.assertEqual(result.returncode, 0) self.assertEqual(json.loads(result.stdout)["matrix_verification_seal"], VECTOR) self.assertEqual(result.stderr, "") def test_cli_missing_payload_is_invalid(self): result = self.cli() self.assertEqual(result.returncode, 2) self.assertFalse(json.loads(result.stdout)["valid"]) def test_cli_rejects_timestamp_without_timezone(self): result = self.cli("test", "--at", "2026-11-03T12:00:00") self.assertEqual(result.returncode, 2) self.assertEqual(json.loads(result.stdout)["error"], "INVALID_TIMESTAMP") def test_cli_preserves_unicode(self): result = self.cli("Čćšđž", "--at", FIXED.isoformat()) self.assertEqual(result.returncode, 0) self.assertEqual(json.loads(result.stdout)["input_payload"], "Čćšđž") if __name__ == "__main__": unittest.main()