livepilot 1.16.0 → 1.16.1

package/CHANGELOG.md

@@ -1,10 +1,80 @@
 # Changelog
 
-## 1.16.0 — Villalobos session bug batch + Splice plan model (April 22 2026)
+## 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
-Villalobos-style production session, ships a plan-aware Splice download
+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.
@@ -525,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
@@ -561,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
@@ -578,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>
-  421 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
 │         └─────────────────┼──────────────────┘                       │
 │                           ▼                                          │
 │                  ┌─────────────────┐                                  │
-│                  │   421 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 421 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
 
-421 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 421 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 421 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.16.0"
+__version__ = "1.16.1"

package/mcp_server/atlas/enrichments/audio_effects/pitch_hack.yaml

@@ -0,0 +1,61 @@
+id: pitch_hack
+name: Pitch Hack
+sonic_description: >
+  Versatile pitch-shifting delay for Creative Extensions. Combines
+  transposition, reverse, feedback, and randomization on a single delay
+  line. Lighter-weight companion to PitchLoop89 — less of a spatial
+  architect, more of a per-sound treatment for pitched echoes and random
+  reversal textures. The go-to for Akufen-style micro-stutter on hats and
+  the random-reverse pitched ghosts that Villalobos uses on every track.
+category: pitch_delay
+character_tags: [pitched, glitchy, reversed, randomized, micro_stutter]
+use_cases: [akufen_stutter, pitched_ghost, reverse_echo, textural_delay]
+genre_affinity:
+  primary: [microhouse, deep_minimal, idm, experimental]
+  secondary: [dub_techno, electronica]
+complexity: beginner
+introduced_in: "10.0"
+pack: Creative Extensions
+creator: Ableton + Amazing Noises
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Transpose"
+    description: "Pitch shift in semitones + cents on the delayed signal."
+    range: [-24, 24]
+    unit: "st"
+    type: int
+  - name: "Delay Time"
+    description: "Delay in ms or tempo-synced subdivisions."
+  - name: "Feedback"
+    description: "Pitched echo feedback. Cascading when transpose is non-zero."
+    range: [0.0, 1.0]
+    type: float
+  - name: "Reverse"
+    description: "Reverse-plays the delay buffer."
+    type: boolean
+  - name: "Randomize"
+    description: "Randomizes pitch and/or reverse per repeat. The Villalobos-texture parameter."
+    range: [0.0, 1.0]
+    type: float
+
+signature_techniques:
+  - name: "Akufen micro-stutter on hats"
+    description: "Short delay (~50ms), Feedback 0.4, Randomize 0.6 → every hi-hat hit gets 2-3 unpredictable pitched ghost echoes."
+    aesthetic: [microhouse]
+  - name: "Ghost chord tails"
+    description: "Chord stab → Reverse on, Transpose +3st, Feedback 0.5 → pitched reverse ghost trails fade out after each stab."
+    aesthetic: [deep_minimal]
+  - name: "Random pitched percussion"
+    description: "Put on a clave or click → Randomize full → each hit decays into a different pitched echo pattern."
+    aesthetic: [microhouse, idm]
+
+pairings:
+  - device: spectral_blur
+    rationale: "Feed Pitch Hack's random-pitched output into Spectral Blur's halo for ghost atmospheres under the kick."
+
+gotchas:
+  - "Randomize above 0.8 can produce notes wildly out of key — gate with key-detection first if harmony matters."
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/creative-extensions/"

package/mcp_server/atlas/enrichments/audio_effects/pitchloop89.yaml

