Commit Graph

3 Commits

Author SHA1 Message Date
Claude
edbac54adb docs: add NIP-777 spell specification
Document kind 777 events as shareable REQ subscription templates:
- Event structure with required/optional tags
- Filter encoding (kinds, authors, tag filters, time bounds)
- $me and $contacts alias system for dynamic resolution
- Relative timestamp support (7d, 24h, now)
- Execution semantics and client behavior requirements
- Security considerations
2026-01-08 09:20:43 +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