CLEAR-LeWM v0.2.1: audited FAST and runtime modes
This patch release makes performance behavior explicit, measurable, and auditable.
Highlights:
- README FAST section with exact correctness fixes and measured speedups
- 9.25x loader-only PushT throughput on the H20-3 node (4661 vs 504 samples/s)
- Historical 1.8x end-to-end H200 training observation (11.0 vs 6.1 steps/s)
- Safe FAST resume validation, batched source fetches, and vectorized memmap writes
- Reproducible FAST audit and isolated benchmark script
- Opt-in CEM environment batching with a canonical LeWM broadcast fix
- H20-3e CEM sweep: batch 16 reduced solver time from 112.8s to 75.6s (1.49x)
- Explicit warning that batched CEM changes random-sample assignment and must not replace batch-1 reference results
- CPU thread and matmul precision controls with all runtime settings/timings recorded in result JSON
- Structured benchmark records and a detailed PERFORMANCE.md audit
Validation:
- 17 base tests passed; one PyTorch-only test skipped in the lightweight environment
- 5/5 FAST and batched-criterion tests passed in the full LeWM/PyTorch environment
- Ruff, formatting, privacy scan, JSON validation, and wheel build passed
The official v0.2.0 reference tables remain unchanged.