@wildshard/sdk 0.0.1 → 0.2.4

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 (688) hide show
  1. package/GUIDE.md +895 -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 +47 -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 +39 -0
  358. package/src/cli/bin.mjs +8 -0
  359. package/src/cli/delete/delete.ts +258 -0
  360. package/src/cli/help.ts +204 -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 +291 -0
  365. package/src/cli/report.ts +20 -0
  366. package/src/cli/shardfile/command.ts +49 -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/agentFiles.ts +127 -0
  394. package/src/sharddev/arenaView.ts +15 -0
  395. package/src/sharddev/as/groupBankV2.ts +36 -0
  396. package/src/sharddev/as/groupStepV2.ts +13 -0
  397. package/src/sharddev/as/ws.ts +30 -0
  398. package/src/sharddev/as/wsV2.ts +180 -0
  399. package/src/sharddev/assemblyscriptCompiler.d.mts +5 -0
  400. package/src/sharddev/assemblyscriptCompiler.mjs +14 -0
  401. package/src/sharddev/assetHandle.ts +84 -0
  402. package/src/sharddev/assetOwner.ts +70 -0
  403. package/src/sharddev/assetScope.ts +30 -0
  404. package/src/sharddev/assets.ts +21 -0
  405. package/src/sharddev/audio.ts +9 -0
  406. package/src/sharddev/audioEncode.ts +211 -0
  407. package/src/sharddev/author.ts +3 -0
  408. package/src/sharddev/authorError.ts +28 -0
  409. package/src/sharddev/authorManifest.ts +39 -0
  410. package/src/sharddev/bake/annulus.ts +19 -0
  411. package/src/sharddev/bake/assemblyscriptMemo.ts +76 -0
  412. package/src/sharddev/bake/assemblyscriptMemoPort.ts +4 -0
  413. package/src/sharddev/bake/authoredWorld.ts +201 -0
  414. package/src/sharddev/bake/basisEncoder.ts +95 -0
  415. package/src/sharddev/bake/basisGlb.ts +85 -0
  416. package/src/sharddev/bake/basisTool.ts +74 -0
  417. package/src/sharddev/bake/basisToolInputs.ts +476 -0
  418. package/src/sharddev/bake/byteCodec.ts +33 -0
  419. package/src/sharddev/bake/canvasAtlas.ts +406 -0
  420. package/src/sharddev/bake/coarseCopy.ts +59 -0
  421. package/src/sharddev/bake/colliders.ts +87 -0
  422. package/src/sharddev/bake/compactGlb.ts +224 -0
  423. package/src/sharddev/bake/compileScript.ts +119 -0
  424. package/src/sharddev/bake/compileScriptV2.ts +75 -0
  425. package/src/sharddev/bake/contactRows.ts +84 -0
  426. package/src/sharddev/bake/creaturePlacement.ts +117 -0
  427. package/src/sharddev/bake/export.ts +67 -0
  428. package/src/sharddev/bake/facetedGeometry.ts +379 -0
  429. package/src/sharddev/bake/farImpostor.ts +120 -0
  430. package/src/sharddev/bake/forest.ts +100 -0
  431. package/src/sharddev/bake/format-hook.mjs +2 -0
  432. package/src/sharddev/bake/generatorGlb.ts +23 -0
  433. package/src/sharddev/bake/geometryBounds.ts +77 -0
  434. package/src/sharddev/bake/geometryError.ts +48 -0
  435. package/src/sharddev/bake/glb.ts +355 -0
  436. package/src/sharddev/bake/glbCompression.ts +143 -0
  437. package/src/sharddev/bake/gltfSource.ts +59 -0
  438. package/src/sharddev/bake/groundMap.ts +142 -0
  439. package/src/sharddev/bake/image.ts +20 -0
  440. package/src/sharddev/bake/isleMap.ts +64 -0
  441. package/src/sharddev/bake/json.mjs +84 -0
  442. package/src/sharddev/bake/keyedSky.ts +47 -0
  443. package/src/sharddev/bake/keyedSkyMemo.ts +39 -0
  444. package/src/sharddev/bake/kinds.ts +137 -0
  445. package/src/sharddev/bake/lightSources.ts +31 -0
  446. package/src/sharddev/bake/mapAssembly.ts +84 -0
  447. package/src/sharddev/bake/mapRaster.ts +173 -0
  448. package/src/sharddev/bake/mapRest.ts +57 -0
  449. package/src/sharddev/bake/mapScenes.ts +234 -0
  450. package/src/sharddev/bake/materialGraph.ts +32 -0
  451. package/src/sharddev/bake/meadow.ts +27 -0
  452. package/src/sharddev/bake/meshoptChoiceMemo.ts +34 -0
  453. package/src/sharddev/bake/nativeInteractionFacts.ts +5 -0
  454. package/src/sharddev/bake/nativeLattice.ts +178 -0
  455. package/src/sharddev/bake/nativeRaster.ts +106 -0
  456. package/src/sharddev/bake/nativeTerrainField.ts +11 -0
  457. package/src/sharddev/bake/navigation-json.mjs +38 -0
  458. package/src/sharddev/bake/navigation.ts +113 -0
  459. package/src/sharddev/bake/navigationAsset.ts +18 -0
  460. package/src/sharddev/bake/nearPlaceholder.ts +206 -0
  461. package/src/sharddev/bake/normalizeRig.ts +80 -0
  462. package/src/sharddev/bake/phoneAstc.ts +93 -0
  463. package/src/sharddev/bake/placeholders.ts +581 -0
  464. package/src/sharddev/bake/placement.ts +80 -0
  465. package/src/sharddev/bake/portableBytes.ts +18 -0
  466. package/src/sharddev/bake/portableBytesMemo.ts +50 -0
  467. package/src/sharddev/bake/practiceCourse.ts +49 -0
  468. package/src/sharddev/bake/primitives.ts +96 -0
  469. package/src/sharddev/bake/props.ts +443 -0
  470. package/src/sharddev/bake/questPlacement.ts +98 -0
  471. package/src/sharddev/bake/rawTexture.ts +26 -0
  472. package/src/sharddev/bake/riderArms.ts +97 -0
  473. package/src/sharddev/bake/rig.ts +95 -0
  474. package/src/sharddev/bake/riggedHullRecipes.ts +40 -0
  475. package/src/sharddev/bake/signPlacements.ts +25 -0
  476. package/src/sharddev/bake/simplifier.ts +52 -0
  477. package/src/sharddev/bake/skinned.ts +312 -0
  478. package/src/sharddev/bake/slabChunks.ts +149 -0
  479. package/src/sharddev/bake/slabs.ts +263 -0
  480. package/src/sharddev/bake/source-loader.mjs +55 -0
  481. package/src/sharddev/bake/sourceMetadata.ts +54 -0
  482. package/src/sharddev/bake/species.ts +368 -0
  483. package/src/sharddev/bake/specimenCatalogue.ts +47 -0
  484. package/src/sharddev/bake/splatGround.ts +141 -0
  485. package/src/sharddev/bake/staticMaterials.ts +171 -0
  486. package/src/sharddev/bake/terrain.ts +195 -0
  487. package/src/sharddev/bake/texture.ts +33 -0
  488. package/src/sharddev/bake/textureWasm.ts +81 -0
  489. package/src/sharddev/bake/tileEncoder.ts +11 -0
  490. package/src/sharddev/bake/tileGrid.ts +62 -0
  491. package/src/sharddev/bake/v2Finite.ts +160 -0
  492. package/src/sharddev/bake/v2Fuel.ts +71 -0
  493. package/src/sharddev/bake/wholePartition.ts +74 -0
  494. package/src/sharddev/bake/wholePieceJoin.ts +147 -0
  495. package/src/sharddev/bake/world.ts +173 -0
  496. package/src/sharddev/bake/worldCollision.ts +128 -0
  497. package/src/sharddev/bake/worldGeometry.ts +237 -0
  498. package/src/sharddev/bake/worldGlb.ts +123 -0
  499. package/src/sharddev/bake/worldImage.ts +12 -0
  500. package/src/sharddev/bake/worldLod.ts +128 -0
  501. package/src/sharddev/bake/worldRows.ts +102 -0
  502. package/src/sharddev/bake/worldTextureMemo.ts +63 -0
  503. package/src/sharddev/bake/zstdBytesMemo.ts +52 -0
  504. package/src/sharddev/bake.ts +193 -0
  505. package/src/sharddev/bakePublication.ts +31 -0
  506. package/src/sharddev/behaviourSource.ts +94 -0
  507. package/src/sharddev/bin/wildshard.mjs +7 -0
  508. package/src/sharddev/blobBytes.ts +65 -0
  509. package/src/sharddev/blobs.ts +138 -0
  510. package/src/sharddev/bootInventory.ts +129 -0
  511. package/src/sharddev/bossProfiles.ts +18 -0
  512. package/src/sharddev/buildBehaviour.ts +77 -0
  513. package/src/sharddev/buildCacheMetrics.ts +17 -0
  514. package/src/sharddev/buildDecisionScripts.ts +122 -0
  515. package/src/sharddev/check.ts +118 -0
  516. package/src/sharddev/checkProject.ts +127 -0
  517. package/src/sharddev/cli.ts +200 -0
  518. package/src/sharddev/clientChannels.ts +169 -0
  519. package/src/sharddev/clientScripts.ts +10 -0
  520. package/src/sharddev/commons.ts +77 -0
  521. package/src/sharddev/commonsCosts.ts +11 -0
  522. package/src/sharddev/compileMovers.ts +11 -0
  523. package/src/sharddev/configBoundary.ts +6 -0
  524. package/src/sharddev/cookInput.ts +40 -0
  525. package/src/sharddev/crowds.ts +6 -0
  526. package/src/sharddev/decisionBindingMap.ts +11 -0
  527. package/src/sharddev/decisionScriptBindings.ts +117 -0
  528. package/src/sharddev/decisionScripts.ts +28 -0
  529. package/src/sharddev/decisionSource.ts +51 -0
  530. package/src/sharddev/dev.ts +113 -0
  531. package/src/sharddev/director.ts +26 -0
  532. package/src/sharddev/directorAbi.ts +77 -0
  533. package/src/sharddev/discoveryDocument.ts +97 -0
  534. package/src/sharddev/draft.ts +11 -0
  535. package/src/sharddev/eliteEntryRows.ts +29 -0
  536. package/src/sharddev/entries.ts +76 -0
  537. package/src/sharddev/entryReads.ts +73 -0
  538. package/src/sharddev/executeBundle.ts +55 -0
  539. package/src/sharddev/finds.ts +5 -0
  540. package/src/sharddev/formatJsonSchema.ts +3 -0
  541. package/src/sharddev/generationCache.ts +257 -0
  542. package/src/sharddev/generationRecipe.ts +94 -0
  543. package/src/sharddev/handwritten.ts +110 -0
  544. package/src/sharddev/immutable.ts +14 -0
  545. package/src/sharddev/interactions.ts +38 -0
  546. package/src/sharddev/kit/bakedGeometry.ts +16 -0
  547. package/src/sharddev/kit/geometryPack.ts +110 -0
  548. package/src/sharddev/ledger.ts +13 -0
  549. package/src/sharddev/looks/tileField.ts +67 -0
  550. package/src/sharddev/materialGraphFiles.ts +57 -0
  551. package/src/sharddev/materials.ts +574 -0
  552. package/src/sharddev/measure.ts +18 -0
  553. package/src/sharddev/modes.ts +115 -0
  554. package/src/sharddev/moverPrograms.ts +213 -0
  555. package/src/sharddev/movers.ts +75 -0
  556. package/src/sharddev/nativePopulationRows.ts +46 -0
  557. package/src/sharddev/newProject.ts +226 -0
  558. package/src/sharddev/noise.ts +54 -0
  559. package/src/sharddev/outputProduct.ts +188 -0
  560. package/src/sharddev/outputRuntime.ts +66 -0
  561. package/src/sharddev/performancePolicy.ts +29 -0
  562. package/src/sharddev/phasedBoss.ts +34 -0
  563. package/src/sharddev/physics.ts +194 -0
  564. package/src/sharddev/platformSections.ts +42 -0
  565. package/src/sharddev/plumbing.ts +8 -0
  566. package/src/sharddev/productOutput.ts +128 -0
  567. package/src/sharddev/project.ts +337 -0
  568. package/src/sharddev/projectCompilerIdentity.ts +94 -0
  569. package/src/sharddev/projectDecisions.ts +66 -0
  570. package/src/sharddev/projectEntryProof.ts +32 -0
  571. package/src/sharddev/projectGeneration.ts +219 -0
  572. package/src/sharddev/projectInputFiles.ts +47 -0
  573. package/src/sharddev/projectManifest.ts +108 -0
  574. package/src/sharddev/projectMap.ts +35 -0
  575. package/src/sharddev/projectOutput.ts +242 -0
  576. package/src/sharddev/projectPolicy.ts +17 -0
  577. package/src/sharddev/projectSections.ts +27 -0
  578. package/src/sharddev/questGraph.ts +25 -0
  579. package/src/sharddev/quests.ts +65 -0
  580. package/src/sharddev/random.ts +61 -0
  581. package/src/sharddev/refusals.ts +304 -0
  582. package/src/sharddev/reportCard.ts +13 -0
  583. package/src/sharddev/returnProjectionV2.ts +81 -0
  584. package/src/sharddev/rows.ts +192 -0
  585. package/src/sharddev/runtimeImports.ts +38 -0
  586. package/src/sharddev/runtimeMirrors.ts +39 -0
  587. package/src/sharddev/runtimePerformance.ts +38 -0
  588. package/src/sharddev/scene.ts +321 -0
  589. package/src/sharddev/sceneAnimation.ts +54 -0
  590. package/src/sharddev/sceneAudio.ts +64 -0
  591. package/src/sharddev/sceneDeclarations.ts +100 -0
  592. package/src/sharddev/sceneGraph.ts +139 -0
  593. package/src/sharddev/sceneTransform.ts +12 -0
  594. package/src/sharddev/schemaValidation.ts +61 -0
  595. package/src/sharddev/sections.ts +47 -0
  596. package/src/sharddev/shardSource.ts +59 -0
  597. package/src/sharddev/sourceReader.ts +26 -0
  598. package/src/sharddev/spawns.ts +38 -0
  599. package/src/sharddev/species/clips.ts +24 -0
  600. package/src/sharddev/species.ts +29 -0
  601. package/src/sharddev/speciesBrains.ts +19 -0
  602. package/src/sharddev/synth.ts +66 -0
  603. package/src/sharddev/test/compileDualScriptV2.ts +71 -0
  604. package/src/sharddev/test/compileSimV2.ts +21 -0
  605. package/src/sharddev/test/diskScriptScenario.ts +86 -0
  606. package/src/sharddev/test/scriptScenario.ts +249 -0
  607. package/src/sharddev/test/scriptSource.ts +12 -0
  608. package/src/sharddev/version.ts +4 -0
  609. package/src/sharddev/weapons/bowProfile.ts +20 -0
  610. package/src/sharddev/weapons/firearmRows.ts +11 -0
  611. package/src/sharddev/weapons/meleeProfile.ts +71 -0
  612. package/src/sharddev/weapons/thrownProfile.ts +10 -0
  613. package/src/sharddev/worldScenes.ts +308 -0
  614. package/src/sharddev/worldSource.ts +82 -0
  615. package/src/shards/_template/README.md +78 -0
  616. package/src/shards/_template/assets/2bf489fdb15f1734ddb4c4f32d500ec6da85c765ec7a4eb28dc6781160e7ec8c +0 -0
  617. package/src/shards/_template/assets/97ec4d8f75f5fa6239ee919444d6dc19fd35896bb305930c1f050ac6e0e0e6a6 +1 -0
  618. package/src/shards/_template/assets/a6a587a31327f936b1b04c05ade818c73fc8964260918662db43539465e27586 +0 -0
  619. package/src/shards/_template/assets/b4fbde0422e125b498c3dc8b9a5cc2516c8598f09e9d0e5f6b639b32f98179e6 +0 -0
  620. package/src/shards/_template/assets/bfa4dfc9c18979f904557ee8deab0058b8a399be10266f5fb1578b403f482fd4 +1 -0
  621. package/src/shards/_template/assets/ef3b7ff4fd22715771cb7d68a3977a903c5e7c3dc293542687d04b3ef3ace2cb +0 -0
  622. package/src/shards/_template/assets/f2db05998615ce1cb79ea96be32c168842eb6a2b34ec01feb86d36404603ee54 +0 -0
  623. package/src/shards/_template/assets/fef98ebb7fce6f66b26e78ac699e5c90f9bdcfaf8cabeb2b58125347eea8b4ab +0 -0
  624. package/src/shards/_template/behaviour/boss.as +39 -0
  625. package/src/shards/_template/behaviour/door.as +32 -0
  626. package/src/shards/_template/behaviour/hooks.json +129 -0
  627. package/src/shards/_template/behaviour/idle.as +75 -0
  628. package/src/shards/_template/behaviour/items.as +22 -0
  629. package/src/shards/_template/card/landscape.jpg +0 -0
  630. package/src/shards/_template/card/portrait.jpg +0 -0
  631. package/src/shards/_template/card/thumb.jpg +0 -0
  632. package/src/shards/_template/data/audio.json +45 -0
  633. package/src/shards/_template/data/bossDecision.json +83 -0
  634. package/src/shards/_template/data/budgets.json +70 -0
  635. package/src/shards/_template/data/card.json +281 -0
  636. package/src/shards/_template/data/clientScripts.json +987 -0
  637. package/src/shards/_template/data/creatures.json +65 -0
  638. package/src/shards/_template/data/director.json +39 -0
  639. package/src/shards/_template/data/encounters.json +96 -0
  640. package/src/shards/_template/data/items.json +172 -0
  641. package/src/shards/_template/data/layout.json +66 -0
  642. package/src/shards/_template/data/ledger.json +32 -0
  643. package/src/shards/_template/data/look.json +521 -0
  644. package/src/shards/_template/data/map.json +64 -0
  645. package/src/shards/_template/data/moves.json +16 -0
  646. package/src/shards/_template/data/placeholder.json +8 -0
  647. package/src/shards/_template/data/plumbing.json +32 -0
  648. package/src/shards/_template/data/quests.json +223 -0
  649. package/src/shards/_template/data/rows.json +423 -0
  650. package/src/shards/_template/data/skins.json +66 -0
  651. package/src/shards/_template/data/spawn.json +6 -0
  652. package/src/shards/_template/data/targets.json +150 -0
  653. package/src/shards/_template/data/text.json +12 -0
  654. package/src/shards/_template/data/ui.json +33 -0
  655. package/src/shards/_template/data/water.json +13 -0
  656. package/src/shards/_template/generators/behaviour.ts +34 -0
  657. package/src/shards/_template/generators/boss.ts +29 -0
  658. package/src/shards/_template/generators/buildOptions.ts +2 -0
  659. package/src/shards/_template/generators/cell.ts +224 -0
  660. package/src/shards/_template/generators/districts.ts +215 -0
  661. package/src/shards/_template/generators/farLook.ts +15 -0
  662. package/src/shards/_template/generators/generate.ts +27 -0
  663. package/src/shards/_template/generators/ground.ts +15 -0
  664. package/src/shards/_template/generators/kit.ts +69 -0
  665. package/src/shards/_template/generators/landscape.ts +59 -0
  666. package/src/shards/_template/generators/landscapeNoise.ts +62 -0
  667. package/src/shards/_template/generators/mapInputs.ts +10 -0
  668. package/src/shards/_template/generators/product.ts +100 -0
  669. package/src/shards/_template/generators/productOutput.ts +18 -0
  670. package/src/shards/_template/generators/props.ts +9 -0
  671. package/src/shards/_template/generators/templatePropsSource.ts +58 -0
  672. package/src/shards/_template/generators/terrain.ts +17 -0
  673. package/src/shards/_template/generators/world.ts +630 -0
  674. package/src/shards/_template/hero.json +10 -0
  675. package/src/shards/_template/look/entry-reads.json +20 -0
  676. package/src/shards/_template/manifest.json +281 -0
  677. package/src/shards/_template/shard.config.ts +10 -0
  678. package/src/shared/health.ts +10 -0
  679. package/src/tools/build-web.ts +59 -0
  680. package/src/tsconfig.json +30 -0
  681. package/src/web/app.tsx +53 -0
  682. package/src/web/index.html +12 -0
  683. package/src/web/main.tsx +10 -0
  684. package/src/web/tsconfig.json +13 -0
  685. package/tsconfig.author.json +23 -0
  686. package/tsconfig.commons.json +21 -0
  687. package/tsconfig.json +47 -0
  688. package/tsconfig.sharddev.json +20 -0
