How rapt0p7/scenegrid-console works
SceneGrid combines a real-time Web Audio runtime with asset preparation and developer-facing observability/control tools. The principal workflow is game audio requests entering the engine, being orchestrated and routed through buses to master output, while runtime state is exposed for inspection and control. The README documents the major runtime capabilities; source excerpts and the SOURCE INDEX support several concrete connections. Some unsampled subsystem links are therefore left out rather than inferred.
Main entry points: InspectorApp.tsx Inspector App · AudioEngine.ts Audio Engine · pipeline.ts Asset Pipeline · AudioBusSystem.ts Bus Routing
Components 27
Audio Runtime
- Audio Engine
packages/engine/src/Application/AudioEngine.ts - Sound Playback
packages/engine/src/Infrastructure/loader/SoundController.ts - Voice Culling
packages/engine/src/Domain/Culling/VoiceCullingArbiter.ts - Shared Types
packages/shared/src/Types/Branded.ts
Mix And Orchestration
- Bus Routing
packages/engine/src/Infrastructure/busSystem/AudioBusSystem.ts - Master Output
packages/engine/src/Infrastructure/nodes/MasterOutput.ts - Mixer Snapshots
packages/engine/src/Domain/Mixer/MixerTransitionEngine.ts - RTPC Automation
packages/engine/src/Infrastructure/automation/AutomationEngine.ts - Engine Ticker
packages/engine/src/Infrastructure/scheduling/EngineTicker.ts - Music Orchestration
packages/engine/src/Domain/Orchestration
Asset Tooling
- Asset Pipeline
packages/cli/src/pipeline.ts - Codec Ladder
packages/cli/src/ladder.ts - PCM Metadata
packages/cli/src/pcm.ts - Chunked Streams
packages/cli/src/stream.ts
Debug And Inspect
- Inspector App
packages/inspector/src/InspectorApp.tsx - Snapshot Timeline
packages/inspector/src/hooks/useSnapshotTimeline.ts - Telemetry Bus
packages/inspector/src/hooks/useTelemetryBus.ts - Audio Graph UI
packages/inspector/src/ui/AudioGraph/NodeInspector.tsx - Performance View
packages/inspector/src/ui/PerformanceGraph.tsx - Raw Logger
packages/inspector/src/ui/RawLogger.tsx - What-If Simulator
packages/inspector/src/ui/SimulatorDrawer.tsx - Timeline Scrubber
packages/inspector/src/ui/TimelineScrubber.tsx - Audio Visualizers
packages/debugger/src/visualizers.ts
External Control
- MCP Server
packages/mcp-server/index.ts - Runtime Tools
packages/mcp-server/src/runtime_tools.ts - Telemetry WebSocket
packages/mcp-server/src/WebSocketTelemetryServer.ts
Other components
- Game Application
Connections 24
- Game Application → Audio Engine: requests audio
README.md - Audio Engine → Sound Playback: plays sounds
- Sound Playback → Bus Routing: routes voices
README.md - Bus Routing → Master Output: feeds output
README.md - Audio Engine → Music Orchestration: coordinates music
- Audio Engine → Voice Culling: manages voices
README.md - Audio Engine → Mixer Snapshots: controls mix state
- Mixer Snapshots → Bus Routing: applies transitions
packages/engine/src/Domain/Mixer/MixerTransitionEngine.ts - Engine Ticker → RTPC Automation: ticks automation
packages/engine/src/Infrastructure/automation/AutomationEngine.ts - Asset Pipeline → PCM Metadata: extracts metadata
packages/cli/src/pipeline.ts - Asset Pipeline → Codec Ladder: generates codecs
packages/cli/src/pipeline.ts - Asset Pipeline → Chunked Streams: generates chunks
packages/cli/src/pipeline.ts - Inspector App → Snapshot Timeline: uses timeline
packages/inspector/src/InspectorApp.tsx - Inspector App → Telemetry Bus: uses telemetry
packages/inspector/src/InspectorApp.tsx - Inspector App → Audio Graph UI: renders inspection
packages/inspector/src/InspectorApp.tsx - Inspector App → Performance View: renders metrics
packages/inspector/src/InspectorApp.tsx - Inspector App → Raw Logger: renders logs
packages/inspector/src/InspectorApp.tsx - Inspector App → What-If Simulator: renders simulator
- Inspector App → Timeline Scrubber: renders scrubber
packages/inspector/src/InspectorApp.tsx - Audio Visualizers → Audio Engine: observes audio
- MCP Server → Runtime Tools: dispatches tools
packages/mcp-server/index.ts - MCP Server → Telemetry WebSocket: configures telemetry
packages/mcp-server/index.ts - Runtime Tools → Telemetry WebSocket: uses telemetry
packages/mcp-server/src/runtime_tools.ts - Audio Engine → Shared Types: uses shared types
packages/engine/src/Application/AudioEngine.ts