# Felisyn protocol 023 revision 2: the paired-runs confirmatory plaids protocol as declared and frozen (public copy)

The declared design of protocol 023 revision 2, with every file its runs, its checks and its analysis depended on. This copy is dated 13 November 2026. The revision asked the question protocol 023 could not answer: whether the plaids pilot's departure from a relay (protocol 022, [journal note 22](https://www.felisyn.com/journal/two-gratings-at-once)) holds on average over six fresh network instances of the same 2 mm model. Protocol 023 ended NOT INTERPRETABLE at its first run, when a declared check caught a one-off execution fault on the laptop ([journal note 24](https://www.felisyn.com/journal/the-confirmatory-test-stopped-at-its-first-run)). Revision 2 reran it with a paired rule: every instance is run twice on identical inputs, and it is analysed only if the two runs agree on every spike train. It ended with the declared outcome **CONFIRMED** on all three measures. The receipts, the comparisons, the checks and the declared analysis are in the package [confirm-023r2](https://www.felisyn.com/research/confirm-023r2/README.md) and in journal note 25.

- **Declared** at 2026-11-11T00:55:21Z, before any revision 2 run: the spec, SHA-256 `b7072b0bc7c56d2fba3bea44a411e2847324e06258f774bd31b40ec3183af980`. That SHA-256 was recorded, with the same timestamp, in the project's private running record at the declaration, nine hours before the first run; the frozen manifest below pins the spec at it, and the queue's launch record names that manifest. The spec is here as `frozen/spec.md`, with 27 copies of the laptop's home folder path replaced (below).
- **Frozen** at 2026-11-11T09:57:37Z by the frozen manifest, here `frozen/manifest.json`, SHA-256 `de6693f140984f8dfc6f8dec638a5339129a79f21621537b040655fd47fe39be`. It gives the size and SHA-256 of all 80 files. The freeze ran every test, and all exited 0: `test_analyze_confirm_023.py`, `test_archive_mozaik_023.py`, `test_calibration_023.py`, `test_check_instance_023.py`, `test_compare_runs_023.py`, `test_confirm_023.py`, `test_contract_023.py`, `test_end_to_end_023.py`, `test_freeze_023.py`, `test_queue_guard_023.sh`, `test_seed_search_023.py`, `test_seed_search_023r2.py`, `test_sequence_023.py`, `bite_023.py`. The queue started 74 seconds later, and its launch record names this manifest's SHA-256 (`receipts/queue/launches.txt` in confirm-023r2).
- **This public copy** holds the frozen package in `frozen/`, in its own layout. 55 files are byte-identical to the frozen manifest's entries. 25 differ only by the recorded replacements below, made because they hold the laptop's home folder path, its host name, a private temporary folder, a stand-in key header or internal wording. No file was added. The frozen package itself is kept unchanged in the project's private workspace.

Simulation only. The protocol ran network instances of a 2 mm reduction of a published model of cat primary visual cortex, on an 8 GB laptop. It is not a biological measurement and not biological validation. No token, wallet, exchange, key or real order was involved.

## How to check this copy

1. `frozen/manifest.json` is byte-identical to the frozen manifest. Its SHA-256 is the value above, which the queue's launch record names.
2. 55 of its 80 entries match the files in `frozen/` byte for byte. They include the analysis and checker code that ran (`controller/`), the lead-in reference (`leadin-reference-023.json`) and the eight stimulus sequences (`sequences/`).
3. The other 25 files differ from their entries only by the replacements listed below. Putting the original strings back gives the frozen files: each token below occurs nowhere in the frozen originals, so the replacement can be reversed exactly. The builder checked that for every one of them.
4. `manifest.json`, at the top, is this copy's own manifest. It gives the size and SHA-256 of every file here, this README included, and lists every replacement with its lines and the SHA-256 of its frozen original.

## How to check the declared spec against its recorded hash

The declared spec's SHA-256, `b7072b0b…3af980`, was recorded at the declaration, before any revision 2 run. The published `frozen/spec.md` cannot hash to that value itself: 27 copies of the laptop's home folder path, which this site never publishes, sat on 13 lines, 25 to 569 of its lines, and they read `<home>` here. What can be checked:
- `frozen/manifest.json`, byte-identical and with the SHA-256 the queue's launch record names, pins `spec.md` at 215,857 bytes and SHA-256 `b7072b0bc7c56d2fba3bea44a411e2847324e06258f774bd31b40ec3183af980`, with the status "DECLARED 2026-11-11T00:55:21Z.";
- the published copy has 215,749 bytes and SHA-256 `3be86bfce8ccad297373442f0fd98616ab52d8c59977e1b99b8be90135b5bdcd`, and differs from the declared text only inside those 27 paths;
- the original, byte for byte, is kept with the frozen package in the project's private workspace, so the recorded hash stays checkable against the record.

