S203i: doc cleanup, debris audit, build artifacts cleaned

Root docs (DOCUMENTATION, NEXT_STEPS, README, specs/README) updated to S203i:
- Session references bumped from S203g to S203i throughout
- Fixed stale test count (7,289 → 21,600+) in NEXT_STEPS
- Fixed false "all files <500" claim (25 remain >500L, all <700L)
- Fixed unsafe block count discrepancy (36 → 66) in README
- Aligned JSON-RPC method count (~67 → ~69) across docs
- Updated rustix claim (display now on 1.x)
- ADR-005/006 status: Planned → Accepted (tokio/thiserror already in effect)
- specs/README metrics refreshed to S203i

Debris cleanup:
- 7 archived showcase demo.sh scripts now hard-fail with exit 1
- 20.3GB build artifacts cleaned (cargo clean)
- Confirmed: zero .bak/.orig/.swp/.tmp files, zero secrets, zero TODO/FIXME

Made-with: Cursor

Author: westgate

DOCUMENTATION.md

@@ -1,6 +1,6 @@
 # ToadStool Documentation Hub
 
-**Last Updated**: April 13, 2026 — S203g
+**Last Updated**: April 14, 2026 — S203i
 
 ---
 
@@ -30,17 +30,18 @@ These root documents were **fully resolved** and **fossilized** in wateringHole
 
 ---
 
-## Current State (S203g — April 13, 2026)
+## Current State (S203i — April 14, 2026)
 
 **Post-budding, dependency-sovereign, IPC-first, fully concurrent, capability-based.** barraCuda is a separate primal at `ecoPrimals/barraCuda/`. ToadStool is the hardware infrastructure layer — GPU/NPU/CPU discovery, capability probing, workload orchestration, and shader dispatch.
 
 - **21,600+ tests**, 0 failures, 0 clippy warnings, 0 fmt diffs. Full workspace concurrent test suite.
 - **~69 JSON-RPC methods** (incl. `compute.execute` direct route S203f). Wire Standard L3 (partial): `cost_estimates`, `operation_dependencies`. IPC compliant (`health.liveness` → `{"status":"alive"}`, `health.readiness` → ready+version, `health.check` full envelope, `capabilities.list`, `identity.get`, socket at `$XDG_RUNTIME_DIR/biomeos/toadstool.sock`).
 - **Pipeline dispatch** — `compute.dispatch.pipeline.submit` + `.status` for ordered multi-stage workloads (DAG, topological sort, result forwarding). Resolves neuralSpring PG-05.
 - **Capability-based everywhere**: 0 production hardcoded primal names, 0 production mocks, 0 production unwraps, 0 TODOs/FIXMEs. All primal references use `PRIMAL_NAME` constant or capability identifiers.
-- **Deprecated surface cleaned (S203g)**: 6 zero-caller deprecated items removed. 26 large files refactored via test extraction (S203c/e/g). Async GPU discovery evolved to non-blocking.
+- **52 production files refactored (S203c/e/g/i)** via test extraction. 6 deprecated zero-caller items removed (S203g). 25 production files remain >500 lines (pure production code — hardware drivers, type defs, crypto managers; no extractable test blocks, all <700L).
+- **TCP idle timeout (S203h)** — `TCP_IDLE_TIMEOUT_SECS` (300s configurable), `TCP_NODELAY` on all accepted streams. Resolves primalSpring benchScale exp082.
 - **BTSP Phase 2 + Auto-Detect** — Handshake enforced on every UDS accept path; auto-detects plain-text clients (primalSpring) and degrades gracefully.
