livepilot 1.10.5 → 1.10.7

package/CHANGELOG.md

@@ -1,5 +1,97 @@
 # Changelog
 
+## 1.10.7 — npm .amxd parity + domain-count consistency (April 18 2026)
+
+Shipping release. Brings npm's tarball back in line with the fresh `.amxd`
+freeze that landed on `main` after v1.10.6 tagged, and unifies the three
+formerly-disagreeing sources of the domain count.
+
+### Fixed
+
+- **npm tarball parity with the GitHub release.** v1.10.6's npm publish
+  predated commit `b0463ea` (the real fat `.amxd` freeze with matching ping
+  bytes), so `npm install livepilot@1.10.6` shipped the stale Batch-22
+  `.amxd` and `simpler_set_warp` silently no-op'd. v1.10.7 republishes with
+  the fresh `.amxd` already present in the GitHub release assets.
+- **Domain count unified at 45.** Three formerly-disagreeing sources: prose
+  docs claimed "43 domains", `generate_tool_catalog.py` inferred "36" (via
+  a hand-maintained whitelist that silently dropped ~10 domains —
+  `atlas`, `composer`, `creative_constraints`, `device_forge`,
+  `hook_hunter`, `preview_studio`, `sample_engine`, `session_continuity`,
+  `song_brain`, `stuckness_detector`, `wonder_mode` — into an "Other"
+  bucket), runtime module layout has 45. All three now agree.
+- **Inline domain lists completed.** `CLAUDE.md:31` was missing
+  `experiment`, `musical_intelligence`, and `semantic_moves`;
+  `livepilot/skills/livepilot-release/SKILL.md:63` was missing
+  `semantic_moves`.
+
+### Infra
+
+- **`scripts/sync_metadata.py` extended** with `check_domain_count()` and
+  `check_domain_list()` that derive truth from `mcp_server` module paths.
+  `--fix` mode now auto-corrects stale tool/domain counts and appends
+  missing inline-list entries; extra entries are never auto-removed so a
+  pattern miss can't silently delete a legitimate domain.
+- **`scripts/generate_tool_catalog.py`** now uses the same module-layout
+  rule (`mcp_server.<X>` / `mcp_server.tools.<Y>`) as `sync_metadata.py`
+  so the two tools can't disagree on the domain set again.
+- **`.mcpbignore`** excludes `m4l_device/*.pre-*-backup` rollback artifacts
+  from the packaged `.mcpb`, keeping release bundles pristine across
+  future freeze cycles.
+- **`CLAUDE.md` gains `## Domain Count` section** documenting the drift
+  enforcer alongside the existing `## Tool Count` and `## Version Bump`
+  sections.
+
+## 1.10.6 — Debuggability + Engine Modularization (April 17 2026)
+
+Defensive-programming release. Zero behavior change for users; substantial
+quality-of-life gains for developers and future debugging sessions.
+
+### Debuggability
+
+- **Silent-exception sweep.** All 79 `except Exception: pass` sites across
+  `mcp_server/` now emit a `logger.debug("<func> failed: %s", exc)` breadcrumb
+  while preserving the original body (pass / return X / continue). Previously
+  invisible failures now leave a trail. Run with `LOG_LEVEL=DEBUG` to surface.
+- **Credit-floor guard hardened.** `SpliceGRPCClient.download_sample()` now
+  enforces `CREDIT_HARD_FLOOR` defensively via `can_afford(1, budget=1)` before
+  the gRPC call. Tool-layer callers still gate upstream for UX; this closes
+  the hole if any future caller forgets. The docstring claimed this guard
+  existed — now the code matches.
+
+### Engine modularization
+
+Two single-file engines (2,477 LOC combined) split into packages while keeping
+the public surface identical. Callers that did `from . import X as engine` or
+`from .X import Symbol` continue to work unchanged.
+
+- **`mcp_server/tools/_composition_engine/`** — 6 sub-modules (models, sections,
+  critics, gestures, harmony, analysis) + facade. Was 1,530 LOC in one file;
+  now no sub-module exceeds 522 LOC.
+- **`mcp_server/tools/_agent_os_engine/`** — 6 sub-modules (models, world_model,
+  critics, evaluation, techniques, taste) + facade. Was 947 LOC; now no
+  sub-module exceeds 207 LOC. `_clamp` promoted to models.py to resolve a
+  circular-dep risk between `evaluation` and `taste`.
+
+### Infra
+
+- **CI matrix adds Python 3.11.** Ableton 12.3's embedded Python is 3.11 on
+  some platforms — catching drift pre-merge.
+- **`livepilot.mcpb` removed from git tracking.** It was already excluded from
+  `.npmignore` and `.mcpbignore`; now it's no longer bloating git history every
+  release. Distribute via GitHub Releases.
+- **`.git-backup-full/` deleted.** 3.4 MB worktree reclaim.
+
+### Docs
+
+- **OSC address convention** documented in both `m4l_device/livepilot_bridge.js`
+  and `mcp_server/m4l_bridge.py` — the existing tolerant normalization at
+  `_parse_osc` now has a written contract.
+
+### Tests
+
+1756 pass, 1 skipped (macOS-only path test on non-darwin), 0 failures.
+
 ## 1.10.5 — Splice online catalog unblocked + Simpler sample-loading fixes (April 14 2026)
 
 The Splice integration was **never working online** in previous releases. The

