diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index ed2af0631..61ba903ab 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -115,5 +115,9 @@ jobs:
run: python tools/closure_pipeline.py check-plan
- name: Math status packet (OPEN/HOLD only; flags stay false)
run: python tools/math_status_check.py
+ - name: Declared navigation links and anchors
+ run: python tools/navigation_check.py
+ - name: Navigation synthetic controls
+ run: python -m unittest tests.test_navigation -v
- name: Unit tests and negative controls
run: python -m pytest -q
diff --git a/.github/workflows/navigation.yml b/.github/workflows/navigation.yml
new file mode 100644
index 000000000..d639b88a6
--- /dev/null
+++ b/.github/workflows/navigation.yml
@@ -0,0 +1,29 @@
+# Declared navigation pages only. Not research CI. A green run is not discharge.
+name: navigation
+on:
+ pull_request:
+ branches: [chatgpt/drive-github-hardening-20260919]
+ push:
+ branches: [chatgpt/drive-github-hardening-20260919]
+ workflow_dispatch:
+permissions:
+ contents: read
+defaults:
+ run:
+ shell: bash
+jobs:
+ navigation:
+ runs-on: ubuntu-24.04
+ timeout-minutes: 10
+ steps:
+ - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4, reviewed 2026-09-22
+ with:
+ persist-credentials: false
+ - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5, reviewed 2026-09-22
+ with:
+ python-version: "3.11.16"
+ - name: Declared links, anchors, and synthetic controls
+ run: |
+ python3 tools/navigation_check.py
+ python3 -m unittest tests.test_navigation -v
+ python3 -O -m unittest tests.test_navigation -v
diff --git a/AGENTS.md b/AGENTS.md
index 1efe2d82c..7aa527756 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -20,6 +20,7 @@ process is agent judgment, and intent still binds.
- Never open `99_DO_NOT_OPEN` for evidence or authority; metadata only.
Never edit exports or frozen bodies in place or cite excluded material.
[quarantine/PATHS.md](quarantine/PATHS.md): quarantine ≠ SoT; `DO_NOT_OPEN` letters ≠ the vault.
+- Reading routes (nav only; no flag flips): [Workspace](docs/WORKSPACE.md), [research index](docs/RESEARCH_INDEX.md), [reproduction](docs/REPRODUCE.md).
## Scoped operational addenda
@@ -31,7 +32,6 @@ process is agent judgment, and intent still binds.
historical rules. Preserve exact review targets and use the existing log.
- Revalidate live records and exact heads at each task boundary. Git merges
and fast-forwards are not semantic reconciliation or cross-system locks.
-
## Historical bridge boundary
The contract under `drive/deltas/2026-09-18/DG-EXEC-20260918-49291487/` remains
diff --git a/CLAUDE.md b/CLAUDE.md
index 2014f0730..366fa4ba6 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -51,9 +51,12 @@ an expected digest to match bytes you changed.
## Technical navigation
Start with [README.md](README.md), [RESEARCH_MAP](docs/RESEARCH_MAP.md) and
-[OPEN_PROBLEMS](docs/OPEN_PROBLEMS.md). Inspect the actual code and workflow for
-the task; check `.github/workflows/ci.yml` for the current executed checks.
-[AGENTS.md](AGENTS.md) is the short cross-model entry.
+[OPEN_PROBLEMS](docs/OPEN_PROBLEMS.md). Reading routes:
+[workspace](docs/WORKSPACE.md), [research index](docs/RESEARCH_INDEX.md), and
+[reproduction](docs/REPRODUCE.md). They do not move claim flags. Inspect the
+actual code and workflow for the task; check `.github/workflows/ci.yml` for
+the current executed checks. [AGENTS.md](AGENTS.md) is the short cross-model
+entry.
The earlier version of this file is preserved in Git at
`fbb43601369b19ecb12447d4cc02ed44340dce60:CLAUDE.md`. Its former rules are
diff --git a/README.md b/README.md
index f091fa0b2..c50f0fa55 100644
--- a/README.md
+++ b/README.md
@@ -51,6 +51,24 @@ be run, reviewed and verified with ordinary git and CI.
> a display is not a certified enclosure; a draft is not an operator promotion;
> registration is not review.
+## Navigation
+
+Reading routes on this hardening checkout. The status tables above stay in
+force. These links do not invent a source of truth and do not move a claim flag.
+
+| I want to… | Go here |
+|---|---|
+| See where this branch sits relative to `main`, Drive, and Math- | [Workspace](docs/WORKSPACE.md) |
+| Follow a topic without treating a link as acceptance | [Research index](docs/RESEARCH_INDEX.md) |
+| Replay a check or an external Math- candidate | [Reproduction](docs/REPRODUCE.md) |
+| Stay on the program map and open problems | [Research map](docs/RESEARCH_MAP.md), [open problems](docs/OPEN_PROBLEMS.md) |
+
+`lemma_closed`, `prizes_solved`, `discharges_OBL_H5_JETMOD`, and
+`certified_C_H` stay false. SIDE24 carriers marked ABSENT stay ABSENT.
+Quarantine is not a source of truth. `inventable_attempt_accepted` stays
+false. A navigation check is engineering hygiene, not discharge. This page
+lives on `chatgpt/drive-github-hardening-20260919`, not on `main`.
+
## What the research is
Two independent tracks plus a platform.
diff --git a/docs/CLOSURE_PIPELINE.md b/docs/CLOSURE_PIPELINE.md
index d203657dc..c17079af7 100644
--- a/docs/CLOSURE_PIPELINE.md
+++ b/docs/CLOSURE_PIPELINE.md
@@ -23,7 +23,9 @@ that all listed rows are open. Terminal rows remain terminal in the projection.
Each supported command becomes an executable machine-verification task. Explicit
relevance links connect RN checks to A5, Hermite checks to A1, and the LPW amplitude
check to its constant repair. These links identify useful evidence; they are not
-theorem-discharge rules. The runner never executes arbitrary carrier IDs or
+theorem-discharge rules. The declared navigation-link check and its synthetic
+unittest are on the same allowlist and have no relevance links, so they do not
+attach to an obligation. The runner never executes arbitrary carrier IDs or
commands found in register cells. In particular, a superseded carrier being
listed among historical A5 inputs does not make it eligible for execution.
diff --git a/docs/LANDING_MANIFEST.json b/docs/LANDING_MANIFEST.json
new file mode 100644
index 000000000..b293ce890
--- /dev/null
+++ b/docs/LANDING_MANIFEST.json
@@ -0,0 +1,23 @@
+{
+ "scope": "DECLARED_NAVIGATION_PAGES_ON_HARDENING_BRANCH_ONLY",
+ "note": "Adapted from the main-landing manifest. This checkout is chatgpt/drive-github-hardening-20260919. history/2025 byte custody is absent here and is not claimed. This file is not a source of truth and does not check scientific status.",
+ "pages": [
+ "README.md",
+ "AGENTS.md",
+ "CLAUDE.md",
+ "docs/WORKSPACE.md",
+ "docs/RESEARCH_INDEX.md",
+ "docs/REPRODUCE.md",
+ "docs/RESEARCH_MAP.md",
+ "docs/RESEARCH_EXECUTION.md"
+ ],
+ "historical_files": [],
+ "not_checked": [
+ "remote link availability or contents",
+ "scientific correctness",
+ "PACKET claim flags",
+ "other branches",
+ "full research repository tests",
+ "history/2025 byte custody (those files are absent on this branch)"
+ ]
+}
diff --git a/docs/NAVIGATION.json b/docs/NAVIGATION.json
new file mode 100644
index 000000000..dc091c380
--- /dev/null
+++ b/docs/NAVIGATION.json
@@ -0,0 +1,56 @@
+{
+ "version": 1,
+ "note": "Reading routes on chatgpt/drive-github-hardening-20260919. Not a source of truth. Named Math- bytes are optional readback targets, not acceptance. inventable_attempt_accepted stays false. OBL-H5-JETMOD and D3-LEMMA-RN-UNIF stay OPEN.",
+ "pages": [
+ "README.md",
+ "AGENTS.md",
+ "CLAUDE.md",
+ "docs/RESEARCH_INDEX.md",
+ "docs/REPRODUCE.md",
+ "docs/WORKSPACE.md"
+ ],
+ "public_targets": [
+ {
+ "repository": "Math-",
+ "ref": "main",
+ "path": "coefficients/side24_v1/PROOF.md",
+ "bytes": 10272,
+ "sha256": "c06daccc4ba4b9168522b9888b76a7d599934fc3b91bd753ee5d492262917769"
+ },
+ {
+ "repository": "Math-",
+ "ref": "main",
+ "path": "frontiers/three_fronts_20260924/LIFETIME_REMAINDER.md",
+ "bytes": 17734,
+ "sha256": "380b7d0abdb0fe2de5a6564565af9560d3f1b1ce22fd5538927db0c52f4f3a4a"
+ },
+ {
+ "repository": "Math-",
+ "ref": "main",
+ "path": "frontiers/three_fronts_20260924/RN_COUNT_INTERFACE.md",
+ "bytes": 8938,
+ "sha256": "aa993f5217bd70e6d1060402d121ab659f6582a098e29042c67585a345a8e3ab"
+ },
+ {
+ "repository": "Math-",
+ "ref": "main",
+ "path": "frontiers/three_fronts_20260924/P15_REALIZED_COVERS.md",
+ "bytes": 11467,
+ "sha256": "c0dbb821fb57b685a20cc321e4074456f39a9697f3104afd1f728e4732179bb9"
+ },
+ {
+ "repository": "Math-",
+ "ref": "main",
+ "path": "frontiers/three_fronts_20260924/P15_PRICE_BOUNDARY.md",
+ "bytes": 2266,
+ "sha256": "498af650ef7139c39d2630561dbfd0822c495ce6308a6cac8b767aefe0c2a40b"
+ },
+ {
+ "repository": "Math-",
+ "ref": "main",
+ "path": "frontiers/price_budget_20260924/PROOF.md",
+ "bytes": 7935,
+ "sha256": "3b79d2de60d77df9dd0d81cea60935d3dbceeb26fcf2d38d62667a425180a535"
+ }
+ ]
+}
diff --git a/docs/REPRODUCE.md b/docs/REPRODUCE.md
new file mode 100644
index 000000000..ec1a55610
--- /dev/null
+++ b/docs/REPRODUCE.md
@@ -0,0 +1,95 @@
+# Reproduce the work
+
+[Home](../README.md) · [Research index](RESEARCH_INDEX.md) · [Workspace](WORKSPACE.md)
+
+Commands below are routes. A passing run is engineering evidence for the
+command that ran. It does not discharge `OBL-H5-JETMOD` or `D3-LEMMA-RN-UNIF`.
+`lemma_closed`, `prizes_solved`, `discharges_OBL_H5_JETMOD`, and
+`certified_C_H` stay false. `inventable_attempt_accepted` stays false.
+SIDE24 carriers marked ABSENT stay ABSENT. Quarantine is not a source of truth.
+
+## This branch
+
+This file lives on `chatgpt/drive-github-hardening-20260919`, not on `main`.
+The research checkers and their boundaries are in
+[RESEARCH_EXECUTION.md](RESEARCH_EXECUTION.md) and
+[VERIFICATION_RUNNER.md](VERIFICATION_RUNNER.md). Record `git rev-parse HEAD`
+and the interpreter version with the result. Navigation checks in the last
+section do not stand in for that CI.
+
+## Mathematical sources
+
+Clone [Math-](https://github.com/d6g8k5htny-coder/Math-) and run these commands
+from its root. The named packages, as described by those notes, use the Python
+standard library. Record the commit you actually checked out. Counts below are
+the counts written in the navigation notes being ported. Re-count them on that
+commit. This port does not re-certify them.
+
+```sh
+git clone https://github.com/d6g8k5htny-coder/Math-.git
+cd Math-
+git rev-parse HEAD
+python --version
+```
+
+| Work | Read | Execute from Math- root |
+|---|---|---|
+| Coefficient | [PROOF.md](https://github.com/d6g8k5htny-coder/Math-/blob/main/coefficients/side24_v1/PROOF.md) | `python -B -S coefficients/side24_v1/coefficient.py` |
+| Lifetime/RN/P15 package | [LIFETIME_REMAINDER.md](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/three_fronts_20260924/LIFETIME_REMAINDER.md), [RN_COUNT_INTERFACE.md](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/three_fronts_20260924/RN_COUNT_INTERFACE.md), [P15_REALIZED_COVERS.md](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/three_fronts_20260924/P15_REALIZED_COVERS.md), [P15_PRICE_BOUNDARY.md](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/three_fronts_20260924/P15_PRICE_BOUNDARY.md) | `python -B -S -m unittest discover -s frontiers/three_fronts_20260924 -p 'test_*.py' -v` |
+| Transformed-price budget | [PROOF.md](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/price_budget_20260924/PROOF.md) | `python -B -S frontiers/price_budget_20260924/price_budget.py` |
+
+The ported notes recorded 30 coefficient tests, 57 three-front tests, and 26
+price-budget tests. Repeating modes does not add independent analytic review.
+A failed baseline stays visible.
+
+## Deliberate error controls
+
+Each package runner described in those notes requires a new output directory
+outside its source directory:
+
+```sh
+python -B -S frontiers/price_budget_20260924/run_validation.py --output /tmp/price-budget-run-001
+python -B -S frontiers/three_fronts_20260924/run_validation.py --output /tmp/three-fronts-run-001
+```
+
+Those runners exercise tests and deliberately incorrect variants. They do not
+prove the Gaussian continuum estimates and they do not supply nonauthor review.
+
+## Exact cross-repository lookup
+
+The ported notes keep sibling checkouts named `Math-`, `meta-framework`,
+`query-`, and `google-drive`. From their common parent:
+
+```sh
+python -B -S query-/research_query.py --registry meta-framework/registry.json --key lifetime-remainder
+python -B -S query-/research_query.py --registry meta-framework/registry.json --key p15-price-budget
+python -B -S query-/research_query.py --registry meta-framework/registry.json --verify --workspace .
+```
+
+That lookup, as described there, refuses unknown keys and altered local bytes.
+A later legitimate edit also fails an older hash. Inspect the newer source.
+The catalog is a curated subset.
+
+[trial's federation replay](https://github.com/d6g8k5htny-coder/trial/blob/main/federation/replay.py)
+downloads pinned historical commits. It does not automatically run later
+additions. A skipped fixture is not a successful multi-repository replay.
+
+## Navigation checks
+
+From this hardening checkout:
+
+```sh
+python3 -B -S tools/navigation_check.py
+python3 -B -S -m unittest tests.test_navigation -v
+```
+
+`tools/navigation_check.py` checks declared inline Markdown links and ATX
+fragments on the pages in [NAVIGATION.json](NAVIGATION.json).
+`--verify-public` is an explicit opt-in readback of the six named public
+Math- files in that manifest. It does not crawl every branch or Drive link,
+execute retrieved sources, or certify mathematics. A changed public byte is a
+reason to inspect the target. It is not a verdict that the mathematics is false.
+
+The historical main-landing custody checker and `history/2025` byte identities
+are absent on this branch. [LANDING_MANIFEST.json](LANDING_MANIFEST.json)
+records that absence. It is not a substitute source of truth.
diff --git a/docs/RESEARCH_INDEX.md b/docs/RESEARCH_INDEX.md
new file mode 100644
index 000000000..6ed40313d
--- /dev/null
+++ b/docs/RESEARCH_INDEX.md
@@ -0,0 +1,82 @@
+# Research index
+
+[Home](../README.md) · [Reproduction](REPRODUCE.md) · [Workspace](WORKSPACE.md) · [Open work](#open-work)
+
+Reading map for `chatgpt/drive-github-hardening-20260919`, adapted on
+24 September 2026 from navigation notes that had been cut on `main`. Follow
+each source's hypotheses. This page is not a mathematical acceptance register.
+
+SIDE24 has no new source-of-truth carrier after 2026-08-06. Objects marked
+**ABSENT** in [RN_SIDE24.md](RN_SIDE24.md),
+[RN_SIDE24_DENSITY.md](RN_SIDE24_DENSITY.md), and
+[RN_SIDE24_CELL.md](RN_SIDE24_CELL.md) stay **ABSENT**. Quarantine is not a
+source of truth. `inventable_attempt_accepted` stays false. `OBL-H5-JETMOD`
+and `D3-LEMMA-RN-UNIF` stay OPEN. `lemma_closed`, `prizes_solved`,
+`discharges_OBL_H5_JETMOD`, and `certified_C_H` stay false. An external link
+is not discharge.
+
+## Gaussian persistence
+
+Read this sequence to follow the external argument. Geometry, a coefficient
+evaluation, and a remainder candidate are different statements.
+
+| Step | Read | What it supplies |
+|---|---|---|
+| 1. Separating geometry | [Marked-cylinder proof](https://drive.google.com/file/d/1BnPods7Lf-ECdD34noQihZcEfcqpy7R5/view) | A deterministic global elder-pairing criterion. Geometry alone is not a Gaussian probability estimate. |
+| 2. Conditioned Gaussian law | [Matrix-cap and lifetime proof](https://drive.google.com/file/d/1foDgiDi4XIKOfbrZEE8dWKV_BkZU8LIb/view) · [review #63](https://github.com/d6g8k5htny-coder/main/issues/63) | External compact-mark and lifetime notes. The parent proof stays unreviewed by this page. |
+| 3. Leading coefficient | [SIDE24 d2/d3 enclosure](https://github.com/d6g8k5htny-coder/Math-/blob/main/coefficients/side24_v1/PROOF.md) · [review #65](https://github.com/d6g8k5htny-coder/main/issues/65) | External evaluation of a parent expression. Numerical precision is not parent acceptance and is not a new SIDE24 source of truth. |
+| 4. Quantitative remainder | [Bounded unrestricted remainder](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/three_fronts_20260924/LIFETIME_REMAINDER.md) · [review #67](https://github.com/d6g8k5htny-coder/main/issues/67) | External remainder candidate. No usable lifetime cutoff is established here. |
+
+The claims concern a specified normalized periodized Gaussian model. Birth,
+gap, orientation, dimension, and normalizer stay attached to the statement.
+Drive access may be required for the older standalone parents.
+
+## RN counting
+
+Start with the external [probability-to-count interface](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/three_fronts_20260924/RN_COUNT_INTERFACE.md).
+A cubic event probability does not by itself give a cubic expected count. That
+note writes an integral. It does not evaluate the integral, and it does not
+discharge [D3-LEMMA-RN-UNIF](math_status/STATUS_RN_UNIF.md).
+
+On this branch, use [RN status as written](math_status/STATUS_RN_UNIF.md) and
+the [execution guide](RESEARCH_EXECUTION.md). Absent source objects, cell
+coverage, and 24-jet requirements stay open. Do not apply a local support
+inclusion to an arbitrary remote region. Do not invent a 24-jet roster.
+
+## P15 combinatorics
+
+| Read in order | Source | Important distinction |
+|---|---|---|
+| Local-cover interface | [Original P15-B](https://drive.google.com/file/d/19D-eHQAIXMGGy2ThZUfZ0GGjIKWm5C2j/view) | Actual local restrictions and budgets at the same prices. |
+| Palette optimization | [Matroid specialization #59](https://github.com/d6g8k5htny-coder/main/issues/59) | Structural hypotheses are required. |
+| Realized family | [Original-coordinate covers](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/three_fronts_20260924/P15_REALIZED_COVERS.md) | 816 is the specified cover threshold named by that note. The whole ground set is a different count there. |
+| Failed extension | [Two-coordinate price boundary](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/three_fronts_20260924/P15_PRICE_BOUNDARY.md) | The unchanged-palette extension to all transformed prices, without extra hypotheses, stays false. |
+| Restricted successor | [Transformed-price budget](https://github.com/d6g8k5htny-coder/Math-/blob/main/frontiers/price_budget_20260924/PROOF.md) | Extra hypotheses. This does not retract the failed extension and does not close a prize. |
+
+Original prize problems solved remain 0, as the [home page](../README.md)
+records. Use [review #67](https://github.com/d6g8k5htny-coder/main/issues/67)
+for the external discussion. A checker certificate of a local budget is not a
+proof that nothing outside that budget exists.
+
+## Open work
+
+| Front | Next substantive target | Existing discussion |
+|---|---|---|
+| Gaussian proof review | Challenge the marked Kac–Rice/elder interface, matrix regression, and all-mark cutoff estimates | [#63](https://github.com/d6g8k5htny-coder/main/issues/63), [#67](https://github.com/d6g8k5htny-coder/main/issues/67) |
+| Quantitative Gaussian estimates | A useful remainder constant and lifetime range are still open | [#67](https://github.com/d6g8k5htny-coder/main/issues/67) |
+| Coefficient audit | Cone truncation, image/normalization comparison, and outward arithmetic | [#65](https://github.com/d6g8k5htny-coder/main/issues/65) |
+| RN and 24-jet route | The count-weighted integral on its declared region, and the missing numerical enclosures | [RN status](math_status/STATUS_RN_UNIF.md), [execution](RESEARCH_EXECUTION.md) |
+| Local obligations | `OBL-H5-JETMOD` and `D3-LEMMA-RN-UNIF` stay OPEN | [math status](math_status/STATUS.md), [JETMOD status](math_status/STATUS_JETMOD.md) |
+| P15 scope | Audit the realized family and the restricted price theorem | [#59](https://github.com/d6g8k5htny-coder/main/issues/59), [#67](https://github.com/d6g8k5htny-coder/main/issues/67) |
+
+These are existing targets. [Campaign #61](https://github.com/d6g8k5htny-coder/main/issues/61)
+is an external collaboration surface. This page does not start a scheduler,
+merge a draft hold, or award independence credit.
+
+## Source lookup
+
+The [exact-source catalog](https://github.com/d6g8k5htny-coder/meta-framework/blob/main/registry.json)
+and [query tool](https://github.com/d6g8k5htny-coder/query-) connect named keys
+to commits and hashes. They track identity, not scientific acceptance. The
+[workspace guide](WORKSPACE.md) separates `main`, this hardening branch, and
+Drive. The [research map](RESEARCH_MAP.md) is the lane map for this tree.
diff --git a/docs/VERIFICATION_RUNNER.md b/docs/VERIFICATION_RUNNER.md
index dcf4e0588..5766eec9e 100644
--- a/docs/VERIFICATION_RUNNER.md
+++ b/docs/VERIFICATION_RUNNER.md
@@ -27,7 +27,8 @@ execution-contract enforcement mechanism, or a security sandbox.
The parser accepts only the current CI header/setup and pairs of literal
`name:`/`run:` lines. Its explicit required-command policy includes all 24
original checker invocations, the RN certificate replay, the derived-frontier
-self-check, the LPW amplitude diagnostic, the static closure-plan check, and
+self-check, the LPW amplitude diagnostic, the static closure-plan check, the
+declared navigation-link check, the navigation synthetic unittest, and
pytest. Commands are matched exactly and must each occur once;
pytest must run last. Omitted checks, empty coverage, duplicate commands,
conditional steps, environment additions, multiline shell, dynamic expressions,
diff --git a/docs/WORKSPACE.md b/docs/WORKSPACE.md
new file mode 100644
index 000000000..ca7d99c27
--- /dev/null
+++ b/docs/WORKSPACE.md
@@ -0,0 +1,54 @@
+# Workspace
+
+[Home](../README.md) · [Research index](RESEARCH_INDEX.md) · [Reproduction](REPRODUCE.md)
+
+Checkout guide for `chatgpt/drive-github-hardening-20260919`. This page does
+not merge the tree into `main` and does not invent a source of truth.
+
+## Choose the correct checkout
+
+| Location | What is actually there |
+|---|---|
+| [main](https://github.com/d6g8k5htny-coder/main) | Separate default branch. This navigation port does not target it. |
+| [this hardening branch](https://github.com/d6g8k5htny-coder/main/tree/chatgpt/drive-github-hardening-20260919) | This checkout: registers, research code, fail-closed math status, and these reading routes. |
+| [Math-](https://github.com/d6g8k5htny-coder/Math-) | Separate repository of mathematical candidates and tests. |
+| [Claude migration branch](https://github.com/d6g8k5htny-coder/main/tree/claude/drive-audit-github-migration-rrglpp) | Other history. Compare exact heads before any integration. |
+
+A green navigation check of this tree does not review the external Math-
+candidates. Holds that were already never-merge stay never-merge. This page
+does not retarget them.
+
+## Drive and source identity
+
+[Drive Research Home](https://docs.google.com/document/d/180yfvocozAaFRxf7tY8CDrobnpi17Sv-UkQGBBWCiD8)
+and the [research registers / Work Events](https://docs.google.com/spreadsheets/d/1O6x8ivmaVUxYqKmCOXmToIHpMXqDI362ibqBl8HY8no)
+remain the governing records. SIDE24 has no new source-of-truth carrier after
+2026-08-06. Objects marked **ABSENT** in [RN_SIDE24.md](RN_SIDE24.md) stay
+**ABSENT**. Quarantine is not a source of truth.
+
+[google-drive](https://github.com/d6g8k5htny-coder/google-drive) holds selected
+public replicas, not a complete backup. The
+[source catalog](https://github.com/d6g8k5htny-coder/meta-framework) and
+[lookup tool](https://github.com/d6g8k5htny-coder/query-) bind public
+identities, not scientific acceptance. Private experiments stay private.
+
+## Continue useful work
+
+Read the source and the [owner instruction on this branch](../governance/OP-AUTONOMY-20260923-v2.0.md).
+Use a separate branch, inspect the real diff, and record what ran.
+[Open work](RESEARCH_INDEX.md#open-work) lists targets. Adding this page does
+not start a scheduler. `inventable_attempt_accepted` stays false.
+`OBL-H5-JETMOD` and `D3-LEMMA-RN-UNIF` stay OPEN. `lemma_closed`,
+`prizes_solved`, `discharges_OBL_H5_JETMOD`, and `certified_C_H` stay false.
+
+## Run this tree
+
+```sh
+git clone --filter=blob:none --single-branch --branch chatgpt/drive-github-hardening-20260919 https://github.com/d6g8k5htny-coder/main.git research-workspace
+cd research-workspace
+git rev-parse HEAD
+```
+
+Then read [execution](RESEARCH_EXECUTION.md), [reproduction](REPRODUCE.md), and
+the [research map](RESEARCH_MAP.md). A navigation check is engineering
+hygiene. It is not the research CI and it is not discharge.
diff --git a/tests/test_navigation.py b/tests/test_navigation.py
new file mode 100644
index 000000000..4d5e25136
--- /dev/null
+++ b/tests/test_navigation.py
@@ -0,0 +1,120 @@
+"""Synthetic navigation controls. The public readback tests use mocks, not the network."""
+import hashlib
+import importlib.util
+import io
+import json
+from pathlib import Path
+import tempfile
+import unittest
+from unittest.mock import patch
+
+spec=importlib.util.spec_from_file_location('nav',Path(__file__).resolve().parents[1]/'tools/navigation_check.py')
+n=importlib.util.module_from_spec(spec);spec.loader.exec_module(n)
+
+
+class NavigationTests(unittest.TestCase):
+ def setUp(self):
+ self.tmp=tempfile.TemporaryDirectory();self.addCleanup(self.tmp.cleanup)
+ self.root=Path(self.tmp.name);(self.root/'docs').mkdir()
+ (self.root/'README.md').write_text('# Home\n[Guide](docs/guide.md#result)\n')
+ (self.root/'docs/guide.md').write_text('# Guide\n## Result\n[Home](../README.md)\n')
+ self.data={'version':1,'pages':['README.md','docs/guide.md'],'public_targets':[]}
+ self.save()
+ def save(self): (self.root/'docs/NAVIGATION.json').write_text(json.dumps(self.data))
+ def test_valid(self): self.assertEqual(n.check(self.root)['problems'],[])
+ def test_counts(self):
+ r=n.check(self.root);self.assertEqual(r['local_links'],2);self.assertEqual(r['fragment_links'],1)
+ def test_missing_page(self):
+ (self.root/'docs/guide.md').unlink()
+ with self.assertRaises(OSError): n.check(self.root)
+ def test_missing_fragment(self):
+ (self.root/'docs/guide.md').write_text('# Renamed\n')
+ self.assertIn('fragment',n.check(self.root)['problems'][0])
+ def test_duplicate_headings(self): self.assertEqual(n.anchors('# A\n## A\n## A'),{'a','a-1','a-2'})
+ def test_formatting_in_heading(self): self.assertIn('read-this-now',n.anchors('# Read **this** now!'))
+ def test_custom_anchor(self): self.assertIn('exact',n.anchors(''))
+ def test_fenced_examples_ignored(self):
+ (self.root/'README.md').write_text('```md\n[Fake](no.md)\n```\n# Home\n')
+ self.assertEqual(n.check(self.root)['problems'],[])
+ def test_root_escape(self):
+ (self.root/'README.md').write_text('[Bad](../../bad.md)')
+ self.assertTrue(n.check(self.root)['problems'])
+ def test_symlink_rejected(self):
+ (self.root/'sym.md').symlink_to(self.root/'docs/guide.md')
+ (self.root/'README.md').write_text('[Bad](sym.md)')
+ self.assertIn('symlink',n.check(self.root)['problems'][0])
+ def test_unsupported_scheme(self):
+ (self.root/'README.md').write_text('[Bad](javascript:alert)')
+ self.assertTrue(n.check(self.root)['problems'])
+ def test_percent_encoded_anchor(self):
+ (self.root/'README.md').write_text('[Good](docs/guide.md#%72esult)')
+ self.assertEqual(n.check(self.root)['problems'],[])
+ def test_duplicate_manifest_key(self):
+ (self.root/'docs/NAVIGATION.json').write_text('{"version":1,"version":1}')
+ with self.assertRaisesRegex(ValueError,'duplicate'): n.load(self.root)
+ def test_duplicate_page(self):
+ self.data['pages'].append('README.md');self.save()
+ with self.assertRaises(ValueError): n.load(self.root)
+ def target(self):
+ row={'repository':'Math-','ref':'main','path':'proof.md','bytes':2,'sha256':hashlib.sha256(b'x\n').hexdigest()}
+ self.data['public_targets']=[row];self.save()
+ (self.root/'README.md').write_text('[Proof](https://github.com/d6g8k5htny-coder/Math-/blob/main/proof.md)')
+ return row
+ def test_private_target_refused(self):
+ row=self.target();row['repository']='sandbox';self.save()
+ with self.assertRaisesRegex(ValueError,'nonpublic'): n.load(self.root)
+ def test_unlinked_target_refused(self):
+ self.target();(self.root/'README.md').write_text('# Home')
+ self.assertIn('no direct navigation link',n.check(self.root)['problems'][0])
+ def test_public_readback_exact(self):
+ self.target()
+ with patch.object(n.urllib.request,'urlopen',return_value=io.BytesIO(b'x\n')):
+ r=n.check(self.root,True)
+ self.assertEqual(r['problems'],[]);self.assertEqual(len(r['public_sources_verified']),1)
+ def test_public_changed_bytes(self):
+ self.target()
+ with patch.object(n.urllib.request,'urlopen',return_value=io.BytesIO(b'y\n')):
+ self.assertIn('changed',n.check(self.root,True)['problems'][0])
+ def test_no_implicit_network(self):
+ self.target()
+ with patch.object(n.urllib.request,'urlopen',side_effect=AssertionError('network called')):
+ self.assertEqual(n.check(self.root)['public_sources_verified'],[])
+ def test_invalid_public_path(self):
+ row=self.target();row['path']='../sandbox/secret';self.save()
+ with self.assertRaises(ValueError): n.load(self.root)
+ def test_invalid_boolean_size(self):
+ row=self.target();row['bytes']=True;self.save()
+ with self.assertRaises(ValueError): n.load(self.root)
+ def test_public_transport_error(self):
+ self.target()
+ with patch.object(n.urllib.request,'urlopen',side_effect=OSError('offline')):
+ self.assertIn('offline',n.check(self.root,True)['problems'])
+ def test_no_writes(self):
+ before={str(p):p.read_bytes() for p in self.root.rglob('*') if p.is_file()}
+ n.check(self.root)
+ self.assertEqual(before,{str(p):p.read_bytes() for p in self.root.rglob('*') if p.is_file()})
+
+ def test_repository_navigation_pages_resolve(self):
+ root=Path(__file__).resolve().parents[1]
+ result=n.check(root)
+ self.assertEqual(result['problems'],[],result)
+
+ def test_navigation_pages_do_not_flip_claim_flags(self):
+ root=Path(__file__).resolve().parents[1]
+ data=n.load(root)
+ banned=(
+ 'lemma_closed: true','lemma_closed": true','lemma_closed=true',
+ 'prizes_solved: true','prizes_solved": true','prizes_solved=true',
+ 'discharges_obl_h5_jetmod: true','discharges_obl_h5_jetmod": true',
+ 'discharges_obl_h5_jetmod=true',
+ 'certified_c_h: true','certified_c_h": true','certified_c_h=true',
+ 'inventable_attempt_accepted: true','inventable_attempt_accepted": true',
+ 'inventable_attempt_accepted=true',
+ )
+ for page in data['pages']:
+ text=(root/page).read_text().lower()
+ for token in banned:
+ self.assertNotIn(token,text,page+' contains '+token)
+
+
+if __name__=='__main__':unittest.main()
diff --git a/tests/test_run_checks.py b/tests/test_run_checks.py
index ee174e6b2..077fcb95a 100644
--- a/tests/test_run_checks.py
+++ b/tests/test_run_checks.py
@@ -47,6 +47,15 @@ def repository(tmp_path):
for command in runner.REQUIRED_COMMANDS:
if command.startswith("python tools/"):
(root / command.split()[1]).write_text("print('fixture checker executed')\n")
+ # The navigation unittest is an exact CI command. Keep it out of pytest
+ # collection so the fixture's two test_tiny cases stay the pytest count.
+ if "python -m unittest tests.test_navigation -v" in runner.REQUIRED_COMMANDS:
+ (root / "tests/test_navigation.py").write_text(
+ "import unittest\n"
+ "class NavigationFixture(unittest.TestCase):\n"
+ " def test_passes(self):\n"
+ " self.assertTrue(True)\n")
+ (root / "pytest.ini").write_text("[pytest]\npython_files = test_tiny.py\n")
shutil.copyfile(ROOT / "tools/run_checks.py", root / "tools/run_checks.py")
(root / "tests/test_tiny.py").write_text(
"import pathlib, subprocess, sys\n"
diff --git a/tests/test_workflows.py b/tests/test_workflows.py
index 1294d13e3..832d2dd9f 100644
--- a/tests/test_workflows.py
+++ b/tests/test_workflows.py
@@ -115,7 +115,9 @@ def masked_checker_lines(text: str) -> list[str]:
def test_workflow_files_exist():
# Keep an exact reviewed inventory: do not accept arbitrary new workflows.
- assert [p.name for p in WORKFLOWS] == ["ci.yml", "research.yml", "withdrawal-governance.yml"]
+ # navigation.yml runs only the declared page checker and its synthetic tests.
+ assert [p.name for p in WORKFLOWS] == [
+ "ci.yml", "navigation.yml", "research.yml", "withdrawal-governance.yml"]
@pytest.mark.parametrize("path", WORKFLOWS, ids=lambda p: p.name)
diff --git a/tools/navigation_check.py b/tools/navigation_check.py
new file mode 100644
index 000000000..f2dec4c56
--- /dev/null
+++ b/tools/navigation_check.py
@@ -0,0 +1,152 @@
+"""Declared navigation pages/anchors and optional bounded public-source readback.
+No repository writes or retrieved-code execution. Not a whole-GitHub crawler.
+"""
+from __future__ import annotations
+import argparse
+import hashlib
+import json
+from pathlib import Path, PurePosixPath
+import re
+from urllib.parse import unquote, urlsplit
+import urllib.request
+
+ROOT=Path(__file__).resolve().parents[1]
+PUBLIC={'main','Math-','meta-framework','query-','google-drive','trial','governance-'}
+LINK=re.compile(r'\[[^\]\n]*\]\(([^\s)]+)\)')
+
+
+def unique(pairs):
+ result={}
+ for key,value in pairs:
+ if key in result: raise ValueError('duplicate JSON key')
+ result[key]=value
+ return result
+
+
+def lines_outside_fences(text):
+ fence=None
+ for line in text.splitlines():
+ match=re.match(r'\s*(`{3,}|~{3,})',line)
+ if match:
+ token=match.group(1)
+ if fence is None: fence=token
+ elif token[0]==fence[0] and len(token)>=len(fence): fence=None
+ continue
+ if fence is None: yield line
+
+
+def anchors(text):
+ result=set()
+ for line in lines_outside_fences(text):
+ result.update(re.findall(r'1_000_000: raise ValueError('manifest too large')
+ data=json.loads(path.read_text(),object_pairs_hook=unique)
+ if not isinstance(data,dict) or type(data.get('version')) is not int or data['version']!=1:
+ raise ValueError('unknown navigation schema')
+ pages=data.get('pages')
+ if not isinstance(pages,list) or not 1<=len(pages)<=32 or not all(isinstance(p,str) for p in pages) or len(set(pages))!=len(pages):
+ raise ValueError('invalid page list')
+ rows=data.get('public_targets')
+ if not isinstance(rows,list) or len(rows)>64: raise ValueError('invalid public targets')
+ seen=set()
+ for row in rows:
+ if not isinstance(row,dict) or row.get('repository') not in PUBLIC: raise ValueError('nonpublic target refused')
+ path=row.get('path')
+ if not isinstance(path,str) or not path or '\\' in path or ':' in path: raise ValueError('invalid public path')
+ pp=PurePosixPath(path)
+ if pp.is_absolute() or '..' in pp.parts or str(pp)!=path: raise ValueError('unsafe public path')
+ if row.get('ref')!='main': raise ValueError('this manifest checks default main targets')
+ if type(row.get('bytes')) is not int or not 0<=row['bytes']<=1_000_000: raise ValueError('invalid size')
+ if not isinstance(row.get('sha256'),str) or not re.fullmatch('[0-9a-f]{64}',row['sha256']): raise ValueError('invalid hash')
+ key=(row['repository'],path)
+ if key in seen: raise ValueError('duplicate public target')
+ seen.add(key)
+ return data
+
+
+def public_readback(row):
+ url=f"https://raw.githubusercontent.com/d6g8k5htny-coder/{row['repository']}/main/{row['path']}"
+ with urllib.request.urlopen(url,timeout=20) as response:
+ raw=response.read(row['bytes']+1)
+ if len(raw)!=row['bytes'] or hashlib.sha256(raw).hexdigest()!=row['sha256']:
+ raise ValueError('public source changed: '+row['repository']+'/'+row['path'])
+ return row['repository']+'/'+row['path']
+
+
+def check(root=ROOT, verify_public=False):
+ root=Path(root).resolve(strict=True)
+ data=load(root)
+ problems=[]; local=fragments=external=0; readback=[]
+ links=set()
+ for page in data['pages']:
+ text=safe_file(root,page).read_text()
+ for line in lines_outside_fences(text):
+ for target in LINK.findall(line):
+ links.add(target)
+ parsed=urlsplit(target)
+ if parsed.scheme in ('https','http','mailto'):
+ external+=1; continue
+ if parsed.scheme or parsed.netloc:
+ problems.append(page+': unsupported link '+target); continue
+ try:
+ rel=str(PurePosixPath(page).parent/unquote(parsed.path)) if parsed.path else page
+ dest=safe_file(root,rel)
+ local+=1
+ if parsed.fragment:
+ fragments+=1
+ if unquote(parsed.fragment) not in anchors(dest.read_text()): raise ValueError('missing fragment '+parsed.fragment)
+ except (ValueError,OSError) as error:
+ problems.append(page+': '+target+': '+str(error))
+ for row in data['public_targets']:
+ target=f"https://github.com/d6g8k5htny-coder/{row['repository']}/blob/main/{row['path']}"
+ if target not in links: problems.append('listed public source has no direct navigation link: '+target)
+ if verify_public:
+ for row in data['public_targets']:
+ try: readback.append(public_readback(row))
+ except (ValueError,OSError) as error: problems.append(str(error))
+ return {'pages':len(data['pages']),'local_links':local,'fragment_links':fragments,
+ 'external_links_not_crawled':external,'public_sources_verified':readback,
+ 'problems':problems,'scope':'declared inline links/ATX anchors and optional named public bytes only; not research acceptance'}
+
+
+def main():
+ p=argparse.ArgumentParser(description=__doc__)
+ p.add_argument('--root',type=Path,default=ROOT)
+ p.add_argument('--verify-public',action='store_true')
+ args=p.parse_args()
+ try: result=check(args.root,args.verify_public)
+ except (ValueError,OSError,TypeError,KeyError) as error:
+ print(json.dumps({'error':str(error)})); return 2
+ print(json.dumps(result,indent=2,sort_keys=True))
+ return 1 if result['problems'] else 0
+
+
+if __name__=='__main__': raise SystemExit(main())
diff --git a/tools/run_checks.py b/tools/run_checks.py
index c752255c9..73d27432c 100644
--- a/tools/run_checks.py
+++ b/tools/run_checks.py
@@ -85,6 +85,8 @@
"python tools/lpw_amplitude_check.py",
"python tools/closure_pipeline.py check-plan",
"python tools/math_status_check.py",
+ "python tools/navigation_check.py",
+ "python -m unittest tests.test_navigation -v",
"python -m pytest -q",
)
CI_PREFIX = '''name: ci