@playcraft/cli 0.1.49-beta → 0.1.51

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