Claude
8b5af5d496
Existing plan docs were written before the moq-lite swap, the
create-space + kind-10112 work, and the harness / submodule findings.
This refresh aligns them with what's actually live on the branch and
captures the work still ahead.
- 2026-04-26-audio-rooms-completion.md — flipped to a STATUS-FIRST
layout: implementation table for every protocol/transport/UI
surface, "pending" table for the remaining items (reconnect,
level meters, Desktop / iOS, Nests parity), pointers section
refreshed.
- 2026-04-26-moq-lite-gap.md — marked DONE with the commit range
that landed it (fb47a4c → 71cf99d → 015b0d7); "When picking up"
section now points at the shipped surface first, raw protocol
references second.
- 2026-04-22-nip-audio-rooms-draft.md — major surgery to match
today's nostrnests reality:
* status banner up top calling out the revision
* dependencies dropped IETF MoQ-transport, added moq-lite
Lite-03 + ALPN "moq-lite-03"
* HTTP control plane: GET <service>/<room-d-tag> → POST /auth
with {namespace, publish}, returning {token}; documented the
JWT claim shape (root, get, put), 600 s lifetime, regex
on `namespace`, JWKS endpoint, error matrix
* Audio transport: replaced IETF SETUP / TrackNamespace tuples
/ OBJECT_DATAGRAM with moq-lite Lite-03 (ControlType varint,
per-bidi message types, group uni streams, audio/data track,
no in-band SETUP, FIN-as-unsubscribe semantics)
* New event-kind sections: kind 4312 (admin command / kick),
kind 10112 (audio-room server list)
* Reconciliation section explaining what changed from the
original draft and why
- NEW: 2026-04-26-nostrnests-integration-audit.md — punchlist of
every nostrnests/NestsUI feature we don't yet ship, sourced from
a code-walk of the React app + moq-auth + API.md (which is
LiveKit-era and dead). Tier 1 (low-effort, visible): chat,
reactions, role parsing + promotion, hand-raise queue, kick
(kind 4312), edit/close room, scheduled rooms, listener counter.
Tier 2: participant grid, augmented presence tags
(publishing/onstage), per-avatar context menu + zap, share via
naddr. Tier 3: room theming. Tier 4: token-refresh +
Connection.Reload sanity checks.
Verified `:nestsClient:jvmTest` + `:amethyst:compilePlayDebugKotlin`
both still green after the doc changes (no code touched).
3.9 KiB
3.9 KiB
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=truework 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 - 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/