@playcraft/cli 0.1.33 → 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 (346) 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 +5 -14
  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 -1174
  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 -658
  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/skill-artifact-loader.js +0 -91
  159. package/dist/workspace-runtime/workspaces/skills.js +0 -189
  160. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  161. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -72
  162. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  163. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  164. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  165. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  166. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  167. package/project-template-v2/.claude/agents/artist.md +0 -82
  168. package/project-template-v2/.claude/agents/developer.md +0 -153
  169. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  170. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  171. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  172. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  173. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  174. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  175. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  176. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  177. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  178. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  179. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  180. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  181. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  182. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  183. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  184. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  185. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  186. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  187. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  188. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  189. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  190. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  191. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  192. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  193. package/project-template-v2/.claude/settings.json +0 -33
  194. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  195. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  196. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  197. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  198. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  199. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  200. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  201. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  202. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  203. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  204. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  205. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  206. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  207. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  208. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  209. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  210. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  211. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  212. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  213. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  214. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  215. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  216. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  217. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  218. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  219. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  220. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  221. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  222. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  223. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  224. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  225. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  226. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  227. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  228. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  229. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  230. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  231. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  232. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  233. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  234. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  235. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  236. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  237. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  238. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  239. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  240. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  241. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  242. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  243. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  244. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  245. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  246. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  247. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  248. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  249. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  250. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  251. package/project-template-v2/.claude/snapshot.mjs +0 -263
  252. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  253. package/project-template-v2/CLAUDE.md +0 -146
  254. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  255. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  256. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  257. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  258. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  259. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  260. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  261. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  262. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  263. package/project-template-v2/assets/models/.gitkeep +0 -0
  264. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  265. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  266. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  267. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  268. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  269. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  270. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  271. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  272. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  273. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  274. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  275. package/project-template-v2/docs/project-state.json +0 -60
  276. package/project-template-v2/docs/project-state.md +0 -72
  277. package/project-template-v2/docs/standards/README.md +0 -225
  278. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  279. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  280. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  281. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  282. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  283. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  284. package/project-template-v2/game/index.ts +0 -18
  285. package/project-template-v2/globals.d.ts +0 -51
  286. package/project-template-v2/index.css +0 -34
  287. package/project-template-v2/index.html +0 -18
  288. package/project-template-v2/main.ts +0 -9
  289. package/project-template-v2/package.json +0 -46
  290. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  291. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  292. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  293. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  294. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  295. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  296. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  297. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  298. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  299. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  300. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  301. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  302. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  303. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  304. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  305. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  306. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  307. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  308. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  309. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  310. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  311. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  312. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  313. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  314. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  315. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  316. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  317. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  318. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  319. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  320. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  321. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  322. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  323. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  324. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  325. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  326. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  327. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  328. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  329. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  330. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  331. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  332. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  333. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  334. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  335. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  336. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  337. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  338. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  339. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  340. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  341. package/project-template-v2/tsconfig.json +0 -20
  342. package/project-template-v2/vite.config.ts +0 -27
  343. package/project-templates/batch-locks/phaser.yaml +0 -922
  344. package/project-templates/batch-locks/threejs.yaml +0 -978
  345. package/project-templates/empty/AGENTS.md +0 -39
  346. 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
- }