## What changed from protocol 023

The spec's section "Changes from protocol 023" lists every change by count. The heart of it is the paired rule, chosen by the owner after note 24's one-off fault: each instance is run twice with identical inputs; the pair counts only if the two runs agree on every one of the 18,600 neurons' spike trains (and their server checks are the same); a disagreement starts a third and, if needed, a fourth run to find an agreeing pair; a seed whose four completed runs give no agreeing pair, or whose attempt names run out, is invalid and falls to the reserve. Slots are pynn_seed 8 to 13 with one reserve, 14 (seed 7 was built and seen by protocol 023, so it is left out, with 5 and 6). The early stop that ended protocol 023 is replaced by this rule: a refused export is a one-off fault unless an agreeing pair repeats it.

## Redactions

| File | Lines | What was replaced | SHA-256 of the frozen original (in `frozen/manifest.json`) | SHA-256 here |
| --- | --- | --- | --- | --- |
| `frozen/assemble_023.py` | 4 | the home folder's path, replaced by `<home>` | `51dd39135bd1e874aa1548ac740cb8832ba78ebdedfc954014efa31f965d5c42` | `346c7413fc6daea0ca8e2dbb2e34a66c6590f8716971f6551d9f6f0288862b0b` |
| `frozen/bite_023.py` | 783, 784 | 2 copies of the home folder's path, replaced by `<home>` | `f166ecefe2fb05529e416e03d09890f47b4913b9329dbb408a2e9fa3ca6c336a` | `91c04f29047bec2df395a383b5ea7009962601b26908953ae3ca39150b9abf6b` |
| `frozen/contract.json` | 12 lines, 125 to 1964 | 12 copies of the home folder's path, replaced by `<home>` | `d061304290d2fb074ac5c565f94006e4bb9be01165c66387a68f7cd8c95be486` | `e2a4f0b85f61252db3f4db62f4f59680098bcee42e17d4915e037af9dcd9e2e8` |
| `frozen/engine-patches/0001-lgn-noise-pair-order.patch` | 4 | internal wording in a header line, replaced as in the copy published in laptop-move | `4dc4b285f0260c1fb0e611ed24891d8198ed72b3d7a0135a3339109d1b6a5ec0` | `f5f424670680b165b12eda5e36485cd12af849cb7f6eee4de02101d7195b08ec` |
| `frozen/engine-patches/0002-block-size-shift.patch` | 4 | internal wording in a header line, replaced as in the copy published in laptop-move | `e0f189b27c007968f537143d02e1b56816dd2ecd3cfb474d00ed23ceff09019d` | `4b0bf47bdf3529752984dbbb8b75fb2dbb5488fc3a485366547e3fad1f59b245` |
| `frozen/freeze_023.py` | 64 | the home folder's path, replaced by `<home>` | `b109059a00d73b9804a6522cfb9e64dc420847688a988052ca521f0bd1304d5e` | `34d1ea942d4c0ff74c4ae6f29a230f6564d4bc815034c720ef68ded6669cf925` |
| `frozen/make_contract_023.py` | 67, 137, 138 | 5 copies of the home folder's path, replaced by `<home>` | `36fc2c7743d19a93860c6d87bccfac5ea478cf2d019004f10b4605e21bc96dec` | `8fbdcc2bf99f245676c93170b68ceaa6eeb03dceb951f75ce8806e3390d0524e` |
| `frozen/runtime-sha256.txt` | 491 lines, 386 to 876 | 491 copies of the home folder's path, replaced by `<home>` | `1f87b07baebd7f0133c831b8b70d4d008c92184123bf5899f96a4b9af9b0b2ad` | `0616c025919414d4b9a887270a66777c538daaa3334a4d74204859589d7e7ddd` |
| `frozen/seed-search-023-runs.txt` | 2 | the home folder's path, replaced by `<home>` | `b5747490779125ca2bab48d42cbd2daf439bee303b3ffe0395daf5bab3eadd6c` | `9c2f3980a3aeba15f51ece22a17ec0e3ef63d4b22b73bd68377740b720f488d2` |
| `frozen/seed-search-023r2-runs.txt` | 2, 16 | 5 copies of the home folder's path, replaced by `<home>` | `b19ff06e846b75f7c9a448ac81a9561148b273ac4ff49a1c294ad239af7351d6` | `e0930e7776ecc60f9dbdb1cc6a899f5eb073fbfc74a0a96c075f76c5c56cc630` |
| `frozen/seed_search_023r2.py` | 23, 24, 30 | 5 copies of the home folder's path, replaced by `<home>` | `6f02307264156ab4dfb5f4ceaa83a5215f7926f7d451d3bf46e729c42945efa3` | `a686060ab22f3ead49e6d2f86f08dd7cd3b657cad086028160657f6f63d83893` |
| `frozen/server/fetch_023.sh` | 7, 31 | 2 copies of the home folder's path, replaced by `<home>` | `f08b3ba4fcc6f8d557440b89247f073854d82eb59c7952836a28e4ed67a46f81` | `27a1b1ec8d3196727b0efea216a819eeac6b76aba23234f99ec5ed7143b6e5a7` |
| `frozen/server/launch_023.sh` | 7 lines, 3 to 71 | 7 copies of the home folder's path, replaced by `<home>` | `3df520372f0a8097ddee18dbe09ca97aa463a3e554c3d50867d1face7d3a85e7` | `be2e475f1272cb81e42a1faf5b079d39e59b7288e990d56eb22e8885cdee2375` |
| `frozen/server/run_queue_023.sh` | 93, 94, 95, 98 | 4 copies of the home folder's path, replaced by `<home>` | `20393f4ac6c26694ce601fc4447c57af7055d071252e044707e4a265458f0998` | `f2f828af2cb3d0979f932b680f6cc250cf63e5f0c2e0f04308f124d9a91b279e` |
| `frozen/spec.md` | 13 lines, 25 to 569 | 27 copies of the home folder's path, replaced by `<home>` | `b7072b0bc7c56d2fba3bea44a411e2847324e06258f774bd31b40ec3183af980` | `3be86bfce8ccad297373442f0fd98616ab52d8c59977e1b99b8be90135b5bdcd` |
| `frozen/test_compare_runs_023.py` | 541, 544 | 2 copies of the home folder's path, replaced by `<home>` | `66a81c9a0f55a2c2dfa7701a89e707ef2f96b53b7df6e296b999aada64ebc72e` | `8c12cea5d999ed950ddd91c7f9933f9e08d4bef566e33985b6c47d46e201bf29` |
| `frozen/test_contract_023.py` | 62, 1018, 1039 | 3 copies of the home folder's path, replaced by `<home>` | `2fc74f47b0dac722730c210811eb3c8d72c8f203ae51ea3baa26def7ac73cdb0` | `57b3a394f3a68640a4ca5db9e58255883e83432e4444e0ee28b29334657e18f4` |
| `frozen/test_end_to_end_023.py` | 26 | the home folder's path, replaced by `<home>` | `93f6333a859371bb5eda7539aade5dc04e1a05a8f9c5430d43b51e900baa7f9e` | `036f1fc89c673b9f3b6487594647709109ad4632baac0b7449435d5a51ba3c27` |
| `frozen/test_freeze_023.py` | 568, 580 | 2 copies of the home folder's path, replaced by `<home>` | `303eedd13da733a0dd98fe54cbe0b94c5bd2fd4d42816e79ca3aca38e9446ba8` | `45f3a86168591e7d87eb72f0dda6ece9f2c9a8908a1e3e3fdbf172ee16b5b07b` |
| `frozen/test_queue_guard_023.sh` | 51; 996, 1108, 1291; 1269; 14 lines, 281 to 1118 | a private temporary folder in `JOBTMP`, replaced by `redacted-private-tmp` (the test then uses its own temporary folder, as it does wherever that folder is absent); 3 copies of the home folder's path written with escaped slashes in a bash pattern, replaced by `<escaped-home>`; 7 copies of the home folder's path flattened into upload file names, its slashes written as underscores, replaced by `<underscored-home>`; 16 copies of the home folder's path, replaced by `<home>` | `8a31e048ae507f3f2bcad6c3f3d4447b0221a1a7e0be7b27aecb4a61dbb5dd87` | `9bd4cc94b9787fdc5d17b0b930059463bf9b11501cf97f7e11d33f9a943a1fb7` |
| `frozen/test_seed_search_023.py` | 40; 359 | a private temporary folder in `JOBTMP`, replaced by `redacted-private-tmp` (the test then uses its own temporary folder, as it does wherever that folder is absent); a stand-in key header that the test writes as bait into a temporary file the seed search must never open; the site's privacy check refuses that header, so it reads `<stand-in key header, redacted>` (the search decides from names and modes, never from content) | `972d244ce6524bff98d1e9941c0fff6841c4bb439eff0a73a0fb1abbc00fbf85` | `d3d94c980d9f63bb75c26616017912bb8c4b66e96116a4c12a0b904c5d657a97` |
| `frozen/test_seed_search_023r2.py` | 93, 110, 116, 119, 120 | 7 copies of the home folder's path, replaced by `<home>` | `8cda006f1d11c8e26e59cce37e29502cb6daded18da7a5d871a0e37ee11033ac` | `bcbda4bf5f9c246d937fa8dfa37ac7970bb202ee2a05c08e7346cc5f25fb2868` |
| `frozen/testkit_023.py` | 48; 51, 312, 435, 501, 502 | a private temporary folder in `JOBTMP`, replaced by `redacted-private-tmp` (the test then uses its own temporary folder, as it does wherever that folder is absent); 8 copies of the home folder's path, replaced by `<home>` | `4284a21b96924967f77866f8e5273aab127e7fc3295a52df6b45ba4cac4743c2` | `e4934fcf6abb4b254074641bdff34a364cd94a0997cfee600ce94313f81b9832` |
| `frozen/tier2/receipt.json` | 4; 39 lines, 6 to 1947 | the laptop's host name in field `host`, replaced by `redacted-host`; 39 copies of the home folder's path, replaced by `<home>` | `417aaa07b4adbf3bebc8c49a61c1acc77cc47d110c32c7564bea518addfe7a8d` | `6bfffcb57c1205422affcc6ccda854bafe9d0ba94de26f5ad59b5456472d0dfb` |
| `frozen/tier2/tier2.log` | 11 | the home folder's path, replaced by `<home>` | `1511a10fe770267e6e2e66eb9db97c52bf885396286fde2eb453855883b65de8` | `0411da1c3814d4ef4224634000a821898eb0fe7ead888046fb0c237b3b162c2e` |