-- **Network constants centralized** — 8 hardcoded values (RFC1918 ranges, gateway, scan suffixes, TEST-NET-3) → `core/config/defaults/network.rs`
+- **Network constants centralized** — 8 hardcoded values (RFC1918 ranges, gateway, scan suffixes, TEST-NET-3) → `core/config/defaults/network.rs`. Hardcoded `CORALREEF_URL`/`CORALREEF_SOCKET` refs evolved to capability-neutral guidance (S203i).
 - **~66 unsafe blocks (all in hw-safe/GPU/VFIO/display containment crates)**; all SAFETY-documented. 41 crates forbid, 6 deny `unsafe_code`.
 - **ecoBin v3.0** — Zero C FFI deps. `serialport` feature-gated in specialty crate. Crypto delegated to security service. HTTP delegated to coordination service.
 - **Headless GPU** — `TOADSTOOL_HEADLESS=1` env var for pure headless operation. wgpu crash isolation via `catch_unwind` + async timeout (S203g: evolved from blocking poll).

NEXT_STEPS.md

@@ -1,8 +1,8 @@
 # ToadStool -- Next Steps
 
-**Updated**: April 13, 2026 — S203g (Deep Debt: Test Extraction + Deprecated Removal + Idiomatic Evolution)
-**Status**: Production-grade | Rust edition **2024** (MSRV 1.85) | **AGPL-3.0-or-later** | **All quality gates green** | 21,600+ tests (0 failures) | **~69 JSON-RPC methods** | Wire Standard L3 (partial) | Zero C FFI deps (ecoBin v3.0) | Zero production unwraps | IPC-first | **43/43 crates with `unsafe_code` lint policy** | **~66 unsafe blocks** (all in hw containment) | **~80 justified #[allow]** | **0 production TODOs** | **~3m30s test runtime** | **rustix 1.x everywhere except display** | **capability-based primal references (no hardcoded names)**
-**Latest**: S203g — 12 large-file test extractions (26 total across S203c/e/g). 6 deprecated zero-caller items removed. Async GPU discovery evolved (blocking poll → tokio oneshot+timeout). Forward dispatch clone optimization. S203f: wetSpring V143 validation, `compute.execute` direct route, plasmidBin metadata to 46 methods. S203d/e: LD-04 BTSP auto-detect, network centralization, env-safe tests.
+**Updated**: April 14, 2026 — S203i (Deep Debt: Massive Test Extraction + Hardcoding Evolution)
+**Status**: Production-grade | Rust edition **2024** (MSRV 1.85) | **AGPL-3.0-or-later** | **All quality gates green** | 21,600+ tests (0 failures) | **~69 JSON-RPC methods** | Wire Standard L3 (partial) | Zero C FFI deps (ecoBin v3.0) | Zero production unwraps | IPC-first | **43/43 crates with `unsafe_code` lint policy** | **~66 unsafe blocks** (all in hw containment) | **~80 justified #[allow]** | **0 production TODOs** | **~3m30s test runtime** | **rustix 1.x workspace-wide** | **capability-based primal references (no hardcoded names)**
+**Latest**: S203i — 52 production files refactored via test extraction (~10K lines moved). Production files >500L reduced 38→25 (no extractable test blocks remain). Hardcoding evolution: `CORALREEF_URL`/`SOCKET` refs → capability-neutral, `localhost` literal → `DEFAULT_HOSTNAME`. S203h: TCP idle timeout (300s configurable), `TCP_NODELAY` on all TCP streams. S203g: 6 deprecated removals, async GPU discovery, forward clone opt. S203f: wetSpring V143 validation, `compute.execute` direct route.
 
 ---
 
@@ -33,7 +33,7 @@ syntax fixed in 3 server files. Test suite fully unblocked.
 
 ### P1: Test Coverage → 90% (D-COV) — Ongoing (S164)
 
-**~80-85% line coverage** (lib-only, 185K lines instrumented). **21,600+ tests** (S198, 0 failures). Target 90%.
+**~83.6% line coverage** (lib-only, 185K lines instrumented). **21,600+ tests** (0 failures). Target 90%.
 
 **S164** expanded coverage with **+94 new tests** across 7 low-coverage files:
 - `resource_validator.rs` 20% → ~75% (+19 tests)
