# 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.