@@ -0,0 +1,111 @@
+id: pitchloop89
+name: PitchLoop89
+sonic_description: >
+  Robert Henke's emulation of the 1979 Publison DHM 89 B2 pitch-shifting delay.
+  Two independent pitch-shifting delay voices per stereo channel, each with
+  their own pitch (±24 semitones), fine detune (±1 semitone), feedback, pan,
+  and reverse capability. Sample rate selection, hold function, vibrato LFO
+  (sine/square), position modulation LFO with 7 waveforms. THE tool for
+  Monolake-style detuned delay clouds, Basic Channel spatial signatures,
+  and Arpiar-adjacent shimmered stabs.
+category: pitch_delay
+character_tags: [detuned, shimmering, glitchy, spatial, pitched, experimental, vintage_digital]
+use_cases: [stab_shimmer, detuned_echo, reverse_tail, infinite_feedback, glitched_texture]
+genre_affinity:
+  primary: [deep_minimal, dub_techno, ambient, experimental]
+  secondary: [microhouse, idm, drone, cinematic]
+complexity: intermediate
+introduced_in: "11.0"
+pack: PitchLoop89
+creator: Robert Henke
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Pitch A / Pitch B"
+    description: "Coarse pitch shift per voice, in semitones. Two voices mean you can split: one +0.05 cents shimmer, one -0.07 cents detune for dual-detune clouds."
+    range: [-24, 24]
+    unit: "st"
+    type: int
+    sweet_spots:
+      dual_detune_cloud: "+0.05 / -0.07 cents"
+      octave_shimmer: "+12 / +0"
+      reverse_ambience: "+0 / +0 with reverse on"
+
+  - name: "Fine A / Fine B"
+    description: "Fine detune per voice in cents (±100)."
+    range: [-100, 100]
+    unit: "cents"
+    type: int
+    sweet_spots:
+      shimmer: "+5 / -7"
+      chorus_thick: "+15 / -15"
+
+  - name: "Feedback A / Feedback B"
+    description: "Per-voice feedback. High values (80-95%) produce infinite-ascending or descending pitch spirals. Shepard-tone territory."
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle_echo: 0.35
+      pitched_spiral: 0.85
+      near_infinite: 0.97
+
+  - name: "Reverse"
+    description: "Per-voice reverse playback. Reverses the delay buffer before pitch shift — creates 'reverse swell' tails from any transient."
+    type: boolean
+    sweet_spots:
+      chord_swell_in: true
+
+  - name: "Mode"
+    description: "Signal routing: L/R (independent), Sum (both voices sum to mono), Cross (voice A to R out, voice B to L out, stereo ping-pong at different pitches)."
+    range: ["L/R", "Sum", "Cross"]
+    type: enum
+    sweet_spots:
+      stereo_ping_pong: "Cross"
+      mono_layer: "Sum"
+
+  - name: "Sample Rate"
+    description: "Buffer sample rate reduction. Lower values add characterful lo-fi grit — emulates the original Publison's digital artifacts."
+    range: [1, 44100]
+    unit: "Hz"
+    type: int
+    sweet_spots:
+      vintage_89: 12000
+      heavy_lofi: 4000
+
+  - name: "Vibrato LFO"
+    description: "Modulates pitch over time. Sine or square waveform; rate in Hz."
+    type: composite
+
+  - name: "Position LFO"
+    description: "Modulates the read position in the delay buffer. Seven waveforms including random. The source of the 'shuddering glitch' and 'fractured rhythm' textures Henke uses."
+    type: composite
+
+signature_techniques:
+  - name: "Shimmer on any stab"
+    description: "Put on a chord stab → Pitch A=0, Fine A=+5, Pitch B=0, Fine B=-7, Feedback both at 0.4 → instant detuned shimmer cloud that hangs after the stab."
+    aesthetic: [arpiar, microhouse, dub_techno]
+  - name: "Reverse-in on chords"
+    description: "Enable Reverse on both voices, short delay time → chord swells backwards in before the downbeat. Haunting Monolake effect."
+    aesthetic: [dub_techno, cinematic]
+  - name: "Infinite Shepard on clicks"
+    description: "Feed a single click → Feedback ~0.92, Pitch A=+12, Pitch B=0 → infinite ascending cascade. Classic Henke."
+    aesthetic: [experimental, idm]
+  - name: "Pitched ghost delay"
+    description: "Slow Position LFO with random waveform → delay buffer warps around, producing organic pitched ghosts that never repeat."
+    aesthetic: [deep_minimal, experimental]
+
+pairings:
+  - device: convolution_reverb
+    rationale: "PitchLoop89 feeding Convolution Reverb's Farfisa Spring IR = the Basic Channel / Monolake spatial chain."
+  - device: granulator_iii
+    rationale: "Layer after Granulator for detuned shimmer on top of grain clouds."
+  - device: utility
+    rationale: "Send a short-decay copy of the source to PitchLoop89 via a return track — leaves the original dry while the pitched tail trails."
+
+gotchas:
+  - "Feedback above 0.95 can self-oscillate into runaway loop — keep a hand on the mute"
+  - "Reverse mode introduces latency equal to the buffer length — sync-critical material needs delay compensation"
+  - "Sample Rate very low (<2000Hz) aliases heavily; character, not hi-fi"
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/pitchloop89/"