@@ -79,7 +79,7 @@ names directly. Deprecated API definitions retained for backward compatibility o
 | Pipeline dispatch for ordered multi-stage (neuralSpring PG-05) | **RESOLVED** S199 — `compute.dispatch.pipeline.submit` + `.status` |
 | Stable compute.dispatch.submit IPC for springs (PG-05) | **RESOLVED** S199 — methods stable, pipeline scheduling added |
 | Deep debt audit + service_discovery refactor | **RESOLVED** S200 — 0 production unwraps/mocks/hardcoded names; fallback.rs extraction |
-| rustix version unification | **RESOLVED** S200 (cli 0.38→1.1); display stays 0.38 (ioctl API migration needed) |
+| rustix version unification | **RESOLVED** S200/S203 — rustix 1.x workspace-wide (display migrated S203) |
 
 ### Transferred to Other Teams
 
@@ -129,7 +129,7 @@ names directly. Deprecated API definitions retained for backward compatibility o
 - [x] **Clippy pedantic clean** -- `cargo clippy --workspace --all-targets -- -D warnings -W clippy::pedantic` zero warnings (S130+)
 - [x] **`#[expect]` evolution** -- production `#[allow]` evolved to `#[expect(lint, reason)]` where the lint fires; ~80 justified `#[allow]` remain (S198); S131+ removed stale suppressions
 - [x] **Spring sync S131+** -- all 5 springs pinned to latest, SPRING_ABSORPTION_TRACKER updated (S131+)
-- [ ] **Test coverage target 90%** -- 21,600+ tests (S198); ~80-85% line; mock hardware layers for V4L2/VFIO (MockV4l2Device, MockVfioDevice); push to 90% ongoing
+- [ ] **Test coverage target 90%** -- 21,600+ tests; ~83.6% line; mock hardware layers for V4L2/VFIO (MockV4l2Device, MockVfioDevice); push to 90% ongoing
 - [x] **C dep elimination** -- flate2 → rust_backend, procfs default features disabled (S129)
 - [x] **Capability-based ports** -- `resolve_capability_or_legacy_port()` with graceful legacy fallback (S129)
 - [x] **God file splits (round 4)** -- ipc/server.rs, container/lib.rs, ecosystem.rs, handler/mod.rs, nestgate/client.rs (S129)
@@ -165,12 +165,21 @@ names directly. Deprecated API definitions retained for backward compatibility o
 
 ## Completed This Session (S90-203)
 
+### Session S203i: Deep Debt — Massive Test Extraction + Hardcoding Evolution (Apr 14, 2026)
+- **52 production files** refactored via test extraction (~10K lines moved to companion files). Production files >500L reduced from 38→25 (remaining are pure production code — hardware drivers, type defs; no extractable test blocks, all <700L).
+- **Hardcoding evolution**: `CORALREEF_URL`/`CORALREEF_SOCKET` dispatch notes → capability-neutral guidance. `FallbackEndpoints` literal `"localhost"` → `DEFAULT_HOSTNAME` constant.
+- All quality gates green. Clippy 0 warnings. 21,600+ tests, 0 failures.
+
+### Session S203h: benchScale — TCP Idle Timeout (Apr 14, 2026)
+- **TCP idle timeout**: `TCP_IDLE_TIMEOUT_SECS` (300s default, env configurable). `tokio::time::timeout` wraps on all TCP read loops (JSON-RPC + tarpc). `TCP_NODELAY` on all accepted streams.
+- Resolves primalSpring benchScale exp082 (half-open connection held indefinitely).
+
 ### Session S203g: Deep Debt — Test Extraction + Deprecated Removal + Idiomatic Evolution (Apr 13, 2026)
-- **12 production files >540 LOC** refactored via test extraction (26 total across S203c/e/g). All production files now target <500 lines.
+- **12 production files >540 LOC** refactored via test extraction (26 total across S203c/e/g).
 - **6 deprecated zero-caller items removed**: `localhost_endpoint`, `METRICS_PORT`, `capability_typical_provider` module, `get_primal_default_port` wrappers, `TarpcClient::address()`.
 - **Async GPU discovery evolved**: blocking `std::thread::sleep` poll loop → `tokio::sync::oneshot` + `tokio::time::timeout` (async-native, no executor blocking).
 - **Forward dispatch clone optimization**: full JSON object clone → empty Map fallback.
