# CLAUDE.md

Tips for future agents working in this repo. It borrows the p2p techniques of
the sibling project `commonview` — read that first; this file only covers what
is different here.

## Architecture

```
src/p2p/
  identity.ts  schnorr keypair; pubkey hex = peer ID  — ported from commonview
  nostr.ts     minimal relay client + topic scheme    — ported (adds event-id dedup)
  peer.ts      WebRTC wrapper: media tracks + a control data channel
  network.ts   the heart: presence roster + the call state machine
src/App.tsx    join form, roster, ring/accept UI, video views
```

## Key design decisions

- **No auto-connect.** Unlike commonview (which meshes every peer), WebRTC is
  only brought up after an explicit `call-request` → `call-accept` handshake;
  `getUserMedia` is also deferred until then. All pre-call messaging rides on
  nostr per-peer topics.
- **One call at a time.** A second incoming ring is auto-declined with
  `busy: true`. Glare (both users call each other) is treated as mutual
  acceptance.
- **Ephemeral events need retries.** The caller re-publishes its ring every 4 s
  (the `Nostr` class dedupes by event id on the receiving side); a callee in
  `connecting` answers a re-ring by re-sending `call-accept`. Ring and connect
  phases both time out at 45 s.
- **Deterministic initiator.** The smaller peer ID creates the offer, same as
  commonview — no perfect-negotiation glare handling. Both sides add their
  tracks before signaling starts so one offer/answer round covers all media.

## Testing

`npm run dev`, then open two browsers (identity is per-browser-profile via
localStorage, so two tabs in one profile are the SAME peer — use a private
window or second browser). `npm run build` type-checks (`tsc -b`) and bundles.