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
23 changes: 15 additions & 8 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,14 +37,21 @@ hiding either. Neither this delegation nor a merge proves a theorem.

## Before editing a file: it may be bound by a certificate

Eight candidate records under `research/` bind repository content by SHA-256 as
*source identity*, and the replay checkers that consume them refuse the tree
when a byte moves. [`research/PINNED_SOURCES.md`](research/PINNED_SOURCES.md)
lists all of it -- 34 files and 6 archive members, generated from the
certificates and verified in CI by `tools/pinned_sources_check.py`.

Three of the bound files are checkers in `tools/` and one is a document in
`docs/`, so this is not deducible from where a file lives. The remedy for a
Candidate records under `research/` bind repository content by SHA-256 as
*source identity*, and so do dependency declarations sealed **inside** the
campaign archives. The replay checkers that consume them refuse the tree when a
byte moves. [`research/PINNED_SOURCES.md`](research/PINNED_SOURCES.md) lists all
of it, generated and verified in CI by `tools/pinned_sources_check.py`:

<!-- counts checked by tests/test_pinned_sources.py against the checker's own
summary line; they drifted twice while they were prose nobody compared -->
certificates=11 archive_declarations=4 pinned_files=55 pinned_archive_members=6

Some of the bound files are checkers in `tools/` -- `h3_rn_n6_check.py` and
`twelve_project_check.py` are pinned by the downstream `rn_bernstein_sharp_variance`
campaign whose replay depends on them, not by the campaigns they enforce -- and
others are documents in `docs/` and `drive/`, so this is not deducible from where
a file lives. The remedy for a
deliberate change is a re-pin on the lane that owns the certificate. Never edit
an expected digest to match bytes you changed.

Expand Down
Loading
Loading