@playcraft/cli 0.1.50-beta → 0.1.51

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 (406) hide show
  1. package/README.md +3 -62
  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 -210
  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 -113
  50. package/dist/commands/video.js +0 -122
  51. package/dist/commands/workspace-runtime.js +0 -54
  52. package/dist/commands/workspace.js +0 -40
  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/error-diagnostics.js +0 -20
  75. package/dist/utils/tool-operation-journal.js +0 -124
  76. package/dist/utils/video-evidence-git.js +0 -81
  77. package/dist/video-replication/client.js +0 -234
  78. package/dist/video-replication/comparison-evidence.js +0 -149
  79. package/dist/video-replication/comparison-files.js +0 -57
  80. package/dist/video-replication/comparison-log.js +0 -72
  81. package/dist/video-replication/comparison-messages.js +0 -104
  82. package/dist/video-replication/comparison-output.js +0 -63
  83. package/dist/video-replication/comparison-preflight.js +0 -66
  84. package/dist/video-replication/comparison.js +0 -230
  85. package/dist/video-replication/diagnostics.js +0 -41
  86. package/dist/video-replication/evidence.js +0 -165
  87. package/dist/video-replication/media.js +0 -112
  88. package/dist/video-replication/messages.js +0 -97
  89. package/dist/workspace/messages.js +0 -67
  90. package/dist/workspace/transfer-client.js +0 -233
  91. package/dist/workspace/transfer-errors.js +0 -48
  92. package/dist/workspace-runtime/batch/content-changes.js +0 -30
  93. package/dist/workspace-runtime/batch/control.js +0 -86
  94. package/dist/workspace-runtime/batch/deliver.js +0 -173
  95. package/dist/workspace-runtime/batch/freeze.js +0 -101
  96. package/dist/workspace-runtime/batch/generate.js +0 -249
  97. package/dist/workspace-runtime/batch/git.js +0 -40
  98. package/dist/workspace-runtime/batch/occupancy.js +0 -8
  99. package/dist/workspace-runtime/batch/policy.js +0 -70
  100. package/dist/workspace-runtime/batch/prepare.js +0 -317
  101. package/dist/workspace-runtime/batch/processes.js +0 -72
  102. package/dist/workspace-runtime/batch/records.js +0 -113
  103. package/dist/workspace-runtime/batch/routes.js +0 -61
  104. package/dist/workspace-runtime/batch/source-candidate.js +0 -86
  105. package/dist/workspace-runtime/batch/source-capture.js +0 -146
  106. package/dist/workspace-runtime/batch/source-failure.js +0 -43
  107. package/dist/workspace-runtime/batch/source-publish.js +0 -130
  108. package/dist/workspace-runtime/codex/app-server.js +0 -1065
  109. package/dist/workspace-runtime/codex/compact.js +0 -46
  110. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  111. package/dist/workspace-runtime/codex/delivery-tools.js +0 -144
  112. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  113. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  114. package/dist/workspace-runtime/codex/loopback.js +0 -146
  115. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  116. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  117. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  118. package/dist/workspace-runtime/codex/permissions.js +0 -79
  119. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  120. package/dist/workspace-runtime/codex/tool-response.js +0 -10
  121. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  122. package/dist/workspace-runtime/codex/ui-tools.js +0 -203
  123. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  124. package/dist/workspace-runtime/main.js +0 -10
  125. package/dist/workspace-runtime/persistence/journal.js +0 -365
  126. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  127. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  128. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  129. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  130. package/dist/workspace-runtime/previews/diagnostics.js +0 -44
  131. package/dist/workspace-runtime/previews/output.js +0 -36
  132. package/dist/workspace-runtime/previews/publish.js +0 -283
  133. package/dist/workspace-runtime/previews/runtime-preview.js +0 -177
  134. package/dist/workspace-runtime/previews/single-file.js +0 -43
  135. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  136. package/dist/workspace-runtime/serve.js +0 -441
  137. package/dist/workspace-runtime/server/accept-operation.js +0 -61
  138. package/dist/workspace-runtime/server/asset-transfers.js +0 -63
  139. package/dist/workspace-runtime/server/auth.js +0 -21
  140. package/dist/workspace-runtime/server/connectivity.js +0 -209
  141. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  142. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  143. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  144. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  145. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  146. package/dist/workspace-runtime/server/dispatch.js +0 -1632
  147. package/dist/workspace-runtime/server/endpoints.js +0 -21
  148. package/dist/workspace-runtime/server/execution-group.js +0 -90
  149. package/dist/workspace-runtime/server/http.js +0 -1340
  150. package/dist/workspace-runtime/server/lock.js +0 -53
  151. package/dist/workspace-runtime/server/operation-record.js +0 -33
  152. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  153. package/dist/workspace-runtime/server/session-restore.js +0 -84
  154. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  155. package/dist/workspace-runtime/server/submit-operation.js +0 -41
  156. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  157. package/dist/workspace-runtime/server/types.js +0 -1
  158. package/dist/workspace-runtime/server/workspace-transfer.js +0 -168
  159. package/dist/workspace-runtime/verify-artifact.js +0 -59
  160. package/dist/workspace-runtime/workspaces/append-only-log.js +0 -62
  161. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  162. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  163. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -199
  164. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  165. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  166. package/dist/workspace-runtime/workspaces/asset-library-import.js +0 -366
  167. package/dist/workspace-runtime/workspaces/asset-transfer-dependencies.js +0 -81
  168. package/dist/workspace-runtime/workspaces/asset-transfer-publish.js +0 -434
  169. package/dist/workspace-runtime/workspaces/asset-transfer-storage.js +0 -389
  170. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -73
  171. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  172. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  173. package/dist/workspace-runtime/workspaces/binary-content.js +0 -65
  174. package/dist/workspace-runtime/workspaces/binary-write.js +0 -112
  175. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  176. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -115
  177. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  178. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  179. package/dist/workspace-runtime/workspaces/delivery-build.js +0 -331
  180. package/dist/workspace-runtime/workspaces/delivery-store.js +0 -168
  181. package/dist/workspace-runtime/workspaces/delivery.js +0 -64
  182. package/dist/workspace-runtime/workspaces/dependencies.js +0 -279
  183. package/dist/workspace-runtime/workspaces/developer-command.js +0 -98
  184. package/dist/workspace-runtime/workspaces/directories.js +0 -132
  185. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  186. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  187. package/dist/workspace-runtime/workspaces/directory-create.js +0 -57
  188. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  189. package/dist/workspace-runtime/workspaces/directory-mutations.js +0 -238
  190. package/dist/workspace-runtime/workspaces/directory-revisions.js +0 -56
  191. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  192. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  193. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  194. package/dist/workspace-runtime/workspaces/file-content.js +0 -48
  195. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  196. package/dist/workspace-runtime/workspaces/files.js +0 -150
  197. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  198. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  199. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  200. package/dist/workspace-runtime/workspaces/git.js +0 -670
  201. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  202. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -313
  203. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  204. package/dist/workspace-runtime/workspaces/operation-log.js +0 -23
  205. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  206. package/dist/workspace-runtime/workspaces/parameter-agent-inputs.js +0 -87
  207. package/dist/workspace-runtime/workspaces/parameter-agent-protocol.js +0 -29
  208. package/dist/workspace-runtime/workspaces/parameter-agent-store.js +0 -58
  209. package/dist/workspace-runtime/workspaces/parameter-agent.js +0 -282
  210. package/dist/workspace-runtime/workspaces/parameters.js +0 -295
  211. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  212. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  213. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  214. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  215. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  216. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  217. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  218. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  219. package/dist/workspace-runtime/workspaces/transfer-quota.js +0 -69
  220. package/dist/workspace-runtime/workspaces/transfer.js +0 -471
  221. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  222. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  223. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  224. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  225. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  226. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  227. package/project-template-v2/.claude/agents/artist.md +0 -82
  228. package/project-template-v2/.claude/agents/developer.md +0 -153
  229. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  230. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  231. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  232. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  233. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  234. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  235. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  236. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  237. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  238. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  239. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  240. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  241. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  242. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  243. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  244. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  245. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  246. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  247. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  248. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  249. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  250. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  251. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  252. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  253. package/project-template-v2/.claude/settings.json +0 -33
  254. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  255. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  256. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  257. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  258. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  259. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  260. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  261. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  262. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  263. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  264. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  265. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  266. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  267. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  268. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  269. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  270. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  271. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  272. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  273. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  274. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  275. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  276. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  277. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  278. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  279. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  280. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  281. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  282. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  283. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  284. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  285. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  286. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  287. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  288. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  289. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  290. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  291. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  292. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  293. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  294. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  295. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  296. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  297. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  298. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  299. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  300. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  301. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  302. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  303. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  304. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  305. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  306. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  307. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  308. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  309. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  310. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  311. package/project-template-v2/.claude/snapshot.mjs +0 -263
  312. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  313. package/project-template-v2/CLAUDE.md +0 -146
  314. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  315. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  316. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  317. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  318. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  319. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  320. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  321. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  322. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  323. package/project-template-v2/assets/models/.gitkeep +0 -0
  324. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  325. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  326. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  327. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  328. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  329. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  330. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  331. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  332. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  333. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  334. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  335. package/project-template-v2/docs/project-state.json +0 -60
  336. package/project-template-v2/docs/project-state.md +0 -72
  337. package/project-template-v2/docs/standards/README.md +0 -225
  338. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  339. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  340. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  341. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  342. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  343. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  344. package/project-template-v2/game/index.ts +0 -18
  345. package/project-template-v2/globals.d.ts +0 -51
  346. package/project-template-v2/index.css +0 -34
  347. package/project-template-v2/index.html +0 -18
  348. package/project-template-v2/main.ts +0 -9
  349. package/project-template-v2/package.json +0 -46
  350. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  351. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  352. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  353. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  354. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  355. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  356. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  357. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  358. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  359. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  360. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  361. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  362. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  363. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  364. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  365. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  366. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  367. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  368. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  369. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  370. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  371. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  372. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  373. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  374. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  375. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  376. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  377. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  378. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  379. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  380. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  381. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  382. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  383. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  384. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  385. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  386. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  387. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  388. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  389. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  390. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  391. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  392. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  393. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  394. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  395. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  396. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  397. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  398. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  399. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  400. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  401. package/project-template-v2/tsconfig.json +0 -20
  402. package/project-template-v2/vite.config.ts +0 -27
  403. package/project-templates/batch-locks/phaser.yaml +0 -922
  404. package/project-templates/batch-locks/threejs.yaml +0 -978
  405. package/project-templates/empty/AGENTS.md +0 -41
  406. package/project-templates/empty/gitignore +0 -33
