@playcraft/cli 0.1.53-beta → 0.1.54

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