livepilot 1.15.0-beta → 1.16.1

package/CHANGELOG.md

@@ -1,5 +1,208 @@
 # Changelog
 
+## 1.16.1 — Post-publish live-verification bug sweep (April 22 2026)
+
+Three rounds of live verification after 1.16.0 shipped caught five
+runtime bugs that unit tests missed. All unit-test-clean paths that
+failed on first live invocation against a running Splice desktop +
+Ableton 12.4 are now both fixed and guarded by source-grep regression
+tests. Plus one new tool and two observations addressed.
+
+**Tool count**: 421 → 422 (+1: `verify_all_devices_health` —
+session-wide silent-track detector).
+**Domain count**: unchanged at 52.
+**Tests**: 2627 → 2644 (+17 new regression guards). No regressions.
+
+### Live-verified bugs fixed
+
+- `add_drum_rack_pad` crashed with `ImportError` on first invocation
+  — inline `from .._analyzer_engine.sample import ...` resolved to
+  `mcp_server._analyzer_engine` (nonexistent; the real package is
+  `mcp_server.tools._analyzer_engine`). The helper is already imported
+  at module scope on line 29; inline form removed.
+- `splice_preview_sample` returned "No preview URL available" for
+  un-downloaded catalog samples. `SampleInfo` RPC only carries
+  `PreviewURL` for downloaded/purchased items. Now falls back to
+  `SearchSamples(FileHash=...)` which always has catalog metadata.
+- `splice_pack_info` crashed with
+  `AttributeError: 'AppStub' object has no attribute 'SamplePackInfo'`.
+  The `SamplePackInfoRequest/Response` messages exist in the proto
+  descriptor but no RPC on the `App` service binds them. Rewrote to
+  paginate `ListSamplePacks` + client-side UUID match. Limitation
+  documented: only finds packs the user has engaged with.
+- `splice_pack_info` on an OWNED pack with an extended-format UUID
+  (43 chars, e.g. `...887a0dd7f26bf5a3951`) failed because the first
+  fix aggressively truncated to `[:36]`, discarding legitimate bytes.
+  Correct behavior: Splice uses both UUID formats; build a `targets`
+  set of the submitted form AND its canonical truncation, match each
+  server-returned UUID in both forms.
+- Startup warning `STARTUP SELF-TEST WARNING — returned 385 tools,
+  expects 422`. `_get_all_tools()` took the first non-empty probe,
+  which could be a stale `_tool_manager._tools` view lagging behind
+  the authoritative `_local_provider._components`. Now takes the
+  largest view across all probes.
+- Startup `RuntimeWarning: coroutine 'FastMCP.list_tools' was never
+  awaited` on every server import. The `list_tools` probe wrapped an
+  async coroutine in `list()` without awaiting. Removed with an
+  explanatory comment.
+
+### Added
+
+- `verify_all_devices_health(test_midi_note=60, skip_audio_tracks=True,
+  skip_empty_tracks=True, threshold=0.005)` — session-wide silent-
+  track detector. Fires a test note on every eligible track and reports
+  alive / dead / skipped with per-track peak-level evidence.
+- `~/.livepilot/splice.json` config key `plan_kind_override` — pin
+  the Splice plan_kind when the gRPC classifier lands on a safe
+  default (e.g. `sounds_plan_id=6` with empty `features` map is
+  classified as SOUNDS_PLUS but may actually be any of several tiers).
+  Values: `ableton_live`, `sounds_plus`, `creator`, `creator_plus`,
+  `free`. `get_splice_credits` response now includes
+  `plan_kind_override: <value|null>`.
+
+### Internal
+
+- M4L bridge source (`livepilot_bridge.js`) ping version drift
+  `1.14.1 → 1.16.1` (source had been stale; binary had already been
+  patched in a prior release).
+- `SpliceGRPCClient.get_pack_info` return signature changed from
+  `Optional[SplicePack]` to `tuple[Optional[SplicePack], Optional[str]]`.
+  Callers now receive a structured error message when the lookup
+  fails, instead of `None` swallowing the cause.
+
+## 1.16.0 — Minimal-techno session bug batch + Splice plan model (April 22 2026)
+
+Hardens the 1.15.0 beta into a full release. Resolves 18 of the 19 bugs
+catalogued in `docs/2026-04-22-bugs-discovered.md` during an end-to-end
+minimal-techno production session, ships a plan-aware Splice download
+model, adds drum-rack pad-by-pad construction, and lands clip-length +
+note-range invariants so programmatic workflows stop corrupting
+arrangement timing.
+
+**Tool count**: 403 → 421 (+18).
+**Domain count**: unchanged at 52.
+**Tests**: 49 new contract tests across five helper modules. No regressions.
+
+### Added
+
+**Drum Rack pad-by-pad construction (BUG #1)**
+- `add_drum_rack_pad(track_index, pad_note, file_path)` — atomic tool
+  that does the full drum-rack build per pad: insert_rack_chain →
+  set_drum_chain_note → insert empty Simpler → load sample via native
+  Live 12.4 replace_sample with nested addressing. Returns
+  `{ok, chain_index, pad_note, nested_device_index}`. Requires Live 12.4+.
+- `replace_simpler_sample` and `load_sample_to_simpler` now accept
+  `chain_index` + `nested_device_index` for deep addressing inside
+  drum-rack chains.
+- Auto-increment of `in_note` on `insert_rack_chain` for drum racks
+  (BUG #13) — no more "all new chains pile up on note 36 (Multi)".
+
+**Live-session device-alive verification (BUG #19)**
+- `verify_device_alive(track_index, device_index)` — static check
+  returning `{alive, reason, recommendation}` based on parameter_count
+  and health_flags.
+- Optional `fire_test_note=True` path for definitive answer: captures
+  pre-hit RMS, fires a scratch MIDI clip, samples the meter over the
+  duration, captures post-hit RMS. Scratch clip auto-cleaned.
+- Remote Script handlers: `fire_test_note`, `cleanup_test_note`.
+
+**Splice plan-aware download gating (2026-04-14 carry-over)**
+- `SpliceGRPCClient.decide_download` with three branches: free samples
+  bypass, Ableton Live plan uses daily quota, credit-metered plans use
+  credit floor. Fixes the bug where the Ableton Live plan (100/day
+  unmetered) was blocked by the credit-floor check.
+- `DailyQuotaTracker` persisting `~/.livepilot/splice_quota.json` keyed
+  by UTC date. 100/day default, 90 warn threshold.
+- `classify_plan` reads feature flags (ableton_unmetered,
+  ableton_live_plan, unmetered_downloads, creator_plus) with precedence
+  locked down by regression-trap tests.
+
+**Splice HTTPS bridge scaffolding**
+- `mcp_server/splice_client/http_bridge.py` — auth + endpoint +
+  retry/timeout plumbing for the plugin-exclusive Describe-a-Sound and
+  Variations features. Tools return a clear "bridge not yet wired"
+  error until the real endpoint shapes are captured via mitmproxy.
+
+**Extended analyzer perception**
+- `analyze_loudness_live` (BUG #8) — LUFS + true-peak on the live
+  master without requiring a file render.
+- `get_master_spectrum` now accepts `window_ms` (BUG #6) — stable
+  averaged reads vs the previous single-sample jitter.
+
+**Clip length + note-range invariants (BUG #1c)**
+- `create_clip(length=N)` now forces `loop_end = N` and `end_marker = N`
+  after creation. Response exposes both fields.
+- `add_notes` auto-extends `loop_end` if any incoming note's
+  `start_time + duration` exceeds it. Response reports
+  `loop_end_extended_to` when extension fired.
+
+**Smart Simpler defaults (BUG #17 + #18)**
+- `load_browser_item(role=...)` applies post-load Simpler defaults:
+  - `drum`:    Snap=0, Vol=0dB, Trigger Mode=0 (Trigger), root=C1 (36)
+  - `melodic`: Snap=1, Vol=0dB, Trigger Mode=1 (Gate), root=C3 (60)
+  - `texture`: Snap=0, Vol=-6dB, Trigger Mode=1 (Gate), root=C3 (60)
+
+**Miscellaneous**
+- `get_track_info(-1000)` returns master track info (BUG #11).
+- `scan_full_library(max_per_category=5000)` — removed the hardcoded
+  1000 cap that silently truncated large categories (BUG #12).
+- `batch_set_parameters` accepts `{index: N, value}` and `{name: "X", value}`
+  shapes — the keys `get_device_parameters` actually returns (BUG #3).
+- `search_browser` / `search_samples` accept intuitive parameter aliases
+  (BUG #4).
+- `get_browser_items` paginates when output would exceed the token cap
+  (BUG #5).
+- `get_track_meters` returns consistent peak/L/R triple on a single time
+  window (BUG #7).
+- `set_song_scale` accepts string root notes ("C", "F#", "Bb") and
+  handles Live 12.4.0's moved `scale_names` attribute via a tolerant
+  resolver with a built-in fallback scale list (BUG #2).
+
+### Documentation
+
+- `docs/load_browser_item-uri-grammar.md` (BUG #14) — the three URI
+  forms, failure modes, discovery recipe, top-level folder map. Moved
+  under `livepilot/skills/livepilot-devices/references/`.
+- `livepilot-devices` SKILL — new "Custom Drum Rack Construction" and
+  "Parameter Name Quirks" sections (BUG #10, #16).
+- `livepilot-arrangement` SKILL — documents the Live LOM limitation
+  behind BUG #1b (programmatic arrangement automation) with two
+  workaround patterns (session-clip + record, or stepped section
+  clips).
+- `docs/M4L_BRIDGE.md` — drift fixes: bridge command count 28 → 30,
+  analyzer MCP tool count 20 → 33, Max 8 → Max 9 reference, new
+  Phase 3 section documenting 8 previously undocumented bridge
+  commands.
+
+### Fixed
+
+- `_live_caps` no longer caches the 12.0.0 fallback when
+  `get_session_info` returns no live_version — previously pinned the
+  entire session to the oldest capability tier.
+
+### Changed
+
+- `insert_rack_chain` on drum racks now auto-increments `in_note`
+  (BUG #13). Pass `auto_pad_note=false` to keep Live's default
+  collide-on-36 behavior.
+
+### Deferred
+
+- **BUG #15** — adding a sub_low (30-60 Hz) spectrum band requires a
+  Max 9 re-freeze of `LivePilot_Analyzer.amxd`. Deferred to the next
+  .amxd rebuild cycle. `get_mel_spectrum` provides finer-grained
+  perceptual bands as a workaround.
+- **BUG #1b** — programmatic creation of arrangement automation
+  breakpoints. Live LOM limitation (per Ableton docs,
+  `Clip.automation_envelope` returns None for arrangement clips);
+  documented workaround patterns instead of a synthetic fix.
+
+### Platform
+
+- LivePilot_Analyzer.amxd ping version bytes patched 1.15.0 → 1.16.0
+  (in-place binary patch — source bumps don't auto-refresh the frozen
+  JS, lesson from two prior releases).
+
 ## 1.15.0-beta — Live 12.4 replace_sample native (April 21 2026)
 
 First Live 12.4 beta support release. Adds a native fast path for
@@ -392,7 +595,7 @@ every bug now has a named regression guard in the test suite.
 ## 1.12.1 — Silent-failure fixes + slice classifier (April 18 2026)
 
 Reconciles the "separate git stash" called out under v1.12.0's Known
-limitations — the 2026-04-18 Villalobos-groove session surfaced four
+limitations — the 2026-04-18 minimal-groove session surfaced four
 silent-failure bugs and the need for a drum-slice spectral classifier.
 
 **+1 tool (397 → 398): `classify_simpler_slices`.** +43 regression
@@ -428,7 +631,7 @@ guards (pure-Python, run without a live Ableton).
   FFT-based spectral analysis on a Simpler's slice boundaries, returns
   each slice labeled as KICK / SNARE / HAT / ghost plus feature
   breakdown (peak, rms, band %). Validated thresholds from the
-  2026-04-18 Villalobos-groove session on "Break Ghosts 90 bpm":
+  2026-04-18 minimal-groove session on "Break Ghosts 90 bpm":
     - KICK: sub+low ≥ 45%, high < 40%
     - HAT: high ≥ 70% AND mid < 25%
     - SNARE: mid ≥ 25% AND high ≥ 40% AND peak ≥ 0.6
@@ -445,7 +648,7 @@ guards (pure-Python, run without a live Ableton).
 
 ### Documented bug entries
 
-- `BUGS.md` gains a new **"F. 2026-04-18 Villalobos-groove creative
+- `BUGS.md` gains a new **"F. 2026-04-18 minimal-groove creative
   session"** section: F1-F4 fixed here, F5-F7 scoped to v1.13+, F8
   wontfix (workaround documented).
 

package/README.md

@@ -17,7 +17,7 @@
 
 <p align="center">
   An agentic production system for Ableton Live 12.<br>
-  403 tools. 52 domains. Device atlas. Splice integration. Auto-composition. Spectral perception. Technique memory.
+  422 tools. 52 domains. Device atlas. Plan-aware Splice integration. Auto-composition. Spectral perception. Technique memory. Drum-rack pad builder. Live dead-device detection.
 </p>
 
 <br>
@@ -38,8 +38,8 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 | Layer | What it provides |
 |-------|-----------------|
 | **Deterministic Tools** | Direct control: transport, tracks, clips, notes, devices, scenes, mixing, arrangement, browser, automation |
-| **Device Atlas** | Knowledge of every device in Ableton's library — 1305 devices indexed by name, URI, category, tag, and genre. 71 enriched with sonic intelligence. 683 drum kits mapped |
-| **Sample Engine** | Three-source sample intelligence — searches Ableton's browser, your filesystem, and Splice's catalog simultaneously. 6 fitness critics score every result. 29 processing techniques |
+| **Device Atlas** | Knowledge of every device in Ableton's library — 1305 devices indexed by name, URI, category, tag, and genre. 107 enriched with sonic intelligence. 683 drum kits mapped |
+| **Sample Engine** | Three-source sample intelligence — Ableton's browser, your filesystem, and Splice's catalog (plan-aware: Ableton Live plan uses daily quota, Sounds+/Creator uses credits, free samples bypass both). 6 fitness critics. 29 processing techniques. Collections, presets, preview-URL audition, HTTPS bridge scaffolding for Describe-a-Sound + Variations |
 | **Spectral Perception** | Real-time ears via M4L — 8-band FFT, RMS/peak metering, Krumhansl-Schmuckler key detection, pitch tracking. Closes the feedback loop so the AI hears its own changes |
 | **Technique Memory** | Persistent library of production decisions. Save a beat pattern, device chain, or mix template. Recall by mood, genre, or texture across sessions |
 | **Creative Intelligence** | 12 engines that understand song identity, learn your taste, diagnose stuck sessions, generate creative options, and evaluate results before claiming success |
@@ -58,7 +58,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 │                                                                      │
 │  Device Atlas            8-band FFT              recall by mood,     │
 │  1305 devices            RMS / peak              genre, texture      │
-│  71 enriched             pitch tracking          29 techniques       │
+│  107 enriched             pitch tracking          29 techniques       │
 │  683 drum kits           key detection           replay into session │
 │                                                                      │
 │  Sample Engine           Corpus Intelligence     Taste Graph          │
@@ -79,7 +79,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 │         └─────────────────┼──────────────────┘                       │
 │                           ▼                                          │
 │                  ┌─────────────────┐                                  │
-│                  │   403 MCP Tools  │                                  │
+│                  │   422 MCP Tools  │                                  │
 │                  │   52 domains     │                                  │
 │                  └────────┬────────┘                                  │
 │                           │                                          │
@@ -102,7 +102,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 
 **M4L Bridge** (`m4l_device/`) — Optional Max for Live Audio Effect on the master track. Provides deep LOM access through Max's LiveAPI that the ControlSurface API can't reach. UDP 9880 (M4L to server) carries spectral data and LiveAPI responses. OSC 9881 (server to M4L) sends commands. The 32 spectral/analyzer tools strictly require the bridge; device and sample tools that call the bridge also have graceful fallbacks, so core functionality works without it. Backed by 30 bridge commands for hidden parameters, Simpler internals, warp markers, display values, and Simpler warp / Compressor sidechain writes that live on child objects Python can't reach.
 
-**Device Atlas** (`mcp_server/atlas/`) — In-memory indexed JSON database. 1305 devices with browser URIs, 71 enriched with YAML sonic intelligence profiles (mood, genre, texture, recommended chains). 6 indexes: by_id, by_name, by_uri, by_category, by_tag, by_genre. The AI never hallucinates a device name or preset — it always resolves against the atlas first.
+**Device Atlas** (`mcp_server/atlas/`) — In-memory indexed JSON database. 1305 devices with browser URIs, 107 enriched with YAML sonic intelligence profiles (mood, genre, texture, recommended chains). 6 indexes: by_id, by_name, by_uri, by_category, by_tag, by_genre. The AI never hallucinates a device name or preset — it always resolves against the atlas first.
 
 **Sample Engine** (`mcp_server/sample_engine/`) — Searches three sources simultaneously: BrowserSource (Ableton's library), SpliceSource (local Splice catalog via SQLite), FilesystemSource (user directories). Every result passes through a 6-critic fitness battery (key, tempo, spectral, genre, mood, technical). 29 processing techniques (Surgeon precision vs. Alchemist experimentation). Builds complete sample processing plans with warp, slice, and effect recommendations.
 
@@ -120,7 +120,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 
 ## The Intelligence Layer
 
-12 engines sit on top of the 403 tools. They give the AI musical judgment, not just musical execution.
+12 engines sit on top of the 422 tools. They give the AI musical judgment, not just musical execution.
 
 ### SongBrain — What the Song Is
 
@@ -172,7 +172,7 @@ Every engine follows: **measure before → act → measure after → compare**.
 
 ## Tools
 
-403 tools across 52 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
+422 tools across 52 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
 
 <br>
 
@@ -232,7 +232,7 @@ The atlas is an in-memory indexed database of Ableton's entire device library.
 
 ```
 1305 devices total
-  71 enriched with sonic intelligence (mood, genre, texture, chains)
+  107 enriched with sonic intelligence (mood, genre, texture, chains)
  683 drum kits mapped with note assignments
    6 indexes: by_id, by_name, by_uri, by_category, by_tag, by_genre
 ```
@@ -360,7 +360,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 403 tools →](docs/manual/tool-catalog.md)**
+> **[View all 422 tools →](docs/manual/tool-catalog.md)**
 
 <br>
 
@@ -587,7 +587,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details, code guidelines
 
 | Document | What's inside |
 |----------|---------------|
-| [Manual](docs/manual/index.md) | Complete reference: architecture, all 403 tools, workflows |
+| [Manual](docs/manual/index.md) | Complete reference: architecture, all 422 tools, workflows |
 | [Intelligence Layer](docs/manual/intelligence.md) | How the 12 engines connect — conductor, moves, preview, evaluation |
 | [Device Atlas](docs/manual/device-atlas.md) | 1305 devices indexed — search, suggest, chain building |
 | [Samples & Slicing](docs/manual/samples.md) | 3-source search, fitness critics, slice workflows |

package/m4l_device/livepilot_bridge.js

@@ -95,7 +95,7 @@ function anything() {
 function dispatch(cmd, args) {
     switch(cmd) {
         case "ping":
-            send_response({"ok": true, "version": "1.14.1"});
+            send_response({"ok": true, "version": "1.16.1"});
             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.15.0-beta"
+__version__ = "1.16.1"