livepilot 1.16.1 → 1.17.0

package/CHANGELOG.md

@@ -1,5 +1,274 @@
 # Changelog
 
+## 1.17.0 — 2026-04-22 handoff close-out (April 22 2026, late)
+
+Closes every item in the 2026-04-22 handoff document: Splice's
+Describe-a-Sound + Variations go LIVE via captured GraphQL
+endpoints, the M4L Analyzer gains a 9th spectrum band (sub_low
+20-60 Hz), track-level arrangement automation lands via a
+two-phase session-record workaround, the atlas gains a
+by_pack index + `atlas_pack_info` MCP tool, the device atlas
+adds 13 enrichments including a Drum Rack container entry, and
+Tier C of the pack-knowledge reference expands from 7 clusters
+to 14 individually-documented packs.
+
+**Tool count**: 422 → 426 (+5 new, −1 retired):
+- `+` `atlas_pack_info` — inspect a pack's device list + enrichment coverage
+- `+` `atlas_describe_chain` — free-text describe-a-chain, mirror of
+  `splice_describe_sound` for the device library. "A granular pad like
+  Tim Hecker" → device chain proposal via artist + genre vocabulary
+  matching
+- `+` `atlas_techniques_for_device` — reverse-lookup: what techniques
+  reference this device? Reads an auto-generated index of 146 technique
+  cross-references across 58 devices
+- `+` `set_arrangement_automation_via_session_record` — T5 workaround,
+  two-phase protocol with tempo-scaled sleep
+- `+` `splice_http_diagnose` — per-endpoint verified-status reporter
+- `−` `splice_search_with_sound` — retired (user handles
+  audio-reference search directly in Splice's UI; capture recipe
+  preserved at `docs/2026-04-22-splice-https-capture-recipe.md`)
+
+**Domain count**: unchanged at 52.
+**Enrichment YAMLs**: 107 → 120 (+13).
+**Atlas pack coverage**: 0 → 641 devices indexed (614 Core Library
+via auto-heuristic + 27 explicit-pack YAML declarations).
+**Signature-technique coverage**: 32 → 47 enrichment files have the
+`signature_techniques` field (+15 files × 3 techniques each = +45
+technique entries from native-synth backfill). Coverage rose from
+27% → 39% of enrichments.
+**Tests**: 2644 → 2696+ (+52 new regression guards).
+
+### Live-verified end-to-end
+
+Against a running Ableton 12.4 + Splice desktop 5.4.9 session on
+2026-04-22:
+
+- `get_master_spectrum()` → 9 keys with `sub_low` first, real-audio
+  energy distribution (`sub_low=0.0003 sub=0.0008 low=0.0064 …`)
+- `atlas_pack_info("Drone Lab")` → Harmonic Drone Generator in
+  both Sounds and M4L variants with URIs
+- `splice_describe_sound("warm dub techno chord stab", limit=5)` →
+  5 real samples out of 4100 total hits (Dub Techno 2 pluck, NEONIC
+  atmos, Visions chord, Organic Elements 2, Underground Techno),
+  with Splice's ML rephrasing `rephrased_query_string: "dub techno,
+  chords, stabs, warm"`
+
+### Splice HTTPS bridge — endpoint capture
+
+Captured via mitmproxy against Splice desktop v5.4.9 (unpinned TLS,
+intercepts cleanly once CA is trusted). Two GraphQL operations
+wired:
+
+- **`SamplesSearch`** at `surfaces-graphql.splice.com/graphql` —
+  describe + keyword search in one operation, flagged via
+  `semantic=1` + `rephrase=true`. 5938-char query embedded as
+  `mcp_server/splice_client/graphql_queries/samples_search.graphql`
+- **`AssetSimilarSoundsQuery`** at the same endpoint — Splice's
+  "Variations" / "Similar Sounds" feature. Input is a sample
+  `uuid` + `isLegacy` bool; returns up to 10 recommendations.
+  886-char query embedded as
+  `mcp_server/splice_client/graphql_queries/asset_similar_sounds.graphql`
+- Auth: `Authorization: Bearer <JWT>` via local gRPC `GetSession`
+  RPC — no stored credentials, token rotates with the running
+  Splice desktop app
+- User-Agent: LivePilot default (override via env var if
+  Cloudflare blocks — mimic pattern: `Splice Baelish/darwin/
+  arm64/arm64 5.4.9/<hash>/stable`)
+- Response normalizer `_flatten_sample_item()` is shared between
+  both operations so samples from describe + variations flatten
+  to identical dicts — 14 new unit tests lock this invariant
+- Per-endpoint `describe_verified` / `variation_verified` flags
+  replace the coarse `is_user_configured` gate
+
+### Changed
+
+- `splice_generate_variation` signature changed: `(file_hash,
+  target_key, target_bpm, count)` → `(uuid, is_legacy)`. The
+  operation is a recommender lookup, not AI audio synthesis, so
+  target-key / target-bpm / count aren't API-supported. The
+  underlying GraphQL returns up to 10 similar samples with the
+  same flat shape as `splice_describe_sound` results.
+- `splice_describe_sound` — status flipped from "scaffolded" to
+  "LIVE". Adds new `rephrase: bool = True` parameter surfacing
+  Splice's `rephrased_query_string` in the response.
+
+### Added
+
+**Sub_low spectrum band** (T3 from handoff):
+- M4L Analyzer `fffb~` filter bank: 8 bands → 9 bands. New band
+  center frequencies: `35 85 175 350 700 1400 2800 5600 12000`
+  (Hz), with `sub_low` (20-60 Hz) prepended to separate kick
+  fundamental from DC rumble
+- `mcp_server/m4l_bridge.py`: `BAND_NAMES_8` + `BAND_NAMES_9`
+  auto-selected based on payload length — older frozen .amxd
+  builds (pre-v1.17) still work without re-freeze
+- `LivePilot_Analyzer.amxd` re-frozen from modified
+  `LivePilot_Analyzer.maxpat` source, 6751650 bytes, synced to
+  repo / Max 9 Library cache / Ableton User Library
+- `docs/2026-04-22-sub-low-band-max-workflow.md` — runbook for
+  future band-count changes (Max editor walkthrough)
+
+**Track-level arrangement automation workaround** (T5 from handoff):
+- New MCP tool `set_arrangement_automation_via_session_record` —
+  async two-phase protocol that creates a session clip with the
+  automation, arms the track, records into arrangement at a
+  target beat, cleans up
+- Two new remote-script handlers:
+  `arrangement_automation_via_session_record_start` returns the
+  live `song.tempo` so the MCP layer can compute the sleep
+  duration, `_complete` stops record + locates the new
+  arrangement clip
+- MCP layer sleeps `duration_beats × 60/tempo + 0.5s` with a
+  600s ceiling and graceful exception handling — incomplete
+  sleep still tries to complete so tracks don't stay armed
+- 17 new contract tests (two-phase ordering, tempo scaling,
+  ceiling, default-tempo fallback, start-failure short-circuit)
+
+**Atlas `by_pack` index + `atlas_pack_info` tool** (T4):
+- New `_by_pack` index on `AtlasManager`, populated from
+  enrichment YAML `pack:` fields plus a Core Library
+  auto-heuristic for native instruments/effects without an
+  explicit pack declaration
+- New `pack_info(name)` and `list_packs()` methods
+- New MCP tool `atlas_pack_info(pack_name)` — `""` returns the
+  full pack list with device counts, otherwise returns
+  `{pack, device_count, enriched_count, devices[...]}` for one
+  pack. Case-insensitive name lookup
+- `genre_affinity` (enriched field) now feeds the `_by_genre`
+  index alongside the raw `genres` field, so
+  `microhouse`/`deep_minimal`/`dub_techno` tags added to YAMLs
+  post-v1.11 finally surface in genre lookups
+
+**Drum Rack atlas enrichment + 12 audio-effects YAMLs** (T1/T2):
+- New `instruments/drum_rack.yaml` — treats Drum Rack as a
+  meta-type container with per-pad key_parameters, 3 starter
+  recipes, 8 gotchas (including MIDI pitch conventions, chain
+  volume vs pad volume)
+- 12 new audio-effects enrichments: `utility`, `corpus`,
+  `vocoder`, `tuner`, `spectrum`, `amp`, `cabinet`, `resonators`,
+  `looper`, `envelope_follower`, `audio_effect_rack`,
+  `external_audio_effect`. Takes `audio_effects/` count from 40
+  → 52
+- Simpler + Sampler enrichments gain 3 new gotchas (Snap=OFF
+  silence bug, -12 dB default, slice base pitch = 36+N)
+- `pack` field added to `_ENRICHMENT_FIELDS` allowlist — was
+  silently dropped from atlas JSON before; now drives the
+  `by_pack` index
+
+**Pack-knowledge reference** (T7):
+- `livepilot/skills/livepilot-core/references/pack-knowledge.md`
+  Tier C expanded from 7 merged clusters (~62 lines) to 14
+  individually-documented packs (Build and Drop, Drive and Glow,
+  Punch and Tilt, Skitter and Step, Trap Drums, Beat Tools, Drum
+  Essentials, SONiVOX Orchestral Brass/Strings/Woodwinds, Grand
+  Piano, Synth Essentials, Session Drums Club + Studio, Core
+  Library) with consistent Essence/Scores/Top/Use/Avoid structure
+
+**Deepened shallow enrichments** (T8):
+- Added `pairs_well_with` + expanded `gotchas` +
+  `signature_techniques` for: `snipper`, `bell_tower`,
+  `performer`, `vector_map`, `filler`
+
+### Concept surface — knowledge the LLM can reason over
+
+Late-v1.17 audit found LivePilot's concept-vs-recipe ratio was already
+healthy (sample-philosophy.md, sound-design-deep.md, per-device
+`signature_techniques`, aesthetic-tagged `character_tags`), but two gaps
+were worth closing before the release: native-synth enrichments heavy
+on `starter_recipes` but thin on `signature_techniques`, and no
+structured artist/genre → device-vocabulary bridge.
+
+Added:
+
+- **`livepilot/skills/livepilot-core/references/artist-vocabularies.md`** —
+  ~25 producers (Villalobos, Hawtin/Plastikman, Basic Channel, Gas,
+  Basinski, Stars of the Lid, Hecker, Aphex, Autechre, OPN, Arca,
+  Dilla, Premier, Madlib, Burial, Mala, Jeff Mills, Moodymann, Daft
+  Punk, Rashad, Photek, Com Truise, Boards of Canada, etc.) with
+  four-field structured entries (sonic fingerprint / reach for /
+  avoid / key techniques). Each entry cross-references
+  `signature_techniques` in per-device YAML or technique names in
+  `sample-techniques.md` / `sound-design-deep.md` — no duplication,
+  just a translation layer from producer names to LivePilot devices
+- **`livepilot/skills/livepilot-core/references/genre-vocabularies.md`** —
+  15 genres (microhouse, dub_techno, deep_minimal, minimal_techno,
+  ambient, idm, modern_classical, hip_hop, trap, dubstep, house,
+  dnb, garage, experimental, synthwave) with tempo / kick / bass /
+  percussion / harmonic / texture / reach-for / avoid structure.
+  Read-before-tool-selection reference for genre-driven workflows
+- **Native-synth `signature_techniques` backfill** — 15 YAMLs that
+  had starter_recipes but no aesthetic-level guidance now have 3
+  techniques each, tagged to known producers (Hawtin subtractive pad,
+  303 acid bass, Reese bass for DnB, J Dilla micro-timed kit, Villalobos
+  sub-bass layer, Basinski tape degradation, Tim Hecker grain cloud,
+  etc.). Files updated: analog, operator, wavetable, drift, collision,
+  tension, electric, simpler, sampler, bass, poli, emit, meld,
+  vector_fm, vector_grain
+- **`mcp_server/atlas/device_techniques_index.json`** — auto-generated
+  reverse-index of 146 device→technique cross-references across 58
+  devices, mined from per-device `signature_techniques` +
+  `sample-techniques.md` + `sound-design-deep.md`
+
+### Docs
+
+- `docs/2026-04-22-release-verification.md` — end-to-end
+  verification report with live-verified evidence per task
+- `docs/2026-04-22-splice-https-capture-recipe.md` — mitmproxy
+  runbook for capturing additional Splice GraphQL operations
+- `docs/2026-04-22-live-api-probe-arrangement-automation.md` —
+  design rationale for the T5 two-phase split
+- `docs/2026-04-22-sub-low-band-max-workflow.md` — Max
+  editor runbook for future filter-bank edits
+- `docs/manual/index.md` — rewrote domain map from source-of-truth
+  per-domain counts (was drifting 30+ entries). Added 7 missing
+  domains (scales, grooves, take_lanes, follow_actions, miditool,
+  diagnostics, synthesis_brain)
+- `docs/manual/tool-reference.md` — new sections for Device Atlas,
+  Sample Engine & Splice, Diagnostics; added v1.17 tools
+  (`atlas_pack_info`, `set_arrangement_automation_via_session_record`,
+  `splice_http_diagnose`, `splice_describe_sound` LIVE,
+  `splice_generate_variation` LIVE); added `add_drum_rack_pad` +
+  `verify_device_alive` + `verify_all_devices_health` that were
+  missing since v1.16
+- `docs/manual/tool-catalog.md` — replaced hand-curated drifting
+  version with single auto-generated file (run
+  `python3 scripts/generate_tool_catalog.py > docs/manual/tool-catalog.md`).
+  Retired `docs/manual/tool-catalog-generated.md` (duplicate
+  with -generated suffix)
+- **Deleted**: `docs/TOOL_REFERENCE.md` (v1.7-era, 317 tools /
+  43 domains — misleadingly stale)
+- **Archived**: `docs/manual/release-smoke-board.md` → `docs/archive/release-smoke-board-v1.10-era.md`
+
+### Internal
+
+- `mcp_server/splice_client/graphql_queries/` — new directory,
+  holds captured `.graphql` query strings, loaded lazily via
+  `_load_graphql_query()` with caching
+- `docs/research/splice-api-capture/` — gitignored local archive
+  of 4 operation captures (request + response pairs):
+  `SamplesSearch`, `SoundsSearchAutocomplete`,
+  `RefreshSamplePreview`, `AssetSimilarSoundsQuery`
+- 5 additional GraphQL operations captured but not wired —
+  candidates for future tools: `DesktopPackSearch`,
+  `SampleAssetSidebarQuery`, `BrowseCarousels`,
+  `CreditsStoreQuery`, `UserService`
+
+### Known non-blockers
+
+- Splice Search-with-Sound (audio-file reference search) is
+  retired — feature not exposed in Splice desktop v5.4.9's UI,
+  user handles it manually. Recipe preserved if a future Splice
+  build re-exposes it.
+- T5 live end-to-end verification in a real Ableton session
+  deferred — contract tests (17) lock the protocol; first real
+  invocation will confirm Live LOM assumptions (classic
+  v1.16.0 → v1.16.1 pattern — any surprises fix in one edit).
+- `splice_http_diagnose` token-availability probe reported a
+  false negative pre-1.17 (walked the wrong context path); fixed
+  to use `ctx.lifespan_context["splice_client"]` + actually call
+  `fetch_session_token`.
+
+
 ## 1.16.1 — Post-publish live-verification bug sweep (April 22 2026)
 
 Three rounds of live verification after 1.16.0 shipped caught five

