pluginbridge / SYNC.md
RAM2118's picture
update SYNC.md β€” real fix pushed (setAlwaysOnTop + X button working)
4de29df verified
|
Raw History Blame
2.47 kB
# PluginBridge β€” Sync File
> HF Claude builds. Claude Code: pull β†’ build β†’ paste error (if any). That's it.
---
## Claude Code Rules (TOKEN EFFICIENT MODE)
**Your ENTIRE job is these commands:**
```bash
cd ~/pluginbridge && git pull
cd build && cmake --build . --config Release 2>&1 | tail -30
```
**If build succeeds:** Reply "βœ… build ok" β€” nothing else.
**If build fails:** Reply with ONLY the first 3 errors:
```
❌ [filename]:[line] β€” [one-line error message]
```
## DO NOT:
- Explain errors
- Suggest fixes
- Write code
- Add commentary
## Architecture (Current)
**Out-of-process hosting.** Two binaries:
1. `PluginBridge.vst3` β€” thin shell (audio bridge + MCP server), loaded in Ableton
2. `PluginBridgeHelper` β€” standalone exe bundled inside .vst3, hosts the actual plugin
If a plugin crashes β†’ only Helper dies β†’ Ableton survives β†’ UI shows "Reload" button.
## What Was Ditched
- ❌ In-process plugin hosting (crashed Ableton with some plugins)
- ❌ Plugin scanning via `PluginDirectoryScanner` (triggered NSAlert crashes)
- ❌ `addDefaultFormats()` (deleted in JUCE 8)
- ❌ `juce::Thread::setCurrentThreadPriority()` (removed in JUCE 8)
- ❌ `MSG_NOSIGNAL` (doesn't exist on macOS)
- ❌ `NSApplicationActivationPolicyAccessory` β€” broke fullscreen, reverted
- ❌ `showAsFloatingPanel()` with objc_msgSend level hacks β€” broke fullscreen, reverted
- ❌ `NSWindowCollectionBehavior` changes β€” didn't help, reverted
- ❌ Window level 25 (NSStatusWindowLevel) β€” unnecessary, reverted
## What's Working
- βœ… Out-of-process via shared memory + semaphores + Unix socket
- βœ… Crash-safe β€” plugins that abort() only kill the helper
- βœ… Plugin GUI via `setAlwaysOnTop(true)` β€” stays in same Space as Ableton (including fullscreen)
- βœ… X button hides GUI (doesn't quit Helper)
- βœ… Toggle GUI via button in PluginBridge panel (Open GUI / Close GUI)
- βœ… Plugin list from filesystem (no binary loading until user selects)
- βœ… Native pthread priority for audio thread
## Status
**Last push:** 2026-05-16 β€” Fixed fullscreen issue. Root cause: commit 0632681 replaced `setAlwaysOnTop(true)` with objc_msgSend hacks that broke Space behavior. Fix: restored `setAlwaysOnTop(true)` + kept X button fix.
**Build:** Needs test
**Test:** Pull, build, Ableton fullscreen β†’ Open GUI β†’ should open in same Space. X button should hide (not quit).
**Next:** Sprint 3 β€” MCP param control from Claude Code (curl tests)