package/mcp_server/atlas/enrichments/audio_effects/re_enveloper.yaml

@@ -0,0 +1,51 @@
+id: re_enveloper
+name: Re-Enveloper
+sonic_description: >
+  Multiband envelope processor with three adjustable frequency bands. Unlike
+  compression (which reduces amplitude when over threshold), Re-Enveloper
+  reshapes envelope character itself — attack, sustain, decay — independently
+  per band. The right tool for 'shorten the decay of this sustained sound so
+  it behaves like a stab' or 'expand the transient on the highs only'.
+category: dynamics
+character_tags: [multiband, envelope_shaping, transient, sculpted]
+use_cases: [transient_shape, decay_control, per_band_dynamics, micro_stab]
+genre_affinity:
+  primary: [minimal, dub_techno, electronica]
+  secondary: [all_genres]
+complexity: intermediate
+introduced_in: "10.0"
+pack: Creative Extensions
+creator: Ableton + Amazing Noises
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Band Split Frequencies"
+    description: "Low/Mid and Mid/High crossover points in Hz."
+    range: [20, 20000]
+    unit: "Hz"
+    type: float
+  - name: "C/E Factor (per band)"
+    description: "Compression (positive) or Expansion (negative) factor per band."
+    range: [-5.0, 5.0]
+    type: float
+    sweet_spots:
+      subtle_expand: 1.5
+      aggressive_stab: 3.0
+      decay_tightening: -2.0
+  - name: "Attack / Release (per band)"
+    description: "Envelope-shape time constants for each band independently."
+
+signature_techniques:
+  - name: "Turn sustained chord into stab"
+    description: "Low + mid bands at -3.0 C/E (expansion toward short decay), short release → 4-bar pad becomes punchy 1/4-note stab."
+    aesthetic: [deep_minimal]
+  - name: "Expand only the snare transient"
+    description: "High band 2.5 expansion, slow release → snare crack pops out without affecting kick or toms."
+    aesthetic: [all]
+
+gotchas:
+  - "Expansion factors above 4.0 can cause clipping — compensate output gain."
+  - "Crossover bands overlap by ~6dB — not a surgical splitter."
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/creative-extensions/"

package/mcp_server/atlas/enrichments/audio_effects/snipper.yaml

@@ -0,0 +1,36 @@
+id: snipper
+name: Snipper
+sonic_description: >
+  Audio snippet replayer with pitch modulation (Building Max Devices
+  tutorial pack). Re-plays snippets of incoming audio at modulated
+  pitches. Small tool, surprisingly aesthetic-critical for microhouse —
+  the 'replay this hat with a slightly different pitch each bar' pattern.
+category: audio_rearranger
+character_tags: [replay, pitched, micro_chop, glitch]
+use_cases: [micro_chop, pitched_replay, vocal_stutter]
+genre_affinity:
+  primary: [microhouse, deep_minimal, glitch]
+  secondary: [idm]
+complexity: intermediate
+introduced_in: "11.0"
+pack: Building Max Devices
+creator: Ableton
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Snippet Length"
+    description: "Duration of the captured snippet."
+  - name: "Replay Rate"
+    description: "How often the snippet re-triggers."
+  - name: "Pitch Modulation"
+    description: "Per-replay pitch shift."
+  - name: "Randomize"
+    description: "Random variation on pitch/replay timing."
+
+signature_techniques:
+  - name: "Vocal micro-chop"
+    description: "Route vocal → Snipper → short snippet, fast replay, pitch mod → instant Akufen-adjacent micro-vocal pattern."
+    aesthetic: [microhouse]
+
+learn_more:
+  pack: "Building Max Devices"

package/mcp_server/atlas/enrichments/audio_effects/spectral_blur.yaml

