README.md now focuses on user-facing content:
- General description and live demo link
- Installation instructions (npm, Bun, npx, bunx)
- CLI usage examples (file, stdin, --serve)
- CLI flags table
- Dev setup with all relevant commands and scripts
- Link to ARCHITECTURE.md
ARCHITECTURE.md contains all technical implementation details:
- High-level architecture diagram
- Full project structure tree
- Runtime and dev dependencies
- Protocol spec (packet format, constants, metadata wrapping)
- Algorithm deep dives (RLNC, GF256, QR encode/decode, GIF, scheduling)
- Sender and receiver data flow diagrams
- Design decisions and rationale
- Common pitfalls
- Add outer Reed-Solomon error correction across generations
(3% overhead, 1 parity gen per ~33 source gens)
- Fix progress display: show generations solved/needed instead of
raw packet counts, making outer EC benefit visible
- Add decode timer: tracks elapsed time from first frame to completion
and shows throughput in KB/s
- Add benchmark test confirming outer EC reduces tail waiting time
under biased frame loss
- Remove per-generation hash verification (superseded by outer RS)
- Update deployment base path to /hermes-web-demos/qr/
Hermes Agent