diff --git a/README.md b/README.md index 1ffec061b..d52ef61e9 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ **Gaussian random fields, persistent homology, and reproducible multi-model mathematical research.** -[![CI](https://github.com/d6g8k5htny-coder/main/actions/workflows/ci.yml/badge.svg)](https://github.com/d6g8k5htny-coder/main/actions/workflows/ci.yml) +[![Landing checks](https://github.com/d6g8k5htny-coder/main/actions/workflows/workspace-landing.yml/badge.svg?branch=main)](https://github.com/d6g8k5htny-coder/main/actions/workflows/workspace-landing.yml) [![Navigation](https://github.com/d6g8k5htny-coder/main/actions/workflows/navigation.yml/badge.svg)](https://github.com/d6g8k5htny-coder/main/actions/workflows/navigation.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) @@ -14,6 +14,8 @@ This is the **single public front door** for the Universal Law research program. The static app is live on main's GitHub Pages, published from `main` / `docs`. See the [deployment and review settings record](docs/PUBLIC_SHOP_SETUP.md). All views preserve scoped ACCEPT, AMEND/open, and engineering-only distinctions. They cannot change scientific status. +**Quick browser demo:** [Open the SIDE24 notebook in Colab](https://colab.research.google.com/github/d6g8k5htny-coder/main/blob/main/docs/notebooks/SIDE24_PUBLIC_COEFFICIENTS.ipynb), then choose **Runtime → Run all**. Read the verified source identity and exact coefficient endpoints for dimensions 2 and 3; the optional chart is **NON-CERTIFYING**. You need no local checkout or installation. The [notebook guide](docs/notebooks/README.md) also explains local setup and dependencies. + ## Public source path For a stranger who wants the landed mathematics rather than the live agent queue, use this order: @@ -34,6 +36,8 @@ For a stranger who wants the landed mathematics rather than the live agent queue For byte identity, use the [public source inventory](docs/public-math/sources.json): its 2,138 frozen source rows are split across the linked JSON pages, and every row records a GitHub repository, path, 40-character commit, Git blob, byte count, and SHA-256. The inventory excludes sandbox, quarantine, and personal paths and is an availability/custody index, not an acceptance register. +**Recovered historical falsifiers:** the [STAGE_E source packet](https://github.com/d6g8k5htny-coder/Math-/blob/a2c3657c3115853a9bd8642b78c3f9ca0bbc59d1/imports/upper2d_stage_e_20260926/README.md) preserves 11 exact files, a reproduced finite H4-JC counterexample, and a source-bound review of numerical defects. Its original certification labels are historical text; the packet does not establish Gaussian continuum or Palm claims. This additive recovery is separate from the frozen inventory above. + **Open draft PRs are visible research/review material, but they are not default-branch mathematics.** Do not treat an AMEND draft, review branch, or custody PR as landed proof merely because GitHub can display it. ## Current status diff --git a/docs/notebooks/README.md b/docs/notebooks/README.md index 2ca161a5c..55a9944bc 100644 --- a/docs/notebooks/README.md +++ b/docs/notebooks/README.md @@ -2,10 +2,47 @@ [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/d6g8k5htny-coder/main/blob/main/docs/notebooks/SIDE24_PUBLIC_COEFFICIENTS.ipynb) -Open [SIDE24_PUBLIC_COEFFICIENTS.ipynb](SIDE24_PUBLIC_COEFFICIENTS.ipynb) on GitHub or in Colab, then run the cells in order. It fetches one public JSON file at a fixed 40-character Math- commit and verifies its size and SHA256 before parsing. +## Quick start in your browser + +1. [Read the saved notebook output on GitHub](SIDE24_PUBLIC_COEFFICIENTS.ipynb), or use **Open in Colab** above to run it without a local installation. +2. In Colab, choose **Runtime → Run all** and follow any connection prompt. Runtime startup and the source download can take time. +3. Check the printed source commit, byte count and SHA256, then read the exact coefficient endpoints for dimensions 2 and 3. The optional chart follows the table. + +The notebook fetches one public JSON file at a fixed 40-character Math- commit and verifies its size and SHA256 before parsing. A fresh run needs internet access to `raw.githubusercontent.com`; a fetch or identity failure stops the run. The notebook preserves the published decimal endpoint strings and original `scientific_acceptance: false`. Its optional two-bar chart uses approximate midpoints and is **NON-CERTIFYING**. No random field or lifetime solver runs, and the notebook cannot change repository status. The exact table needs only Python's standard library; the chart uses Matplotlib if available. +## Run locally + +Use Python 3.11 or later. The notebook's dependency groups are: + +| Part | Dependencies | +|---|---| +| Fetch, hash verification and exact table | Python standard library: `hashlib`, `json`, `urllib.request`, `decimal` | +| Local notebook interface | JupyterLab and its installed dependencies | +| Optional approximate chart | Matplotlib and its installed dependencies; the notebook skips the chart when Matplotlib is absent | + +From the root of a checkout of this `main` repository, create a separate environment. These commands use a macOS/Linux shell and put the environment beside the checkout: + +```sh +python3 -m venv ../universal-law-notebook-env +. ../universal-law-notebook-env/bin/activate +python -m pip install jupyterlab +python -m jupyterlab docs/notebooks/SIDE24_PUBLIC_COEFFICIENTS.ipynb +``` + +Select the environment's Python kernel and run the cells in order. For the optional chart, install Matplotlib in the same activated environment before starting JupyterLab: + +```sh +python -m pip install matplotlib +``` + +On Windows, create the environment with `py -3 -m venv ..\universal-law-notebook-env` and activate it with `..\universal-law-notebook-env\Scripts\Activate.ps1` in PowerShell; the remaining `python` commands are the same. If you already have a notebook interface and Python kernel, use those directly. + +These are notebook setup dependencies, not a dependency specification for the separate research branch or query package. The commands install compatible available package versions rather than a locked environment. Record your Python, JupyterLab and Matplotlib versions when sharing a replay. See the [JupyterLab installation guide](https://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html) and [Matplotlib installation guide](https://matplotlib.org/stable/install/index.html) for platform-specific setup. + +## Source and scope + Input: [`Math-@9d7b6802424fb4715b31999066aafca8ee2f3cca:coefficients/side24_v1/ENCLOSURE.json`](https://github.com/d6g8k5htny-coder/Math-/blob/9d7b6802424fb4715b31999066aafca8ee2f3cca/coefficients/side24_v1/ENCLOSURE.json), 1090 bytes, SHA256 `72b6cd92d31394cdaf5da8919a5d548e902228af1f095cc184158a71d8287811`. See the [scoped coefficient review](https://github.com/d6g8k5htny-coder/main/issues/65#issuecomment-5841269490) and [current program status](https://github.com/d6g8k5htny-coder/main/blob/main/STATUS.md) separately. Viewing or replaying these numbers does not accept a parent theorem. The public inventory remains [`../public-math/`](../public-math/sources.json); these files create no separate catalog.