-- 7,289 tests pass, 0 failures. Clippy 0 warnings.
+- All quality gates green. Clippy 0 warnings. 21,600+ tests, 0 failures.
 
 ### Session S203f: wetSpring V143 Validation — Capability Surface (Apr 13, 2026)
 - **`compute.execute` promoted** to direct JSON-RPC route (closes wetSpring PG-05 gap).

README.md

@@ -42,7 +42,7 @@ Nest    = Tower  + Storage            <- storage
 | `cargo fmt --all -- --check` | 0 diffs |
 | `cargo clippy --workspace --all-targets -- -D warnings` | 0 warnings |
 | `cargo doc --workspace --no-deps` (RUSTDOCFLAGS="-D warnings") | 0 warnings |
-| `cargo test --workspace` | **21,600+ tests, 0 failures** (S203e), 121 ignored (hardware-gated); full workspace ~3m30s |
+| `cargo test --workspace` | **21,600+ tests, 0 failures**, 121 ignored (hardware-gated); full workspace ~3m30s |
 | Doctests | All passing (common, core, server, cli, testing, display) |
 | Standalone clone test | Pull to any machine, `cargo test` works (GPU-optional, CPU fallback, device-lost resilient) |
 | `unsafe` blocks | **~66 actual** (all in hw-safe/GPU/VFIO/display containment crates); SAFETY-documented; **41 crates forbid, 6 deny** `unsafe_code` |
@@ -234,7 +234,7 @@ toadStool/
 7. **Honest documentation** -- no aspirational claims as facts; ML stubs return `ModelNotLoaded`/`ModelBackendRequired`
 8. **Vendor-agnostic** -- WGPU/Vulkan for GPU discovery, any vendor works
 9. **Sovereign compute** -- no vendor lock-in, pure Rust core
-10. **100% unsafe documentation** -- every `unsafe` block has `// SAFETY:` comments (~36 blocks, all justified; 25 in containment zones)
+10. **100% unsafe documentation** -- every `unsafe` block has `// SAFETY:` comments (~66 blocks, all justified; all in hw-safe/GPU/VFIO/display containment crates)
 11. **Shared error tracking** -- `AtomicU64` counter across all server transports
 
 ### Quality Metrics
@@ -244,7 +244,7 @@ toadStool/
 | Clippy pedantic warnings | 0 (workspace-wide `clippy::pedantic` clean; `#[expect]` evolution S131+) |
 | Doc warnings | 0 |
 | Build warnings | 0 |
-| Workspace tests | **21,600+** (S203e), 0 failures |
+| Workspace tests | **21,600+**, 0 failures |
 | Lib-only line coverage | ~83.6% |
 | Full workspace test time | ~2m30s (unlimited parallelism, `cfg!(test)` fast timeouts; GPU crates have NVK resilience wrappers) |
 | `unsafe` blocks | **~66 actual** (all in hw-safe/GPU/VFIO/display containment crates); SAFETY-documented; **41 crates forbid, 6 deny** `unsafe_code` |
@@ -266,7 +266,7 @@ toadStool/
 **We are still evolving.** barraCuda (separate primal) owns all math and shaders. ToadStool focuses on hardware discovery, capability probing, and workload orchestration. All 5 spring handoffs absorbed.
 
 ### Active / Next
-- **Test coverage** -- pushing toward 90% target; 21,600+ tests (S203e); ~83.6% lib-only line (185K lines instrumented); remaining gap: hardware-dependent paths, specialty runtimes
+- **Test coverage** -- pushing toward 90% target; 21,600+ tests; ~83.6% lib-only line (185K lines instrumented); remaining gap: hardware-dependent paths, specialty runtimes
 - **DF64 / ComputeDispatch** -- transferred to barraCuda team (S93); toadStool serves hardware capabilities
 - **Sovereign compiler Phase 4+** -- register pressure estimation, loop software pipelining (barraCuda)
 
