livepilot 1.20.3 → 1.21.0

package/mcp_server/semantic_moves/performance_moves.py

@@ -76,6 +76,51 @@ EMERGENCY_SIMPLIFY = SemanticMove(
     ],
 )
 
+# v1.21: configure_record_readiness — closes the tech_debt entry from
+# v1.20 live test 6 (raw set_track_arm without a semantic-move wrapper).
+# seed_args: {track_index: int, armed: bool, exclusive?: bool = False}.
+# Note: `armed` here is the *ergonomic* seed_arg name — the compiler
+# translates it to the wire-format key `arm` per remote_script/LivePilot/
+# tracks.py:263. See _compile_configure_record_readiness.
+CONFIGURE_RECORD_READINESS = SemanticMove(
+    move_id="configure_record_readiness",
+    family="performance",
+    intent=(
+        "Arm or disarm a track for recording. When exclusive=True, disarms "
+        "all other regular tracks then arms the target — the standard "
+        "one-take recording setup (Live 12.4's `song.exclusive_arm` toggle "
+        "is read-only from Python, so the compiler emulates the mode via "
+        "a manual disarm loop)."
+    ),
+    targets={},
+    protect={"signal_integrity": 0.7},
+    risk_level="low",
+    required_capabilities=["session"],
+    plan_template=[
+        # Informational — compiler builds concrete steps from seed_args.
+        {
+            "tool": "set_track_arm",
+            "params": {"description": "Arm or disarm the target track"},
+            "description": "Toggle track arm",
+            "backend": "remote_command",
+        },
+    ],
+    verification_plan=[
+        {
+            "tool": "get_track_info",
+            "check": "track's arm field matches requested value",
+            "backend": "remote_command",
+        },
+    ],
+)
+
+
 # Register all performance moves
-for _move in [RECOVER_ENERGY, DECOMPRESS_TENSION, SAFE_SPOTLIGHT, EMERGENCY_SIMPLIFY]:
+for _move in [
+    RECOVER_ENERGY,
+    DECOMPRESS_TENSION,
+    SAFE_SPOTLIGHT,
+    EMERGENCY_SIMPLIFY,
+    CONFIGURE_RECORD_READINESS,  # v1.21
+]:
     register(_move)

package/mcp_server/semantic_moves/tools.py

