livepilot 1.26.2 → 1.27.1

package/CHANGELOG.md

@@ -1,5 +1,97 @@
 # Changelog
 
+## v1.27.1 — 2026-06-21
+
+Maintenance release: 35 verified fixes from a deep multi-agent audit, recursive installed-plugin scanning, and Windows-CI hardening. No change to the tool surface (467 tools / 56 domains).
+
+### Restored — tools that were silently broken
+- `augment_with_samples`, `get_composition_plan`, `propose_composer_branches` — crashed or returned nothing since the v1.24 refactor removed section templates; they now degrade to a single full-length section.
+- `check_clip_key_consistency` — always returned `"unknown"` (removed FastMCP `.fn` accessor).
+- `compare_phrase_renders` — returned an identical empty critique; now analyzes each render.
+
+### Fixed — correctness
+- Reference engine: project spectrum and stereo width are now populated (gap analysis previously ran against an all-zero project).
+- `infer_section_purposes`: drops are no longer mislabeled as tension.
+- Grader: master/return/group tracks identified by their real field names (group containers were inflating track counts).
+- Hook salience: the memorability boost no longer fires on every candidate.
+- Mix: the `flat_dynamics` critic is now reachable (`over_compressed` is a 3–6 dB band).
+- Wavetable adapter uses the real `Osc 1 Pos` parameter name.
+- Simpler slice playback uses the correct base note (36+N); `vibe_fit` energy proxy normalized.
+- Harmony and phrase-grid analysis read from the correct clip slot.
+- `exclude_globs` now match files inside named directories.
+- A single shared technique store so in-session saves are visible to recall/search.
+- Read-only prefix matcher no longer misclassifies mutating tools as safe.
+- Atlas id/name collisions no longer shadow entries; the overlay index is no longer rescanned per namespace.
+- AMXD device-type map recognizes MIDI Tool devices (Live 12.1+).
+- `apply_full_plan_v2` postflight no longer deletes a reused existing track.
+- Fatigue level no longer diluted by low-severity issues; energy-arc no longer desyncs on skipped scenes; `create_preview_set` no longer silently overwrites an existing set.
+
+### Fixed — installed-plugin scanning (#44)
+- The plugin scanner now recurses into vendor subfolders (e.g. `VST3/<Vendor>/Plugin.vst3`); nested plugins are found and vendor folders are no longer emitted as junk inventory records.
+
+### Fixed — safety and resources
+- Splice `is_free` misclassification that could bypass credit/quota gating.
+- Experiment rollback undoes only `remote_command` steps (no longer reverts unrelated edits).
+- Timed-out write commands are dropped instead of re-executing later on the main thread.
+- Order-tolerant M4L bridge chunk reassembly (no permanent response loss on UDP reordering).
+- Installer install-path guard hardened; Splice bearer token gated to splice.com HTTPS hosts; non-numeric Live version strings tolerated instead of crashing the capability probe.
+
+### Performance
+- Blocking sample I/O (SQLite, file decode, FFT, network) moved off the asyncio event loop.
+- Capped previously-unbounded tool responses (`atlas_device_info`, `extension_atlas_search`, corpus synthesis briefs, piano-roll matrix, plugin `sdk_metadata`).
+- Deduped redundant session round-trips (`enter_wonder_mode`, `build_project_brain`).
+
+### CI and tooling
+- Fixed the Windows CI matrix (cp1252 `UnicodeEncodeError` in verifier scripts; POSIX-path test fixture).
+- `build_mcpb.sh` enforces `.mcpbignore`; portable dev scripts.
+
+### Dependencies
+- fastmcp, soundfile 0.14.0, grpcio 1.81.1, protobuf 7.35.1.
+
+## v1.27.0 — 2026-06-16
+
+Probe-first Live 12.4 capability release.
+
+### Added
+
+- Added read-only `probe_link_audio()` and `probe_stem_workflow()` runtime tools. They report observed capability modes and reasons without invoking UI scripting, menu automation, or destructive stem operations.
+- Added `link_audio` and `stem_workflow` capability domains to `get_capability_state()` and `get_session_kernel()`. Both default to `manual_only` unless a real probe supplies routable/callable evidence.
+- Added Live 12.4 version flags for Link Audio, selected-time stem separation, and merge-selected-stems while keeping workflow support probe-gated.
+- Added `operation_profile` to the session kernel with `studio_deep` as the legacy default and profile names for `safe_live`, `arrangement_build`, `sound_design_deep`, and `release_audit`.
+
+### Changed
+
+- `replace_simpler_sample()` and `load_sample_to_simpler()` now report `native_attempted`, `bridge_attempted`, and `fallback_reason` so native-vs-bridge behavior is observable during Live 12.4 sample workflows.
+- Creative Director guidance now includes a Producer Decision Center: library hunt before loading, inspect enriched atlas hits, avoid Analog/Poli/Drift filler unless explicitly requested, and require instrument/source-level programming before effects-only polish.
+- Capability-mode docs now describe the new Link Audio and stem workflow probe domains instead of treating them as undocumented future work.
+
+### Tests
+
+- Added coverage for Live 12.4 version flags, Link/stem capability domains and probe tools, session-kernel operation profiles, sample fallback reporting, and Producer Decision Center contract text.
+
+## v1.26.3 — 2026-06-16
+
+Truth/knowledge patch for Live 12.4.2, local Codex plugin sync, and runtime capability reporting.
+
+### Fixed
+
+- Runtime FluCoMa capability probing now checks the Max/FluCoMa package and live M4L streams instead of a nonexistent Python `flucoma` module, so installed-but-bridge-blocked systems report `flucoma_bridge_unavailable` or `flucoma_no_streams` instead of the misleading `flucoma_not_installed`.
+- Metadata drift checks now cover `AGENTS.md` bridge-command claims and the runtime capability probe's analyzer-tool unavailable message.
+- README compatibility docs now advertise all four Live 12 capability tiers, including the Live 12.4+ Collaborative tier for native Simpler sample replacement.
+- M4L bridge docs and operating contracts now distinguish the M4L `replace_sample` empty-Simpler limitation from the Live 12.4+ native `replace_sample_native` route.
+
+### Added
+
+- Added `scripts/verify_codex_plugin_sync.py` to verify the local Codex plugin active dir, versioned cache dir, mirrored manifests, `.mcp.json`, payload directories, and Local Plugins marketplace entry.
+
+### Changed
+
+- Refreshed Live 12.4.2 knowledge notes for Link Audio, stem-selection workflows, Erosion, Chorus-Ensemble, Delay LFOs, Max 9.1.4, and `SimplerDevice.replace_sample`, while keeping unprobed Link Audio/stem workflows marked as future LivePilot work.
+
+### Tests
+
+- Added drift guards for AGENTS bridge-command claims, analyzer-tool capability probe text, README Live tier docs, and Codex plugin sync verification.
+
 ## v1.26.2 — 2026-05-27
 
 Patch release for Claude/Codex plugin instruction correctness and local install reliability.

