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
2 changes: 2 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,8 @@ jobs:
run: python tools/manifest_integrity_check.py --coverage .github/manifest-coverage.json
- name: Review records (zero independence credit, no gate moved)
run: python tools/reviews_check.py
- name: Architectural admission attestations (fail-closed, no grade changed)
run: python tools/attestations_check.py
- name: Recovered exceptions (candidates never stored as recoveries)
run: python tools/recovery_check.py
- name: Collision proposal (additive only, exported registers untouched)
Expand Down
113 changes: 113 additions & 0 deletions attestations/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
# `attestations/` — architectural admission records

**An attestation is not a review, not a grade, not a promotion and not an
independence credit.** It records one thing: that a named object cleared a
named, machine-checkable *architectural* predicate at a stated commit.

## Why this exists

The program's throughput problem is not that work is unfinished. It is that
finished work has nowhere to be *seen* waiting. A result can be complete,
ported, hashed and structurally sound, and still be indistinguishable — to any
automated reader — from a result that was never started. The Review Queue
answers "who must look at this next"; nothing answered "which objects are
already structurally admissible and are now purely waiting on people".

That question is answerable without moving a single status, and this directory
answers it.

## What admission means, exactly

`ARCH-ADMISSION-V1` passes when every structural gate the repository runs over
the object's lineage exits zero: the claim-graph firewalls accept it, logical
quarantine is enforced, every manifest matches its SHA-256 and byte count, the
register-consumer map is free of drift, no lane reads stronger than the claim
graph, frozen digests agree, and the object's own replay driver reproduces its
stated quantities.

**Passing means the object is structurally admissible here. It does not mean
the mathematics is correct.** A wrong argument that is correctly filed,
correctly hashed and correctly scoped is `ADMITTED`, and that is deliberate:
the predicate is about structure, and structure is all it can see. Anyone
reading an `ADMITTED` record as mathematical endorsement has misread it.

## The four properties that keep this from becoming a promotion

1. **`claim_grade_after` is pinned to `UNCHANGED`** by the schema, and
`tools/attestations_check.py` refuses any other value. An attestation cannot
raise, lower or create a grade.
2. **`gate_status_after` is pinned to `UNCHANGED`.** No gate, premise or
obligation moves.
3. **`independence_credit` is pinned to `0`.** An attestation is not a review
and cannot carry organizational independence. R17 §4 is untouched.
4. **`awaiting` cannot be empty on an `ADMITTED` record.** Admission never
finishes anything, so a record claiming nothing remained would be false by
construction. The checker refuses it.

`tests/test_attestations.py` carries a negative control for each, and for the
fail-closed rule below.

## Fail-closed

A single non-zero exit code among the recorded checks **forbids** `ADMITTED`.
A record claiming admission while carrying a failed gate is a violation, not a
judgement call. The converse also holds: a `REFUSED` record must name the check
that refused it, so a refusal cannot be asserted without evidence either.

Exit codes are transcribed from real runs. A check nobody ran has no business
in the list.

## What this directory does not do

* **It does not promote.** Nothing here is a licensing predicate, and CLAUDE.md
rule 1 is unaffected: status labels are still transcribed from the source
registers and only an operator moves a gate.
* **It does not review.** It supplies no reviewer, of any provider, and no
record here counts toward any independence-requiring predicate.
* **It does not verify mathematics.** See above, twice.
* **It does not schedule.** Nothing consumes these records; this form is NOT
DEPLOYED as an enforcement mechanism. It is a queryable record, and a
queryable record is a record.
* **It does not expire.** Age never converts a `REFUSED` into an `ADMITTED`,
and never converts an `ADMITTED` into anything further.

## Run it

```bash
python3 tools/attestations_check.py
python3 tools/attestations_check.py --records DIR --schema PATH
python3 -m pytest -q tests/test_attestations.py
```

Exit status is non-zero on any violation.

## If you are about to edit one of these files, read this

An attestation says seven structural gates exited zero **over specific bytes**.
Change the object and the record stops describing it, so `attestations_check`
refuses the record and CI goes red. That is the check working, not a nuisance —
a record that silently kept applying to different bytes would be the quiet
inflation this directory exists to prevent.

Currently attested, and therefore sensitive to any edit:

```bash
python3 -c "import json,glob;print('\n'.join(sorted(json.load(open(p))['object_id'].split(' @ ')[0] for p in glob.glob('attestations/records/*.json') if not json.load(open(p)).get('superseded_by'))))"
```

