@playcraft/cli 0.1.40-beta → 0.1.42

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