Claude bebb4ed834 docs: add comprehensive ReqViewer state machine analysis and improvement plan ...

Analysis document:
- Identified critical bug in applesauce-relay catchError handling
- Documented 7 edge cases causing "LIVE with 0 relays" issue
- Root cause: relay disconnections treated as EOSE messages
- Detailed Nostr protocol semantics and applesauce behavior

Implementation plan:
- Hybrid approach: RelayStateManager + event metadata tracking
- New state types: ReqRelayState, ReqOverallState
- Enhanced hook: useReqTimelineEnhanced with per-relay tracking
- 3-phase rollout: infrastructure → UI → testing
- Comprehensive state machine with 8 query states, 8 relay states

This provides the foundation for production-quality REQ status tracking
that accurately handles disconnections, timeouts, and partial failures.

2025-12-22 15:59:00 +00:00

..

req-viewer-improvement-plan.md

docs: add comprehensive ReqViewer state machine analysis and improvement plan

2025-12-22 15:59:00 +00:00

req-viewer-state-analysis.md

docs: add comprehensive ReqViewer state machine analysis and improvement plan

2025-12-22 15:59:00 +00:00