At the time of writing: `docs/LPW_AMPLITUDE.md`, `docs/RN_BERNSTEIN_SHARP.md`,
`docs/RN_INNER_WEDGE.md`, `docs/RN_SIDE24_DENSITY.md`.

**Editing one is fine — appending an honesty wall to it is usually an
improvement.** But the same commit needs a numbered successor attestation:
re-run the seven gates against the new bytes, write `ATT-…-<date>B.json`
recording the exit codes you actually got, and add `superseded_by` to the
predecessor. Never edit a predecessor's attested bytes in place. Two of the four
live records have already been superseded exactly this way, both times because
another agent appended honesty prose — a good change that simply needs its
record refreshed alongside it.

Do not copy the predecessor's `does_not_establish`: the anti-boilerplate rule
refuses a statement transcribed between records, and the successor genuinely has
something different to disclaim — that attesting bytes says nothing about
whether the newly added prose is accurate.
111 changes: 111 additions & 0 deletions attestations/attestation.schema.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,111 @@
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://github.com/q0-research/attestations/attestation.schema.json",
"title": "Architectural admission attestation",
"description": "Machine-checkable record that a named object cleared a named, machine-checkable ARCHITECTURAL predicate at a stated commit. It is NOT a review, NOT a grade, NOT a promotion and NOT an independence credit. Admission says the repository's own structural gates accepted the object; it says nothing whatever about whether the mathematics is correct. Every admitted object is still waiting on something, and `awaiting` is where that is written down. Enforced by tools/attestations_check.py.",
"type": "object",
"additionalProperties": false,
"required": [
"schema_version",
"attestation_id",
"attested_utc",
"object_id",
"object_title",
"object_bytes",
"object_sha256",
"predicate_id",
"predicate_statement",
"predicate_source",
"checks",
"outcome",
"awaiting",
"claim_grade_after",
"gate_status_after",
"independence_credit",
"does_not_establish"
],
"properties": {
"schema_version": {"const": "1.0.0"},
"attestation_id": {
"type": "string",
"pattern": "^ATT-[A-Z0-9][A-Z0-9._-]{2,60}$",
"description": "Unique in attestations/records/ and equal to the filename stem."
},
"attested_utc": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$",
"description": "When the predicate was evaluated. Age never converts a REFUSED into an ADMITTED, and never converts an ADMITTED into anything further."
},
"object_id": {
"type": "string",
"minLength": 3,
"description": "Exact object identity: repository path plus commit, Drive file id, or carrier id plus member path. Not a title, not a folder."
},
"object_title": {"type": "string", "minLength": 3},
"object_bytes": {"type": "integer", "minimum": 1},
"object_sha256": {"type": "string", "pattern": "^[0-9a-f]{64}$"},
"predicate_id": {
"type": "string",
"pattern": "^[A-Z0-9][A-Z0-9._-]{2,60}$",
"description": "Identifier of the architectural predicate evaluated, e.g. ARCH-ADMISSION-V1."
},
"predicate_statement": {
"type": "string",
"minLength": 80,
"description": "What passing this predicate means, stated so a reader can tell what it does not mean."
},
"predicate_source": {
"type": "string",
"minLength": 10,
"description": "Where the predicate is defined: the checker paths, the schema, or the governance document."
},
"checks": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": ["command", "exit_code", "summary"],
"properties": {
"command": {"type": "string", "minLength": 5},
"exit_code": {"type": "integer"},
"summary": {"type": "string", "minLength": 3}
}
},
"description": "Every command actually run, with its real exit code. A single non-zero exit code forbids ADMITTED."
},
"outcome": {
"enum": ["ADMITTED", "REFUSED"],
"description": "ADMITTED: the structural gates accepted the object. REFUSED: they did not. There is no third value, and no partial credit."
},
"awaiting": {
"type": "array",
"minItems": 1,
"items": {"type": "string", "minLength": 5},
"description": "What the object is still waiting on after this attestation. Required to be non-empty: architectural admission never finishes anything, so an attestation that claimed nothing remained would be false by construction."
},
"claim_grade_after": {
"const": "UNCHANGED",
"description": "The grade of every claim after this record exists. Always UNCHANGED. An attestation cannot raise, lower or create a grade."
},
"gate_status_after": {
"const": "UNCHANGED",
"description": "The state of every gate, premise and obligation after this record exists. Always UNCHANGED."
},
"independence_credit": {
"const": 0,
"description": "Always zero. An attestation is not a review and cannot carry organizational independence."
},
"does_not_establish": {
"type": "string",
"minLength": 200,
"description": "What this attestation does NOT establish, specific to this object. Boilerplate shared with another record is rejected."
},
"superseded_by": {
"type": "string",
"pattern": "^ATT-[A-Z0-9][A-Z0-9._-]{2,60}$",
"description": "The attestation that re-ran the gates against this object's current bytes. An attestation speaks only for the commit it names, so when the object changes the record does not become false, it becomes historical. Setting this marks it as such and exempts it from the current-bytes check; the named successor must exist in the same directory."
},
"notes": {"type": "string"}
}
}
34 changes: 34 additions & 0 deletions attestations/records/ATT-LPW-AMPLITUDE-20260923.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
{
"schema_version": "1.0.0",
"attestation_id": "ATT-LPW-AMPLITUDE-20260923",
"attested_utc": "2026-09-23T19:09:00Z",
"object_id": "docs/LPW_AMPLITUDE.md @ 52bdd4430faba314829ab82817f15c7117cb6e18",
"object_title": "LPW amplitude: exact parent-law moments and the radius/phase budget",
"object_bytes": 7368,
"object_sha256": "b4b44a6a3e55526d38e7ce4c1ba79e24960a0a788f4e5ea267d75e2b8a5fb7c1",
"predicate_id": "ARCH-ADMISSION-V1",
"predicate_statement": "Every structural gate this repository runs over the object's lineage exited zero at the stated commit: the claim-graph firewalls accept it, logical quarantine is enforced, every content manifest matches its recorded SHA-256 and byte count, the register-consumer map is free of drift, no lane reads stronger than the claim graph, frozen Drive-side digests agree, and the object's own replay driver reproduces its stated quantities and matches its declared source hashes. Passing means the object is structurally admissible here. It does not mean the mathematics is correct.",
"predicate_source": "tools/claims_check.py, tools/quarantine_check.py, tools/verify_manifests.py, tools/consumers_check.py, tools/lanes_check.py, tools/frozen_check.py, tools/lpw_amplitude_check.py; shape enforced by attestations/attestation.schema.json and tools/attestations_check.py",
"checks": [
{"command": "python3 tools/claims_check.py", "exit_code": 0, "summary": "claims=26 premises=13 firewalls=9 problems=0"},
{"command": "python3 tools/quarantine_check.py", "exit_code": 0, "summary": "exclusions=22 archive_members=14 manifest_digests=2965"},
{"command": "python3 tools/verify_manifests.py", "exit_code": 0, "summary": "manifests=414 verified=3203 problems=0"},
{"command": "python3 tools/consumers_check.py", "exit_code": 0, "summary": "tabs=44 MACHINE=23 PROSE_ONLY=3 UNREAD=18, no drift"},
{"command": "python3 tools/lanes_check.py", "exit_code": 0, "summary": "no lane reads stronger than the claim graph"},
{"command": "python3 tools/frozen_check.py", "exit_code": 0, "summary": "rows=195 comparable=62 match=62 mismatch=0 unverifiable=0"},
{"command": "python3 tools/lpw_amplitude_check.py", "exit_code": 0, "summary": "exact parent moments rho^4=8, L1^4=12+32/pi; norm/phase/radius checks and 2 source hashes match; analytic imports retained; authority=NONE"}
],
"outcome": "ADMITTED",
"awaiting": [
"An organizationally distinct reviewer; the driver reports authority=NONE and custody alone does not verify the source's analytic claims.",
"The infinite-sum Tonelli and Minkowski justification, which the object states remains an analytic import rather than something it derives.",
"The passage from finite sums to the full field, which the object says still requires that imported analytic argument.",
"The separate regression treatment R05 uses for conditional norm estimates, since the moments recorded here are unconditional parent-law moments and conditioning generally changes the law.",
"The 39 checks in the cited source, whose authority this object explicitly does not rerun, replace, extend or count as its own."
],
"claim_grade_after": "UNCHANGED",
"gate_status_after": "UNCHANGED",
"independence_credit": 0,
"does_not_establish": "Admission does not establish that the parent-law moments rho^4=8 and L1^4=12+32/pi are correctly derived, nor that the amplitude budget is a valid bound for the Rayleigh quantity it is applied to. Matching two declared source hashes proves custody of bytes, not soundness of what those bytes assert. The unconditional moments recorded here are not conditional estimates, and nothing in this record bridges that gap. It leaves the Tonelli and Minkowski justification and the finite-sum-to-full-field passage as the analytic imports the object declares them to be, supplies no reviewer, awards no independence, and shifts no obligation.",
"notes": "Custody of source hashes is recorded as custody. The object is explicit that custody alone does not verify the source's analytic claims, and this record does not claim otherwise."
}
34 changes: 34 additions & 0 deletions attestations/records/ATT-RN-BERNSTEIN-SHARP-20260923.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
{
"schema_version": "1.0.0",
"attestation_id": "ATT-RN-BERNSTEIN-SHARP-20260923",
"attested_utc": "2026-09-23T19:05:00Z",
"object_id": "docs/RN_BERNSTEIN_SHARP.md @ 52bdd4430faba314829ab82817f15c7117cb6e18",
"object_title": "RN Bernstein/sharp refinement of the local inner-wedge integrand bound",
"object_bytes": 4416,
"object_sha256": "7e8557cfb45f9a6d89d4f63f8f63c53b225c27d371e71bd44583276e9845f271",
"predicate_id": "ARCH-ADMISSION-V1",
"predicate_statement": "Every structural gate this repository runs over the object's lineage exited zero at the stated commit: the claim-graph firewalls accept it, logical quarantine is enforced, every content manifest matches its recorded SHA-256 and byte count, the register-consumer map is free of drift, no lane reads stronger than the claim graph, frozen Drive-side digests agree, and the object's own replay driver reproduces its stated quantities under both normal and optimized Python. Passing means the object is structurally admissible here. It does not mean the mathematics is correct.",
"predicate_source": "tools/claims_check.py, tools/quarantine_check.py, tools/verify_manifests.py, tools/consumers_check.py, tools/lanes_check.py, tools/frozen_check.py, tools/rn_bernstein_sharp_check.py; shape enforced by attestations/attestation.schema.json and tools/attestations_check.py",
"checks": [
{"command": "python3 tools/claims_check.py", "exit_code": 0, "summary": "claims=26 premises=13 firewalls=9 problems=0"},
{"command": "python3 tools/quarantine_check.py", "exit_code": 0, "summary": "exclusions=22 archive_members=14 manifest_digests=2965"},
{"command": "python3 tools/verify_manifests.py", "exit_code": 0, "summary": "manifests=414 verified=3203 problems=0"},
{"command": "python3 tools/consumers_check.py", "exit_code": 0, "summary": "tabs=44 MACHINE=23 PROSE_ONLY=3 UNREAD=18, no drift"},
{"command": "python3 tools/lanes_check.py", "exit_code": 0, "summary": "no lane reads stronger than the claim graph"},
{"command": "python3 tools/frozen_check.py", "exit_code": 0, "summary": "rows=195 comparable=62 match=62 mismatch=0 unverifiable=0"},
{"command": "python3 tools/rn_bernstein_sharp_check.py", "exit_code": 0, "summary": "PASS: RN Bernstein/sharp; normal/-O; 6 byte-identical reports; same local wedge; independence=0; no promotion"}
],
"outcome": "ADMITTED",
"awaiting": [
"An organizationally distinct reviewer; the independence-requiring predicate is OPEN and the driver reports independence=0 itself.",
"The imported fixed-radius H3 floor 0.0077592917375327855 and the six-pin energy allowance below 8, which this packet explicitly does not reprove.",
"Certification of the full annulus, which the object states it does not cover.",
"All radii and all pin orientations beyond the single local wedge whose domain this refinement does not enlarge.",
"The original inner-wedge result it sharpens, which it does not replace and which remains byte-for-byte alongside it."
],
"claim_grade_after": "UNCHANGED",
"gate_status_after": "UNCHANGED",
"independence_credit": 0,
"does_not_establish": "Admission does not establish that the sharpened Bernstein coefficient is correct, that the tenfold improvement over the previous integrand cap is sound, or that the exact preconditioner and Taylor remainders behave as the packet describes. It re-derives no inequality and reproves none of the imported premises the object names as imports. Byte-identical replay across normal and optimized Python is a record of reproducibility, not of truth: a mistaken bound reproduces just as faithfully as a correct one. It supplies no reviewer and no independence, leaves the full annulus and every other radius untouched, and moves no claim, premise or obligation.",
"notes": "The driver reports independence=0 and no promotion in its own summary; this record transcribes that rather than softening it."
}
Loading
Loading