livepilot 1.9.20 → 1.9.21

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "livepilot",
       "description": "Agentic production system for Ableton Live 12 — 237 tools, 32 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
-      "version": "1.9.20",
+      "version": "1.9.21",
       "author": {
         "name": "Pilot Studio"
       },

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.9.21 — Verification Discipline Pass (April 2026)
+
+### Systemic Fixes
+- **fix(devices):** `set_device_parameter` and `batch_set_parameters` now return `value_string`, `min`, `max` in response — the agent can immediately see "26.0 Hz" instead of just "75" and catch nonsensical values
+- **fix(automation):** `apply_automation_recipe` now auto-scales 0-1 recipe curves to the target parameter's actual native range (e.g., Auto Filter 20-135, Bit Depth 1-16). Previously, a "0.3 center" vinyl_crackle on a 20-135 range wrote 0.3 literally, killing audio
+- **fix(automation):** `auto_pan` recipe pan values now clamped to ±0.6 to prevent full L/R swing that makes tracks disappear from one channel
+- **docs(skill):** Added Golden Rules 15-16 — mandatory post-write verification protocol: always read `value_string`, always check track meters after filter/effect changes, never apply automation recipes without understanding the target parameter's range
+
 ## 1.9.20 — Deep Production Test Pass (April 2026)
 
 ### New Tool

package/livepilot/.Codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "livepilot",
-  "version": "1.9.20",
+  "version": "1.9.21",
   "description": "Agentic production system for Ableton Live 12 — 237 tools, 32 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
   "author": {
     "name": "Pilot Studio"

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

@@ -1,6 +1,6 @@
 {
   "name": "livepilot",
-  "version": "1.9.20",
+  "version": "1.9.21",
   "description": "Agentic production system for Ableton Live 12 — 237 tools, 32 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
   "author": {
     "name": "Pilot Studio"

package/livepilot/skills/livepilot-core/SKILL.md

@@ -27,6 +27,13 @@ Agentic production system for Ableton Live 12. 237 tools across 32 domains, thre
 12. **ALWAYS report tool errors** — never silently swallow errors. Include: tool name, error message, fallback plan
 13. **Verify plugin health after loading** — check `health_flags`, `mcp_sound_design_ready`, `plugin_host_status`. If `parameter_count` <= 1 on AU/VST → dead plugin, delete and replace
 14. **Use `C hijaz` for Hijaz/Phrygian Dominant keys** — avoids false out-of-key warnings
+15. **VERIFY AFTER EVERY WRITE** — mandatory, non-negotiable:
+    - After `set_device_parameter` or `batch_set_parameters`: read `value_string` in the response to confirm the actual Hz/dB/% value makes sense
+    - After any filter, EQ, or effect parameter change: call `get_track_meters(include_stereo=true)` and verify the target track has non-zero left AND right levels
+    - After `apply_automation_recipe`: check that the recipe didn't push the parameter to an extreme that kills audio
+    - If a track's stereo output drops to 0: the effect is killing the signal — check `get_device_parameters` for `value_string`, fix, re-verify
+    - **Parameter ranges are NOT always 0-1.** Auto Filter Frequency is 20-135. Bit Depth is 1-16. Always read `value_string` to see actual units.
+16. **NEVER apply automation recipes without understanding the target parameter's range** — recipes generate 0-1 curves that get auto-scaled for device parameters, but always verify the result
 
 ## Tool Speed Tiers
 

package/livepilot/skills/livepilot-core/references/overview.md

@@ -1,4 +1,4 @@
-# LivePilot v1.9.20 — Architecture & Tool Reference
+# LivePilot v1.9.21 — Architecture & Tool Reference
 
 Agentic production system for Ableton Live 12. 237 tools across 32 domains. Device atlas (280+ devices), spectral perception (M4L analyzer), technique memory, automation intelligence (16 curve types, 15 recipes), music theory (Krumhansl-Schmuckler, species counterpoint), generative algorithms (Euclidean rhythm, tintinnabuli, phase shift, additive process), neo-Riemannian harmony (PRL transforms, Tonnetz), MIDI file I/O.
 

package/m4l_device/livepilot_bridge.js

@@ -84,7 +84,7 @@ function anything() {
 function dispatch(cmd, args) {
     switch(cmd) {
         case "ping":
-            send_response({"ok": true, "version": "1.9.20"});
+            send_response({"ok": true, "version": "1.9.21"});
             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.9.20"
+__version__ = "1.9.21"

package/mcp_server/tools/automation.py

@@ -341,6 +341,32 @@ def apply_automation_recipe(
 
     points = generate_from_recipe(recipe, duration=duration, density=density)
 
+    # Scale recipe's 0.0-1.0 curves to the parameter's actual native range.
+    # Without this, a "0.3" center on a 20-135 range parameter writes 0.3
+    # literally instead of scaling to the 20-135 range — killing the signal.
+    if parameter_type == "device" and device_index is not None and parameter_index is not None:
+        try:
+            dev_info = _get_ableton(ctx).send_command("get_device_parameters", {
+                "track_index": track_index,
+                "device_index": device_index,
+            })
+            params_list = dev_info.get("parameters", [])
+            if parameter_index < len(params_list):
+                p_info = params_list[parameter_index]
+                p_min = float(p_info.get("min", 0))
+                p_max = float(p_info.get("max", 1))
+                # Only scale if the range is NOT already 0-1
+                if abs(p_max - p_min) > 1.5 or p_min < -0.5:
+                    for pt in points:
+                        pt["value"] = p_min + pt["value"] * (p_max - p_min)
+        except Exception:
+            pass  # Fail open — write values as-is if we can't read the range
+
+    # Safety clamp: auto_pan amplitude should be limited to avoid full L/R swing
+    if recipe == "auto_pan" and parameter_type == "panning":
+        for pt in points:
+            pt["value"] = max(-0.6, min(0.6, pt["value"]))
+
     if time_offset > 0:
         for p in points:
             p["time"] += time_offset

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "livepilot",
-  "version": "1.9.20",
+  "version": "1.9.21",
   "mcpName": "io.github.dreamrec/livepilot",
   "description": "Agentic production system for Ableton Live 12 — 237 tools, 32 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.9.20"
+__version__ = "1.9.21"
 
 from _Framework.ControlSurface import ControlSurface
 from .server import LivePilotServer

package/remote_script/LivePilot/devices.py

@@ -104,7 +104,13 @@ def set_device_parameter(song, params):
         raise ValueError("Must provide parameter_name or parameter_index")
 
     param.value = value
-    return {"name": param.name, "value": param.value}
+    return {
+        "name": param.name,
+        "value": param.value,
+        "value_string": param.str_for_value(param.value),
+        "min": param.min,
+        "max": param.max,
+    }
 
 
 @register("batch_set_parameters")
@@ -157,7 +163,11 @@ def batch_set_parameters(song, params):
                 )
 
         param.value = value
-        results.append({"name": param.name, "value": param.value})
+        results.append({
+            "name": param.name,
+            "value": param.value,
+            "value_string": param.str_for_value(param.value),
+        })
 
     return {"parameters": results}