@playcraft/cli 0.1.40-beta → 0.1.41-prod

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (368) hide show
  1. package/README.md +3 -58
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build-all.js +19 -5
  5. package/dist/commands/build.js +28 -15
  6. package/dist/commands/create.js +33 -26
  7. package/dist/commands/image.js +6 -2
  8. package/dist/commands/login.js +42 -84
  9. package/dist/commands/skills.js +0 -4
  10. package/dist/commands/tools-3d.js +0 -11
  11. package/dist/commands/tools-generation.js +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 -185
  22. package/dist/utils/image-asset-context.js +228 -0
  23. package/dist/utils/playcraft-http-client.js +4 -6
  24. package/package.json +3 -13
  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 -87
  50. package/dist/commands/video.js +0 -111
  51. package/dist/commands/workspace-runtime.js +0 -54
  52. package/dist/commands/workspace.js +0 -35
  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/tool-operation-journal.js +0 -124
  75. package/dist/utils/video-evidence-git.js +0 -81
  76. package/dist/video-replication/client.js +0 -222
  77. package/dist/video-replication/comparison-evidence.js +0 -149
  78. package/dist/video-replication/comparison-files.js +0 -57
  79. package/dist/video-replication/comparison-log.js +0 -72
  80. package/dist/video-replication/comparison-messages.js +0 -104
  81. package/dist/video-replication/comparison-output.js +0 -63
  82. package/dist/video-replication/comparison-preflight.js +0 -66
  83. package/dist/video-replication/comparison.js +0 -216
  84. package/dist/video-replication/evidence.js +0 -165
  85. package/dist/video-replication/media.js +0 -111
  86. package/dist/video-replication/messages.js +0 -89
  87. package/dist/workspace/messages.js +0 -35
  88. package/dist/workspace/transfer-client.js +0 -174
  89. package/dist/workspace-runtime/codex/app-server.js +0 -1040
  90. package/dist/workspace-runtime/codex/compact.js +0 -46
  91. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  92. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  93. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  94. package/dist/workspace-runtime/codex/loopback.js +0 -146
  95. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  96. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  97. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  98. package/dist/workspace-runtime/codex/permissions.js +0 -70
  99. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  100. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  101. package/dist/workspace-runtime/codex/ui-tools.js +0 -183
  102. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  103. package/dist/workspace-runtime/main.js +0 -10
  104. package/dist/workspace-runtime/persistence/journal.js +0 -365
  105. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  106. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  107. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  108. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  109. package/dist/workspace-runtime/previews/output.js +0 -36
  110. package/dist/workspace-runtime/previews/publish.js +0 -262
  111. package/dist/workspace-runtime/previews/single-file.js +0 -43
  112. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  113. package/dist/workspace-runtime/production/content-changes.js +0 -36
  114. package/dist/workspace-runtime/production/contracts.js +0 -19
  115. package/dist/workspace-runtime/production/controller.js +0 -218
  116. package/dist/workspace-runtime/production/dependencies.js +0 -60
  117. package/dist/workspace-runtime/production/native.js +0 -212
  118. package/dist/workspace-runtime/production/processes.js +0 -102
  119. package/dist/workspace-runtime/production/save-command.js +0 -35
  120. package/dist/workspace-runtime/production/source-archive.js +0 -137
  121. package/dist/workspace-runtime/production/source-copy.js +0 -91
  122. package/dist/workspace-runtime/production/stages.js +0 -334
  123. package/dist/workspace-runtime/production/storage.js +0 -75
  124. package/dist/workspace-runtime/serve.js +0 -214
  125. package/dist/workspace-runtime/server/auth.js +0 -21
  126. package/dist/workspace-runtime/server/connectivity.js +0 -201
  127. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  128. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  129. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  130. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  131. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  132. package/dist/workspace-runtime/server/dispatch.js +0 -1217
  133. package/dist/workspace-runtime/server/endpoints.js +0 -21
  134. package/dist/workspace-runtime/server/execution-group.js +0 -90
  135. package/dist/workspace-runtime/server/http.js +0 -1243
  136. package/dist/workspace-runtime/server/lock.js +0 -53
  137. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  138. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  139. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  140. package/dist/workspace-runtime/server/types.js +0 -1
  141. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  142. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  143. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  144. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  145. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  146. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  147. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  148. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  149. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  150. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  151. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  152. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  153. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  154. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  155. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  156. package/dist/workspace-runtime/workspaces/directories.js +0 -133
  157. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  158. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  159. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  160. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  161. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  162. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  163. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  164. package/dist/workspace-runtime/workspaces/files.js +0 -138
  165. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  166. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  167. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  168. package/dist/workspace-runtime/workspaces/git.js +0 -670
  169. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  170. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  171. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  172. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  173. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  174. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  175. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  176. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  177. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  178. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  179. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  180. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  181. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  182. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  183. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  184. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  185. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  186. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  187. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  188. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  189. package/project-template-v2/.claude/agents/artist.md +0 -82
  190. package/project-template-v2/.claude/agents/developer.md +0 -153
  191. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  192. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  193. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  194. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  195. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  196. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  197. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  198. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  199. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  200. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  201. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  202. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  203. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  204. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  205. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  206. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  207. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  208. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  209. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  210. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  211. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  212. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  213. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  214. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  215. package/project-template-v2/.claude/settings.json +0 -33
  216. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  219. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  220. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  221. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  222. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  223. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  224. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  225. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  226. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  227. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  228. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  229. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  230. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  236. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  237. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  238. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  239. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  240. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  241. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  242. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  243. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  244. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  245. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  246. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  247. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  248. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  249. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  250. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  251. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  252. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  253. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  254. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  255. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  256. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  257. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  258. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  259. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  260. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  261. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  262. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  263. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  264. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  269. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  270. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  271. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  272. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  273. package/project-template-v2/.claude/snapshot.mjs +0 -263
  274. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  275. package/project-template-v2/CLAUDE.md +0 -146
  276. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  277. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  278. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  281. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  282. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  283. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  284. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  285. package/project-template-v2/assets/models/.gitkeep +0 -0
  286. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  287. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  288. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  289. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  290. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  291. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  292. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  293. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  294. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  295. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  296. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  297. package/project-template-v2/docs/project-state.json +0 -60
  298. package/project-template-v2/docs/project-state.md +0 -72
  299. package/project-template-v2/docs/standards/README.md +0 -225
  300. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  301. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  302. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  303. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  304. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  305. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  306. package/project-template-v2/game/index.ts +0 -18
  307. package/project-template-v2/globals.d.ts +0 -51
  308. package/project-template-v2/index.css +0 -34
  309. package/project-template-v2/index.html +0 -18
  310. package/project-template-v2/main.ts +0 -9
  311. package/project-template-v2/package.json +0 -46
  312. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  313. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  314. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  315. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  316. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  317. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  318. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  319. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  320. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  321. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  322. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  323. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  324. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  325. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  326. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  327. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  328. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  329. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  330. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  331. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  332. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  333. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  334. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  335. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  336. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  337. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  338. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  339. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  340. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  341. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  342. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  343. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  344. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  345. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  346. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  347. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  348. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  349. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  350. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  351. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  354. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  355. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  356. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  357. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  358. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  359. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  360. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  361. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  362. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  363. package/project-template-v2/tsconfig.json +0 -20
  364. package/project-template-v2/vite.config.ts +0 -27
  365. package/project-templates/batch-locks/phaser.yaml +0 -922
  366. package/project-templates/batch-locks/threejs.yaml +0 -978
  367. package/project-templates/empty/AGENTS.md +0 -41
  368. package/project-templates/empty/gitignore +0 -33
