@playcraft/cli 0.1.34 → 0.1.36-beta1

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 (347) hide show
  1. package/README.md +3 -56
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build.js +4 -9
  5. package/dist/commands/create.js +33 -26
  6. package/dist/commands/image.js +6 -2
  7. package/dist/commands/login.js +42 -84
  8. package/dist/commands/skills.js +0 -2
  9. package/dist/commands/tools-3d.js +0 -11
  10. package/dist/commands/tools-generation.js +109 -68
  11. package/dist/commands/tools-image-context.js +23 -0
  12. package/dist/commands/tools.js +2 -2
  13. package/dist/config.js +4 -59
  14. package/dist/index.js +3 -36
  15. package/dist/remix/clone.js +0 -2
  16. package/dist/remix/init-template.js +0 -2
  17. package/dist/remix/pull.js +0 -2
  18. package/dist/remix/push.js +1 -21
  19. package/dist/utils/agent-api-client.js +30 -185
  20. package/dist/utils/image-asset-context.js +105 -0
  21. package/dist/utils/playcraft-http-client.js +4 -6
  22. package/package.json +5 -14
  23. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  24. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +105 -44
  25. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  26. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +36 -39
  29. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  30. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +105 -44
  31. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +36 -39
  35. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  36. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +105 -44
  37. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +36 -39
  41. package/dist/auth/account-activation.js +0 -157
  42. package/dist/auth/messages.js +0 -30
  43. package/dist/commands/platform-skills.generated.js +0 -19
  44. package/dist/commands/playable.js +0 -53
  45. package/dist/commands/tools-batch.js +0 -87
  46. package/dist/commands/video.js +0 -111
  47. package/dist/commands/workspace-runtime.js +0 -54
  48. package/dist/commands/workspace.js +0 -35
  49. package/dist/project-skills/builtin-import.js +0 -225
  50. package/dist/project-skills/commands.js +0 -77
  51. package/dist/project-skills/lifecycle.js +0 -28
  52. package/dist/project-skills/local-run.js +0 -112
  53. package/dist/project-skills/local-store.js +0 -221
  54. package/dist/project-skills/messages.js +0 -80
  55. package/dist/project-skills/reconcile.js +0 -62
  56. package/dist/project-skills/remote-cache.js +0 -51
  57. package/dist/project-skills/validation.js +0 -19
  58. package/dist/recording/messages.js +0 -40
  59. package/dist/recording/project-digest.js +0 -85
  60. package/dist/recording/recorder.js +0 -293
  61. package/dist/recording/scenario.js +0 -50
  62. package/dist/utils/environment-endpoints.js +0 -17
  63. package/dist/utils/tool-operation-journal.js +0 -124
  64. package/dist/utils/video-evidence-git.js +0 -81
  65. package/dist/video-replication/client.js +0 -222
  66. package/dist/video-replication/comparison-evidence.js +0 -149
  67. package/dist/video-replication/comparison-files.js +0 -57
  68. package/dist/video-replication/comparison-log.js +0 -72
  69. package/dist/video-replication/comparison-messages.js +0 -104
  70. package/dist/video-replication/comparison-output.js +0 -63
  71. package/dist/video-replication/comparison-preflight.js +0 -66
  72. package/dist/video-replication/comparison.js +0 -216
  73. package/dist/video-replication/evidence.js +0 -165
  74. package/dist/video-replication/media.js +0 -111
  75. package/dist/video-replication/messages.js +0 -89
  76. package/dist/workspace/messages.js +0 -35
  77. package/dist/workspace/transfer-client.js +0 -174
  78. package/dist/workspace-runtime/codex/app-server.js +0 -965
  79. package/dist/workspace-runtime/codex/compact.js +0 -46
  80. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  81. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  82. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  83. package/dist/workspace-runtime/codex/loopback.js +0 -146
  84. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  85. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  86. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  87. package/dist/workspace-runtime/codex/permissions.js +0 -70
  88. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  89. package/dist/workspace-runtime/main.js +0 -10
  90. package/dist/workspace-runtime/persistence/journal.js +0 -355
  91. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  92. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  93. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1096
  94. package/dist/workspace-runtime/previews/output.js +0 -36
  95. package/dist/workspace-runtime/previews/publish.js +0 -262
  96. package/dist/workspace-runtime/previews/single-file.js +0 -43
  97. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  98. package/dist/workspace-runtime/production/contracts.js +0 -17
  99. package/dist/workspace-runtime/production/controller.js +0 -207
  100. package/dist/workspace-runtime/production/dependencies.js +0 -60
  101. package/dist/workspace-runtime/production/native.js +0 -203
  102. package/dist/workspace-runtime/production/processes.js +0 -86
  103. package/dist/workspace-runtime/production/save-command.js +0 -35
  104. package/dist/workspace-runtime/production/source-copy.js +0 -91
  105. package/dist/workspace-runtime/production/stages.js +0 -205
  106. package/dist/workspace-runtime/production/storage.js +0 -60
  107. package/dist/workspace-runtime/serve.js +0 -207
  108. package/dist/workspace-runtime/server/auth.js +0 -21
  109. package/dist/workspace-runtime/server/connectivity.js +0 -201
  110. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  111. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  112. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  113. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  114. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  115. package/dist/workspace-runtime/server/dispatch.js +0 -1183
  116. package/dist/workspace-runtime/server/endpoints.js +0 -19
  117. package/dist/workspace-runtime/server/execution-group.js +0 -85
  118. package/dist/workspace-runtime/server/http.js +0 -1127
  119. package/dist/workspace-runtime/server/lock.js +0 -53
  120. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  121. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  122. package/dist/workspace-runtime/server/types.js +0 -1
  123. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  124. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  125. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  126. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  127. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  128. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  129. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  130. package/dist/workspace-runtime/workspaces/attachments.js +0 -181
  131. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  132. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  133. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  134. package/dist/workspace-runtime/workspaces/composer-context.js +0 -125
  135. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  136. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  137. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  138. package/dist/workspace-runtime/workspaces/directories.js +0 -123
  139. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  140. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  141. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  142. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  143. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  144. package/dist/workspace-runtime/workspaces/empty-template.js +0 -40
  145. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  146. package/dist/workspace-runtime/workspaces/files.js +0 -120
  147. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  148. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  149. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  150. package/dist/workspace-runtime/workspaces/git.js +0 -670
  151. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  152. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  153. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  154. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  155. package/dist/workspace-runtime/workspaces/prepare.js +0 -264
  156. package/dist/workspace-runtime/workspaces/registry.js +0 -236
  157. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  158. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  159. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -91
  160. package/dist/workspace-runtime/workspaces/skills.js +0 -189
  161. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  162. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  163. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  164. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  165. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  166. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  167. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  168. package/project-template-v2/.claude/agents/artist.md +0 -82
  169. package/project-template-v2/.claude/agents/developer.md +0 -153
  170. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  171. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  172. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  173. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  174. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  175. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  176. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  177. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  178. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  179. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  180. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  181. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  182. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  183. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  184. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  185. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  186. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  187. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  188. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  189. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  190. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  191. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  192. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  193. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  194. package/project-template-v2/.claude/settings.json +0 -33
  195. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  196. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  197. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  198. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  199. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  200. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  201. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  202. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  203. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  204. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  205. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  206. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  207. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  208. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  209. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  210. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  211. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  212. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  213. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  214. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  215. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  216. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  217. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  218. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  219. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  220. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  221. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  222. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  223. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  224. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  225. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  226. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  227. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  228. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  229. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  230. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  231. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  232. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  233. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  234. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  235. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  236. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  237. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  238. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  239. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  240. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  241. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  242. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  243. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  244. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  245. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  246. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  247. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  248. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  249. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  250. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  251. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  252. package/project-template-v2/.claude/snapshot.mjs +0 -263
  253. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  254. package/project-template-v2/CLAUDE.md +0 -146
  255. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  256. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  257. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  258. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  259. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  260. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  261. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  262. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  263. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  264. package/project-template-v2/assets/models/.gitkeep +0 -0
  265. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  266. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  267. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  268. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  269. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  270. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  271. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  272. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  273. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  274. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  275. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  276. package/project-template-v2/docs/project-state.json +0 -60
  277. package/project-template-v2/docs/project-state.md +0 -72
  278. package/project-template-v2/docs/standards/README.md +0 -225
  279. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  280. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  281. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  282. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  283. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  284. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  285. package/project-template-v2/game/index.ts +0 -18
  286. package/project-template-v2/globals.d.ts +0 -51
  287. package/project-template-v2/index.css +0 -34
  288. package/project-template-v2/index.html +0 -18
  289. package/project-template-v2/main.ts +0 -9
  290. package/project-template-v2/package.json +0 -46
  291. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  292. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  293. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  294. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  295. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  296. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  297. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  298. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  299. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  300. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  301. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  302. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  303. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  304. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  305. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  306. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  307. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  308. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  309. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  310. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  311. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  312. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  313. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  314. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  315. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  316. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  317. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  318. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  319. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  320. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  321. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  322. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  323. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  324. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  325. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  326. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  327. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  328. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  329. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  330. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  331. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  332. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  333. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  334. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  335. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  336. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  337. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  338. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  339. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  340. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  341. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  342. package/project-template-v2/tsconfig.json +0 -20
  343. package/project-template-v2/vite.config.ts +0 -27
  344. package/project-templates/batch-locks/phaser.yaml +0 -922
  345. package/project-templates/batch-locks/threejs.yaml +0 -978
  346. package/project-templates/empty/AGENTS.md +0 -39
  347. 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();