@wildshard/sdk 0.0.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (687) hide show
  1. package/GUIDE.md +790 -0
  2. package/README.md +13 -5
  3. package/bin/wildshard.mjs +38 -0
  4. package/lint/declaration-config.d.mts +2 -0
  5. package/lint/declaration-config.mjs +19 -0
  6. package/lint/engine-plugin.d.mts +2 -0
  7. package/lint/engine-plugin.mjs +40 -0
  8. package/lint/host-callbacks.d.mts +6 -0
  9. package/lint/host-callbacks.mjs +123 -0
  10. package/lint/host-files.d.mts +1 -0
  11. package/lint/host-files.mjs +7 -0
  12. package/lint/layer-exports.d.mts +2 -0
  13. package/lint/layer-exports.mjs +21 -0
  14. package/lint/legacy-line-basis.json +995 -0
  15. package/lint/nine-tiling-baseline.json +35 -0
  16. package/lint/ratchet.json +11 -0
  17. package/lint/runtime-files.d.mts +12 -0
  18. package/lint/runtime-files.json +16 -0
  19. package/lint/runtime-files.mjs +69 -0
  20. package/lint/runtime-performance.d.mts +6 -0
  21. package/lint/runtime-performance.mjs +184 -0
  22. package/lint/sdk-plugin.d.mts +4 -0
  23. package/lint/sdk-plugin.mjs +134 -0
  24. package/lint/shardfile-boundaries.d.mts +10 -0
  25. package/lint/shardfile-boundaries.mjs +122 -0
  26. package/lint/tile-bake-debt.json +556 -0
  27. package/package.json +365 -3
  28. package/scripts/agent-parity.mjs +1524 -0
  29. package/scripts/agent-sync.mjs +518 -0
  30. package/scripts/apfs-clone.mjs +67 -0
  31. package/scripts/assert-store-layout.mjs +23 -0
  32. package/scripts/astc6-phone-cap.d.mts +3 -0
  33. package/scripts/astc6-phone-cap.mjs +137 -0
  34. package/scripts/audit-assets.d.mts +10 -0
  35. package/scripts/audit-assets.mjs +151 -0
  36. package/scripts/bake/coatFiles.d.mts +6 -0
  37. package/scripts/bake/coatFiles.mjs +37 -0
  38. package/scripts/bake/environment.d.mts +2 -0
  39. package/scripts/bake/environment.mjs +58 -0
  40. package/scripts/bake/far-proxies.mjs +45 -0
  41. package/scripts/bake/keyed-sky.d.mts +4 -0
  42. package/scripts/bake/keyed-sky.mjs +34 -0
  43. package/scripts/bake/movers.mjs +56 -0
  44. package/scripts/bake/nativeWorld.d.mts +6 -0
  45. package/scripts/bake/nativeWorld.mjs +43 -0
  46. package/scripts/bake/navmeshGround.ts +22 -0
  47. package/scripts/bake/near-placeholder.mjs +331 -0
  48. package/scripts/bake/placeholderShards.mjs +41 -0
  49. package/scripts/bake/skins.mjs +15 -0
  50. package/scripts/bake/template-skins.mjs +33 -0
  51. package/scripts/bake/viewmodelBytes.ts +26 -0
  52. package/scripts/bake/viewmodelPage.ts +11 -0
  53. package/scripts/bake/worldHost.d.mts +35 -0
  54. package/scripts/bake/worldHost.mjs +110 -0
  55. package/scripts/bake-astc6.cache.json +80 -0
  56. package/scripts/bake-astc6.far-reach.cache.json +23 -0
  57. package/scripts/bake-astc6.list.json +111 -0
  58. package/scripts/bake-astc6.mjs +279 -0
  59. package/scripts/bake-astc6.nalati-grasslands.cache.json +42 -0
  60. package/scripts/bake-catalogue.mjs +44 -0
  61. package/scripts/bake-check.mjs +54 -0
  62. package/scripts/bake-chunk.mjs +124 -0
  63. package/scripts/bake-cloud-field.mjs +24 -0
  64. package/scripts/bake-coats.mjs +110 -0
  65. package/scripts/bake-data-maps.d.mts +24 -0
  66. package/scripts/bake-data-maps.mjs +72 -0
  67. package/scripts/bake-entry-programs.mjs +117 -0
  68. package/scripts/bake-geometry.mjs +106 -0
  69. package/scripts/bake-hybrid-tiles.mjs +28 -0
  70. package/scripts/bake-ktx2.cache.json +276 -0
  71. package/scripts/bake-ktx2.list.json +365 -0
  72. package/scripts/bake-ktx2.mjs +477 -0
  73. package/scripts/bake-map-glb.mjs +127 -0
  74. package/scripts/bake-map-rest.d.mts +7 -0
  75. package/scripts/bake-map-rest.mjs +50 -0
  76. package/scripts/bake-maps.mjs +200 -0
  77. package/scripts/bake-navmesh.mjs +259 -0
  78. package/scripts/bake-packs.mjs +129 -0
  79. package/scripts/bake-pickups.mjs +102 -0
  80. package/scripts/bake-query-terrain.mjs +64 -0
  81. package/scripts/bake-recurve-pool.mjs +16 -0
  82. package/scripts/bake-section-schemas.d.mts +3 -0
  83. package/scripts/bake-template-shardfile.mjs +32 -0
  84. package/scripts/bake-textures.mjs +80 -0
  85. package/scripts/bake-viewmodel-sets.json +45 -0
  86. package/scripts/bake-viewmodel-sets.mjs +137 -0
  87. package/scripts/bake-voxel-ao.mjs +119 -0
  88. package/scripts/bake-water-ripples.mjs +25 -0
  89. package/scripts/blender/README.md +129 -0
  90. package/scripts/blender/build.sh +166 -0
  91. package/scripts/blender/lib/export-scene.mjs +129 -0
  92. package/scripts/blender/lib/glb-digest.mjs +188 -0
  93. package/scripts/blender/lib/glb.py +68 -0
  94. package/scripts/blender/lib/save_blend.py +17 -0
  95. package/scripts/blender/lib/world_fixture.py +55 -0
  96. package/scripts/blender/targets.json +591 -0
  97. package/scripts/build-sdk.mjs +95 -0
  98. package/scripts/build-shardfiles.d.mts +7 -0
  99. package/scripts/build-shardfiles.mjs +206 -0
  100. package/scripts/capture-hero.mjs +137 -0
  101. package/scripts/check-lift-review.mjs +23 -0
  102. package/scripts/chromium-keychain-check.mjs +139 -0
  103. package/scripts/chromium-keychain.d.mts +1 -0
  104. package/scripts/chromium-keychain.mjs +5 -0
  105. package/scripts/compile-script.d.mts +3 -0
  106. package/scripts/compile-script.mjs +8 -0
  107. package/scripts/creature-color.mjs +255 -0
  108. package/scripts/decide/calibrate.py +127 -0
  109. package/scripts/decide/calibration/2026-10-03/labels-s1.tsv +281 -0
  110. package/scripts/decide/calibration/2026-10-03/labels-s2.tsv +97 -0
  111. package/scripts/decide/calibration/2026-10-03/labels-s3.tsv +48 -0
  112. package/scripts/decide/calibration/2026-10-03/labels-s3b.tsv +26 -0
  113. package/scripts/decide/calibration/2026-10-03/res-capture-status-v1.jsonl +376 -0
  114. package/scripts/decide/calibration/2026-10-03/res-text-garbled-strings.jsonl +48 -0
  115. package/scripts/decide/calibration/2026-10-03/res-text-garbled-v1.jsonl +73 -0
  116. package/scripts/decide/decide.py +262 -0
  117. package/scripts/decide/decide.sh +50 -0
  118. package/scripts/decide/layer-purity-pilot.mjs +41 -0
  119. package/scripts/decide/sets/capture-status.json +46 -0
  120. package/scripts/decide/sets/layer-purity.json +28 -0
  121. package/scripts/decide/sets/text-garbled.json +17 -0
  122. package/scripts/decide/test_decide.py +37 -0
  123. package/scripts/docs.mjs +15 -0
  124. package/scripts/entry-reads/crawl.ts +152 -0
  125. package/scripts/entry-reads/tsconfig.json +25 -0
  126. package/scripts/gen-format-schema.d.mts +2 -0
  127. package/scripts/gen-format-schema.mjs +21 -0
  128. package/scripts/gen-host-catalogue.d.mts +14 -0
  129. package/scripts/gen-host-catalogue.mjs +108 -0
  130. package/scripts/gen-shard-layout-doc.d.mts +4 -0
  131. package/scripts/gen-shard-layout-doc.mjs +55 -0
  132. package/scripts/gen-shards.d.mts +17 -0
  133. package/scripts/gen-shards.mjs +311 -0
  134. package/scripts/goldens/capture-inputs.d.mts +4 -0
  135. package/scripts/goldens/capture-inputs.mjs +34 -0
  136. package/scripts/goldens/colour_shift.py +27 -0
  137. package/scripts/goldens/native-residency.d.mts +10 -0
  138. package/scripts/goldens/native-residency.mjs +104 -0
  139. package/scripts/goldens/plot-inputs.d.mts +12 -0
  140. package/scripts/goldens/plot-inputs.mjs +46 -0
  141. package/scripts/gpu-texmem.mjs +98 -0
  142. package/scripts/horizon-matte/config.py +24 -0
  143. package/scripts/horizon-matte/encode.py +91 -0
  144. package/scripts/horizon-matte/key.py +141 -0
  145. package/scripts/horizon-matte/mkjobs.py +33 -0
  146. package/scripts/horizon-matte/mkjobs_day2.py +11 -0
  147. package/scripts/horizon-matte/overlap.py +80 -0
  148. package/scripts/horizon-matte/run_codex.py +57 -0
  149. package/scripts/horizon-matte/stitch.py +133 -0
  150. package/scripts/img2mesh/CC0.md +105 -0
  151. package/scripts/img2mesh/README.md +209 -0
  152. package/scripts/img2mesh/ab_board.py +102 -0
  153. package/scripts/img2mesh/birds/birds.json +255 -0
  154. package/scripts/img2mesh/birds/birds_atlas.py +150 -0
  155. package/scripts/img2mesh/birds/birds_fix_preview.mjs +103 -0
  156. package/scripts/img2mesh/birds/birds_fix_render.py +75 -0
  157. package/scripts/img2mesh/birds/birds_pack.py +110 -0
  158. package/scripts/img2mesh/birds/birds_phone_b.py +112 -0
  159. package/scripts/img2mesh/birds/birds_post.py +550 -0
  160. package/scripts/img2mesh/birds/birds_render.py +125 -0
  161. package/scripts/img2mesh/birds/birds_sheet.py +33 -0
  162. package/scripts/img2mesh/birds/birds_view.py +60 -0
  163. package/scripts/img2mesh/board.py +100 -0
  164. package/scripts/img2mesh/build_cc0.sh +52 -0
  165. package/scripts/img2mesh/build_driftwood.sh +12 -0
  166. package/scripts/img2mesh/build_faces.sh +53 -0
  167. package/scripts/img2mesh/build_props.py +81 -0
  168. package/scripts/img2mesh/cc0_export.py +186 -0
  169. package/scripts/img2mesh/driftwood_post.py +571 -0
  170. package/scripts/img2mesh/e304_faces.sh +67 -0
  171. package/scripts/img2mesh/face_remaster.py +911 -0
  172. package/scripts/img2mesh/face_views.py +95 -0
  173. package/scripts/img2mesh/faces-e304.json +9 -0
  174. package/scripts/img2mesh/faces.json +30 -0
  175. package/scripts/img2mesh/head_cut.py +100 -0
  176. package/scripts/img2mesh/hi3d_paint.py +94 -0
  177. package/scripts/img2mesh/hi3d_refine.py +161 -0
  178. package/scripts/img2mesh/hunyuan_cpu_rasterizer.sh +42 -0
  179. package/scripts/img2mesh/pine_hollow_phone.sh +13 -0
  180. package/scripts/img2mesh/props/coral-arch.json +32 -0
  181. package/scripts/img2mesh/props/ember-furnace.json +30 -0
  182. package/scripts/img2mesh/props/night-market-gate.json +10 -0
  183. package/scripts/img2mesh/render_still.py +86 -0
  184. package/scripts/img2mesh/rig_strip.mjs +46 -0
  185. package/scripts/img2mesh/rig_transfer.mjs +104 -0
  186. package/scripts/img2mesh/split_sheet.py +48 -0
  187. package/scripts/img2mesh/trellis_batch.py +110 -0
  188. package/scripts/img2mesh/versus_board.py +114 -0
  189. package/scripts/import-bundle.d.mts +2 -0
  190. package/scripts/import-bundle.mjs +20 -0
  191. package/scripts/ktx2-ab-board.py +133 -0
  192. package/scripts/ktx2-ab.mjs +111 -0
  193. package/scripts/ktx2-settings.mjs +18 -0
  194. package/scripts/land.d.mts +14 -0
  195. package/scripts/land.mjs +809 -0
  196. package/scripts/lint-dispatch.mjs +14 -0
  197. package/scripts/map-bake-frames.d.mts +4 -0
  198. package/scripts/map-bake-frames.mjs +23 -0
  199. package/scripts/map-geometry.d.mts +9 -0
  200. package/scripts/map-geometry.mjs +29 -0
  201. package/scripts/map-world.mjs +162 -0
  202. package/scripts/mockup-local.sh +46 -0
  203. package/scripts/music/export-midi.mjs +68 -0
  204. package/scripts/music/gen/analyze.py +308 -0
  205. package/scripts/music/gen/audio_jobs.py +46 -0
  206. package/scripts/music/gen/briefs.json +51 -0
  207. package/scripts/music/gen/build_page.py +334 -0
  208. package/scripts/music/gen/folk.json +3187 -0
  209. package/scripts/music/gen/gen_ace_step.py +156 -0
  210. package/scripts/music/gen/gen_heartmula.py +187 -0
  211. package/scripts/music/gen/gen_minimax.py +143 -0
  212. package/scripts/music/gen/gen_sao.py +122 -0
  213. package/scripts/music/gen/gen_sao_small.py +104 -0
  214. package/scripts/music/gen/gen_sfx.py +98 -0
  215. package/scripts/music/gen/gen_sfx_ezaudio.py +112 -0
  216. package/scripts/music/gen/gen_sfx_moss.py +112 -0
  217. package/scripts/music/gen/models.json +61 -0
  218. package/scripts/music/gen/nalati-jobs.json +104 -0
  219. package/scripts/music/gen/nalati-score-build.json +119 -0
  220. package/scripts/music/gen/nalati-score.json +3448 -0
  221. package/scripts/music/gen/ob7-fit-decisions.json +38 -0
  222. package/scripts/music/gen/ob7-score-jobs.json +152 -0
  223. package/scripts/music/gen/ob7-sfx-jobs.json +897 -0
  224. package/scripts/music/gen/ob7_build.py +469 -0
  225. package/scripts/music/gen/ob7_generate.py +67 -0
  226. package/scripts/music/gen/ob7_run.sh +42 -0
  227. package/scripts/music/gen/orchestral.json +3187 -0
  228. package/scripts/music/gen/own_score.py +486 -0
  229. package/scripts/music/gen/ph-jobs.json +27 -0
  230. package/scripts/music/gen/ph_page.py +222 -0
  231. package/scripts/music/gen/piano.json +3175 -0
  232. package/scripts/music/gen/rank_v3.py +248 -0
  233. package/scripts/music/gen/sfx-best.json +2486 -0
  234. package/scripts/music/gen/sfx-ezaudio.json +4082 -0
  235. package/scripts/music/gen/sfx-jobs.json +57 -0
  236. package/scripts/music/gen/sfx-minimax-jobs.json +16 -0
  237. package/scripts/music/gen/sfx-minimax.json +289 -0
  238. package/scripts/music/gen/sfx-moss.json +4082 -0
  239. package/scripts/music/gen/sfx-nalati-b3-jobs.json +17 -0
  240. package/scripts/music/gen/sfx-nalati-jobs.json +338 -0
  241. package/scripts/music/gen/sfx-nalati.json +11202 -0
  242. package/scripts/music/gen/sfx-nd-jobs.json +57 -0
  243. package/scripts/music/gen/sfx-nd-moss.json +2097 -0
  244. package/scripts/music/gen/sfx-nd-sa3-medium.json +2097 -0
  245. package/scripts/music/gen/sfx-nd-summary.json +38 -0
  246. package/scripts/music/gen/sfx-peaks.json +7 -0
  247. package/scripts/music/gen/sfx-ph-jobs.json +169 -0
  248. package/scripts/music/gen/sfx-ph-moss.json +6564 -0
  249. package/scripts/music/gen/sfx-ph-sa3-medium.json +7239 -0
  250. package/scripts/music/gen/sfx-ph-summary.json +63 -0
  251. package/scripts/music/gen/sfx-sa3-medium.json +4082 -0
  252. package/scripts/music/gen/sfx-sa3.json +4082 -0
  253. package/scripts/music/gen/sfx-summary.json +107 -0
  254. package/scripts/music/gen/sfx_build.py +332 -0
  255. package/scripts/music/gen/sfx_merge.py +255 -0
  256. package/scripts/music/gen/sfx_minimax.py +61 -0
  257. package/scripts/music/gen/sfx_nalati.py +331 -0
  258. package/scripts/music/gen/sfx_sprite.py +424 -0
  259. package/scripts/music/gen/stems.py +539 -0
  260. package/scripts/music/gen/test_loop_meter.py +29 -0
  261. package/scripts/music/gen/test_ob7_provenance.py +77 -0
  262. package/scripts/music/gen/v3-folk-build.json +148 -0
  263. package/scripts/music/gen/v3-folk.json +1818 -0
  264. package/scripts/music/gen/v3-jobs.json +145 -0
  265. package/scripts/music/gen/v3-orchestral-build.json +148 -0
  266. package/scripts/music/gen/v3-orchestral.json +1813 -0
  267. package/scripts/music/gen/v3-ph-folk-build.json +94 -0
  268. package/scripts/music/gen/v3-ph-folk.json +1806 -0
  269. package/scripts/music/gen/v3-ph-orchestral-build.json +94 -0
  270. package/scripts/music/gen/v3-ph-orchestral.json +1824 -0
  271. package/scripts/music/gen/v3-ph-piano-build.json +94 -0
  272. package/scripts/music/gen/v3-ph-piano.json +1818 -0
  273. package/scripts/music/gen/v3-piano-build.json +148 -0
  274. package/scripts/music/gen/v3-piano.json +1813 -0
  275. package/scripts/music/wildshard-theme.mid +0 -0
  276. package/scripts/music/wildshard-trailer30.mid +0 -0
  277. package/scripts/named-blob-output.d.mts +8 -0
  278. package/scripts/named-blob-output.mjs +48 -0
  279. package/scripts/pack-all.mjs +15 -0
  280. package/scripts/pid-lock.d.mts +1 -0
  281. package/scripts/pid-lock.mjs +63 -0
  282. package/scripts/practice/bake_dummy.py +53 -0
  283. package/scripts/practice/build_dummies.sh +43 -0
  284. package/scripts/practice/dummy_parts.py +568 -0
  285. package/scripts/practice/dummy_rig_gate.py +139 -0
  286. package/scripts/practice/gate_sheet.py +36 -0
  287. package/scripts/practice/generate_dummy_unimate.py +132 -0
  288. package/scripts/practice/pack_dummy.mjs +59 -0
  289. package/scripts/practice/repair_dummy_weights.mjs +68 -0
  290. package/scripts/practice/rig_dummy.py +828 -0
  291. package/scripts/practice/verify_unimate_skin.mjs +356 -0
  292. package/scripts/preparation-seed.mjs +15 -0
  293. package/scripts/prepare-basis-tool.mjs +6 -0
  294. package/scripts/prepare-product.d.mts +14 -0
  295. package/scripts/prepare-product.mjs +101 -0
  296. package/scripts/product-build-tools.d.mts +3 -0
  297. package/scripts/product-build-tools.json +3 -0
  298. package/scripts/product-build-tools.mjs +31 -0
  299. package/scripts/publish-public.mjs +7 -0
  300. package/scripts/push-tables.d.mts +1 -0
  301. package/scripts/push-tables.mjs +28 -0
  302. package/scripts/record-shard-mounts.mjs +133 -0
  303. package/scripts/sdk-externals.d.mts +2 -0
  304. package/scripts/sdk-externals.mjs +2 -0
  305. package/scripts/section-inventory.ts +209 -0
  306. package/scripts/select-candidate.mjs +15 -0
  307. package/scripts/shard-build-pool.d.mts +4 -0
  308. package/scripts/shard-build-pool.mjs +53 -0
  309. package/scripts/shard-line-baseline.json +17 -0
  310. package/scripts/shard-milestones.d.mts +15 -0
  311. package/scripts/shard-milestones.mjs +105 -0
  312. package/scripts/shard-output-report.d.mts +9 -0
  313. package/scripts/shard-output-report.mjs +85 -0
  314. package/scripts/shard-platform-cli.mjs +93 -0
  315. package/scripts/shard-progress.mjs +212 -0
  316. package/scripts/shard-timelapse.py +102 -0
  317. package/scripts/shardfile-cold-boot.mjs +79 -0
  318. package/scripts/shardfile-vite.d.mts +4 -0
  319. package/scripts/shardfile-vite.mjs +20 -0
  320. package/scripts/simplify-models.mjs +24 -0
  321. package/scripts/site-facts.mjs +88 -0
  322. package/scripts/test-template-gate.mjs +44 -0
  323. package/scripts/test_golden_compare.py +68 -0
  324. package/scripts/tex-tiers.cache.json +181 -0
  325. package/scripts/tex-tiers.mjs +240 -0
  326. package/scripts/texmem-probe.mjs +184 -0
  327. package/scripts/unused-assets.mjs +173 -0
  328. package/scripts/vite-tmp.d.mts +23 -0
  329. package/scripts/vite-tmp.mjs +157 -0
  330. package/scripts/wave-line-baselines.json +32 -0
  331. package/scripts/wildshard.d.mts +4 -0
  332. package/scripts/wildshard.mjs +105 -0
  333. package/scripts/witness-checkpoints.d.mts +10 -0
  334. package/scripts/witness-checkpoints.mjs +84 -0
  335. package/scripts/witness-generation.d.mts +10 -0
  336. package/scripts/witness-generation.mjs +45 -0
  337. package/scripts/witness-manifests.d.mts +8 -0
  338. package/scripts/witness-manifests.mjs +157 -0
  339. package/scripts/worktree-ignore.d.mts +4 -0
  340. package/scripts/worktree-ignore.mjs +36 -0
  341. package/scripts/worktree-reap.mjs +214 -0
  342. package/scripts/worktree.mjs +396 -0
  343. package/scripts/worldclaw/capture-front.sh +28 -0
  344. package/scripts/worldclaw/design-template.md +62 -0
  345. package/scripts/worldclaw/spec-map.py +92 -0
  346. package/scripts/worldclaw/spec.ts +96 -0
  347. package/skills/wildshard/SKILL.md +50 -0
  348. package/skills/wildshard-goldens/SKILL.md +54 -0
  349. package/skills/wildshard-mockup-to-model/SKILL.md +56 -0
  350. package/skills/wildshard-upgrade/SKILL.md +46 -0
  351. package/src/.oxfmtrc.json +50 -0
  352. package/src/.oxlintrc.json +173 -0
  353. package/src/cli/account/account.ts +199 -0
  354. package/src/cli/account/command.ts +193 -0
  355. package/src/cli/account/key.ts +154 -0
  356. package/src/cli/args.ts +97 -0
  357. package/src/cli/audio/audio.ts +24 -0
  358. package/src/cli/bin.mjs +8 -0
  359. package/src/cli/delete/delete.ts +258 -0
  360. package/src/cli/help.ts +196 -0
  361. package/src/cli/hero/adopt.ts +103 -0
  362. package/src/cli/hero/hero.ts +112 -0
  363. package/src/cli/hero/stamp.ts +298 -0
  364. package/src/cli/main.ts +292 -0
  365. package/src/cli/report.ts +16 -0
  366. package/src/cli/shardfile/command.ts +50 -0
  367. package/src/cli/shardfile/shardfile.ts +192 -0
  368. package/src/cli/upload/api.ts +246 -0
  369. package/src/cli/upload/compress.ts +55 -0
  370. package/src/cli/upload/hero.ts +62 -0
  371. package/src/cli/upload/placement.ts +115 -0
  372. package/src/cli/upload/provenance.ts +192 -0
  373. package/src/cli/upload/signature.ts +30 -0
  374. package/src/cli/upload/upload.ts +269 -0
  375. package/src/cli/upload/validate.ts +74 -0
  376. package/src/cli/upload/wire.ts +147 -0
  377. package/src/cli/version.ts +63 -0
  378. package/src/commons/bake/portableMath.ts +187 -0
  379. package/src/commons/catalogue.ts +10 -0
  380. package/src/commons/courseProgram.ts +32 -0
  381. package/src/commons/practiceCourse.ts +16 -0
  382. package/src/commons/scripts/abi.as +14 -0
  383. package/src/commons/scripts/bridge.as +14 -0
  384. package/src/commons/scripts/course.as +63 -0
  385. package/src/scripts/ask-new.sh +29 -0
  386. package/src/scripts/asks.mjs +141 -0
  387. package/src/scripts/herdr-prompt.sh +34 -0
  388. package/src/scripts/herdr-question-open.sh +67 -0
  389. package/src/scripts/md-wrap.mjs +229 -0
  390. package/src/server/app.ts +19 -0
  391. package/src/server/serve.ts +49 -0
  392. package/src/sharddev/admission.ts +7 -0
  393. package/src/sharddev/arenaView.ts +15 -0
  394. package/src/sharddev/as/groupBankV2.ts +36 -0
  395. package/src/sharddev/as/groupStepV2.ts +13 -0
  396. package/src/sharddev/as/ws.ts +30 -0
  397. package/src/sharddev/as/wsV2.ts +180 -0
  398. package/src/sharddev/assemblyscriptCompiler.d.mts +5 -0
  399. package/src/sharddev/assemblyscriptCompiler.mjs +14 -0
  400. package/src/sharddev/assetHandle.ts +84 -0
  401. package/src/sharddev/assetOwner.ts +70 -0
  402. package/src/sharddev/assetScope.ts +30 -0
  403. package/src/sharddev/assets.ts +21 -0
  404. package/src/sharddev/audio.ts +9 -0
  405. package/src/sharddev/audioEncode.ts +211 -0
  406. package/src/sharddev/author.ts +3 -0
  407. package/src/sharddev/authorError.ts +28 -0
  408. package/src/sharddev/authorManifest.ts +39 -0
  409. package/src/sharddev/bake/annulus.ts +19 -0
  410. package/src/sharddev/bake/assemblyscriptMemo.ts +76 -0
  411. package/src/sharddev/bake/assemblyscriptMemoPort.ts +4 -0
  412. package/src/sharddev/bake/authoredWorld.ts +201 -0
  413. package/src/sharddev/bake/basisEncoder.ts +95 -0
  414. package/src/sharddev/bake/basisGlb.ts +85 -0
  415. package/src/sharddev/bake/basisTool.ts +74 -0
  416. package/src/sharddev/bake/basisToolInputs.ts +476 -0
  417. package/src/sharddev/bake/byteCodec.ts +33 -0
  418. package/src/sharddev/bake/canvasAtlas.ts +406 -0
  419. package/src/sharddev/bake/coarseCopy.ts +59 -0
  420. package/src/sharddev/bake/colliders.ts +87 -0
  421. package/src/sharddev/bake/compactGlb.ts +224 -0
  422. package/src/sharddev/bake/compileScript.ts +119 -0
  423. package/src/sharddev/bake/compileScriptV2.ts +75 -0
  424. package/src/sharddev/bake/contactRows.ts +84 -0
  425. package/src/sharddev/bake/creaturePlacement.ts +117 -0
  426. package/src/sharddev/bake/export.ts +67 -0
  427. package/src/sharddev/bake/facetedGeometry.ts +379 -0
  428. package/src/sharddev/bake/farImpostor.ts +120 -0
  429. package/src/sharddev/bake/forest.ts +100 -0
  430. package/src/sharddev/bake/format-hook.mjs +2 -0
  431. package/src/sharddev/bake/generatorGlb.ts +23 -0
  432. package/src/sharddev/bake/geometryBounds.ts +77 -0
  433. package/src/sharddev/bake/geometryError.ts +48 -0
  434. package/src/sharddev/bake/glb.ts +355 -0
  435. package/src/sharddev/bake/glbCompression.ts +143 -0
  436. package/src/sharddev/bake/gltfSource.ts +59 -0
  437. package/src/sharddev/bake/groundMap.ts +142 -0
  438. package/src/sharddev/bake/image.ts +20 -0
  439. package/src/sharddev/bake/isleMap.ts +64 -0
  440. package/src/sharddev/bake/json.mjs +84 -0
  441. package/src/sharddev/bake/keyedSky.ts +47 -0
  442. package/src/sharddev/bake/keyedSkyMemo.ts +39 -0
  443. package/src/sharddev/bake/kinds.ts +137 -0
  444. package/src/sharddev/bake/lightSources.ts +31 -0
  445. package/src/sharddev/bake/mapAssembly.ts +84 -0
  446. package/src/sharddev/bake/mapRaster.ts +173 -0
  447. package/src/sharddev/bake/mapRest.ts +57 -0
  448. package/src/sharddev/bake/mapScenes.ts +234 -0
  449. package/src/sharddev/bake/materialGraph.ts +32 -0
  450. package/src/sharddev/bake/meadow.ts +27 -0
  451. package/src/sharddev/bake/meshoptChoiceMemo.ts +34 -0
  452. package/src/sharddev/bake/nativeInteractionFacts.ts +5 -0
  453. package/src/sharddev/bake/nativeLattice.ts +178 -0
  454. package/src/sharddev/bake/nativeRaster.ts +106 -0
  455. package/src/sharddev/bake/nativeTerrainField.ts +11 -0
  456. package/src/sharddev/bake/navigation-json.mjs +38 -0
  457. package/src/sharddev/bake/navigation.ts +113 -0
  458. package/src/sharddev/bake/navigationAsset.ts +18 -0
  459. package/src/sharddev/bake/nearPlaceholder.ts +206 -0
  460. package/src/sharddev/bake/normalizeRig.ts +80 -0
  461. package/src/sharddev/bake/phoneAstc.ts +93 -0
  462. package/src/sharddev/bake/placeholders.ts +581 -0
  463. package/src/sharddev/bake/placement.ts +80 -0
  464. package/src/sharddev/bake/portableBytes.ts +18 -0
  465. package/src/sharddev/bake/portableBytesMemo.ts +50 -0
  466. package/src/sharddev/bake/practiceCourse.ts +49 -0
  467. package/src/sharddev/bake/primitives.ts +96 -0
  468. package/src/sharddev/bake/props.ts +443 -0
  469. package/src/sharddev/bake/questPlacement.ts +98 -0
  470. package/src/sharddev/bake/rawTexture.ts +26 -0
  471. package/src/sharddev/bake/riderArms.ts +97 -0
  472. package/src/sharddev/bake/rig.ts +95 -0
  473. package/src/sharddev/bake/riggedHullRecipes.ts +40 -0
  474. package/src/sharddev/bake/signPlacements.ts +25 -0
  475. package/src/sharddev/bake/simplifier.ts +52 -0
  476. package/src/sharddev/bake/skinned.ts +312 -0
  477. package/src/sharddev/bake/slabChunks.ts +149 -0
  478. package/src/sharddev/bake/slabs.ts +263 -0
  479. package/src/sharddev/bake/source-loader.mjs +55 -0
  480. package/src/sharddev/bake/sourceMetadata.ts +54 -0
  481. package/src/sharddev/bake/species.ts +368 -0
  482. package/src/sharddev/bake/specimenCatalogue.ts +47 -0
  483. package/src/sharddev/bake/splatGround.ts +141 -0
  484. package/src/sharddev/bake/staticMaterials.ts +171 -0
  485. package/src/sharddev/bake/terrain.ts +195 -0
  486. package/src/sharddev/bake/texture.ts +33 -0
  487. package/src/sharddev/bake/textureWasm.ts +81 -0
  488. package/src/sharddev/bake/tileEncoder.ts +11 -0
  489. package/src/sharddev/bake/tileGrid.ts +62 -0
  490. package/src/sharddev/bake/v2Finite.ts +160 -0
  491. package/src/sharddev/bake/v2Fuel.ts +71 -0
  492. package/src/sharddev/bake/wholePartition.ts +74 -0
  493. package/src/sharddev/bake/wholePieceJoin.ts +147 -0
  494. package/src/sharddev/bake/world.ts +173 -0
  495. package/src/sharddev/bake/worldCollision.ts +128 -0
  496. package/src/sharddev/bake/worldGeometry.ts +237 -0
  497. package/src/sharddev/bake/worldGlb.ts +123 -0
  498. package/src/sharddev/bake/worldImage.ts +12 -0
  499. package/src/sharddev/bake/worldLod.ts +128 -0
  500. package/src/sharddev/bake/worldRows.ts +102 -0
  501. package/src/sharddev/bake/worldTextureMemo.ts +63 -0
  502. package/src/sharddev/bake/zstdBytesMemo.ts +52 -0
  503. package/src/sharddev/bake.ts +193 -0
  504. package/src/sharddev/bakePublication.ts +31 -0
  505. package/src/sharddev/behaviourSource.ts +94 -0
  506. package/src/sharddev/bin/wildshard.mjs +7 -0
  507. package/src/sharddev/blobBytes.ts +65 -0
  508. package/src/sharddev/blobs.ts +138 -0
  509. package/src/sharddev/bootInventory.ts +129 -0
  510. package/src/sharddev/bossProfiles.ts +18 -0
  511. package/src/sharddev/buildBehaviour.ts +77 -0
  512. package/src/sharddev/buildCacheMetrics.ts +17 -0
  513. package/src/sharddev/buildDecisionScripts.ts +122 -0
  514. package/src/sharddev/check.ts +117 -0
  515. package/src/sharddev/checkProject.ts +126 -0
  516. package/src/sharddev/cli.ts +191 -0
  517. package/src/sharddev/clientChannels.ts +169 -0
  518. package/src/sharddev/clientScripts.ts +10 -0
  519. package/src/sharddev/commons.ts +77 -0
  520. package/src/sharddev/commonsCosts.ts +11 -0
  521. package/src/sharddev/compileMovers.ts +11 -0
  522. package/src/sharddev/configBoundary.ts +6 -0
  523. package/src/sharddev/cookInput.ts +40 -0
  524. package/src/sharddev/crowds.ts +6 -0
  525. package/src/sharddev/decisionBindingMap.ts +11 -0
  526. package/src/sharddev/decisionScriptBindings.ts +117 -0
  527. package/src/sharddev/decisionScripts.ts +28 -0
  528. package/src/sharddev/decisionSource.ts +51 -0
  529. package/src/sharddev/dev.ts +113 -0
  530. package/src/sharddev/director.ts +26 -0
  531. package/src/sharddev/directorAbi.ts +77 -0
  532. package/src/sharddev/discoveryDocument.ts +97 -0
  533. package/src/sharddev/draft.ts +11 -0
  534. package/src/sharddev/eliteEntryRows.ts +29 -0
  535. package/src/sharddev/entries.ts +76 -0
  536. package/src/sharddev/entryReads.ts +73 -0
  537. package/src/sharddev/executeBundle.ts +55 -0
  538. package/src/sharddev/finds.ts +5 -0
  539. package/src/sharddev/formatJsonSchema.ts +3 -0
  540. package/src/sharddev/generationCache.ts +257 -0
  541. package/src/sharddev/generationRecipe.ts +94 -0
  542. package/src/sharddev/handwritten.ts +110 -0
  543. package/src/sharddev/immutable.ts +14 -0
  544. package/src/sharddev/interactions.ts +38 -0
  545. package/src/sharddev/kit/bakedGeometry.ts +16 -0
  546. package/src/sharddev/kit/geometryPack.ts +110 -0
  547. package/src/sharddev/ledger.ts +13 -0
  548. package/src/sharddev/looks/tileField.ts +67 -0
  549. package/src/sharddev/materialGraphFiles.ts +57 -0
  550. package/src/sharddev/materials.ts +574 -0
  551. package/src/sharddev/measure.ts +18 -0
  552. package/src/sharddev/modes.ts +115 -0
  553. package/src/sharddev/moverPrograms.ts +213 -0
  554. package/src/sharddev/movers.ts +75 -0
  555. package/src/sharddev/nativePopulationRows.ts +46 -0
  556. package/src/sharddev/newProject.ts +247 -0
  557. package/src/sharddev/noise.ts +54 -0
  558. package/src/sharddev/outputProduct.ts +188 -0
  559. package/src/sharddev/outputRuntime.ts +66 -0
  560. package/src/sharddev/performancePolicy.ts +18 -0
  561. package/src/sharddev/phasedBoss.ts +34 -0
  562. package/src/sharddev/physics.ts +194 -0
  563. package/src/sharddev/platformSections.ts +42 -0
  564. package/src/sharddev/plumbing.ts +8 -0
  565. package/src/sharddev/productOutput.ts +128 -0
  566. package/src/sharddev/project.ts +337 -0
  567. package/src/sharddev/projectCompilerIdentity.ts +94 -0
  568. package/src/sharddev/projectDecisions.ts +66 -0
  569. package/src/sharddev/projectEntryProof.ts +32 -0
  570. package/src/sharddev/projectGeneration.ts +219 -0
  571. package/src/sharddev/projectInputFiles.ts +47 -0
  572. package/src/sharddev/projectManifest.ts +108 -0
  573. package/src/sharddev/projectMap.ts +35 -0
  574. package/src/sharddev/projectOutput.ts +242 -0
  575. package/src/sharddev/projectPolicy.ts +17 -0
  576. package/src/sharddev/projectSections.ts +27 -0
  577. package/src/sharddev/questGraph.ts +25 -0
  578. package/src/sharddev/quests.ts +65 -0
  579. package/src/sharddev/random.ts +61 -0
  580. package/src/sharddev/refusals.ts +234 -0
  581. package/src/sharddev/reportCard.ts +13 -0
  582. package/src/sharddev/returnProjectionV2.ts +81 -0
  583. package/src/sharddev/rows.ts +192 -0
  584. package/src/sharddev/runtimeImports.ts +38 -0
  585. package/src/sharddev/runtimeMirrors.ts +39 -0
  586. package/src/sharddev/runtimePerformance.ts +38 -0
  587. package/src/sharddev/scene.ts +321 -0
  588. package/src/sharddev/sceneAnimation.ts +54 -0
  589. package/src/sharddev/sceneAudio.ts +64 -0
  590. package/src/sharddev/sceneDeclarations.ts +100 -0
  591. package/src/sharddev/sceneGraph.ts +139 -0
  592. package/src/sharddev/sceneTransform.ts +12 -0
  593. package/src/sharddev/schemaValidation.ts +61 -0
  594. package/src/sharddev/sections.ts +47 -0
  595. package/src/sharddev/shardSource.ts +59 -0
  596. package/src/sharddev/sourceReader.ts +26 -0
  597. package/src/sharddev/spawns.ts +38 -0
  598. package/src/sharddev/species/clips.ts +24 -0
  599. package/src/sharddev/species.ts +29 -0
  600. package/src/sharddev/speciesBrains.ts +19 -0
  601. package/src/sharddev/synth.ts +66 -0
  602. package/src/sharddev/test/compileDualScriptV2.ts +71 -0
  603. package/src/sharddev/test/compileSimV2.ts +21 -0
  604. package/src/sharddev/test/diskScriptScenario.ts +86 -0
  605. package/src/sharddev/test/scriptScenario.ts +249 -0
  606. package/src/sharddev/test/scriptSource.ts +12 -0
  607. package/src/sharddev/version.ts +4 -0
  608. package/src/sharddev/weapons/bowProfile.ts +20 -0
  609. package/src/sharddev/weapons/firearmRows.ts +11 -0
  610. package/src/sharddev/weapons/meleeProfile.ts +71 -0
  611. package/src/sharddev/weapons/thrownProfile.ts +10 -0
  612. package/src/sharddev/worldScenes.ts +308 -0
  613. package/src/sharddev/worldSource.ts +82 -0
  614. package/src/shards/_template/README.md +78 -0
  615. package/src/shards/_template/assets/2bf489fdb15f1734ddb4c4f32d500ec6da85c765ec7a4eb28dc6781160e7ec8c +0 -0
  616. package/src/shards/_template/assets/97ec4d8f75f5fa6239ee919444d6dc19fd35896bb305930c1f050ac6e0e0e6a6 +1 -0
  617. package/src/shards/_template/assets/a6a587a31327f936b1b04c05ade818c73fc8964260918662db43539465e27586 +0 -0
  618. package/src/shards/_template/assets/b4fbde0422e125b498c3dc8b9a5cc2516c8598f09e9d0e5f6b639b32f98179e6 +0 -0
  619. package/src/shards/_template/assets/bfa4dfc9c18979f904557ee8deab0058b8a399be10266f5fb1578b403f482fd4 +1 -0
  620. package/src/shards/_template/assets/ef3b7ff4fd22715771cb7d68a3977a903c5e7c3dc293542687d04b3ef3ace2cb +0 -0
  621. package/src/shards/_template/assets/f2db05998615ce1cb79ea96be32c168842eb6a2b34ec01feb86d36404603ee54 +0 -0
  622. package/src/shards/_template/assets/fef98ebb7fce6f66b26e78ac699e5c90f9bdcfaf8cabeb2b58125347eea8b4ab +0 -0
  623. package/src/shards/_template/behaviour/boss.as +39 -0
  624. package/src/shards/_template/behaviour/door.as +32 -0
  625. package/src/shards/_template/behaviour/hooks.json +129 -0
  626. package/src/shards/_template/behaviour/idle.as +75 -0
  627. package/src/shards/_template/behaviour/items.as +22 -0
  628. package/src/shards/_template/card/landscape.jpg +0 -0
  629. package/src/shards/_template/card/portrait.jpg +0 -0
  630. package/src/shards/_template/card/thumb.jpg +0 -0
  631. package/src/shards/_template/data/audio.json +45 -0
  632. package/src/shards/_template/data/bossDecision.json +83 -0
  633. package/src/shards/_template/data/budgets.json +70 -0
  634. package/src/shards/_template/data/card.json +281 -0
  635. package/src/shards/_template/data/clientScripts.json +987 -0
  636. package/src/shards/_template/data/creatures.json +65 -0
  637. package/src/shards/_template/data/director.json +39 -0
  638. package/src/shards/_template/data/encounters.json +96 -0
  639. package/src/shards/_template/data/items.json +172 -0
  640. package/src/shards/_template/data/layout.json +66 -0
  641. package/src/shards/_template/data/ledger.json +32 -0
  642. package/src/shards/_template/data/look.json +521 -0
  643. package/src/shards/_template/data/map.json +64 -0
  644. package/src/shards/_template/data/moves.json +16 -0
  645. package/src/shards/_template/data/placeholder.json +8 -0
  646. package/src/shards/_template/data/plumbing.json +32 -0
  647. package/src/shards/_template/data/quests.json +223 -0
  648. package/src/shards/_template/data/rows.json +423 -0
  649. package/src/shards/_template/data/skins.json +66 -0
  650. package/src/shards/_template/data/spawn.json +6 -0
  651. package/src/shards/_template/data/targets.json +150 -0
  652. package/src/shards/_template/data/text.json +12 -0
  653. package/src/shards/_template/data/ui.json +33 -0
  654. package/src/shards/_template/data/water.json +13 -0
  655. package/src/shards/_template/generators/behaviour.ts +34 -0
  656. package/src/shards/_template/generators/boss.ts +29 -0
  657. package/src/shards/_template/generators/buildOptions.ts +2 -0
  658. package/src/shards/_template/generators/cell.ts +224 -0
  659. package/src/shards/_template/generators/districts.ts +215 -0
  660. package/src/shards/_template/generators/farLook.ts +15 -0
  661. package/src/shards/_template/generators/generate.ts +27 -0
  662. package/src/shards/_template/generators/ground.ts +15 -0
  663. package/src/shards/_template/generators/kit.ts +69 -0
  664. package/src/shards/_template/generators/landscape.ts +59 -0
  665. package/src/shards/_template/generators/landscapeNoise.ts +62 -0
  666. package/src/shards/_template/generators/mapInputs.ts +10 -0
  667. package/src/shards/_template/generators/product.ts +100 -0
  668. package/src/shards/_template/generators/productOutput.ts +18 -0
  669. package/src/shards/_template/generators/props.ts +9 -0
  670. package/src/shards/_template/generators/templatePropsSource.ts +58 -0
  671. package/src/shards/_template/generators/terrain.ts +17 -0
  672. package/src/shards/_template/generators/world.ts +630 -0
  673. package/src/shards/_template/hero.json +10 -0
  674. package/src/shards/_template/look/entry-reads.json +20 -0
  675. package/src/shards/_template/manifest.json +281 -0
  676. package/src/shards/_template/shard.config.ts +10 -0
  677. package/src/shared/health.ts +10 -0
  678. package/src/tools/build-web.ts +59 -0
  679. package/src/tsconfig.json +30 -0
  680. package/src/web/app.tsx +53 -0
  681. package/src/web/index.html +12 -0
  682. package/src/web/main.tsx +10 -0
  683. package/src/web/tsconfig.json +13 -0
  684. package/tsconfig.author.json +23 -0
  685. package/tsconfig.commons.json +21 -0
  686. package/tsconfig.json +47 -0
  687. package/tsconfig.sharddev.json +20 -0
