pluginbridge / SYNC.md
RAM2118's picture
update SYNC.md β€” Sprint 3 COMPLETE, MCP verified working end-to-end
64c9482 verified
|
Raw History Blame
2.22 kB
# PluginBridge β€” Sync File
---
## STATUS: v0.5.2 β€” SPRINT 3 COMPLETE (2026-05-17)
Build: βœ… Clean
GUI: βœ… Working (Pro-Q 4, God Particle, Little MicroShift, LIMITER)
MCP: βœ… Verified end-to-end β€” registered in Claude Code config
Crashes: βœ… None (unsafe plugins handled via audio-only mode)
---
## MCP INTEGRATION CONFIRMED
**Server:** `http://127.0.0.1:16620/mcp`
**Registered as:** `pluginbridge` in Claude Code local config
**Scope:** AI MUSIC PRODUCTION project
**Verified working (2026-05-17):**
- `GET /health` β†’ `{"status":"ok","helper":"connected","port":16620}`
- `initialize` β†’ handshake complete
- `tools/list` β†’ 5 tools registered
- `search_param "band 1"` β†’ 24 params returned from Pro-Q 4 with real values
**Pro-Q 4 via MCP:** 737 parameters fully accessible (vs 1 parameter via Ableton LOM)
---
## SPRINTS
| Sprint | Status | What |
|---|---|---|
| Sprint 1 | βœ… | Plugin shell + MCP server |
| Sprint 2 | βœ… | Out-of-process hosting, crash-safe, GUI |
| Sprint 3 | βœ… | MCP param control β€” verified from Claude Code |
| Sprint 4 | **NEXT** | Real-time audio analysis (LUFS, FFT, spectral) |
---
## ARCHITECTURE (v0.5.2)
```
Claude Code / Gemini CLI
β”‚
β”œβ”€β”€ ableton-live-mcp (port 16619) β€” DAW control, LOM, tracks, routing
β”‚
└── pluginbridge (port 16620) β€” plugin parameter control
β”‚
β–Ό
PluginBridge.vst3 (inside Ableton)
β”œβ”€β”€ In-process GUI (safe plugins)
β”œβ”€β”€ Shared memory audio β†’ Helper process (crash-safe)
β”œβ”€β”€ MCP server (5 tools)
└── Safety DB + blocklist
PluginBridgeHelper.app (separate process)
β”œβ”€β”€ Audio processing via shared memory
β”œβ”€β”€ --scan mode for safety testing
└── --load mode for audio routing
```
---
## BUILD
```bash
cd "/Volumes/T7 Shield/Users/Aditya/pluginbridge/build"
cmake --build . --target PluginBridge_VST3 -- -j4
```
---
## MODE: NORMAL (build+test only)
Claude Code rules:
- `pull and build` β†’ pull + cmake build + report result
- `pull and test` β†’ pull + build + run curl tests + report
- For debugging: ML Intern will update SYNC.md to grant full debug mode when needed