package/CONTRIBUTING.md

@@ -98,7 +98,7 @@ Prefix with `fix:`, `feat:`, `docs:`, `refactor:`, `test:`, or `chore:`.
 
 ## Tool Count Discipline
 
-Currently **320 tools**. If you add or remove a `@mcp.tool()` decorator, update all of these files:
+Currently **323 tools**. If you add or remove a `@mcp.tool()` decorator, update all of these files:
 
 - `README.md`
 - `CLAUDE.md`

package/README.md

@@ -17,7 +17,7 @@
 
 <p align="center">
   An agentic production system for Ableton Live 12.<br>
-  320 tools. 43 domains. Device atlas. Splice integration. Auto-composition. Spectral perception. Technique memory.
+  323 tools. 45 domains. Device atlas. Splice integration. Auto-composition. Spectral perception. Technique memory.
 </p>
 
 <br>
@@ -79,8 +79,8 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 │         └─────────────────┼──────────────────┘                       │
 │                           ▼                                          │
 │                  ┌─────────────────┐                                  │
-│                  │   320 MCP Tools  │                                  │
-│                  │   43 domains     │                                  │
+│                  │   323 MCP Tools  │                                  │
+│                  │   45 domains     │                                  │
 │                  └────────┬────────┘                                  │
 │                           │                                          │
 │           Remote Script ──┤── TCP 9878                                │
@@ -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 320 tools. They give the AI musical judgment, not just musical execution.
+12 engines sit on top of the 323 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
 
-320 tools across 43 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
+323 tools across 45 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 320 tools →](docs/manual/tool-catalog.md)**
+> **[View all 323 tools →](docs/manual/tool-catalog.md)**
 
 <br>
 
@@ -585,7 +585,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details, code guidelines
 
 | Document | What's inside |
 |----------|---------------|
-| [Manual](docs/manual/index.md) | Complete reference: architecture, all 320 tools, workflows |
+| [Manual](docs/manual/index.md) | Complete reference: architecture, all 323 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/bin/livepilot.js

