@playcraft/cli 0.1.37-beta → 0.1.39-prod

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (366) hide show
  1. package/README.md +3 -58
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build-all.js +19 -5
  5. package/dist/commands/build.js +28 -15
  6. package/dist/commands/create.js +33 -26
  7. package/dist/commands/image.js +6 -2
  8. package/dist/commands/login.js +42 -84
  9. package/dist/commands/skills.js +0 -4
  10. package/dist/commands/tools-3d.js +0 -11
  11. package/dist/commands/tools-generation.js +126 -68
  12. package/dist/commands/tools-image-context.js +23 -0
  13. package/dist/commands/tools.js +2 -2
  14. package/dist/config.js +4 -59
  15. package/dist/index.js +3 -40
  16. package/dist/remix/clone.js +0 -2
  17. package/dist/remix/init-template.js +0 -2
  18. package/dist/remix/pull.js +0 -2
  19. package/dist/remix/push.js +1 -21
  20. package/dist/utils/agent-api-client.js +30 -185
  21. package/dist/utils/image-asset-context.js +106 -0
  22. package/dist/utils/playcraft-http-client.js +4 -6
  23. package/package.json +5 -15
  24. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  25. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  26. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  29. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  30. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  31. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  35. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  36. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  37. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  41. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  42. package/SKILLS_REGISTRY.md +0 -149
  43. package/dist/auth/account-activation.js +0 -157
  44. package/dist/auth/messages.js +0 -30
  45. package/dist/commands/build-temp.js +0 -26
  46. package/dist/commands/platform-skills.generated.js +0 -19
  47. package/dist/commands/playable.js +0 -53
  48. package/dist/commands/tools-batch.js +0 -87
  49. package/dist/commands/video.js +0 -111
  50. package/dist/commands/workspace-runtime.js +0 -54
  51. package/dist/commands/workspace.js +0 -35
  52. package/dist/project-skills/builtin-import.js +0 -225
  53. package/dist/project-skills/commands.js +0 -77
  54. package/dist/project-skills/lifecycle.js +0 -28
  55. package/dist/project-skills/local-run.js +0 -112
  56. package/dist/project-skills/local-store.js +0 -221
  57. package/dist/project-skills/messages.js +0 -80
  58. package/dist/project-skills/reconcile.js +0 -62
  59. package/dist/project-skills/remote-cache.js +0 -51
  60. package/dist/project-skills/validation.js +0 -19
  61. package/dist/recording/messages.js +0 -40
  62. package/dist/recording/project-digest.js +0 -85
  63. package/dist/recording/recorder.js +0 -293
  64. package/dist/recording/scenario.js +0 -50
  65. package/dist/skill-registry/client.js +0 -345
  66. package/dist/skill-registry/commands.js +0 -180
  67. package/dist/skill-registry/evaluation-client.js +0 -156
  68. package/dist/skill-registry/evaluation-commands.js +0 -174
  69. package/dist/skill-registry/messages.js +0 -177
  70. package/dist/skill-registry/package.js +0 -275
  71. package/dist/skill-registry/platform-package.js +0 -100
  72. package/dist/utils/environment-endpoints.js +0 -17
  73. package/dist/utils/tool-operation-journal.js +0 -124
  74. package/dist/utils/video-evidence-git.js +0 -81
  75. package/dist/video-replication/client.js +0 -222
  76. package/dist/video-replication/comparison-evidence.js +0 -149
  77. package/dist/video-replication/comparison-files.js +0 -57
  78. package/dist/video-replication/comparison-log.js +0 -72
  79. package/dist/video-replication/comparison-messages.js +0 -104
  80. package/dist/video-replication/comparison-output.js +0 -63
  81. package/dist/video-replication/comparison-preflight.js +0 -66
  82. package/dist/video-replication/comparison.js +0 -216
  83. package/dist/video-replication/evidence.js +0 -165
  84. package/dist/video-replication/media.js +0 -111
  85. package/dist/video-replication/messages.js +0 -89
  86. package/dist/workspace/messages.js +0 -35
  87. package/dist/workspace/transfer-client.js +0 -174
  88. package/dist/workspace-runtime/codex/app-server.js +0 -1040
  89. package/dist/workspace-runtime/codex/compact.js +0 -46
  90. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  91. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  92. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  93. package/dist/workspace-runtime/codex/loopback.js +0 -146
  94. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  95. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  96. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  97. package/dist/workspace-runtime/codex/permissions.js +0 -70
  98. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  99. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  100. package/dist/workspace-runtime/codex/ui-tools.js +0 -183
  101. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  102. package/dist/workspace-runtime/main.js +0 -10
  103. package/dist/workspace-runtime/persistence/journal.js +0 -358
  104. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  105. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  106. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  107. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  108. package/dist/workspace-runtime/previews/output.js +0 -36
  109. package/dist/workspace-runtime/previews/publish.js +0 -262
  110. package/dist/workspace-runtime/previews/single-file.js +0 -43
  111. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  112. package/dist/workspace-runtime/production/contracts.js +0 -19
  113. package/dist/workspace-runtime/production/controller.js +0 -218
  114. package/dist/workspace-runtime/production/dependencies.js +0 -60
  115. package/dist/workspace-runtime/production/native.js +0 -212
  116. package/dist/workspace-runtime/production/processes.js +0 -102
  117. package/dist/workspace-runtime/production/save-command.js +0 -35
  118. package/dist/workspace-runtime/production/source-archive.js +0 -137
  119. package/dist/workspace-runtime/production/source-copy.js +0 -91
  120. package/dist/workspace-runtime/production/stages.js +0 -303
  121. package/dist/workspace-runtime/production/storage.js +0 -60
  122. package/dist/workspace-runtime/serve.js +0 -214
  123. package/dist/workspace-runtime/server/auth.js +0 -21
  124. package/dist/workspace-runtime/server/connectivity.js +0 -201
  125. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  126. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  127. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  128. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  129. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  130. package/dist/workspace-runtime/server/dispatch.js +0 -1217
  131. package/dist/workspace-runtime/server/endpoints.js +0 -21
  132. package/dist/workspace-runtime/server/execution-group.js +0 -90
  133. package/dist/workspace-runtime/server/http.js +0 -1243
  134. package/dist/workspace-runtime/server/lock.js +0 -53
  135. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  136. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  137. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  138. package/dist/workspace-runtime/server/types.js +0 -1
  139. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  140. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  141. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  142. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  143. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  144. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  145. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  146. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  147. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  148. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  149. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  150. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  151. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  152. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  153. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  154. package/dist/workspace-runtime/workspaces/directories.js +0 -133
  155. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  156. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  157. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  158. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  159. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  160. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  161. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  162. package/dist/workspace-runtime/workspaces/files.js +0 -120
  163. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  164. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  165. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  166. package/dist/workspace-runtime/workspaces/git.js +0 -670
  167. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  168. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  169. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  170. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  171. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  172. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  173. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  174. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  175. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  176. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  177. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  178. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  179. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  180. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  181. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  182. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  183. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  184. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  185. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  186. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  187. package/project-template-v2/.claude/agents/artist.md +0 -82
  188. package/project-template-v2/.claude/agents/developer.md +0 -153
  189. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  190. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  191. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  192. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  193. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  194. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  195. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  196. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  197. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  198. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  199. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  200. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  201. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  202. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  203. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  204. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  205. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  206. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  207. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  208. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  209. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  210. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  211. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  212. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  213. package/project-template-v2/.claude/settings.json +0 -33
  214. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  215. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  216. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  219. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  220. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  221. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  222. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  223. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  224. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  225. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  226. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  227. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  228. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  229. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  230. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  236. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  237. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  238. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  239. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  240. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  241. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  242. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  243. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  244. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  245. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  246. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  247. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  248. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  249. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  250. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  251. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  252. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  253. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  254. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  255. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  256. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  257. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  258. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  259. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  260. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  261. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  262. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  263. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  264. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  269. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  270. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  271. package/project-template-v2/.claude/snapshot.mjs +0 -263
  272. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  273. package/project-template-v2/CLAUDE.md +0 -146
  274. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  275. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  276. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  277. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  278. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  281. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  282. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  283. package/project-template-v2/assets/models/.gitkeep +0 -0
  284. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  285. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  286. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  287. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  288. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  289. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  290. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  291. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  292. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  293. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  294. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  295. package/project-template-v2/docs/project-state.json +0 -60
  296. package/project-template-v2/docs/project-state.md +0 -72
  297. package/project-template-v2/docs/standards/README.md +0 -225
  298. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  299. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  300. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  301. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  302. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  303. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  304. package/project-template-v2/game/index.ts +0 -18
  305. package/project-template-v2/globals.d.ts +0 -51
  306. package/project-template-v2/index.css +0 -34
  307. package/project-template-v2/index.html +0 -18
  308. package/project-template-v2/main.ts +0 -9
  309. package/project-template-v2/package.json +0 -46
  310. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  311. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  312. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  313. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  314. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  315. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  316. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  317. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  318. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  319. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  320. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  321. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  322. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  323. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  324. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  325. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  326. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  327. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  328. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  329. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  330. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  331. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  332. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  333. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  334. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  335. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  336. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  337. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  338. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  339. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  340. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  341. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  342. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  343. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  344. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  345. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  346. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  347. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  348. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  349. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  350. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  351. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  354. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  355. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  356. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  357. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  358. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  359. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  360. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  361. package/project-template-v2/tsconfig.json +0 -20
  362. package/project-template-v2/vite.config.ts +0 -27
  363. package/project-templates/batch-locks/phaser.yaml +0 -922
  364. package/project-templates/batch-locks/threejs.yaml +0 -978
  365. package/project-templates/empty/AGENTS.md +0 -41
  366. package/project-templates/empty/gitignore +0 -33
