Basic audio hooks

[deanblackborough]

Summary by CodeRabbit

• New Features
  • Added basic in-app audio support with sound playback that can be enabled or disabled.
  • Introduced scene event signals for actions like firing, jumping, hits, enemy defeats, and round resets.
  • Added an Audio menu with sound toggle and device availability status.
• Bug Fixes
  • Scene event queues now reset correctly when loading scenes and during runtime transitions.
• Documentation
  • Updated project readiness notes and the development roadmap to reflect the latest short-term priorities.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 050c6880-8033-4e4e-98fe-cac6701b8495

📥 Commits

Reviewing files that changed from the base of the PR and between b7b9434 and 00b785f.

⛔ Files ignored due to path filters (3)

• assets/sound-effects/explosion.wav is excluded by !**/*.wav
• assets/sound-effects/jump.wav is excluded by !**/*.wav
• assets/sound-effects/shoot.wav is excluded by !**/*.wav

📒 Files selected for processing (18)

• CMakeLists.txt
• DECISIONS.md
• NOTES.md
• README.md
• src/prune/app/app.cpp
• src/prune/app/app.hpp
• src/prune/audio/audio_system.cpp
• src/prune/audio/audio_system.hpp
• src/prune/scene/artillery/artillery_behaviour.cpp
• src/prune/scene/platformer/platformer_behaviour.cpp
• src/prune/scene/scene.hpp
• src/prune/scene/scene_event.hpp
• src/prune/scene/scene_state.hpp
• src/prune/scene/simple_shooter/simple_shooter_behaviour.cpp
• src/prune/scene/world_scene.cpp
• src/prune/scene/world_scene.hpp
• src/prune/tooling/ui.cpp
• src/prune/tooling/ui.hpp

---

📝 Walkthrough

Walkthrough

Right then, recruit — pull up a chair. This PR wires up a lightweight event bus (SceneEventQueue) that gameplay behaviours (artillery, platformer, simple shooter) can shout into without knowing or caring who's listening. A brand-new AudioSystem listens in, mapping scene event IDs to SDL-loaded sounds and mixing active voices in a device callback. App now owns and drives the audio system's lifecycle, and Ui grows an Audio menu to toggle sound. Docs and notes are refreshed to match.

Estimated code review effort: 4 (Complex) | ~60 minutes

Possibly related PRs

• deanblackborough/Prune#27: Both touch App::run's UI build path and the Ui::build(...) contract.
• deanblackborough/Prune#44: Both extend the prune::Scene base interface, this PR adding event buffering methods.
• deanblackborough/Prune#49: This PR builds pending/clear scene-event hooks onto the WorldScene infrastructure introduced there.

Suggested labels: enhancement

---

A jump, a shot, a tank laid low —
Each scene now whispers where to go.
No wires to sound, no calls direct,
Just events emitted, audio to detect.
Mix your voices, cap them tight —
Ship it clean, and sleep at night. 🐇🔊

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch basic-audio

---

_{Comment @coderabbitai help to get the list of available commands.}