S166: doc evolution — stale counts corrected (1155/75/73/267/67/225), V117 evolution review handoff, archive sweep

Correct test/binary/module/tolerance counts across all docs (README,
CHANGELOG, EVOLUTION_READINESS, CONTROL_EXPERIMENT_STATUS, specs/*,
experiments/, whitePaper/). Create V117 handoff with full barraCuda
Sprint 6-7 review and per-primal action items. Archive V116. Fix
check_drift.sh stale comment.

Made-with: Cursor

Author: eastgate

CHANGELOG.md

@@ -5,7 +5,25 @@ All notable changes to neuralSpring are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased] — Session 165 (March 17, 2026)
+## [Unreleased] — Session 166 (March 17, 2026)
+
+### Session 166 — Doc Evolution, V117 Handoff, Archive Sweep (2026-03-17)
+
+**Stale count cleanup, full barracuda evolution review, V117 handoff, archive sweep.**
+
+- **DOC CLEANUP**: Test counts corrected across all docs: 1155 lib (was 1152) + 75 playGround
+  (was 70) + 73 forge = 1303 total. Binary count: 267 (was 260). Module count: 67 (was 47).
+  Tolerance count: 225 named constants (was "180+"). All root docs, specs, experiments,
+  whitePaper, and wateringHole synchronized.
+- **BARRACUDA REVIEW**: Full evolution mapping against barraCuda Sprint 7 (3772 tests,
+  `execute_gemm_ex` TransA/TransB, `WGSL_MEAN_REDUCE` re-export, 10 `mul_add()` evolutions,
+  typed `BarracudaError`). Confirmed neuralSpring leverages 45+ submodules, 80+ functions,
+  216+ import files. Identified new wiring opportunities: L-BFGS optimizer, `StatefulPipeline`,
+  `WGSL_MEAN_REDUCE` re-export.
+- **V117 HANDOFF**: New `NEURALSPRING_V117_EVOLUTION_REVIEW_HANDOFF_MAR17_2026.md` with
+  action items for barraCuda (FMA sweep recommendation, `WGSL_MEAN_REDUCE` absorption) and
+  toadStool (IPC proptest pattern, `StatefulPipeline` for HMM chains).
+- **ARCHIVE SWEEP**: Stale TODO/FIXME review, outdated count corrections, debris check.
 
 ### Session 165 — Ecosystem Absorption: FMA Sweep, IPC Proptest, Leverage Guide (2026-03-17)
 

CONTROL_EXPERIMENT_STATUS.md

@@ -1,11 +1,11 @@
 # neuralSpring — Control Experiment Status
 
-**Last updated**: March 17, 2026 (Session 165 — Ecosystem absorption: mul_add FMA sweep 14 sites, IPC proptest 8 new tests, ECOSYSTEM_LEVERAGE_GUIDE.md. V116 handoff. 1152 lib + 70 playGround + 73 forge tests. 28 property + 23 playground IPC tests. 0 warnings. 0 unfulfilled expectations.)
+**Last updated**: March 17, 2026 (Session 166 — Ecosystem absorption: mul_add FMA sweep 14 sites, IPC proptest 8 new tests, ECOSYSTEM_LEVERAGE_GUIDE.md. V117 handoff. 1155 lib + 75 playGround + 73 forge tests. 28 property + 23 playground IPC tests. 0 warnings. 0 unfulfilled expectations.)
 **Gate**: Eastgate (i9-12900K, 32 GB DDR5, RTX 4070 12 GB + TITAN V 12 GB NVK, Pop!_OS 22.04)
 **Python**: 3.10.12, PyTorch 2.9.0+cu128, NumPy 2.2.6, SciPy 1.15.3
 **Rust**: Edition 2024 (MSRV 1.87), clippy pedantic + nursery, unsafe_code=forbid
 **Grand Total**: 397/397 Python PASS + 4000+ Rust+GPU validation PASS = **4500+ total validation checks**
-**Library**: 1295 tests (1152 lib + 73 forge + 70 playGround) | 47 modules + config + niche + primal_names + streaming/ + search/ + visualization/ + gpu_ops/ + gpu_dispatch | 260 validation/bench binaries
+**Library**: 1303 tests (1155 lib + 73 forge + 75 playGround) | 67 modules + config + niche + primal_names + streaming/ + search/ + visualization/ + gpu_ops/ + gpu_dispatch | 267 validation/bench binaries
 **CPU↔Python Parity**: 41/41 PASS — `validate_cpu_math_parity` (9 primitives + 10 paper kernels + 6 Dispatcher cpu_only checks, all within 1e-10)
 **Dispatch Overhead**: `bench_dispatch_tiers` — 9/10 ops ≤1.04× overhead (CPU dispatch is transparent), per-call GPU driver-bound for small workloads (motivates pipeline batching)
 **baseCamp**: 6 biophysical AI modules + 11 validators (162/162 CPU + 14/14 GPU + 19/19 dispatch + GPU pure 6/6 sub-theses PASS) — Sessions 50, 54, 56, 77, 104b, 107

DEPRECATION_MIGRATION.md

@@ -2,7 +2,7 @@
 
 **Date**: March 17, 2026 (Sessions 44–163)
 **barraCuda**: v0.3.5 at `0649cd0` (`../barraCuda/crates/barracuda`). 719+ WGSL shaders, wgpu 28, Sprint 2 APIs (activations, rng, tridiagonal_ql), healthSpring domain, batched logsumexp, CoralReefDevice. ToadStool S146+, coralReef Iter 49.
-**Status**: Migration complete — deprecated modules fossilized, S-03b resolved upstream, gpu_dispatch active (47 ops, ~97% GPU, 7 domain files). coralForge unified. 260 binaries, 1152 lib + 70 playGround + 73 forge tests, 0 clippy (pedantic+nursery, -D warnings), 0 fmt diffs. Zero unsafe (forbid on all 3 crate roots), zero production mocks, zero cross-primal logic. **Zero C deps** in entire workspace (reqwest/ring eliminated via Tower Atomic in S157). Standalone barraCuda confirmed. V116 handoff (S165: FMA sweep, IPC proptest, ecosystem leverage guide). Zero `eprintln!` workspace-wide (1642 → 0 in S162). Zero hardcoded socket paths. Structured `IpcError`, `call_typed()`, `extract_rpc_error()`, `resilient_call()` circuit breaker, typed `compute.dispatch`, `DispatchOutcome` enum, 4-format `parse_capability_list()`. `discover_primal()` + `socket_env_var()`. `safe_cast` module (5 helpers). OrExit<T> zero-panic (6 binaries), deny.toml, zero `#[allow()]`, temp-env. Niche deployment: `src/niche.rs` + `graphs/neuralspring_deploy.toml`. `src/primal_names.rs`. `control/tolerances.py`.
+**Status**: Migration complete — deprecated modules fossilized, S-03b resolved upstream, gpu_dispatch active (47 ops, ~97% GPU, 7 domain files). coralForge unified. 267 binaries, 1155 lib + 75 playGround + 73 forge tests, 0 clippy (pedantic+nursery, -D warnings), 0 fmt diffs. Zero unsafe (forbid on all 3 crate roots), zero production mocks, zero cross-primal logic. **Zero C deps** in entire workspace (reqwest/ring eliminated via Tower Atomic in S157). Standalone barraCuda confirmed. V117 handoff (S166: FMA sweep, IPC proptest, ecosystem leverage guide). Zero `eprintln!` workspace-wide (1642 → 0 in S162). Zero hardcoded socket paths. Structured `IpcError`, `call_typed()`, `extract_rpc_error()`, `resilient_call()` circuit breaker, typed `compute.dispatch`, `DispatchOutcome` enum, 4-format `parse_capability_list()`. `discover_primal()` + `socket_env_var()`. `safe_cast` module (5 helpers). OrExit<T> zero-panic (6 binaries), deny.toml, zero `#[allow()]`, temp-env. Niche deployment: `src/niche.rs` + `graphs/neuralspring_deploy.toml`. `src/primal_names.rs`. `control/tolerances.py`.
 **S130**: `PrecisionRoutingAdvice` wired, fused GPU regression gated, coralNAK→coralReef rename.
 **S121**: `MlpLayer` struct removed from `wdm_surrogate.rs` and `wdm_transport.rs` — replaced by `barracuda::nn::SimpleMlp` with `DenseLayer` format. `hmm_viterbi_chain_gpu` per-step f32 Tensor loop replaced by single f64 `barracuda::ops::bio::hmm_viterbi` dispatch.
 

EVOLUTION_READINESS.md

@@ -1,10 +1,11 @@
 # neuralSpring — Evolution Readiness
 
-**Date**: March 17, 2026 (Session 165 — Ecosystem Absorption: FMA sweep 14 sites, IPC proptest 8 tests, ECOSYSTEM_LEVERAGE_GUIDE.md + V116 Handoff)
+**Date**: March 17, 2026 (Session 166 — Doc evolution, V117 handoff, archive sweep. 1155 lib + 75 playGround + 73 forge = 1303 tests, 267 binaries, 67 modules, 225 named tolerances)
 **barraCuda**: v0.3.5 at `0649cd0` (`../barraCuda/crates/barracuda`). 719 WGSL shaders, wgpu 28, Sprint 2 APIs (activations, rng, tridiagonal_ql), healthSpring domain, batched logsumexp, CoralReefDevice. `PrecisionRoutingAdvice` with `F64NativeNoSharedMem` Ada Lovelace reclassification, `WORKGROUP_SIZE_1D` constant, cross-spring provenance registry, `BatchedOdeRK45F64`, `mean_variance_to_buffer`, coralReef Phase 10 IPC. Three-tier precision: F32/F64/Df64 (lean 3-tier model, F16+templates removed). Deep debt: typed errors, named constants, `Arc<str>` hot-path, `RwLock` compiler, ring buffer back-off, streaming pipeline completion. **Known issue**: `enable f64;` in WGSL triggers PTXAS silent-zero regression on Ada Lovelace — fix implemented locally in `pipeline_cache.rs`, pending upstream absorption.
 **ToadStool**: S146 at `751b3849`. Hardware testing, PCIe transport, ResourceOrchestrator, 19,900+ tests. Absorbed neuralSpring `pipeline_graph` DAG + hotSpring `streaming_dispatch`. Dual-write discovery (canonical + coralReef-compatible). `GpuDevice` enrichment (render_node, driver, arch). `gpu.dispatch` + `shader.compile` + `orchestration` capabilities. Compute triangle unblocked. Deep debt, zero-copy.
 **coralReef**: Iteration 49. `coral-glowplug` crate (sovereign PCIe broker), GV100 per-runlist registers, HBM2 training, bar cartography, 1842+ tests. Sovereign shader compiler (WGSL → native GPU binary). NVIDIA SM70-SM89, AMD RDNA2+ (E2E GPU dispatch verified on RDNA2). Three-tier precision architecture: f32 native, f64 DFMA+polynomial lowering, df64 preamble auto-prepend. `Fp64Strategy` in `CompileOptions`. Built-in `df64_preamble.wgsl`. 8 neuralSpring shaders in corpus.
-**neuralSpring**: 1152 lib tests + 70 playGround + 73 forge tests, 260 binaries, 48 modules, 0 clippy warnings (pedantic+nursery, -D warnings), 0 fmt diffs. All 3 crate roots `forbid(unsafe_code)`. All files ≤1000 LOC. AGPL-3.0-or-later. **Zero C dependencies** in entire workspace (ecoBin compliant — reqwest/ring eliminated via Tower Atomic). **Rust Edition 2024** (let chains, reserved `gen` keyword, pattern ergonomics). proptest property-based testing (6 invariants).
+**neuralSpring**: 1155 lib tests + 75 playGround + 73 forge tests, 267 binaries, 67 modules, 0 clippy warnings (pedantic+nursery, -D warnings), 0 fmt diffs. All 3 crate roots `forbid(unsafe_code)`. All files ≤1000 LOC. AGPL-3.0-or-later. **Zero C dependencies** in entire workspace (ecoBin compliant — reqwest/ring eliminated via Tower Atomic). **Rust Edition 2024** (let chains, reserved `gen` keyword, pattern ergonomics). proptest property-based testing (6 invariants).
+**S166**: Doc evolution + V117 handoff — stale counts corrected (1155 lib, 75 playGround, 267 binaries, 67 modules, 225 tolerances), full barraCuda Sprint 7 review, archive sweep. V117 handoff.
 **S165**: Ecosystem absorption — `mul_add()` FMA sweep (14 sites, 10 modules), IPC proptest invariants (8 new tests: RetryPolicy bounds, CircuitBreaker state machine, parse_capability_list fuzz, DispatchOutcome fuzz, IpcError contract), `specs/ECOSYSTEM_LEVERAGE_GUIDE.md`. V116 handoff.
 **S164**: Deep debt evolution — 7 inline tolerances named and wired (domain_guards), `solve_symmetric` → `barracuda::linalg::solve::solve_f64_cpu()`, MSRV `rust-version = "1.87"` pinned across workspace, `/tmp` → `temp_dir()`, `partial_cmp().unwrap()` → `total_cmp()`, `tolerances/training.rs` extracted, test sockets → `niche::NICHE_NAME`. V115 handoff.
 **S163**: Edition 2024 evolution — Rust Edition 2024 upgrade, `health.liveness`+`health.readiness` IPC probes, `ipc_resilience.rs` (RetryPolicy + CircuitBreaker), proptest (6 property tests), MCP tools 14→16, tolerance provenance doc comments, deny.toml hardened (unknown-git=deny, advisory DB), DispatchOutcome enriched.