Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 52 additions & 0 deletions .github/ISSUE_TEMPLATE/task.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
name: Public contribution task
description: A bounded replay, chart, review comment, catalog note or documentation task
title: "[Task] "
labels: [eng-only]
body:
- type: markdown
attributes:
value: |
Claim one open task at a time by commenting `/claim`. A maintainer records
the claimant and assigns the issue when GitHub permits. `/claim` is a
coordination convention, not an automatic bot command or a permission grant.
Submit results through a fork PR under `incoming/<new-id>/`.
Publication and passing checks do not accept mathematics.
- type: dropdown
id: type
attributes:
label: Task type
options: [replay, chart, review-comment, catalog-stub, docs]
validations:
required: true
- type: textarea
id: source
attributes:
label: Exact public source
description: Give the existing inventory key or import ID, repository, path, full 40-character commit, and SHA-256. Link the public bytes. No Drive-only source.
validations:
required: true
- type: textarea
id: deliverable
attributes:
label: Bounded deliverable and verification
description: Say what can be completed, how it is checked, and where uncertainty remains. Use the existing docs/public-math inventory; do not make a second catalog.
validations:
required: true
- type: textarea
id: claim
attributes:
label: Claim and release rule
value: "Comment /claim before starting; keep one open claim per person. Link the results PR, or comment /release if you stop. A maintainer updates the assignment and task state."
validations:
required: true
- type: checkboxes
id: boundary
attributes:
label: Contribution boundary
options:
- label: This task does not edit ACCEPT/AMEND rows, STATUS.md, PROOF_INDEX, LANDING_CLAIMS, claims, prizes, or lemma_closed.
required: true
- label: This task does not merge AMEND mathematics or copy sandbox work into Math-; its results require review.
required: true
- label: The task uses pinned public bytes and labels numerical output or illustrations without claiming theorem acceptance.
required: true
25 changes: 25 additions & 0 deletions .github/workflows/public-intake-controls.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Kept separate so pull_request events cannot emit a skipped/successful
# public-intake check with the same name as the trusted guard.
name: Public intake checker controls
on:
pull_request:
branches: [main]
paths: ['tools/public_intake_check.py', 'tests/test_public_intake.py', '.github/workflows/public-intake.yml', '.github/workflows/public-intake-controls.yml']
push:
branches: [main]
paths: ['tools/public_intake_check.py', 'tests/test_public_intake.py', '.github/workflows/public-intake.yml', '.github/workflows/public-intake-controls.yml']
permissions:
contents: read
jobs:
intake-controls:
name: intake-controls
runs-on: ubuntu-latest
timeout-minutes: 5
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
with:
persist-credentials: false
- name: Run positive and refusal controls without network
run: |
python3 -B -S -m unittest discover -s tests -p test_public_intake.py -v
python3 -B -O -S -m unittest discover -s tests -p test_public_intake.py -v
28 changes: 28 additions & 0 deletions .github/workflows/public-intake.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
name: Public results intake
on:
# Read trusted default-branch workflow and checker only. Never checkout a
# submitted branch or execute submitted code in this workflow.
pull_request_target:
branches: [main]
types: [opened, reopened, synchronize, edited, labeled, unlabeled, ready_for_review]
permissions:
contents: read
pull-requests: read
jobs:
public-intake:
name: public-intake
runs-on: ubuntu-latest
timeout-minutes: 5
steps:
- name: Read trusted default-branch checker
uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
with:
# github.sha is the trusted default-branch commit for this event.
ref: ${{ github.sha }}
persist-credentials: false
sparse-checkout: tools/public_intake_check.py
sparse-checkout-cone-mode: false
- name: Verify intake from API bytes without checking out the PR
env:
GH_TOKEN: ${{ github.token }}
run: python3 -B -I tools/public_intake_check.py
24 changes: 24 additions & 0 deletions .github/workflows/public-shop.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
name: public-shop
on:
pull_request:
branches: [main]
push:
branches: [main]
workflow_dispatch:
permissions:
contents: read
jobs:
public-shop:
runs-on: ubuntu-latest
timeout-minutes: 5
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262
with:
persist-credentials: false
fetch-depth: 0
- name: Status-export negative controls
run: python3 -B -m unittest discover -s tests -p test_public_shop_data.py
- name: Browser data-validation controls
run: node --test tests/test_public_shop_frontend.mjs
- name: Pinned public source readback and interaction harness
run: python3 -B tools/public_shop_check.py
101 changes: 101 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,107 @@ participants and may be improved by them.
4. Check the current branch and exact head. A merge is not a semantic
reconciliation, and a stale base silently changes what your diff means.