package/README.md

@@ -17,7 +17,7 @@
 
 <p align="center">
   An agentic production system for Ableton Live 12.<br>
-  422 tools. 52 domains. Device atlas. Plan-aware Splice integration. Auto-composition. Spectral perception. Technique memory. Drum-rack pad builder. Live dead-device detection.
+  426 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>
@@ -33,16 +33,17 @@
 
 ## What LivePilot Does
 
-Most MCP servers are tool collections — they execute commands. LivePilot is an **agentic production system**. It has six layers that work together:
+Most MCP servers are tool collections — they execute commands. LivePilot is an **agentic production system**. It has seven layers that work together:
 
 | 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. 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 |
+| **Device Atlas** | Knowledge of every device in Ableton's library — 1305 devices indexed by name, URI, category, tag, genre, and pack (641 pack-indexed). 120 enriched with sonic intelligence (47 with aesthetic-tagged `signature_techniques`). 683 drum kits mapped. **Free-text `atlas_describe_chain`** ("a granular pad like Tim Hecker") and **reverse-lookup `atlas_techniques_for_device`** (what techniques reference this device?) added in v1.17 |
+| **Concept Surface** | **New in v1.17.** Two reference files let the LLM's training translate into LivePilot: `artist-vocabularies.md` maps ~25 producers (Villalobos, Hawtin, Basic Channel, Gas, Basinski, Hecker, Aphex, Autechre, Dilla, Burial, Henke, Daft Punk, …) to `reach_for` / `avoid` / `key_techniques`; `genre-vocabularies.md` maps 15 genres to tempo / kick / bass / percussion / harmonic / texture / devices. 146 cross-references between devices and techniques. The LLM reads "sound like Gas" and gets a concrete device chain, not guesswork |
+| **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, **LIVE Describe-a-Sound + Variations via Splice GraphQL (v1.17)** |
+| **Spectral Perception** | Real-time ears via M4L — **9-band FFT (v1.17+, sub_low split at 20-60 Hz)**, RMS/peak metering, Krumhansl-Schmuckler key detection, pitch tracking, FluCoMa mel/chroma/onset. 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 |
+| **Creative Intelligence** | A dozen engines that understand song identity, learn your taste, diagnose stuck sessions, generate creative options, and evaluate results before claiming success |
 
 <br>
 