@@ -402,27 +402,47 @@ async function setupFlucoma() {
   const https = require("https");
 
   const home = os.homedir();
-  const packagesDir = process.platform === "darwin"
-    ? path.join(home, "Documents", "Max 8", "Packages")
-    : path.join(process.env.USERPROFILE || home, "Documents", "Max 8", "Packages");
 
+  // Max 9 is the current release (the Ableton Live 12.3+ default); Max 8 is
+  // the legacy path. Check both — if FluCoMa is already installed in either,
+  // Max will find it via its package search path. For fresh installs, prefer
+  // Max 9. Users still on Max 8 get the legacy path.
+  const docsBase = process.platform === "darwin"
+    ? path.join(home, "Documents")
+    : path.join(process.env.USERPROFILE || home, "Documents");
+
+  const max9PackagesDir = path.join(docsBase, "Max 9", "Packages");
+  const max8PackagesDir = path.join(docsBase, "Max 8", "Packages");
+
+  // Prefer Max 9 if that directory exists, else Max 8
+  const packagesDir = fs.existsSync(max9PackagesDir) ? max9PackagesDir : max8PackagesDir;
   const flucomaDir = path.join(packagesDir, "FluidCorpusManipulation");
 
-  if (fs.existsSync(flucomaDir)) {
-    // Check version
-    const pkgInfo = path.join(flucomaDir, "package-info.json");
+  // Check BOTH locations for an existing install — a user may have Max 8
+  // FluCoMa from a prior install that still works
+  const altFlucomaDir = path.join(
+    packagesDir === max9PackagesDir ? max8PackagesDir : max9PackagesDir,
+    "FluidCorpusManipulation"
+  );
+
+  for (const candidateDir of [flucomaDir, altFlucomaDir]) {
+    if (!fs.existsSync(candidateDir)) continue;
+    const pkgInfo = path.join(candidateDir, "package-info.json");
     if (fs.existsSync(pkgInfo)) {
       try {
         const info = JSON.parse(fs.readFileSync(pkgInfo, "utf-8"));
         console.log("FluCoMa already installed: v%s", info.version || "unknown");
-        console.log("Location: %s", flucomaDir);
+        console.log("Location: %s", candidateDir);
         return;
       } catch {}
     }
-    console.log("FluCoMa already installed at %s", flucomaDir);
+    console.log("FluCoMa already installed at %s", candidateDir);
     return;
   }
 
+  // Ensure the parent Packages directory exists for the install target
+  fs.mkdirSync(packagesDir, { recursive: true });
+
   console.log("FluCoMa not found. Downloading from GitHub...");
   const crypto = require("crypto");
 

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

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.10.5",
-  "description": "Agentic production system for Ableton Live 12 — 320 tools, 43 domains, device atlas, sample intelligence, auto-composition, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "version": "1.10.7",
+  "description": "Agentic production system for Ableton Live 12 — 323 tools, 45 domains, device atlas, sample intelligence, auto-composition, spectral perception, 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.10.5",
-  "description": "Agentic production system for Ableton Live 12 — 320 tools, 43 domains, device atlas, sample intelligence, auto-composition, spectral perception, technique memory, neo-Riemannian harmony, Euclidean rhythm, species counterpoint, MIDI I/O",
+  "version": "1.10.7",
+  "description": "Agentic production system for Ableton Live 12 — 323 tools, 45 domains, device atlas, sample intelligence, auto-composition, 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,11 +1,11 @@
 ---
 name: livepilot-core
-description: Core discipline for LivePilot — agentic production system for Ableton Live 12. 320 tools across 43 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. 323 tools across 45 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. 320 tools across 43 domains, three layers:
+Agentic production system for Ableton Live 12. 323 tools across 45 domains, three layers:
 
 - **Device Atlas** — 1305 devices indexed (81 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 (8-band spectrum, RMS/peak, key detection). Optional — all core tools work without it.
@@ -39,7 +39,7 @@ Agentic production system for Ableton Live 12. 320 tools across 43 domains, thre
 ## Tool Speed Tiers
 
 ### Instant (<1s) — Use freely
-All 320 tools plus M4L perception tools.
+All 323 tools plus M4L perception tools.
 
 ### Fast (1-5s) — Use freely
 `analyze_loudness` · `analyze_mix` · `analyze_sound_design`
@@ -128,7 +128,7 @@ Deep production knowledge in `references/`:
 
 | File | Content |
 |------|---------|
-| `references/overview.md` | All 320 tools with params and ranges |
+| `references/overview.md` | All 323 tools with params and ranges |
 | `references/device-atlas/` | 280+ device corpus with URIs and presets |
 | `references/midi-recipes.md` | Drum patterns, chord voicings, humanization |
 | `references/sound-design.md` | Synth recipes, device chain patterns |

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

@@ -1,6 +1,6 @@
-# LivePilot v1.10.5 — Architecture & Tool Reference
+# LivePilot v1.10.7 — Architecture & Tool Reference
 
-Agentic production system for Ableton Live 12. 320 tools across 43 domains. Device atlas (1305 devices, 81 enriched), 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, Splice online catalog search and download via gRPC (v1.10.5 unblocked 19,690+ catalog hits previously inaccessible).
+Agentic production system for Ableton Live 12. 323 tools across 45 domains. Device atlas (1305 devices, 81 enriched), 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, Splice online catalog search and download via gRPC (v1.10.6 unblocked 19,690+ catalog hits previously inaccessible).
 
 ## Architecture
 

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

@@ -104,7 +104,7 @@ Call `get_capability_state` at the start of any evaluation session. The response
 {
   "mode": "normal",
   "analyzer_connected": true,
-  "bridge_version": "1.10.5",
+  "bridge_version": "1.10.6",
   "spectral_cache_age_ms": 1200,
   "flucoma_available": false,
   "session_connected": true

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

@@ -28,20 +28,20 @@ Run this checklist EVERY time the user says "update everything", "push", "releas
 
 ## 2. Tool Count (must ALL match)
 
-Current: **320 tools across 43 domains**.
+Current: **323 tools across 45 domains**.
 Core (no M4L): **289**. Bridge (M4L): **30** (backed by 28 bridge commands).
 
 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 ("320 tools. 43 domains"), bridge section ("281 core...36 bridge")
+- [ ] `README.md` — header ("323 tools. 45 domains"), bridge section ("281 core...36 bridge")
 - [ ] `package.json` → `"description"`
 - [ ] `server.json` → `"description"`
 - [ ] `manifest.json` → `"description"`
 - [ ] `livepilot/.Codex-plugin/plugin.json` → `"description"` (primary Codex manifest)
 - [ ] `livepilot/.claude-plugin/plugin.json` → `"description"` (must match Codex plugin)
 - [ ] `.claude-plugin/marketplace.json` → `"description"`
-- [ ] `CLAUDE.md` → "320 tools across 43 domains"
+- [ ] `CLAUDE.md` → "323 tools across 45 domains"
 - [ ] `CONTRIBUTING.md` → tool count in intro
 - [ ] `livepilot/skills/livepilot-core/SKILL.md` — tool/domain count
 - [ ] `livepilot/skills/livepilot-core/references/overview.md` — tool/domain count
@@ -60,10 +60,10 @@ Files that reference tool count:
 
 ## 3. Domain Count
 
-Current: **43 domains**: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception, agent_os, composition, motif, research, planner, project_brain, runtime, evaluation, mix_engine, sound_design, transition_engine, reference_engine, translation_engine, performance_engine, song_brain, preview_studio, hook_hunter, stuckness_detector, wonder_mode, session_continuity, creative_constraints, device_forge, sample_engine, atlas, composer, experiment, musical_intelligence.
+Current: **45 domains**: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception, agent_os, composition, motif, research, planner, project_brain, runtime, evaluation, mix_engine, sound_design, transition_engine, reference_engine, translation_engine, performance_engine, song_brain, preview_studio, hook_hunter, stuckness_detector, wonder_mode, session_continuity, creative_constraints, device_forge, sample_engine, atlas, composer, experiment, musical_intelligence, semantic_moves.
 
-- [ ] All files that mention domain count say "43 domains"
-- [ ] Domain lists include ALL 43 (especially newer domains — they're the most often omitted)
+- [ ] All files that mention domain count say "45 domains"
+- [ ] Domain lists include ALL 45 (especially newer domains — they're the most often omitted)
 
 ## 4. npm Registry
 
@@ -93,8 +93,8 @@ Current: **43 domains**: transport, tracks, clips, notes, devices, scenes, mixin
 
 - [ ] `README.md` — features match current capabilities, "Coming" section is accurate
 - [ ] `docs/manual/getting-started.md` — install instructions current
-- [ ] `docs/manual/tool-reference.md` — all 43 domains listed, all 320 tools present
-- [ ] `docs/TOOL_REFERENCE.md` — all 43 domains present with correct counts
+- [ ] `docs/manual/tool-reference.md` — all 45 domains listed, all 323 tools present
+- [ ] `docs/TOOL_REFERENCE.md` — all 45 domains present with correct counts
 - [ ] `docs/M4L_BRIDGE.md` — architecture accurate, core/bridge counts correct
 
 ## 9. Derived Artifacts

package/m4l_device/LivePilot_Analyzer.maxproj

@@ -0,0 +1,53 @@
+{
+	"name" : "LivePilot_Analyzer",
+	"version" : 1,
+	"creationdate" : 3923452800,
+	"modificationdate" : 3923452800,
+	"viewrect" : [ 100.0, 100.0, 300.0, 500.0 ],
+	"autoorganize" : 0,
+	"hideprojectwindow" : 0,
+	"showdependencies" : 1,
+	"autolocalize" : 0,
+	"contents" : 	{
+		"patchers" : 		{
+			"LivePilot_Analyzer.maxpat" : 			{
+				"kind" : "patcher",
+				"local" : 1,
+				"toplevel" : 1
+			}
+		},
+		"code" : 		{
+			"livepilot_bridge.js" : 			{
+				"kind" : "javascript",
+				"local" : 1
+			}
+		},
+		"externals" : 		{
+			"fluid.chroma~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.chroma~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.loudness~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.loudness~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.melbands~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.melbands~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.noveltyfeature~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.noveltyfeature~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.onsetfeature~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.onsetfeature~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 },
+			"fluid.spectralshape~.mxo" : { "kind" : "maxext_darwin", "local" : 1 },
+			"fluid.spectralshape~.mxe64" : { "kind" : "maxext_win_64", "local" : 1 }
+		}
+	},
+	"layout" : 	{
+
+	},
+	"searchpath" : 	{
+
+	},
+	"detailsvisible" : 0,
+	"amxdtype" : 1627865200,
+	"readonly" : 0,
+	"devpathtype" : 0,
+	"devpath" : ".",
+	"sortmode" : 0,
+	"viewmode" : 0
+}