@@ -397,11 +397,14 @@ async def apply_semantic_move(
     success_count = sum(1 for s in executed_steps if s["ok"])
     failure_count = sum(1 for s in executed_steps if not s["ok"])
 
-    # v1.20: write the executed move to the SessionLedger so
-    # get_last_move / memory_list / anti-repetition-rules can see it
-    # WITHOUT requiring the director to call add_session_memory
-    # manually. Best-effort — a ledger write failure must not fail
-    # the overall move.
+    # store_purpose: writer
+    # v1.20: apply_semantic_move is the canonical semantic-moves writer
+    # to the SessionLedger. Downstream anti-repetition / stuckness /
+    # song-brain readers (annotated store_purpose: anti_repetition) consume
+    # entries this block writes. commit_experiment (v1.21) mirrors this
+    # pattern with a "composer|experiment" engine tag instead of
+    # "semantic_moves". Best-effort — a ledger write failure must not
+    # fail the overall move.
     ledger_entry_id: Optional[str] = None
     try:
         from ..runtime.action_ledger import SessionLedger

package/mcp_server/song_brain/tools.py

@@ -139,6 +139,12 @@ def _fetch_session_data(ctx: Context) -> dict:
     except Exception as exc:
         logger.debug("_fetch_session_data failed: %s", exc)
 
+    # store_purpose: anti_repetition
+    # song_brain's _fetch_session_data surfaces recent moves into the
+    # brain's context so section analysis can detect repeated work
+    # patterns. Recency signal — NOT the persistent technique library.
+    # Correct store: SessionLedger.get_recent_moves (v1.20 director SKILL
+    # previously pointed at memory_list for this, which was wrong).
     # Recent moves — from session-scoped action ledger
     try:
         from ..runtime.action_ledger import SessionLedger

package/mcp_server/stuckness_detector/tools.py

@@ -27,6 +27,10 @@ def _get_action_history(ctx: Context) -> list[dict]:
     repeated undos, local-tweaking, loop-without-structure detection.
     Falls back to empty list when no ledger data exists (graceful degradation).
     """
+    # store_purpose: anti_repetition
+    # Stuckness detection reads recent_moves to spot repeated undos,
+    # local-tweaking loops, and loop-without-structure patterns.
+    # Recency signal — NOT the persistent technique library.
     try:
         from ..runtime.action_ledger import SessionLedger
         ledger = ctx.lifespan_context.get("action_ledger")

package/mcp_server/tools/_agent_os_engine/taste.py

@@ -14,6 +14,12 @@ from typing import Any, Optional
 from .models import QUALITY_DIMENSIONS, _clamp
 
 
+# store_purpose: technique_library
+# analyze_outcome_history consumes payloads from the persistent
+# technique library (memory_list(type="outcome")) — NOT recency data.
+# Taste-inference work reads accumulated outcome records, unlike
+# anti-repetition which reads SessionLedger.get_recent_moves.
+
 # ── Outcome Memory Analysis (Round 1) ────────────────────────────────
 def analyze_outcome_history(outcomes: list[dict]) -> dict:
     """Analyze accumulated outcome memories to identify user taste patterns.

package/mcp_server/tools/memory.py

@@ -150,6 +150,13 @@ def _generate_replay_steps(technique: dict) -> list[str]:
     return ["Replay the technique from the stored payload"]
 
 
+# store_purpose: mcp_tool_definition
+# memory_list is the MCP tool for browsing the persistent technique
+# library (memory_learn-populated). Callers that use its output for
+# anti-repetition recency have the v1.20 store-confusion BUG: correct
+# pattern is SessionLedger.get_recent_moves or get_action_ledger_summary.
+# The test tests/test_ledger_readers.py::TestAntiRepetitionUsesLedgerNotMemoryList
+# enforces this invariant across the codebase.
 @mcp.tool()
 def memory_list(
     ctx: Context,

package/mcp_server/wonder_mode/tools.py

@@ -148,6 +148,10 @@ def _get_active_constraints():
 
 def _get_ledger_entries(ctx: Context) -> list[dict]:
     """Get recent action ledger entries as dicts."""
+    # store_purpose: anti_repetition
+    # Wonder Mode's rescue trigger reads recent_moves to feed the
+    # stuckness detector — classic recency signal, NOT the persistent
+    # technique library. Correct store: SessionLedger.get_recent_moves.
     try:
         from ..runtime.action_ledger import SessionLedger
         ledger: SessionLedger = ctx.lifespan_context.setdefault(

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "livepilot",
-  "version": "1.20.3",
+  "version": "1.21.0",
   "mcpName": "io.github.dreamrec/livepilot",
-  "description": "Agentic production system for Ableton Live 12 — 430 tools, 53 domains. Device atlas (1305 devices), sample engine (Splice + browser + filesystem), auto-composition, spectral perception, technique memory, creative intelligence (12 engines)",
+  "description": "Agentic production system for Ableton Live 12 — 430 tools, 53 domains, 43 semantic moves. Device atlas (1305 devices, 120 enriched, 7 indexes), Splice intelligence (gRPC + GraphQL describe-a-sound + preview + collections + presets), 9-band spectral perception auto-loaded via ensure_analyzer_on_master, Creative Director skill, technique memory, 12 creative intelligence engines",
   "author": "Pilot Studio",
   "license": "BSL-1.1",
   "type": "commonjs",

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.20.3"
+__version__ = "1.21.0"
 
 from _Framework.ControlSurface import ControlSurface
 from . import router

package/server.json

@@ -1,17 +1,17 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.dreamrec/livepilot",
-  "description": "430-tool agentic MCP production system for Ableton Live 12 — device atlas, sample engine, composer",
+  "description": "430-tool agentic MCP production system for Ableton Live 12 — 53 domains, 43 semantic moves, device atlas (1305 devices), Splice intelligence (gRPC + GraphQL), 9-band spectral perception auto-loaded, Creative Director skill, technique memory, 12 creative engines",
   "repository": {
     "url": "https://github.com/dreamrec/LivePilot",
     "source": "github"
   },
-  "version": "1.20.3",
+  "version": "1.21.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "livepilot",
-      "version": "1.20.3",
+      "version": "1.21.0",
       "transport": {
         "type": "stdio"
       }