@@ -1,366 +0,0 @@
1
- import { productionDirectoryBusy } from '../production/controller.js';
2
- import { createRequire } from 'node:module';
3
- import { randomUUID } from 'node:crypto';
4
- import { lstat } from 'node:fs/promises';
5
- import { StringDecoder } from 'node:string_decoder';
6
- import { WebSocketServer } from 'ws';
7
- import { appendTerminalOutput, createTerminalOutputLog, decodeTerminalBytes, runtimeError, terminalClientFrameSchema, terminalOutputSince, } from '@playcraft/common/cloud-workspace/runtime';
8
- import { resolveWorkspaceFile } from '../workspaces/files.js';
9
- import { sessionWorkspaceRoot } from '../workspaces/registry.js';
10
- import { startLauncherProcess } from '../codex/launcher-client.js';
11
- import { controlTokenMatches, extractControlToken } from './auth.js';
12
- const require = createRequire(import.meta.url);
13
- const commands = new WeakMap();
14
- const hosts = new WeakMap();
15
- export function setTerminalCommand(state, command) {
16
- commands.set(state, command);
17
- }
18
- export function terminalHost(state) {
19
- let host = hosts.get(state);
20
- if (!host) {
21
- host = new TerminalHost(state);
22
- hosts.set(state, host);
23
- }
24
- return host;
25
- }
26
- export function disposeTerminalHost(state) {
27
- hosts.get(state)?.dispose();
28
- hosts.delete(state);
29
- }
30
- export class TerminalHost {
31
- state;
32
- disposed = false;
33
- sessions = new Map();
34
- spawning = new Map();
35
- restored;
36
- attempted = new Set();
37
- closing = new Set();
38
- stops = new Map();
39
- confirmed = new Set();
40
- sockets = new WebSocketServer({ noServer: true });
41
- constructor(state) {
42
- this.state = state;
43
- // An absent in-memory session cannot prove a restored terminal's old process group stopped.
44
- this.restored = new Set((state.journal?.listTerminals?.() ?? []).map(terminal => terminal.terminalId));
45
- }
46
- async handleUpgrade(request, socket, head) {
47
- const url = new URL(request.url ?? '/', 'http://127.0.0.1');
48
- const match = /^\/runtime\/terminals\/([^/]+)\/connect$/.exec(url.pathname);
49
- if (!match || !controlTokenMatches(this.state.config.controlToken, extractControlToken(request.headers))) {
50
- rejectUpgrade(socket, 401, runtimeError('unauthenticated', 'control_token_required'));
51
- return;
52
- }
53
- if (this.disposed || this.state.journal.destroyed()) {
54
- rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'runtime_destroyed'));
55
- return;
56
- }
57
- let terminalId;
58
- try {
59
- terminalId = decodeURIComponent(match[1]);
60
- }
61
- catch {
62
- rejectUpgrade(socket, 404, { error: 'terminal_not_found' });
63
- return;
64
- }
65
- const terminal = this.state.journal.getTerminal(terminalId);
66
- if (!terminal) {
67
- rejectUpgrade(socket, 404, { error: 'terminal_not_found' });
68
- return;
69
- }
70
- if (await productionDirectoryBusy(this.state, terminal.workspaceId, terminal.directoryName)) {
71
- rejectUpgrade(socket, 409, { error: 'batch_workspace_readonly' });
72
- return;
73
- }
74
- if (terminal.status === 'destroyed') {
75
- rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'terminal_destroyed'));
76
- return;
77
- }
78
- if (this.closing.has(terminalId) || this.restored.has(terminalId) && !this.sessions.has(terminalId)) {
79
- rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'terminal_stop_unconfirmed'));
80
- return;
81
- }
82
- let session = this.sessions.get(terminal.terminalId);
83
- if (!session) {
84
- try {
85
- let pending = this.spawning.get(terminal.terminalId);
86
- if (!pending) {
87
- pending = terminalDirectory(this.state, terminal).then((cwd) => this.spawn(terminal, cwd))
88
- .finally(() => this.spawning.delete(terminal.terminalId));
89
- this.spawning.set(terminal.terminalId, pending);
90
- }
91
- session = await pending;
92
- }
93
- catch {
94
- rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'pty_unavailable'));
95
- return;
96
- }
97
- }
98
- if (this.disposed || this.state.journal.destroyed() || this.closing.has(terminalId) || this.state.journal.getTerminal(terminalId)?.status === 'destroyed') {
99
- if (!this.closing.has(terminalId))
100
- this.revoke(terminalId, 'terminal_destroyed');
101
- rejectUpgrade(socket, 409, runtimeError('capability_unavailable', 'terminal_destroyed'));
102
- return;
103
- }
104
- const active = session;
105
- this.sockets.handleUpgrade(request, socket, head, (ws) => this.attach(active, ws));
106
- }
107
- destroy(terminalId) {
108
- const pending = this.stops.get(terminalId);
109
- if (pending)
110
- return pending;
111
- this.closing.add(terminalId);
112
- const stopped = (async () => {
113
- await this.spawning.get(terminalId);
114
- const session = this.sessions.get(terminalId);
115
- if (session)
116
- await session.stop();
117
- else if (!this.confirmed.has(terminalId) && (this.restored.has(terminalId) || this.attempted.has(terminalId)))
118
- throw new Error('terminal_stop_unconfirmed');
119
- const terminal = this.state.journal.getTerminal(terminalId);
120
- if (!terminal)
121
- throw new Error('terminal_not_found');
122
- const destroyed = terminal.status === 'destroyed' ? terminal : await this.state.journal.putTerminal({
123
- ...terminal, status: 'destroyed', destroyedAt: new Date().toISOString(),
124
- });
125
- this.confirmed.add(terminalId);
126
- this.revoke(terminalId, 'terminal_destroyed');
127
- this.closing.delete(terminalId);
128
- return destroyed;
129
- })().finally(() => this.stops.delete(terminalId));
130
- this.stops.set(terminalId, stopped);
131
- return stopped;
132
- }
133
- revoke(terminalId, reason) {
134
- const session = this.sessions.get(terminalId);
135
- if (!session)
136
- return;
137
- this.sessions.delete(terminalId);
138
- const frame = { type: 'revoked', reason };
139
- for (const listener of session.listeners)
140
- listener(frame);
141
- session.listeners.clear();
142
- try {
143
- session.pty.kill();
144
- }
145
- catch {
146
- /* the process may already have exited */
147
- }
148
- }
149
- dispose() {
150
- this.disposed = true;
151
- for (const terminalId of [...this.sessions.keys()])
152
- this.revoke(terminalId, 'runtime_destroyed');
153
- this.sockets.close();
154
- }
155
- async spawn(terminal, cwd) {
156
- if (this.disposed)
157
- throw new Error('pty_unavailable');
158
- if (this.state.config.workspaceMode === 'multi' || process.env.PLAYCRAFT_LAUNCHER_SOCKET
159
- || process.getuid?.() === 1500) {
160
- // User shells require the root launcher's fixed development account, even when an
161
- // alternative command is installed for local tests. Never fall back to the control user.
162
- const socketPath = process.env.PLAYCRAFT_LAUNCHER_SOCKET;
163
- if (!socketPath)
164
- throw new Error('pty_unavailable');
165
- this.attempted.add(terminal.terminalId);
166
- const child = await startLauncherProcess({ socketPath, processId: `terminal-${randomUUID()}`,
167
- runtimeEpoch: this.state.runtimeEpoch, cwd, argv: [], env: {}, terminal: { cols: 80, rows: 24 } });
168
- if (this.disposed) {
169
- await child.stop();
170
- throw new Error('pty_unavailable');
171
- }
172
- const session = { terminalId: terminal.terminalId, streamId: randomUUID(), log: createTerminalOutputLog(), listeners: new Set(),
173
- stop: () => child.stop(),
174
- pty: { write: (data) => { child.stdin?.write(data); }, resize: child.resize,
175
- kill: () => { void child.stop().catch(() => undefined); } } };
176
- const decoder = new StringDecoder('utf8');
177
- child.stdout?.on('data', (data) => { const text = decoder.write(data); if (text)
178
- publish(session, text); });
179
- child.onExit((code) => {
180
- const tail = decoder.end();
181
- if (tail)
182
- publish(session, tail);
183
- const stopped = code === undefined ? Promise.resolve(false) : child.stop().then(() => true, () => false);
184
- void stopped.then(confirmed => this.exited(terminal.terminalId, session, confirmed ? code : undefined)).catch(() => undefined);
185
- });
186
- this.sessions.set(terminal.terminalId, session);
187
- return session;
188
- }
189
- const pty = require('node-pty');
190
- const command = commands.get(this.state) ?? defaultShell();
191
- let finishExit;
192
- let didExit = false;
193
- const knownExit = new Promise(resolve => { finishExit = () => { didExit = true; resolve(); }; });
194
- this.attempted.add(terminal.terminalId);
195
- const session = {
196
- terminalId: terminal.terminalId,
197
- streamId: randomUUID(),
198
- log: createTerminalOutputLog(),
199
- listeners: new Set(),
200
- pty: pty.spawn(command.file, command.args, {
201
- name: 'xterm-256color',
202
- cols: 80,
203
- rows: 24,
204
- cwd,
205
- env: shellEnv(command.file, cwd),
206
- }),
207
- stop: async () => {
208
- if (!didExit)
209
- session.pty.kill();
210
- let timer;
211
- try {
212
- await Promise.race([knownExit, new Promise((_resolve, reject) => {
213
- timer = setTimeout(() => reject(new Error('terminal_stop_unconfirmed')), 3000);
214
- })]);
215
- }
216
- finally {
217
- clearTimeout(timer);
218
- }
219
- },
220
- };
221
- const local = session.pty;
222
- local.onData((data) => publish(session, data));
223
- local.onExit(({ exitCode, signal }) => { finishExit(); void this.exited(terminal.terminalId, session, exitCode, signal).catch(() => undefined); });
224
- this.sessions.set(terminal.terminalId, session);
225
- return session;
226
- }
227
- async exited(terminalId, session, code, signal) {
228
- session.exited = { code: code ?? null, ...(signal === undefined ? {} : { signal: String(signal) }) };
229
- try {
230
- if (code !== undefined) {
231
- const terminal = this.state.journal.getTerminal(terminalId);
232
- if (terminal && terminal.status !== 'destroyed')
233
- await this.state.journal.putTerminal({
234
- ...terminal, status: 'destroyed', destroyedAt: new Date().toISOString(),
235
- });
236
- if (terminal)
237
- this.confirmed.add(terminalId);
238
- }
239
- }
240
- finally {
241
- for (const listener of session.listeners)
242
- listener(exitFrame(session));
243
- }
244
- }
245
- attach(session, ws) {
246
- let open = true;
247
- let resumed = false;
248
- let cursor = 0;
249
- const send = (frame) => {
250
- if (open && ws.readyState === ws.OPEN)
251
- ws.send(JSON.stringify(frame));
252
- };
253
- const listener = (frame) => {
254
- if (!resumed)
255
- return;
256
- if (frame.type === 'output') {
257
- const end = frame.offset + decodeTerminalBytes(frame.data).length;
258
- if (end <= cursor)
259
- return;
260
- cursor = Math.max(cursor, end);
261
- }
262
- send(frame);
263
- };
264
- session.listeners.add(listener);
265
- ws.on('message', (raw) => {
266
- let body;
267
- try {
268
- body = JSON.parse(String(raw));
269
- }
270
- catch {
271
- return;
272
- }
273
- const parsed = terminalClientFrameSchema.safeParse(body);
274
- if (!parsed.success || (session.exited || this.closing.has(session.terminalId)) && parsed.data.type !== 'resume')
275
- return;
276
- const frame = parsed.data;
277
- if (frame.type === 'resume') {
278
- if (frame.streamId && frame.streamId !== session.streamId) {
279
- send({ type: 'reset', streamId: session.streamId, offset: session.log.end });
280
- cursor = session.log.end;
281
- resumed = true;
282
- if (session.exited)
283
- send(exitFrame(session));
284
- return;
285
- }
286
- const since = terminalOutputSince(session.log, frame.offset);
287
- if (since.gap)
288
- send({ type: 'gap', streamId: session.streamId, offset: since.offset });
289
- for (const item of since.frames) {
290
- send({ type: 'output', streamId: session.streamId, offset: item.offset, data: item.data });
291
- }
292
- cursor = session.log.end;
293
- resumed = true;
294
- if (session.exited)
295
- send(exitFrame(session));
296
- return;
297
- }
298
- if (!resumed)
299
- return;
300
- if (frame.type === 'resize') {
301
- session.pty.resize(frame.cols, frame.rows);
302
- return;
303
- }
304
- session.pty.write(Buffer.from(decodeTerminalBytes(frame.data)).toString('utf8'));
305
- });
306
- const detach = () => {
307
- open = false;
308
- session.listeners.delete(listener);
309
- };
310
- ws.on('close', detach);
311
- ws.on('error', detach);
312
- }
313
- }
314
- function publish(session, text) {
315
- const before = session.log.end;
316
- session.log = appendTerminalOutput(session.log, text);
317
- const since = terminalOutputSince(session.log, before);
318
- for (const item of since.frames) {
319
- const frame = {
320
- type: 'output',
321
- streamId: session.streamId,
322
- offset: item.offset,
323
- data: item.data,
324
- };
325
- for (const listener of session.listeners)
326
- listener(frame);
327
- }
328
- }
329
- function exitFrame(session) {
330
- return {
331
- type: 'exit',
332
- streamId: session.streamId,
333
- code: session.exited?.code ?? null,
334
- ...(session.exited?.signal ? { signal: session.exited.signal } : {}),
335
- };
336
- }
337
- async function terminalDirectory(state, terminal) {
338
- const root = await sessionWorkspaceRoot(state, terminal.workspaceId, terminal.directoryName);
339
- if (!terminal.cwd)
340
- return root;
341
- const resolved = await resolveWorkspaceFile(root, terminal.cwd);
342
- const stat = await lstat(resolved);
343
- if (!stat.isDirectory() || stat.isSymbolicLink())
344
- throw new Error('pty_unavailable');
345
- return resolved;
346
- }
347
- function defaultShell() {
348
- const shell = process.env.SHELL;
349
- const file = shell && shell.startsWith('/') ? shell : '/bin/sh';
350
- return { file, args: ['-i'] };
351
- }
352
- function shellEnv(file, cwd) {
353
- return {
354
- PATH: process.env.PATH ?? '/usr/bin:/bin',
355
- HOME: process.env.HOME ?? cwd,
356
- TERM: 'xterm-256color',
357
- LANG: process.env.LANG ?? 'C.UTF-8',
358
- SHELL: file,
359
- };
360
- }
361
- function rejectUpgrade(socket, status, body) {
362
- const payload = JSON.stringify(body);
363
- const title = status === 401 ? 'Unauthorized' : status === 404 ? 'Not Found' : 'Conflict';
364
- socket.write(`HTTP/1.1 ${status} ${title}\r\ncontent-type: application/json; charset=utf-8\r\ncontent-length: ${Buffer.byteLength(payload)}\r\nconnection: close\r\n\r\n${payload}`);
365
- socket.destroy();
366
- }
@@ -1 +0,0 @@
1
- export {};
@@ -1,99 +0,0 @@
1
- import { createReadStream } from 'node:fs';
2
- import { stat } from 'node:fs/promises';
3
- import { pipeline } from 'node:stream/promises';
4
- import { applyWorkspaceTransfer, createWorkspaceTransfer, WORKSPACE_TRANSFER_MAX_BYTES, WorkspaceTransferError } from '../workspaces/transfer.js';
5
- import { revisionScope, sessionWorkspaceRoot } from '../workspaces/registry.js';
6
- import { workspaceDirectoryOccupied } from '../workspaces/directory-maintenance.js';
7
- import { publishSourceEvents } from './dispatch.js';
8
- export async function handleWorkspaceTransfer(state, request, response, url) {
9
- const workspaceId = url.searchParams.get('workspaceId') ?? undefined;
10
- const directoryName = url.searchParams.get('directoryName') ?? 'basic';
11
- const root = await sessionWorkspaceRoot(state, workspaceId, directoryName);
12
- const controller = new AbortController();
13
- const abort = () => controller.abort();
14
- const close = () => { if (!response.writableEnded)
15
- abort(); };
16
- request.once('aborted', abort);
17
- response.once('close', close);
18
- try {
19
- if (request.method === 'GET') {
20
- const snapshot = await createWorkspaceTransfer(root);
21
- try {
22
- controller.signal.throwIfAborted();
23
- response.writeHead(200, { 'content-type': 'application/octet-stream', 'cache-control': 'private, no-store',
24
- 'content-length': (await stat(snapshot.bundlePath)).size, 'x-content-type-options': 'nosniff',
25
- 'x-playcraft-workspace-tree': snapshot.tree, 'x-playcraft-workspace-head': snapshot.head });
26
- await pipeline(createReadStream(snapshot.bundlePath), response, { signal: controller.signal });
27
- }
28
- finally {
29
- await snapshot.cleanup();
30
- }
31
- return;
32
- }
33
- const expectedTree = request.headers['x-playcraft-workspace-tree'];
34
- if (typeof expectedTree !== 'string' || !/^[a-f0-9]{40,64}$/.test(expectedTree))
35
- throw new WorkspaceTransferError('invalid_workspace_transfer');
36
- if (Number(request.headers['content-length'] ?? 0) > WORKSPACE_TRANSFER_MAX_BYTES)
37
- throw new WorkspaceTransferError('workspace_transfer_too_large');
38
- const chunks = [];
39
- let size = 0;
40
- for await (const chunk of request) {
41
- size += chunk.length;
42
- if (size > WORKSPACE_TRANSFER_MAX_BYTES)
43
- throw new WorkspaceTransferError('workspace_transfer_too_large');
44
- chunks.push(Buffer.from(chunk));
45
- }
46
- const directories = directoryName === 'root'
47
- ? [...new Set(['root', 'basic', ...(state.journal.getWorkspace(workspaceId ?? '')?.directories ?? []).map(item => item.directoryName)])].sort()
48
- : [...new Set(['root', directoryName])].sort();
49
- const lockKeys = [...new Set([...directories.map(name => `directory:${workspaceId}:${name}`),
50
- ...directories.map(name => `workspace:${revisionScope(state, workspaceId, name) ?? 'single'}`)])];
51
- const locked = async (index) => index < lockKeys.length
52
- ? state.journal.exclusive(lockKeys[index], () => locked(index + 1))
53
- : apply();
54
- const apply = async () => {
55
- controller.signal.throwIfAborted();
56
- if (state.journal.destroyed())
57
- throw new WorkspaceTransferError('runtime_destroyed');
58
- for (const directory of directories) {
59
- if (await workspaceDirectoryOccupied(state, workspaceId ?? 'workspace', directory))
60
- throw new WorkspaceTransferError('workspace_transfer_busy');
61
- }
62
- return applyWorkspaceTransfer(root, Buffer.concat(chunks, size), expectedTree);
63
- };
64
- const result = await locked(0);
65
- if (result.changedPaths.length > 0) {
66
- const groups = new Map([[directoryName, result.changedPaths]]);
67
- if (directoryName === 'root')
68
- for (const path of result.changedPaths) {
69
- const [directory, ...parts] = path.split('/');
70
- if (directory && directories.includes(directory) && parts.length)
71
- groups.set(directory, [...(groups.get(directory) ?? []), parts.join('/')]);
72
- }
73
- const events = [];
74
- for (const [directory, paths] of groups)
75
- events.push(await state.journal.allocateSourceEvent({
76
- runtimeId: state.config.runtimeId, generation: state.config.generation, runtimeEpoch: state.runtimeEpoch,
77
- workspaceId, type: 'files.changed', occurredAt: new Date().toISOString(), payload: { workspaceId, directoryName: directory, paths },
78
- }));
79
- await publishSourceEvents(state, events);
80
- }
81
- writeJson(response, 200, result);
82
- }
83
- catch (error) {
84
- if (response.headersSent)
85
- response.destroy(error instanceof Error ? error : undefined);
86
- else if (!controller.signal.aborted) {
87
- const code = error instanceof WorkspaceTransferError ? error.code : 'workspace_transfer_failed';
88
- writeJson(response, code === 'workspace_transfer_too_large' ? 413 : code === 'invalid_workspace_transfer' ? 400 : 409, { error: code });
89
- }
90
- }
91
- finally {
92
- request.off('aborted', abort);
93
- response.off('close', close);
94
- }
95
- }
96
- function writeJson(response, status, body) {
97
- response.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'private, no-store' });
98
- response.end(JSON.stringify(body));
99
- }
@@ -1,207 +0,0 @@
1
- import { constants } from 'node:fs';
2
- import { lstat, open, opendir, realpath } from 'node:fs/promises';
3
- import { join, relative, sep } from 'node:path';
4
- import { Readable, Transform } from 'node:stream';
5
- import { pipeline } from 'node:stream/promises';
6
- import { createDeflateRaw } from 'node:zlib';
7
- import { isCredentialFile } from './git.js';
8
- const EXCLUDED_NAMES = new Set(['.git', 'node_modules', '.playcraft.json', '.playcraft-workspace.json']);
9
- const MAX_SOURCE_BYTES = 2 * 1024 * 1024 * 1024;
10
- const MAX_ENTRIES = 50_000;
11
- const UTF8_DESCRIPTOR_FLAGS = 0x0808;
12
- const CRC_TABLE = Uint32Array.from({ length: 256 }, (_, value) => {
13
- let crc = value;
14
- for (let bit = 0; bit < 8; bit += 1)
15
- crc = (crc >>> 1) ^ (crc & 1 ? 0xedb88320 : 0);
16
- return crc >>> 0;
17
- });
18
- /** Exports working files, including ignored deliverables, without following symbolic links. */
19
- export async function createWorkspaceArchive(root, options = {}) {
20
- const rootReal = await realpath(root);
21
- const excludedRoots = await Promise.all((options.excludedRoots ?? []).map(path => realpath(path).catch(() => path)));
22
- const entries = [];
23
- let bytes = 0;
24
- const walk = async (directory) => {
25
- options.signal?.throwIfAborted();
26
- const info = await lstat(directory);
27
- if (!info.isDirectory() || info.isSymbolicLink() || !inside(rootReal, await realpath(directory)))
28
- throw new Error('workspace_archive_changed');
29
- for await (const entry of await opendir(directory)) {
30
- options.signal?.throwIfAborted();
31
- if (EXCLUDED_NAMES.has(entry.name) || entry.name.startsWith('.playcraft-credential-'))
32
- continue;
33
- const target = join(directory, entry.name);
34
- const path = relative(rootReal, target).split(sep).join('/');
35
- if (isCredentialFile(path) || /(?:^|\/)\.playcraft\/(?:workspace-context(?:\.[^/]*)?|video-replication)(?:\/|$)/.test(path))
36
- continue;
37
- if (excludedRoots.some(excluded => inside(excluded, target)))
38
- continue;
39
- const info = await lstat(target);
40
- if (info.isSymbolicLink())
41
- continue;
42
- if (!inside(rootReal, await realpath(target)))
43
- throw new Error('workspace_archive_changed');
44
- if (info.isDirectory()) {
45
- await walk(target);
46
- continue;
47
- }
48
- if (!info.isFile())
49
- continue;
50
- if (Buffer.byteLength(path) > 65_535 || /[\0\\]/.test(path))
51
- throw new Error('workspace_archive_invalid_path');
52
- bytes += info.size;
53
- if (bytes > (options.maxSourceBytes ?? MAX_SOURCE_BYTES) || entries.length >= (options.maxEntries ?? MAX_ENTRIES))
54
- throw new Error('workspace_archive_too_large');
55
- entries.push({ path, target, info });
56
- }
57
- };
58
- await walk(rootReal);
59
- entries.sort((left, right) => left.path.localeCompare(right.path));
60
- return Readable.from(zipFiles(rootReal, entries, options.signal));
61
- }
62
- /** Standard ZIP (ZIP archive format, 压缩归档格式) records are streamed with bounded buffers. */
63
- async function* zipFiles(root, entries, signal) {
64
- const central = [];
65
- let offset = 0;
66
- for (const entry of entries) {
67
- signal?.throwIfAborted();
68
- if (!inside(root, await realpath(entry.target)))
69
- throw new Error('workspace_archive_changed');
70
- const handle = await open(entry.target, constants.O_RDONLY | constants.O_NOFOLLOW);
71
- try {
72
- const info = await handle.stat();
73
- if (!info.isFile() || info.dev !== entry.info.dev || info.ino !== entry.info.ino || info.size !== entry.info.size
74
- || info.mtimeMs !== entry.info.mtimeMs || info.ctimeMs !== entry.info.ctimeMs)
75
- throw new Error('workspace_archive_changed');
76
- const name = Buffer.from(entry.path);
77
- const stamp = zipTimestamp(info.mtime);
78
- const header = Buffer.alloc(30);
79
- header.writeUInt32LE(0x04034b50, 0);
80
- header.writeUInt16LE(20, 4);
81
- header.writeUInt16LE(UTF8_DESCRIPTOR_FLAGS, 6);
82
- header.writeUInt16LE(8, 8);
83
- header.writeUInt32LE(stamp, 10);
84
- header.writeUInt16LE(name.length, 26);
85
- const start = offset;
86
- yield header;
87
- yield name;
88
- offset += header.length + name.length;
89
- let crc = 0xffffffff;
90
- let size = 0;
91
- let compressedSize = 0;
92
- const checksum = new Transform({ transform(chunk, _encoding, done) {
93
- size += chunk.length;
94
- if (size > info.size) {
95
- done(new Error('workspace_archive_changed'));
96
- return;
97
- }
98
- for (const byte of chunk)
99
- crc = CRC_TABLE[(crc ^ byte) & 0xff] ^ (crc >>> 8);
100
- done(null, chunk);
101
- } });
102
- const compressed = createDeflateRaw();
103
- const completion = pipeline(handle.createReadStream({ autoClose: false }), checksum, compressed, { signal });
104
- void completion.catch(() => undefined);
105
- try {
106
- for await (const chunk of compressed) {
107
- signal?.throwIfAborted();
108
- compressedSize += chunk.length;
109
- offset += chunk.length;
110
- yield chunk;
111
- }
112
- await completion;
113
- }
114
- finally {
115
- compressed.destroy();
116
- checksum.destroy();
117
- await completion.catch(() => undefined);
118
- }
119
- if (size !== info.size)
120
- throw new Error('workspace_archive_changed');
121
- const after = await handle.stat();
122
- if (after.size !== info.size || after.mtimeMs !== info.mtimeMs || after.ctimeMs !== info.ctimeMs)
123
- throw new Error('workspace_archive_changed');
124
- crc = (crc ^ 0xffffffff) >>> 0;
125
- const descriptor = Buffer.alloc(16);
126
- descriptor.writeUInt32LE(0x08074b50, 0);
127
- descriptor.writeUInt32LE(crc, 4);
128
- descriptor.writeUInt32LE(compressedSize, 8);
129
- descriptor.writeUInt32LE(size, 12);
130
- yield descriptor;
131
- offset += descriptor.length;
132
- const record = Buffer.alloc(46);
133
- record.writeUInt32LE(0x02014b50, 0);
134
- record.writeUInt16LE(0x0314, 4);
135
- record.writeUInt16LE(20, 6);
136
- record.writeUInt16LE(UTF8_DESCRIPTOR_FLAGS, 8);
137
- record.writeUInt16LE(8, 10);
138
- record.writeUInt32LE(stamp, 12);
139
- record.writeUInt32LE(crc, 16);
140
- record.writeUInt32LE(compressedSize, 20);
141
- record.writeUInt32LE(size, 24);
142
- record.writeUInt16LE(name.length, 28);
143
- record.writeUInt32LE(((info.mode & 0xffff) << 16) >>> 0, 38);
144
- record.writeUInt32LE(start, 42);
145
- central.push(record, name);
146
- }
147
- finally {
148
- await handle.close();
149
- }
150
- }
151
- const centralStart = offset;
152
- for (const record of central) {
153
- signal?.throwIfAborted();
154
- yield record;
155
- offset += record.length;
156
- }
157
- const end = Buffer.alloc(22);
158
- end.writeUInt32LE(0x06054b50, 0);
159
- end.writeUInt16LE(entries.length, 8);
160
- end.writeUInt16LE(entries.length, 10);
161
- end.writeUInt32LE(offset - centralStart, 12);
162
- end.writeUInt32LE(centralStart, 16);
163
- yield end;
164
- }
165
- export async function serveWorkspaceArchive(root, request, response, options = {}) {
166
- const controller = new AbortController();
167
- const abort = () => controller.abort();
168
- const close = () => { if (!response.writableEnded)
169
- abort(); };
170
- request.once('aborted', abort);
171
- response.once('close', close);
172
- try {
173
- const archive = await createWorkspaceArchive(root, { ...options, signal: controller.signal });
174
- response.writeHead(200, {
175
- 'content-type': 'application/zip', 'content-disposition': 'attachment; filename="workspace.zip"',
176
- 'cache-control': 'private, no-store', 'x-content-type-options': 'nosniff',
177
- });
178
- if (request.method === 'HEAD') {
179
- archive.destroy();
180
- response.end();
181
- return;
182
- }
183
- await pipeline(archive, response, { signal: controller.signal });
184
- }
185
- catch (error) {
186
- if (response.headersSent)
187
- response.destroy(error instanceof Error ? error : undefined);
188
- else if (!controller.signal.aborted) {
189
- const reason = error instanceof Error ? error.message : 'workspace_archive_failed';
190
- response.writeHead(reason === 'workspace_archive_too_large' ? 413 : 409, { 'content-type': 'application/json', 'cache-control': 'private, no-store' });
191
- response.end(JSON.stringify({ error: reason.startsWith('workspace_archive_') ? reason : 'workspace_archive_failed' }));
192
- }
193
- }
194
- finally {
195
- request.off('aborted', abort);
196
- response.off('close', close);
197
- }
198
- }
199
- function inside(root, target) {
200
- const path = relative(root, target);
201
- return path === '' || (path !== '..' && !path.startsWith(`..${sep}`) && !path.startsWith(sep));
202
- }
203
- function zipTimestamp(date) {
204
- const year = Math.min(2107, Math.max(1980, date.getUTCFullYear()));
205
- return (((year - 1980) << 25) | ((date.getUTCMonth() + 1) << 21) | (date.getUTCDate() << 16)
206
- | (date.getUTCHours() << 11) | (date.getUTCMinutes() << 5) | (date.getUTCSeconds() >>> 1)) >>> 0;
207
- }