@playcraft/cli 0.1.28 → 0.1.29

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