Preserve organic evidence and version saturation requirement bindings

[seathatflowsinourveins]

Scope

Preserve organic-use observations in the existing registry, component matrix and freshness/saturation reports, with null pilot metrics/verdicts and no readiness change. The earlier UNKNOWN/DEFERRED and native-EXCLUDED declaration guards remain intact.

Add an optional version-2 saturation requirement snapshot over exact text and catalog/layer identity. Keep every historical record, scope and digest; retain the old digest as legacy_hash in new snapshots. New original/expanded field digests include the snapshot only when present. Append can copy only a binding captured in retained discovery, and the report distinguishes legacy scopes without promoting their counts into text-bound qualification.

• Base commit: 424b8a778222ae8857aade42c49ae6f7a13b3138; this migration extends Preserve organic evidence and version saturation requirement bindings #750 at bed695bef593aa5a846611bb6cb4cf8ee2286760.
• Lane: exactly lane:foundation; DRAFT.
• New owned paths: scripts/saturation_ledger.py, catalogs/saturation/ledger.schema.json, tests/test_saturation_ledger.py, current saturation README, new decision/receipt and registry.
• Trading requirement TEXT remains 5f's. Live producer propagation remains a custody handoff to convergence-practice for tools/sota-convergence/landscape-sweep/{build_inputs.py,convert.py,build_args.py}; these files are not changed.
• Landing path: the command center reviews the exact binding head; readiness-runner records a dated addendum; after the required independent/CC reads and ACK, 5f lands in its assigned queue. No new runner, host change or acceptance count.

SOTA sources

• seathatflowsinourveins/native-agent-stack@bed695bef593aa5a846611bb6cb4cf8ee2286760:scripts/saturation_ledger.py:122-132,524-531,575-580,1139-1162,1341-1346,1626-1708: extend the native canonical/hash, frozen-source and append-only mechanisms; no replacement ledger or hash rewrite.
• At that pin, catalogs/saturation/ledger.schema.json:77-85, catalogs/saturation/README.md:29-95, catalogs/landscape/foundation.json:7-10, catalogs/landscape/us-equities.json:7-11 and tests/test_saturation_ledger.py:443,743,764,962: actual requirement joins, historical-prefix and frozen-scope regression seams.
• At that pin, tools/sota-convergence/landscape-sweep/build_inputs.py:393,638-645, convert.py:369,378,577, build_args.py:544: explicitly pending live producer propagation.
• Original organic carrier/guards: native-agent-stack@1796303f:catalogs/README.md:8,25; scripts/validate.py:432-461; scripts/component_matrix.py:79-102,356-393,866; native-agent-stack@af6427f577601c3b8d77d34fc93d60f389afb896:scripts/organic_use.py:190-234; tests/test_organic_use.py:93-114,209-231; docs/acceptance-evidence-policy.md:26-33.
• Protocol organic-e2e-v1-20261005 SHA 1154e174, suite cd26427a, U1 db3ca7e1 lines15-20,61, rule(c) 668362fe lines27-36: full logical locators/hashes are retained in the unchanged pilot receipt.
• JSON Schema Draft 2020-12 and MADR 4.0.0: supported declaration format and proposed dated record.
• Registry mechanism: native-agent-stack@bed695bef593aa5a846611bb6cb4cf8ee2286760:scripts/host_receipts.py:720-737; hot-file protocol docs/lanes.md:94-128.

Evidence-class table

Claim	Evidence class	Receipt / source
Original organic protocol, eight historical process records, null metrics	source_review / historical owner observations	Unchanged organic pilot receipt
Distinct text/identity hashes, tampering and original-field rejection	synthetic	Focused fixture regressions
Every checked-in legacy record still verifies, source hashes and report semantics	local_integration	New binding receipt, native checker/scope/report output
Independent review, dated owner addendum, live producer activation	pending	No adoption, new sweep or readiness claim

Local commands run

rtk proxy env PYTHONDONTWRITEBYTECODE=1 nice -n 19 ionice -c3 python3 -m unittest tests.test_saturation_ledger
0; 111 tests in21.517s, one optional-jsonschema skip
rtk proxy env PYTHONDONTWRITEBYTECODE=1 nice -n 19 ionice -c3 python3 scripts/saturation_ledger.py --check
0; 5 sweep records, chain intact, bindings verified
rtk proxy env PYTHONDONTWRITEBYTECODE=1 nice -n 19 ionice -c3 python3 scripts/saturation_ledger.py --scope
0; legacy map unchanged, 45 additive declarations
rtk proxy env PYTHONDONTWRITEBYTECODE=1 nice -n 19 ionice -c3 python3 scripts/saturation_ledger.py --report --json
0; every recorded scope remains legacy, zero text-bound saturation candidates
env PYTHONDONTWRITEBYTECODE=1 nice -n 19 ionice -c3 python3 scripts/validate.py
0; 69components,4profiles,210receipts,10246hashedfiles; final registered receipt validated
rtk git diff --check
0

Read-only prior-module comparison also passed: old --scope submaps are canonically byte-equal, report count/candidate/due/reset fields match, all95 historical scopes still verify, and the original ledger SHA256 is unchanged. The same-family completeness critic found0 material blockers; independent review remains pending.

Frozen head: a40a083172af588f4b97646db87dfc8ef3c0b60e.
Source commit: cf3ad64c7461df8784fc9b9bd25b626ea4f23032; the final commit changes only manifests/evidence.json.

Earlier organic unit: 415 tests passed with one optional-jsonschema skip; the two-guard source critic was same-family only. Its retained first failures/timeouts and unknown metrics remain unchanged. The new binding unit's actual outputs and any failures are retained separately.

Decision record

docs/decisions/2026-10-07-saturation-requirement-binding-v2.md records the additive snapshot, preserved history, producer custody, alternatives and overturn comparison. The earlier organic decision remains unchanged.

Host evidence

No host receipt or platform-status change, model run, installation or organic qualification. No credentials, raw conversations, active client configuration or personal paths are published.

Checklist

• Historical ledger bytes, scope hashes, chain and root policy/schema remain unchanged.
• Legacy missing-binding field hashes remain compatible; new snapshots require retained-source verification.
• No live producer, trading requirement, gate or host change.
• One lane label; draft; registry-only final commit.
• Command-center exact-head review and readiness-runner dated addendum.

[seathatflowsinourveins]

Closed with a record by the PR triage of 2026-10-07 (the command center's ruling). Not merged; the branch codex/ns2604-grand-catalog-organic-use-20261005 stays on origin at 6cd4f40.

Folded into #820 at 77d35e4. Of this PR's 30 changed files, 26 are byte-identical there and 4 are merged (shared files, and registry entries re-registered for the merged files); none is lost. The exact-head read of #820 at that head gives the same fold-completeness table.

Reopen trigger: none while #820 carries the content. Reopen with gh pr reopen 750.