aboutsummaryrefslogtreecommitdiffstats
path: root/CLAUDE.md
diff options
context:
space:
mode:
Diffstat (limited to 'CLAUDE.md')
-rw-r--r--CLAUDE.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/CLAUDE.md b/CLAUDE.md
index ad215d5..6701d7d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -254,6 +254,14 @@ keypair bundle, or anything that looks like a user's public key.
`deploy-hub.sh` runs `alembic upgrade head` before restarting the service; a schema
change that skips a migration file will still pass every test you have
+- **Some paths only exist in a browser, and only one browser has them.** The
+ download-to-disk story is three different mechanisms — File System Access
+ (Chrome/Edge), a service worker streaming a response (Firefox/Safari), and a
+ blob as the floor — and no test in this repo exercises any of them.
+ `test_downloads.py` pins the contracts by reading the source; the behaviour
+ needs a person with a large file. Confirmed by the operator on 2026-08-15:
+ Firefox, 180 MB, written to disk. Nothing multi-gigabyte has been measured
+
**Corrections to remember:**
- `punch_nat()` is **not** a NAT traversal stack — one UDP probe, no STUN, no candidate
gathering, one ISP validated. **ICE/STUN (WebRTC) is the traversal path**, for native