import importlib.util import json import tempfile import unittest from datetime import datetime, timezone from pathlib import Path from unittest.mock import patch SCRIPT = Path(__file__).resolve().parents[1] / 'scripts' / 'docs_audit.py' spec = importlib.util.spec_from_file_location('docs_audit', SCRIPT) audit = importlib.util.module_from_spec(spec) spec.loader.exec_module(audit) class AuditPreflightTests(unittest.TestCase): def test_missing_state_and_force_never_claim_semantic_review(self): with tempfile.TemporaryDirectory() as directory, patch.object(audit, 'DOCS', Path(directory)), \ patch.object(audit, 'STATE', Path(directory) / 'missing.json'), patch.object(audit, 'git', return_value=None): result = audit.preflight(force=True, now=datetime(2026, 11, 4, tzinfo=timezone.utc)) self.assertTrue(result['due']) self.assertFalse(result['semantic_review_performed']) self.assertIsNone(result['changed_tracked_source_files']) def test_due_boundary_and_invalid_commit(self): with tempfile.TemporaryDirectory() as directory: state = Path(directory) / 'state.json' state.write_text(json.dumps({'last_successful_audit': '2026-10-21T12:00:00Z', 'last_audited_commit': 'bad-commit'})) with patch.object(audit, 'DOCS', Path(directory)), patch.object(audit, 'STATE', state), \ patch.object(audit, 'git', side_effect=lambda *args: 'head' if args == ('rev-parse', 'HEAD') else None): result = audit.preflight(now=datetime(2026, 11, 4, 12, tzinfo=timezone.utc)) self.assertTrue(result['due']) self.assertFalse(result['stored_commit_valid']) self.assertTrue(any('valid local commit' in warning for warning in result['warnings'])) def test_local_links(self): with tempfile.TemporaryDirectory() as directory: root = Path(directory) docs = root / 'docs' docs.mkdir() (docs / 'a.md').write_text('[works](b.md) [broken](missing.md) [external](https://example.com)') (docs / 'b.md').write_text('ok') with patch.object(audit, 'ROOT', root), patch.object(audit, 'DOCS', docs): self.assertEqual(audit.links(), ['docs/a.md -> missing.md']) if __name__ == '__main__': unittest.main()