livepilot 1.8.0 → 1.8.2

package/.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "dreamrec-LivePilot",
+  "description": "Agentic MCP production system for Ableton Live 12 — 168 tools, 17 domains",
+  "owner": {
+    "name": "dreamrec",
+    "email": "dreamrec@users.noreply.github.com"
+  },
+  "plugins": [
+    {
+      "name": "livepilot",
+      "description": "Agentic production system for Ableton Live 12 — 168 tools, 17 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+      "version": "1.8.1",
+      "author": {
+        "name": "Pilot Studio"
+      },
+      "source": "./livepilot",
+      "category": "integration"
+    }
+  ]
+}

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 1.8.2 — FluCoMa Wiring + Analyzer Fix (March 2026)
+
+- Fix: wire 6 FluCoMa DSP objects into LivePilot_Analyzer.maxpat (spectral shape, mel bands, chroma, loudness, onset, novelty)
+- Fix: onset/novelty Python handlers now accept 1 arg (fluid.onsetfeature~/noveltyfeature~ output single float)
+- Fix: rebuild .amxd with FluCoMa objects + binary patch openinpresentation
+- FluCoMa perception tools now fully functional when FluCoMa package is installed
+
+## 1.8.1 — Patch (March 2026)
+
+- Fix: `parse_key()` now accepts shorthand key notation ("Am", "C#m", "Bbm") in addition to "A minor" / "C# major"
+- Fix: re-freeze LivePilot_Analyzer.amxd with v1.8.0 bridge + patch openinpresentation
+- Fix: address audit findings from fresh v1.8 code review
+- Fix: update bridge version string
+- Fix: restructure plugin directory for Claude Code marketplace compatibility (`plugin/` → `livepilot/.claude-plugin/`)
+
 ## 1.8.0 — Perception Layer (March 2026)
 
 **13 new tools (155 → 168), 1 new domain (perception), FluCoMa real-time DSP, offline audio analysis, audio capture.**

package/livepilot/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "livepilot",
+  "version": "1.8.2",
+  "description": "Agentic production system for Ableton Live 12 — 168 tools, 17 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "author": {
+    "name": "Pilot Studio"
+  }
+}

package/{plugin → livepilot}/skills/livepilot-release/SKILL.md

@@ -12,24 +12,24 @@ Run this checklist EVERY time the user says "update everything", "push", "releas
 - [ ] `package.json` → `"version"`
 - [ ] `package-lock.json` → `"version"` (run `npm install --package-lock-only` if stale)
 - [ ] `server.json` → `"version"` (TWO locations: top-level and package)
-- [ ] `plugin/plugin.json` → `"version"`
+- [ ] `livepilot/.claude-plugin/plugin.json` → `"version"`
 - [ ] `mcp_server/__init__.py` → `__version__`
 - [ ] `remote_script/LivePilot/__init__.py` → version in log message
 - [ ] `m4l_device/livepilot_bridge.js` → version in ping response
 - [ ] `CHANGELOG.md` → latest version header
 - [ ] `docs/social-banner.html` → version display
 
-**How to check:** `grep -rn "1\.[0-9]\.[0-9]" package.json server.json plugin/plugin.json mcp_server/__init__.py remote_script/LivePilot/__init__.py m4l_device/livepilot_bridge.js CHANGELOG.md docs/social-banner.html`
+**How to check:** `grep -rn "1\.[0-9]\.[0-9]" package.json server.json livepilot/.claude-plugin/plugin.json mcp_server/__init__.py remote_script/LivePilot/__init__.py m4l_device/livepilot_bridge.js CHANGELOG.md docs/social-banner.html`
 
 ## 2. Tool Count (must ALL match)
 
 - [ ] `README.md` — every occurrence
 - [ ] `package.json` → `"description"`
 - [ ] `server.json` → `"description"`
-- [ ] `plugin/plugin.json` → `"description"`
+- [ ] `livepilot/.claude-plugin/plugin.json` → `"description"`
 - [ ] `CLAUDE.md`
