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