Music Pipeline Refactor

README.md

@@ -61,8 +61,17 @@ paths:
   build: build
 
 music:
+  # Legacy shorthand — automatically normalized into a dataset.
   prefixes:
     envi/music/westgate: mus_wg_
+
+  # Explicit dataset config (replaces prefixes above).
+  defaults:
+    max_stem_length: 16
+  datasets:
+    westgate:
+      source: envi/music/westgate
+      prefix: mus_wg_
 ```
 
 Resolved configuration can be inspected without scanning or building:
@@ -151,6 +160,21 @@ autogen:
     repo_env: SOW_ASSETS_REPO
 ```
 
+Music defaults (used when not explicitly configured):
+
+```yaml
+music:
+  defaults:
+    stage_root: "{paths.cache}/music"
+    credits_root: "{paths.cache}/credits"
+    credits_overlay: CREDITS.md
+    max_stem_length: 16
+```
+
+Music datasets define individual music collections with independent sources and
+naming prefixes. The legacy `music.prefixes` shorthand is automatically normalized
+into a dataset.
+
 Generated and machine-readable artifacts remain JSON, including HAK manifests,
 topdata datasets, caches, credits inventories, build reports, and canonical GFF
 documents. Nested metadata such as `topdata/templates/config.json` is not root