-- [ ] `plugin/skills/livepilot-core/SKILL.md` — header and domain breakdown
-- [ ] `plugin/skills/livepilot-core/references/overview.md`
+- [ ] `livepilot/skills/livepilot-core/SKILL.md` — header and domain breakdown
+- [ ] `livepilot/skills/livepilot-core/references/overview.md`
 - [ ] `docs/manual/index.md`
 - [ ] `docs/manual/tool-reference.md`
 - [ ] `docs/TOOL_REFERENCE.md`
@@ -97,5 +97,5 @@ Run this checklist EVERY time the user says "update everything", "push", "releas
 
 Run this one-liner to catch most issues:
 ```bash
-echo "=== Versions ===" && grep -h '"version"' package.json server.json plugin/plugin.json | head -5 && grep __version__ mcp_server/__init__.py && echo "=== Tool count ===" && grep -rc "@mcp.tool" mcp_server/tools/ | tail -1 && echo "=== npm ===" && npm view livepilot version 2>/dev/null && echo "=== GitHub release ===" && gh release list --limit 1 && echo "=== Tags ===" && git tag -l
+echo "=== Versions ===" && grep -h '"version"' package.json server.json livepilot/.claude-plugin/plugin.json | head -5 && grep __version__ mcp_server/__init__.py && echo "=== Tool count ===" && grep -rc "@mcp.tool" mcp_server/tools/ | tail -1 && echo "=== npm ===" && npm view livepilot version 2>/dev/null && echo "=== GitHub release ===" && gh release list --limit 1 && echo "=== Tags ===" && git tag -l
 ```

package/m4l_device/LivePilot_Analyzer.maxpat

