From 30a9699d8af0074570e3ef3bf7ce962907f4d493 Mon Sep 17 00:00:00 2001
From: Dylan Roy <249851642+d6g8k5htny-coder@users.noreply.github.com>
Date: Wed, 14 Oct 2026 14:55:39 -0500
Subject: [PATCH] test: include formal verification guide in navigation
 coverage

Add the guide to the existing manifest and five manifest-driven real
scanner regressions, preserving all public-source pins and scanner bytes.
Author: OpenAI / GPT-6 Astra Pro, Research task-loop
RLOOP-NAV-GUIDE-COVERAGE-20261014; main#402 pickup6176896482.
Original manifest: four intended failures per mode. Candidate: 28/28
navigation tests per mode. Engineering only; scientific effect NONE.
---
 docs/NAVIGATION.json              |   1 +
 tests/test_navigation_manifest.py | 101 ++++++++++++++++++++++++++++++
 2 files changed, 102 insertions(+)
 create mode 100644 tests/test_navigation_manifest.py

diff --git a/docs/NAVIGATION.json b/docs/NAVIGATION.json
index 1767cfb68..42c7e0028 100644
--- a/docs/NAVIGATION.json
+++ b/docs/NAVIGATION.json
@@ -26,6 +26,7 @@
     "docs/rn_d5_shrinking_witness_20260926.md",
     "docs/QUEUE_RECONCILIATION_20260927.md",
     "docs/FORMAL_VERIFICATION_ROLLOUT_20260927.md",
+    "docs/FORMAL_VERIFICATION.md",
     "formal/README.md",
     "formal/GLOSSARY.md",
     "formal/REVIEW_LANE.md",
diff --git a/tests/test_navigation_manifest.py b/tests/test_navigation_manifest.py
new file mode 100644
index 000000000..fad063344
--- /dev/null
+++ b/tests/test_navigation_manifest.py
@@ -0,0 +1,101 @@
+"""Real scanner regressions for the committed formal-guide page declaration.
+
+Only the committed page list is reused. Disposable synthetic documents and an
+empty public-target list keep these controls local; no repository file is edited.
+"""
+import importlib.util
+import json
+from pathlib import Path, PurePosixPath
+import subprocess
+import sys
+import tempfile
+import unittest
+
+
+ROOT = Path(__file__).resolve().parents[1]
+GUIDE = 'docs/FORMAL_VERIFICATION.md'
+SCANNER = ROOT / 'tools/navigation_check.py'
+spec = importlib.util.spec_from_file_location('navigation_manifest_scanner', SCANNER)
+nav = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(nav)
+
+
+class FormalGuideNavigationTests(unittest.TestCase):
+    def setUp(self):
+        self.pages = nav.load(ROOT)['pages']
+        temporary = tempfile.TemporaryDirectory()
+        self.addCleanup(temporary.cleanup)
+        self.root = Path(temporary.name)
+        for page in self.pages:
+            rel = PurePosixPath(page)
+            self.assertFalse(rel.is_absolute() or '..' in rel.parts)
+            target = self.root / rel
+            target.parent.mkdir(parents=True, exist_ok=True)
+            target.write_text('# Fixture\n', encoding='utf-8')
+        (self.root / 'docs').mkdir(exist_ok=True)
+        (self.root / 'docs/NAVIGATION.json').write_text(
+            json.dumps({'version': 1, 'pages': self.pages, 'public_targets': []}),
+            encoding='utf-8',
+        )
+        (self.root / 'README.md').write_text(
+            f'# Home\n[Guide]({GUIDE})\n', encoding='utf-8',
+        )
+        self.guide = self.root / GUIDE
+        self.guide.write_text(
+            '# Guide\n[Target](navigation-fixture-target.md#result)\n',
+            encoding='utf-8',
+        )
+        (self.root / 'docs/navigation-fixture-target.md').write_text(
+            '# Result\n', encoding='utf-8',
+        )
+
+    def cli(self):
+        flags = ['-O'] if sys.flags.optimize else []
+        process = subprocess.run(
+            [sys.executable, '-B', '-S', *flags, str(SCANNER),
+             '--root', str(self.root)],
+            stdin=subprocess.DEVNULL, capture_output=True, text=True,
+            encoding='utf-8', timeout=15, cwd=self.root,
+        )
+        self.assertEqual(process.stderr, '')
+        return process.returncode, json.loads(process.stdout)
+
+    def test_manifest_lists_guide_once(self):
+        self.assertEqual(self.pages.count(GUIDE), 1)
+
+    def test_valid_guide_links(self):
+        code, result = self.cli()
+        self.assertEqual(code, 0)
+        self.assertEqual(result['problems'], [])
+        self.assertEqual(result['public_sources_verified'], [])
+
+    def test_guide_outgoing_link_is_scanned(self):
+        result = nav.check(self.root)
+        self.assertEqual(result['local_links'], 2)
+        self.assertEqual(result['fragment_links'], 1)
+
+    def test_missing_guide_target_is_rejected(self):
+        self.guide.write_text(
+            '# Guide\n[Missing](navigation-fixture-missing.md)\n',
+            encoding='utf-8',
+        )
+        code, result = self.cli()
+        self.assertEqual(code, 1)
+        self.assertEqual(len(result['problems']), 1)
+        self.assertIn(GUIDE + ': navigation-fixture-missing.md:',
+                      result['problems'][0])
+
+    def test_missing_guide_anchor_is_rejected(self):
+        self.guide.write_text(
+            '# Guide\n[Missing](navigation-fixture-target.md#absent)\n',
+            encoding='utf-8',
+        )
+        code, result = self.cli()
+        self.assertEqual(code, 1)
+        self.assertEqual(len(result['problems']), 1)
+        self.assertIn(GUIDE + ':', result['problems'][0])
+        self.assertIn('missing fragment absent', result['problems'][0])
+
+
+if __name__ == '__main__':
+    unittest.main()