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