@playcraft/cli 0.1.40-beta → 0.1.41-prod

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 (368) hide show
  1. package/README.md +3 -58
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build-all.js +19 -5
  5. package/dist/commands/build.js +28 -15
  6. package/dist/commands/create.js +33 -26
  7. package/dist/commands/image.js +6 -2
  8. package/dist/commands/login.js +42 -84
  9. package/dist/commands/skills.js +0 -4
  10. package/dist/commands/tools-3d.js +0 -11
  11. package/dist/commands/tools-generation.js +137 -69
  12. package/dist/commands/tools-image-context.js +29 -0
  13. package/dist/commands/tools-utils.js +12 -0
  14. package/dist/commands/tools.js +2 -2
  15. package/dist/config.js +4 -59
  16. package/dist/index.js +3 -40
  17. package/dist/remix/clone.js +0 -2
  18. package/dist/remix/init-template.js +0 -2
  19. package/dist/remix/pull.js +0 -2
  20. package/dist/remix/push.js +1 -21
  21. package/dist/utils/agent-api-client.js +30 -185
  22. package/dist/utils/image-asset-context.js +228 -0
  23. package/dist/utils/playcraft-http-client.js +4 -6
  24. package/package.json +3 -13
  25. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  26. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  29. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  30. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  31. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  35. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  36. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  37. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  41. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  42. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  43. package/SKILLS_REGISTRY.md +0 -149
  44. package/dist/auth/account-activation.js +0 -157
  45. package/dist/auth/messages.js +0 -30
  46. package/dist/commands/build-temp.js +0 -26
  47. package/dist/commands/platform-skills.generated.js +0 -19
  48. package/dist/commands/playable.js +0 -53
  49. package/dist/commands/tools-batch.js +0 -87
  50. package/dist/commands/video.js +0 -111
  51. package/dist/commands/workspace-runtime.js +0 -54
  52. package/dist/commands/workspace.js +0 -35
  53. package/dist/project-skills/builtin-import.js +0 -225
  54. package/dist/project-skills/commands.js +0 -77
  55. package/dist/project-skills/lifecycle.js +0 -28
  56. package/dist/project-skills/local-run.js +0 -112
  57. package/dist/project-skills/local-store.js +0 -221
  58. package/dist/project-skills/messages.js +0 -80
  59. package/dist/project-skills/reconcile.js +0 -62
  60. package/dist/project-skills/remote-cache.js +0 -51
  61. package/dist/project-skills/validation.js +0 -19
  62. package/dist/recording/messages.js +0 -40
  63. package/dist/recording/project-digest.js +0 -85
  64. package/dist/recording/recorder.js +0 -293
  65. package/dist/recording/scenario.js +0 -50
  66. package/dist/skill-registry/client.js +0 -345
  67. package/dist/skill-registry/commands.js +0 -180
  68. package/dist/skill-registry/evaluation-client.js +0 -156
  69. package/dist/skill-registry/evaluation-commands.js +0 -174
  70. package/dist/skill-registry/messages.js +0 -177
  71. package/dist/skill-registry/package.js +0 -275
  72. package/dist/skill-registry/platform-package.js +0 -100
  73. package/dist/utils/environment-endpoints.js +0 -17
  74. package/dist/utils/tool-operation-journal.js +0 -124
  75. package/dist/utils/video-evidence-git.js +0 -81
  76. package/dist/video-replication/client.js +0 -222
  77. package/dist/video-replication/comparison-evidence.js +0 -149
  78. package/dist/video-replication/comparison-files.js +0 -57
  79. package/dist/video-replication/comparison-log.js +0 -72
  80. package/dist/video-replication/comparison-messages.js +0 -104
  81. package/dist/video-replication/comparison-output.js +0 -63
  82. package/dist/video-replication/comparison-preflight.js +0 -66
  83. package/dist/video-replication/comparison.js +0 -216
  84. package/dist/video-replication/evidence.js +0 -165
  85. package/dist/video-replication/media.js +0 -111
  86. package/dist/video-replication/messages.js +0 -89
  87. package/dist/workspace/messages.js +0 -35
  88. package/dist/workspace/transfer-client.js +0 -174
  89. package/dist/workspace-runtime/codex/app-server.js +0 -1040
  90. package/dist/workspace-runtime/codex/compact.js +0 -46
  91. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  92. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  93. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  94. package/dist/workspace-runtime/codex/loopback.js +0 -146
  95. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  96. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  97. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  98. package/dist/workspace-runtime/codex/permissions.js +0 -70
  99. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  100. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  101. package/dist/workspace-runtime/codex/ui-tools.js +0 -183
  102. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  103. package/dist/workspace-runtime/main.js +0 -10
  104. package/dist/workspace-runtime/persistence/journal.js +0 -365
  105. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  106. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  107. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  108. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  109. package/dist/workspace-runtime/previews/output.js +0 -36
  110. package/dist/workspace-runtime/previews/publish.js +0 -262
  111. package/dist/workspace-runtime/previews/single-file.js +0 -43
  112. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  113. package/dist/workspace-runtime/production/content-changes.js +0 -36
  114. package/dist/workspace-runtime/production/contracts.js +0 -19
  115. package/dist/workspace-runtime/production/controller.js +0 -218
  116. package/dist/workspace-runtime/production/dependencies.js +0 -60
  117. package/dist/workspace-runtime/production/native.js +0 -212
  118. package/dist/workspace-runtime/production/processes.js +0 -102
  119. package/dist/workspace-runtime/production/save-command.js +0 -35
  120. package/dist/workspace-runtime/production/source-archive.js +0 -137
  121. package/dist/workspace-runtime/production/source-copy.js +0 -91
  122. package/dist/workspace-runtime/production/stages.js +0 -334
  123. package/dist/workspace-runtime/production/storage.js +0 -75
  124. package/dist/workspace-runtime/serve.js +0 -214
  125. package/dist/workspace-runtime/server/auth.js +0 -21
  126. package/dist/workspace-runtime/server/connectivity.js +0 -201
  127. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  128. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  129. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  130. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  131. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  132. package/dist/workspace-runtime/server/dispatch.js +0 -1217
  133. package/dist/workspace-runtime/server/endpoints.js +0 -21
  134. package/dist/workspace-runtime/server/execution-group.js +0 -90
  135. package/dist/workspace-runtime/server/http.js +0 -1243
  136. package/dist/workspace-runtime/server/lock.js +0 -53
  137. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  138. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  139. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  140. package/dist/workspace-runtime/server/types.js +0 -1
  141. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  142. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  143. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  144. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  145. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  146. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  147. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  148. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  149. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  150. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  151. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  152. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  153. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  154. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  155. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  156. package/dist/workspace-runtime/workspaces/directories.js +0 -133
  157. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  158. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  159. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  160. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  161. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  162. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  163. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  164. package/dist/workspace-runtime/workspaces/files.js +0 -138
  165. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  166. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  167. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  168. package/dist/workspace-runtime/workspaces/git.js +0 -670
  169. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  170. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  171. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  172. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  173. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  174. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  175. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  176. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  177. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  178. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  179. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  180. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  181. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  182. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  183. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  184. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  185. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  186. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  187. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  188. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  189. package/project-template-v2/.claude/agents/artist.md +0 -82
  190. package/project-template-v2/.claude/agents/developer.md +0 -153
  191. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  192. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  193. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  194. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  195. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  196. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  197. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  198. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  199. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  200. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  201. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  202. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  203. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  204. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  205. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  206. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  207. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  208. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  209. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  210. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  211. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  212. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  213. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  214. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  215. package/project-template-v2/.claude/settings.json +0 -33
  216. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  219. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  220. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  221. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  222. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  223. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  224. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  225. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  226. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  227. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  228. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  229. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  230. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  236. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  237. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  238. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  239. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  240. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  241. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  242. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  243. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  244. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  245. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  246. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  247. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  248. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  249. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  250. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  251. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  252. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  253. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  254. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  255. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  256. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  257. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  258. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  259. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  260. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  261. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  262. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  263. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  264. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  269. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  270. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  271. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  272. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  273. package/project-template-v2/.claude/snapshot.mjs +0 -263
  274. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  275. package/project-template-v2/CLAUDE.md +0 -146
  276. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  277. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  278. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  281. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  282. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  283. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  284. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  285. package/project-template-v2/assets/models/.gitkeep +0 -0
  286. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  287. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  288. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  289. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  290. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  291. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  292. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  293. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  294. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  295. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  296. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  297. package/project-template-v2/docs/project-state.json +0 -60
  298. package/project-template-v2/docs/project-state.md +0 -72
  299. package/project-template-v2/docs/standards/README.md +0 -225
  300. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  301. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  302. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  303. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  304. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  305. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  306. package/project-template-v2/game/index.ts +0 -18
  307. package/project-template-v2/globals.d.ts +0 -51
  308. package/project-template-v2/index.css +0 -34
  309. package/project-template-v2/index.html +0 -18
  310. package/project-template-v2/main.ts +0 -9
  311. package/project-template-v2/package.json +0 -46
  312. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  313. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  314. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  315. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  316. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  317. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  318. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  319. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  320. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  321. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  322. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  323. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  324. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  325. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  326. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  327. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  328. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  329. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  330. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  331. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  332. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  333. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  334. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  335. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  336. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  337. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  338. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  339. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  340. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  341. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  342. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  343. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  344. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  345. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  346. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  347. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  348. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  349. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  350. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  351. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  354. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  355. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  356. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  357. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  358. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  359. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  360. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  361. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  362. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  363. package/project-template-v2/tsconfig.json +0 -20
  364. package/project-template-v2/vite.config.ts +0 -27
  365. package/project-templates/batch-locks/phaser.yaml +0 -922
  366. package/project-templates/batch-locks/threejs.yaml +0 -978
  367. package/project-templates/empty/AGENTS.md +0 -41
  368. package/project-templates/empty/gitignore +0 -33
