| # PluginBridge — Sprint History |
| > Archive. Claude Code reads this only when debugging a historical issue. |
| > Active work goes in SYNC.md. |
|
|
| --- |
|
|
| ## Sprint 1 ✅ |
| Plugin shell + MCP server. Basic VST3 structure, HTTP JSON-RPC endpoint. |
|
|
| ## Sprint 2 ✅ |
| Out-of-process hosting via shared memory. Helper process. Crash isolation. |
| GUI showed in windowed Ableton but broke in fullscreen → led to Sprint 3 redesign. |
|
|
| ## Sprint 3 ✅ (v0.5.2) |
| Full in-process hosting with safety scan. Ableton-style TreeView picker. |
| Fixes: deduplication, manufacturer names, background scan conflict, addChildComponent bug. |
| MCP verified end-to-end. Pro-Q 4 = 737 params via MCP. |
|
|
| ## Sprint 8 ✅ (v0.8.0 — Port 16620 Restored) |
| Reverted out-of-scope regression from Sprint 7: McpServer now tries port 16620 first |
| (via kDefaultMcpPort constant), falls back to bind_to_any_port if taken. |
| First instance always gets 16620. Multi-instance still works. |
| Build: ✅ Clean 2026-05-17. |
| |
| ## Sprint 7 ✅ (v0.7.0 — In-Process Param Routing) |
| Route MCP set_params/get_params/search_param through inProcessPlugin for SAFE plugins. |
| Root cause: after Sprint 5, audio+GUI use in-process instance but MCP still targets Helper's |
| hidden instance → EQ changes invisible in Pro-Q 4. |
| Fix: three param callbacks on McpServer (same pattern as getAnalysisCallback). |
| Also fixes id-vs-index bug: search_param now returns "i" (array index) not VST3 param ID. |
| Build: ✅ Clean 2026-05-17. |
| ⚠️ Out-of-scope regression: port 16620 priority removed from McpServer.cpp → Sprint 8 fixes. |
| |
| ## Sprint 6 ✅ (v0.6.0 — Multi-Instance + Channel Selector) |
| Channel name dropdown in Editor (30 items: Vocals/Drums/Bass/Keys/Synths/Strings/FX/Buses/Custom). |
| Auto-port via bind_to_any_port — each instance gets its own port. |
| InstanceRegistry.h — atomic read/write of /tmp/pluginbridge-registry.json. |
| list_instances MCP tool (6th tool) — returns all loaded channel names. |
| get_analysis prefixed with channel name: "[Vocal Bus] -16.2 LUFS | ..." |
|
|
| ## Sprint 5 ✅ (v0.5.3 — Live Spectrum) |
| Audio routed through in-process plugin for SAFE plugins. |
| Pro-Q 4 spectrum analyzer shows live signal. All plugin GUI meters/displays now work. |
| prepareToPlay() added to loadInProcessPlugin() — safe because UNSAFE plugins never reach it. |
| ML intern correctly identified the prepareToPlay risk and asked before writing code. ✅ |
|
|
| ## Sprint 4 ✅ (AudioAnalyser) |
| Real-time audio analysis: LUFS, true peak, stereo width, spectral centroid, 7-band FFT. |
| `get_analysis` MCP tool wired. |
|
|
| **Regression introduced and fixed (2026-05-17):** |
| ML intern rewrote Editor+Processor while adding AudioAnalyser, reverting to CALayerHost |
| architecture (FAILED-APPROACHES #10). Fixed by restoring from git stash `9042377`. |
| Root cause: ML intern touched locked files outside its task scope. |
| Prevention: scope rules added to MACHINE-CONTEXT.md, NEXT PUSH template in SYNC.md. |
|
|
