RAM2118 commited on
Commit
715eca0
Β·
verified Β·
1 Parent(s): 2224b8a

Upload SYNC.md

Browse files
Files changed (1) hide show
  1. SYNC.md +35 -11
SYNC.md CHANGED
@@ -8,9 +8,13 @@
8
  **Your ENTIRE job is these commands:**
9
  ```bash
10
  cd ~/pluginbridge && git pull
11
- cd build && cmake --build . --config Release 2>&1 | tail -30
 
 
12
  ```
13
 
 
 
14
  **If build succeeds:** Reply "βœ… build ok" β€” nothing else.
15
 
16
  **If build fails:** Reply with ONLY the first 3 errors:
@@ -24,17 +28,37 @@ cd build && cmake --build . --config Release 2>&1 | tail -30
24
  - Write code
25
  - Add commentary
26
 
27
- ## POST-BUILD ACTION (this time only):
28
- After successful build, also run:
29
- ```bash
30
- rm -f ~/Library/Application\ Support/PluginBridge/blocklist.txt
31
  ```
32
- This clears the blocklist because Pro-Q 4 was wrongly added due to the previous bug.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
33
 
34
- ## Architecture (v0.3)
35
- In-process hosting. Helper is test-only (spawned before load to check safety).
36
 
37
  ## Status
38
- **Last push:** 2026-05-16 β€” Fixed Helper test-load: paths with spaces + message loop needed for VST3 validation.
39
- **Build:** Needs test
40
- **Test:** Restart Ableton β†’ load PluginBridge β†’ select Pro-Q 4 β†’ should load successfully (2-3 sec first time while Helper tests).
 
 
8
  **Your ENTIRE job is these commands:**
9
  ```bash
10
  cd ~/pluginbridge && git pull
11
+ rm -rf build && mkdir build && cd build
12
+ cmake .. -DCMAKE_C_COMPILER=/usr/bin/cc -DCMAKE_CXX_COMPILER=/usr/bin/c++
13
+ cmake --build . --config Release 2>&1 | tail -40
14
  ```
15
 
16
+ NOTE: Full clean rebuild needed β€” architecture changed from v0.3 (in-process) to v0.4 (out-of-process with CARemoteLayerServer).
17
+
18
  **If build succeeds:** Reply "βœ… build ok" β€” nothing else.
19
 
20
  **If build fails:** Reply with ONLY the first 3 errors:
 
28
  - Write code
29
  - Add commentary
30
 
31
+ ## Architecture (v0.4 β€” CARemoteLayerServer)
32
+
 
 
33
  ```
34
+ PluginBridge.vst3 (inside Ableton):
35
+ β”œβ”€β”€ PluginBridgeProcessor (audio via shared memory)
36
+ β”œβ”€β”€ PluginBridgeEditor.mm (displays CARemoteLayerClient layer β€” plugin GUI inside Ableton window)
37
+ β”œβ”€β”€ HelperConnection (spawns helper, IPC, shared mem)
38
+ β”œβ”€β”€ McpServer (port 16620)
39
+ └── Blocklist (~/Library/PluginBridge/blocklist.txt)
40
+
41
+ PluginBridgeHelper.app (separate process, crash-safe):
42
+ β”œβ”€β”€ main.cpp (JUCE app, --pid argument)
43
+ β”œβ”€β”€ HelperPluginHost.mm (loads plugin, audio, CARemoteLayerServer for GUI)
44
+ β”œβ”€β”€ HelperIPC.cpp (commands + mouse/key event forwarding)
45
+ └── SharedAudioBuffer.h (shared memory audio bridge)
46
+ ```
47
+
48
+ **How GUI works:**
49
+ 1. Helper loads plugin β†’ creates editor β†’ renders into CARemoteLayerServer
50
+ 2. Helper registers Mach port via NSMachBootstrapServer (named per PID)
51
+ 3. Helper sends "gui_ready" notification with port name + size to host
52
+ 4. PluginBridge.vst3 looks up Mach port β†’ creates CARemoteLayerClient
53
+ 5. Adds client.layer as sublayer of JUCE editor's NSView
54
+ 6. Plugin GUI appears INSIDE Ableton's plugin window (no separate window)
55
+ 7. Mouse/keyboard events forwarded from host β†’ helper via IPC
56
 
57
+ **Crash safety:** Plugin crashes kill only the Helper. Ableton survives.
58
+ **Fullscreen:** CALayer is part of the view hierarchy β€” follows into fullscreen.
59
 
60
  ## Status
61
+ **Last push:** 2026-05-17 β€” v0.4 complete rewrite (CARemoteLayerServer architecture)
62
+ **Build:** Needs clean rebuild (rm -rf build)
63
+ **Test:** Restart Ableton β†’ load PluginBridge β†’ select Pro-Q 4 β†’ GUI should appear inside PluginBridge's editor (no floating window). Then test Kickstart 2 β†’ should NOT crash Ableton (Helper crashes, gets blocklisted).
64
+ **Also clear blocklist:** `rm -f ~/Library/PluginBridge/blocklist.txt`