@@ -366,7 +366,7 @@ See [DEBT.md](DEBT.md) for full register and evolution paths.
 
 ---
 
-**Last Updated**: April 13, 2026 — S203g. **21,600+** workspace tests, 0 failures. ~83.6% lib-only line coverage (target 90%). **~67 JSON-RPC methods** with **Wire Standard L3** (cost_estimates + operation_dependencies). AGPL-3.0-or-later. Zero C FFI deps (ecoBin v3.0). **~66 unsafe blocks** (all in hw-safe/GPU/VFIO/display containment crates); **41 crates forbid, 6 deny** `unsafe_code`. IPC-first JSON-RPC (Unix sockets). Capability symlinks (`compute.sock`). Rust 1.85+ (edition 2024, MSRV). **S203g**: 12 large-file test extractions, 6 deprecated zero-caller items removed, async GPU discovery evolved (no executor blocking), forward dispatch clone optimization — quality gates green. **Capability-based discovery compliant** per `CAPABILITY_BASED_DISCOVERY_STANDARD.md` v1.2.
+**Last Updated**: April 14, 2026 — S203i. **21,600+** workspace tests, 0 failures. ~83.6% lib-only line coverage (target 90%). **~69 JSON-RPC methods** with **Wire Standard L3** (cost_estimates + operation_dependencies). AGPL-3.0-or-later. Zero C FFI deps (ecoBin v3.0). **~66 unsafe blocks** (all in hw-safe/GPU/VFIO/display containment crates); **41 crates forbid, 6 deny** `unsafe_code`. IPC-first JSON-RPC (Unix sockets). Capability symlinks (`compute.sock`). Rust 1.85+ (edition 2024, MSRV). **S203i**: 52 production-file test extractions (>500L files 38→25), hardcoding evolution (CORALREEF refs → capability-neutral). **S203h**: TCP idle timeout (300s), TCP_NODELAY. **Capability-based discovery compliant** per `CAPABILITY_BASED_DISCOVERY_STANDARD.md` v1.2.
 
 ---
 

docs/architecture/adrs/README.md

@@ -27,12 +27,12 @@ Architecture Decision Records (ADRs) capture important architectural decisions a
 | [ADR-003](./ADR-003-ntt-for-fhe-polynomial-multiplication.md) | Use NTT for FHE Multiplication | 2026-02-05 | **High** - 56x FHE speedup |
 | [ADR-004](./ADR-004-capability-based-service-discovery.md) | Capability-Based Service Discovery | 2026-02-05 | **Critical** - Distributed architecture foundation |
 
-### 🔄 Proposed
+### 🔄 Accepted (undocumented — decisions already in effect)
 
 | ADR | Title | Status |
 |-----|-------|--------|
-| ADR-005 | Async Runtime Selection (tokio) | Planned |
-| ADR-006 | Error Handling Strategy (thiserror only — anyhow removed S74) | Planned |
+| ADR-005 | Async Runtime Selection (tokio) | Accepted (tokio 1.x workspace-wide since S69) |
+| ADR-006 | Error Handling Strategy (thiserror only — anyhow removed S74) | Accepted (thiserror 2.0 workspace-wide since S74) |
 
 ### ❌ Deprecated
 
@@ -180,9 +180,9 @@ Architecture Decision Records (ADRs) capture important architectural decisions a
 
 ## Quick Reference
 
-**Current Count**: 4 ADRs (4 accepted, 2 proposed, 0 deprecated)
+**Current Count**: 6 ADRs (6 accepted, 0 proposed, 0 deprecated)
 
-**Last Updated**: April 3, 2026
+**Last Updated**: April 14, 2026
 
 **Maintainer**: ToadStool/BarraCuda Core Team
 