package/README.md

@@ -17,7 +17,7 @@
 
 <p align="center">
   An agentic production system for Ableton Live 12.<br>
-  465 tools. 56 domains. Device atlas. Plan-aware Splice integration. Auto-composition. Spectral perception. Technique memory. Drum-rack pad builder. Live dead-device detection.
+  467 tools. 56 domains. Device atlas. Plan-aware Splice integration. Auto-composition. Spectral perception. Technique memory. Drum-rack pad builder. Live dead-device detection.
 </p>
 
 <br>
@@ -38,6 +38,20 @@
 
 ---
 
+## What's New in v1.27.1
+
+A maintenance release that fixes 35 issues from a deep audit and restores tools that had silently broken:
+
+- **Restored tools** — `augment_with_samples`, `get_composition_plan`, `propose_composer_branches`, `check_clip_key_consistency`, and `compare_phrase_renders` were crashing or returning empty results; they now work.
+- **Recursive plugin scanning (#44)** — the User Corpus scanner now finds plugins nested in vendor subfolders (e.g. `VST3/<Vendor>/Plugin.vst3`) instead of only the top level.
+- **Truer analysis** — reference-gap, hook-salience, dynamics, drop-detection, harmony-slot, and grader fixes that previously produced fabricated or empty results.
+- **Safer & faster** — Splice credit-gating fixed, blocking sample I/O moved off the event loop, unbounded tool responses capped, and the M4L bridge no longer loses responses on UDP reordering.
+- **v1.27.0** added two read-only Live 12.4 capability-probe tools (`probe_link_audio`, `probe_stem_workflow`).
+
+Full details in the [CHANGELOG](CHANGELOG.md).
+
+---
+
 ## What LivePilot Does
 
 Most MCP servers are tool collections — they execute commands. LivePilot is an **agentic production system**. It has eight layers that work together:
@@ -59,7 +73,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 
 ## Two Ways to Talk to LivePilot
 
-Pick whichever is faster for the idea in your head — both reach the same 465-tool surface.
+Pick whichever is faster for the idea in your head — both reach the same 467-tool surface.
 
 ### Route A — Artist / aesthetic shorthand
 
@@ -112,7 +126,7 @@ Most sessions do both. Lead with shorthand to anchor the aesthetic, then refine
 │         └─────────────────┼──────────────────┘                       │
 │                           ▼                                          │
 │                  ┌─────────────────┐                                  │
-│                  │   465 MCP Tools  │                                  │
+│                  │   467 MCP Tools  │                                  │
 │                  │   56 domains     │                                  │
 │                  └────────┬────────┘                                  │
 │                           │                                          │
@@ -129,7 +143,7 @@ Most sessions do both. Lead with shorthand to anchor the aesthetic, then refine
 
 ### How the pieces connect
 
-**Remote Script** (`remote_script/LivePilot/`) — A Python ControlSurface that runs inside Ableton's process. Listens on TCP 9878. All Live Object Model calls execute on Ableton's main thread via `schedule_message`. Detects Ableton version at startup and enables three capability tiers: Core (12.0+), Enhanced Arrangement (12.1.10+), Full Intelligence (12.3+).
+**Remote Script** (`remote_script/LivePilot/`) — A Python ControlSurface that runs inside Ableton's process. Listens on TCP 9878. All Live Object Model calls execute on Ableton's main thread via `schedule_message`. Detects Ableton version at startup and enables four capability tiers: Core (12.0+), Enhanced Arrangement (12.1.10+), Full Intelligence (12.3+), Collaborative (12.4+).
 
 **MCP Server** (`mcp_server/`) — Python FastMCP server. Validates inputs, routes commands to the Remote Script over TCP, manages the M4L bridge, runs the atlas, sample engine, composer, and all intelligence engines. This is what your AI client connects to.
 
@@ -153,7 +167,7 @@ Most sessions do both. Lead with shorthand to anchor the aesthetic, then refine
 
 ## The Intelligence Layer
 
-12 engines sit on top of the 465 tools. They give the AI musical judgment, not just musical execution.
+12 engines sit on top of the 467 tools. They give the AI musical judgment, not just musical execution.
 
 ### SongBrain — What the Song Is
 
@@ -205,7 +219,7 @@ Every engine follows: **measure before → act → measure after → compare**.
 
 ## Tools
 
-465 tools across 56 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
+467 tools across 56 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
 
 <br>
 
@@ -473,7 +487,7 @@ Full track with song form: intro, verse, hook, breakdown, outro. Uses a two-phas
 - Native arrangement clips via `create_native_arrangement_clip` (one clip per section, looped to fill section length)
 - Zombie-track cleanup in postflight (removes tracks with no clips and no instrument device)
 - Drum-role pitch repair ported from fast mode
-- **Known gap (v1.25):** `KnowledgePack.atlas_candidates_per_role` is an empty stub — the agent currently falls through to `search_browser` filename matching instead of consulting the indexed atlas. This is BUG-FULL-MODE-24 and is the headline feature of v1.25.
+- **Atlas anchors:** role-level device knowledge is supplied through `KnowledgePack.atlas_anchors`, which consults the indexed atlas rather than filename matching. The older `atlas_candidates_per_role` field is a deprecated legacy stub, kept empty for back-compat.
 - Invoke with: *"Write a full [genre] track at [tempo] BPM"* or *"Build a full arrangement"*
 
 #### develop mode — `develop_apply`
@@ -492,7 +506,7 @@ All three modes share a `KnowledgePack` that provides structured creative contex
 - `event_lexicon` — 42 structural events across 7 categories (drum density, harmonic, texture, vocal, rhythm feel, tension, fx gesture)
 - `genre_context` — parses the 15-genre `genre-vocabularies.md` at load time
 - `artist_context` — parses the ~25-producer `artist-vocabularies.md` at load time
-- `atlas_candidates_per_role` — **stubbed in v1.25.0**, will be populated in v1.25
+- `atlas_anchors` — indexed-atlas device anchors per role (replaced the legacy `atlas_candidates_per_role` stub)
 
 #### Core composer tools
 
@@ -540,7 +554,7 @@ The V2 intelligence layer. These tools analyze, diagnose, plan, evaluate, and le
 | Creative Constraints | 5 | constraint activation, reference-inspired variants |
 | Preview Studio | 5 | variant creation, preview rendering, comparison, commit |
 
-> **[View all 465 tools →](docs/manual/tool-catalog.md)**
+> **[View all 467 tools →](docs/manual/tool-catalog.md)**
 
 <br>
 
@@ -550,7 +564,7 @@ The V2 intelligence layer. These tools analyze, diagnose, plan, evaluate, and le
 
 ### Easiest: Claude Desktop Extension (1 click)
 
-Download [`livepilot.mcpb`](https://github.com/dreamrec/LivePilot/releases/latest) and double-click it.
+Download the latest `livepilot-<version>.mcpb` from the [Releases page](https://github.com/dreamrec/LivePilot/releases/latest) and double-click it.
 Claude Desktop installs everything automatically. Then:
 
 1. Open Ableton Live 12
@@ -584,10 +598,14 @@ Restart Ableton → Preferences → Link, Tempo & MIDI → Control Surface → *
 <details>
 <summary><strong>2. MCP Client</strong></summary>
 
-**Claude Code:**
+**Claude Code** — pick one (installing both registers the MCP server twice and collides on port 9878):
 ```bash
+# MCP server only:
 claude mcp add LivePilot -- npx livepilot
-claude plugin add github:dreamrec/LivePilot/plugin
+
+# Or the full plugin (MCP server + skills + slash commands):
+claude plugin marketplace add github:dreamrec/LivePilot
+claude plugin install livepilot@dreamrec-LivePilot
 ```
 
 **Codex App:**
@@ -680,7 +698,8 @@ npx livepilot --install-codex-plugin
 **Claude Code**
 
 ```bash
-claude plugin add github:dreamrec/LivePilot/plugin
+claude plugin marketplace add github:dreamrec/LivePilot
+claude plugin install livepilot@dreamrec-LivePilot
 ```
 
 | Command | What |
@@ -741,6 +760,7 @@ npx livepilot --version    # Show version
 - **Core (12.0+):** All session tools, mixing, devices, MIDI, theory, generative, memory
 - **Enhanced Arrangement (12.1.10+):** Native arrangement clips, arrangement automation
 - **Full Intelligence (12.3+):** `insert_device_native`, complete device insertion pipeline
+- **Collaborative (12.4+):** `replace_sample_native` and newer sample-editing routes that bypass the M4L fallback when Live exposes a native LOM path
 
 <br>
 
@@ -767,7 +787,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details, code guidelines
 
 | Document | What's inside |
 |----------|---------------|
-| [Manual](docs/manual/index.md) | Complete reference: architecture, all 465 tools, workflows |
+| [Manual](docs/manual/index.md) | Complete reference: architecture, all 467 tools, workflows |
 | [Intelligence Layer](docs/manual/intelligence.md) | How the 12 engines connect — conductor, moves, preview, evaluation |
 | [Device Atlas](docs/manual/device-atlas.md) | 5264 devices indexed — search, suggest, chain building |
 | [Samples & Slicing](docs/manual/samples.md) | 3-source search, fitness critics, slice workflows |

package/bin/livepilot.js

@@ -823,8 +823,10 @@ async function main() {
     console.log("  --help        Show this help");
     console.log("");
     console.log("Environment:");
-    console.log("  LIVE_MCP_HOST   Remote Script host (default: 127.0.0.1)");
-    console.log("  LIVE_MCP_PORT   Remote Script port (default: 9878)");
+    console.log("  LIVE_MCP_HOST          Remote Script host (default: 127.0.0.1)");
+    console.log("  LIVE_MCP_PORT          Remote Script port (default: 9878)");
+    console.log("  LIVEPILOT_AUTO_INSTALL Auto-install Remote Script on launch (set to 'true')");
+    console.log("  LIVEPILOT_TCP_PORT     Override Remote Script port (Desktop Extension/MCPB)");
     return;
   }
 

package/installer/install.js

@@ -46,23 +46,32 @@ function _assertSafeInstallPath(resolvedPath, candidates) {
     "/Applications/Ableton",
     "C:\\ProgramData\\Ableton",
   ];
-  // The detected Ableton candidate paths are always considered safe
+  // True iff `child` equals `root` or is a descendant of it. The path.sep
+  // suffix prevents `/Applications/Ableton-evil` from matching the
+  // `/Applications/Ableton` prefix (prefix-boundary check).
+  const within = (child, root) => {
+    const c = path.resolve(child);
+    const r = path.resolve(root);
+    return c === r || c.startsWith(r + path.sep);
+  };
+  // The destination must be a detected Ableton Remote Scripts dir, a descendant
+  // of one, or under a known-safe prefix. We deliberately do NOT treat an
+  // *ancestor* of a candidate as safe — that previously let
+  // LIVEPILOT_INSTALL_PATH=/ or /Applications slip through (candidate path
+  // "starts with" the broad parent), defeating the guard.
   for (const c of candidates) {
-    if (path.resolve(c.path).startsWith(path.resolve(resolvedPath))) {
-      return;
-    }
-    if (path.resolve(resolvedPath).startsWith(path.resolve(c.path))) {
+    if (within(resolvedPath, c.path)) {
       return;
     }
   }
-  const safe = allowedPrefixes.some((p) => resolvedPath.startsWith(path.resolve(p)));
-  if (!safe) {
-    throw new InstallerAbort(
-      `LIVEPILOT_INSTALL_PATH=${resolvedPath} is outside permitted directories. ` +
-      `Refusing to install. Allowed roots: ${allowedPrefixes.join(", ")}`,
-      { recoverable: false }
-    );
+  if (allowedPrefixes.some((p) => within(resolvedPath, p))) {
+    return;
   }
+  throw new InstallerAbort(
+    `LIVEPILOT_INSTALL_PATH=${resolvedPath} is outside permitted directories. ` +
+    `Refusing to install. Allowed roots: ${allowedPrefixes.join(", ")}`,
+    { recoverable: false }
+  );
 }
 
 /**

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.26.2",
-  "description": "Agentic production system for Ableton Live 12 \u2014 465 tools, 56 domains, 44 semantic moves, device atlas (5264 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, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "version": "1.27.1",
+  "description": "Agentic production system for Ableton Live 12 \u2014 467 tools, 56 domains, 44 semantic moves, device atlas (5264 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, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
   "author": {
     "name": "Pilot Studio"
   }

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.26.2",
-  "description": "Agentic production system for Ableton Live 12 \u2014 465 tools, 56 domains, 44 semantic moves, device atlas (5264 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, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "version": "1.27.1",
+  "description": "Agentic production system for Ableton Live 12 \u2014 467 tools, 56 domains, 44 semantic moves, device atlas (5264 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, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
   "author": {
     "name": "Pilot Studio"
   }

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

@@ -1,11 +1,11 @@
 ---
 name: livepilot-core
-description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 465 tools across 56 domains. This skill should be used whenever working with Ableton Live through MCP tools. Provides golden rules, tool speed tiers, error handling protocol, and pointers to domain and engine skills.
+description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 467 tools across 56 domains. This skill should be used whenever working with Ableton Live through MCP tools. Provides golden rules, tool speed tiers, error handling protocol, and pointers to domain and engine skills.
 ---
 
 # LivePilot Core — Ableton Live 12
 
-Agentic production system for Ableton Live 12. 465 tools across 56 domains, three layers:
+Agentic production system for Ableton Live 12. 467 tools across 56 domains, three layers:
 
 - **Device Atlas** — 5264 devices indexed (120 enriched with sonic intelligence, 683 drum kits). Consult `atlas_search` or `atlas_suggest` before loading any device. Never guess a device name.
 - **M4L Analyzer** — Real-time audio analysis on the master bus (9-band spectrum sub_low → air, RMS/peak, key detection). Optional — all core tools work without it.
@@ -52,7 +52,7 @@ Agentic production system for Ableton Live 12. 465 tools across 56 domains, thre
 ## Tool Speed Tiers
 
 ### Instant (<1s) — Use freely
-All 465 tools plus M4L perception tools.
+All 467 tools plus M4L perception tools.
 
 ### Fast (1-5s) — Use freely
 `analyze_loudness` · `analyze_mix` · `analyze_sound_design`
@@ -142,7 +142,7 @@ Deep production knowledge in `references/`:
 
 | File | Content |
 |------|---------|
-| `references/overview.md` | All 465 tools with params and ranges |
+| `references/overview.md` | All 467 tools with params and ranges |
 | `references/device-atlas/` | 280+ device corpus with URIs and presets |
 | `references/device-knowledge/` | Per-device parameter + technique knowledge |
 | `references/pack-knowledge.md` | All 44 installed packs scored for aesthetic fit (Tier S / A / B / C), with Top / Use-when guidance |
@@ -198,14 +198,14 @@ Use when the user wants options, variants, or is stuck ("surprise me", "try some
 **Rule of thumb**: if the user asked for a specific fix, Flow A. If they asked "what would you do?" or mentioned feel/vibe without parameters, Flow B.
 
 ### Semantic Moves
-High-level musical intents that compile to deterministic tool sequences. 7 families (44 moves as of v1.26.2):
-- **mix** — `tighten_low_end`, `widen_stereo`, `make_punchier`, `darken_without_losing_width`, `reduce_repetition_fatigue`, `make_kick_bass_lock`, `reduce_foreground_competition`
-- **arrangement** — `refresh_repeated_section`, plus structural moves defined alongside mix
-- **transition** — `create_buildup_tension`, `smooth_scene_handoff`, `increase_contrast_before_payoff`, `bridge_sections`, `increase_forward_motion`, `open_chorus`, `create_breakdown`
-- **sound_design** — `add_warmth`, `add_texture`, `shape_transients`, `add_space`
-- **performance** — `recover_energy`, `decompress_tension`, `safe_spotlight`, `emergency_simplify`
-- **device_creation** — `create_chaos_modulator`, `create_feedback_resonator`, `create_wavefolder_effect`, `create_bitcrusher_effect`, `create_karplus_string`, `create_stochastic_texture`, `create_fdn_reverb` (procedural M4L device generation)
-- **sample** — `sample_chop_rhythm`, `sample_texture_layer`, `sample_vocal_ghost`, `sample_break_layer`, `sample_resample_destroy`, `sample_one_shot_accent` (registered from `sample_engine/moves.py`)
+High-level musical intents that compile to deterministic tool sequences. 7 families (44 moves as of v1.27.1):
+- **mix** (9) — `tighten_low_end`, `widen_stereo`, `make_punchier`, `darken_without_losing_width`, `reduce_repetition_fatigue`, `make_kick_bass_lock`, `set_track_routing`, `set_track_metadata`, `configure_send_architecture`
+- **device_creation** (9) — `create_chaos_modulator`, `create_feedback_resonator`, `create_wavefolder_effect`, `create_bitcrusher_effect`, `create_karplus_string`, `create_stochastic_texture`, `create_fdn_reverb`, `create_drum_rack_pad`, `build_send_chain` (procedural M4L device generation)
+- **sound_design** (7) — `add_warmth`, `add_texture`, `shape_transients`, `add_space`, `configure_device`, `remove_device`, `load_chord_source`
+- **sample** (6) — `sample_chop_rhythm`, `sample_texture_layer`, `sample_vocal_ghost`, `sample_break_layer`, `sample_resample_destroy`, `sample_one_shot_accent` (registered from `sample_engine/moves.py`)
+- **performance** (5) — `recover_energy`, `decompress_tension`, `safe_spotlight`, `emergency_simplify`, `configure_record_readiness`
+- **arrangement** (4) — `create_buildup_tension`, `smooth_scene_handoff`, `configure_groove`, `set_scene_metadata`
+- **transition** (4) — `bridge_sections`, `increase_forward_motion`, `open_chorus`, `create_breakdown`
 
 Use `list_semantic_moves(domain="mix")` to discover available moves.
 

package/livepilot/skills/livepilot-core/references/device-knowledge/effects-space.md

@@ -63,7 +63,7 @@ Combines convolution (early reflections from real spaces) with algorithmic (cust
 
 ## Delay
 
-Updated in 12.4 with new LFO modes. The most creative delay in Live.
+Updated in Live 12.4 with a deeper LFO section: rate can be set in Hz, ms, or tempo-synced divisions, with seven waveforms and Morph shaping. The most creative delay in Live.
 
 ### Key Parameters
 
@@ -77,6 +77,7 @@ Updated in 12.4 with new LFO modes. The most creative delay in Live.
 **Mod Freq / Dly < Mod / Filter < Mod:** The modulation section.
 - **Dly < Mod:** Modulates delay time — creates pitch wobble on echoes. At 5-15%, subtle tape-like wow. At 20-40%, obvious pitch warping — dub character. At 50%+, extreme — pitch spirals.
 - **Filter < Mod:** Modulates the filter cutoff with the same LFO — echoes alternately brighten and darken. Combined with Dly < Mod, this creates echoes that are never the same twice.
+- **Morph:** Live 12.4+ waveform shaping. Use small Morph values for stable repeat motion; push Morph when the delay tail should feel handmade, unstable, or visibly animated.
 
 **Filter Freq / Width:** Bandpass filter in the feedback loop. This shapes how each echo changes:
 - Freq 500-1000 Hz, Width 4-6: Dark, telephone-like echoes that thin out over time (classic dub)

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

@@ -1,6 +1,6 @@
-# LivePilot v1.26.2 — Architecture & Tool Reference
+# LivePilot v1.27.1 — Architecture & Tool Reference
 
-Agentic production system for Ableton Live 12. 465 tools across 56 domains. Device atlas (5264 devices, 120 enriched, 47 with aesthetic-tagged `signature_techniques`), spectral perception (M4L analyzer with 9-band FFT — sub_low / sub / low / low_mid / mid / high_mid / high / presence / air), 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, **LIVE Splice describe-a-sound + variations via captured GraphQL endpoints (v1.17)**, drum-rack pad-by-pad construction, live dead-device detection via meter sampling, role-aware Simpler defaults, session-record arrangement-automation workaround.
+Agentic production system for Ableton Live 12. 467 tools across 56 domains. Device atlas (5264 devices, 120 enriched, 47 with aesthetic-tagged `signature_techniques`), spectral perception (M4L analyzer with 9-band FFT — sub_low / sub / low / low_mid / mid / high_mid / high / presence / air), 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, **LIVE Splice describe-a-sound + variations via captured GraphQL endpoints (v1.17)**, drum-rack pad-by-pad construction, live dead-device detection via meter sampling, role-aware Simpler defaults, session-record arrangement-automation workaround.
 
 **Concept surface (v1.17):** `artist-vocabularies.md` and `genre-vocabularies.md` in `references/` provide structured translation from the LLM's training (producers like Villalobos, Hawtin, Basic Channel, Gas, Basinski, Hecker, Aphex, Dilla, Burial, Henke; genres like microhouse, dub_techno, ambient, idm) into LivePilot's device surface. New MCP tools `atlas_describe_chain` (free-text → chain proposal) and `atlas_techniques_for_device` (reverse-lookup: 146 technique cross-references across 58 devices).
 
@@ -12,6 +12,8 @@ Agentic production system for Ableton Live 12. 465 tools across 56 domains. Devi
 
 **Compose framework rebuild (v1.25.0):** three modes share a shared Applier substrate (bridge handshake retry + monitoring=Auto postflight + back_to_arranger). `compose_fast_apply` — quick loop in session view, curated-.adg-first hunt order, drum-role pitch repair. `compose_full_apply` — full song form (intro/verse/hook/breakdown/outro), per-section MIDI variants, native arrangement clips via `create_native_arrangement_clip`, zombie-track cleanup. `develop_apply` — extends an existing 8-bar seed, introspects tracks by name+content, pulls references from prompt. `KnowledgePack` scaffolding: `event_lexicon` (42 events), `genre_context` (15 genres), `artist_context` (~25 producers). Known gap: `atlas_candidates_per_role` is an empty stub in v1.25.0 — device lookup still falls back to `search_browser` filename matching. Resolved in v1.25 (BUG-FULL-MODE-24).
 
+**Live 12.4.2 knowledge refresh (2026-06-16):** Ableton's current stable line is Live 12.4.2 (June 11, 2026). The 12.4 baseline added Link Audio, selected-time stem separation and stem merge, updated Erosion, refined Chorus mode in Chorus-Ensemble, expanded Delay LFO modulation, Max 9.1.4, and `SimplerDevice.replace_sample` in the Live API. LivePilot exploits the native Simpler replacement path on Live 12.4+ and ships read-only `probe_link_audio()` / `probe_stem_workflow()` checks; Link Audio routing and stem write workflows remain unavailable unless a real probe proves a stable non-UI-scripted API path.
+
 ## Architecture
 
 ```
@@ -42,7 +44,7 @@ A flat tool list lets the AI press buttons. LivePilot's three layers give it con
 
 This turns "set EQ band 3 to -4 dB" into "cut 400 Hz by 4 dB, then read the spectrum to confirm the mud is actually reduced."
 
-## The 465 Tools — What Each One Does
+## The 467 Tools — What Each One Does
 
 ### Transport (12) — Playback, tempo, global state, diagnostics
 
@@ -216,7 +218,7 @@ This turns "set EQ band 3 to -4 dB" into "cut 400 Hz by 4 dB, then read the spec
 | `memory_update` | Updates name, tags, or qualities | `technique_id`, `name`, `tags`, `qualities` |
 | `memory_delete` | Removes technique (backs up first) | `technique_id` |
 
-### Analyzer (30) — Real-time DSP analysis (requires LivePilot Analyzer M4L device on master track)
+### Analyzer (38) — Real-time DSP analysis (requires LivePilot Analyzer M4L device on master track)
 
 | Tool | What it does | Key params |
 |------|-------------|------------|

package/livepilot/skills/livepilot-core/references/sound-design.md

@@ -165,6 +165,7 @@ Simple 3-band EQ for quick tonal shaping.
 - `Filter` — LP/HP on feedback path
 - `Dry/Wet` — Mix
 - `Ping Pong` — Alternates between L/R
+- **Live 12.4+ LFO** — Rate can be Hz, ms, or tempo-synced; seven LFO shapes plus Morph make Delay a stronger movement source before reaching for Echo.
 - **Common sync values**: 1/4, 1/8, 3/16 (dotted eighth), 1/4T (triplet)
 
 **Echo** (combines delay + reverb + modulation)
@@ -191,8 +192,9 @@ Simple 3-band EQ for quick tonal shaping.
 - **Use for**: Guitar-amp style warmth, bass grit
 
 **Erosion**
-- Adds digital artifacts: noise, sine wave modulation
-- `Amount`, `Frequency`, `Width`
+- Adds digital artifacts: noise/sine modulation, edge, air, bitcrush-like abrasion
+- `Amount`, `Frequency`, `Noise Blend`, `Stereo Width`
+- **Live 12.4+** — refreshed Erosion blends sine/noise continuously, scales stereo modulation precisely, and has lower algorithmic latency. Older Sets load as Erosion Legacy.
 - **Use for**: Lo-fi, bitcrushed textures, digital degradation
 
 **Redux**
@@ -206,6 +208,7 @@ Simple 3-band EQ for quick tonal shaping.
 - `Rate 1/2` — LFO speeds
 - `Amount 1/2` — Modulation depths
 - `Feedback` — Flanging intensity
+- `Time` / `Taps` — Live 12.4+ Chorus mode controls for fixed delay-line times and one- vs two-tap chorus textures
 - `Dry/Wet` — Mix
 - **Use for**: Thickening, stereo width, classic chorus
 

package/livepilot/skills/livepilot-creative-director/SKILL.md

@@ -113,6 +113,42 @@ For open-ended quality requests, treat timbre and spectral character as the main
 
 The `mix` family is dominant only when the user asks for balance, loudness, headroom, masking, stereo translation, send levels, or an explicit mix pass. Otherwise use mix analysis as safety/evidence and keep it out of the main creative slot.
 
+## Producer Decision Center
+
+Before choosing any instrument, preset, sample, or dominant move, run a
+producer decision center pass. This pass exists to prevent generic AI synth
+choices and effects-only "sound design".
+
+**Library hunt order:**
+
+1. `search_browser(path="sounds", name_filter="<role or sonic target>")`
+   for curated Ableton `.adg` chains.
+2. `atlas_search(query="<sonic description>", category="instruments")`
+   for scored character matches.
+3. If `atlas_search` returns `enriched: true`, read the surfaced fields and
+   call `atlas_device_info(device_id)` when the device is borderline or the
+   plan depends on gotchas, self-contained status, or signature techniques.
+4. `search_browser(path="instruments", name_filter="<specific candidate>")`
+   only after the curated/preset search has been exhausted.
+
+**Generic-default guardrail:** do not reach for Analog/Poli/Drift as a
+default bass, pad, or lead unless the user explicitly asked for analog
+subtractive synthesis or that exact instrument. Those defaults read as a
+generic AI synth in this project. If one of them is still the right choice,
+state the reason and program the source immediately.
+
+**Instrument/source-level first:** real sound design changes what the sound
+is before effects-only polish. For every melodic, harmonic, bass, drum, or
+texture layer, plan at least one instrument/source-level move before adding
+effects: envelopes, LFO routing, filter envelope, oscillator/wavetable/FM
+position, pitch modulation, sample start, slice selection, velocity mapping,
+spread, detune, or sampler playback mode.
+
+**Layer precision gate:** before declaring a plan or execution complete,
+each active layer needs a role and an evidence path: timbre/spectrum,
+sequence feel, stereo placement, movement/automation, and parameter
+programming. Low-volume buried layers do not count as solved layers.
+
 ### Phase 1 — Ground
 
 Read in parallel (all are fast). All of these are REQUIRED, not

package/livepilot/skills/livepilot-creative-director/references/move-family-diversity-rule.md

@@ -44,7 +44,7 @@ Never invent an eighth family at the director level.
 
 **Discovery:** always call `list_semantic_moves(domain=<family>)` at
 runtime to enumerate — do not hardcode move IDs. Families are stable;
-the move catalog grows. As of v1.26.2 the runtime returns 44 moves
+the move catalog grows. As of v1.26.3 the runtime returns 44 moves
 across all 7 domains.
 
 **Why the director never invents an eighth `rhythmic` family:** the

package/livepilot/skills/livepilot-evaluation/references/capability-modes.md

@@ -111,7 +111,9 @@ Call `get_capability_state` at the start of any evaluation session. The response
       "memory":         {"name": "memory",         "available": true,  "confidence": 1.0, "mode": "available",   "reasons": []},
       "web":            {"name": "web",            "available": true,  "confidence": 0.7, "mode": "available",   "reasons": []},
       "research":       {"name": "research",       "available": true,  "confidence": 0.9, "mode": "available",   "reasons": []},
-      "flucoma":        {"name": "flucoma",        "available": false, "confidence": 0.0, "mode": "unavailable", "reasons": ["flucoma_not_installed"]}
+      "flucoma":        {"name": "flucoma",        "available": false, "confidence": 0.2, "mode": "unavailable", "reasons": ["flucoma_bridge_unavailable"], "device_loaded": true},
+      "link_audio":     {"name": "link_audio",     "available": false, "confidence": 0.2, "mode": "manual_only", "reasons": ["link_audio_unprobed"]},
+      "stem_workflow":  {"name": "stem_workflow",  "available": false, "confidence": 0.2, "mode": "manual_only", "reasons": ["stem_workflow_unprobed"]}
     }
   }
 }
@@ -127,11 +129,11 @@ Call `get_capability_state` at the start of any evaluation session. The response
 
 Every entry in `domains` has the same shape:
 
-- `name`: the domain key (`"session_access"`, `"analyzer"`, `"memory"`, `"web"`, `"research"`, `"flucoma"`).
+- `name`: the domain key (`"session_access"`, `"analyzer"`, `"memory"`, `"web"`, `"research"`, `"flucoma"`, `"link_audio"`, `"stem_workflow"`).
 - `available`: boolean — is this capability ready to use right now?
 - `confidence`: 0.0–1.0 — how much to trust the `available` flag (e.g. stale analyzer data lowers confidence).
 - `mode`: short human label specific to the domain (`"healthy"`, `"available"`, `"measured"`, `"stale"`, `"targeted_only"`, `"full"`, `"unavailable"`).
-- `reasons`: list of short machine-readable tokens explaining why the domain is in its current state (`"analyzer_offline"`, `"web_unavailable"`, `"flucoma_not_installed"`, …). Empty when healthy.
+- `reasons`: list of short machine-readable tokens explaining why the domain is in its current state (`"analyzer_offline"`, `"web_unavailable"`, `"flucoma_bridge_unavailable"`, `"flucoma_no_streams"`, `"flucoma_not_installed"`, …). Empty when healthy.
 - `freshness_ms`: optional — milliseconds since the domain last received fresh data (currently only the analyzer domain populates this).
 
 ### Domain definitions
@@ -141,7 +143,9 @@ Every entry in `domains` has the same shape:
 - **memory** — the local technique-store / taste memory. `available=true` means the persistent stores can be read and written.
 - **web** — server-side outbound HTTP capability. True when the MCP host can reach an arbitrary public URL (probed by a 500 ms HEAD request to `https://api.github.com`). Does NOT imply curated research corpora are installed — see the `research` domain for that.
 - **research** — composite over `session_access`, `memory`, and `web`. `mode="full"` when all three are available; `"targeted_only"` when at least one source is up; `"unavailable"` when nothing is reachable.
-- **flucoma** — whether the optional `flucoma` Python package is importable (probed via `importlib.util.find_spec`). FluCoMa-backed tools (`check_flucoma`, `extract_timbre_fingerprint`, etc.) degrade gracefully when this domain is unavailable.
+- **flucoma** — Max/FluCoMa real-time stream readiness. `device_loaded=true` means the FluidCorpusManipulation Max package is installed, or active streams prove a frozen analyzer is working. `available=true` requires at least one FluCoMa stream (`spectral_shape`, `mel_bands`, `chroma`, `onset`, `novelty`, or `loudness`) to have reached the M4L spectral cache. FluCoMa-backed tools (`check_flucoma`, `extract_timbre_fingerprint`, etc.) degrade gracefully when this domain is unavailable.
+- **link_audio** — Live 12.4 Link Audio capability. `probe_link_audio` is read-only and reports `mode="manual_only"` until peer/input/routing evidence proves the surface is readable or routable. Version number alone never makes this domain available.
+- **stem_workflow** — Live 12.4 selected-time stem separation / merge capability. `probe_stem_workflow` is read-only and reports `mode="manual_only"` until a stable callable path is observed. Stem tools must not run on full tracks/clips by default.
 
 ## Collaborative Mode (Live 12.4+)
 
@@ -169,8 +173,10 @@ Live 12.4 introduces a new capability tier that unlocks native LOM access for sa
 **Tool signatures:** unchanged. Callers do not need to detect the tier —
 routing is transparent.
 
-**Follow-up plans (not yet shipped):**
-- Link Audio (tempo-sync sharing between Live sets) — tracked as a
-  future Collaborative-tier feature.
-- Stem Separation v2 — tracked as a future Collaborative-tier feature.
-Neither is available in the 1.26.2 release — still pending.
+**Probe-first 12.4 surfaces in v1.27.1:**
+- `probe_link_audio()` reports observed peer/input/routing visibility and
+  returns `manual_only`, `readable`, `routable`, or `unavailable`.
+- `probe_stem_workflow()` reports observed callable paths and returns
+  `manual_only`, `callable`, or `unavailable`.
+- Write workflows are intentionally absent unless a real Live probe proves
+  a stable non-UI-scripted route.