@@ -1,322 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Gameplay fusion wiring probe — objective DoD for `fusion`.
4
- *
5
- * - <2 selected *.aigameplay atoms → PASS (no-op)
6
- * - ≥2 atoms → DESIGN fusion type must be consistent + each mechanic wired in game/ source
7
- * + autoPlay path references both mechanics when publish contract is present
8
- *
9
- * Usage:
10
- * node skills/playable-record/scripts/verify-fusion.mjs --root=.
11
- * npm run verify:fusion
12
- *
13
- * Exit 0 = OK/pass
14
- * Exit 2 = fusion contract broken
15
- * Exit 1 = unexpected error
16
- */
17
-
18
- import { readFile, readdir } from 'node:fs/promises';
19
- import { existsSync } from 'node:fs';
20
- import { join, resolve, basename } from 'node:path';
21
- import { writeValidatorArtifact } from '../../_shared/scripts/lib/validator-artifacts.mjs';
22
-
23
- // `[*_\s]*` tolerates markdown emphasis in the §6 template form `- **Fusion type**:`.
24
- const FUSION_TYPE_RE =
25
- /Fusion\s+type[*_\s]*:\s*(Single|A-Visual|B1-Passive|B2-Active|C-Sequential|D-Parallel)/i;
26
- const REAL_FUSION_TYPES = new Set(['A-Visual', 'B1-Passive', 'B2-Active', 'C-Sequential', 'D-Parallel']);
27
-
28
- /** Signature tokens per gameplay atom — at least one must appear under game/. */
29
- export const GAMEPLAY_SIGNATURES = {
30
- 'match3_core.aigameplay': [
31
- 'trySwap',
32
- 'applyGravity',
33
- 'refillBoard',
34
- 'minMatchCount',
35
- 'match3',
36
- 'match-3',
37
- ],
38
- 'memory_match.aigameplay': [
39
- 'flipCard',
40
- 'checkMatch',
41
- 'face_up',
42
- 'pairId',
43
- 'memory_match',
44
- 'flipBack',
45
- ],
46
- 'screw_puzzle.aigameplay': [
47
- 'removeScrew',
48
- 'canRemoveScrew',
49
- 'bufferSlots',
50
- 'screw_puzzle',
51
- 'colorMatchRequired',
52
- ],
53
- 'arrow_escape_core.aigameplay': [
54
- 'arrow_escape',
55
- 'direction_arrow',
56
- 'escape_core',
57
- 'canMoveArrow',
58
- ],
59
- };
60
-
61
- function parseArgs(argv) {
62
- const opts = { root: process.cwd(), json: false };
63
- for (const arg of argv) {
64
- if (arg === '--json') opts.json = true;
65
- else if (arg.startsWith('--root=')) {
66
- const v = arg.slice('--root='.length);
67
- opts.root = v.startsWith('/') ? v : resolve(process.cwd(), v);
68
- }
69
- }
70
- return opts;
71
- }
72
-
73
- /**
74
- * @param {unknown} tree
75
- * @returns {string[]}
76
- */
77
- export function readSelectedGameplayAtoms(tree) {
78
- const atoms = Array.isArray(tree?.meta?.selectedAtoms) ? tree.meta.selectedAtoms : [];
79
- return atoms
80
- .map((a) => (typeof a === 'string' ? a.trim() : ''))
81
- .filter((a) => a.endsWith('.aigameplay'));
82
- }
83
-
84
- /**
85
- * True only when a real pseudo-fusion / risk-accepted decision is documented.
86
- *
87
- * Judged by the *value* of the "Pseudo-fusion decision:" field — not the field
88
- * label itself. The §6 template label always contains the word "pseudo-fusion"
89
- * (and the placeholder hint contains "risk accepted: …"), so a naive substring
90
- * match would make every fusion gate a no-op for any template-derived DESIGN.md.
91
- *
92
- * @param {string} content
93
- * @returns {boolean}
94
- */
95
- export function hasPseudoFusionDecision(content) {
96
- // Drop unfilled {…} template placeholders so their hint text cannot satisfy the gate.
97
- const filled = content.replace(/\{[^}]*\}/g, '');
98
- // `[*_\s]*` tolerates markdown emphasis in `- **Pseudo-fusion decision**:`.
99
- const field = filled.match(/Pseudo-?fusion decision[*_\s]*:\s*(.*)/i);
100
- if (field) {
101
- const value = field[1].trim();
102
- const lower = value.toLowerCase();
103
- const isEmpty = lower === '' || lower === 'n/a' || lower === 'na' || lower === 'none';
104
- if (!isEmpty) return true;
105
- // Field present but n/a → no decision documented; fall through to scan the rest.
106
- }
107
- // No structured field (or n/a): scan with the bare label stripped so it cannot self-satisfy.
108
- const scrubbed = filled.replace(/Pseudo-?fusion decision[*_\s]*:/gi, '');
109
- return /pseudo-?fusion/i.test(scrubbed) || /risk\s+accepted/i.test(scrubbed);
110
- }
111
-
112
- /**
113
- * @param {string} designContent
114
- * @returns {{ type: string | null, isPseudoFusion: boolean }}
115
- */
116
- export function parseDesignFusionType(designContent) {
117
- const match = designContent.match(FUSION_TYPE_RE);
118
- if (!match) return { type: null, isPseudoFusion: false };
119
- const raw = match[1];
120
- const type =
121
- raw.startsWith('B1') ? 'B1-Passive' : raw.startsWith('B2') ? 'B2-Active' : raw;
122
- const isPseudoFusion = hasPseudoFusionDecision(designContent);
123
- return { type, isPseudoFusion };
124
- }
125
-
126
- /**
127
- * @param {string} content
128
- * @param {string} atomId
129
- * @returns {string[]}
130
- */
131
- export function matchedSignatures(content, atomId) {
132
- const signatures = GAMEPLAY_SIGNATURES[atomId] ?? [
133
- atomId.replace('.aigameplay', ''),
134
- atomId.split('.')[0],
135
- ];
136
- return signatures.filter((sig) => content.includes(sig));
137
- }
138
-
139
- async function collectGameSource(root) {
140
- const gameDir = join(root, 'game');
141
- if (!existsSync(gameDir)) return '';
142
- const chunks = [];
143
-
144
- async function walk(dir) {
145
- let entries = [];
146
- try {
147
- entries = await readdir(dir, { withFileTypes: true });
148
- } catch {
149
- return;
150
- }
151
- for (const entry of entries) {
152
- const abs = join(dir, entry.name);
153
- if (entry.isDirectory()) {
154
- await walk(abs);
155
- continue;
156
- }
157
- if (!/\.(ts|js|mjs|cjs)$/.test(entry.name)) continue;
158
- try {
159
- chunks.push(await readFile(abs, 'utf8'));
160
- } catch {
161
- // ignore unreadable files
162
- }
163
- }
164
- }
165
-
166
- await walk(gameDir);
167
- return chunks.join('\n');
168
- }
169
-
170
- /**
171
- * Extract the full `autoPlay(...) { ... }` body via brace balancing.
172
- *
173
- * A non-greedy regex stops at the first `\n}` and truncates the block whenever
174
- * autoPlay contains nested `{}` (if/for blocks), which would drop later mechanic
175
- * calls and cause false "missing mechanic" failures. This walks braces instead.
176
- *
177
- * @param {string} gameSource
178
- * @returns {string}
179
- */
180
- export function extractAutoPlayBlock(gameSource) {
181
- const header = /autoPlay\s*\([^)]*\)\s*\{/g;
182
- const m = header.exec(gameSource);
183
- if (!m) return '';
184
- const start = m.index;
185
- let depth = 0;
186
- for (let i = header.lastIndex - 1; i < gameSource.length; i += 1) {
187
- const ch = gameSource[i];
188
- if (ch === '{') depth += 1;
189
- else if (ch === '}') {
190
- depth -= 1;
191
- if (depth === 0) return gameSource.slice(start, i + 1);
192
- }
193
- }
194
- // Unbalanced source — best effort: return from the header onward.
195
- return gameSource.slice(start);
196
- }
197
-
198
- /**
199
- * @param {string} root
200
- * @param {{ gameplayAtoms?: string[], designContent?: string, gameSource?: string }} [overrides]
201
- */
202
- export async function verifyFusion(root, overrides = {}) {
203
- const problems = [];
204
-
205
- let gameplayAtoms = overrides.gameplayAtoms;
206
- if (!gameplayAtoms) {
207
- const atomTreePath = join(root, 'docs/atom-tree.json');
208
- if (!existsSync(atomTreePath)) {
209
- return { ok: true, skipped: true, reason: 'no atom-tree.json — fusion no-op' };
210
- }
211
- const tree = JSON.parse(await readFile(atomTreePath, 'utf8'));
212
- gameplayAtoms = readSelectedGameplayAtoms(tree);
213
- }
214
-
215
- if (gameplayAtoms.length < 2) {
216
- return { ok: true, skipped: true, reason: 'single gameplay atom — fusion no-op PASS' };
217
- }
218
-
219
- const designPath = existsSync(join(root, 'docs/design.md'))
220
- ? join(root, 'docs/design.md')
221
- : join(root, 'docs/DESIGN.md');
222
- const designContent =
223
- overrides.designContent ??
224
- (existsSync(designPath) ? await readFile(designPath, 'utf8') : '');
225
- const { type, isPseudoFusion } = parseDesignFusionType(designContent);
226
-
227
- if (!type) {
228
- problems.push('DESIGN.md missing Fusion type: — classify fusion in ## 6. Gameplay Fusion');
229
- } else if (type === 'Single' && !isPseudoFusion) {
230
- problems.push(
231
- `DESIGN.md Fusion type is Single but atom-tree selected ${gameplayAtoms.length} gameplay atoms — use a real fusion type or document pseudo-fusion`,
232
- );
233
- } else if (type !== 'Single' && !REAL_FUSION_TYPES.has(type) && !isPseudoFusion) {
234
- problems.push(`DESIGN.md Fusion type "${type}" is not a recognized fusion classification`);
235
- }
236
-
237
- const gameSource = overrides.gameSource ?? (await collectGameSource(root));
238
- if (!gameSource.trim()) {
239
- problems.push('game/ source missing — cannot verify fusion wiring');
240
- return { ok: false, problems, gameplayAtoms };
241
- }
242
-
243
- const wiring = {};
244
- for (const atomId of gameplayAtoms) {
245
- const hits = matchedSignatures(gameSource, atomId);
246
- wiring[atomId] = hits;
247
- if (hits.length === 0) {
248
- problems.push(
249
- `gameplay atom "${atomId}" has no wiring evidence in game/ (expected one of: ${(GAMEPLAY_SIGNATURES[atomId] ?? [atomId]).join(', ')})`,
250
- );
251
- }
252
- }
253
-
254
- const autoPlayBlock = extractAutoPlayBlock(gameSource);
255
- if (autoPlayBlock) {
256
- const autoPlayHits = gameplayAtoms.filter((atomId) =>
257
- matchedSignatures(autoPlayBlock, atomId).length > 0,
258
- );
259
- if (autoPlayHits.length < gameplayAtoms.length) {
260
- const missing = gameplayAtoms.filter((id) => !autoPlayHits.includes(id));
261
- problems.push(
262
- `autoPlay() does not reference all fused mechanics — missing evidence for: ${missing.join(', ')}`,
263
- );
264
- }
265
- } else {
266
- const referencedInSource = gameplayAtoms.filter((atomId) => gameSource.includes(atomId));
267
- if (referencedInSource.length < gameplayAtoms.length) {
268
- problems.push(
269
- 'autoPlay() block not found and not all selected gameplay atom ids appear in game/ source',
270
- );
271
- }
272
- }
273
-
274
- return {
275
- ok: problems.length === 0,
276
- problems,
277
- gameplayAtoms,
278
- wiring,
279
- fusionType: type,
280
- };
281
- }
282
-
283
- async function main() {
284
- const opts = parseArgs(process.argv.slice(2));
285
- try {
286
- const result = await verifyFusion(opts.root);
287
- const artifactPayload = result.skipped
288
- ? { ok: true, skipped: true, reason: result.reason }
289
- : result;
290
- await writeValidatorArtifact(opts.root, 'fusion', artifactPayload).catch(() => {});
291
- if (result.skipped) {
292
- const msg = `[verify:fusion] OK — ${result.reason}\n`;
293
- process.stdout.write(msg);
294
- if (opts.json) process.stdout.write(`${JSON.stringify({ ok: true, skipped: true, reason: result.reason })}\n`);
295
- process.exit(0);
296
- }
297
-
298
- if (result.ok) {
299
- const msg = `[verify:fusion] OK — ${result.gameplayAtoms.length} gameplay atoms wired (${result.gameplayAtoms.join(', ')})\n`;
300
- process.stdout.write(msg);
301
- if (opts.json) process.stdout.write(`${JSON.stringify({ ok: true, ...result })}\n`);
302
- process.exit(0);
303
- }
304
-
305
- const detail = result.problems.join('\n - ');
306
- process.stderr.write(`[verify:fusion] FAIL\n - ${detail}\n`);
307
- if (opts.json) {
308
- process.stdout.write(`${JSON.stringify({ ok: false, problems: result.problems, ...result })}\n`);
309
- }
310
- process.exit(2);
311
- } catch (err) {
312
- process.stderr.write(`[verify:fusion] error: ${err.message}\n`);
313
- process.exit(1);
314
- }
315
- }
316
-
317
- const isMain =
318
- process.argv[1] && basename(process.argv[1]) === 'verify-fusion.mjs';
319
-
320
- if (isMain) {
321
- main();
322
- }
@@ -1,105 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Iteration-2 lifecycle probe.
4
- *
5
- * Boots the game, triggers autoPlay, and verifies that the phase path is
6
- * complete: starts at HOOK, passes through TUTORIAL and GAMEPLAY, reaches
7
- * ENDCARD. Missing intermediate phases indicate an incomplete scene FSM —
8
- * fix in the packaging-scene-fsm todo (game/ state machine entry points).
9
- *
10
- * iter-1 only required HOOK→ENDCARD; iter-2 requires all 4 waypoints.
11
- */
12
-
13
- import { resolve } from 'node:path';
14
- import { fileURLToPath } from 'node:url';
15
- import { runFirstWinProbe } from './verify-firstwin.mjs';
16
- import { writeValidatorArtifact } from '../../_shared/scripts/lib/validator-artifacts.mjs';
17
-
18
- function parseArgs(argv) {
19
- const opts = {
20
- root: process.cwd(),
21
- url: null,
22
- useDev: false,
23
- port: 8080,
24
- scene: 'MainScene',
25
- timeout: 30_000,
26
- headed: false,
27
- json: false,
28
- };
29
- for (const arg of argv) {
30
- if (arg === '--use-dev') opts.useDev = true;
31
- else if (arg === '--headed') opts.headed = true;
32
- else if (arg === '--json') opts.json = true;
33
- else if (arg.startsWith('--root=')) {
34
- const v = arg.slice('--root='.length);
35
- opts.root = v.startsWith('/') ? v : resolve(process.cwd(), v);
36
- } else if (arg.startsWith('--url=')) opts.url = arg.slice('--url='.length);
37
- else if (arg.startsWith('--port=')) opts.port = Number(arg.slice('--port='.length));
38
- else if (arg.startsWith('--scene=')) opts.scene = arg.slice('--scene='.length);
39
- else if (arg.startsWith('--timeout=')) opts.timeout = Number(arg.slice('--timeout='.length));
40
- }
41
- return opts;
42
- }
43
-
44
- // Phases that must appear somewhere in phasePath (in order) for iter-2.
45
- const REQUIRED_WAYPOINTS = ['HOOK', 'TUTORIAL', 'GAMEPLAY', 'ENDCARD'];
46
-
47
- export function evaluateLifecycleResult(result) {
48
- const problems = [...(result.problems || [])];
49
- const path = result.phasePath || [];
50
-
51
- if (result.ok) {
52
- if (path[0] !== 'HOOK') {
53
- problems.push(
54
- `phase path must start at HOOK but started at "${path[0] ?? '(empty)'}" — ` +
55
- 'check that window.__playable.getState().currentPhase is "HOOK" on boot ' +
56
- '(game/ state machine entry, typically game/scenes/MainScene or game/fsm/)',
57
- );
58
- }
59
- const missing = REQUIRED_WAYPOINTS.filter((wp) => !path.includes(wp));
60
- if (missing.length > 0) {
61
- problems.push(
62
- `phase path missing required waypoints: ${missing.join(', ')} — ` +
63
- 'autoPlay() did not drive through these phases; add scene transitions in ' +
64
- 'the packaging-scene-fsm todo (game/ state machine or scene manager)',
65
- );
66
- }
67
- if (path[path.length - 1] !== 'ENDCARD') {
68
- problems.push(
69
- `phase path must end at ENDCARD but ended at "${path[path.length - 1] ?? '(empty)'}" — ` +
70
- 'check win/fail → ENDCARD transition in game/ scene FSM',
71
- );
72
- }
73
- }
74
- return { ok: result.ok && problems.length === 0, problems, phasePath: path };
75
- }
76
-
77
- function printHuman(result) {
78
- const evaluated = evaluateLifecycleResult(result);
79
- console.log(`[verify:lifecycle] ${evaluated.ok ? 'OK' : 'FAIL'} — ${result.url}`);
80
- if (result.phasePath) console.log(` phase path: ${result.phasePath.join(' → ')}`);
81
- if (result.elapsedMs != null) console.log(` elapsed: ${result.elapsedMs}ms`);
82
- for (const p of evaluated.problems) console.log(` ✗ ${p}`);
83
- }
84
-
85
- async function main() {
86
- const opts = parseArgs(process.argv.slice(2));
87
- const result = await runFirstWinProbe(opts);
88
- const evaluated = evaluateLifecycleResult(result);
89
- const payload = { ...result, ...evaluated };
90
- await writeValidatorArtifact(opts.root, 'lifecycle', payload).catch(() => {});
91
- if (opts.json) {
92
- console.log(JSON.stringify(payload, null, 2));
93
- } else {
94
- printHuman(result);
95
- }
96
- process.exit(evaluated.ok ? 0 : 2);
97
- }
98
-
99
- const isMain = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
100
- if (isMain) {
101
- main().catch((err) => {
102
- console.error(`[verify:lifecycle] ${err.message}`);
103
- process.exit(1);
104
- });
105
- }
@@ -1,230 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * VLM-based video semantic verifier for growth-ring harness.
4
- *
5
- * Invokes `playcraft tools analyze-video` on the autoplay MP4 and writes
6
- * findings to validate/ring{N}/vlm-video.json (or per-slice path when --slice-id set).
7
- *
8
- * Usage:
9
- * node skills/playable-record/scripts/verify-vlm-video.mjs --root=. --ring=2 [--record-first] [--slice-id=...] [--context-json=...]
10
- */
11
- import fs from 'node:fs';
12
- import path from 'node:path';
13
- import { spawnSync } from 'node:child_process';
14
- import { fileURLToPath } from 'node:url';
15
- import { readState } from '../../_shared/scripts/state-store.mjs';
16
-
17
- function parseArgs(argv) {
18
- const opts = {
19
- root: process.cwd(),
20
- ring: null,
21
- tier: null,
22
- provider: null,
23
- video: null,
24
- contextFile: null,
25
- contextJson: null,
26
- sliceId: null,
27
- recordFirst: false,
28
- };
29
- for (const arg of argv) {
30
- if (arg.startsWith('--root=')) opts.root = arg.slice('--root='.length);
31
- else if (arg.startsWith('--ring=')) opts.ring = arg.slice('--ring='.length);
32
- else if (arg.startsWith('--tier=')) opts.tier = arg.slice('--tier='.length);
33
- else if (arg.startsWith('--provider=')) opts.provider = arg.slice('--provider='.length);
34
- else if (arg.startsWith('--video=')) opts.video = arg.slice('--video='.length);
35
- else if (arg.startsWith('--context-file=')) opts.contextFile = arg.slice('--context-file='.length);
36
- else if (arg.startsWith('--context-json=')) opts.contextJson = arg.slice('--context-json='.length);
37
- else if (arg.startsWith('--slice-id=')) opts.sliceId = arg.slice('--slice-id='.length);
38
- else if (arg === '--record-first' || arg === '--record-first=true') opts.recordFirst = true;
39
- }
40
- return opts;
41
- }
42
-
43
- function resolveRoot(root) {
44
- return path.isAbsolute(root) ? root : path.resolve(process.cwd(), root);
45
- }
46
-
47
- function defaultTier(ring) {
48
- const n = Number(ring);
49
- if (Number.isFinite(n) && n >= 3) return 'thorough';
50
- return 'fast';
51
- }
52
-
53
- function resolvePlaycraftCmd(projectRoot) {
54
- const candidates = [
55
- process.env.PLAYCRAFT_CLI_PATH,
56
- path.join(projectRoot, 'node_modules/.bin/playcraft'),
57
- 'playcraft',
58
- ].filter(Boolean);
59
- for (const cmd of candidates) {
60
- const result = spawnSync(cmd, ['--version'], {
61
- encoding: 'utf8',
62
- shell: process.platform === 'win32',
63
- timeout: 10_000,
64
- });
65
- if (result.status === 0 || result.status === null) return cmd;
66
- }
67
- return process.platform === 'win32' ? 'npx.cmd' : 'npx';
68
- }
69
-
70
- function runPlaycraft(cmd, args, timeoutMs) {
71
- const isNpx = cmd === 'npx' || cmd === 'npx.cmd';
72
- const finalArgs = isNpx ? ['playcraft', ...args] : args;
73
- return spawnSync(cmd, finalArgs, {
74
- encoding: 'utf8',
75
- shell: process.platform === 'win32',
76
- timeout: timeoutMs,
77
- stdio: ['ignore', 'pipe', 'pipe'],
78
- });
79
- }
80
-
81
- function runNpmRecord(root, ring) {
82
- return spawnSync(
83
- 'npm',
84
- ['run', 'record:mp4', '--', `--out=validate/ring${ring}`, '--name=autoplay', '--use-dev'],
85
- {
86
- cwd: root,
87
- encoding: 'utf8',
88
- shell: process.platform === 'win32',
89
- timeout: 360_000,
90
- stdio: ['ignore', 'pipe', 'pipe'],
91
- },
92
- );
93
- }
94
-
95
- function extractDesignSummary(root, ring) {
96
- const designPath = fs.existsSync(path.join(root, 'docs/design.md'))
97
- ? path.join(root, 'docs/design.md')
98
- : path.join(root, 'docs/DESIGN.md');
99
- if (!fs.existsSync(designPath)) return undefined;
100
- const text = fs.readFileSync(designPath, 'utf8');
101
- const sections = [];
102
- const pick = (label, re) => {
103
- const m = text.match(re);
104
- if (m) sections.push(`${label}: ${m[1].trim().slice(0, 200)}`);
105
- };
106
- pick('Player action', /##\s*Player Action\s*\n([\s\S]*?)(?=\n##|$)/i);
107
- pick('First win', /##\s*First(?:[- ]Level)? Win\s*\n([\s\S]*?)(?=\n##|$)/i);
108
- if (Number(ring) >= 3) {
109
- pick('Hook', /##\s*Hook\s*\n([\s\S]*?)(?=\n##|$)/i);
110
- pick('CTA', /##\s*CTA\s*\n([\s\S]*?)(?=\n##|$)/i);
111
- }
112
- return sections.join('\n') || undefined;
113
- }
114
-
115
- function buildContextFromSlice(root, sliceId, ring) {
116
- const state = readState(root);
117
- const slice =
118
- (state.sliceState?.slices || []).find((s) => s.sliceId === sliceId)
119
- || (state.sliceState?.slices || []).find((s) => s.sliceId === state.sliceState?.activeSliceId)
120
- || null;
121
- const designSummary = extractDesignSummary(root, ring);
122
- const hypothesis = slice?.hypothesis ? `Slice hypothesis: ${slice.hypothesis}` : '';
123
- const parts = [designSummary, hypothesis].filter(Boolean);
124
- if (!parts.length) return undefined;
125
- return {
126
- designSummary: parts.join('\n'),
127
- firstAction: slice?.doWhat || undefined,
128
- };
129
- }
130
-
131
- /**
132
- * @param {ReturnType<typeof parseArgs>} opts
133
- */
134
- export function runVerifyVlmVideo(opts) {
135
- const root = resolveRoot(opts.root);
136
- const ring = opts.ring || '1';
137
- const tier = opts.tier || defaultTier(ring);
138
- const videoPath = opts.video || path.join(root, `validate/ring${ring}/autoplay.mp4`);
139
-
140
- if (!fs.existsSync(videoPath)) {
141
- if (opts.recordFirst) {
142
- const rec = runNpmRecord(root, ring);
143
- if (rec.status !== 0) {
144
- return { ok: false, exitCode: 2, error: `record:mp4 failed: ${(rec.stderr || rec.stdout).slice(-300)}` };
145
- }
146
- }
147
- }
148
- if (!fs.existsSync(videoPath)) {
149
- return { ok: false, exitCode: 2, error: `video not found: ${videoPath}` };
150
- }
151
-
152
- let context = undefined;
153
- if (opts.contextJson) {
154
- try {
155
- context = JSON.parse(opts.contextJson);
156
- } catch (err) {
157
- return { ok: false, exitCode: 2, error: `invalid --context-json: ${err.message}` };
158
- }
159
- } else {
160
- context = buildContextFromSlice(root, opts.sliceId, ring);
161
- }
162
-
163
- const outDir = path.join(root, `validate/ring${ring}`);
164
- fs.mkdirSync(outDir, { recursive: true });
165
- const outPath = opts.sliceId
166
- ? path.join(root, 'validate/slice', `${opts.sliceId}.vlm-video.json`)
167
- : path.join(outDir, 'vlm-video.json');
168
- fs.mkdirSync(path.dirname(outPath), { recursive: true });
169
-
170
- const cmd = resolvePlaycraftCmd(root);
171
- const args = ['tools', 'analyze-video', '--video', videoPath, '--output', outPath, '--ring', String(ring)];
172
- const contextFile = opts.contextFile || path.join(root, 'docs/DESIGN.md');
173
- if (context) {
174
- args.push('--context-json', JSON.stringify(context));
175
- } else if (fs.existsSync(contextFile)) {
176
- args.push('--context-file', contextFile);
177
- }
178
- if (tier) args.push('--tier', tier);
179
- if (opts.provider) args.push('--provider', opts.provider);
180
-
181
- const timeoutMs = tier === 'fast' ? 120_000 : 360_000;
182
- const result = runPlaycraft(cmd, args, timeoutMs);
183
-
184
- if (!fs.existsSync(outPath)) {
185
- const detail = result.stderr || result.stdout || result.error || `exit ${result.status}`;
186
- const errorArtifact = { ok: false, error: detail.slice(-500), findings: [] };
187
- fs.writeFileSync(outPath, `${JSON.stringify(errorArtifact, null, 2)}\n`, 'utf8');
188
- return { ok: false, exitCode: 2, artifact: errorArtifact, cliArgs: args };
189
- }
190
-
191
- let data;
192
- try {
193
- data = JSON.parse(fs.readFileSync(outPath, 'utf8'));
194
- } catch (err) {
195
- const errorArtifact = { ok: false, error: err.message, findings: [] };
196
- fs.writeFileSync(outPath, `${JSON.stringify(errorArtifact, null, 2)}\n`, 'utf8');
197
- return { ok: false, exitCode: 2, artifact: errorArtifact, cliArgs: args };
198
- }
199
-
200
- const failed = (data.findings || []).filter((f) => f.status === 'fail' || f.severity === 'P0');
201
- return {
202
- ok: failed.length === 0,
203
- exitCode: failed.length === 0 ? 0 : 2,
204
- artifact: data,
205
- outPath,
206
- cliArgs: args,
207
- ring,
208
- tier,
209
- };
210
- }
211
-
212
- function main() {
213
- const opts = parseArgs(process.argv.slice(2));
214
- const result = runVerifyVlmVideo(opts);
215
- if (result.error && !result.artifact) {
216
- console.error(`[verify-vlm-video] ${result.error}`);
217
- process.exit(result.exitCode ?? 2);
218
- }
219
- const failed = (result.artifact?.findings || []).filter(
220
- (f) => f.status === 'fail' || f.severity === 'P0',
221
- );
222
- console.log(
223
- `[verify-vlm-video] ok=${result.ok} findings=${result.artifact?.findings?.length ?? 0} failed=${failed.length} ring=${result.ring} tier=${result.tier} → ${result.outPath || 'n/a'}`,
224
- );
225
- process.stdout.write(`${JSON.stringify(result.artifact, null, 2)}\n`);
226
- process.exit(result.exitCode ?? (result.ok ? 0 : 2));
227
- }
228
-
229
- const isMain = process.argv[1] && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
230
- if (isMain) main();