Soundboard 61: apps/fluxer and devserver: soundboard and entrance-sound runtime, parity #390

Closed
opened 2026-11-13 01:40:53 +00:00 by charles · 0 comments
Owner

Plan: docs/superpowers/plans/2026-11-12-textchat.md, section "Task 61" (Soundboard and entrance sounds, added 2026-11-12, high priority per Charles).

Task 61: apps/fluxer and devserver: soundboard and entrance-sound runtime, parity

Issue: (to be created)
Closes: #92 (with Text chat 14).

Touches apps/fluxer and fluxer-devserver (serialised: devserver routes and fixtures first, then the runtime), plus the parity docs.

Files:

  • Create: apps/fluxer/src/sound_edit_rt.rs
  • Modify: apps/fluxer/src/{runtime.rs,audio_rt.rs,main.rs}, apps/fluxer/README.md; crates/fluxer-devserver/src/{http.rs,voice.rs}, crates/fluxer-devserver/fixtures/ (soundboard sounds with a custom emoji and a creator, a second guild with sounds and an icon, an entrance library with two sounds and selections), crates/fluxer-devserver/README.md; docs/parity/voice.md (rows → done), docs/parity/settings.toml (section-voice_video-entrance-sound → done, note removed)
  • Test: apps/fluxer/tests/voice_runtime.rs, crates/fluxer-devserver/tests/voice.rs