@@ -0,0 +1,308 @@
1
+ """Objective checks for the Music v2 bake-off takes (nobody can listen from here, so measure).
2
+
3
+ ~/ml/music/analysis/.venv/bin/python scripts/music/gen/analyze.py <raw-dir> [--force]
4
+
5
+ For every <raw-dir>/<style>/<take>.wav with a .json sidecar, writes <take>.metrics.json:
6
+ loudness ffmpeg ebur128: integrated LUFS, LRA, true peak
7
+ clipping samples at |x| >= 0.999 (and runs of them)
8
+ silence ffmpeg silencedetect (-45 dB, >= 1 s): longest gap that is not the head/tail
9
+ spectrum librosa: centroid, 95 % rolloff, flatness, energy share above 12 kHz / below 60 Hz
10
+ tempo librosa beat tracker vs the brief's BPM (half/double tolerated)
11
+ key Krumhansl-Schmuckler on mean CQT chroma vs D major (relative B minor accepted)
12
+ loop seam best loop (start in the first 40 %, >= 16 bars long (8 for < 60 s takes, 2 for < 30 s), whole bars at the brief's BPM)
13
+ scored by chroma+MFCC similarity of the 2 s either side of the two cut points + level match
14
+ vocals htdemucs source separation: vocal-stem energy share + fraction of 1 s windows with a voice
15
+ above -20 dB of the mix (the real instrumental check; CLAP's vocal guess is kept for reference)
16
+ CLAP laion/clap-htsat-fused (larger_clap_music ships untrained-looking logit scales and
17
+ near-identical text embeddings - unusable): which of the three style briefs the audio matches best
18
+ (softmax over the 3), and a vocals-vs-instrumental score
19
+ """
20
+
21
+ from __future__ import annotations
22
+
23
+ import argparse
24
+ import json
25
+ import os
26
+ import re
27
+ import subprocess
28
+ import sys
29
+ from pathlib import Path
30
+
31
+ import librosa
32
+ import numpy as np
33
+ import soundfile as sf
34
+
35
+ HERE = Path(__file__).resolve().parent
36
+ CLAP_DIR = Path(os.environ.get("CLAP_WEIGHTS", Path.home() / "projects/weights/manual/laion/clap-htsat-fused"))
37
+
38
+ STYLE_TEXT = {
39
+ "piano": "sparse solo piano with soft ambient pads, calm open-world video game music",
40
+ "orchestral": "warm cinematic orchestra with strings, flute, harp and choir, fantasy film score",
41
+ "folk": "folk adventure music with fiddle, acoustic guitar, marimba and hand percussion, sea shanty",
42
+ }
43
+ VOCAL_TEXT = ["a person singing lyrics, lead vocals, a song with a singer", "instrumental music with no vocals"]
44
+
45
+ MAJOR = np.array([6.35, 2.23, 3.48, 2.33, 4.38, 4.09, 2.52, 5.19, 2.39, 3.66, 2.29, 2.88])
46
+ MINOR = np.array([6.33, 2.68, 3.52, 5.38, 2.60, 3.53, 2.54, 4.75, 3.98, 2.69, 3.34, 3.17])
47
+ NOTES = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"]
48
+
49
+
50
+ def ffmpeg_loudness(path: Path) -> dict:
51
+ p = subprocess.run(["ffmpeg", "-nostats", "-hide_banner", "-i", str(path), "-filter_complex", "ebur128=peak=true", "-f", "null", "-"],
52
+ capture_output=True, text=True)
53
+ tail = p.stderr[p.stderr.rfind("Summary:"):]
54
+ get = lambda pat: float(m.group(1)) if (m := re.search(pat, tail)) else None # noqa: E731
55
+ return {"lufs": get(r"I:\s+(-?[\d.]+) LUFS"), "lra": get(r"LRA:\s+(-?[\d.]+) LU"), "true_peak_dbfs": get(r"Peak:\s+(-?[\d.]+) dBFS")}
56
+
57
+
58
+ def ffmpeg_silences(path: Path, dur: float) -> dict:
59
+ p = subprocess.run(["ffmpeg", "-nostats", "-hide_banner", "-i", str(path), "-af", "silencedetect=noise=-45dB:d=1.0", "-f", "null", "-"],
60
+ capture_output=True, text=True)
61
+ starts = [float(x) for x in re.findall(r"silence_start: (-?[\d.]+)", p.stderr)]
62
+ ends = [float(x) for x in re.findall(r"silence_end: (-?[\d.]+)", p.stderr)]
63
+ gaps = []
64
+ for i, s in enumerate(starts):
65
+ e = ends[i] if i < len(ends) else dur
66
+ gaps.append((max(s, 0.0), e))
67
+ internal = [(s, e) for s, e in gaps if s > 0.5 and e < dur - 0.5]
68
+ head = next((e for s, e in gaps if s <= 0.5), 0.0)
69
+ tail = next((dur - s for s, e in gaps if e >= dur - 0.5), 0.0)
70
+ return {
71
+ "longest_internal_gap_s": round(max((e - s for s, e in internal), default=0.0), 2),
72
+ "internal_gaps": len(internal),
73
+ "head_silence_s": round(head, 2),
74
+ "tail_silence_s": round(tail, 2),
75
+ "total_silence_s": round(sum(e - s for s, e in gaps), 2),
76
+ }
77
+
78
+
79
+ def key_estimate(chroma_mean: np.ndarray) -> dict:
80
+ scores = []
81
+ for i in range(12):
82
+ scores.append((np.corrcoef(np.roll(MAJOR, i), chroma_mean)[0, 1], f"{NOTES[i]} major"))
83
+ scores.append((np.corrcoef(np.roll(MINOR, i), chroma_mean)[0, 1], f"{NOTES[i]} minor"))
84
+ scores.sort(reverse=True)
85
+ target = {s: c for c, s in scores}
86
+ rank = [s for _, s in scores].index("D major") + 1
87
+ return {
88
+ "best_key": scores[0][1],
89
+ "best_r": round(float(scores[0][0]), 3),
90
+ "d_major_r": round(float(target["D major"]), 3),
91
+ "d_major_rank": rank,
92
+ "key_ok": scores[0][1] in ("D major", "B minor") or rank <= 2,
93
+ }
94
+
95
+
96
+ def loop_seam(y: np.ndarray, sr: int, bpm: float, dur: float, beats_per_bar: int = 4) -> dict:
97
+ if type(beats_per_bar) is not int or not 1 <= beats_per_bar <= 12:
98
+ raise ValueError("Loop meter must be one to twelve beats per bar")
99
+ hop = 512
100
+ chroma = librosa.feature.chroma_cqt(y=y, sr=sr, hop_length=hop)
101
+ mfcc = librosa.feature.mfcc(y=y, sr=sr, n_mfcc=20, hop_length=hop)
102
+ rms = librosa.feature.rms(y=y, hop_length=hop)[0]
103
+ mfcc = (mfcc - mfcc.mean(1, keepdims=True)) / (mfcc.std(1, keepdims=True) + 1e-6)
104
+ feat = np.vstack([chroma, 0.5 * mfcc])
105
+ fps = sr / hop
106
+ w = int(2.0 * fps)
107
+ bar = beats_per_bar * 60.0 / bpm
108
+ best = {"score": -1.0}
109
+
110
+ def win(i: int, left: bool) -> np.ndarray:
111
+ return feat[:, i - w:i] if left else feat[:, i:i + w]
112
+
113
+ def cos(a: np.ndarray, b: np.ndarray) -> float:
114
+ a, b = a.flatten(), b.flatten()
115
+ return float(np.dot(a, b) / (np.linalg.norm(a) * np.linalg.norm(b) + 1e-9))
116
+
117
+ step = 0.25
118
+ a = 2.0
119
+ min_bars = 16 if dur >= 60 else (8 if dur >= 30 else 2) # 47 s SAO takes hold 8+ bars, 11 s SAO Small 2+
120
+ best["min_bars"] = min_bars
121
+ while a <= 0.4 * dur:
122
+ nb = min_bars
123
+ while a + nb * bar <= dur - 2.2:
124
+ b = a + nb * bar
125
+ ia, ib = int(a * fps), int(b * fps)
126
+ if ia - w < 0 or ib + w > feat.shape[1]:
127
+ nb += 1
128
+ continue
129
+ sim = 0.5 * (cos(win(ia, False), win(ib, False)) + cos(win(ia, True), win(ib, True)))
130
+ ra = float(rms[ia - w:ia + w].mean())
131
+ rb = float(rms[ib - w:ib + w].mean())
132
+ level = min(ra, rb) / (max(ra, rb) + 1e-9)
133
+ score = sim * (0.7 + 0.3 * level)
134
+ if score > best["score"]:
135
+ best = {"min_bars": min_bars, "score": round(score, 3), "similarity": round(sim, 3), "level_match": round(level, 3),
136
+ "start_s": round(a, 2), "end_s": round(b, 2), "bars": nb, "loop_s": round(b - a, 2)}
137
+ nb += 1
138
+ a += step
139
+ return best
140
+
141
+
142
+ def _tensor(out):
143
+ # transformers >= 5 returns a ModelOutput from get_*_features; older versions return the tensor
144
+ return out if hasattr(out, "norm") else (out.pooler_output if getattr(out, "pooler_output", None) is not None else out[0])
145
+
146
+
147
+ class Clap:
148
+ def __init__(self) -> None:
149
+ import torch
150
+ from transformers import ClapModel, ClapProcessor
151
+
152
+ self.torch = torch
153
+ self.model = ClapModel.from_pretrained(str(CLAP_DIR)).eval()
154
+ self.proc = ClapProcessor.from_pretrained(str(CLAP_DIR))
155
+ texts = [STYLE_TEXT[k] for k in ("piano", "orchestral", "folk")] + VOCAL_TEXT
156
+ with torch.no_grad():
157
+ t = self.proc(text=texts, return_tensors="pt", padding=True)
158
+ self.text = torch.nn.functional.normalize(_tensor(self.model.get_text_features(**t)), dim=-1)
159
+
160
+ def score(self, y48: np.ndarray) -> dict:
161
+ torch = self.torch
162
+ seg = 48000 * 10
163
+ chunks = [y48[i:i + seg] for i in range(0, max(len(y48) - seg // 2, 1), seg)]
164
+ chunks = [c for c in chunks if np.sqrt((c ** 2).mean()) > 1e-3] or chunks[:1]
165
+ with torch.no_grad():
166
+ a = self.proc(audio=chunks, sampling_rate=48000, return_tensors="pt")
167
+ emb = torch.nn.functional.normalize(_tensor(self.model.get_audio_features(**a)), dim=-1).mean(0, keepdim=True)
168
+ emb = torch.nn.functional.normalize(emb, dim=-1)
169
+ sims = (emb @ self.text.T)[0]
170
+ scale = float(self.model.logit_scale_a.exp()) # the model's own audio-text logit scale
171
+ p = torch.softmax(sims[:3] * scale, 0).tolist()
172
+ v = torch.softmax(sims[3:] * scale, 0).tolist()
173
+ return {
174
+ "style_prob": {k: round(x, 3) for k, x in zip(("piano", "orchestral", "folk"), p)},
175
+ "style_sim": {k: round(float(x), 4) for k, x in zip(("piano", "orchestral", "folk"), sims[:3])},
176
+ "vocal_prob": round(v[0], 3),
177
+ }
178
+
179
+
180
+ DEMUCS_DIR = Path(os.environ.get("DEMUCS_WEIGHTS", Path.home() / "projects/weights/manual/facebook/demucs"))
181
+
182
+
183
+ class Vocals:
184
+ """Source separation (htdemucs, local repo in the weight store): how much of the take is a voice.
185
+ CLAP's vocal guess called every full-band take vocal; a separated vocal stem is the real test.
186
+ Demucs bleeds lead instruments (fiddle, flute, whistle) into the vocal stem a little, so treat a
187
+ share under ~10 % as instrumental."""
188
+
189
+ def __init__(self) -> None:
190
+ import torch
191
+ from demucs.pretrained import get_model
192
+
193
+ self.torch = torch
194
+ self.model = get_model("htdemucs", repo=DEMUCS_DIR).eval()
195
+ self.dev = os.environ.get("DEMUCS_DEVICE", "cpu")
196
+ self.model.to(self.dev)
197
+
198
+ def score(self, y_st: np.ndarray, sr: int) -> dict:
199
+ from demucs.apply import apply_model
200
+
201
+ torch = self.torch
202
+ msr = self.model.samplerate
203
+ y = y_st.T.astype(np.float32)
204
+ if y.shape[0] == 1:
205
+ y = np.vstack([y, y])
206
+ if sr != msr:
207
+ y = librosa.resample(y, orig_sr=sr, target_sr=msr)
208
+ mix = torch.from_numpy(y)[None]
209
+ with torch.no_grad():
210
+ stems = apply_model(self.model, mix, device=self.dev, split=True, overlap=0.1)[0]
211
+ vi = self.model.sources.index("vocals")
212
+ voc = stems[vi].numpy()
213
+ tot = float((stems.numpy() ** 2).sum()) + 1e-12
214
+ share = float((voc ** 2).sum()) / tot
215
+ win = msr # 1 s windows: how much of the time is there a voice above -20 dB of the mix
216
+ n = voc.shape[1] // win
217
+ vr = np.array([np.sqrt((voc[:, i * win:(i + 1) * win] ** 2).mean()) for i in range(n)])
218
+ mr = np.array([np.sqrt((y[:, i * win:(i + 1) * win] ** 2).mean()) for i in range(n)]) + 1e-9
219
+ active = float((20 * np.log10(vr / mr + 1e-9) > -20).mean()) if n else 0.0
220
+ st = stems.numpy()
221
+ shares = {src: round(float((st[i] ** 2).sum()) / tot, 4) for i, src in enumerate(self.model.sources)}
222
+ # groove continuity for the v3 tension layer: share of 1 s windows where drums+bass sit within 20 dB of the mix
223
+ gb = st[self.model.sources.index("drums")] + st[self.model.sources.index("bass")]
224
+ gr = np.array([np.sqrt((gb[:, i * win:(i + 1) * win] ** 2).mean()) for i in range(n)])
225
+ groove = float((20 * np.log10(gr / mr + 1e-9) > -20).mean()) if n else 0.0
226
+ dr = st[self.model.sources.index("drums")]
227
+ drr = np.array([np.sqrt((dr[:, i * win:(i + 1) * win] ** 2).mean()) for i in range(n)])
228
+ drums_active = float((20 * np.log10(drr / mr + 1e-9) > -24).mean()) if n else 0.0
229
+ return {"vocal_energy_share": round(share, 4), "vocal_active_frac": round(active, 3), "stem_share": shares,
230
+ "groove_active_frac": round(groove, 3), "drums_active_frac": round(drums_active, 3)}
231
+
232
+
233
+ def analyze(wav: Path, side: dict, brief: dict, clap: Clap | None, vocals: Vocals | None = None) -> dict:
234
+ info = sf.info(str(wav))
235
+ dur = info.duration
236
+ y_st, sr = sf.read(str(wav), always_2d=True)
237
+ clip = np.abs(y_st) >= 0.999
238
+ m: dict = {"duration_s": round(dur, 2), "sample_rate": sr, "channels": info.channels}
239
+ m["loudness"] = ffmpeg_loudness(wav)
240
+ m["clipping"] = {"clipped_samples": int(clip.sum()), "clipped_frac": float(clip.mean()), "peak": round(float(np.abs(y_st).max()), 4)}
241
+ m["silence"] = ffmpeg_silences(wav, dur)
242
+ y = y_st.mean(1).astype(np.float32)
243
+ y22 = librosa.resample(y, orig_sr=sr, target_sr=22050)
244
+ S = np.abs(librosa.stft(y, n_fft=4096, hop_length=2048)) ** 2
245
+ freqs = librosa.fft_frequencies(sr=sr, n_fft=4096)
246
+ tot = S.sum() + 1e-12
247
+ m["spectrum"] = {
248
+ "centroid_hz": round(float(librosa.feature.spectral_centroid(S=np.sqrt(S), sr=sr).mean()), 1),
249
+ "rolloff95_hz": round(float(librosa.feature.spectral_rolloff(S=np.sqrt(S), sr=sr, roll_percent=0.95).mean()), 1),
250
+ "flatness": round(float(librosa.feature.spectral_flatness(S=np.sqrt(S)).mean()), 4),
251
+ "hf_above_12k": round(float(S[freqs > 12000].sum() / tot), 5),
252
+ "sub_below_60": round(float(S[freqs < 60].sum() / tot), 4),
253
+ "stereo_corr": round(float(np.corrcoef(y_st[:, 0], y_st[:, 1])[0, 1]), 3) if info.channels == 2 else 1.0,
254
+ }
255
+ tempo, _ = librosa.beat.beat_track(y=y22, sr=22050)
256
+ tempo = float(np.atleast_1d(tempo)[0])
257
+ bpm = float(brief["bpm"])
258
+ err = min(abs(t - bpm) / bpm for t in (tempo, tempo * 2, tempo / 2))
259
+ m["tempo"] = {"estimated_bpm": round(tempo, 1), "brief_bpm": bpm, "rel_err": round(err, 3)}
260
+ chroma = librosa.feature.chroma_cqt(y=y22, sr=22050)
261
+ m["key"] = key_estimate(chroma.mean(1))
262
+ loop_bpm = bpm if err < 0.04 else (tempo if tempo > 0 else bpm)
263
+ m["loop"] = loop_seam(y22, 22050, loop_bpm, dur, brief.get("beatsPerBar", 4))
264
+ m["loop"]["beats_per_bar"] = brief.get("beatsPerBar", 4)
265
+ m["loop"]["grid_bpm"] = round(loop_bpm, 1)
266
+ if clap is not None:
267
+ y48 = librosa.resample(y, orig_sr=sr, target_sr=48000) if sr != 48000 else y
268
+ m["clap"] = clap.score(y48)
269
+ if vocals is not None:
270
+ m["vocals"] = vocals.score(y_st, sr)
271
+ return m
272
+
273
+
274
+ def main() -> None:
275
+ ap = argparse.ArgumentParser()
276
+ ap.add_argument("raw")
277
+ ap.add_argument("--force", action="store_true")
278
+ ap.add_argument("--no-clap", action="store_true")
279
+ ap.add_argument("--only-vocals", action="store_true", help="add the demucs vocal check to existing metrics")
280
+ args = ap.parse_args()
281
+ briefs = json.loads((HERE / "briefs.json").read_text())
282
+ clap = None if (args.no_clap or args.only_vocals) else Clap()
283
+ vocals = Vocals()
284
+ for wav in sorted(Path(args.raw).glob("*/*.wav")):
285
+ side_p = wav.with_suffix(".json")
286
+ out = wav.with_suffix(".metrics.json")
287
+ if args.only_vocals and out.exists() and side_p.exists():
288
+ m = json.loads(out.read_text())
289
+ if "vocals" in m and not args.force:
290
+ continue
291
+ y_st, sr = sf.read(str(wav), always_2d=True)
292
+ m["vocals"] = vocals.score(y_st, sr)
293
+ out.write_text(json.dumps(m, indent=2))
294
+ print(f"{wav.parent.name}/{wav.name}: vocals {m['vocals']}", flush=True)
295
+ continue
296
+ if not side_p.exists() or (out.exists() and not args.force):
297
+ continue
298
+ side = json.loads(side_p.read_text())
299
+ brief = briefs["styles"].get(side["style"]) or {"bpm": side.get("bpm") or 100} # v3 stings / sfx have no style brief
300
+ m = analyze(wav, side, brief, clap, vocals)
301
+ out.write_text(json.dumps(m, indent=2))
302
+ c = m.get("clap", {})
303
+ print(f"{wav.parent.name}/{wav.name}: {m['loudness']['lufs']} LUFS, tempo {m['tempo']['estimated_bpm']}, "
304
+ f"key {m['key']['best_key']}, seam {m['loop']['score']}, style {c.get('style_prob')}, vocals {m.get('vocals')}", flush=True)
305
+
306
+
307
+ if __name__ == "__main__":
308
+ sys.exit(main())
@@ -0,0 +1,46 @@
1
+ """Model-free validation and manifest keys shared by the audio job scripts."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import re
7
+ from pathlib import Path
8
+
9
+
10
+ def tag_name(value: str) -> str:
11
+ if re.fullmatch(r"[a-z0-9]+(?:-[a-z0-9]+)*", value) is None:
12
+ raise ValueError(f"invalid audio set/tag: {value!r}")
13
+ return value
14
+
15
+
16
+ def family_key(family: str) -> str:
17
+ """Existing bed-forest / hum-shrine and Nine Dragon's bed.nd.market / hum.lantern."""
18
+ for prefix in ("bed-", "hum-", "bed.", "hum."):
19
+ if family.startswith(prefix):
20
+ return family[len(prefix):]
21
+ raise ValueError(f"loop family needs a bed/hum prefix: {family}")
22
+
23
+
24
+ def read_sfx(path: Path) -> dict:
25
+ doc = json.loads(path.read_text())
26
+ for family, job in doc["families"].items():
27
+ if job["kind"] not in ("oneshot", "bed", "hum"):
28
+ raise ValueError(f"{family}: unknown kind")
29
+ if not job["prompt"] or not job["desc"] or job["duration"] <= 0:
30
+ raise ValueError(f"{family}: needs prompt, description and positive duration")
31
+ if job["kind"] != "oneshot":
32
+ family_key(family)
33
+ if "into" in job:
34
+ tag_name(job["into"])
35
+ return doc
36
+
37
+
38
+ def read_score(path: Path) -> dict:
39
+ doc = json.loads(path.read_text())
40
+ for key, job in doc["jobs"].items():
41
+ instrument_test = key.startswith("test/") and job["slot"] == key.replace("/", "-", 1)
42
+ if key != f"{job['style']}/{job['slot']}" and not instrument_test:
43
+ raise ValueError(f"{key}: must match style/slot")
44
+ if not job["prompt"] or job["duration"] <= 0 or job["lyrics"] not in doc["lyrics"]:
45
+ raise ValueError(f"{key}: needs prompt, positive duration and a known lyrics key")
46
+ return doc
@@ -0,0 +1,51 @@
1
+ {
2
+ "_doc": "The Music v2 bake-off briefs (project/archive/2026-09-23-music.md checkpoint 2). One shared brief + one per style, then the per-model prompt each generator actually sends. Generators read this file; collect.py writes the takes (seed, model, version, metrics) into <style>.json beside it.",
3
+ "shared": {
4
+ "game": "Wildshard",
5
+ "brief": "Instrumental game exploration theme for Wildshard, a world that arrives one chunk at a time: wonder first, adventure second, a little melancholy underneath. No vocals. 60-90 s, loopable (it will be trimmed to a bar-exact loop). The model composes freely - no required motif.",
6
+ "duration_s": 75,
7
+ "timesig": "4/4"
8
+ },
9
+ "styles": {
10
+ "piano": {
11
+ "title": "Sparse piano + ambient",
12
+ "reference": "Breath of the Wild field music",
13
+ "key": "D major",
14
+ "mode_colour": "Lydian (raised 4th, G#)",
15
+ "bpm": 80,
16
+ "ace_caption": "Sparse solo piano with ambient pads, open-world exploration video game soundtrack in the style of Breath of the Wild. Gentle, spacious grand piano phrases with long rests between notes, soft felt tone and sustain pedal; a distant airy pad and faint string harmonics underneath; an occasional glassy bell. Wide natural reverb. Mood: wonder first, quiet adventure second, a little melancholy underneath - a world slowly appearing one piece at a time. Instrumental, no vocals, no drums. D major with a Lydian raised fourth.",
17
+ "heartmula_tags": "piano,ambient,instrumental,calm,peaceful,melancholic,dreamy,minimal,cinematic,slow",
18
+ "sao_prompt": "Sparse solo grand piano with soft ambient pad, open-world video game exploration music, gentle, wistful, spacious reverb, no drums, D major, 80 BPM",
19
+ "sao_negative": "drums, vocals, distortion, low quality, noise",
20
+ "minimax_prompt": "Genre: video game soundtrack, ambient solo piano. BPM: 80. Key: D major with a Lydian raised fourth. Instrumental only, no vocals. Mood: wonder first, quiet adventure second, a little melancholy underneath - an open world appearing one piece at a time, like Breath of the Wild's field music. Arrangement: sparse grand piano phrases with long rests and soft sustain pedal; a distant airy pad and faint string harmonics underneath; an occasional glassy bell; no drums. Production: intimate close-miked piano, wide natural reverb.",
21
+ "heartmula_tags_v0_spaced": "instrumental, piano, ambient, video game soundtrack, calm, peaceful, melancholic, cinematic, sparse, soft"
22
+ },
23
+ "orchestral": {
24
+ "title": "Warm orchestral",
25
+ "reference": "Studio Ghibli (Joe Hisaishi) / Ori and the Blind Forest",
26
+ "key": "D major",
27
+ "mode_colour": "Lydian lift",
28
+ "bpm": 96,
29
+ "ace_caption": "Warm cinematic orchestral exploration theme for a fantasy adventure video game, in the style of Joe Hisaishi's Studio Ghibli scores and Ori and the Blind Forest. A lyrical flute and oboe melody over legato strings, rippling harp arpeggios, soft French horns, celesta sparkle and a wordless choir pad swelling underneath; gentle timpani, no drum kit. Mood: wonder first, adventure second, a little melancholy underneath. Rich concert-hall reverb. Instrumental, no lead vocals. D major.",
30
+ "heartmula_tags": "orchestral,cinematic,classical,instrumental,violin,cello,flute,harp,fantasy,adventure,gentle,dreamy",
31
+ "sao_prompt": "Warm cinematic orchestra, lyrical flute melody over legato strings, harp arpeggios, soft french horns, celesta, wordless choir pad, fantasy adventure film score, hopeful and wistful, D major, 96 BPM",
32
+ "sao_negative": "drum kit, vocals, distortion, low quality, noise",
33
+ "minimax_prompt": "Genre: cinematic orchestral film score for a fantasy adventure video game. BPM: 96. Key: D major. Instrumental only, no lead vocals. Mood: wonder first, adventure second, a little melancholy underneath - in the spirit of Joe Hisaishi's Studio Ghibli scores and Ori and the Blind Forest. Arrangement: a lyrical flute and oboe melody over legato strings, rippling harp arpeggios, soft French horns, celesta sparkle and a wordless choir pad swelling underneath; gentle timpani, no drum kit. Production: warm, wide concert-hall reverb.",
34
+ "heartmula_tags_v0_spaced": "instrumental, orchestral, cinematic, film score, strings, flute, harp, choir, warm, emotional, fantasy, adventure"
35
+ },
36
+ "folk": {
37
+ "title": "Folk-adventure",
38
+ "reference": "Sea of Thieves",
39
+ "key": "D major",
40
+ "mode_colour": "Mixolydian (flat 7th, C natural)",
41
+ "bpm": 104,
42
+ "ace_caption": "Folk-adventure exploration theme for a seafaring video game in the style of Sea of Thieves. A lively fiddle carries the melody over strummed and fingerpicked acoustic guitar, a warm marimba ostinato, hand percussion (frame drum, bodhran, shaker), upright bass and a touch of tin whistle and accordion. Mood: wonder first, adventure second, a little melancholy underneath - sailing towards an island that forms as you approach. Natural room sound. Instrumental, no vocals. D major with a Mixolydian flat seventh.",
43
+ "heartmula_tags": "folk,acoustic,guitar,violin,accordion,instrumental,adventure,traditional,upbeat,cheerful,playful,nostalgic",
44
+ "sao_prompt": "Folk adventure music, lively fiddle melody, strummed acoustic guitar, marimba ostinato, frame drum and shaker, upright bass, tin whistle, sea shanty feel, joyful and wistful, D major, 104 BPM",
45
+ "sao_negative": "vocals, electric guitar, synth, distortion, low quality, noise",
46
+ "minimax_prompt": "Genre: folk adventure, sea-shanty flavoured video game soundtrack. BPM: 104. Key: D major with a Mixolydian flat seventh. Instrumental only, no vocals. Mood: wonder first, adventure second, a little melancholy underneath - sailing towards an island that forms as you approach, in the spirit of Sea of Thieves. Arrangement: a lively fiddle carries the melody over strummed and fingerpicked acoustic guitar, a warm marimba ostinato, hand percussion (frame drum, bodhran, shaker), upright bass, a touch of tin whistle and accordion. Production: natural, warm room sound.",
47
+ "heartmula_tags_v0_spaced": "instrumental, folk, celtic, acoustic guitar, fiddle, marimba, percussion, adventure, sea shanty, upbeat, warm"
48
+ }
49
+ },
50
+ "_heartmula_note": "HeartMuLa wants tags comma-separated WITHOUT spaces (heartlib README; issue #17). The bake-off takes (hm-spaced-*) were made with heartmula_tags_v0_spaced before that was known; the no-space heartmula_tags were then A/B-tested (2 seeds x piano/folk, 30 s, with and without '[intro]/[instrumental]/[outro]' lyrics) and did NOT reduce the humming/singing demucs finds, so the run was completed with the original tags for consistency."
51
+ }