@playcraft/cli 0.1.38-beta → 0.1.39-prod

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