Claude
dfdf07269d
Adds Fix #6 (L2 — SubscribeOk narrowing), Fix #7 (L3 — subscriber-driven Probe API), and Fix #8 (L1 — version-aware Lite-03/04 codec + ALPN negotiation) to the compliance audit document. Updates the gap matrix (L1/L2/L3 → ✅) and the TL;DR (now reads "nine shipped fixes + M6 closed; every gap is now resolved, no items remain deferred"). The "what's deliberately deferred" section now lists only the external follow-up — a `kixelated/moq` feature request suggesting per-deployment tuning of moq-rs's per-subscriber forward-queue starvation behavior. That's an upstream-relay concern, not a moq-lite gap. Updates the audio-rooms completion-plan pointer to reflect the shipped count and the absence of remaining deferrals. Audit doc title acknowledges Lite-04 alongside Lite-03 since the codec now speaks both. https://claude.ai/code/session_012TGfo99Ugz7fcCPv85a8Tq
87 lines
4.7 KiB
Markdown
87 lines
4.7 KiB
Markdown
# Audio rooms — completion plan
|
|
|
|
> **STATUS (2026-04-26 PM):** Listener and speaker paths are both live
|
|
> end-to-end on moq-lite Lite-03, the create-space flow ships, and the
|
|
> kind-10112 host-server list lives in Settings. What remains is
|
|
> hardening (reconnect / leave cleanup / per-speaker level metering),
|
|
> Nests-feature parity (chat, hand-raise approval, recordings — see
|
|
> the integration audit), and Desktop / iOS targets.
|
|
> `:nestsClient:jvmTest` (~140 unit tests) is green; integration tests
|
|
> behind `-DnestsInterop=true` work against a real Docker'd nostrnests
|
|
> stack.
|
|
|
|
## Implementation state
|
|
|
|
### Transport + protocol
|
|
|
|
| Surface | Status | Notes |
|
|
|---|---|---|
|
|
| `:quic` v1 + HTTP/3 + WebTransport | ✅ done | RFC 9000 + 9220; auditor passes |
|
|
| moq-lite Lite-03 codec (announce / subscribe / group) | ✅ done | `moq/lite/`, full unit suite |
|
|
| moq-lite session (listener + publisher) | ✅ done | `MoqLiteSession.client(...)` |
|
|
| `WebTransportSession.incomingBidiStreams` + `openUniStream` | ✅ done | needed for publisher |
|
|
| IETF `draft-ietf-moq-transport-17` codec | ✅ done | reference impl, no production caller |
|
|
|
|
### `:nestsClient`
|
|
|
|
| Surface | Status | Notes |
|
|
|---|---|---|
|
|
| HTTP `/auth` JWT mint (NIP-98 → ES256 JWT) | ✅ done | `OkHttpNestsClient.mintToken` |
|
|
| `connectNestsListener` → `MoqLiteNestsListener` | ✅ done | path = `/<namespace>?jwt=<token>` |
|
|
| `connectNestsSpeaker` → `MoqLiteNestsSpeaker` | ✅ done | publishes `audio/data` track |
|
|
| `AudioRecordCapture` + `MediaCodecOpusEncoder` | ✅ done | Android actuals |
|
|
| `MediaCodecOpusDecoder` + `AudioTrackPlayer` | ✅ done | Android actuals |
|
|
| `AudioRoomMoqLiteBroadcaster` + `AudioRoomPlayer` | ✅ done | encode / decode pumps |
|
|
| Interop harness (Docker compose nostrnests stack) | ✅ done | `NostrNestsHarness`, 4 test classes |
|
|
|
|
### Amethyst (Android UI)
|
|
|
|
| Surface | Status | Notes |
|
|
|---|---|---|
|
|
| `AudioRoomsScreen` feed of kind-30312 events | ✅ done | from followed users |
|
|
| `AudioRoomJoinCard` → launches `AudioRoomActivity` | ✅ done | passes service / endpoint / hostPubkey |
|
|
| `AudioRoomActivity` (full screen + PIP) | ✅ done | lifecycle anchor |
|
|
| `AudioRoomViewModel` (listener + speaker state) | ✅ done | `commons/.../viewmodels/` |
|
|
| Foreground service (`AudioRoomForegroundService`) | ✅ done | listening + microphone variants |
|
|
| Mute / unmute / hand-raise UI | ✅ done | drives `BroadcastHandle.setMuted` + presence |
|
|
| Kind-10312 presence heartbeat | ✅ done | 30 s + debounced state-change publish |
|
|
| **"Start space" FAB → `CreateAudioRoomSheet`** | ✅ done | publishes kind-30312 with caller as host |
|
|
| **Settings → Audio-room servers (kind 10112)** | ✅ done | replaceable list, defaults to `nostrnests.com` |
|
|
|
|
### Pending
|
|
|
|
| Item | Phase | Effort |
|
|
|---|---|---|
|
|
| Reconnect / retry on listener Failed | M8 | 1 d |
|
|
| Per-speaker level meters (RMS from decoder output) | M8 | 1 d |
|
|
| Connection-failure UX copy (typed reasons → strings) | M8 | 0.5 d |
|
|
| Desktop audio capture + playback | future | gated on Compose Desktop AudioInput API |
|
|
| iOS audio capture + playback | future | new `iosMain` actuals |
|
|
| Nests-feature parity (chat, mod, recordings, …) | see integration audit | varies |
|
|
|
|
## Pointers
|
|
|
|
- moq-lite wire spec + IETF gap: `nestsClient/plans/2026-04-26-moq-lite-gap.md`
|
|
- moq-lite Lite-03/04 compliance audit (2026-05-09): `nestsClient/plans/2026-05-09-moq-lite-rfc-compliance.md` —
|
|
no 🔴 wire-incompatibilities found; **nine spec tightenings
|
|
shipped end-to-end**: AnnouncePlease prefix-mismatch, Subscribe
|
|
broadcast validation, trackPriority bit-pack matching
|
|
kixelated's `PriorityHandle`, publishers-list freshness on
|
|
inbound bidi dispatch, RESET_STREAM with typed code on Drop
|
|
replies, STOP_SENDING(SUBSCRIPTION_GONE) on dead group uni,
|
|
SubscribeOk narrowing of `startGroup` to publisher's
|
|
`nextSequence`, subscriber-driven Probe API
|
|
(`MoqLiteSession.probe()`), and full Lite-04 codec + ALPN
|
|
negotiation (`MoqLiteVersion` enum, `wt-protocol` parsing,
|
|
dual-version advertisement). M6 (Goaway body) closed via spec
|
|
verification (no body in Lite-03/04). **No items remain
|
|
deferred.**
|
|
- Nostrnests integration audit (gaps + roadmap): see most recent doc in `nestsClient/plans/`
|
|
- QUIC stack status: `quic/plans/2026-04-26-quic-stack-status.md`
|
|
- Audio-rooms NIP draft (needs refresh after the moq-lite findings):
|
|
`docs/plans/2026-04-22-nip-audio-rooms-draft.md`
|
|
- Listener entry: `nestsClient/src/commonMain/kotlin/com/vitorpamplona/nestsclient/NestsConnect.kt`
|
|
- Speaker entry: same file (`connectNestsSpeaker`)
|
|
- Create-space sheet: `amethyst/src/main/java/com/vitorpamplona/amethyst/ui/screen/loggedIn/audiorooms/create/`
|
|
- Servers settings: `amethyst/src/main/java/com/vitorpamplona/amethyst/ui/actions/nestsServers/`
|