@playcraft/cli 0.1.37-beta → 0.1.39-prod

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (366) hide show
  1. package/README.md +3 -58
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build-all.js +19 -5
  5. package/dist/commands/build.js +28 -15
  6. package/dist/commands/create.js +33 -26
  7. package/dist/commands/image.js +6 -2
  8. package/dist/commands/login.js +42 -84
  9. package/dist/commands/skills.js +0 -4
  10. package/dist/commands/tools-3d.js +0 -11
  11. package/dist/commands/tools-generation.js +126 -68
  12. package/dist/commands/tools-image-context.js +23 -0
  13. package/dist/commands/tools.js +2 -2
  14. package/dist/config.js +4 -59
  15. package/dist/index.js +3 -40
  16. package/dist/remix/clone.js +0 -2
  17. package/dist/remix/init-template.js +0 -2
  18. package/dist/remix/pull.js +0 -2
  19. package/dist/remix/push.js +1 -21
  20. package/dist/utils/agent-api-client.js +30 -185
  21. package/dist/utils/image-asset-context.js +106 -0
  22. package/dist/utils/playcraft-http-client.js +4 -6
  23. package/package.json +5 -15
  24. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  25. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  26. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  29. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  30. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  31. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  35. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  36. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  37. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  41. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  42. package/SKILLS_REGISTRY.md +0 -149
  43. package/dist/auth/account-activation.js +0 -157
  44. package/dist/auth/messages.js +0 -30
  45. package/dist/commands/build-temp.js +0 -26
  46. package/dist/commands/platform-skills.generated.js +0 -19
  47. package/dist/commands/playable.js +0 -53
  48. package/dist/commands/tools-batch.js +0 -87
  49. package/dist/commands/video.js +0 -111
  50. package/dist/commands/workspace-runtime.js +0 -54
  51. package/dist/commands/workspace.js +0 -35
  52. package/dist/project-skills/builtin-import.js +0 -225
  53. package/dist/project-skills/commands.js +0 -77
  54. package/dist/project-skills/lifecycle.js +0 -28
  55. package/dist/project-skills/local-run.js +0 -112
  56. package/dist/project-skills/local-store.js +0 -221
  57. package/dist/project-skills/messages.js +0 -80
  58. package/dist/project-skills/reconcile.js +0 -62
  59. package/dist/project-skills/remote-cache.js +0 -51
  60. package/dist/project-skills/validation.js +0 -19
  61. package/dist/recording/messages.js +0 -40
  62. package/dist/recording/project-digest.js +0 -85
  63. package/dist/recording/recorder.js +0 -293
  64. package/dist/recording/scenario.js +0 -50
  65. package/dist/skill-registry/client.js +0 -345
  66. package/dist/skill-registry/commands.js +0 -180
  67. package/dist/skill-registry/evaluation-client.js +0 -156
  68. package/dist/skill-registry/evaluation-commands.js +0 -174
  69. package/dist/skill-registry/messages.js +0 -177
  70. package/dist/skill-registry/package.js +0 -275
  71. package/dist/skill-registry/platform-package.js +0 -100
  72. package/dist/utils/environment-endpoints.js +0 -17
  73. package/dist/utils/tool-operation-journal.js +0 -124
  74. package/dist/utils/video-evidence-git.js +0 -81
  75. package/dist/video-replication/client.js +0 -222
  76. package/dist/video-replication/comparison-evidence.js +0 -149
  77. package/dist/video-replication/comparison-files.js +0 -57
  78. package/dist/video-replication/comparison-log.js +0 -72
  79. package/dist/video-replication/comparison-messages.js +0 -104
  80. package/dist/video-replication/comparison-output.js +0 -63
  81. package/dist/video-replication/comparison-preflight.js +0 -66
  82. package/dist/video-replication/comparison.js +0 -216
  83. package/dist/video-replication/evidence.js +0 -165
  84. package/dist/video-replication/media.js +0 -111
  85. package/dist/video-replication/messages.js +0 -89
  86. package/dist/workspace/messages.js +0 -35
  87. package/dist/workspace/transfer-client.js +0 -174
  88. package/dist/workspace-runtime/codex/app-server.js +0 -1040
  89. package/dist/workspace-runtime/codex/compact.js +0 -46
  90. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  91. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  92. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  93. package/dist/workspace-runtime/codex/loopback.js +0 -146
  94. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  95. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  96. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  97. package/dist/workspace-runtime/codex/permissions.js +0 -70
  98. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  99. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  100. package/dist/workspace-runtime/codex/ui-tools.js +0 -183
  101. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  102. package/dist/workspace-runtime/main.js +0 -10
  103. package/dist/workspace-runtime/persistence/journal.js +0 -358
  104. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  105. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  106. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  107. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  108. package/dist/workspace-runtime/previews/output.js +0 -36
  109. package/dist/workspace-runtime/previews/publish.js +0 -262
  110. package/dist/workspace-runtime/previews/single-file.js +0 -43
  111. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  112. package/dist/workspace-runtime/production/contracts.js +0 -19
  113. package/dist/workspace-runtime/production/controller.js +0 -218
  114. package/dist/workspace-runtime/production/dependencies.js +0 -60
  115. package/dist/workspace-runtime/production/native.js +0 -212
  116. package/dist/workspace-runtime/production/processes.js +0 -102
  117. package/dist/workspace-runtime/production/save-command.js +0 -35
  118. package/dist/workspace-runtime/production/source-archive.js +0 -137
  119. package/dist/workspace-runtime/production/source-copy.js +0 -91
  120. package/dist/workspace-runtime/production/stages.js +0 -303
  121. package/dist/workspace-runtime/production/storage.js +0 -60
  122. package/dist/workspace-runtime/serve.js +0 -214
  123. package/dist/workspace-runtime/server/auth.js +0 -21
  124. package/dist/workspace-runtime/server/connectivity.js +0 -201
  125. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  126. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  127. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  128. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  129. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  130. package/dist/workspace-runtime/server/dispatch.js +0 -1217
  131. package/dist/workspace-runtime/server/endpoints.js +0 -21
  132. package/dist/workspace-runtime/server/execution-group.js +0 -90
  133. package/dist/workspace-runtime/server/http.js +0 -1243
  134. package/dist/workspace-runtime/server/lock.js +0 -53
  135. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  136. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  137. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  138. package/dist/workspace-runtime/server/types.js +0 -1
  139. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  140. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  141. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  142. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  143. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  144. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  145. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  146. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  147. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  148. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  149. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  150. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  151. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  152. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  153. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  154. package/dist/workspace-runtime/workspaces/directories.js +0 -133
  155. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  156. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  157. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  158. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  159. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  160. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  161. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  162. package/dist/workspace-runtime/workspaces/files.js +0 -120
  163. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  164. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  165. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  166. package/dist/workspace-runtime/workspaces/git.js +0 -670
  167. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  168. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  169. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  170. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  171. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  172. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  173. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  174. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  175. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  176. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  177. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  178. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  179. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  180. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  181. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  182. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  183. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  184. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  185. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  186. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  187. package/project-template-v2/.claude/agents/artist.md +0 -82
  188. package/project-template-v2/.claude/agents/developer.md +0 -153
  189. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  190. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  191. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  192. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  193. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  194. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  195. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  196. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  197. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  198. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  199. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  200. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  201. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  202. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  203. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  204. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  205. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  206. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  207. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  208. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  209. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  210. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  211. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  212. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  213. package/project-template-v2/.claude/settings.json +0 -33
  214. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  215. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  216. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  219. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  220. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  221. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  222. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  223. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  224. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  225. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  226. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  227. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  228. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  229. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  230. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  236. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  237. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  238. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  239. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  240. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  241. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  242. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  243. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  244. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  245. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  246. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  247. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  248. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  249. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  250. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  251. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  252. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  253. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  254. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  255. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  256. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  257. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  258. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  259. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  260. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  261. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  262. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  263. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  264. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  269. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  270. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  271. package/project-template-v2/.claude/snapshot.mjs +0 -263
  272. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  273. package/project-template-v2/CLAUDE.md +0 -146
  274. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  275. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  276. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  277. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  278. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  281. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  282. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  283. package/project-template-v2/assets/models/.gitkeep +0 -0
  284. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  285. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  286. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  287. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  288. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  289. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  290. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  291. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  292. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  293. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  294. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  295. package/project-template-v2/docs/project-state.json +0 -60
  296. package/project-template-v2/docs/project-state.md +0 -72
  297. package/project-template-v2/docs/standards/README.md +0 -225
  298. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  299. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  300. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  301. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  302. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  303. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  304. package/project-template-v2/game/index.ts +0 -18
  305. package/project-template-v2/globals.d.ts +0 -51
  306. package/project-template-v2/index.css +0 -34
  307. package/project-template-v2/index.html +0 -18
  308. package/project-template-v2/main.ts +0 -9
  309. package/project-template-v2/package.json +0 -46
  310. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  311. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  312. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  313. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  314. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  315. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  316. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  317. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  318. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  319. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  320. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  321. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  322. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  323. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  324. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  325. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  326. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  327. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  328. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  329. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  330. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  331. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  332. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  333. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  334. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  335. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  336. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  337. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  338. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  339. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  340. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  341. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  342. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  343. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  344. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  345. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  346. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  347. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  348. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  349. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  350. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  351. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  354. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  355. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  356. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  357. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  358. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  359. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  360. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  361. package/project-template-v2/tsconfig.json +0 -20
  362. package/project-template-v2/vite.config.ts +0 -27
  363. package/project-templates/batch-locks/phaser.yaml +0 -922
  364. package/project-templates/batch-locks/threejs.yaml +0 -978
  365. package/project-templates/empty/AGENTS.md +0 -41
  366. package/project-templates/empty/gitignore +0 -33
