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