showcase/01-shader-pipeline/01-naga-fallback/demo.sh

@@ -1,10 +1,6 @@
 #!/usr/bin/env bash
-# ARCHIVED (S169): This demo references JSON-RPC methods no longer in toadStool.
+# ARCHIVED (S169): JSON-RPC methods referenced by this demo were removed.
 # See showcase/00-local-primal/ for current demos.
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR"
-echo "Building demo..."
-cargo build --release 2>/dev/null
-echo ""
-cargo run --release
+echo "ARCHIVED: This demo references JSON-RPC methods removed in S169."
+echo "See showcase/00-local-primal/ for current working demos."
+exit 1

showcase/01-shader-pipeline/02-coralreef-compile/demo.sh

@@ -1,10 +1,6 @@
 #!/usr/bin/env bash
-# ARCHIVED (S169): This demo references JSON-RPC methods no longer in toadStool.
+# ARCHIVED (S169): JSON-RPC methods referenced by this demo were removed.
 # See showcase/00-local-primal/ for current demos.
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR"
-echo "Building demo..."
-cargo build --release 2>/dev/null
-echo ""
-cargo run --release
+echo "ARCHIVED: This demo references JSON-RPC methods removed in S169."
+echo "See showcase/00-local-primal/ for current working demos."
+exit 1

showcase/01-shader-pipeline/03-compile-status/demo.sh

@@ -1,10 +1,6 @@
 #!/usr/bin/env bash
-# ARCHIVED (S169): This demo references JSON-RPC methods no longer in toadStool.
+# ARCHIVED (S169): JSON-RPC methods referenced by this demo were removed.
 # See showcase/00-local-primal/ for current demos.
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR"
-echo "Building demo..."
-cargo build --release 2>/dev/null
-echo ""
-cargo run --release
+echo "ARCHIVED: This demo references JSON-RPC methods removed in S169."
+echo "See showcase/00-local-primal/ for current working demos."
+exit 1

showcase/02-compute-patterns/01-capability-discovery/demo.sh

@@ -1,10 +1,6 @@
 #!/usr/bin/env bash
-# ARCHIVED (S169): This demo references JSON-RPC methods no longer in toadStool.
+# ARCHIVED (S169): JSON-RPC methods referenced by this demo were removed.
 # See showcase/00-local-primal/ for current demos.
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR"
-echo "Building demo..."
-cargo build --release 2>/dev/null
-echo ""
-cargo run --release
+echo "ARCHIVED: This demo references JSON-RPC methods removed in S169."
+echo "See showcase/00-local-primal/ for current working demos."
+exit 1

showcase/02-compute-patterns/02-science-dispatch/demo.sh

@@ -1,10 +1,6 @@
 #!/usr/bin/env bash
-# ARCHIVED (S169): This demo references JSON-RPC methods no longer in toadStool.
+# ARCHIVED (S169): JSON-RPC methods referenced by this demo were removed.
 # See showcase/00-local-primal/ for current demos.
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR"
-echo "Building demo..."
-cargo build --release 2>/dev/null
-echo ""
-cargo run --release
+echo "ARCHIVED: This demo references JSON-RPC methods removed in S169."
+echo "See showcase/00-local-primal/ for current working demos."
+exit 1

showcase/02-compute-patterns/03-deploy-graph/demo.sh

@@ -1,10 +1,6 @@
 #!/usr/bin/env bash
-# ARCHIVED (S169): This demo references JSON-RPC methods no longer in toadStool.
+# ARCHIVED (S169): JSON-RPC methods referenced by this demo were removed.
 # See showcase/00-local-primal/ for current demos.
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-cd "$SCRIPT_DIR"
-echo "Building demo..."
-cargo build --release 2>/dev/null
-echo ""
-cargo run --release
+echo "ARCHIVED: This demo references JSON-RPC methods removed in S169."
+echo "See showcase/00-local-primal/ for current working demos."
+exit 1