Interfaces:

  • Consumes: Tasks 55–58; Text chat 14 (synced soundboard favourites) and 21 (PatchUserSettings execution).

  • Produces (runtime): the new ApiRequests (UploadEntranceSound, RenameEntranceSound, DeleteEntranceSound, PutEntranceSoundSelection) on ApiClient with their ApiResults; AudioCommand::PlayClipBytes → AudioEngine::play_clip(key, Some(bytes), gain, tag), AudioCommand::StopClip(tag) → stop_clip; sound_edit_rt::AppSoundFiles wraps fluxer_platform::files::SoundFiles (reads) and implements SoundFileReader::{outline, trim} with fluxer_audio::edit on the blocking pool (300 buckets), injected into fluxer_ui::run in place of SoundFiles; nothing of a file or path is logged.

  • Produces (devserver, shaped like api/user/entrance_sound/EntranceSoundController.ts and EntranceSoundService.ts, the fixture commit names them): POST /users/@me/entrance-sounds (201, quota 8 → 400 ENTRANCE_SOUND_QUOTA_REACHED), PATCH and DELETE /users/@me/entrance-sounds/{id} (delete clears selections), PUT /users/@me/entrance-sound-selections (204, scope pattern checked); limits with feature_voice_entrance_sounds on; the new soundboard fixtures.

  • Step 1: Write failing tests: devserver — entrance_upload_rename_delete_and_select, entrance_quota_is_eight, entrance_delete_clears_selections, selection_scope_is_validated; runtime (devserver + fake audio) — preview_sound_reaches_the_mixer, local_preview_plays_bytes_and_stops, outline_and_trim_answer_through_the_reader, entrance_upload_select_and_join_announces_it, muted_entrance_user_plays_nothing, edit_sound_round_trip_through_gateway_update, soundboard_favourite_star_syncs_through_user_settings (#92: a star in the popout becomes one debounced PATCH /users/@me/settings whose soundboard_picker.favorite_sound_keys holds it; a USER_SETTINGS_UPDATE from another session replaces the local list).

  • Step 2–5: FAIL → implement → PASS → commit feat(app): soundboard and entrance-sound runtime, devserver endpoints, parity. In the PR: the steps Charles runs on his desktop (preview, upload with trim, edit, delete confirm, cooldown countdown after spamming sounds, entrance pick/upload/preview, joining with an entrance sound heard by a second client, per-user entrance mute/volume, favourites matching the Electron app).

🤖 Generated with Claude Code

Plan: `docs/superpowers/plans/2026-11-12-textchat.md`, section "Task 61" (Soundboard and entrance sounds, added 2026-11-12, high priority per Charles). ### Task 61: `apps/fluxer` and devserver: soundboard and entrance-sound runtime, parity **Issue:** (to be created) **Closes:** #92 (with Text chat 14). Touches `apps/fluxer` and `fluxer-devserver` (serialised: devserver routes and fixtures first, then the runtime), plus the parity docs. **Files:** - Create: `apps/fluxer/src/sound_edit_rt.rs` - Modify: `apps/fluxer/src/{runtime.rs,audio_rt.rs,main.rs}`, `apps/fluxer/README.md`; `crates/fluxer-devserver/src/{http.rs,voice.rs}`, `crates/fluxer-devserver/fixtures/` (soundboard sounds with a custom emoji and a creator, a second guild with sounds and an icon, an entrance library with two sounds and selections), `crates/fluxer-devserver/README.md`; `docs/parity/voice.md` (rows → done), `docs/parity/settings.toml` (`section-voice_video-entrance-sound` → done, note removed) - Test: `apps/fluxer/tests/voice_runtime.rs`, `crates/fluxer-devserver/tests/voice.rs` **Interfaces:** - Consumes: Tasks 55–58; Text chat 14 (synced soundboard favourites) and 21 (`PatchUserSettings` execution). - Produces (runtime): the new `ApiRequest`s (`UploadEntranceSound`, `RenameEntranceSound`, `DeleteEntranceSound`, `PutEntranceSoundSelection`) on `ApiClient` with their `ApiResult`s; `AudioCommand::PlayClipBytes` → `AudioEngine::play_clip(key, Some(bytes), gain, tag)`, `AudioCommand::StopClip(tag)` → `stop_clip`; `sound_edit_rt::AppSoundFiles` wraps `fluxer_platform::files::SoundFiles` (reads) and implements `SoundFileReader::{outline, trim}` with `fluxer_audio::edit` on the blocking pool (300 buckets), injected into `fluxer_ui::run` in place of `SoundFiles`; nothing of a file or path is logged. - Produces (devserver, shaped like `api/user/entrance_sound/EntranceSoundController.ts` and `EntranceSoundService.ts`, the fixture commit names them): `POST /users/@me/entrance-sounds` (201, quota 8 → 400 `ENTRANCE_SOUND_QUOTA_REACHED`), `PATCH` and `DELETE /users/@me/entrance-sounds/{id}` (delete clears selections), `PUT /users/@me/entrance-sound-selections` (204, scope pattern checked); `limits` with `feature_voice_entrance_sounds` on; the new soundboard fixtures. - [ ] **Step 1: Write failing tests**: devserver — `entrance_upload_rename_delete_and_select`, `entrance_quota_is_eight`, `entrance_delete_clears_selections`, `selection_scope_is_validated`; runtime (devserver + fake audio) — `preview_sound_reaches_the_mixer`, `local_preview_plays_bytes_and_stops`, `outline_and_trim_answer_through_the_reader`, `entrance_upload_select_and_join_announces_it`, `muted_entrance_user_plays_nothing`, `edit_sound_round_trip_through_gateway_update`, `soundboard_favourite_star_syncs_through_user_settings` (#92: a star in the popout becomes one debounced `PATCH /users/@me/settings` whose `soundboard_picker.favorite_sound_keys` holds it; a `USER_SETTINGS_UPDATE` from another session replaces the local list). - [ ] **Step 2–5:** FAIL → implement → PASS → commit `feat(app): soundboard and entrance-sound runtime, devserver endpoints, parity`. In the PR: the steps Charles runs on his desktop (preview, upload with trim, edit, delete confirm, cooldown countdown after spamming sounds, entrance pick/upload/preview, joining with an entrance sound heard by a second client, per-user entrance mute/volume, favourites matching the Electron app). 🤖 Generated with [Claude Code](https://claude.com/claude-code)
charles added this to the Text chat milestone 2026-11-13 01:40:53 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/fluxer-native#390
No description provided.