@@ -37,6 +37,20 @@
 		"subpatcher_template": "",
 		"assistshowspatchername": 0,
 		"boxes": [
+			{
+				"box": {
+					"id": "obj-panel",
+					"maxclass": "panel",
+					"numinlets": 1,
+					"numoutlets": 0,
+					"patching_rect": [50.0, 790.0, 350.0, 82.0],
+					"presentation": 1,
+					"presentation_rect": [0.0, 0.0, 350.0, 170.0],
+					"bgcolor": [0.12, 0.12, 0.12, 1.0],
+					"bordercolor": [0.2, 0.2, 0.2, 1.0],
+					"border": 1
+				}
+			},
 			{
 				"box": {
 					"id": "obj-1",
@@ -415,7 +429,7 @@
 					"id": "obj-js",
 					"maxclass": "newobj",
 					"text": "js livepilot_bridge.js",
-					"numinlets": 1,
+					"numinlets": 2,
 					"numoutlets": 2,
 					"outlettype": ["", ""],
 					"patching_rect": [500.0, 550.0, 130.0, 22.0]
@@ -443,20 +457,6 @@
 					"patching_rect": [700.0, 500.0, 95.0, 22.0]
 				}
 			},
-			{
-				"box": {
-					"id": "obj-panel",
-					"maxclass": "panel",
-					"numinlets": 1,
-					"numoutlets": 0,
-					"patching_rect": [50.0, 790.0, 350.0, 82.0],
-					"presentation": 1,
-					"presentation_rect": [0.0, 0.0, 350.0, 170.0],
-					"bgcolor": [0.12, 0.12, 0.12, 1.0],
-					"bordercolor": [0.2, 0.2, 0.2, 1.0],
-					"border": 1
-				}
-			},
 			{
 				"box": {
 					"id": "obj-multislider",
@@ -592,6 +592,138 @@
 					"outlettype": [""],
 					"patching_rect": [810.0, 620.0, 72.0, 22.0]
 				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-spectralshape",
+					"maxclass": "newobj",
+					"text": "fluid.spectralshape~ @fftsettings 2048 512",
+					"numinlets": 1,
+					"numoutlets": 2,
+					"outlettype": ["", ""],
+					"patching_rect": [50.0, 880.0, 260.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-prepend-spectralshape",
+					"maxclass": "newobj",
+					"text": "prepend /spectral_shape",
+					"numinlets": 1,
+					"numoutlets": 1,
+					"outlettype": [""],
+					"patching_rect": [50.0, 920.0, 140.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-melbands",
+					"maxclass": "newobj",
+					"text": "fluid.melbands~ 40 @fftsettings 2048 512",
+					"numinlets": 1,
+					"numoutlets": 2,
+					"outlettype": ["", ""],
+					"patching_rect": [320.0, 880.0, 250.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-prepend-melbands",
+					"maxclass": "newobj",
+					"text": "prepend /mel_bands",
+					"numinlets": 1,
+					"numoutlets": 1,
+					"outlettype": [""],
+					"patching_rect": [320.0, 920.0, 115.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-chroma",
+					"maxclass": "newobj",
+					"text": "fluid.chroma~ @fftsettings 4096 1024",
+					"numinlets": 1,
+					"numoutlets": 2,
+					"outlettype": ["", ""],
+					"patching_rect": [580.0, 880.0, 230.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-prepend-chroma",
+					"maxclass": "newobj",
+					"text": "prepend /chroma",
+					"numinlets": 1,
+					"numoutlets": 1,
+					"outlettype": [""],
+					"patching_rect": [580.0, 920.0, 100.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-loudness",
+					"maxclass": "newobj",
+					"text": "fluid.loudness~ @kweighting 1 @truepeak 1",
+					"numinlets": 1,
+					"numoutlets": 2,
+					"outlettype": ["", ""],
+					"patching_rect": [820.0, 880.0, 260.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-prepend-loudness",
+					"maxclass": "newobj",
+					"text": "prepend /loudness",
+					"numinlets": 1,
+					"numoutlets": 1,
+					"outlettype": [""],
+					"patching_rect": [820.0, 920.0, 108.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-onsetfeature",
+					"maxclass": "newobj",
+					"text": "fluid.onsetfeature~",
+					"numinlets": 1,
+					"numoutlets": 2,
+					"outlettype": ["", ""],
+					"patching_rect": [50.0, 960.0, 120.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-prepend-onset",
+					"maxclass": "newobj",
+					"text": "prepend /onset",
+					"numinlets": 1,
+					"numoutlets": 1,
+					"outlettype": [""],
+					"patching_rect": [50.0, 1000.0, 90.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-noveltyfeature",
+					"maxclass": "newobj",
+					"text": "fluid.noveltyfeature~ @kernelsize 21",
+					"numinlets": 1,
+					"numoutlets": 2,
+					"outlettype": ["", ""],
+					"patching_rect": [320.0, 960.0, 220.0, 22.0]
+				}
+			},
+			{
+				"box": {
+					"id": "obj-fc-prepend-novelty",
+					"maxclass": "newobj",
+					"text": "prepend /novelty",
+					"numinlets": 1,
+					"numoutlets": 1,
+					"outlettype": [""],
+					"patching_rect": [320.0, 1000.0, 100.0, 22.0]
+				}
 			}
 		],
 		"lines": [
@@ -665,7 +797,31 @@
 			{"patchline": {"source": ["obj-route-status", 0], "destination": ["obj-set-status", 0]}},
 			{"patchline": {"source": ["obj-set-status", 0], "destination": ["obj-status", 0]}},
 			{"patchline": {"source": ["obj-route-status", 1], "destination": ["obj-set-key", 0]}},
-			{"patchline": {"source": ["obj-set-key", 0], "destination": ["obj-key-display", 0]}}
+			{"patchline": {"source": ["obj-set-key", 0], "destination": ["obj-key-display", 0]}},
+
+			{"patchline": {"source": ["obj-4", 0], "destination": ["obj-fc-spectralshape", 0]}},
+			{"patchline": {"source": ["obj-fc-spectralshape", 0], "destination": ["obj-fc-prepend-spectralshape", 0]}},
+			{"patchline": {"source": ["obj-fc-prepend-spectralshape", 0], "destination": ["obj-udpsend", 0]}},
+
+			{"patchline": {"source": ["obj-4", 0], "destination": ["obj-fc-melbands", 0]}},
+			{"patchline": {"source": ["obj-fc-melbands", 0], "destination": ["obj-fc-prepend-melbands", 0]}},
+			{"patchline": {"source": ["obj-fc-prepend-melbands", 0], "destination": ["obj-udpsend", 0]}},
+
+			{"patchline": {"source": ["obj-4", 0], "destination": ["obj-fc-chroma", 0]}},
+			{"patchline": {"source": ["obj-fc-chroma", 0], "destination": ["obj-fc-prepend-chroma", 0]}},
+			{"patchline": {"source": ["obj-fc-prepend-chroma", 0], "destination": ["obj-udpsend", 0]}},
+
+			{"patchline": {"source": ["obj-4", 0], "destination": ["obj-fc-loudness", 0]}},
+			{"patchline": {"source": ["obj-fc-loudness", 0], "destination": ["obj-fc-prepend-loudness", 0]}},
+			{"patchline": {"source": ["obj-fc-prepend-loudness", 0], "destination": ["obj-udpsend", 0]}},
+
+			{"patchline": {"source": ["obj-4", 0], "destination": ["obj-fc-onsetfeature", 0]}},
+			{"patchline": {"source": ["obj-fc-onsetfeature", 0], "destination": ["obj-fc-prepend-onset", 0]}},
+			{"patchline": {"source": ["obj-fc-prepend-onset", 0], "destination": ["obj-udpsend", 0]}},
+
+			{"patchline": {"source": ["obj-4", 0], "destination": ["obj-fc-noveltyfeature", 0]}},
+			{"patchline": {"source": ["obj-fc-noveltyfeature", 0], "destination": ["obj-fc-prepend-novelty", 0]}},
+			{"patchline": {"source": ["obj-fc-prepend-novelty", 0], "destination": ["obj-udpsend", 0]}}
 		],
 		"dependency_cache": [
 			{

package/m4l_device/livepilot_bridge.js

@@ -83,7 +83,7 @@ function anything() {
 function dispatch(cmd, args) {
     switch(cmd) {
         case "ping":
-            send_response({"ok": true, "version": "1.8.0"});
+            send_response({"ok": true, "version": "1.8.2"});
             break;
         case "get_params":
             cmd_get_params(args);

package/mcp_server/__init__.py

@@ -1,2 +1,2 @@
 """LivePilot MCP Server — bridges MCP protocol to Ableton Live."""
-__version__ = "1.8.0"
+__version__ = "1.8.2"

package/mcp_server/m4l_bridge.py

@@ -189,16 +189,18 @@ class SpectralReceiver(asyncio.DatagramProtocol):
         elif address == "/chroma" and len(args) >= 12:
             self.cache.update("chroma", [round(float(a), 4) for a in args[:12]])
 
-        elif address == "/onset" and len(args) >= 2:
+        elif address == "/onset" and len(args) >= 1:
+            strength = round(float(args[0]), 4)
             self.cache.update("onset", {
-                "detected": float(args[0]) > 0.5,
-                "strength": round(float(args[1]), 4),
+                "detected": strength > 0.5,
+                "strength": strength,
             })
 
-        elif address == "/novelty" and len(args) >= 2:
+        elif address == "/novelty" and len(args) >= 1:
+            score = round(float(args[0]), 4)
             self.cache.update("novelty", {
-                "score": round(float(args[0]), 4),
-                "boundary": float(args[1]) > 0.5,
+                "score": score,
+                "boundary": score > 0.5,
             })
 
         elif address == "/loudness" and len(args) >= 2:

package/mcp_server/server.py

@@ -2,6 +2,9 @@
 
 from contextlib import asynccontextmanager
 import asyncio
+import os
+import signal
+import subprocess
 
 from fastmcp import FastMCP, Context  # noqa: F401
 
@@ -9,6 +12,28 @@ from .connection import AbletonConnection
 from .m4l_bridge import SpectralCache, SpectralReceiver, M4LBridge
 
 
+def _kill_port_holder(port: int) -> None:
+    """Kill whichever process holds the given UDP port.
+
+    Used to reclaim port 9880 when a stale duplicate server instance
+    is hogging it (common when both project .mcp.json and plugin
+    .mcp.json launch the server).
+    """
+    try:
+        out = subprocess.check_output(
+            ["lsof", "-t", "-i", f"UDP:{port}"],
+            text=True,
+            timeout=3,
+        ).strip()
+        my_pid = os.getpid()
+        for pid_str in out.splitlines():
+            pid = int(pid_str)
+            if pid != my_pid:
+                os.kill(pid, signal.SIGTERM)
+    except (subprocess.CalledProcessError, FileNotFoundError, ValueError):
+        pass  # lsof not found or no process — nothing to kill
+
+
 @asynccontextmanager
 async def lifespan(server):
     """Create and yield the shared AbletonConnection + M4L bridge."""
@@ -19,14 +44,35 @@ async def lifespan(server):
 
     # Start UDP listener for incoming M4L spectral data (port 9880)
     loop = asyncio.get_running_loop()
+    transport = None
     try:
         transport, _ = await loop.create_datagram_endpoint(
             lambda: receiver,
             local_addr=('127.0.0.1', 9880),
         )
     except OSError:
-        # Port in use — M4L bridge won't work but core tools still function
-        transport = None
+        # Port 9880 already bound — likely a duplicate server instance
+        # (project .mcp.json + plugin .mcp.json both launching).
+        # Kill the stale holder so this instance gets the port.
+        import sys
+        print(
+            "LivePilot: UDP port 9880 in use — reclaiming from stale instance",
+            file=sys.stderr,
+        )
+        _kill_port_holder(9880)
+        await asyncio.sleep(0.3)
+        try:
+            transport, _ = await loop.create_datagram_endpoint(
+                lambda: receiver,
+                local_addr=('127.0.0.1', 9880),
+            )
+        except OSError:
+            print(
+                "LivePilot: WARNING — could not bind UDP 9880, "
+                "analyzer tools will be unavailable",
+                file=sys.stderr,
+            )
+            transport = None
 
     try:
         yield {

package/mcp_server/tools/_theory_engine.py

@@ -82,8 +82,23 @@ def pitch_name(midi: int) -> str:
 
 
 def parse_key(key_str: str) -> dict:
-    """Parse key string -> {tonic: 0-11, tonic_name: str, mode: str}."""
-    parts = key_str.strip().split()
+    """Parse key string -> {tonic: 0-11, tonic_name: str, mode: str}.
+
+    Accepts: "D minor", "Dm", "C# major", "C#m", "Bb", "Bbm", "F#m".
+    """
+    s = key_str.strip()
+
+    # Shorthand: trailing 'm' after a note name means minor (e.g. "Am", "C#m", "Bbm")
+    # But not "Dm" vs "D" — check if removing 'm' leaves a valid tonic
+    if len(s) >= 2 and s[-1] == 'm' and ' ' not in s:
+        candidate = s[:-1]
+        norm = candidate[0].upper() + candidate[1:]
+        if norm in ENHARMONIC:
+            norm = ENHARMONIC[norm]
+        if norm in NOTE_NAMES:
+            return {"tonic": NOTE_NAMES.index(norm), "tonic_name": norm, "mode": "minor"}
+
+    parts = s.split()
     raw_tonic = parts[0]
     mode = parts[1].lower() if len(parts) > 1 else 'major'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livepilot",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "mcpName": "io.github.dreamrec/livepilot",
   "description": "Agentic production system for Ableton Live 12 — 168 tools, 17 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
   "author": "Pilot Studio",

package/remote_script/LivePilot/__init__.py

@@ -5,7 +5,7 @@ Entry point for the ControlSurface. Ableton calls create_instance(c_instance)
 when this script is selected in Preferences > Link, Tempo & MIDI.
 """
 
-__version__ = "1.8.0"
+__version__ = "1.8.2"
 
 from _Framework.ControlSurface import ControlSurface
 from .server import LivePilotServer
@@ -34,7 +34,7 @@ class LivePilot(ControlSurface):
         ControlSurface.__init__(self, c_instance)
         self._server = LivePilotServer(self)
         self._server.start()
-        self.log_message("LivePilot v1.8.0 initialized")
+        self.log_message("LivePilot v1.8.1 initialized")
         self.show_message("LivePilot: Listening on port 9878")
 
     def disconnect(self):

package/plugin/plugin.json

@@ -1,20 +0,0 @@
-{
-  "name": "livepilot",
-  "version": "1.8.0",
-  "description": "Agentic production system for Ableton Live 12 — 168 tools, 17 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
-  "author": "Pilot Studio",
-  "skills": [
-    "skills/livepilot-core",
-    "skills/livepilot-release"
-  ],
-  "commands": [
-    "commands/session.md",
-    "commands/beat.md",
-    "commands/mix.md",
-    "commands/sounddesign.md",
-    "commands/memory.md"
-  ],
-  "agents": [
-    "agents/livepilot-producer"
-  ]
-}