@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,334 @@
1
+ """Rank the bake-off takes, encode the shortlist, write <style>.json and the listening page.
2
+
3
+ python3 scripts/music/gen/build_page.py <raw-dir>
4
+
5
+ Reads <raw-dir>/<style>/<take>.wav + .json (generator sidecar) + .metrics.json (analyze.py).
6
+ Writes, in this repo:
7
+ scripts/music/gen/<style>.json every take: model, version, prompt, seed, timing, metrics, score
8
+ art/music/round-1-bakeoff/<style>/*.m4a the shortlist (3 per style), AAC-LC 96 kb/s, <= 75 s,
9
+ gain-matched to -18 LUFS so no take wins by being louder
10
+ art/music/round-1-bakeoff/index.html the listening page (audio referenced relatively)
11
+ Only the shortlist is encoded/committed; the full take set stays in <raw-dir>.
12
+
13
+ Nobody could listen while ranking, so the score is objective checks only (see SCORE below). It is a
14
+ shortlist filter, not a verdict - the user's ears pick.
15
+ """
16
+
17
+ from __future__ import annotations
18
+
19
+ import html
20
+ import json
21
+ import subprocess
22
+ import sys
23
+ from pathlib import Path
24
+
25
+ HERE = Path(__file__).resolve().parent
26
+ REPO = HERE.parents[2]
27
+ ART = REPO / "art/music/round-1-bakeoff"
28
+ STYLES = ("piano", "orchestral", "folk")
29
+ MAX_S = 75.0
30
+ TARGET_LUFS = -18.0
31
+
32
+ SCORE = {
33
+ "style": 0.35, # CLAP: probability the take matches its own style brief (of the three)
34
+ "seam": 0.20, # best bar-exact loop seam similarity
35
+ "length": 0.10, # >= 60 s is a theme; 47 s is short; 11 s is a loop/one-shot
36
+ "tempo": 0.10, # beat-tracked tempo vs brief BPM (half/double tolerated)
37
+ "key": 0.10, # D major (or relative B minor) by chroma
38
+ "clean": 0.15, # no clipping, no internal dropouts, not dull (95 % rolloff)
39
+ }
40
+ VOCAL_PENALTY = 0.0 # CLAP vocals-vs-instrumental: shown, NOT scored - it rated ~every full-band take (folk,
41
+ # orchestral) >= 0.9 "vocal", so it cannot tell a fiddle or a choir pad from a singer
42
+
43
+
44
+ def family(side: dict) -> str:
45
+ return side["model"]
46
+
47
+
48
+ def score(m: dict, style: str) -> tuple[float, dict]:
49
+ clap = m.get("clap", {})
50
+ parts = {
51
+ "style": clap.get("style_prob", {}).get(style, 0.0),
52
+ "seam": max(0.0, min(1.0, (m["loop"].get("score", -1) - 0.1) / 0.6)) if m["loop"].get("score", -1) > 0 else 0.0,
53
+ "length": 1.0 if m["duration_s"] >= 59 else (0.6 if m["duration_s"] >= 40 else 0.15),
54
+ "tempo": 1.0 - min(m["tempo"]["rel_err"] / 0.1, 1.0),
55
+ "key": 1.0 if m["key"]["key_ok"] else (0.5 if m["key"]["d_major_rank"] <= 4 else 0.0),
56
+ }
57
+ clean = 1.0
58
+ if m["clipping"]["clipped_frac"] > 1e-4:
59
+ clean -= 0.5
60
+ if m["silence"]["longest_internal_gap_s"] > 2.0:
61
+ clean -= 0.3
62
+ if m["spectrum"]["rolloff95_hz"] < 7000:
63
+ clean -= 0.2
64
+ if m.get("vocals", {}).get("vocal_energy_share", 0) > 0.10: # demucs: a real voice, not lead-instrument bleed
65
+ clean -= 0.6
66
+ parts["clean"] = max(clean, 0.0)
67
+ total = sum(SCORE[k] * v for k, v in parts.items()) - VOCAL_PENALTY * clap.get("vocal_prob", 0.0)
68
+ return round(total, 3), {k: round(v, 3) for k, v in parts.items()}
69
+
70
+
71
+ def encode(wav: Path, m: dict, dest: Path) -> dict:
72
+ dest.parent.mkdir(parents=True, exist_ok=True)
73
+ lufs, tp = m["loudness"]["lufs"], m["loudness"]["true_peak_dbfs"]
74
+ gain = min(TARGET_LUFS - lufs, -1.0 - tp)
75
+ dur = min(m["duration_s"], MAX_S)
76
+ af = f"volume={gain:.2f}dB"
77
+ if m["duration_s"] > MAX_S:
78
+ af += f",afade=t=out:st={MAX_S - 2:.2f}:d=2"
79
+ subprocess.run(["ffmpeg", "-y", "-loglevel", "error", "-i", str(wav), "-t", f"{dur:.2f}", "-af", af,
80
+ "-c:a", "aac", "-b:a", "96k", "-movflags", "+faststart", str(dest)], check=True)
81
+ return {"gain_db": round(gain, 2), "seconds": round(dur, 2), "bytes": dest.stat().st_size}
82
+
83
+
84
+ def main() -> None:
85
+ raw = Path(sys.argv[1])
86
+ briefs = json.loads((HERE / "briefs.json").read_text())
87
+ models = json.loads((HERE / "models.json").read_text())
88
+ exclude = tuple(models.get("_exclude_prefixes", []))
89
+ out: dict = {}
90
+ for style in STYLES:
91
+ takes = []
92
+ for side_p in sorted((raw / style).glob("*.json")):
93
+ if side_p.name.endswith(".metrics.json"):
94
+ continue
95
+ name = side_p.stem
96
+ if name.startswith(exclude):
97
+ continue
98
+ mp = side_p.with_name(name + ".metrics.json")
99
+ if not mp.exists():
100
+ continue
101
+ side, m = json.loads(side_p.read_text()), json.loads(mp.read_text())
102
+ total, parts = score(m, style)
103
+ takes.append({"id": name, "side": side, "metrics": m, "score": total, "parts": parts})
104
+ takes.sort(key=lambda t: -t["score"])
105
+ short, per_family = [], {}
106
+ for t in takes:
107
+ fam = family(t["side"])
108
+ sung = t["metrics"].get("vocals", {}).get("vocal_energy_share", 0) > 0.20
109
+ if t["metrics"]["duration_s"] < 30 or sung or per_family.get(fam, 0) >= 1: # one per model: the bake-off is between models
110
+ continue
111
+ short.append(t)
112
+ per_family[fam] = per_family.get(fam, 0) + 1
113
+ if len(short) == 3:
114
+ break
115
+ for old in (ART / style).glob("*.m4a"): # this folder holds only this script's output
116
+ old.unlink()
117
+ for rank, t in enumerate(short, 1):
118
+ t["shortlist"] = rank
119
+ t["file"] = f"{style}/{t['id']}.m4a"
120
+ t["encode"] = encode(raw / style / f"{t['id']}.wav", t["metrics"], ART / t["file"])
121
+ out[style] = takes
122
+ rec = {
123
+ "style": style,
124
+ "brief": briefs["shared"] | briefs["styles"][style],
125
+ "scoring": {"weights": SCORE, "vocal_penalty": VOCAL_PENALTY, "target_lufs": TARGET_LUFS},
126
+ "shortlist": [t["id"] for t in short],
127
+ "takes": [
128
+ {
129
+ "id": t["id"], "score": t["score"], "parts": t["parts"], "shortlist": t.get("shortlist"),
130
+ "file": t.get("file"), "encode": t.get("encode"),
131
+ **{k: t["side"].get(k) for k in ("model", "variant", "lm", "codec", "code_commit", "backend", "seed", "prompt",
132
+ "negative_prompt", "lyrics", "bpm", "key", "duration_s", "steps", "guidance",
133
+ "cfg", "cfg_scale", "temperature", "topk", "gen_time_s", "model_load_s",
134
+ "mlx_peak_gb", "mps_driver_gb") if t["side"].get(k) is not None},
135
+ "metrics": t["metrics"],
136
+ }
137
+ for t in takes
138
+ ],
139
+ }
140
+ (HERE / f"{style}.json").write_text(json.dumps(rec, indent=2, ensure_ascii=False) + "\n")
141
+ print(f"{style}: {len(takes)} takes, shortlist {[t['id'] for t in short]}")
142
+ (ART / "index.html").write_text(page(out, briefs, models))
143
+ total = sum(p.stat().st_size for p in ART.glob("*/*.m4a"))
144
+ print(f"audio total {total / 1e6:.1f} MB -> {ART}")
145
+
146
+
147
+ # ---------------------------------------------------------------- page
148
+
149
+ PAGE_CSS = """:root {
150
+ --ground: #eef2f1; --surface: #ffffff; --ink: #14201e; --muted: #56655f; --line: #d3dcd9;
151
+ --accent: #0f6e66; --accent-soft: #dcefeb; --warn: #9a5b00; --warn-soft: #fbefd9; --bad: #a3222b; --bad-soft: #f8dfe1;
152
+ --good: #1d6b3a; --good-soft: #def1e4;
153
+ }
154
+ @media (prefers-color-scheme: dark) {
155
+ :root:not([data-theme="light"]) {
156
+ color-scheme: dark;
157
+ --ground: #0d1413; --surface: #141d1c; --ink: #e2ebe8; --muted: #93a39e; --line: #26332f;
158
+ --accent: #5fc9b9; --accent-soft: #173330; --warn: #e3a64a; --warn-soft: #33270f; --bad: #f08a91; --bad-soft: #3a1a1d;
159
+ --good: #7fd49c; --good-soft: #15301f;
160
+ }
161
+ }
162
+ :root[data-theme="dark"] {
163
+ color-scheme: dark;
164
+ --ground: #0d1413; --surface: #141d1c; --ink: #e2ebe8; --muted: #93a39e; --line: #26332f;
165
+ --accent: #5fc9b9; --accent-soft: #173330; --warn: #e3a64a; --warn-soft: #33270f; --bad: #f08a91; --bad-soft: #3a1a1d;
166
+ --good: #7fd49c; --good-soft: #15301f;
167
+ }
168
+ body { background: var(--ground); color: var(--ink); font: 15px/1.55 "IBM Plex Sans", system-ui, sans-serif; }
169
+ .wrap { max-width: 980px; margin: 0 auto; padding-inline: 16px; padding-block: 28px 64px; }
170
+ h1, h2, h3 { font-family: "Newsreader", Georgia, serif; font-weight: 600; text-wrap: balance; margin: 0; }
171
+ h1 { font-size: clamp(30px, 6vw, 46px); line-height: 1.05; letter-spacing: -0.01em; }
172
+ .lede { max-width: 62ch; color: var(--muted); margin: 12px 0 0; }
173
+ .brief { margin: 22px 0 0; padding: 14px 16px; border-left: 3px solid var(--accent); background: var(--surface); max-width: 70ch; }
174
+ .brief p { margin: 0; font-family: "Newsreader", Georgia, serif; font-size: 18px; line-height: 1.45; }
175
+ .brief small { display: block; margin-top: 6px; color: var(--muted); font: 12px/1.4 "IBM Plex Mono", monospace; }
176
+ nav.jump { display: flex; flex-wrap: wrap; gap: 8px; margin: 22px 0 0; }
177
+ nav.jump a { color: var(--accent); text-decoration: none; border: 1px solid var(--line); background: var(--surface); padding: 6px 12px; border-radius: 999px; font-weight: 500; }
178
+ nav.jump a:focus-visible, summary:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
179
+ .style { margin-top: 44px; }
180
+ .style-head { display: grid; gap: 4px; border-bottom: 1px solid var(--line); padding-bottom: 12px; }
181
+ .style-head h2 { font-size: 30px; }
182
+ .ref { margin: 0; color: var(--muted); font-style: italic; font-family: "Newsreader", Georgia, serif; font-size: 17px; }
183
+ .spec { display: flex; flex-wrap: wrap; gap: 6px 14px; margin: 4px 0 0; font: 12px/1.4 "IBM Plex Mono", monospace; color: var(--muted); letter-spacing: 0.02em; text-transform: uppercase; }
184
+ .takes { display: grid; gap: 14px; margin-top: 16px; }
185
+ .take { background: var(--surface); border: 1px solid var(--line); border-radius: 10px; padding: 14px 16px; display: grid; gap: 10px; }
186
+ .take-head { display: grid; grid-template-columns: auto 1fr auto; gap: 12px; align-items: center; }
187
+ .rank { width: 34px; height: 34px; border-radius: 50%; display: grid; place-items: center; background: var(--accent); color: var(--surface); font: 600 16px/1 "IBM Plex Mono", monospace; }
188
+ .take h3 { font-size: 20px; }
189
+ .seed { font: 400 13px "IBM Plex Mono", monospace; color: var(--muted); margin-left: 6px; }
190
+ .meta { margin: 2px 0 0; color: var(--muted); font-size: 13px; }
191
+ .score { font: 500 14px "IBM Plex Mono", monospace; color: var(--accent); background: var(--accent-soft); padding: 4px 8px; border-radius: 6px; font-variant-numeric: tabular-nums; }
192
+ audio { width: 100%; }
193
+ .chips { display: flex; flex-wrap: wrap; gap: 6px; }
194
+ .chip { font: 12px/1.3 "IBM Plex Mono", monospace; padding: 3px 8px; border-radius: 6px; background: var(--ground); color: var(--ink); }
195
+ .chip b { font-weight: 500; color: var(--muted); }
196
+ .chip.good { background: var(--good-soft); } .chip.good b { color: var(--good); }
197
+ .chip.warn { background: var(--warn-soft); } .chip.warn b { color: var(--warn); }
198
+ .chip.bad { background: var(--bad-soft); } .chip.bad b { color: var(--bad); }
199
+ details summary { cursor: pointer; color: var(--accent); font-weight: 500; }
200
+ .prompt { margin: 6px 0 0; color: var(--muted); font-size: 14px; max-width: 75ch; }
201
+ details.all { margin-top: 14px; }
202
+ .tablewrap { overflow-x: auto; margin-top: 10px; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); }
203
+ table { border-collapse: collapse; width: 100%; font: 12.5px/1.4 "IBM Plex Mono", monospace; font-variant-numeric: tabular-nums; }
204
+ th, td { padding: 6px 10px; text-align: left; border-bottom: 1px solid var(--line); white-space: nowrap; }
205
+ th { color: var(--muted); font-weight: 500; text-transform: uppercase; letter-spacing: 0.04em; font-size: 11px; }
206
+ td.n { text-align: right; }
207
+ tr.on td { background: var(--accent-soft); }
208
+ .models td { white-space: normal; vertical-align: top; min-width: 110px; }
209
+ .notes { margin-top: 48px; display: grid; gap: 14px; }
210
+ .notes h2 { font-size: 26px; }
211
+ .notes p, .notes li { max-width: 75ch; }
212
+ .empty { color: var(--muted); }
213
+ @media (max-width: 560px) { .take-head { grid-template-columns: auto 1fr; } .score { grid-column: 2; justify-self: start; } }
214
+ """
215
+
216
+ def esc(x: object) -> str:
217
+ return html.escape(str(x), quote=True)
218
+
219
+
220
+ def chip(label: str, value: str, tone: str = "") -> str:
221
+ return f'<span class="chip {tone}"><b>{esc(label)}</b> {esc(value)}</span>'
222
+
223
+
224
+ def take_chips(t: dict, style: str) -> str:
225
+ m = t["metrics"]
226
+ c = m.get("clap", {})
227
+ sp = c.get("style_prob", {}).get(style)
228
+ loop = m["loop"]
229
+ out = [
230
+ chip("length", f"{min(m['duration_s'], MAX_S):.0f} s"),
231
+ chip("style match", f"{sp * 100:.0f}%" if sp is not None else "-", "good" if (sp or 0) >= 0.6 else ("warn" if (sp or 0) < 0.34 else "")),
232
+ chip("tempo", f"{m['tempo']['estimated_bpm']:.0f} bpm"),
233
+ chip("key", m["key"]["best_key"], "" if m["key"]["key_ok"] else "warn"),
234
+ chip("loop", f"{loop['bars']} bars @ {loop['start_s']:.1f}s, seam {loop['score']:.2f}" if loop.get("score", -1) > 0 else "none found", "" if loop.get("score", -1) > 0.35 else "warn"),
235
+ chip("level", f"{m['loudness']['lufs']:.0f} LUFS, LRA {m['loudness']['lra']:.0f}"),
236
+ ]
237
+ v = m.get("vocals")
238
+ if v:
239
+ share = v["vocal_energy_share"]
240
+ out.append(chip("voice", f"{share * 100:.1f}% of energy", "bad" if share > 0.10 else ("warn" if share > 0.03 else "good")))
241
+ if m["silence"]["longest_internal_gap_s"] > 2:
242
+ out.append(chip("dropout", f"{m['silence']['longest_internal_gap_s']:.1f} s", "bad"))
243
+ if m["clipping"]["clipped_frac"] > 1e-4:
244
+ out.append(chip("clipping", f"{m['clipping']['clipped_frac'] * 100:.2f}%", "bad"))
245
+ return "".join(out)
246
+
247
+
248
+ def page(out: dict, briefs: dict, models: dict) -> str:
249
+ shared = briefs["shared"]
250
+ sections = []
251
+ for style in STYLES:
252
+ b = briefs["styles"][style]
253
+ takes = out[style]
254
+ short = sorted([t for t in takes if t.get("shortlist")], key=lambda t: t["shortlist"])
255
+ cards = []
256
+ for t in short:
257
+ s = t["side"]
258
+ mi = models["models"].get(s["model"], {})
259
+ cards.append(f"""
260
+ <article class="take">
261
+ <div class="take-head">
262
+ <span class="rank">{t['shortlist']}</span>
263
+ <div>
264
+ <h3>{esc(s['model'])} <span class="seed">seed {esc(s['seed'])}</span></h3>
265
+ <p class="meta">{esc(s.get('variant', ''))} &middot; {esc(mi.get('licence_short', ''))}</p>
266
+ </div>
267
+ <span class="score" title="objective score, not a verdict">{t['score']:.2f}</span>
268
+ </div>
269
+ <audio controls preload="none" src="{esc(t['file'])}"></audio>
270
+ <div class="chips">{take_chips(t, style)}</div>
271
+ <details><summary>Prompt</summary><p class="prompt">{esc(s.get('prompt', ''))}</p></details>
272
+ </article>""")
273
+ rows = []
274
+ for t in takes:
275
+ s, m = t["side"], t["metrics"]
276
+ c = m.get("clap", {})
277
+ rows.append(
278
+ f"<tr class=\"{'on' if t.get('shortlist') else ''}\"><td>{esc(t['id'])}</td><td>{esc(s['model'])}</td>"
279
+ f"<td class=n>{t['score']:.2f}</td><td class=n>{c.get('style_prob', {}).get(style, 0) * 100:.0f}%</td>"
280
+ f"<td class=n>{m['duration_s']:.0f}</td><td class=n>{m['tempo']['estimated_bpm']:.0f}</td><td>{esc(m['key']['best_key'])}</td>"
281
+ f"<td class=n>{m['loop'].get('score', -1):.2f}</td><td class=n>{m['loudness']['lufs']:.1f}</td>"
282
+ f"<td class=n>{m.get('vocals', {}).get('vocal_energy_share', 0) * 100:.1f}%</td><td class=n>{s.get('gen_time_s', '')}</td></tr>")
283
+ sections.append(f"""
284
+ <section class="style" id="{style}">
285
+ <header class="style-head">
286
+ <h2>{esc(b['title'])}</h2>
287
+ <p class="ref">after {esc(b['reference'])}</p>
288
+ <p class="spec"><span>{esc(b['key'])}</span><span>{esc(b['mode_colour'])}</span><span>{b['bpm']} BPM</span><span>{esc(shared['timesig'])}</span></p>
289
+ </header>
290
+ <div class="takes">{''.join(cards) or '<p class="empty">No take long enough to shortlist yet.</p>'}</div>
291
+ <details class="all"><summary>All {len(takes)} takes, ranked</summary>
292
+ <div class="tablewrap"><table>
293
+ <thead><tr><th>take</th><th>model</th><th>score</th><th>style</th><th>s</th><th>bpm</th><th>key</th><th>seam</th><th>LUFS</th><th>voice</th><th>gen s</th></tr></thead>
294
+ <tbody>{''.join(rows)}</tbody>
295
+ </table></div>
296
+ </details>
297
+ </section>""")
298
+ mrows = []
299
+ for name, mi in models["models"].items():
300
+ mrows.append(f"<tr><td><b>{esc(name)}</b><br><span class=meta>{esc(mi.get('version', ''))}</span></td><td>{esc(mi.get('status', ''))}</td>"
301
+ f"<td>{esc(mi.get('backend', ''))}</td><td>{esc(mi.get('speed', ''))}</td><td>{esc(mi.get('memory', ''))}</td>"
302
+ f"<td>{esc(mi.get('licence', ''))}</td></tr>")
303
+ weights = ", ".join(f"{k} {int(v * 100)}%" for k, v in SCORE.items())
304
+ return f"""<title>Wildshard Music Bake-off</title>
305
+ <meta name="description" content="Round 1 of the Wildshard music bake-off: three styles, locally generated by open-weight models, shortlisted by objective checks.">
306
+ <link rel="preconnect" href="https://fonts.googleapis.com">
307
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
308
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Newsreader:opsz,wght@6..72,500;6..72,600&family=IBM+Plex+Sans:wght@400;500;600&family=IBM+Plex+Mono:wght@400;500&display=swap">
309
+ <style>
310
+ {PAGE_CSS}</style>
311
+ <div class="wrap">
312
+ <header>
313
+ <h1>Wildshard music bake-off</h1>
314
+ <p class="lede">Round 1. Every take below was composed on the Mac by an open-weight model, from the same brief per style. The three per style are a shortlist picked by objective checks, since nobody could listen while ranking. Pick one track per style by ear.</p>
315
+ <div class="brief"><p>&ldquo;{esc(shared['brief'])}&rdquo;</p><small>shared brief &middot; {shared['duration_s']} s target &middot; players are gain-matched to {TARGET_LUFS:.0f} LUFS</small></div>
316
+ <nav class="jump">{''.join(f'<a href="#{s}">{esc(briefs["styles"][s]["title"])}</a>' for s in STYLES)}<a href="#models">Models</a></nav>
317
+ </header>
318
+ {''.join(sections)}
319
+ <section class="notes" id="models">
320
+ <h2>The models</h2>
321
+ <div class="tablewrap"><table class="models">
322
+ <thead><tr><th>model</th><th>status</th><th>engine</th><th>speed</th><th>peak memory</th><th>licence</th></tr></thead>
323
+ <tbody>{''.join(mrows)}</tbody>
324
+ </table></div>
325
+ <h2>How the shortlist was picked</h2>
326
+ <p>Score = {esc(weights)}. Style match comes from CLAP (laion/clap-htsat-fused) comparing each take to the three style briefs; its own vocals guess called almost every full-band take vocal, so the voice check is source separation instead (htdemucs vocal-stem share of energy: over 10% costs the take, over 20% keeps it off the shortlist); tempo and key from librosa; the loop seam is the most similar pair of bar-aligned cut points; loudness and dropouts from ffmpeg. One shortlist place per model, so each style is heard from three different models, and nothing under 30 s (those are loop or sting material, not a theme).</p>
327
+ <ul>{''.join(f'<li>{esc(n)}</li>' for n in models.get('notes', []))}</ul>
328
+ </section>
329
+ </div>
330
+ """
331
+
332
+
333
+ if __name__ == "__main__":
334
+ main()