Upload SYNC.md

SYNC.md

@@ -8,9 +8,11 @@
 **Your ENTIRE job is these commands:**
 ```bash
 cd ~/pluginbridge && git pull
-cd build && cmake --build . --config Release 2>&1 | tail -30
+cd build && cmake .. -DCMAKE_C_COMPILER=/usr/bin/cc -DCMAKE_CXX_COMPILER=/usr/bin/c++ && cmake --build . --config Release 2>&1 | tail -30
 ```
 
+NOTE: Need full cmake reconfigure (not just build) because CMakeLists.txt changed.
+
 **If build succeeds:** Reply "✅ build ok" — nothing else.
 
 **If build fails:** Reply with ONLY the first 3 errors:
@@ -24,35 +26,37 @@ cd build && cmake --build . --config Release 2>&1 | tail -30
 - 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
+## Architecture (v0.3 — COMPLETE REWRITE)
+
+**In-process hosting (like SnappySnap).** Plugin loads INSIDE Ableton.
+
+```
+PluginBridge.vst3 (loaded in Ableton)
+├── Hosts the plugin IN-PROCESS (processBlock direct)
+├── Plugin GUI embedded inside PluginBridge's own editor
+├── MCP server on port 16620
+├── Blocklist (persistent, prevents known-crashy plugins from loading)
+└── PluginBridgeHelper (bundled in .vst3/Contents/Resources/)
+    └── ONLY used for test-loading — spawned briefly, quits immediately
+```
+
+**User flow:**
+1. Load PluginBridge in Ableton
+2. Select plugin from dropdown (blocked ones greyed out)
+3. Plugin loads → GUI appears inside PluginBridge's window
+4. If load fails → added to blocklist → shows "not compatible" next time
+
+**What was removed (v0.2 → v0.3):**
+- ❌ Shared memory audio routing
+- ❌ Semaphores
+- ❌ Unix socket IPC for audio
+- ❌ HelperConnection.h/.cpp
+- ❌ HelperIPC.h/.cpp
+- ❌ Floating GUI window from Helper process
+- ❌ All NSWindow/objc hacks
 
 ## 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)
+**Last push:** 2026-05-16 — Complete architecture rewrite to in-process hosting
+**Build:** Needs cmake reconfigure + build
+**Test:** Load in Ableton → select Pro-Q 4 → GUI should appear INSIDE PluginBridge's editor panel (same window as Ableton's plugin view)
+**Known:** HelperIPC.cpp and HelperIPC.h still exist in repo but are no longer compiled. Can be deleted later.