livepilot 1.8.3 → 1.9.0

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
   "name": "dreamrec-LivePilot",
-  "description": "Agentic MCP production system for Ableton Live 12 — 168 tools, 17 domains",
+  "description": "Agentic MCP production system for Ableton Live 12 — 178 tools, 17 domains",
   "owner": {
     "name": "dreamrec",
     "email": "dreamrec@users.noreply.github.com"
@@ -9,8 +9,8 @@
   "plugins": [
     {
       "name": "livepilot",
-      "description": "Agentic production system for Ableton Live 12 — 168 tools, 17 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
-      "version": "1.8.1",
+      "description": "Agentic production system for Ableton Live 12 — 178 tools, 17 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+      "version": "1.9.0",
       "author": {
         "name": "Pilot Studio"
       },

package/AGENTS.md

@@ -0,0 +1,46 @@
+# LivePilot v1.9.0 — Ableton Live 12
+
+## Project
+- **Repo:** This directory (LivePilot)
+- **Type:** Agentic MCP production system for Ableton Live 12
+- **Three layers:** Device Atlas (knowledge) + M4L Analyzer (perception) + Technique Memory (learning)
+- **Sister projects:** TDPilot (TouchDesigner), ComfyPilot (ComfyUI)
+- **Design spec:** `docs/specs/2026-03-17-livepilot-design.md`
+
+## Architecture
+- **Remote Script** (`remote_script/LivePilot/`): Runs inside Ableton's Python, ControlSurface base class, TCP socket on port 9878
+- **MCP Server** (`mcp_server/`): Python FastMCP server, validates inputs, sends commands to Remote Script
+- **M4L Bridge** (`m4l_device/`): Max for Live Audio Effect on master track, UDP/OSC bridge for deep LOM access
+  - UDP 9880: M4L -> Server (spectral data, responses)
+  - OSC 9881: Server -> M4L (commands)
+  - `livepilot_bridge.js`: 22 bridge commands for LiveAPI access
+  - `SpectralCache`: thread-safe, time-expiring data cache (5s max age)
+  - Bridge is optional — all core tools work without it
+- **Plugin** (`livepilot/`): Codex plugin (marketplace-compatible: `.Codex-plugin/plugin.json`)
+- **Installer** (`installer/`): Auto-detects Ableton path, copies Remote Script
+
+## Key Rules
+- ALL Live Object Model (LOM) calls must execute on Ableton's main thread via schedule_message queue
+- Live 12 minimum — use modern note API (add_new_notes, get_notes_extended, apply_note_modifications)
+- 178 tools across 17 domains: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception
+- JSON over TCP, newline-delimited, port 9878
+- Structured errors with codes: INDEX_ERROR, NOT_FOUND, INVALID_PARAM, STATE_ERROR, TIMEOUT, INTERNAL
+
+## M4L Bridge Notes
+- OSC addresses must be sent WITHOUT leading `/` — Max `udpreceive` passes `/` as part of messagename
+- `str_for_value` requires `call()` not `get()` (it's a function)
+- `get()` in Max JS LiveAPI always returns arrays
+- `warp_markers` is a dict property returning JSON string — use `JSON.parse()`
+- `SimplerDevice.slices` lives on the `sample` child, not the device
+- `replace_sample` only works on Simplers with existing samples
+- Max freezes JS from search path cache, not source directory — copy to `~/Documents/Max 8/`
+
+## Binary Patching Workflow (.amxd)
+When modifying .amxd attributes that Max editor won't persist (e.g., `openinpresentation`):
+1. Find the byte sequence in the .amxd binary
+2. Replace with same-byte-count alternative (file size must not change)
+3. Test by loading in Ableton
+4. Structure: 24-byte `ampf` header + `ptch` chunk + `mx@c` header + JSON patcher + frozen deps
+
+## Tool Count
+Currently 178 tools. If adding/removing tools, update: README.md, package.json description, livepilot/.Codex-plugin/plugin.json, server.json, livepilot/skills/livepilot-core/SKILL.md, livepilot/skills/livepilot-core/references/overview.md, AGENTS.md, CHANGELOG.md, tests/test_tools_contract.py, docs/manual/index.md, docs/manual/tool-reference.md

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 1.9.0 — Scene Matrix, Freeze/Flatten, Plugin Deep Control (March 2026)
+
+**10 new tools (168 → 178), 3 features shipped.**
+
+### Scene Matrix Operations (+4 tools)
+- `get_scene_matrix` — full N×M clip grid with states (empty/stopped/playing/triggered/recording)
+- `fire_scene_clips` — fire a scene with optional track filter for selective launching
+- `stop_all_clips` — stop all playing clips in the session (panic button)
+- `get_playing_clips` — return all currently playing or triggered clips
+
+### Track Freeze/Flatten (+3 tools)
+- `freeze_track` — freeze a track (render devices to audio for CPU savings)
+- `flatten_track` — flatten a frozen track (commit rendered audio permanently)
+- `get_freeze_status` — check if a track is frozen
+
+### Plugin Parameter Mapping (+3 tools, M4L)
+- `get_plugin_parameters` — get ALL VST/AU plugin parameters including unconfigured ones
+- `map_plugin_parameter` — add a plugin parameter to Ableton's Configure list for automation
+- `get_plugin_presets` — list a plugin's internal presets and banks
+
+### Infrastructure
+- `SLOW_WRITE_COMMANDS` set for freeze_track (35s timeout vs 15s for normal writes)
+- Removed "Coming" section from README — all roadmap features shipped or dropped
+
+## 1.8.4 — Bug Fix Audit (March 2026)
+
+**5 bugs fixed (2 P1, 3 P2), verified live in Ableton.**
+
+### P1 — Safety-Critical
+- Fix: `create_arrangement_clip` no longer hangs Ableton when `loop_length` is zero or negative — validation at MCP + Remote Script layers
+- Fix: `import_midi_to_clip` now preserves the MIDI file's beat grid instead of scaling by session tempo — a 60 BPM MIDI imported at 120 BPM no longer doubles note positions
+
+### P2 — Correctness
+- Fix: `create_arrangement_clip` now sets `loop_end` on duplicated clips when `loop_length < source_length`, with documented LOM limitation for arrangement clip resizing
+- Fix: `--status` / `--doctor` CLI commands no longer report success for error responses — only resolves true on valid pong
+- Fix: `import_midi_to_clip` with `create_clip=True` now checks for existing clips before creating — clears notes if occupied, creates if empty
+
+### Tests
+- 2 new tests for MIDI tempo independence (`test_midi_io.py::TestImportTempoIndependence`)
+- 255 total tests passing
+
 ## 1.8.3 — FluCoMa Wiring + Analyzer Fix (March 2026)
 
 - Fix: wire 6 FluCoMa DSP objects into LivePilot_Analyzer.maxpat (spectral shape, mel bands, chroma, loudness, onset, novelty)

package/README.md

@@ -9,10 +9,9 @@
 
 An agentic production system for Ableton Live 12.
 
-168 tools. Device atlas. Spectral perception. Technique memory.
+178 tools. Device atlas. Spectral perception. Technique memory.
 Neo-Riemannian harmony. Euclidean rhythm. Species counterpoint.
 
-It doesn't assist — it produces.
 
 <br>
 
@@ -38,7 +37,7 @@ It doesn't assist — it produces.
 │         └───────────────────┼───────────────────┘           │
 │                             ▼                               │
 │                    ┌─────────────────┐                      │
-│                    │   168 MCP Tools  │                      │
+│                    │   178 MCP Tools  │                      │
 │                    │   17 domains     │                      │
 │                    └────────┬────────┘                      │
 │                             │                               │
@@ -60,7 +59,7 @@ via a Max for Live device.
 The memory gives it history — a searchable library of production decisions
 that persists across sessions.
 
-All three feed into 168 deterministic tools that execute on Ableton's main thread
+All three feed into 178 deterministic tools that execute on Ableton's main thread
 through the official Live Object Model API. Everything is reversible with undo.
 
 <br>
@@ -96,7 +95,7 @@ Every tool maps directly to an LOM call — no abstraction, no guessing.
 The M4L Analyzer sits on the master track. UDP 9880 carries spectral data
 from Max to the server. OSC 9881 sends commands back.
 
-All 135 core tools work without it — the analyzer adds 20 more
+All 139 core tools work without it — the analyzer adds 29 more
 and closes the feedback loop.
 
 <br>
@@ -477,7 +476,7 @@ Check memory before creative decisions. Verify every mutation.
 
 ## Full Tool List
 
-168 tools across 17 domains.
+178 tools across 17 domains.
 
 <br>
 
@@ -673,7 +672,7 @@ Check memory before creative decisions. Verify every mutation.
 
 <br>
 
-### Analyzer (20) `[M4L]`
+### Analyzer (29) `[M4L]`
 
 | Tool | Description |
 |------|-------------|
@@ -697,6 +696,26 @@ Check memory before creative decisions. Verify every mutation.
 | `remove_warp_marker` | Remove warp marker |
 | `scrub_clip` | Preview at beat position |
 | `stop_scrub` | Stop preview |
+| `get_spectral_shape` | 7 spectral descriptors via FluCoMa |
+| `get_mel_spectrum` | 40-band mel spectrum |
+| `get_chroma` | 12 pitch class energies |
+| `get_onsets` | Real-time onset detection |
+| `get_novelty` | Spectral novelty for section boundaries |
+| `get_momentary_loudness` | EBU R128 momentary LUFS + peak |
+| `check_flucoma` | Verify FluCoMa installation |
+| `capture_audio` | Record master output to WAV |
+| `capture_stop` | Cancel in-progress capture |
+
+<br>
+
+### Perception (4)
+
+| Tool | Description |
+|------|-------------|
+| `analyze_loudness` | Integrated LUFS, true peak, LRA, streaming compliance |
+| `analyze_spectrum_offline` | Spectral centroid, rolloff, flatness, 5-band balance |
+| `compare_to_reference` | Mix vs reference: loudness + spectral delta |
+| `read_audio_metadata` | Format, duration, sample rate, tags |
 
 <br>
 
@@ -750,18 +769,6 @@ Check memory before creative decisions. Verify every mutation.
 
 ---
 
-## Coming
-
-```
-□  Real-time DSP analysis via LOM meters
-□  M4L bridge expansion — deeper LiveAPI access
-□  Arrangement view — clip placement, tempo automation
-□  Audio clip manipulation — stretch, slice, resample
-□  Plugin parameter mapping — VST/AU deep control
-```
-
-<br>
-
 ---
 
 ## CLI

package/bin/livepilot.js

@@ -70,7 +70,7 @@ function ensureVenv(systemPython, prefixArgs) {
   // Check if venv already exists and has our deps
   if (fs.existsSync(venvPy)) {
     try {
-      execFileSync(venvPy, ["-c", "import fastmcp; import midiutil; import pretty_midi"], {
+      execFileSync(venvPy, ["-c", "import fastmcp; import midiutil; import pretty_midi; import numpy; import pyloudnorm; import soundfile; import scipy"], {
         encoding: "utf-8",
         timeout: 10000,
         stdio: "pipe",
@@ -127,10 +127,12 @@ function checkStatus() {
     sock.on("data", (chunk) => {
       buf += chunk.toString();
       if (buf.includes("\n")) {
+        let ok = false;
         try {
           const resp = JSON.parse(buf.split("\n")[0]);
           if (resp.ok === true && resp.result && resp.result.pong) {
             console.log("  Ableton Live: connected on %s:%d", HOST, PORT);
+            ok = true;
           } else {
             console.log("  Ableton Live: unexpected response:", JSON.stringify(resp));
           }
@@ -138,7 +140,7 @@ function checkStatus() {
           console.log("  Ableton Live: invalid response");
         }
         sock.destroy();
-        resolve(true);
+        resolve(ok);
       }
     });
 

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.8.3",
-  "description": "Agentic production system for Ableton Live 12 — 168 tools, 17 domains, device atlas, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "version": "1.9.0",
+  "description": "Agentic production system for Ableton Live 12 — 178 tools, 17 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

@@ -1,17 +1,17 @@
 ---
 name: livepilot-core
-description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 168 tools across 17 domains. Device atlas (280+ devices), M4L analyzer (spectrum/RMS/key detection), technique memory, automation intelligence (16 curve types, 15 recipes), music theory (Krumhansl-Schmuckler, species counterpoint), generative algorithms (Euclidean rhythm, tintinnabuli, phase shift), neo-Riemannian harmony (PRL transforms, Tonnetz), MIDI file I/O. Use whenever working with Ableton Live through MCP tools.
+description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 178 tools across 17 domains. Device atlas (280+ devices), M4L analyzer (spectrum/RMS/key detection), technique memory, automation intelligence (16 curve types, 15 recipes), music theory (Krumhansl-Schmuckler, species counterpoint), generative algorithms (Euclidean rhythm, tintinnabuli, phase shift), neo-Riemannian harmony (PRL transforms, Tonnetz), MIDI file I/O. Use whenever working with Ableton Live through MCP tools.
 ---
 
 # LivePilot Core — Ableton Live 12
 
-Agentic production system for Ableton Live 12. 168 tools across 17 domains, three layers:
+Agentic production system for Ableton Live 12. 178 tools across 17 domains, three layers:
 
 - **Device Atlas** — A structured knowledge corpus of 280+ instruments, 139 drum kits, and 350+ impulse responses. Consult the atlas before loading any device. It contains real browser URIs, preset names, and sonic descriptions. Never guess a device name — look it up.
 - **M4L Analyzer** — Real-time audio analysis on the master bus (8-band spectrum, RMS/peak, key detection). Use it to verify mixing decisions, detect frequency problems, and find the key before writing harmonic content.
 - **Technique Memory** — Persistent storage for production decisions. Consult `memory_recall` before creative tasks to understand the user's taste. Save techniques when the user likes something. The memory shapes future decisions without constraining them.
 
-These layers sit on top of 168 deterministic tools across 17 domains: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, MIDI I/O, and perception.
+These layers sit on top of 178 deterministic tools across 17 domains: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, MIDI I/O, and perception.
 
 ## Golden Rules
 
@@ -32,7 +32,7 @@ These layers sit on top of 168 deterministic tools across 17 domains: transport,
 Not all tools respond instantly. Know the tiers and act accordingly.
 
 ### Instant (<1s) — Use freely, no warning needed
-All 168 core tools (transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, automation, theory, generative, harmony, midi_io, perception) plus Layer A perception tools (spectral shape, timbral profile, mel spectrum, chroma, onsets, harmonic/percussive, novelty, momentary loudness). These are the reflex tools — call them anytime without hesitation.
+All 178 core tools (transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, automation, theory, generative, harmony, midi_io, perception) plus Layer A perception tools (spectral shape, timbral profile, mel spectrum, chroma, onsets, harmonic/percussive, novelty, momentary loudness). These are the reflex tools — call them anytime without hesitation.
 
 ### Fast (1-5s) — Use freely, barely noticeable
 `analyze_loudness` · `analyze_dynamic_range` · `compare_loudness`
@@ -117,7 +117,7 @@ Never skip levels. The user's question determines the entry point, but always st
 - MIDI track with no instrument loaded
 - Notes programmed but clip not fired
 
-## Tool Domains (168 total)
+## Tool Domains (178 total)
 
 ### Transport (12)
 `get_session_info` · `set_tempo` · `set_time_signature` · `start_playback` · `stop_playback` · `continue_playback` · `toggle_metronome` · `set_session_loop` · `undo` · `redo` · `get_recent_actions` · `get_session_diagnostics`
@@ -149,8 +149,8 @@ Never skip levels. The user's question determines the entry point, but always st
 ### Memory (8)
 `memory_learn` · `memory_recall` · `memory_get` · `memory_replay` · `memory_list` · `memory_favorite` · `memory_update` · `memory_delete`
 
-### Analyzer (20) — requires LivePilot Analyzer M4L device on master track
-`get_master_spectrum` · `get_master_rms` · `get_detected_key` · `get_hidden_parameters` · `get_automation_state` · `walk_device_tree` · `get_clip_file_path` · `replace_simpler_sample` · `load_sample_to_simpler` · `get_simpler_slices` · `crop_simpler` · `reverse_simpler` · `warp_simpler` · `get_warp_markers` · `add_warp_marker` · `move_warp_marker` · `remove_warp_marker` · `scrub_clip` · `stop_scrub` · `get_display_values`
+### Analyzer (29) — requires LivePilot Analyzer M4L device on master track
+`get_master_spectrum` · `get_master_rms` · `get_detected_key` · `get_hidden_parameters` · `get_automation_state` · `walk_device_tree` · `get_clip_file_path` · `replace_simpler_sample` · `load_sample_to_simpler` · `get_simpler_slices` · `crop_simpler` · `reverse_simpler` · `warp_simpler` · `get_warp_markers` · `add_warp_marker` · `move_warp_marker` · `remove_warp_marker` · `scrub_clip` · `stop_scrub` · `get_display_values` · `get_spectral_shape` · `get_mel_spectrum` · `get_chroma` · `get_onsets` · `get_novelty` · `get_momentary_loudness` · `check_flucoma` · `capture_audio` · `capture_stop`
 
 ### Automation (8)
 Clip automation CRUD + intelligent curve generation with 15 built-in recipes.
@@ -175,6 +175,14 @@ Clip automation CRUD + intelligent curve generation with 15 built-in recipes.
 - Clear existing automation before rewriting: `clear_clip_automation` first
 - Load `references/automation-atlas.md` for curve theory, genre recipes, diagnostic technique, and cross-track spectral mapping
 
+### Perception (4) — offline audio analysis, no Ableton connection required
+`analyze_loudness` · `analyze_spectrum_offline` · `compare_to_reference` · `read_audio_metadata`
+
+**Key discipline:**
+- These work on any local audio file — no Ableton connection needed
+- Use `compare_to_reference` for A/B mix comparisons against reference tracks
+- Use `analyze_loudness` to check streaming compliance (Spotify, Apple Music, YouTube targets)
+
 ### Theory (7)
 Music theory analysis — built-in pure Python engine, zero external dependencies.
 
@@ -366,7 +374,7 @@ Deep production knowledge lives in `references/`. Consult these when making crea
 
 | File | What's inside | When to consult |
 |------|--------------|-----------------|
-| `references/overview.md` | All 168 tools mapped with params, units, ranges | Quick lookup for any tool |
+| `references/overview.md` | All 178 tools mapped with params, units, ranges | Quick lookup for any tool |
 | `references/midi-recipes.md` | Drum patterns by genre, chord voicings, scales, hi-hat techniques, humanization, polymetrics | Programming MIDI notes, building beats |
 | `references/sound-design.md` | Stock instruments/effects, parameter recipes for bass/pad/lead/pluck, device chain patterns | Loading and configuring devices |
 | `references/mixing-patterns.md` | Gain staging, parallel compression, sidechain, EQ by instrument, bus processing, stereo width | Setting volumes, panning, adding effects |

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

@@ -1,6 +1,6 @@
-# LivePilot v1.8.0 — Architecture & Tool Reference
+# LivePilot v1.9.0 — Architecture & Tool Reference
 
-Agentic production system for Ableton Live 12. 168 tools across 17 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.
+Agentic production system for Ableton Live 12. 178 tools across 17 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.
 
 ## Architecture
 
@@ -202,7 +202,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 (20) — Real-time DSP analysis (requires LivePilot Analyzer M4L device on master track)
+### Analyzer (29) — Real-time DSP analysis (requires LivePilot Analyzer M4L device on master track)
 
 | Tool | What it does | Key params |
 |------|-------------|------------|

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

@@ -13,43 +13,56 @@ Run this checklist EVERY time the user says "update everything", "push", "releas
 - [ ] `package-lock.json` → `"version"` (run `npm install --package-lock-only` if stale)
 - [ ] `server.json` → `"version"` (TWO locations: top-level and package)
 - [ ] `livepilot/.claude-plugin/plugin.json` → `"version"`
+- [ ] `.claude-plugin/marketplace.json` → `"version"` in plugins array
 - [ ] `mcp_server/__init__.py` → `__version__`
-- [ ] `remote_script/LivePilot/__init__.py` → version in log message
+- [ ] `remote_script/LivePilot/__init__.py` → `__version__` (log message auto-uses it)
 - [ ] `m4l_device/livepilot_bridge.js` → version in ping response
+- [ ] `CLAUDE.md` → header line
+- [ ] `livepilot/skills/livepilot-core/references/overview.md` → header line
 - [ ] `CHANGELOG.md` → latest version header
 - [ ] `docs/social-banner.html` → version display
+- [ ] `docs/M4L_BRIDGE.md` → ping response example
 
-**How to check:** `grep -rn "1\.[0-9]\.[0-9]" package.json server.json livepilot/.claude-plugin/plugin.json mcp_server/__init__.py remote_script/LivePilot/__init__.py m4l_device/livepilot_bridge.js CHANGELOG.md docs/social-banner.html`
+**How to check:** `grep -rn "1\.[0-9]\.[0-9]" package.json server.json livepilot/.claude-plugin/plugin.json .claude-plugin/marketplace.json mcp_server/__init__.py remote_script/LivePilot/__init__.py m4l_device/livepilot_bridge.js CHANGELOG.md CLAUDE.md livepilot/skills/livepilot-core/references/overview.md docs/social-banner.html docs/M4L_BRIDGE.md`
 
 ## 2. Tool Count (must ALL match)
 
-- [ ] `README.md` — every occurrence
-- [ ] `package.json` → `"description"`
+Current: **178 tools across 17 domains**.
+Core (no M4L): **139**. Analyzer (M4L): **29**. Perception (offline): **4**.
+
+Verify: `grep -rc "@mcp.tool" mcp_server/tools/ | grep -v ":0" | awk -F: '{sum+=$2} END{print sum}'`
+
+Files that reference tool count:
+- [ ] `README.md` — header, PERCEPTION section ("139 core...29 analyzer"), Analyzer table header "(29)", Perception table header "(4)"
+- [ ] `package.json` → `"description"` (178 tools, 17 domains)
 - [ ] `server.json` → `"description"`
 - [ ] `livepilot/.claude-plugin/plugin.json` → `"description"`
-- [ ] `CLAUDE.md`
-- [ ] `livepilot/skills/livepilot-core/SKILL.md` — header and domain breakdown
-- [ ] `livepilot/skills/livepilot-core/references/overview.md`
-- [ ] `docs/manual/index.md`
-- [ ] `docs/manual/tool-reference.md`
-- [ ] `docs/TOOL_REFERENCE.md`
-- [ ] `docs/M4L_BRIDGE.md`
+- [ ] `.claude-plugin/marketplace.json` → `"description"`
+- [ ] `CLAUDE.md` → "178 tools across 17 domains"
+- [ ] `livepilot/skills/livepilot-core/SKILL.md` — "178 tools across 17 domains", Analyzer (29), Perception (4)
+- [ ] `livepilot/skills/livepilot-core/references/overview.md` — "178 tools across 17 domains"
+- [ ] `docs/manual/index.md` — domain table: Analyzer (29), Perception (4)
+- [ ] `docs/manual/getting-started.md` — "139 core tools...29 analyzer"
+- [ ] `docs/manual/tool-reference.md` — all domains present with correct counts
+- [ ] `docs/TOOL_REFERENCE.md` — all domains present
+- [ ] `docs/M4L_BRIDGE.md` — "139 core tools...29 analyzer"
 - [ ] `docs/social-banner.html`
 - [ ] `mcp_server/tools/analyzer.py` → module docstring
-- [ ] `tests/test_tools_contract.py` → expected count
+- [ ] `tests/test_tools_contract.py` → expected total count
 
-**How to check:** `grep -rn "127\|128\|129\|130\|131\|132\|133\|134" --include="*.md" --include="*.json" --include="*.py" --include="*.html" --include="*.js" . | grep -v node_modules | grep -v .git | grep -v __pycache__`
+**How to check:** `grep -rn "168\|139\|135\|127\|115\|107" --include="*.md" --include="*.json" --include="*.py" --include="*.html" . | grep -v node_modules | grep -v .git | grep -v __pycache__ | grep -v CHANGELOG`
 
 ## 3. Domain Count
 
-- [ ] All files above that mention "11 domains" should say "12 domains"
-- [ ] Domain lists should include: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, automation, memory, analyzer
+Current: **17 domains**: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception.
+
+- [ ] All files that mention domain count say "17 domains"
+- [ ] Domain lists include ALL 17 (especially perception — it's the newest and most often omitted)
 
 ## 4. npm Registry
 
 - [ ] `npm view livepilot version` matches local version
 - [ ] If not: `npm publish`
-- [ ] Verify badge will update: badge URL in README.md points to shields.io/npm/v/livepilot
 
 ## 5. GitHub
 
@@ -57,9 +70,6 @@ Run this checklist EVERY time the user says "update everything", "push", "releas
 - [ ] Topics are current (should include: ai, mcp, ableton, livepilot, max-for-live, audio-analysis)
 - [ ] Latest release matches current version (`gh release list`)
 - [ ] Release notes are current
-- [ ] Old stale releases cleaned up
-- [ ] Git tags: only relevant versions exist (`git tag -l`)
-- [ ] No co-author or unwanted metadata in commit messages
 
 ## 6. Plugin Cache
 
@@ -74,28 +84,26 @@ Run this checklist EVERY time the user says "update everything", "push", "releas
 
 ## 8. Documentation Content
 
-- [ ] `README.md` — features match current capabilities
-- [ ] `docs/manual/getting-started.md` — install instructions current, mentions M4L Analyzer
-- [ ] `docs/manual/tool-reference.md` — all tools listed
-- [ ] `docs/M4L_BRIDGE.md` — architecture accurate
-- [ ] `docs/TOOL_REFERENCE.md` — all tools listed with correct params
+- [ ] `README.md` — features match current capabilities, "Coming" section is accurate
+- [ ] `docs/manual/getting-started.md` — install instructions current
+- [ ] `docs/manual/tool-reference.md` — all 17 domains listed, all 178 tools present
+- [ ] `docs/TOOL_REFERENCE.md` — all 17 domains present
+- [ ] `docs/M4L_BRIDGE.md` — architecture accurate, core tool count correct
 
 ## 9. Derived Artifacts
 
 - [ ] `m4l_device/LivePilot_Analyzer.amxd` — frozen JS matches source? All commands present?
-- [ ] Distributable zip on Desktop — rebuilt with latest?
-- [ ] Private backup repo — synced and pushed?
-- [ ] `LivePilot-v*.INSTALL.txt` — updated?
+- [ ] If `livepilot_bridge.js` changed → amxd needs rebuilding in Max editor
 
 ## 10. Code Consistency
 
 - [ ] `@mcp.tool()` count matches documented tool count: `grep -r "@mcp.tool" mcp_server/tools/ | wc -l`
 - [ ] No dead imports or unused code in recently changed files
 - [ ] Remote script version matches MCP server version
+- [ ] All tests pass: `python3 -m pytest tests/ -v`
 
 ## Quick Verify Command
 
-Run this one-liner to catch most issues:
 ```bash
-echo "=== Versions ===" && grep -h '"version"' package.json server.json livepilot/.claude-plugin/plugin.json | head -5 && grep __version__ mcp_server/__init__.py && echo "=== Tool count ===" && grep -rc "@mcp.tool" mcp_server/tools/ | tail -1 && echo "=== npm ===" && npm view livepilot version 2>/dev/null && echo "=== GitHub release ===" && gh release list --limit 1 && echo "=== Tags ===" && git tag -l
+echo "=== Versions ===" && grep -h '"version"' package.json server.json livepilot/.claude-plugin/plugin.json .claude-plugin/marketplace.json | head -6 && grep __version__ mcp_server/__init__.py remote_script/LivePilot/__init__.py && echo "=== Tool count ===" && grep -rc "@mcp.tool" mcp_server/tools/ | grep -v ":0" | awk -F: '{sum+=$2} END{print "Total:", sum}' && echo "=== Tests ===" && python3 -m pytest tests/ -q 2>&1 | tail -1
 ```