molluskandClaude Opus 4.8 a3263bee03 docs: teach Gemini the codebase via antigravity.toml (project map, invariants, test gotchas)
The system prompt was generic Rust guidance with no project-specific knowledge,
so Gemini kept re-deriving (and re-breaking) the audio-networking design. Adds
four sections distilled from the senior-audit sessions:
- Section 5: project map — module-by-module, with the trait seams to honor.
- Section 6: audio-networking invariants — each maps to a real fixed bug
  (single deterministic-initiator connection per pair; per-peer supervisor owns
  the lifecycle; AbortOnDrop for Connection-holding tasks; silent-drop != close;
  retain the full EndpointAddr and dial it directly; presence layer != transport
  layer; seq header + jitter/PLC; non-blocking broadcast; RT-path rules; UI-event
  throttling; intentional privacy posture).
- Section 7: testing gotchas — stable-address loopback misses eviction bugs,
  iroh's path cache makes lookup-removal a false test, same-host instances are
  invalid for outage tests, explicit close() for prompt drops, clippy/test gates.
- Section 8: offline dep docs at ~/Documents/peerspeak_docs/ + the handoff log.
Also fixes the closing line, which told Gemini to ask for "details of our new
project" on what is now a mature codebase.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-05-31 15:49:12 -04:00
2026-05-29 15:36:55 -04:00
2026-05-29 15:36:55 -04:00
S
Description
No description provided
MIT
14 MiB
2026-07-19 19:57:06 +00:00
Languages
Rust 99.2%
Shell 0.5%
Python 0.2%
Inno Setup 0.1%