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:

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)