@@ -1,123 +0,0 @@
1
- import { constants } from 'node:fs';
2
- import { open } from 'node:fs/promises';
3
- import { extname } from 'node:path';
4
- import { pipeline } from 'node:stream/promises';
5
- import { attachmentIdsSchema, attachmentUploadSchema, WORKSPACE_ATTACHMENT_MAX_BYTES, WORKSPACE_USER_UPLOADS_DIRECTORY, WORKSPACE_VIDEO_ATTACHMENT_MAX_BYTES, } from '@playcraft/common/cloud-workspace/runtime';
6
- import { artifactMime, artifactPath } from './artifact-files.js';
7
- import { openLibraryAttachmentFile, readLibraryAttachmentMetadata } from './library-attachments.js';
8
- import { openWorkspaceDirectoryFile, readWorkspaceDirectoryMetadata } from './directory-attachments.js';
9
- const additionalMediaTypes = {
10
- '.aac': 'audio/aac', '.opus': 'audio/ogg', '.oga': 'audio/ogg', '.aif': 'audio/aiff', '.aiff': 'audio/aiff',
11
- '.bmp': 'image/bmp', '.ico': 'image/vnd.microsoft.icon', '.heic': 'image/heic', '.heif': 'image/heif',
12
- '.tif': 'image/tiff', '.tiff': 'image/tiff',
13
- };
14
- const detectedImageTypes = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
15
- function attachmentRange(header, size) {
16
- if (!header)
17
- return undefined;
18
- const match = /^bytes=(\d*)-(\d*)$/.exec(header.trim());
19
- if (!match || (!match[1] && !match[2]) || !size)
20
- return null;
21
- const first = match[1] ? Number(match[1]) : undefined;
22
- const last = match[2] ? Number(match[2]) : undefined;
23
- if ((first !== undefined && !Number.isSafeInteger(first)) || (last !== undefined && !Number.isSafeInteger(last)))
24
- return null;
25
- const start = first ?? Math.max(0, size - (last ?? 0));
26
- const end = first === undefined ? size - 1 : Math.min(last ?? size - 1, size - 1);
27
- return start >= size || start > end ? null : { start, end };
28
- }
29
- async function openAttachment(root, id, filePath) {
30
- const metadataPath = await artifactPath(root, `${WORKSPACE_USER_UPLOADS_DIRECTORY}/.metadata/${id}.json`);
31
- const metadataFile = await open(metadataPath, constants.O_RDONLY | constants.O_NOFOLLOW);
32
- let metadata;
33
- try {
34
- const stat = await metadataFile.stat();
35
- if (!stat.isFile() || stat.nlink !== 1 || stat.size > 1024 * 1024)
36
- throw new Error('attachment_unavailable');
37
- metadata = JSON.parse(await metadataFile.readFile('utf8'));
38
- if (metadata.id !== id || !attachmentUploadSchema.shape.name.safeParse(metadata.name).success)
39
- throw new Error('attachment_unavailable');
40
- }
41
- finally {
42
- await metadataFile.close();
43
- }
44
- if (metadata.origin?.kind === 'asset-library') {
45
- const library = await readLibraryAttachmentMetadata(root, id);
46
- return openLibraryAttachmentFile(root, library, filePath);
47
- }
48
- if (metadata.kind === 'directory') {
49
- const directory = await readWorkspaceDirectoryMetadata(root, id);
50
- return openWorkspaceDirectoryFile(root, directory, filePath);
51
- }
52
- if (filePath !== undefined)
53
- throw new Error('attachment_unavailable');
54
- const path = await artifactPath(root, `${WORKSPACE_USER_UPLOADS_DIRECTORY}/${id}/${metadata.name}`);
55
- const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
56
- try {
57
- const stat = await handle.stat();
58
- const mimeType = detectedImageTypes.has(metadata.mimeType) ? metadata.mimeType
59
- : additionalMediaTypes[extname(metadata.name).toLowerCase()] ?? artifactMime(metadata.name);
60
- const limit = mimeType.startsWith('video/') ? WORKSPACE_VIDEO_ATTACHMENT_MAX_BYTES : WORKSPACE_ATTACHMENT_MAX_BYTES;
61
- if (!stat.isFile() || stat.nlink !== 1 || stat.size !== metadata.size || stat.size > limit)
62
- throw new Error('attachment_unavailable');
63
- return { handle, name: metadata.name, mimeType, size: stat.size };
64
- }
65
- catch (error) {
66
- await handle.close();
67
- throw error;
68
- }
69
- }
70
- /** Serve only registered references; no caller-supplied file paths reach the filesystem. */
71
- export async function serveWorkspaceAttachment(root, attachmentId, request, response, filePath) {
72
- if (!attachmentIdsSchema.safeParse([attachmentId]).success) {
73
- response.writeHead(400, { 'content-type': 'application/json', 'cache-control': 'no-store' });
74
- response.end(JSON.stringify({ error: 'invalid_attachment' }));
75
- return;
76
- }
77
- let content;
78
- try {
79
- content = await openAttachment(root, attachmentId, filePath);
80
- }
81
- catch {
82
- response.writeHead(404, { 'content-type': 'application/json', 'cache-control': 'no-store' });
83
- response.end(JSON.stringify({ error: 'attachment_not_found' }));
84
- return;
85
- }
86
- try {
87
- const range = attachmentRange(request.headers.range, content.size);
88
- const headers = {
89
- 'content-type': content.mimeType,
90
- 'cache-control': 'private, no-store',
91
- 'x-content-type-options': 'nosniff',
92
- 'content-security-policy': "sandbox; default-src 'none'; style-src 'unsafe-inline'",
93
- 'referrer-policy': 'no-referrer',
94
- 'accept-ranges': 'bytes',
95
- };
96
- if (!/^(?:image|video|audio|model)\//.test(content.mimeType) || content.mimeType === 'image/svg+xml')
97
- headers['content-disposition'] = `attachment; filename*=UTF-8''${encodeURIComponent(content.name).replace(/'/g, '%27')}`;
98
- if (range === null) {
99
- response.writeHead(416, { ...headers, 'content-range': `bytes */${content.size}`, 'content-length': '0' });
100
- response.end();
101
- return;
102
- }
103
- if (range)
104
- headers['content-range'] = `bytes ${range.start}-${range.end}/${content.size}`;
105
- headers['content-length'] = String(range ? range.end - range.start + 1 : content.size);
106
- response.writeHead(range ? 206 : 200, headers);
107
- if (request.method === 'HEAD' || !content.size) {
108
- response.end();
109
- return;
110
- }
111
- await pipeline(content.handle.createReadStream({
112
- start: range?.start ?? 0,
113
- end: range?.end ?? content.size - 1,
114
- autoClose: false,
115
- }), response);
116
- }
117
- catch (error) {
118
- response.destroy(error instanceof Error ? error : undefined);
119
- }
120
- finally {
121
- await content.handle.close();
122
- }
123
- }
@@ -1,185 +0,0 @@
1
- import { randomUUID } from 'node:crypto';
2
- import { constants } from 'node:fs';
3
- import { chmod, lstat, mkdir, open, rm, writeFile } from 'node:fs/promises';
4
- import { join } from 'node:path';
5
- import { WORKSPACE_USER_UPLOADS_DIRECTORY, attachmentIdsSchema, attachmentUploadSchema, WORKSPACE_ATTACHMENT_MAX_BYTES, WORKSPACE_VIDEO_ATTACHMENT_MAX_BYTES, WORKSPACE_VIDEO_ATTACHMENT_MIME_TYPES, workspaceVideoAttachmentQuerySchema, } from '@playcraft/common/cloud-workspace/runtime';
6
- import { NativePreparationError } from '../codex/native-adapter.js';
7
- import { excludeFromGit } from './dependencies.js';
8
- import { hashAttachment, probeAttachmentVideo } from './video-attachments.js';
9
- import { resolveLibraryAttachment } from './library-attachments.js';
10
- import { resolveWorkspaceDirectoryAttachment } from './directory-attachments.js';
11
- async function attachmentRoot(root) {
12
- // Reject redirected upload directories, including symlinks that stay inside the workspace.
13
- let directory = root;
14
- for (const part of WORKSPACE_USER_UPLOADS_DIRECTORY.split('/')) {
15
- directory = join(directory, part);
16
- await mkdir(directory, { mode: 0o755 }).catch((error) => {
17
- if (error.code !== 'EEXIST')
18
- throw error;
19
- });
20
- if (!(await lstat(directory)).isDirectory())
21
- throw new Error('invalid_attachment');
22
- await chmod(directory, 0o755);
23
- }
24
- return directory;
25
- }
26
- export function imageMime(bytes) {
27
- if (bytes.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])))
28
- return 'image/png';
29
- if (bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255)
30
- return 'image/jpeg';
31
- if (/^GIF8[79]a$/.test(bytes.subarray(0, 6).toString('ascii')))
32
- return 'image/gif';
33
- if (bytes.subarray(0, 4).toString() === 'RIFF' && bytes.subarray(8, 12).toString() === 'WEBP')
34
- return 'image/webp';
35
- return 'application/octet-stream';
36
- }
37
- export async function readAttachmentUpload(request) {
38
- const chunks = [];
39
- let size = 0;
40
- for await (const chunk of request) {
41
- const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
42
- size += bytes.length;
43
- if (size > 4 * Math.ceil(WORKSPACE_ATTACHMENT_MAX_BYTES / 3) + 4096)
44
- throw new Error('invalid_attachment');
45
- chunks.push(bytes);
46
- }
47
- return JSON.parse(Buffer.concat(chunks).toString('utf8'));
48
- }
49
- /** References belong to the workspace and are retained by its checkpoints. */
50
- export async function uploadWorkspaceAttachment(root, body) {
51
- const parsed = attachmentUploadSchema.parse(body);
52
- const bytes = Buffer.from(parsed.content, 'base64');
53
- if (bytes.length > WORKSPACE_ATTACHMENT_MAX_BYTES || bytes.toString('base64') !== parsed.content)
54
- throw new Error('invalid_attachment');
55
- const attachment = {
56
- id: randomUUID(),
57
- name: parsed.name,
58
- size: bytes.length,
59
- mimeType: imageMime(bytes),
60
- };
61
- await excludeFromGit(root, `/${WORKSPACE_USER_UPLOADS_DIRECTORY}/`);
62
- const uploads = await attachmentRoot(root);
63
- const directory = join(uploads, attachment.id);
64
- const metadataDirectory = join(uploads, '.metadata');
65
- await mkdir(metadataDirectory, { mode: 0o755 }).catch((error) => {
66
- if (error.code !== 'EEXIST')
67
- throw error;
68
- });
69
- if (!(await lstat(metadataDirectory)).isDirectory())
70
- throw new Error('invalid_attachment');
71
- // Codex can run as a different user from the sandbox control process.
72
- await mkdir(directory, { mode: 0o755 });
73
- await writeFile(join(directory, attachment.name), bytes, { flag: 'wx', mode: 0o644 });
74
- await writeFile(join(metadataDirectory, `${attachment.id}.json`), JSON.stringify(attachment), {
75
- flag: 'wx',
76
- mode: 0o644,
77
- });
78
- return attachment;
79
- }
80
- /** Video bodies are streamed into an unpublished attachment and never decoded as base64. */
81
- export async function uploadWorkspaceVideoAttachment(root, request, query) {
82
- const { name } = workspaceVideoAttachmentQuerySchema.parse(query);
83
- const contentType = String(request.headers['content-type'] ?? '').split(';')[0].trim().toLowerCase();
84
- const declaredSize = request.headers['content-length'];
85
- if (!WORKSPACE_VIDEO_ATTACHMENT_MIME_TYPES.includes(contentType)
86
- || (declaredSize !== undefined && (!/^\d+$/.test(declaredSize) || Number(declaredSize) > WORKSPACE_VIDEO_ATTACHMENT_MAX_BYTES)))
87
- throw new Error('invalid_attachment');
88
- await excludeFromGit(root, `/${WORKSPACE_USER_UPLOADS_DIRECTORY}/`);
89
- const uploads = await attachmentRoot(root);
90
- const id = randomUUID(), directory = join(uploads, id), metadataDirectory = join(uploads, '.metadata');
91
- await mkdir(metadataDirectory, { mode: 0o755 }).catch((error) => { if (error.code !== 'EEXIST')
92
- throw error; });
93
- if (!(await lstat(metadataDirectory)).isDirectory())
94
- throw new Error('invalid_attachment');
95
- await mkdir(directory, { mode: 0o755 });
96
- const handle = await open(join(directory, name), constants.O_CREAT | constants.O_EXCL | constants.O_RDWR | constants.O_NOFOLLOW, 0o644);
97
- try {
98
- let size = 0;
99
- for await (const data of request) {
100
- const bytes = Buffer.isBuffer(data) ? data : Buffer.from(data);
101
- size += bytes.length;
102
- if (size > WORKSPACE_VIDEO_ATTACHMENT_MAX_BYTES)
103
- throw new Error('invalid_attachment');
104
- let offset = 0;
105
- while (offset < bytes.length)
106
- offset += (await handle.write(bytes, offset, bytes.length - offset, size - bytes.length + offset)).bytesWritten;
107
- }
108
- if (!size || (declaredSize !== undefined && Number(declaredSize) !== size))
109
- throw new Error('invalid_attachment');
110
- await handle.sync();
111
- const media = await probeAttachmentVideo(handle);
112
- if (contentType !== media.mimeType && !(contentType === 'video/quicktime' && media.mimeType === 'video/mp4'))
113
- throw new Error('invalid_attachment');
114
- const attachment = { id, name, size, ...media, sha256: await hashAttachment(handle) };
115
- await writeFile(join(metadataDirectory, `${id}.json`), JSON.stringify(attachment), { flag: 'wx', mode: 0o644 });
116
- return attachment;
117
- }
118
- catch (error) {
119
- await rm(directory, { recursive: true, force: true });
120
- throw error;
121
- }
122
- finally {
123
- await handle.close();
124
- }
125
- }
126
- export async function resolveWorkspaceAttachments(root, input) {
127
- try {
128
- const ids = attachmentIdsSchema.parse(input ?? []);
129
- const attachments = await Promise.all(ids.map(async (id) => {
130
- const uploads = await attachmentRoot(root);
131
- const directory = join(uploads, id);
132
- if (!(await lstat(directory)).isDirectory())
133
- throw new Error('invalid_attachment');
134
- await chmod(directory, 0o755);
135
- if (!(await lstat(join(uploads, '.metadata'))).isDirectory())
136
- throw new Error('invalid_attachment');
137
- const metadataHandle = await open(join(uploads, '.metadata', `${id}.json`), constants.O_RDONLY | constants.O_NOFOLLOW);
138
- let metadata;
139
- try {
140
- const stat = await metadataHandle.stat();
141
- if (!stat.isFile() || stat.nlink !== 1 || stat.size > 1024 * 1024)
142
- throw new Error('invalid_attachment');
143
- metadata = JSON.parse(await metadataHandle.readFile('utf8'));
144
- }
145
- finally {
146
- await metadataHandle.close();
147
- }
148
- if (metadata.origin?.kind === 'asset-library')
149
- return resolveLibraryAttachment(root, id);
150
- if (metadata.kind === 'directory')
151
- return resolveWorkspaceDirectoryAttachment(root, id);
152
- attachmentUploadSchema.shape.name.parse(metadata.name);
153
- if (metadata.id !== id)
154
- throw new Error('invalid_attachment');
155
- const path = join(directory, metadata.name);
156
- const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
157
- try {
158
- const stat = await handle.stat();
159
- const video = metadata.mimeType?.startsWith('video/');
160
- if (!stat.isFile() || stat.nlink !== 1 || stat.size !== metadata.size || stat.size > (video ? WORKSPACE_VIDEO_ATTACHMENT_MAX_BYTES : WORKSPACE_ATTACHMENT_MAX_BYTES))
161
- throw new Error('invalid_attachment');
162
- if (video) {
163
- const media = await probeAttachmentVideo(handle);
164
- const sha256 = await hashAttachment(handle);
165
- if (sha256 !== metadata.sha256 || media.mimeType !== metadata.mimeType || media.durationMs !== metadata.durationMs
166
- || media.width !== metadata.width || media.height !== metadata.height)
167
- throw new Error('invalid_attachment');
168
- return { ...metadata, ...media, path };
169
- }
170
- const bytes = Buffer.alloc(12);
171
- const { bytesRead } = await handle.read(bytes, 0, bytes.length, 0);
172
- return { ...metadata, size: stat.size, mimeType: imageMime(bytes.subarray(0, bytesRead)), path };
173
- }
174
- finally {
175
- await handle.close();
176
- }
177
- }));
178
- if (attachments.reduce((total, attachment) => total + attachment.size, 0) > WORKSPACE_ATTACHMENT_MAX_BYTES)
179
- throw new Error('invalid_attachment');
180
- return attachments;
181
- }
182
- catch {
183
- throw new NativePreparationError('attachment_unavailable');
184
- }
185
- }
@@ -1,142 +0,0 @@
1
- import { execFile } from 'node:child_process';
2
- import { constants } from 'node:fs';
3
- import { createHash } from 'node:crypto';
4
- import { lstat, mkdir, open, realpath, rm, writeFile } from 'node:fs/promises';
5
- import { dirname, isAbsolute, join, relative, sep } from 'node:path';
6
- import { promisify } from 'node:util';
7
- import { batchCommitSourceVersion } from '@playcraft/common/cloud-workspace/runtime';
8
- import { validateProjectSkillsSnapshot } from '@playcraft/common/project-skills';
9
- const execute = promisify(execFile);
10
- const ID = /^[A-Za-z0-9_-]{1,128}$/;
11
- const COMMIT = /^(?:[a-f0-9]{40}|[a-f0-9]{64})$/;
12
- const PRIVATE_NAMES = new Set([
13
- '.ssh', '.aws', '.azure', '.gnupg', '.codex', '.npm', '.pnpm-store', '.config',
14
- '.npmrc', '.yarnrc', '.yarnrc.yml', '.netrc', '.git-credentials', 'credentials.json',
15
- 'credentials', 'secrets', 'id_rsa', 'id_ed25519', 'settings.local.json', '.playcraft.json', 'playcraft.config.json',
16
- ]);
17
- const DEPENDENCY_LOCKS = ['pnpm-lock.yaml', 'package-lock.json', 'npm-shrinkwrap.json', 'yarn.lock', 'bun.lock', 'bun.lockb'];
18
- const SKILLS_DECLARATION = '.playcraft/skills.json';
19
- const SKILLS_LOCK = '.playcraft/skills.lock.json';
20
- const sha256 = (body) => createHash('sha256').update(body).digest('hex');
21
- async function git(root, args, encoding = 'utf8') {
22
- const { stdout } = await execute('git', ['-c', 'core.hooksPath=/dev/null', '-c', 'core.fsmonitor=false', '-C', root, ...args], {
23
- timeout: 90_000, maxBuffer: 64 * 1024 * 1024, encoding: 'buffer',
24
- env: { PATH: process.env.PATH, HOME: root, GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1', GIT_TERMINAL_PROMPT: '0' },
25
- });
26
- return encoding === 'utf8' ? Buffer.from(stdout.toString('utf8').trim()) : stdout;
27
- }
28
- function assertSource(source) {
29
- if (!ID.test(source.workspaceId) || !isAbsolute(source.root))
30
- throw new Error('batch_snapshot_scope_invalid');
31
- }
32
- function engineeringPath(path) {
33
- return !path.split('/').some((name) => PRIVATE_NAMES.has(name) || /^\.env(?:$|\.)/.test(name) || /\.(?:pem|key|p12|pfx)$/.test(name));
34
- }
35
- function lockedArtifacts(declaration, lock) {
36
- const snapshot = validateProjectSkillsSnapshot(JSON.parse(declaration.toString('utf8')), JSON.parse(lock.toString('utf8')));
37
- return snapshot.lock.entries.map((entry) => `.playcraft/skill-artifacts/${entry.revision.artifactHash}.tar.gz`);
38
- }
39
- function inside(root, path) {
40
- const rel = relative(root, path);
41
- return rel === '' || (rel !== '..' && !rel.startsWith(`..${sep}`) && !isAbsolute(rel));
42
- }
43
- /** Locked skill archives are kept out of Git; each one is named by the hash of its exact bytes. */
44
- async function readArtifact(root, path) {
45
- const full = join(root, ...path.split('/'));
46
- if (!inside(root, await realpath(dirname(full)).catch(() => '')))
47
- throw new Error('batch_snapshot_skill_artifact_missing');
48
- const handle = await open(full, constants.O_RDONLY | constants.O_NOFOLLOW).catch(() => undefined);
49
- if (!handle)
50
- throw new Error('batch_snapshot_skill_artifact_missing');
51
- try {
52
- const stat = await handle.stat();
53
- if (!stat.isFile() || stat.nlink !== 1)
54
- throw new Error('batch_snapshot_skill_artifact_missing');
55
- const body = await handle.readFile();
56
- if (sha256(body) !== path.slice(path.lastIndexOf('/') + 1, -'.tar.gz'.length))
57
- throw new Error('batch_snapshot_skill_artifact_missing');
58
- return body;
59
- }
60
- finally {
61
- await handle.close();
62
- }
63
- }
64
- async function treeChecksum(root, commitHash) {
65
- const listing = await git(root, ['ls-tree', '-r', '--full-tree', '-z', commitHash], 'buffer');
66
- const paths = listing.toString('utf8').split('\0').filter(Boolean).map((line) => line.slice(line.indexOf('\t') + 1));
67
- return { checksum: sha256(listing), paths };
68
- }
69
- /**
70
- * Freezes a commit of `basic` as batch input. The commit is already saved by Git, so later edits to
71
- * `basic` never reach the batch; nothing is copied to separate storage. A commit is accepted only
72
- * when it carries the dependency lock and skill lock its build needs and no credential files.
73
- */
74
- export async function freezeBatchCommit(input) {
75
- assertSource(input.source);
76
- if (!COMMIT.test(input.commitHash) || !ID.test(input.snapshotId))
77
- throw new Error('batch_snapshot_commit_required');
78
- const root = await realpath(input.source.root);
79
- const resolved = (await git(root, ['rev-parse', '--verify', '--quiet', `${input.commitHash}^{commit}`]).catch(() => Buffer.from(''))).toString();
80
- if (resolved !== input.commitHash)
81
- throw new Error('batch_snapshot_commit_required');
82
- const { checksum, paths } = await treeChecksum(root, input.commitHash);
83
- if (paths.some((path) => !engineeringPath(path)))
84
- throw new Error('batch_snapshot_path_invalid');
85
- const tracked = new Set(paths);
86
- if (!tracked.has('package.json') || !DEPENDENCY_LOCKS.some((path) => tracked.has(path)))
87
- throw new Error('batch_snapshot_dependency_lock_required');
88
- if (!tracked.has(SKILLS_DECLARATION) || !tracked.has(SKILLS_LOCK))
89
- throw new Error('batch_snapshot_skills_lock_required');
90
- const declaration = await git(root, ['show', `${input.commitHash}:${SKILLS_DECLARATION}`], 'buffer');
91
- const lock = await git(root, ['show', `${input.commitHash}:${SKILLS_LOCK}`], 'buffer');
92
- for (const path of lockedArtifacts(declaration, lock))
93
- if (!tracked.has(path))
94
- await readArtifact(root, path);
95
- const committedAt = (await git(root, ['show', '-s', '--format=%cI', input.commitHash])).toString();
96
- return {
97
- snapshotId: input.snapshotId, sourceWorkspaceId: input.source.workspaceId, commitHash: input.commitHash, checksum,
98
- sourceVersion: batchCommitSourceVersion(input.commitHash), skillLockDigest: sha256(lock),
99
- frozenAt: new Date(committedAt).toISOString(),
100
- };
101
- }
102
- /**
103
- * Checks the frozen commit out into a new private directory and adds the locked skill archives. A
104
- * pre-existing destination is never reused, and the checkout must still match the frozen checksum.
105
- */
106
- export async function checkoutBatchCommit(input) {
107
- assertSource(input.source);
108
- if (!isAbsolute(input.destination) || !COMMIT.test(input.frozen.commitHash))
109
- throw new Error('batch_snapshot_scope_invalid');
110
- if (input.frozen.sourceWorkspaceId !== input.source.workspaceId)
111
- throw new Error('batch_snapshot_identity_mismatch');
112
- if (await lstat(input.destination).catch(() => undefined))
113
- throw new Error('batch_snapshot_destination_exists');
114
- const root = await realpath(input.source.root);
115
- const { checksum } = await treeChecksum(root, input.frozen.commitHash);
116
- if (checksum !== input.frozen.checksum)
117
- throw new Error('batch_snapshot_identity_mismatch');
118
- await mkdir(dirname(input.destination), { recursive: true });
119
- try {
120
- await execute('git', ['-c', 'core.hooksPath=/dev/null', 'clone', '--local', '--no-hardlinks', '--no-checkout', '--', root, input.destination], {
121
- timeout: 90_000, maxBuffer: 1024 * 1024,
122
- env: { PATH: process.env.PATH, HOME: dirname(input.destination), GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1', GIT_TERMINAL_PROMPT: '0' },
123
- });
124
- await git(input.destination, ['checkout', '--detach', input.frozen.commitHash]);
125
- const lock = await git(input.destination, ['show', `${input.frozen.commitHash}:${SKILLS_LOCK}`], 'buffer');
126
- if (sha256(lock) !== input.frozen.skillLockDigest)
127
- throw new Error('batch_snapshot_identity_mismatch');
128
- const declaration = await git(input.destination, ['show', `${input.frozen.commitHash}:${SKILLS_DECLARATION}`], 'buffer');
129
- for (const path of lockedArtifacts(declaration, lock)) {
130
- const target = join(input.destination, ...path.split('/'));
131
- if (await lstat(target).catch(() => undefined))
132
- continue;
133
- const body = await readArtifact(root, path);
134
- await mkdir(dirname(target), { recursive: true });
135
- await writeFile(target, body, { flag: 'wx', mode: 0o600 });
136
- }
137
- }
138
- catch (cause) {
139
- await rm(input.destination, { recursive: true, force: true });
140
- throw cause;
141
- }
142
- }
@@ -1,23 +0,0 @@
1
- import { randomUUID } from 'node:crypto';
2
- import { lstat, mkdir, rename, rm, writeFile } from 'node:fs/promises';
3
- import { join } from 'node:path';
4
- import { excludeFromGit } from './dependencies.js';
5
- /** Non-secret routing hint; the business service still authorizes the selected workspace. */
6
- export async function writeWorkspaceCliContext(root, workspaceId) {
7
- const management = join(root, '.playcraft');
8
- await mkdir(management, { mode: 0o755 }).catch(error => { if (error.code !== 'EEXIST')
9
- throw error; });
10
- const stat = await lstat(management);
11
- if (!stat.isDirectory() || stat.isSymbolicLink())
12
- throw new Error('workspace_skills_invalid');
13
- const temporary = join(management, `workspace-context.${randomUUID()}.tmp`);
14
- try {
15
- await writeFile(temporary, `${JSON.stringify({ schemaVersion: 'playcraft.workspace-context.v1', workspaceId })}\n`, { flag: 'wx', mode: 0o644 });
16
- await rename(temporary, join(management, 'workspace-context.json'));
17
- await excludeFromGit(root, '/.playcraft/workspace-context.json');
18
- await excludeFromGit(root, '/.playcraft/video-replication/');
19
- }
20
- finally {
21
- await rm(temporary, { force: true });
22
- }
23
- }
@@ -1,111 +0,0 @@
1
- import { randomUUID } from 'node:crypto';
2
- import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
3
- import { join } from 'node:path';
4
- import { z } from 'zod';
5
- import { PLATFORM_ROUTES, platformEndpoint } from '@playcraft/common/cloud-workspace/runtime';
6
- const responseSchema = z.object({
7
- token: z.string().min(1),
8
- apiUrl: z.string().url(),
9
- expiresAt: z.string().datetime(),
10
- claims: z.object({
11
- kind: z.literal('cloud-runtime-cli'),
12
- environment: z.string(),
13
- userId: z.string(),
14
- runtimeId: z.string(),
15
- generation: z.number().int(),
16
- runtimeEpoch: z.number().int(),
17
- }),
18
- });
19
- const entries = new WeakMap();
20
- /** The file is outside every checkout, shared by all workspaces owned by this sandbox's user. */
21
- export async function ensureCliCredentials(state) {
22
- let entry = entries.get(state);
23
- if (!entry) {
24
- entry = { closed: false, expiresAt: 0, epoch: -1 };
25
- entries.set(state, entry);
26
- }
27
- if (entry.closed)
28
- throw new Error('cli_credentials_unavailable');
29
- if (entry.epoch === state.runtimeEpoch && entry.expiresAt > Date.now() + 60_000)
30
- return;
31
- if (!entry.pending)
32
- entry.pending = renew(state, entry).finally(() => {
33
- entry.pending = undefined;
34
- });
35
- await entry.pending;
36
- }
37
- async function renew(state, entry) {
38
- const config = state.config;
39
- const epoch = state.runtimeEpoch;
40
- const endpoint = platformEndpoint(config.publicBaseUrl, PLATFORM_ROUTES.cliCredentials);
41
- try {
42
- const response = await fetch(endpoint, {
43
- method: 'POST',
44
- redirect: 'error',
45
- signal: AbortSignal.timeout(10_000),
46
- headers: {
47
- authorization: `Bearer ${config.controlToken}`,
48
- 'content-type': 'application/json',
49
- 'playcraft-env': config.environment,
50
- },
51
- body: JSON.stringify({
52
- runtimeId: config.runtimeId,
53
- generation: config.generation,
54
- runtimeEpoch: epoch,
55
- }),
56
- });
57
- if (!response.ok) {
58
- await response.body?.cancel();
59
- throw new Error('cli_credentials_unavailable');
60
- }
61
- const credential = responseSchema.parse(await response.json());
62
- const claims = credential.claims;
63
- if (entry.closed ||
64
- state.journal.destroyed() ||
65
- epoch !== state.runtimeEpoch ||
66
- claims.environment !== config.environment ||
67
- claims.userId !== config.userId ||
68
- claims.runtimeId !== config.runtimeId ||
69
- claims.generation !== config.generation ||
70
- claims.runtimeEpoch !== epoch ||
71
- Date.parse(credential.expiresAt) <= Date.now() + 60_000)
72
- throw new Error('cli_credential_scope_mismatch');
73
- await mkdir(config.workspaceRoot, { recursive: true });
74
- const temporary = join(config.workspaceRoot, `.playcraft-credential-${randomUUID()}.tmp`);
75
- try {
76
- await writeFile(temporary, JSON.stringify({
77
- apiUrl: credential.apiUrl,
78
- token: credential.token,
79
- env: config.environment,
80
- userId: config.userId,
81
- expiresAt: credential.expiresAt,
82
- }), { flag: 'wx', mode: 0o644 });
83
- await rename(temporary, join(config.workspaceRoot, '.playcraft.json'));
84
- }
85
- finally {
86
- await rm(temporary, { force: true });
87
- }
88
- entry.expiresAt = Date.parse(credential.expiresAt);
89
- entry.epoch = epoch;
90
- }
91
- finally {
92
- if (!entry.closed && !state.journal.destroyed()) {
93
- if (entry.timer)
94
- clearTimeout(entry.timer);
95
- const wait = entry.expiresAt > Date.now() + 60_000 ? entry.expiresAt - Date.now() - 59_000 : 30_000;
96
- entry.timer = setTimeout(() => void ensureCliCredentials(state).catch(() => undefined), wait);
97
- entry.timer.unref();
98
- }
99
- }
100
- }
101
- export async function closeCliCredentials(state) {
102
- const entry = entries.get(state);
103
- if (entry) {
104
- entry.closed = true;
105
- if (entry.timer)
106
- clearTimeout(entry.timer);
107
- await entry.pending?.catch(() => undefined);
108
- }
109
- if (entry)
110
- await rm(join(state.config.workspaceRoot, '.playcraft.json'), { force: true });
111
- }