@@ -56,9 +57,9 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 │  KNOWLEDGE               PERCEPTION              MEMORY              │
 │  ──────────────          ──────────────          ──────────────       │
 │                                                                      │
-│  Device Atlas            8-band FFT              recall by mood,     │
+│  Device Atlas            9-band FFT              recall by mood,     │
 │  1305 devices            RMS / peak              genre, texture      │
-│  107 enriched             pitch tracking          29 techniques       │
+│  120 enriched             pitch tracking          29 techniques       │
 │  683 drum kits           key detection           replay into session │
 │                                                                      │
 │  Sample Engine           Corpus Intelligence     Taste Graph          │
@@ -79,7 +80,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 │         └─────────────────┼──────────────────┘                       │
 │                           ▼                                          │
 │                  ┌─────────────────┐                                  │
-│                  │   422 MCP Tools  │                                  │
+│                  │   426 MCP Tools  │                                  │
 │                  │   52 domains     │                                  │
 │                  └────────┬────────┘                                  │
 │                           │                                          │
@@ -102,7 +103,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, 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.
+**Device Atlas** (`mcp_server/atlas/`) — In-memory indexed JSON database. 1305 devices with browser URIs, 120 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 +121,7 @@ Most MCP servers are tool collections — they execute commands. LivePilot is an
 
 ## The Intelligence Layer
 
