Files
typewriter/docs/notes
Julien Calixte 4ead64bada docs(notes): mark the sync-latency waterfall as partly superseded
The 2026-07-11 dev-repo record stands, but the publish half it
describes (add_all index staging, mixed-reset reconcile) was replaced
by the splice + soft-reset replay, and the reconcile path is now
hardware-verified. Point to the kaizen and the tradeoff curve for the
real-repo numbers (24.1 s cold :gp).
2026-07-14 12:49:17 +02:00
..
2026-07-14 12:40:51 +02:00
2026-07-14 12:40:51 +02:00

Notes

Longer-form essays on the thinking behind specific Typoena choices — the arguments too big for an ADR and too durable for a commit message.

Docs index: ../README.md. Project overview: ../../README.md.

Note What it argues
ctrl-g-perceived-latency.md Durability before delivery — surfacing "commit landed" at ~0.2 s makes the 510 s Ctrl-G push feel instant.
git-sync-images-and-repo-size.md Why we don't shrink the notes repo — its 153 MB of media is remanso's image CDN, so rewriting history to slim the on-device clone breaks the web app.
boot-time-budget.md Where the ~4.3 s to cursor goes — and why the ≤ 3 s v1.0 target is hard: one ~1.9 s full refresh is unavoidable at cold boot, so the splash is nearly free.
sync-latency.md Where the ~16 s cold :sync goes — Wi-Fi + SNTP + one TLS push; why optimistic-retry cut a whole handshake, and why the rest is close to the protocol floor.