## Pick a public task

Use [public tasks](https://github.com/d6g8k5htny-coder/main/issues?q=is%3Aissue+is%3Aopen+label%3Aeng-only)
or [propose a bounded task](https://github.com/d6g8k5htny-coder/main/issues/new?template=task.yml).
The starter types are `replay`, `chart`, `review-comment`, `catalog-stub`, and
`docs`. Cite the existing key, public path, full commit and digest from
[the single public inventory](docs/PUBLIC_MATHEMATICS.md). An import is a byte
copy for review, not an accepted result.

Comment `/claim` before beginning. Keep one open claim per person; a maintainer
records the claimant and assigns the issue when GitHub permits. Link your PR when
ready, or comment `/release` if you stop. These are manual coordination conventions,
not an installed claim bot. The task states are `open` → `claimed` → `results-pr`
→ `review` → `parked` or `landed-eng`. `landed-eng` means published engineering
or review material, not mathematical acceptance.

Good tasks regenerate a chart from pinned JSON, document one existing import ID,
or submit a precisely located review comment. Closing the D1 parent or accepting
SARD-G is not a public starter task. Do not edit ACCEPT/AMEND rows, `STATUS.md`,
`PROOF_INDEX`, `LANDING_CLAIMS`, `claims/`, prizes or `lemma_closed`, or merge AMEND
mathematics. Math- remains the proof vault; sandbox and trial are not upload lanes.

## Submit public results for review

1. Fork this repository and create a branch from its current `main`.
2. Add a **new** `incoming/<id>/` directory. Use a short lowercase ID containing
letters, digits or hyphens, for example `incoming/side24-replay-yourname/`.
Change only files in that one new directory. For a correction after landing,
use a new ID and link the previous result; earlier submissions remain readable.
3. Include `RESULT.md`, your `output.json` and/or plots, and `IDENTITY.json`.
In `RESULT.md`, link the task and describe the exact source commit, command or
method, runtime, result, limitations and any source exposure. State that the
result is for review and has scientific effect `NONE`. A numerical result or
plot is not a theorem. Never upload credentials, personal data or private sources.
4. In `IDENTITY.json`, list every artifact except the identity file itself with
its byte count and SHA-256. List one to eight public source files by repository,
path, full 40-character commit and SHA-256. The checker reads those exact public
bytes. Use the real values, not the placeholders in this schema:

```json
{
"schema": 1,
"scientific_effect": "NONE",
"review_status": "REVIEW_REQUIRED",
"sources": [
{
"repository": "d6g8k5htny-coder/Math-",
"path": "path/to/public/source.json",
"commit": "REPLACE_WITH_40_LOWERCASE_HEX_CHARACTERS",
"sha256": "REPLACE_WITH_64_LOWERCASE_HEX_CHARACTERS"
}
],
"artifacts": [
{"path": "RESULT.md", "bytes": 123, "sha256": "REPLACE_WITH_REAL_SHA256"},
{"path": "output.json", "bytes": 456, "sha256": "REPLACE_WITH_REAL_SHA256"}
]
}
```

Generate byte counts with `len(Path(name).read_bytes())` and digests with
`hashlib.sha256(Path(name).read_bytes()).hexdigest()` in Python, or use
`wc -c` and `sha256sum`. Artifact paths are relative to the new package.
The identity file is excluded to avoid a circular self-hash; its Git blob and
PR head are checked separately.
5. Open a draft PR **against this repository's `main`**, link the claimed task,
and request the `results-for-review` label. A maintainer applies it if you cannot.
Mark the PR ready when the result is ready to review. Removing the label cannot
bypass the guard: a fork, an `incoming/` path, or that label independently selects
the restricted lane.
6. A human or designated agent reviews the content and exact bytes. If accepted
for publication, the PR lands only in `incoming/`. This is not automatic merge,
a theorem verdict, or transfer into Math-. A later audit needs its own reviewed
engineering PR; no upload changes the scientific registers.

The first intake version accepts UTF-8 `.md`, `.txt`, `.json`, `.csv`, and `.png`
files, with at most 50 files, 256 KiB per file and 2 MiB per package. Source files
must be public in `main`, `Math-`, `query-` or `Universal-Law-Workspace` and regular
files of at most 2 MiB, bound to their exact commit-tree path and blob. Scripts, notebooks,
HTML, SVG, archives, executable files, symlinks and submodules are refused here.
For code or a notebook proposal, describe it in an issue; a maintainer can sponsor
a separate engineering PR. Do not encode a refused file inside an allowed format.

`public-intake` runs trusted default-branch code with a read-only token. It reads
PR metadata and blobs through the GitHub API, checks complete path lists and source
identities, and fails on missing information or a changing PR. It never checks
out or executes submitted code. The credential scan catches a small documented
set of recognizable private-key/token patterns; **it is not a complete secret
scanner**, and a green check cannot establish that content is safe or correct.
Reviewers must inspect the content before merging. Source readback proves identity
and public availability, not the source's acceptance or the output's correctness.

Maintainer branches in this repository can still submit ordinary engineering PRs.
Adding an `incoming/` change or `results-for-review` label also restricts those PRs.
Require PR review and the `public-intake` check in repository rules before treating
this workflow as an enforced merge boundary. The workflow file alone does not
install branch protection or prevent an administrator bypass. Before merging,
the designated reviewer must verify that the actual `Public results intake` run
used the trusted `pull_request_target` workflow and reports the PR's current exact
head. A check name alone does not bind its workflow or event identity; a similarly
named check from a submitted workflow is not the trusted intake guard.

## Evidence standards

These are not style preferences. A change that breaks one of them will be sent
Expand Down
12 changes: 9 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,21 +8,27 @@

This is the **single public front door** for the Universal Law research program. The project studies persistence lifetimes and critical-point geometry of Gaussian random fields, together with exact/reproducible computational methods and a fail-closed review workflow. Proofs, code, reviews, and source identities live in several focused repositories, but readers should start here.

## Public research shop

[Open the shop guide](docs/site/README.md) for the status board, pinned SIDE24 coefficient viewer, searchable full-text catalog, and contribution route. The [SIDE24 notebook](docs/notebooks/README.md) is also readable on GitHub and runnable in Colab. [Grab a public task](https://github.com/d6g8k5htny-coder/main/issues?q=is%3Aissue+is%3Aopen+label%3Agood-first-task) or [submit an incoming result PR](CONTRIBUTING.md).

The static app is committed under `docs/site`; Pages activation is a separate [setup step](docs/PUBLIC_SHOP_SETUP.md). All views preserve scoped ACCEPT, AMEND/open, and engineering-only distinctions. They cannot change scientific status.

## Public source path

For a stranger who wants the landed mathematics rather than the live agent queue, use this order:

1. **Proof index:** [Math- `PROOF_INDEX.md` at `10e1f191c7d9f2755ca971ddbba87874d2475619`](https://github.com/d6g8k5htny-coder/Math-/blob/10e1f191c7d9f2755ca971ddbba87874d2475619/PROOF_INDEX.md)
1. **Proof index:** [Math- `PROOF_INDEX.md` at `58f7936d1138b24dd6cc988081d74d07683611d6`](https://github.com/d6g8k5htny-coder/Math-/blob/58f7936d1138b24dd6cc988081d74d07683611d6/PROOF_INDEX.md)
2. **Human status map:** [`STATUS.md`](STATUS.md)
3. **Pinned Math checkout:**
```sh
git clone https://github.com/d6g8k5htny-coder/Math-.git Math-
git -C Math- checkout --detach 10e1f191c7d9f2755ca971ddbba87874d2475619
git -C Math- checkout --detach 58f7936d1138b24dd6cc988081d74d07683611d6
```
4. **Pinned query checkout:**
```sh
git clone https://github.com/d6g8k5htny-coder/query-.git query-
git -C query- checkout --detach 76e1ca09a4838f84f20e28daa51eb024c0781dc1
git -C query- checkout --detach 89456c5033173c69a304c5fffa781888185675cc
python -B -S -m unittest discover -s query-/tests -p 'test_*.py' -v
```

Expand Down
8 changes: 4 additions & 4 deletions STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ These are useful infrastructure, but they carry **no theorem-acceptance meaning*

## Where to read — public source custody

The two human maps are this file and the [Math- proof index at the pinned public Math commit](https://github.com/d6g8k5htny-coder/Math-/blob/10e1f191c7d9f2755ca971ddbba87874d2475619/PROOF_INDEX.md). Neither file replaces the underlying proof or review.
The two human maps are this file and the [Math- proof index at the pinned public Math commit](https://github.com/d6g8k5htny-coder/Math-/blob/58f7936d1138b24dd6cc988081d74d07683611d6/PROOF_INDEX.md). Neither file replaces the underlying proof or review.

For exact source identity, use [`docs/public-math/sources.json`](docs/public-math/sources.json). It indexes **2,138 intended public text artifacts** and points to 14 JSON shards. Each artifact row carries:

Expand All @@ -45,9 +45,9 @@ The machine catalog at [`meta-framework/registry.json`](https://github.com/d6g8k

### Default-branch boundary

- Pinned Math reading checkout: `10e1f191c7d9f2755ca971ddbba87874d2475619`.
- Pinned query checkout: `76e1ca09a4838f84f20e28daa51eb024c0781dc1`.
- [Math- PR #70](https://github.com/d6g8k5htny-coder/Math-/pull/70) proposes default-branch custody copies of nine proof files already public on `main`. Until that PR lands, those copies are **not** default-branch Math; their immutable public source paths remain discoverable in the frozen public-source inventory.
- Pinned Math reading checkout: `58f7936d1138b24dd6cc988081d74d07683611d6`.
- Pinned query checkout: `89456c5033173c69a304c5fffa781888185675cc`.
- [Math- PR #70](https://github.com/d6g8k5htny-coder/Math-/pull/70) landed nine byte-custody copies at `9d7b6802424fb4715b31999066aafca8ee2f3cca`; [PR #75](https://github.com/d6g8k5htny-coder/Math-/pull/75) added their proof-index pointer. These are public default-branch imports, **not newly accepted mathematics**. Source self-labels were not adopted.
- The `main#59` issue-body file in PR #70 is explicitly a transcription, not original source bytes, so it is not counted as byte custody.
- Open draft AMEND/review PRs remain visible but are not represented here as landed mathematics.

Expand Down
Empty file added docs/.nojekyll
Empty file.
5 changes: 4 additions & 1 deletion docs/NAVIGATION.json
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,10 @@
"docs/public-math/sources-11.md",
"docs/public-math/sources-12.md",
"docs/public-math/sources-13.md",
"docs/public-math/sources-14.md"
"docs/public-math/sources-14.md",
"docs/site/README.md",
"docs/notebooks/README.md",
"docs/PUBLIC_SHOP_SETUP.md"
],
"public_targets": [
{
Expand Down
31 changes: 31 additions & 0 deletions docs/PUBLIC_SHOP_SETUP.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Public shop deployment and contribution board

Scientific effect: **NONE**. This page records the remaining GitHub configuration and the exact reviewable repository implementation. It does not claim settings are already installed.

## Pages

In [main Pages settings](https://github.com/d6g8k5htny-coder/main/settings/pages), choose **Deploy from a branch**, branch **main**, folder **/docs**, then Save. The entry file and `.nojekyll` are committed. Verify the deployment before advertising the public Pages URL as live. Do not enable Pages on Math-, trial, or sandbox for this shop.

## Profile pins

On the [owner profile](https://github.com/d6g8k5htny-coder), use Customize your pins. Select **main**, **Math-**, **query-**, and **Universal-Law-Workspace**. Leave trial and sandbox unpinned.

## Issues and Project

Issues are already in use on main. Keep tasks in [main Issues](https://github.com/d6g8k5htny-coder/main/issues), using the public task form. Create these labels if absent:

`good-first-task`, `needs-replay`, `needs-chart`, `eng-only`, `math-review`, `do-not-merge`, `results-for-review`.

Create one [main Project](https://github.com/d6g8k5htny-coder/main/projects), **Public contributions**, with Status options:

`open → claimed → results-pr → review → parked / landed-eng`.

Add the public contribution tasks to that project. `/claim` is a request: a maintainer assigns it after checking one active claim per person. This is a human/agent coordination convention, not an installed assignment bot. Keep deep open theorems off this introductory board.

## Branch protection and review

In [main branch settings](https://github.com/d6g8k5htny-coder/main/settings/branches) and [Math- branch settings](https://github.com/d6g8k5htny-coder/Math-/settings/branches), protect the default `main` branch: require a pull request, a designated review, and the applicable passing checks. For main, the external results guard is **public-intake**; its tests are a different check. For Math-, retain the existing replay/scientific gates and require review rather than treating a green replay as acceptance. Do not grant outsiders direct write access.

A check name alone does not authenticate the workflow. Before merging an intake PR, inspect the **trusted public-intake workflow**, its `pull_request_target` event, the precise reviewed PR head, and the pass result. Administrative override must not be treated as a scientific review.

Do not merge Math #60/#64/#69 or main #122/#128 to populate this shop. Landed custody copies, results intake, and notebook figures never adopt source status labels or promote a theorem.
1 change: 1 addition & 0 deletions docs/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="refresh" content="0;url=site/"><title>Universal Law public research</title></head><body><a href="site/">Open the Universal Law public research shop</a></body></html>
Loading
Loading