- **The tier 2 receipt.** Its host name and its paths are replaced. Nothing else in it changes.
- **The redacted tests** (`test_end_to_end_023.py`, `test_queue_guard_023.sh` and `test_seed_search_023.py`, with their helper `testkit_023.py`) ran in their original form at the freeze, as the frozen manifest records.
- **The engine patches.** Their redacted copies are byte-identical to the ones published in [laptop-move](https://www.felisyn.com/research/laptop-move/README.md), which made the same replacement.
- **Words that look like secrets, left in place.** The seed searches (`seed_search_023.py`, `seed_search_023r2.py`), their records and their tests, the contract builder, the test breaks and the spec name the kinds of files the search never opens: key, keystore, wallet and environment files, `.ssh` and `devnet-keys` folders, the site's `.vercel` folder. The tests write harmless stand-ins under such names (for example `ssh-ed25519 AAAA pynn_seed 10`) to check that the search never opens them. None of these is key material. The one stand-in that the site's privacy check refuses, a key header, is replaced above. `runtime-sha256.txt` names macOS's own `AppleKeyStore` framework among the system libraries it pins. The spec also names one home-relative cache folder, `~/.npm/_npx`, in its record of the owner's answers; it holds no user name. Every such word was reviewed one by one.
- **Private names left in place.** The spec, the frozen manifest and several scripts name private project records by their paths in the private workspace (under `work/`, `docs/` and `logs/`, also in the frozen manifest's `source` fields) and refer to the owner and the owner's agent. Those records are not published. The files that name them are pinned by the frozen manifest, so they are left unchanged.

## What happened

The queue ran from 2026-11-11T09:58:51Z to 2026-11-12T23:54:28Z and ended rc=0 with six valid instances: s8 agreed a1 a3; s9's attempt names were all consumed by disk-floor stops (another program's disk use; no completed run) and the reserve, seed 14, took its slot under the declared replacement rule; s10 agreed a3 a4; s11 agreed a1 a2; s12 agreed a1 a2; s13 agreed a1 a3; s14 agreed a5 a6. Two completed runs were one-off faults that the paired rule absorbed: s8-a2 (its server check passed; its cortical spike trains differed from a1's) and s13-a2 (refused by the blind check: 1,799 of 1,800 X_ON lead-in trains identical, the fault class that ended protocol 023, this time costing one run instead of the protocol). The declared analysis then ran once on the frozen package and wrote the outcome CONFIRMED on all three measures. The full record is in [confirm-023r2](https://www.felisyn.com/research/confirm-023r2/README.md).

## What is in `frozen/`

| Part | What it is |
| --- | --- |
| `spec.md` | The spec as declared (redacted, above). |
| `contract.json` | The contract of the runs, the checks and the analysis, built from the spec by `make_contract_023.py` (redacted, above). Its frozen SHA-256 is `d0613042…`. |
| `manifest.json` | The frozen manifest, written by `freeze_023.py`. |
| `sequences/` | The eight declared stimulus orders, one for each of pynn_seed 7 to 14 (7's is protocol 023's and did not run here), built by `make_plaid_sequence_023.py` with protocol 022's `make_plaid_sequence_r2.py`. |
| `controller/` | The rule, categories and fixed texts (`confirm_023.py`), the analysis driver (`analyze_confirm_023.py`), the blind checker with the replacement rule and the summary (`check_instance_023.py`), revision 2's pair comparison (`compare_runs_023.py`), and protocol 022's `plaid_stats.py`, `analyze_plaids.py` and `frozen017.py`, byte-identical. |
| `leadin-reference-023.json`, `make_leadin_reference_023.py` | The LGN lead-in reference, every X_ON and X_OFF cell's spike times before 504 ms in the pilot's intact export, and the script that extracted it. |
| `protocol-017/` | Byte-identical copies of protocol 017's contract, decoder, manifest, model-file list and frozen controller code. |
| `server/` | The run folder's scripts: the queue with the paired rule, the launcher, the fetch, the host shell, the runner, its LGN input cache and stimulus version 3 (byte-identical to protocol 022's), the memory wrapper `run_controller_mem.py`, and the tier 2 check. |
| `engine-patches/` | The two engine patches: the LGN noise pair order and NEST's block size. |
| `runtime-sha256.txt` | The hash list of the engine's native files on the laptop, made from the final build. |
| `tier2/` | The tier 2 check's inputs, its passing receipt and its log. |
| `calibrate_023.py`, `calibration-023.json`, `calibration-023.log` | The calibration of the decision rule on synthetic instances, rerun for this revision's slots on 9 November. |
| `analysis-choices-023.txt` | Details the spec leaves to the code. |
| `seed_search_023.py`, `seed_search_023r2.py` and `seed-search-*.txt`, `seed-census-server.txt`, `window-census-server.txt` | The read-only seed searches and their records: protocol 023's, the server's last records, and revision 2's search of the Mac's run folders, which showed seeds 8 to 14 unbuilt before the declaration. |
| `freeze_023.py`, `assemble_023.py`, `bite_023.py`, `testkit_023.py`, `test_*.py`, `test_queue_guard_023.sh` | The freeze, the package assembly, the tests and their deliberate breaks. |

## Credits and licences

- **Model.** Antolík J, Cagnol R, Rózsa T, Monier C, Frégnac Y, Davison AP (2024), *A comprehensive data-driven model of cat primary visual cortex*, [PLOS Computational Biology 20(8): e1012342](https://doi.org/10.1371/journal.pcbi.1012342), published under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). The runs used its code, LSV1M v1.0 (MIT license), with the command-line overrides of the 2 mm reduction. That code stays on the laptop, and none of its files is copied here.
- **Mozaik** (CeCILL version 2.0) and **PyNN 0.11.0** (CeCILL version 2.0): the simulation framework and its interface to the simulator. No file of either is copied here.
- **NEST 3.4** (GNU GPL, version 2 or later) and the [NEST step current module](https://github.com/CSNG-MFF/nest-step-current-module/tree/fe91c0345a602d564a74ebe0ea2c66d9a4157005) (GPL): the two engine patches change one file of each, and are offered under the terms of the files they change. **GSL 2.7.1** (GPL) was rebuilt from source; no GSL file is here.
- **This work.** The spec, the contract, the scripts, the tests and the patches are Felisyn's own.