@@ -1,53 +0,0 @@
1
- import { closeSync, constants, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
2
- import { dirname, join } from 'node:path';
3
- export class RuntimeProcessLock {
4
- filePath;
5
- fd = null;
6
- constructor(stateDir) {
7
- this.filePath = join(stateDir, 'workspace-runtime.lock');
8
- }
9
- acquire() {
10
- mkdirSync(dirname(this.filePath), { recursive: true, mode: 0o700 });
11
- try {
12
- this.fd = openSync(this.filePath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY, 0o600);
13
- writeFileSync(this.fd, String(process.pid));
14
- return;
15
- }
16
- catch (error) {
17
- if (error.code !== 'EEXIST')
18
- throw error;
19
- }
20
- const existing = Number.parseInt(readFileSync(this.filePath, 'utf8'), 10);
21
- if (Number.isInteger(existing) && processAlive(existing)) {
22
- throw Object.assign(new Error(`workspace-runtime already running as pid ${existing}`), {
23
- code: 'duplicate_instance',
24
- });
25
- }
26
- unlinkSync(this.filePath);
27
- this.acquire();
28
- }
29
- release() {
30
- if (this.fd !== null) {
31
- closeSync(this.fd);
32
- this.fd = null;
33
- }
34
- try {
35
- if (readFileSync(this.filePath, 'utf8').trim() === String(process.pid)) {
36
- unlinkSync(this.filePath);
37
- }
38
- }
39
- catch (error) {
40
- if (error.code !== 'ENOENT')
41
- throw error;
42
- }
43
- }
44
- }
45
- function processAlive(pid) {
46
- try {
47
- process.kill(pid, 0);
48
- return true;
49
- }
50
- catch {
51
- return false;
52
- }
53
- }
@@ -1,168 +0,0 @@
1
- /**
2
- * RFB (Remote Framebuffer, 远程帧缓冲) viewing needs a handshake and picture requests.
3
- * This gate supports the sandbox's version 3.8 / None security negotiation.
4
- * Input requires a hold for the entire message; unsupported framing closes the stream.
5
- */
6
- const INPUT_TYPES = new Set([4, 5, 6, 250, 251, 255]);
7
- const VERSION = Buffer.from('RFB 003.008\n');
8
- const MAX_CLIPBOARD_BYTES = 1_000_000;
9
- export function createRfbWatchGate() {
10
- let server = Buffer.alloc(0);
11
- let client = Buffer.alloc(0);
12
- let phase = 'server-version';
13
- let messageInputAllowed = false;
14
- const fail = () => {
15
- phase = 'failed';
16
- server = Buffer.alloc(0);
17
- client = Buffer.alloc(0);
18
- };
19
- const observeServer = (chunk) => {
20
- if (phase === 'ready' || phase === 'failed')
21
- return;
22
- let offset = 0;
23
- while (offset < chunk.length) {
24
- let size = serverMessageSize(server, phase);
25
- if (size === 'invalid') {
26
- fail();
27
- return;
28
- }
29
- const count = Math.min(size - server.length, chunk.length - offset);
30
- server = Buffer.concat([server, chunk.subarray(offset, offset + count)]);
31
- offset += count;
32
- size = serverMessageSize(server, phase);
33
- if (size === 'invalid') {
34
- fail();
35
- return;
36
- }
37
- if (server.length < size)
38
- continue;
39
- if (phase === 'server-version' && server.equals(VERSION))
40
- phase = 'client-version';
41
- else if (phase === 'server-types' && server.subarray(1).includes(1))
42
- phase = 'client-security';
43
- else if (phase === 'server-result' && server.readUInt32BE(0) === 0)
44
- phase = 'client-init';
45
- else if (phase === 'server-init')
46
- phase = 'ready';
47
- else {
48
- fail();
49
- return;
50
- }
51
- server = Buffer.alloc(0);
52
- // The first picture can share the ServerInit chunk; it needs no buffering.
53
- if (phase === 'ready')
54
- return;
55
- }
56
- };
57
- const clientBytes = (chunk, allowInput) => {
58
- if (phase === 'failed')
59
- return [];
60
- const outgoing = [];
61
- let offset = 0;
62
- if (client.length > 0)
63
- messageInputAllowed &&= allowInput;
64
- while (offset < chunk.length) {
65
- if (client.length === 0)
66
- messageInputAllowed = allowInput;
67
- let size = phase === 'client-version' ? 12
68
- : phase === 'client-security' || phase === 'client-init' ? 1
69
- : phase === 'server-init' || phase === 'ready' ? clientMessageSize(client)
70
- : 'invalid';
71
- if (size === 'invalid') {
72
- fail();
73
- return [];
74
- }
75
- const count = Math.min(size - client.length, chunk.length - offset);
76
- client = Buffer.concat([client, chunk.subarray(offset, offset + count)]);
77
- offset += count;
78
- if (phase === 'server-init' || phase === 'ready')
79
- size = clientMessageSize(client);
80
- if (size === 'invalid') {
81
- fail();
82
- return [];
83
- }
84
- if (client.length < size)
85
- continue;
86
- if (phase === 'client-version' && client.equals(VERSION))
87
- phase = 'server-types';
88
- else if (phase === 'client-security' && client[0] === 1)
89
- phase = 'server-result';
90
- else if (phase === 'client-init' && client[0] <= 1)
91
- phase = 'server-init';
92
- else if (phase !== 'server-init' && phase !== 'ready') {
93
- fail();
94
- return [];
95
- }
96
- else if (INPUT_TYPES.has(client[0]) && !messageInputAllowed) {
97
- client = Buffer.alloc(0);
98
- continue;
99
- }
100
- outgoing.push(client);
101
- client = Buffer.alloc(0);
102
- }
103
- return outgoing;
104
- };
105
- return { get failed() { return phase === 'failed'; }, observeServer, clientBytes };
106
- }
107
- function serverMessageSize(buffer, phase) {
108
- if (phase === 'server-version')
109
- return 12;
110
- if (phase === 'server-types') {
111
- if (buffer.length < 1)
112
- return 1;
113
- return buffer[0] === 0 ? 'invalid' : 1 + buffer[0];
114
- }
115
- if (phase === 'server-result')
116
- return 4;
117
- if (phase === 'server-init') {
118
- if (buffer.length < 24)
119
- return 24;
120
- const length = buffer.readUInt32BE(20);
121
- return length > 4096 ? 'invalid' : 24 + length;
122
- }
123
- return 'invalid';
124
- }
125
- function clientMessageSize(buffer) {
126
- if (buffer.length === 0)
127
- return 1;
128
- const type = buffer[0];
129
- if (type === 0)
130
- return 20;
131
- if (type === 3 || type === 150)
132
- return 10;
133
- if (type === 4)
134
- return 8;
135
- if (type === 5)
136
- return 6;
137
- if (type === 250)
138
- return 4;
139
- if (type === 2) {
140
- if (buffer.length < 4)
141
- return 4;
142
- const count = buffer.readUInt16BE(2);
143
- return count > 64 ? 'invalid' : 4 + count * 4;
144
- }
145
- if (type === 6) {
146
- if (buffer.length < 8)
147
- return 8;
148
- // Extended clipboard messages encode their payload size as a negative length.
149
- const length = Math.abs(buffer.readInt32BE(4));
150
- return length > MAX_CLIPBOARD_BYTES ? 'invalid' : 8 + length;
151
- }
152
- if (type === 248) {
153
- if (buffer.length < 9)
154
- return 9;
155
- return buffer[8] > 64 ? 'invalid' : 9 + buffer[8];
156
- }
157
- if (type === 251) {
158
- if (buffer.length < 8)
159
- return 8;
160
- return buffer[6] > 16 ? 'invalid' : 8 + buffer[6] * 16;
161
- }
162
- if (type === 255) {
163
- if (buffer.length < 2)
164
- return 2;
165
- return buffer[1] === 0 ? 12 : 'invalid';
166
- }
167
- return 'invalid';
168
- }
@@ -1,138 +0,0 @@
1
- import { PLATFORM_ROUTES, platformEndpoint } from '@playcraft/common/cloud-workspace/runtime';
2
- const uploaders = new WeakMap();
3
- /** The existing journal and cloud acknowledgement are the outbox and its only delivery cursor. */
4
- export class SourceEventUploader {
5
- state;
6
- options;
7
- timer;
8
- request;
9
- requestScope;
10
- running = false;
11
- closed = false;
12
- requested = false;
13
- failures = 0;
14
- hintedHistoryScope;
15
- observedScope;
16
- unsubscribe;
17
- constructor(state, options = {}) {
18
- this.state = state;
19
- this.options = options;
20
- this.observedScope = this.scope();
21
- this.unsubscribe = state.journal.onSourceEvent(() => this.wake());
22
- this.wake();
23
- }
24
- wake() {
25
- if (this.closed)
26
- return;
27
- const scope = this.scope();
28
- if (this.observedScope !== scope) {
29
- this.observedScope = scope;
30
- this.failures = 0;
31
- clearTimeout(this.timer);
32
- this.timer = undefined;
33
- this.request?.abort();
34
- }
35
- this.requested = true;
36
- if (!this.running && !this.timer)
37
- this.schedule(0);
38
- }
39
- close() {
40
- this.closed = true;
41
- this.unsubscribe();
42
- clearTimeout(this.timer);
43
- this.timer = undefined;
44
- this.request?.abort();
45
- }
46
- scope() {
47
- const { config, runtimeEpoch } = this.state;
48
- return JSON.stringify([config.runtimeId, config.generation, runtimeEpoch, config.publicBaseUrl, config.controlToken]);
49
- }
50
- schedule(delay) {
51
- if (this.closed || this.timer)
52
- return;
53
- this.timer = setTimeout(() => {
54
- this.timer = undefined;
55
- void this.upload();
56
- }, delay);
57
- this.timer.unref?.();
58
- }
59
- async upload() {
60
- if (this.closed || this.running)
61
- return;
62
- this.running = true;
63
- this.requested = false;
64
- try {
65
- while (!this.closed) {
66
- const { runtimeId, generation, publicBaseUrl, controlToken } = this.state.config;
67
- const runtimeEpoch = this.state.runtimeEpoch;
68
- const identity = { runtimeId, generation, runtimeEpoch };
69
- const epoch = this.state.journal.epochsSnapshot().find(item => item.runtime_id === runtimeId &&
70
- item.generation === generation && item.runtime_epoch === runtimeEpoch);
71
- if (!epoch || epoch.cloud_ack_through >= epoch.local_durable_through) {
72
- const history = this.state.journal.epochsSnapshot().filter(item => item.runtime_id === runtimeId &&
73
- item.generation === generation && item.runtime_epoch < runtimeEpoch && item.cloud_ack_through < item.local_durable_through);
74
- const historyScope = `${this.scope()}:${this.state.journal.executionGroup().stopConfirmed}:${this.state.journal.stoppedRuntimeEpochs().join(',')}`;
75
- if (!history.length || this.hintedHistoryScope === historyScope)
76
- return;
77
- await this.state.journal.allocateSourceEvent({ ...identity, type: 'runtime.source.pending',
78
- payload: { runtimeId, epochs: history.map(item => ({ runtimeEpoch: item.runtime_epoch, highWater: item.local_durable_through })) },
79
- occurredAt: new Date().toISOString() });
80
- this.hintedHistoryScope = historyScope;
81
- continue;
82
- }
83
- const page = this.state.journal.readSourcePage({ ...identity, after: epoch.cloud_ack_through, limit: 100 });
84
- if (!page.ok || page.events.length === 0)
85
- throw new Error('source_gap');
86
- this.requestScope = this.scope();
87
- this.request = new AbortController();
88
- const response = await (this.options.fetchImpl ?? fetch)(platformEndpoint(publicBaseUrl, PLATFORM_ROUTES.events), {
89
- method: 'POST', redirect: 'error',
90
- signal: AbortSignal.any([this.request.signal, AbortSignal.timeout(this.options.requestTimeoutMs ?? 5000)]),
91
- headers: { authorization: `Bearer ${controlToken}`, 'x-playcraft-control-token': controlToken, 'content-type': 'application/json' },
92
- body: JSON.stringify({ ...identity, events: page.events }),
93
- });
94
- await response.body?.cancel();
95
- if (this.closed)
96
- return;
97
- if (this.requestScope !== this.scope())
98
- continue;
99
- if (!response.ok)
100
- throw new Error(`callback_${response.status}`);
101
- const confirmed = this.state.journal.epochsSnapshot().find(item => item.runtime_id === runtimeId &&
102
- item.generation === generation && item.runtime_epoch === runtimeEpoch)?.cloud_ack_through ?? 0;
103
- // A successful callback is only a wakeup. Its response never substitutes for the fenced acknowledgement.
104
- if (confirmed <= epoch.cloud_ack_through)
105
- throw new Error('awaiting_ack');
106
- this.failures = 0;
107
- }
108
- }
109
- catch {
110
- if (!this.closed) {
111
- const changed = this.requestScope !== undefined && this.requestScope !== this.scope();
112
- this.failures = changed ? 0 : this.failures + 1;
113
- this.schedule(changed ? 0 : this.options.retryDelayMs?.(this.failures) ?? Math.min(30_000, 1000 * 2 ** Math.min(5, this.failures - 1)));
114
- }
115
- }
116
- finally {
117
- this.running = false;
118
- this.request = undefined;
119
- this.requestScope = undefined;
120
- if (this.requested && !this.timer)
121
- this.schedule(0);
122
- }
123
- }
124
- }
125
- export function startSourceEventUploader(state, options) {
126
- let uploader = uploaders.get(state);
127
- if (!uploader) {
128
- uploader = new SourceEventUploader(state, options);
129
- uploaders.set(state, uploader);
130
- }
131
- return uploader;
132
- }
133
- export function wakeSourceEventUploader(state) {
134
- uploaders.get(state)?.wake();
135
- }
136
- export function stopSourceEventUploader(state) {
137
- uploaders.get(state)?.close();
138
- }