Files
bitvid/.agents/memory/lessons.md
T
2026-08-12 20:57:52 -04:00

25 lines
902 B
Markdown

# Lessons
Hard-won lessons and recurring landmines.
## Cloudflare/S3 upload-path gotchas
`js/services/r2Service.js` and `js/services/s3UploadService.js` are near-identical
copies that must be changed in lockstep, and storage keys must stay
content-addressed (`computeStorageContentHash`) or URL-first uploads silently
overwrite objects. Full audited writeup in the doc below.
Authoritative source:
- docs/lessons/cloudflare-s3-upload-gotchas.md
## NIP-07 signer reliability
"DMs / lists / watch-history won't load after login" is almost always an
unresponsive NIP-07 signer extension, not bitvid — diagnose with a raw
`window.nostr` probe first, and never regress the five resilience invariants
(capped relay fan-out, NIP-07 circuit breaker, re-thrown transient decrypt
errors, generous decrypt budgets, lazy modal population).
Authoritative source:
- docs/lessons/nip07-signer-reliability.md