@playcraft/cli 0.1.34 → 0.1.35-prod

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