Commit Graph

3 Commits

Author SHA1 Message Date
Claude
90d207bd6c docs: design EVENT command as counterpart to REQ
Research nak's event implementation and design Grimoire's EVENT command
that maintains flag symmetry with REQ where applicable:
- Reuses -k, -e, -p, -t, -d, -T flags with same syntax
- Adds -c for content, --ts for timestamp
- Same relay argument handling

Document includes parser interface, examples, man page entry, and
comparison with nak's implementation.
2026-01-23 21:37:24 +00:00
Alejandro Gómez
c4bc3ab445 ui: improve relay tooltip, update docs 2025-12-22 19:43:00 +01:00
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