From 98f4a374bc6e2a1c2aa0dbdfe5de55654e48abf8 Mon Sep 17 00:00:00 2001 From: Vishnu Vettrivel <23726095+cloudronin@users.noreply.github.com> Date: Sat, 29 Aug 2026 19:14:06 -0700 Subject: [PATCH 1/2] docs(c-series): wire the Zenodo DOI through every citing record MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 10.5281/zenodo.22167996, deposit version c-series-v1, verified to resolve to records/22167996 before being embedded. The load-bearing one is `Encoding_Protocol_v0_2.md`'s Validation Record. It cited `credenza/docs/donetest/...` paths that resolve for NOBODY outside this project — the escalation the supplement was published to close, still open in the protocol's own prose. It now points at `studies/c-series/` and the DOI, and carries the `uofa verify` invocation inline so a reader can check a package without leaving the page. The ledger's §4.6 venue line replaces its placeholder ("a Zenodo deposit ... is minted from these same bytes") with the minted DOI. The supplement README states the split: cite the DOI in a manuscript, cite the directory to run the checks. **Flagged, not fixed:** the Zenodo record's title reads "Unit of Assurance (UoFA) Specification", inherited from CITATION.cff rather than the release title, so the DOI reads in a bibliography as a citation of the spec rather than of the data supplement. That is a record-metadata edit on Zenodo and a repo identity question in CITATION.cff — both the author's, not this commit's. --- docs/Encoding_Protocol_v0_2.md | 14 ++++++++++---- studies/c-series/README.md | 3 +++ studies/ch4_numbers/LEDGER.md | 5 +++-- 3 files changed, 16 insertions(+), 6 deletions(-) diff --git a/docs/Encoding_Protocol_v0_2.md b/docs/Encoding_Protocol_v0_2.md index 3eb45def..89808894 100644 --- a/docs/Encoding_Protocol_v0_2.md +++ b/docs/Encoding_Protocol_v0_2.md @@ -603,10 +603,16 @@ timestamped. Ten ledgers were read; ten orderings held. condition pins 10/10 read `same` — a trial of the frozen condition voids 1 (tool-surface breach), replaced; ledgered in the report -Pre-registered before the first counted run in -`credenza/docs/donetest/C_SERIES_PREREGISTRATION.md`; reported in -`credenza/docs/donetest/C_SERIES_REPORT.md` with the composition table, the void ledger and the -verification transcripts. +Pre-registered before the first counted run; reported with the composition table, the void +ledger and the verification transcripts. **The packages, the pre-registration, the report and +the per-run notes are published at `studies/c-series/` and archived at https://doi.org/10.5281/zenodo.22167996**, so every +citation here resolves for a reader outside this project. + +Each package verifies from the anchors it ships: + + pip install uofa + uofa verify uofa.jsonld --pubkey keys/uofa-issuer.pub \ + --decision-pubkey keys/demo-reviewer.pub **What the rate does and does not say.** The signatures attest completion of the governed review **with dispositions recorded where evidence was unrecoverable** — nine of ten packages explicitly diff --git a/studies/c-series/README.md b/studies/c-series/README.md index d97f48e1..5e9533df 100644 --- a/studies/c-series/README.md +++ b/studies/c-series/README.md @@ -3,6 +3,9 @@ The artifacts behind Chapter 4 §4.6 and the Validation Record appendix of `docs/Encoding_Protocol_v0_2.md`. +**Archived: https://doi.org/10.5281/zenodo.22167996** (deposit version `c-series-v1`). Cite the DOI for the +manuscript; cite this directory for a reader who wants to run the checks. + **These are published so a stranger can check the claim without asking anyone.** Each package verifies from the anchors it ships, against the wheel on PyPI, on a machine that has never seen this repository. diff --git a/studies/ch4_numbers/LEDGER.md b/studies/ch4_numbers/LEDGER.md index 23693ddb..b97c1c11 100644 --- a/studies/ch4_numbers/LEDGER.md +++ b/studies/ch4_numbers/LEDGER.md @@ -520,8 +520,9 @@ Frozen set: pv1, prompt hash `35033e4b…`, application `716d92d9`, | Messages per run, range | 783 – 1345 | " | " | " | **Both escalations CLOSED, 2026-08-29, venue: this repository, -`studies/c-series/`** (commit `793470e4`; a Zenodo deposit for the manuscript -DOI is minted from these same bytes). +`studies/c-series/`** (commit `793470e4`, release `c-series-v1`), archived at +**https://doi.org/10.5281/zenodo.22167996** — the citable form for the manuscript, minted +from these same bytes. - *The primary artifacts were uncommitted.* The ten signed zips lived only in a local run directory. They are now committed, with `SHA256SUMS` matching the From 1d93cf68fcbd6cf05a9c56f3ec51f0c055e6ad64 Mon Sep 17 00:00:00 2001 From: Vishnu Vettrivel <23726095+cloudronin@users.noreply.github.com> Date: Sat, 29 Aug 2026 19:33:10 -0700 Subject: [PATCH 2/2] docs(c-series): record the concept DOI, and which of the two a chapter cites The deposit minted two: 10.5281/zenodo.22167996 is the VERSION DOI (this release, these bytes) and 10.5281/zenodo.22167995 is the CONCEPT DOI (always the latest version). Only the first was wired in. The distinction is load-bearing for a results chapter. A version DOI cannot move under a reference; a concept DOI can, and would silently repoint a citation at different bytes the day a c-series-v2 is cut. The records now say which to cite and why, rather than leaving a reader to pick. --- studies/c-series/README.md | 11 +++++++++-- studies/ch4_numbers/LEDGER.md | 6 ++++-- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/studies/c-series/README.md b/studies/c-series/README.md index 5e9533df..2f446a55 100644 --- a/studies/c-series/README.md +++ b/studies/c-series/README.md @@ -3,8 +3,15 @@ The artifacts behind Chapter 4 §4.6 and the Validation Record appendix of `docs/Encoding_Protocol_v0_2.md`. -**Archived: https://doi.org/10.5281/zenodo.22167996** (deposit version `c-series-v1`). Cite the DOI for the -manuscript; cite this directory for a reader who wants to run the checks. +**Archived: https://doi.org/10.5281/zenodo.22167996** (deposit version +`c-series-v1`). Cite the DOI for the manuscript; cite this directory for a reader +who wants to run the checks. + +**Two DOIs, and which to cite.** `10.5281/zenodo.22167996` is the **version +DOI** — this release, these exact bytes, and what a manuscript should cite so +the reference cannot move under it. `10.5281/zenodo.22167995` is the **concept +DOI**, which always resolves to the latest version of this supplement; cite it +only where "the supplement, whatever its current version" is what is meant. **These are published so a stranger can check the claim without asking anyone.** Each package verifies from the anchors it ships, against the wheel on PyPI, on a diff --git a/studies/ch4_numbers/LEDGER.md b/studies/ch4_numbers/LEDGER.md index b97c1c11..3fd41912 100644 --- a/studies/ch4_numbers/LEDGER.md +++ b/studies/ch4_numbers/LEDGER.md @@ -521,8 +521,10 @@ Frozen set: pv1, prompt hash `35033e4b…`, application `716d92d9`, **Both escalations CLOSED, 2026-08-29, venue: this repository, `studies/c-series/`** (commit `793470e4`, release `c-series-v1`), archived at -**https://doi.org/10.5281/zenodo.22167996** — the citable form for the manuscript, minted -from these same bytes. +**https://doi.org/10.5281/zenodo.22167996** — the **version DOI**, minted from +these same bytes and the citable form for the manuscript, because a version DOI +cannot move under a reference. The concept DOI `10.5281/zenodo.22167995` +resolves to the latest version and is *not* what a results chapter should cite. - *The primary artifacts were uncommitted.* The ten signed zips lived only in a local run directory. They are now committed, with `SHA256SUMS` matching the