-12 engines sit on top of the 422 tools. They give the AI musical judgment, not just musical execution.
+12 engines sit on top of the 426 tools. They give the AI musical judgment, not just musical execution.
 
 ### SongBrain — What the Song Is
 
@@ -172,7 +173,7 @@ Every engine follows: **measure before → act → measure after → compare**.
 
 ## Tools
 
-422 tools across 52 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
+426 tools across 52 domains. Highlights below — [full catalog here](docs/manual/tool-catalog.md).
 
 <br>
 
@@ -232,7 +233,7 @@ The atlas is an in-memory indexed database of Ableton's entire device library.
 
 ```
 1305 devices total
-  107 enriched with sonic intelligence (mood, genre, texture, chains)
+  120 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 +361,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 422 tools →](docs/manual/tool-catalog.md)**
+> **[View all 426 tools →](docs/manual/tool-catalog.md)**
 
 <br>
 
@@ -587,7 +588,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for architecture details, code guidelines
 
 | Document | What's inside |
 |----------|---------------|
-| [Manual](docs/manual/index.md) | Complete reference: architecture, all 422 tools, workflows |
+| [Manual](docs/manual/index.md) | Complete reference: architecture, all 426 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.16.1"
+__version__ = "1.17.0"

package/mcp_server/atlas/__init__.py

@@ -28,6 +28,7 @@ class AtlasManager:
         self._by_category: Dict[str, List[Dict[str, Any]]] = {}
         self._by_tag: Dict[str, List[Dict[str, Any]]] = {}
         self._by_genre: Dict[str, List[Dict[str, Any]]] = {}
+        self._by_pack: Dict[str, List[Dict[str, Any]]] = {}
 
         for dev in self._devices:
             dev_id = dev.get("id", "")
@@ -55,6 +56,30 @@ class AtlasManager:
                 self._by_genre.setdefault(genre.lower(), []).append(dev)
             for genre in dev.get("genres", {}).get("secondary", []):
                 self._by_genre.setdefault(genre.lower(), []).append(dev)
+            # Also read the enriched genre_affinity field, which is where
+            # curated YAML entries land after merge (scanners emit `genres`,
+            # enrichments emit `genre_affinity` — both must feed the index
+            # or new minimal/microhouse/dub_techno tags would never surface).
+            aff = dev.get("genre_affinity", {}) or {}
+            for genre in aff.get("primary", []) if isinstance(aff, dict) else []:
+                self._by_genre.setdefault(str(genre).lower(), []).append(dev)
+            for genre in aff.get("secondary", []) if isinstance(aff, dict) else []:
+                self._by_genre.setdefault(str(genre).lower(), []).append(dev)
+
+            # Pack index — enriched devices declare `pack:` in YAML. Native
+            # Live devices without an explicit pack default to "Core Library"
+            # so the index covers everything shipped with the stock install.
+            pack_name = dev.get("pack")
+            if not pack_name and dev.get("source") in (None, "native", "browser"):
+                # Heuristic: if we have no explicit pack and the scan source
+                # is the built-in browser, treat as Core Library. Don't fake
+                # a pack for plugins/user samples where the source isn't the
+                # stock library.
+                if dev_category in ("instruments", "audio_effects",
+                                    "midi_effects", "max_for_live"):
+                    pack_name = "Core Library"
+            if pack_name:
+                self._by_pack.setdefault(pack_name, []).append(dev)
 
     # ── Properties ──────────────────────────────────────────────────
 
@@ -83,9 +108,69 @@ class AtlasManager:
                 "by_category": len(self._by_category),
                 "by_tag": len(self._by_tag),
                 "by_genre": len(self._by_genre),
+                "by_pack": len(self._by_pack),
             },
         }
 
+    # ── Pack lookup ────────────────────────────────────────────────
+    def pack_info(self, pack_name: str) -> Dict[str, Any]:
+        """Return summary of a pack — device list + enrichment coverage.
+
+        Matches the pack name case-insensitively; the index stores the
+        canonical casing from the YAML (e.g. "Core Library", "Drone Lab").
+        """
+        if not pack_name:
+            return {"pack": "", "device_count": 0, "enriched_count": 0,
+                    "devices": []}
+
+        target = pack_name.strip().lower()
+        # Find canonical name
+        canonical = None
+        for name in self._by_pack.keys():
+            if name.lower() == target:
+                canonical = name
+                break
+
+        if canonical is None:
+            return {
+                "pack": pack_name,
+                "device_count": 0,
+                "enriched_count": 0,
+                "devices": [],
+                "available_packs": sorted(self._by_pack.keys()),
+            }
+
+        devices = self._by_pack[canonical]
+        enriched = [d for d in devices if d.get("enriched")]
+        return {
+            "pack": canonical,
+            "device_count": len(devices),
+            "enriched_count": len(enriched),
+            "devices": [
+                {
+                    "id": d.get("id", ""),
+                    "name": d.get("name", ""),
+                    "category": d.get("category", ""),
+                    "enriched": bool(d.get("enriched")),
+                    "uri": d.get("uri", ""),
+                }
+                for d in devices
+            ],
+        }
+
+    def list_packs(self) -> List[Dict[str, Any]]:
+        """All known packs with device counts, sorted by size descending."""
+        packs = [
+            {
+                "name": name,
+                "device_count": len(devs),
+                "enriched_count": sum(1 for d in devs if d.get("enriched")),
+            }
+            for name, devs in self._by_pack.items()
+        ]
+        packs.sort(key=lambda p: -p["device_count"])
+        return packs
+
     # ── Lookup ──────────────────────────────────────────────────────
 
     def lookup(self, name_or_id: str) -> Optional[Dict[str, Any]]: