S203g: docs cleanup — root docs to S203g, showcase README aligned with archived demos

DOCUMENTATION.md: updated to S203g current state, deprecated surface cleanup noted.
NEXT_STEPS.md: updated to S203g, added S203d-g completion entries.
showcase/README.md: Level 01/02 marked ARCHIVED (S169), compute triangle headline removed.
Build artifacts cleaned (55.5 GiB).

Made-with: Cursor

Author: westgate

DOCUMENTATION.md

@@ -1,6 +1,6 @@
 # ToadStool Documentation Hub
 
-**Last Updated**: April 12, 2026 — S203e
+**Last Updated**: April 13, 2026 — S203g
 
 ---
 
@@ -30,20 +30,20 @@ These root documents were **fully resolved** and **fossilized** in wateringHole
 
 ---
 
-## Current State (S203e — April 12, 2026)
+## Current State (S203g — April 13, 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**. 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`).
+- **~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 (S202)**: 0 production hardcoded primal names, 0 production mocks, 0 production unwraps, 0 TODOs/FIXMEs. All primal references use `PRIMAL_NAME` constant or capability identifiers. API keys evolved (e.g., `shader_compiler_available`).
-- **TS-01 / shader compiler discovery** — `visualization_client.rs` uses unified `capability.discover` (no `CORALREEF_*` env, no coralreef-core.json, no coralreef dir scan).
+- **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.
 - **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`
-- **34 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 (S202). 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` + thread timeout.
+- **~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).
 - **Fully concurrent tests** — All tests run with unlimited parallelism. Zero `#[serial]`. Zero fixed sleeps in non-chaos tests.
 - **AGPL-3.0-or-later** — All Cargo.toml + all .rs files aligned. `deny.toml` enforced.
 

NEXT_STEPS.md

@@ -1,8 +1,8 @@
 # ToadStool -- Next Steps
 
-**Updated**: April 12, 2026 — S203e (Deep Debt: Network Centralization + BTSP Auto-Detect)
-**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** | **34 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**: S203e — Network constants centralized (8 hardcoded values → config/defaults). BTSP auto-detect for plain-text peers (LD-04). 5 large files refactored (test extraction). Full deep audit: zero debt markers in production. S203d (prior): LD-04 BTSP resolution + env-safe test hardening.
+**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.
 
 ---
 
@@ -163,7 +163,23 @@ names directly. Deprecated API definitions retained for backward compatibility o
 
 ---
 
-## Completed This Session (S90-202)
+## Completed This Session (S90-203)
+
+### 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.
+- **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.
+
+### Session S203f: wetSpring V143 Validation — Capability Surface (Apr 13, 2026)
+- **`compute.execute` promoted** to direct JSON-RPC route (closes wetSpring PG-05 gap).
+- **Pipeline methods** (`dispatch.pipeline.submit`, `dispatch.pipeline.status`) added to `capabilities.list`.
+- **plasmidBin metadata** expanded from 6 to 46 callable methods, `min_ipc_version = "2.0"`.
+
+### Session S203d/e: LD-04 BTSP Auto-Detect + Network Centralization + File Refactoring (Apr 12, 2026)
+- BTSP first-byte auto-detection for plain-text clients (primalSpring). `PrependByte<S>` adapter.
+- 8 hardcoded network constants centralized. 5+2 env-dependent tests hardened. 10 large files refactored.
 
 ### Session S202: Deep Debt Execution — Capability-Based Evolution (Apr 11, 2026)
 - **Hardcoded literal evolution**: 3 production `"toadstool"` literals → `PRIMAL_NAME` constant (self_identity.rs, bear_dog/client.rs, identity.rs). `"coral_reef_available"` JSON-RPC key → `"shader_compiler_available"`.

showcase/README.md

@@ -2,7 +2,7 @@
 
 **Hardware Discovery, Compute Orchestration, and Inter-Primal Compute Patterns**
 
-**Status**: Active | **Updated**: April 12, 2026 -- S203c
+**Status**: Active | **Updated**: April 13, 2026 -- S203g
 **License**: AGPL-3.0-only
 
 ---
@@ -20,12 +20,11 @@ cd showcase/00-local-primal
 ./05-gpu-job-queue/demo.sh          # 60s  - GPU dispatch and queue management
 ```
 
-### Compute Triangle Demo (toadStool + barraCuda + coralReef)
+### ~~Compute Triangle Demo~~ (ARCHIVED S169)
 
-```bash
-cd showcase/02-compute-patterns
-./04-shader-to-gpu/demo.sh          # The headline demo: compile -> dispatch -> execute
-```
+Levels 01 and 02 are archived — the JSON-RPC methods they demonstrated (`shader.compile.*`,
+`discovery.*`, `science.*`, `deploy.*`) were removed in S169 (compile → coralReef,
+science/deploy → biomeOS). See `00-local-primal/` for current demos.
 
 ---
 
@@ -44,27 +43,15 @@ APIs directly and runs on any machine with Rust installed.
 | 04-resource-management | 30s | Resource estimation, validation, optimization suggestions |
 | 05-gpu-job-queue | 60s | GPU job dispatch, queue management, capabilities |
 
-### Level 01: Shader Pipeline (toadStool + coralReef)
-
-Demonstrates shader compilation with naga fallback and coralReef integration.
-
-| Demo | Time | What It Shows |
-|------|------|---------------|
-| 01-naga-fallback | 30s | WGSL compile via naga (no coralReef needed) |
-| 02-coralreef-compile | 60s | WGSL/SPIR-V compile via coralReef socket |
-| 03-compile-status | 30s | Async compilation status polling |
+### Level 01: Shader Pipeline — ARCHIVED (S169)
 
-### Level 02: Compute Patterns (toadStool + barraCuda + coralReef)
+Archived — `shader.compile.*` methods removed from toadStool in S169 (compile is coralReef's
+domain). See `01-shader-pipeline/README.md` for details and current alternatives.
 
-Demonstrates the compute triangle: toadStool decides WHERE, barraCuda decides WHAT,
-coralReef compiles HOW.
+### Level 02: Compute Patterns — ARCHIVED (S169)
 
-| Demo | Time | What It Shows |
-|------|------|---------------|
-| 01-capability-discovery | 30s | Runtime discovery of compute.sock, coralreef.sock |
-| 02-science-dispatch | 60s | science.compute.submit + science.gpu.dispatch |
-| 03-deploy-graph | 60s | deploy.capability_call routing to barraCuda |
-| 04-shader-to-gpu | 120s | Full triangle: compile -> dispatch -> execute |
+Archived — `discovery.*`, `science.*`, `deploy.*` methods removed from toadStool in S169
+(science/deploy routing is biomeOS's domain). See `02-compute-patterns/README.md` for details.
 
 ### Level 03: Ecosystem Integration (toadStool + phase1 primals)