@@ -1,366 +0,0 @@
1
- import { batchDirectoryHeld } from '../batch/occupancy.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 batchDirectoryHeld(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,168 +0,0 @@
1
- import { createReadStream, createWriteStream } from 'node:fs';
2
- import { mkdtemp, rm, stat } from 'node:fs/promises';
3
- import { tmpdir } from 'node:os';
4
- import { join } from 'node:path';
5
- import { Readable, Transform } from 'node:stream';
6
- import { pipeline } from 'node:stream/promises';
7
- import { applyWorkspaceTransfer, createWorkspaceTransfer, inspectWorkspaceTransfer, inspectWorkspaceTree, WorkspaceTransferError } from '../workspaces/transfer.js';
8
- import { assertTransferDiskSpace, checkWorkspaceTransferQuota, transferDiskBudget } from '../workspaces/transfer-quota.js';
9
- import { revisionScope, sessionWorkspaceRoot, workspaceContainerRoot } from '../workspaces/registry.js';
10
- import { workspaceDirectoryOccupied } from '../workspaces/directory-maintenance.js';
11
- import { publishSourceEvents } from './dispatch.js';
12
- export async function handleWorkspaceTransfer(state, request, response, url) {
13
- const workspaceId = url.searchParams.get('workspaceId') ?? undefined;
14
- const directoryName = url.searchParams.get('directoryName') ?? 'basic';
15
- const root = await sessionWorkspaceRoot(state, workspaceId, directoryName);
16
- const controller = new AbortController();
17
- const abort = () => controller.abort();
18
- const close = () => { if (!response.writableEnded)
19
- abort(); };
20
- request.once('aborted', abort);
21
- response.once('close', close);
22
- let temporary;
23
- try {
24
- const directories = directoryName === 'root'
25
- ? [...new Set(['root', 'basic', ...(state.journal.getWorkspace(workspaceId ?? '')?.directories ?? []).map(item => item.directoryName)])].sort()
26
- : [...new Set(['root', directoryName])].sort();
27
- const assertAvailable = async () => {
28
- controller.signal.throwIfAborted();
29
- if (state.journal.destroyed())
30
- throw new WorkspaceTransferError('runtime_destroyed');
31
- for (const directory of directories) {
32
- if (await workspaceDirectoryOccupied(state, workspaceId ?? 'workspace', directory))
33
- throw new WorkspaceTransferError('workspace_transfer_busy');
34
- }
35
- };
36
- const quotaRoot = await workspaceContainerRoot(state, workspaceId);
37
- if (request.method === 'GET' && url.searchParams.get('preflight') === '1') {
38
- const integer = (key) => {
39
- const value = url.searchParams.get(key) ?? '';
40
- if (!/^\d+$/.test(value) || !Number.isSafeInteger(Number(value)))
41
- throw new WorkspaceTransferError('invalid_workspace_transfer');
42
- return Number(value);
43
- };
44
- const expectedTree = url.searchParams.get('expectedTree') ?? '';
45
- if (!/^[a-f0-9]{40,64}$/.test(expectedTree))
46
- throw new WorkspaceTransferError('invalid_workspace_transfer');
47
- const incoming = { bytes: integer('contentBytes'), files: integer('fileCount') };
48
- await assertAvailable();
49
- const targetTree = url.searchParams.get('targetTree');
50
- if (targetTree !== null && !/^[a-f0-9]{40,64}$/.test(targetTree))
51
- throw new WorkspaceTransferError('invalid_workspace_transfer');
52
- const current = await inspectWorkspaceTree(root, { signal: controller.signal });
53
- if (current.tree === targetTree) {
54
- writeJson(response, 200, { protocolVersion: 2, alreadyApplied: true, tree: current.tree });
55
- return;
56
- }
57
- if (current.tree !== expectedTree)
58
- throw new WorkspaceTransferError('workspace_transfer_conflict');
59
- const quota = await checkWorkspaceTransferQuota(quotaRoot, current, incoming, state.config.workspaceStorageQuotaBytes);
60
- await assertTransferDiskSpace(tmpdir(), current.bytes * 2 + incoming.bytes * 2);
61
- writeJson(response, 200, { protocolVersion: 2, quota, contentBytes: incoming.bytes, fileCount: incoming.files });
62
- return;
63
- }
64
- if (request.method === 'GET') {
65
- const current = await inspectWorkspaceTransfer(root, { signal: controller.signal });
66
- await assertTransferDiskSpace(tmpdir(), current.bytes * 3);
67
- const snapshot = await createWorkspaceTransfer(root, { signal: controller.signal });
68
- try {
69
- controller.signal.throwIfAborted();
70
- response.writeHead(200, { 'content-type': 'application/octet-stream', 'cache-control': 'private, no-store',
71
- 'content-length': (await stat(snapshot.bundlePath)).size, 'x-content-type-options': 'nosniff',
72
- 'x-playcraft-workspace-tree': snapshot.tree, 'x-playcraft-workspace-head': snapshot.head,
73
- 'x-playcraft-workspace-content-bytes': snapshot.stats.bytes, 'x-playcraft-workspace-file-count': snapshot.stats.files });
74
- await pipeline(createReadStream(snapshot.bundlePath), response, { signal: controller.signal });
75
- }
76
- finally {
77
- await snapshot.cleanup();
78
- }
79
- return;
80
- }
81
- const expectedTree = request.headers['x-playcraft-workspace-tree'];
82
- if (typeof expectedTree !== 'string' || !/^[a-f0-9]{40,64}$/.test(expectedTree))
83
- throw new WorkspaceTransferError('invalid_workspace_transfer');
84
- const rawLength = request.headers['content-length'];
85
- const declaredLength = rawLength === undefined ? undefined : Number(rawLength);
86
- if (rawLength !== undefined && (typeof rawLength !== 'string' || !/^\d+$/.test(rawLength) || !Number.isSafeInteger(declaredLength)))
87
- throw new WorkspaceTransferError('invalid_workspace_transfer');
88
- await assertAvailable();
89
- const disk = await transferDiskBudget(tmpdir());
90
- if (declaredLength !== undefined)
91
- await assertTransferDiskSpace(tmpdir(), declaredLength);
92
- temporary = await mkdtemp(join(tmpdir(), 'playcraft-upload-'));
93
- const bundlePath = join(temporary, 'incoming.bundle');
94
- let size = 0, lastProbe = 0;
95
- const guard = new Transform({ transform(chunk, _encoding, callback) {
96
- size += chunk.length;
97
- if (size > disk.budget) {
98
- callback(new WorkspaceTransferError('workspace_transfer_disk_full', { metric: 'transferBytes', actual: size, limit: disk.budget }));
99
- return;
100
- }
101
- if (size - lastProbe < 16 * 1024 * 1024) {
102
- callback(null, chunk);
103
- return;
104
- }
105
- lastProbe = size;
106
- assertTransferDiskSpace(temporary, chunk.length).then(() => callback(null, chunk), error => callback(error));
107
- } });
108
- await pipeline(Readable.from(request.iterator({ destroyOnReturn: false })), guard, createWriteStream(bundlePath, { flags: 'wx', mode: 0o600 }), { signal: controller.signal });
109
- if (!size || (declaredLength !== undefined && size !== declaredLength))
110
- throw new WorkspaceTransferError('invalid_workspace_transfer');
111
- const lockKeys = [...new Set([...directories.map(name => `directory:${workspaceId}:${name}`),
112
- ...directories.map(name => `workspace:${revisionScope(state, workspaceId, name) ?? 'single'}`)])];
113
- const locked = async (index) => index < lockKeys.length
114
- ? state.journal.exclusive(lockKeys[index], () => locked(index + 1))
115
- : apply();
116
- const apply = async () => {
117
- await assertAvailable();
118
- const current = await inspectWorkspaceTransfer(root, { signal: controller.signal });
119
- await assertTransferDiskSpace(tmpdir(), current.bytes * 2);
120
- return applyWorkspaceTransfer(root, bundlePath, expectedTree, {
121
- signal: controller.signal,
122
- validateSnapshot: async (incoming, actualCurrent) => {
123
- await checkWorkspaceTransferQuota(quotaRoot, actualCurrent, incoming, state.config.workspaceStorageQuotaBytes);
124
- await assertTransferDiskSpace(tmpdir(), incoming.bytes);
125
- },
126
- });
127
- };
128
- const result = await locked(0);
129
- if (result.changedPaths.length > 0) {
130
- const groups = new Map([[directoryName, result.changedPaths]]);
131
- if (directoryName === 'root')
132
- for (const path of result.changedPaths) {
133
- const [directory, ...parts] = path.split('/');
134
- if (directory && directories.includes(directory) && parts.length)
135
- groups.set(directory, [...(groups.get(directory) ?? []), parts.join('/')]);
136
- }
137
- const events = [];
138
- for (const [directory, paths] of groups)
139
- events.push(await state.journal.allocateSourceEvent({
140
- runtimeId: state.config.runtimeId, generation: state.config.generation, runtimeEpoch: state.runtimeEpoch,
141
- workspaceId, type: 'files.changed', occurredAt: new Date().toISOString(), payload: { workspaceId, directoryName: directory, paths },
142
- }));
143
- await publishSourceEvents(state, events);
144
- }
145
- writeJson(response, 200, result);
146
- }
147
- catch (error) {
148
- if (response.headersSent)
149
- response.destroy(error instanceof Error ? error : undefined);
150
- else if (!controller.signal.aborted) {
151
- const code = error instanceof WorkspaceTransferError ? error.code
152
- : error.code === 'ENOSPC' ? 'workspace_transfer_disk_full' : 'workspace_transfer_failed';
153
- const status = code === 'workspace_transfer_quota_exceeded' ? 413 : code === 'workspace_transfer_disk_full' ? 507
154
- : code === 'invalid_workspace_transfer' ? 400 : code.includes('timeout') ? 504 : code === 'workspace_transfer_storage_unavailable' ? 503 : 409;
155
- writeJson(response, status, { error: code, ...(error instanceof WorkspaceTransferError && error.details ? { details: error.details } : {}) });
156
- }
157
- }
158
- finally {
159
- request.off('aborted', abort);
160
- response.off('close', close);
161
- if (temporary)
162
- await rm(temporary, { recursive: true, force: true });
163
- }
164
- }
165
- function writeJson(response, status, body) {
166
- response.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'private, no-store' });
167
- response.end(JSON.stringify(body));
168
- }
@@ -1,59 +0,0 @@
1
- import assert from 'node:assert/strict';
2
- import { randomUUID } from 'node:crypto';
3
- import { readFile, mkdtemp, rm } from 'node:fs/promises';
4
- import { createRequire } from 'node:module';
5
- import { tmpdir } from 'node:os';
6
- import { dirname, join, resolve } from 'node:path';
7
- import { fileURLToPath } from 'node:url';
8
- import { batchSourceRemoteRef, parseSandboxRuntimeConfig } from '@playcraft/common/cloud-workspace/runtime';
9
- import { createLoopbackNativeAdapter } from './codex/loopback.js';
10
- import { startWorkspaceRuntime } from './serve.js';
11
- async function dependencyVersion(name, entry) {
12
- let directory = dirname(createRequire(import.meta.url).resolve(entry));
13
- for (;;) {
14
- const metadata = await readFile(join(directory, 'package.json'), 'utf8').then(JSON.parse).catch(() => undefined);
15
- if (metadata?.name === name)
16
- return metadata.version;
17
- const parent = dirname(directory);
18
- if (parent === directory)
19
- throw new Error(`package_metadata_missing:${name}`);
20
- directory = parent;
21
- }
22
- }
23
- /** Starts only an isolated temporary runtime; never reads or changes an existing workspace. */
24
- export async function verifyRuntimeArtifact(expectedVersion) {
25
- assert.match(expectedVersion, /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/);
26
- const metadata = JSON.parse(await readFile(new URL('../../package.json', import.meta.url), 'utf8'));
27
- assert.equal(metadata.version, expectedVersion, 'command package version differs from the release target');
28
- assert.equal(await dependencyVersion('@playcraft/common', '@playcraft/common/cloud-workspace/runtime'), expectedVersion);
29
- assert.equal(await dependencyVersion('@playcraft/build', '@playcraft/build'), expectedVersion);
30
- const batchId = randomUUID();
31
- assert.equal(batchSourceRemoteRef(batchId), `refs/tags/playcraft/batch/${batchId}/source`, 'installed shared library lacks standard tag references for source snapshots');
32
- const directory = await mkdtemp(join(tmpdir(), 'playcraft-artifact-verify-'));
33
- let runtime;
34
- try {
35
- const config = parseSandboxRuntimeConfig({
36
- protocolMajor: 1, protocolMinor: 0, environment: 'artifact-verification',
37
- runtimeId: randomUUID(), userId: 'artifact-verification', generation: 1, runtimeEpoch: 0,
38
- workspaceMode: 'multi', workspaceRoot: join(directory, 'workspaces'), stateDir: join(directory, 'state'),
39
- publicBaseUrl: 'http://127.0.0.1:9', controlToken: randomUUID(), cliVersion: expectedVersion,
40
- listen: { host: '127.0.0.1', port: 0 },
41
- });
42
- runtime = await startWorkspaceRuntime(config, { nativeAdapter: createLoopbackNativeAdapter() });
43
- const response = await fetch(`${runtime.url}/runtime/identity`, {
44
- headers: { authorization: `Bearer ${config.controlToken}` }, signal: AbortSignal.timeout(10_000),
45
- });
46
- assert.equal(response.status, 200, 'built runtime identity is unavailable');
47
- const identity = await response.json();
48
- assert.equal(identity.runtimeId, config.runtimeId);
49
- assert.equal(identity.batchSourceFreezeRevision, 2, 'built runtime lacks the required batch source freeze implementation');
50
- }
51
- finally {
52
- await runtime?.close();
53
- await rm(directory, { recursive: true, force: true });
54
- }
55
- }
56
- if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
57
- await verifyRuntimeArtifact(process.argv[2] ?? '');
58
- console.log('Runtime artifact verified: batchSourceFreezeRevision=2');
59
- }
@@ -1,62 +0,0 @@
1
- import { randomUUID } from 'node:crypto';
2
- import { constants } from 'node:fs';
3
- import { mkdir, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';
4
- import { dirname } from 'node:path';
5
- /**
6
- * One append-only log file with a hard byte cap. When the cap is crossed the file is atomically
7
- * replaced with a truncation notice plus the newest bytes, so readers never see a half write.
8
- */
9
- export class AppendOnlyLog {
10
- path;
11
- maxBytes;
12
- truncatedNotice;
13
- constructor(path, maxBytes, truncatedNotice = '[playcraft] log truncated; showing the tail\n') {
14
- this.path = path;
15
- this.maxBytes = maxBytes;
16
- this.truncatedNotice = truncatedNotice;
17
- }
18
- async append(chunk) {
19
- if (!chunk)
20
- return;
21
- await mkdir(dirname(this.path), { recursive: true, mode: 0o700 });
22
- const handle = await open(this.path, constants.O_WRONLY | constants.O_CREAT | constants.O_APPEND | constants.O_NOFOLLOW, 0o600);
23
- try {
24
- await handle.write(Buffer.from(chunk));
25
- }
26
- finally {
27
- await handle.close();
28
- }
29
- const info = await stat(this.path);
30
- if (info.size <= this.maxBytes)
31
- return;
32
- const content = await readFile(this.path);
33
- const notice = Buffer.from(this.truncatedNotice);
34
- const tail = content.subarray(Math.max(0, content.length - (this.maxBytes - notice.length)));
35
- const temporary = `${this.path}.${randomUUID()}.tmp`;
36
- try {
37
- await writeFile(temporary, Buffer.concat([notice, tail]), { mode: 0o600 });
38
- await rename(temporary, this.path);
39
- }
40
- catch (error) {
41
- await rm(temporary, { force: true }).catch(() => undefined);
42
- throw error;
43
- }
44
- }
45
- async read(offset = 0) {
46
- let content;
47
- try {
48
- content = await readFile(this.path);
49
- }
50
- catch (error) {
51
- if (error.code === 'ENOENT')
52
- return { text: '', size: 0, offset: 0 };
53
- throw error;
54
- }
55
- const start = Math.min(Math.max(0, offset), content.length);
56
- return { text: content.subarray(start).toString('utf8'), size: content.length, offset: start };
57
- }
58
- async size() {
59
- const info = await stat(this.path).catch(() => undefined);
60
- return info?.isFile() ? info.size : 0;
61
- }
62
- }