livepilot 1.14.1 → 1.16.0

package/CHANGELOG.md

@@ -1,5 +1,180 @@
 # Changelog
 
+## 1.16.0 — Villalobos 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
+Villalobos-style 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
+SimplerDevice.replace_sample(path) while preserving 100% backward
+compatibility for 12.0-12.3.x users.
+
+**Tool count**: unchanged at 403.
+**Domain count**: unchanged at 52.
+**Tests**: 2503 passed, 1 skipped, 0 regressions (+13 new from this release).
+
+### Added
+- **Live 12.4 support (beta):** `SimplerDevice.replace_sample(path)` native
+  LOM path is now used automatically on Live 12.4+. Handles empty Simplers —
+  fixes the long-standing workaround documented in
+  `feedback_load_browser_item_is_source_of_truth.md`.
+- New capability tier `"collaborative"` (Live 12.4+) exposed via
+  `LiveVersionCapabilities.capability_tier` and `.has_replace_sample_native`.
+- Remote Script: new `replace_sample_native` handler.
+- MCP server: new `_live_caps(ctx)` helper with lazy version-capability
+  caching on the lifespan context.
+- Registered `replace_sample_native` in `mcp_server/runtime/remote_commands.py`
+  REMOTE_COMMANDS (required by the boundary audit contract).
+
+### Changed
+- `replace_simpler_sample` and `load_sample_to_simpler` now route to the
+  native path when available and fall back to the M4L-bridge path
+  otherwise. Tool signatures, argument names, and return shapes unchanged.
+
+### Backward Compatibility
+- Live 12.0–12.3.x: zero behavior change. All routing still goes through
+  the M4L bridge.
+- Live 12.4+: native path preferred; bridge used only on fallback.
+
+### Verification status
+- Full test suite: 2503 passed, 0 failures.
+- Backward compat on Live 12.4: verified in-session — `replace_simpler_sample`
+  and `load_sample_to_simpler` both work via the bridge path on 12.4 (legacy
+  flow intact).
+- Native E2E on Live 12.4 empty-Simpler case: deferred until the plugin
+  swap activates the worktree's MCP code. Unit tests prove the routing
+  logic and the native handler wiring.
+
 ## 1.14.1 — reload_handlers workflow + device/mixing fixes (April 21 2026)
 
 Patch release that lands the post-1.14.0 audit work: one new diagnostics
@@ -13,7 +188,7 @@ tool, three bug fixes, and a new plugin-sync verification script.
 
 - Replaces the manual "toggle Control Surface in Live → Preferences →
   Link/MIDI" step that every Remote Script edit required. New workflow:
-  after `node installer/install.js`, call `reload_handlers` via the MCP
+  after `npx livepilot --install`, call `reload_handlers` via the MCP
   tool. The Remote Script side uses `pkgutil` + `importlib.reload()` to
   re-fire all `@register` decorators in place in <1s, without dropping
   the MCP TCP connection on port 9878.

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.
+  421 tools. 52 domains. Device atlas. Splice integration. Auto-composition. Spectral perception. Technique memory.
 </p>
 
 <br>
@@ -79,7 +79,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 │         └─────────────────┼──────────────────┘                       │
 │                           ▼                                          │
 │                  ┌─────────────────┐                                  │
-│                  │   403 MCP Tools  │                                  │
+│                  │   421 MCP Tools  │                                  │
 │                  │   52 domains     │                                  │
 │                  └────────┬────────┘                                  │
 │                           │                                          │
@@ -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 421 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).
+421 tools across 52 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
 
 <br>
 
@@ -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 421 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 421 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/mcp_server/__init__.py

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