@@ -0,0 +1,64 @@
+id: spectral_blur
+name: Spectral Blur
+sonic_description: >
+  Spectral halo/reverb hybrid. Creates reverb-like textures by blurring
+  user-defined frequency ranges into dense clouds of delayed/smeared
+  harmonic content. Not a real reverb — no IR — but the result behaves
+  like one, with more control over which frequency ranges get haloed.
+  Freeze button holds the current spectral content indefinitely. The
+  tool for ethereal pads from sparse sources and alien textures that
+  don't sound like rooms.
+category: spectral_fx
+character_tags: [spectral, halo, reverb_like, ethereal, frozen, frequency_selective]
+use_cases: [halo_pad, ghost_atmosphere, frozen_texture, spectral_bed]
+genre_affinity:
+  primary: [ambient, deep_minimal, experimental, drone]
+  secondary: [dub_techno, cinematic]
+complexity: intermediate
+introduced_in: "10.0"
+pack: Creative Extensions
+creator: Ableton + Amazing Noises
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Frequency Range"
+    description: "Low and high cutoff of the blurred band. Narrow ranges produce pitched halos; wide ranges produce reverb-like wash."
+  - name: "Halo (Grain Length)"
+    description: "How long each spectral grain lingers. Short = shimmer; long = sustained bed."
+    range: [50, 5000]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      subtle_shimmer: 200
+      sustained_bed: 2000
+  - name: "Residual"
+    description: "Amount of dry signal that passes through. 0 = fully wet halo, 1 = hear the source clearly."
+    range: [0.0, 1.0]
+    type: float
+  - name: "Freeze"
+    description: "Holds the current spectral content. Manual or MIDI-triggered."
+    type: boolean
+
+signature_techniques:
+  - name: "Ghost atmosphere under the kick"
+    description: "Very short source (click), narrow mid band, Halo 3000ms, Residual 0 → continuous ghost bed at -30dB."
+    aesthetic: [deep_minimal, ambient]
+  - name: "Freeze-and-move"
+    description: "Play a chord → hit Freeze → automate frequency-range low/high up the spectrum → harmonic cloud morphs in pitch-space."
+    aesthetic: [experimental, drone]
+  - name: "Reverse reverb alternative"
+    description: "Apply to a short stab with long Halo → get reverse-reverb-like build-in without needing to flip the audio."
+    aesthetic: [cinematic, deep_minimal]
+
+pairings:
+  - device: pitchloop89
+    rationale: "PitchLoop89 feeding Spectral Blur = Basic Channel / Monolake ethereal space"
+  - device: convolution_reverb
+    rationale: "Spectral Blur before Conv Rev compounds the halo with real-space acoustics"
+
+gotchas:
+  - "Halo times above 3000ms accumulate CPU — freeze the track after print"
+  - "Narrow frequency ranges at high levels self-oscillate — keep Residual > 0 or compress"
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/creative-extensions/"

package/mcp_server/atlas/enrichments/instruments/bell_tower.yaml

@@ -0,0 +1,37 @@
+id: bell_tower
+name: Bell Tower
+sonic_description: >
+  FM bell synthesis M4L example device from the Building Max Devices pack.
+  Designed as a tutorial but produces genuinely usable bell/mallet timbres
+  via simple FM synthesis. Through Convolution Reverb = thin Arpiar bell
+  stab territory.
+synthesis_type: fm_bell
+character_tags: [bell, fm, metallic, percussive]
+use_cases: [bell_stab, pluck, atmospheric_bell]
+genre_affinity:
+  primary: [ambient, deep_minimal, arpiar]
+  secondary: [experimental, cinematic]
+complexity: beginner
+self_contained: true
+introduced_in: "11.0"
+pack: Building Max Devices
+creator: Ableton
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Carrier Freq"
+    description: "Base pitch."
+  - name: "Modulator Ratio"
+    description: "Ratio of modulator to carrier — inharmonic ratios give bells, integer ratios give pluck tones."
+  - name: "Modulator Depth"
+    description: "FM index — brightness/metallic character."
+  - name: "Decay"
+    description: "Bell decay time."
+
+signature_techniques:
+  - name: "Arpiar bell through Convolution Reverb"
+    description: "Short decay, subtle modulator depth, single hit per bar, through a long cathedral IR → the thin bell stab that recurs in Arpiar tracks."
+    aesthetic: [arpiar, deep_minimal]
+
+learn_more:
+  pack: "Building Max Devices"