@@ -0,0 +1,258 @@
1
+ import {
2
+ array,
3
+ boolean,
4
+ nullable,
5
+ number,
6
+ object,
7
+ optional,
8
+ safeParse,
9
+ string,
10
+ tuple,
11
+ } from 'valibot'
12
+
13
+ // `wildshard delete <slug>` (meta SHARD-DELETE DEL10, J307, J310): the
14
+ // owner's two calls back to back. Start (`POST /api/shards/:slug/delete`)
15
+ // answers a confirm token, good for 10 minutes, and a summary whose `note`
16
+ // says whether a signed release still plays the shard (DEL8); the author
17
+ // reads it and types the slug; finalize (`…/delete/finalize {confirm}`)
18
+ // spends the token. A typed slug that is not the slug finalizes nothing,
19
+ // and `yes` (`--yes`, for scripts) skips the typing. Both calls send the
20
+ // account key as `Authorization: Bearer`; the key and the token are never
21
+ // printed.
22
+
23
+ const OK = 200
24
+ const CONFLICT = 409
25
+ const SHORT_HASH = 8
26
+ const FIRST = 0
27
+
28
+ const ErrorSchema = object({ error: string() })
29
+ const VersionSchema = object({ version: string(), hash: string() })
30
+ const PointerSchema = object({ channel: string() })
31
+ const CellSchema = array(number())
32
+ const FreedSchema = tuple([number(), number()])
33
+ const PlacedSchema = object({ channel: string(), cells: array(CellSchema) })
34
+
35
+ const SummarySchema = object({
36
+ deleted: optional(boolean()),
37
+ versions: array(VersionSchema),
38
+ channels: array(PointerSchema),
39
+ grid: optional(array(PlacedSchema)),
40
+ note: optional(string()),
41
+ })
42
+
43
+ const StartSchema = object({
44
+ confirm: string(),
45
+ expiresAt: string(),
46
+ summary: SummarySchema,
47
+ })
48
+
49
+ const ChannelsSchema = array(string())
50
+
51
+ const FinalizeSchema = object({
52
+ deletedAt: string(),
53
+ channels: ChannelsSchema,
54
+ placements: ChannelsSchema,
55
+ /** The channels whose grid cells named the slug (api-server SA31). */
56
+ cells: optional(ChannelsSchema),
57
+ /** The slug's own grid cell, freed for the next new slug; null: it held none (SA31). */
58
+ freed: optional(nullable(FreedSchema)),
59
+ })
60
+
61
+ /** What finalize did, as the API answers it. */
62
+ type Finalized = Readonly<{
63
+ deletedAt: string
64
+ channels: readonly string[]
65
+ placements: readonly string[]
66
+ cells?: readonly string[] | undefined
67
+ freed?: readonly [number, number] | null | undefined
68
+ }>
69
+
70
+ type Started = Readonly<{
71
+ confirm: string
72
+ expiresAt: string
73
+ summary: Readonly<{
74
+ deleted?: boolean | undefined
75
+ versions: readonly Readonly<{ version: string; hash: string }>[]
76
+ channels: readonly Readonly<{ channel: string }>[]
77
+ grid?: readonly Placed[] | undefined
78
+ note?: string | undefined
79
+ }>
80
+ }>
81
+
82
+ type Placed = Readonly<{
83
+ channel: string
84
+ cells: readonly (readonly number[])[]
85
+ }>
86
+
87
+ interface DeleteOptions {
88
+ /** The api-server origin. */
89
+ readonly server: string
90
+ /** The owner's `wsk_` key. */
91
+ readonly apiKey: string
92
+ readonly slug: string
93
+ /** Skip the typed slug (`--yes`). */
94
+ readonly yes: boolean
95
+ /** Print the prompt and read one typed line; undefined when none comes. */
96
+ readonly ask: (prompt: string) => Promise<string | undefined>
97
+ readonly report: (line: string) => void
98
+ }
99
+
100
+ function jsonOf(text: string): unknown {
101
+ try {
102
+ const value: unknown = JSON.parse(text)
103
+ return value
104
+ } catch {
105
+ return undefined
106
+ }
107
+ }
108
+
109
+ function reasonOf(body: unknown): string {
110
+ const parsed = safeParse(ErrorSchema, body)
111
+ return parsed.success ? parsed.output.error : 'not an api-server reply'
112
+ }
113
+
114
+ /** One delete call: its status and parsed body. */
115
+ async function call(
116
+ options: DeleteOptions,
117
+ route: string,
118
+ body?: unknown,
119
+ ): Promise<Readonly<{ status: number; body: unknown }>> {
120
+ const slug = encodeURIComponent(options.slug)
121
+ const reply = await fetch(
122
+ new URL(`/api/shards/${slug}/${route}`, options.server),
123
+ {
124
+ method: 'POST',
125
+ headers: {
126
+ authorization: `Bearer ${options.apiKey}`,
127
+ 'content-type': 'application/json',
128
+ },
129
+ body: JSON.stringify(body ?? {}),
130
+ },
131
+ )
132
+ return { status: reply.status, body: jsonOf(await reply.text()) }
133
+ }
134
+
135
+ async function startDelete(options: DeleteOptions): Promise<Started> {
136
+ const reply = await call(options, 'delete')
137
+ const parsed = safeParse(StartSchema, reply.body)
138
+ if (reply.status !== OK || !parsed.success) {
139
+ throw new Error(
140
+ `delete ${options.slug}: start answered ${String(reply.status)}: ${reasonOf(reply.body)}`,
141
+ )
142
+ }
143
+ return parsed.output
144
+ }
145
+
146
+ function listed(names: readonly string[]): string {
147
+ return names.length === FIRST ? 'none' : names.join(', ')
148
+ }
149
+
150
+ /** Each grid cell placing the slug: `staging [2, 3]`. */
151
+ function gridCells(grid: readonly Placed[] | undefined): readonly string[] {
152
+ return (grid ?? []).flatMap((row: Placed): string[] =>
153
+ row.cells.map(
154
+ (cell: readonly number[]): string =>
155
+ `${row.channel} [${cell.join(', ')}]`,
156
+ ),
157
+ )
158
+ }
159
+
160
+ /** What start found, in the author's words. */
161
+ function summaryLines(slug: string, started: Started): readonly string[] {
162
+ const { summary } = started
163
+ const versions = summary.versions.map(
164
+ (row: Readonly<{ version: string; hash: string }>): string =>
165
+ `${row.version} ${row.hash.slice(FIRST, SHORT_HASH)}`,
166
+ )
167
+ const channels = summary.channels.map(
168
+ (row: Readonly<{ channel: string }>): string => row.channel,
169
+ )
170
+ return [
171
+ `delete ${slug}: ${String(versions.length)} versions (${listed(versions)})`,
172
+ `channels pointing at it: ${listed(channels)}`,
173
+ `grid cells placing it: ${listed(gridCells(summary.grid))}`,
174
+ ...(summary.note === undefined ? [] : [summary.note]),
175
+ ...(summary.deleted === true
176
+ ? [`${slug} is deleted already: finalize changes nothing`]
177
+ : []),
178
+ `the confirm token lasts until ${started.expiresAt} (10 minutes)`,
179
+ ]
180
+ }
181
+
182
+ /** What finalize did, in the author's words; the last line says deleted. */
183
+ function doneLines(slug: string, done: Finalized): readonly string[] {
184
+ const cells =
185
+ done.cells === undefined
186
+ ? ''
187
+ : `; grid cells dropped on: ${listed(done.cells)}`
188
+ const freed =
189
+ done.freed === undefined
190
+ ? ''
191
+ : `; grid cell freed: ${done.freed === null ? 'none' : `[${done.freed.join(', ')}]`}`
192
+ return [
193
+ `pointers dropped on: ${listed(done.channels)}; solo placements dropped on: ${listed(done.placements)}${cells}${freed}`,
194
+ `deleted ${slug} at ${done.deletedAt}: hidden from the catalogue and every grid`,
195
+ ]
196
+ }
197
+
198
+ async function finalizeDelete(
199
+ options: DeleteOptions,
200
+ confirm: string,
201
+ ): Promise<readonly string[]> {
202
+ const { slug } = options
203
+ const reply = await call(options, 'delete/finalize', { confirm })
204
+ const parsed = safeParse(FinalizeSchema, reply.body)
205
+ const reason = reasonOf(reply.body)
206
+ if (reply.status === CONFLICT && reason.includes('confirm token')) {
207
+ throw new Error(
208
+ `delete ${slug}: finalize answered 409: ${reason}. Nothing was deleted; start again with wildshard delete ${slug}`,
209
+ )
210
+ }
211
+ if (reply.status !== OK || !parsed.success) {
212
+ throw new Error(
213
+ `delete ${slug}: finalize answered ${String(reply.status)}: ${reason}`,
214
+ )
215
+ }
216
+ return doneLines(slug, parsed.output)
217
+ }
218
+
219
+ /** Why the author's answer does not confirm the delete, if it doesn't. */
220
+ async function notConfirmed(
221
+ options: DeleteOptions,
222
+ ): Promise<string | undefined> {
223
+ const { slug } = options
224
+ if (options.yes) {
225
+ return undefined
226
+ }
227
+ const typed = await options.ask(
228
+ `type ${slug} to delete it (anything else keeps it): `,
229
+ )
230
+ if (typed?.trim() === slug) {
231
+ return undefined
232
+ }
233
+ const what = typed === undefined ? 'nothing' : `"${typed.trim()}"`
234
+ return `delete ${slug} not confirmed: you typed ${what}, not ${slug}, so nothing was deleted`
235
+ }
236
+
237
+ /**
238
+ * Start, show the summary, take the typed slug (unless `yes`), finalize.
239
+ * Undefined once deleted, or why nothing was deleted.
240
+ */
241
+ async function deleteShard(
242
+ options: DeleteOptions,
243
+ ): Promise<string | undefined> {
244
+ const started = await startDelete(options)
245
+ for (const line of summaryLines(options.slug, started)) {
246
+ options.report(line)
247
+ }
248
+ const refused = await notConfirmed(options)
249
+ if (refused !== undefined) {
250
+ return refused
251
+ }
252
+ for (const line of await finalizeDelete(options, started.confirm)) {
253
+ options.report(line)
254
+ }
255
+ return undefined
256
+ }
257
+
258
+ export { type DeleteOptions, deleteShard }
@@ -0,0 +1,204 @@
1
+ import { DEFAULT_BROTLI_LEVEL } from './upload/compress.ts'
2
+
3
+ // SHARD-AUTHORING SA2 (J317): every verb's help in the glossary's words (meta
4
+ // docs/architecture/README.md § Glossary): shard source, shard file, build
5
+ // (which bakes), check, hero, prepare, upload, channel, flip. Never product,
6
+ // publish (for an upload), promote, cook, head or tarball; `pack` only as the
7
+ // deprecated alias below. Flag names stay as they are, retired word or not:
8
+ // renaming one breaks scripts. help.test.ts greps every verb's help for the
9
+ // retired words. bin/wildshard.mjs prints `wildshard <verb> --help` from here.
10
+
11
+ const LEVEL = String(DEFAULT_BROTLI_LEVEL)
12
+
13
+ /** The deprecated alias's whole entry: the one place help may say pack. */
14
+ const PACK_ALIAS = `pack <folder> [--out <file>]
15
+ Deprecated alias: wildshard build <folder> [file]`
16
+
17
+ /** Each verb's entry: its usage lines, then what it does, indented. */
18
+ const VERBS: Readonly<Record<string, string>> = {
19
+ new: `new <dir> [slug] [--template sdk|blender] [--empty]
20
+ Start a shard repo in <dir>, a folder that does not
21
+ exist yet, with its shard source at src/ (slug: the
22
+ folder's name unless given). --template sdk (the
23
+ default) copies the reference world; --template
24
+ blender copies the hand-written Blender template
25
+ (a shard file folder, no code). --empty writes a
26
+ bare shard source instead`,
27
+ update: `update [dir]
28
+ Rewrite GUIDE.md and the four wildshard skills in
29
+ .claude/skills/ from the installed sdk (dir: the
30
+ shard repo, default the current folder). Adds the
31
+ .agents/skills links, AGENTS.md and CLAUDE.md if
32
+ missing; touches nothing else, and leaves an
33
+ AGENTS.md you changed (it says so). Run it after
34
+ moving to a newer sdk. --pins is not built yet`,
35
+ dev: `dev <source> [port]
36
+ Serve the shard source on localhost (port 0, the
37
+ default, picks a free one) and build it again on
38
+ every edit`,
39
+ check: `check <source> [folder] [--json]
40
+ Lint, build, validate, prove (with the shard
41
+ source's proof.json) and read the report card, then
42
+ give one verdict. --json prints only the verdict
43
+ document: { version, verdict, project, output, ms,
44
+ steps: [{ name, status, ms, note? }], refusals:
45
+ [{ step, rule, message, fix, guide, file? }],
46
+ warnings: [the same] }. Every refusal names its
47
+ rule, a fix and its GUIDE.md section. A warning (an
48
+ unprepared draft) does not fail the verdict. Exits 1
49
+ on fail`,
50
+ hero: `hero <source> --base <served-build-url>
51
+ Capture the shard's hero (thumb, portrait,
52
+ landscape) in headless Chromium from a served build
53
+ of this candidate, and stamp hero.json with its
54
+ content
55
+ hero <source> --stamp-existing
56
+ No capture: stamp the hero images already in the
57
+ shard source as current. WARNING: use it ONLY when
58
+ those images show the current content; a wrong
59
+ stamp hides a stale hero from the cut`,
60
+ upload: `upload <file> --channel staging|prod [--server <url>]
61
+ [--level <n>] [--version <X.Y.Z>] [--commit <sha>] [--no-place]
62
+ Check a shard file (an unprepared draft, sdk 0.2,
63
+ is refused before anything is sent), compress it
64
+ (Brotli level <n>, default ${LEVEL}), sign it with the
65
+ creator key and upload it to the API. The channel
66
+ is required: staging flips the preview and staging
67
+ pointers, prod flips all three (production too).
68
+ Sends the shard source version (default: the shard
69
+ source's package.json version), the shard source
70
+ commit (default: the checked-out commit of a clean
71
+ tree) and the sdk, engine and shard-format releases
72
+ it was built with. Refuses a hero unchanged since
73
+ the shard's newest upload (run hero first). Prints
74
+ the API's version, format version and migrations,
75
+ then the grid: the shard's cell ("placed at (0,3)
76
+ on preview, staging"), "grid full, not placed",
77
+ "not placed (--no-place)", or "no new cell" while
78
+ the API's placement is off or past the shard's
79
+ first upload; then the /slug/<slug> link on each
80
+ channel the upload moved (that page is not built
81
+ yet). --no-place takes no grid cell, for a proof
82
+ upload. Only a shard's first upload takes a cell,
83
+ so one uploaded with --no-place never gets one; on
84
+ a later upload --no-place leaves the grid as it
85
+ was, so a prod upload adds no production cell.
86
+ Sends your account key (WILDSHARD_API_KEY, else
87
+ the file wildshard account saved; with neither it
88
+ refuses before anything is sent). Reads
89
+ WILDSHARD_API_URL when --server is absent,
90
+ WILDSHARD_CREATOR_PRIVATE_KEY, and
91
+ VERCEL_AUTOMATION_BYPASS_SECRET for a protected
92
+ preview`,
93
+ account: `account <email> [--server <url>] [--force]
94
+ Make your Wildshard account (no mail is sent) and
95
+ save its key to ~/.config/wildshard/sharddev-key
96
+ (mode 600) for upload to send. The API shows a key
97
+ once: an email that has an account is refused, and
98
+ a lost key needs an operator reset. A saved key is
99
+ never replaced without --force. Reads
100
+ WILDSHARD_API_URL when --server is absent`,
101
+ whoami: `whoami [--server <url>]
102
+ Print where upload's account key comes from
103
+ (WILDSHARD_API_KEY, else the key file) and its
104
+ first characters, never the whole key, then the
105
+ key's account: its email and how many slugs it
106
+ owns. Reads WILDSHARD_API_URL when --server is
107
+ absent`,
108
+ delete: `delete <slug> [--yes] [--server <url>]
109
+ Delete your shard: it leaves the catalogue, every
110
+ channel and the grid at once. Prints what it would
111
+ delete (its versions, the channels pointing at it,
112
+ and whether a signed release still plays it until
113
+ its next release), then asks you to type the slug;
114
+ anything else deletes nothing. The confirmation
115
+ lasts 10 minutes. --yes skips typing, for scripts.
116
+ Sends your account key, as upload does; only the
117
+ key that uploaded the shard deletes it. Reads
118
+ WILDSHARD_API_URL when --server is absent`,
119
+ build: `build <source> [folder] [--shardfile-only | --folder-only]
120
+ [--no-placeholders] [--output=<slug>]
121
+ Build the shard source: bake it into a shard file
122
+ folder (default <source>/public/shardfiles/<slug>),
123
+ then write the shard file <slug>.shardfile beside
124
+ it and run shard-format's checks on it. Refuses a
125
+ shard whose captured hero is older than its content
126
+ (hero.json) and prints the audio rules. What it
127
+ writes is a draft (sdk 0.2): it warns that the API
128
+ and upload refuse a draft until prepare makes it
129
+ sdk 0.3. --shardfile-only skips the web client;
130
+ --folder-only also skips the shard file
131
+ build <folder> [file]
132
+ Write the shard file of a built shard file folder
133
+ (default <slug>.shardfile beside it), with the same
134
+ checks
135
+ build <source> --behaviour-only [--check]
136
+ Build only the shard source's native behaviour
137
+ outputs; --check refuses stale ones and writes
138
+ nothing`,
139
+ prepare: `prepare <folder> --base <exact-preview-url>
140
+ Record the shard file folder in phone WebKit against
141
+ an exact engine preview and write its author
142
+ preparation (the fence, the fence policy and the
143
+ recorded programs): the draft becomes sdk 0.3, the
144
+ only kind upload sends. Then write its shard file
145
+ with build <folder>`,
146
+ validate: `validate <source | folder | shard.json>
147
+ Validate a shard source, or a built shard file
148
+ folder with shard-format's checks, and run it
149
+ headlessly against its budgets`,
150
+ prove: `prove <source | folder | shard.json> <proof.json>
151
+ Play the proof tape headlessly and print what
152
+ happened as JSON`,
153
+ synth: `synth <source>
154
+ Run shard.config.ts's scene and identity exports in
155
+ Node and write the scene they describe as data`,
156
+ schema: `schema [list|shardfile|<root>] [JSON-pointer]
157
+ Print the JSON Schema of shard.json (\`shardfile\`) or
158
+ of one section (<root>), or of the part at a JSON
159
+ pointer; list names every root`,
160
+ serve: `serve [--port <n>] Start the sharddev server on localhost`,
161
+ 'build-shards': `build-shards [--shard=<slug>[,<slug>]] [--reuse]
162
+ Build every shard source under src/shards into its
163
+ shard file folders (one per output) under out/.
164
+ --shard builds only those outputs; --reuse keeps a
165
+ folder whose inputs are unchanged`,
166
+ pack: PACK_ALIAS,
167
+ }
168
+
169
+ /** Indent every line of a verb's entry for the full help. */
170
+ function indented(entry: string): string {
171
+ return entry
172
+ .split('\n')
173
+ .map((line: string): string => (line.startsWith(' ') ? line : ` ${line}`))
174
+ .join('\n')
175
+ }
176
+
177
+ const USAGE = `Usage: wildshard <command> [options]
178
+
179
+ The loop: new, dev, check, hero, upload. A shard source builds a shard file;
180
+ upload sends it to the API for a channel.
181
+
182
+ Commands:
183
+ ${Object.values(VERBS)
184
+ .map((entry: string): string => indented(entry))
185
+ .join('\n')}
186
+
187
+ Options:
188
+ --version Print the sdk, engine, shard-format and three
189
+ versions (after upload: the shard source version)
190
+ --help Print this help (after a command: that command's)
191
+
192
+ Also installed as \`sharddev\`. wildshard help <command> prints one command.
193
+ `
194
+
195
+ /** The verbs help knows, in the order the full help lists them. */
196
+ const HELP_VERBS: readonly string[] = Object.keys(VERBS)
197
+
198
+ /** One verb's help, or undefined for a verb help does not know. */
199
+ function verbHelp(verb: string): string | undefined {
200
+ const entry = Object.hasOwn(VERBS, verb) ? VERBS[verb] : undefined
201
+ return entry === undefined ? undefined : `Usage: wildshard ${entry}\n`
202
+ }
203
+
204
+ export { HELP_VERBS, PACK_ALIAS, USAGE, verbHelp }
@@ -0,0 +1,103 @@
1
+ import { access } from 'node:fs/promises'
2
+ import path from 'node:path'
3
+
4
+ import {
5
+ MANIFEST,
6
+ NONE,
7
+ STAMP,
8
+ heroSlotFiles,
9
+ heroState,
10
+ isMissing,
11
+ readJson,
12
+ writeHeroStamp,
13
+ } from './stamp.ts'
14
+
15
+ // `wildshard hero <shard> --stamp-existing`: a shard repo gains the hero check
16
+ // (stamp.ts) when it bumps its sharddev pin, with curated heroes and no stamp.
17
+ // Recapturing from the spawn view would put a plain shot over good art, so
18
+ // this stamps the files already there, with no capture. Only right when those
19
+ // images show the current content. A stamp whose content no longer matches is
20
+ // refused: there the world has moved past the picture, and only a capture fixes
21
+ // it.
22
+
23
+ const ADOPTED =
24
+ 'stamp-existing: the hero files already in the shard, adopted without a capture'
25
+
26
+ interface Adopted {
27
+ /** False when the stamp was already current and nothing was written. */
28
+ readonly written: boolean
29
+ readonly content: string
30
+ }
31
+
32
+ async function exists(file: string): Promise<boolean> {
33
+ try {
34
+ await access(file)
35
+ return true
36
+ } catch (error: unknown) {
37
+ if (isMissing(error)) {
38
+ return false
39
+ }
40
+ throw error
41
+ }
42
+ }
43
+
44
+ /** Refuse a generated card or a card file that is not on disk. */
45
+ async function assertCardFiles(shard: string): Promise<void> {
46
+ const files = Object.entries(await heroSlotFiles(shard))
47
+ if (files.length === NONE) {
48
+ throw new Error(
49
+ `${path.join(shard, MANIFEST)}: the card is generated (data: urls), so there are no hero files to stamp`,
50
+ )
51
+ }
52
+ const present = await Promise.all(
53
+ files.map(
54
+ async ([, file]: readonly [string, string]): Promise<boolean> =>
55
+ await exists(file),
56
+ ),
57
+ )
58
+ const gone = files.filter(
59
+ (_entry: unknown, at: number): boolean => present[at] !== true,
60
+ )
61
+ if (gone.length > NONE) {
62
+ const named = gone.map(
63
+ ([slot, file]: readonly [string, string]): string =>
64
+ `card.${slot} (${path.relative(shard, file).split(path.sep).join('/')})`,
65
+ )
66
+ throw new Error(`${named.join(', ')} not there; nothing stamped`)
67
+ }
68
+ }
69
+
70
+ /** Refuse a hero.json that does not parse: it may declare a camera. */
71
+ async function assertStampReadable(shard: string): Promise<void> {
72
+ try {
73
+ await readJson(path.join(shard, STAMP))
74
+ } catch (error: unknown) {
75
+ throw new Error(
76
+ `${path.join(shard, STAMP)} does not parse; fix it by hand, nothing stamped`,
77
+ { cause: error },
78
+ )
79
+ }
80
+ }
81
+
82
+ /**
83
+ * Stamp the hero files on disk as showing the content now, keeping a
84
+ * declared camera. Only an unstamped hero, or hand-swapped hero files over
85
+ * unchanged content, is stamped; a current stamp is left alone.
86
+ */
87
+ async function stampExistingHero(shard: string): Promise<Adopted> {
88
+ await assertCardFiles(shard)
89
+ await assertStampReadable(shard)
90
+ const hero = await heroState(shard)
91
+ if (hero.state === 'fresh') {
92
+ return { written: false, content: hero.content }
93
+ }
94
+ if (hero.stamped !== undefined && hero.stamped !== hero.content) {
95
+ throw new Error(
96
+ `the hero of ${path.basename(shard)} was stamped for other content (captured ${hero.captured ?? 'at an unknown time'}); the world has changed since, so only a capture fixes it, nothing stamped`,
97
+ )
98
+ }
99
+ const stamp = await writeHeroStamp(shard, { base: ADOPTED })
100
+ return { written: true, content: stamp.content }
101
+ }
102
+
103
+ export { stampExistingHero }
@@ -0,0 +1,112 @@
1
+ import { readdir } from 'node:fs/promises'
2
+ import path from 'node:path'
3
+
4
+ import {
5
+ MANIFEST,
6
+ NONE,
7
+ STAMP,
8
+ UNKNOWN_TIME,
9
+ cardHashes,
10
+ heroState,
11
+ readJson,
12
+ } from './stamp.ts'
13
+
14
+ import type { HeroState } from './stamp.ts'
15
+
16
+ // The cut's hero check (`wildshard build`, as it writes the shard file, SA3): see stamp.ts for what the stamp
17
+ // records. Jake, 2026-11-12 17:14 Cancún: "you have to update the hero
18
+ // images for the templates."
19
+
20
+ const CAPTURE = 'pnpm exec wildshard hero'
21
+
22
+ /** The shard source as the author names it: `src` in a single-shard repo (J317), else `src/shards/<name>`. */
23
+ function sourceOperand(shard: string): string {
24
+ return path.basename(shard) === 'src'
25
+ ? 'src'
26
+ : `src/shards/${path.basename(shard)}`
27
+ }
28
+
29
+ /** The capture command a refusal names, run from the shard project root. */
30
+ function captureCommand(shard: string): string {
31
+ return `${CAPTURE} ${sourceOperand(shard)} --base <served-build-url>`
32
+ }
33
+
34
+ /** The no-capture stamp, for hero files that already show this content. */
35
+ function stampExistingCommand(shard: string): string {
36
+ return `${CAPTURE} ${sourceOperand(shard)} --stamp-existing`
37
+ }
38
+
39
+ /** The source shard folder of a product built at `<root>/out/<name>`. */
40
+ function sourceShard(product: string): string {
41
+ const resolved = path.resolve(product)
42
+ const root = path.dirname(path.dirname(resolved))
43
+ return path.join(root, 'src', 'shards', path.basename(resolved))
44
+ }
45
+
46
+ /** Every file name in the product, without its extension: blobs are named by hash. */
47
+ async function productHashes(product: string): Promise<ReadonlySet<string>> {
48
+ const entries = await readdir(product, { recursive: true })
49
+ return new Set(entries.map((entry: string): string => path.parse(entry).name))
50
+ }
51
+
52
+ /** Refuse a product built before the stamped hero was captured. */
53
+ async function assertProductCarries(
54
+ product: string,
55
+ shard: string,
56
+ ): Promise<void> {
57
+ const card = await cardHashes(shard)
58
+ const held = await productHashes(product)
59
+ const missing = Object.keys(card).filter(
60
+ (name: string): boolean => !held.has(card[name] ?? ''),
61
+ )
62
+ if (missing.length > NONE) {
63
+ throw new Error(
64
+ `the shard file folder ${product} does not carry the captured hero (${missing.join(', ')}); it was built before the capture: rebuild it (pnpm build:shards), then build its shard file`,
65
+ )
66
+ }
67
+ }
68
+
69
+ /** Why a hero that is neither fresh nor generated stops the cut, and the fix. */
70
+ function refusal(shard: string, hero: HeroState): string {
71
+ const name = path.basename(shard)
72
+ const capture = `serve this candidate in an engine build, then capture it: ${captureCommand(shard)}`
73
+ const adopt = `; or, only if the images already there show this content, stamp them with no capture: ${stampExistingCommand(shard)}`
74
+ if (hero.state === 'unstamped') {
75
+ return `the hero of ${name} has no ${STAMP} stamp, so nothing says it shows this content; ${capture}${adopt}`
76
+ }
77
+ const captured = hero.captured ?? UNKNOWN_TIME
78
+ return hero.stamped === hero.content
79
+ ? `the hero files of ${name} are not the ones stamped (captured ${captured}), though the content is unchanged; ${capture}${adopt}`
80
+ : `the hero of ${name} is older than its content (captured ${captured}); ${capture}`
81
+ }
82
+
83
+ /**
84
+ * The cut's check. A built product lives at `<root>/out/<name>` and its
85
+ * source at `<root>/src/shards/<name>`. Throws for a stale or unstamped
86
+ * hero; reports and passes a generated card or a product with no source.
87
+ */
88
+ async function assertHeroCurrent(
89
+ product: string,
90
+ report: (line: string) => void,
91
+ source?: string,
92
+ ): Promise<void> {
93
+ // SA3: `build` names the project it built; a bare folder is read by layout.
94
+ const shard = source ?? sourceShard(product)
95
+ if ((await readJson(path.join(shard, MANIFEST))) === undefined) {
96
+ report(`hero: no source shard with a ${MANIFEST} at ${shard}; not checked`)
97
+ return
98
+ }
99
+ const hero = await heroState(shard)
100
+ if (hero.state === 'fresh') {
101
+ await assertProductCarries(product, shard)
102
+ report(`hero: current (captured ${hero.captured ?? UNKNOWN_TIME})`)
103
+ } else if (hero.state === 'generated') {
104
+ report(
105
+ `hero: generated card, no captured hero; capture one: ${captureCommand(shard)}`,
106
+ )
107
+ } else {
108
+ throw new Error(refusal(shard, hero))
109
+ }
110
+ }
111
+
112
+ export { assertHeroCurrent }