@playcraft/cli 0.1.34 → 0.1.36-beta1

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 +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 -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,205 +0,0 @@
1
- import { execFile } from 'node:child_process';
2
- import { createHash } from 'node:crypto';
3
- import { lstat, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises';
4
- import { dirname, join } from 'node:path';
5
- import { promisify } from 'node:util';
6
- import { batchBaselineSnapshotSchema } from '@playcraft/common/cloud-workspace/runtime';
7
- import { checkoutBatchCommit, freezeBatchCommit } from '../workspaces/batch-commit.js';
8
- import { grantWorkspaceTraversal, openDirectoryToDevelopment } from '../workspaces/directory-access.js';
9
- import { registerWorkspaceDirectory } from '../workspaces/directories.js';
10
- import { workspaceContainerRoot, workspaceRoot, workspaceSessions } from '../workspaces/registry.js';
11
- import { excludeFromGit, settleDependencyInstalls } from '../workspaces/dependencies.js';
12
- import { resolveProductionDependencies, verifyProductionDependencyLocks } from './dependencies.js';
13
- import { productionLocalCommitCommand } from './save-command.js';
14
- import { productionOutputStore, verifyProductionLease } from './storage.js';
15
- import { runProductionCommand } from './processes.js';
16
- import { runProductionNative } from './native.js';
17
- import { classifyPreviewOutput, findExternalLocalReferences } from '../previews/single-file.js';
18
- import { copyProductionSource } from './source-copy.js';
19
- import { workspaceDirectoryOccupied } from '../workspaces/directory-maintenance.js';
20
- import { ensureWorkspaceSkills } from '../workspaces/skills.js';
21
- const execute = promisify(execFile);
22
- const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
23
- const hash = (body) => createHash('sha256').update(body).digest('hex');
24
- const record = (value) => value && typeof value === 'object' ? value : {};
25
- export async function executeProductionStage(state, input, processRecord, track) {
26
- await verifyProductionLease(input);
27
- const store = productionOutputStore(input);
28
- const stage = input.stage;
29
- const workspaceId = input.task.workspaceId;
30
- const resultId = String(input.payload.resultVersionId ?? input.task.payload.resultVersionId ?? input.task.attemptId);
31
- const sourceDirectoryName = String(input.payload.sourceDirectoryName ?? input.task.payload.sourceDirectoryName ?? 'basic');
32
- if (input.task.payload.sourceDirectoryName !== undefined && input.payload.sourceDirectoryName !== undefined
33
- && input.task.payload.sourceDirectoryName !== input.payload.sourceDirectoryName)
34
- throw new Error('production_source_directory_mismatch');
35
- const previous = (name) => input.stages?.find(value => value.stage === name && value.status === 'completed')?.result;
36
- const run = async (cwd, command, env, trusted = false) => {
37
- const outcome = await runProductionCommand(state, { processId: `production-${input.task.attemptId}-${stage}`, cwd, command, env, trusted,
38
- timeoutMs: 10 * 60_000, record: processRecord });
39
- if (!outcome.stopped || outcome.code === undefined)
40
- throw new Error('production_process_unknown');
41
- if (outcome.code !== 0)
42
- throw new Error(`production_${stage}_failed`);
43
- return outcome.output;
44
- };
45
- const git = async (root, ...args) => (await execute('git', ['-c', 'core.hooksPath=/dev/null', '-c', 'core.fsmonitor=false', '-C', root, ...args], {
46
- timeout: 20_000, maxBuffer: 1024 * 1024, env: { PATH: process.env.PATH, HOME: state.config.stateDir, GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1' },
47
- })).stdout.trim();
48
- if (stage === 'capture-source') {
49
- if (input.directoryName === 'basic' || input.directoryName === sourceDirectoryName)
50
- throw new Error('production_source_directory_mismatch');
51
- const authority = record(input.payload.workspace);
52
- if (authority.directoryName !== input.directoryName || authority.workspaceId !== workspaceId
53
- || typeof authority.remixId !== 'string' || typeof authority.branchName !== 'string' || typeof authority.repositoryUrl !== 'string')
54
- throw new Error('production_source_directory_mismatch');
55
- const { remixId, branchName, repositoryUrl } = authority;
56
- await settleDependencyInstalls(state);
57
- return state.journal.exclusive(`directory:${workspaceId}:${sourceDirectoryName}`, async () => {
58
- if (await workspaceDirectoryOccupied(state, workspaceId, sourceDirectoryName)
59
- || workspaceSessions(state, workspaceId, sourceDirectoryName).some(session => session.turnBlock === 'uncertain' || ['starting', 'running', 'waiting_for_user'].includes(session.turnStatus ?? '')))
60
- throw new Error('production_source_busy');
61
- const source = await workspaceRoot(state, workspaceId, sourceDirectoryName);
62
- const container = await workspaceContainerRoot(state, workspaceId);
63
- const destination = join(container, input.directoryName);
64
- const developmentGroup = (await lstat(state.config.workspaceRoot)).gid;
65
- const snapshot = await copyProductionSource({ source, destination, branchName, repositoryUrl });
66
- await ensureWorkspaceSkills(destination, join(state.config.stateDir, 'skill-artifacts'));
67
- await openDirectoryToDevelopment(destination, developmentGroup);
68
- await grantWorkspaceTraversal(container, developmentGroup);
69
- await state.journal.exclusive(`workspace:${workspaceId}`, async () => {
70
- const binding = state.journal.getWorkspace(workspaceId);
71
- await state.journal.putWorkspace({ ...binding, directories: [...(binding.directories ?? []).filter(value => value.directoryName !== input.directoryName),
72
- { workspaceId, directoryName: input.directoryName, remixId, branchName, sourceCommit: snapshot.commitHash, status: 'ready' }] });
73
- });
74
- return { sourceSnapshot: snapshot, commitHash: snapshot.commitHash };
75
- });
76
- }
77
- if (stage === 'prepare' && input.directoryName !== 'basic' && (input.payload.baseline ?? input.task.payload.baseline)) {
78
- const baseline = record(input.payload.baseline ?? input.task.payload.baseline);
79
- const authority = record(input.payload.workspace);
80
- const sourceCommit = baseline.commitHash;
81
- if (typeof sourceCommit !== 'string')
82
- throw new Error('production_approved_commit_required');
83
- const directory = { workspaceId, directoryName: input.directoryName,
84
- remixId: String(authority.remixId), branchName: String(authority.branchName), sourceCommit };
85
- await registerWorkspaceDirectory(state, directory, state.acceptedLeaseFence, sourceDirectoryName);
86
- }
87
- const root = await workspaceRoot(state, workspaceId, input.directoryName);
88
- if (stage === 'prepare') {
89
- await settleDependencyInstalls(state);
90
- if (!(await lstat(join(root, 'package.json')).catch(() => undefined)))
91
- return { prepared: true, directoryName: input.directoryName, emptySource: true };
92
- const policy = await resolveProductionDependencies(root).catch(error => {
93
- if (!(input.payload.baseline ?? input.task.payload.baseline) && error instanceof Error
94
- && error.message === 'production_dependency_lock_required')
95
- return undefined;
96
- throw error;
97
- });
98
- if (!policy)
99
- return { prepared: true, directoryName: input.directoryName, dependencyRepairRequired: true };
100
- await run(root, process.env.PLAYCRAFT_PRODUCTION_INSTALL_COMMAND ?? 'pnpm install --frozen-lockfile --store-dir /var/cache/playcraft/pnpm-store --ignore-scripts');
101
- await verifyProductionDependencyLocks(root, policy);
102
- return { prepared: true, directoryName: input.directoryName };
103
- }
104
- if (stage === 'generate') {
105
- await runProductionNative(state, input, root, processRecord, track);
106
- await resolveProductionDependencies(root);
107
- return { generated: true };
108
- }
109
- if (stage === 'save') {
110
- const binding = state.journal.getWorkspace(workspaceId);
111
- const branch = input.directoryName === 'basic' ? binding.branchName : binding.directories?.find(value => value.directoryName === input.directoryName)?.branchName;
112
- if ((input.git && input.git.branchName !== branch) || await git(root, 'symbolic-ref', '--short', 'HEAD') !== branch)
113
- throw new Error('production_git_binding_mismatch');
114
- await run(root, 'chmod -R u+rwX,g+rwX .').catch(() => undefined);
115
- await excludeFromGit(root);
116
- await excludeFromGit(root, '/.env*');
117
- await excludeFromGit(root, '/.playcraft-temp/');
118
- await excludeFromGit(root, '/.playcraft-preview-out/');
119
- await git(root, 'config', 'user.name', 'PlayCraft');
120
- await git(root, 'config', 'user.email', 'playcraft@localhost');
121
- const env = { GIT_TERMINAL_PROMPT: '0', GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1' };
122
- await run(root, productionLocalCommitCommand(), env, true);
123
- const commitHash = await git(root, 'rev-parse', 'HEAD');
124
- const snapshot = await freezeBatchCommit({ source: { workspaceId, root }, commitHash, snapshotId: `${input.task.attemptId}-save` });
125
- return { snapshot, saved: { attemptId: input.task.attemptId, resultVersionId: resultId, workspaceId, sourceDigest: snapshot.checksum, commitHash, pushedCommitHash: commitHash } };
126
- }
127
- if (stage === 'freeze') {
128
- const saved = record(previous('save')?.saved);
129
- if (typeof saved.commitHash !== 'string')
130
- throw new Error('production_saved_commit_required');
131
- const snapshot = await freezeBatchCommit({ source: { workspaceId, root }, commitHash: saved.commitHash, snapshotId: `${input.task.attemptId}-freeze` });
132
- const baseline = batchBaselineSnapshotSchema.parse({ batchId: input.task.batchId, projectId: String(input.payload.projectId ?? input.task.payload.projectId),
133
- snapshotId: snapshot.snapshotId, sourceWorkspaceId: snapshot.sourceWorkspaceId, commitHash: snapshot.commitHash, checksum: snapshot.checksum,
134
- sourceVersion: snapshot.sourceVersion, engine: String(input.payload.engine ?? input.task.payload.engine), skillLockDigest: snapshot.skillLockDigest, frozenAt: snapshot.frozenAt });
135
- return { snapshot, baseline };
136
- }
137
- if (stage === 'build') {
138
- const saved = record(input.payload.saved ?? previous('save')?.saved);
139
- const snapshot = (previous('freeze')?.snapshot ?? previous('save')?.snapshot);
140
- if (!snapshot || snapshot.commitHash !== saved.commitHash || snapshot.checksum !== saved.sourceDigest)
141
- throw new Error('production_saved_snapshot_mismatch');
142
- const destination = join(root, '.playcraft-temp', `production-${input.task.attemptId}`);
143
- const removeDestination = async () => {
144
- try {
145
- await rm(destination, { recursive: true, force: true });
146
- }
147
- catch {
148
- await run(destination, 'chmod -R u+rwX,g+rwX .').catch(() => undefined);
149
- await rm(destination, { recursive: true, force: true });
150
- }
151
- };
152
- await excludeFromGit(root, '/.playcraft-temp/');
153
- await removeDestination();
154
- try {
155
- await checkoutBatchCommit({ source: { workspaceId, root }, frozen: snapshot, destination });
156
- await openDirectoryToDevelopment(destination, (await lstat(state.config.workspaceRoot)).gid);
157
- const policy = await resolveProductionDependencies(destination);
158
- await run(destination, process.env.PLAYCRAFT_PRODUCTION_INSTALL_COMMAND ?? 'pnpm install --frozen-lockfile --store-dir /var/cache/playcraft/pnpm-store --ignore-scripts');
159
- await verifyProductionDependencyLocks(destination, policy);
160
- const output = join(destination, '.production-html');
161
- const command = process.env.PLAYCRAFT_PRODUCTION_BUILD_COMMAND ?? 'playcraft build --mode full --platform playcraft --format html';
162
- await run(destination, `${command} --output ${quote(output)} .`);
163
- await verifyProductionDependencyLocks(destination, policy);
164
- const entries = await readdir(output, { withFileTypes: true });
165
- const single = classifyPreviewOutput(entries.map(entry => ({ name: entry.name, kind: entry.isFile() ? 'file' : entry.isDirectory() ? 'dir' : 'symlink' })));
166
- if (!single.ok)
167
- throw new Error('production_preview_not_single_file');
168
- const path = join(output, single.entry);
169
- if (!(await lstat(path)).isFile())
170
- throw new Error('production_preview_invalid');
171
- const body = await readFile(path);
172
- if (findExternalLocalReferences(body.toString()).length)
173
- throw new Error('production_preview_external_reference');
174
- const outputDigest = hash(body), outputKey = `workspaces/${workspaceId}/production/${input.task.attemptId}/${outputDigest}.html`;
175
- await store.put(outputKey, body);
176
- return { outputKey, outputDigest, build: { attemptId: input.task.attemptId, resultVersionId: resultId, workspaceId,
177
- sourceDigest: snapshot.checksum, commitHash: snapshot.commitHash, buildId: `${input.task.attemptId}-build`, succeeded: true } };
178
- }
179
- finally {
180
- await removeDestination();
181
- }
182
- }
183
- if (stage === 'preview') {
184
- const built = previous('build');
185
- if (typeof built?.outputKey !== 'string' || typeof built.outputDigest !== 'string')
186
- throw new Error('production_build_required');
187
- const body = await store.get(built.outputKey);
188
- if (hash(body) !== built.outputDigest)
189
- throw new Error('production_preview_digest_mismatch');
190
- const previewPath = join(root, '.playcraft-temp', `${input.task.attemptId}.html`);
191
- await mkdir(dirname(previewPath), { recursive: true });
192
- await writeFile(previewPath, body);
193
- try {
194
- const browser = process.env.PLAYCRAFT_PRODUCTION_PREVIEW_COMMAND ?? 'chromium --headless --no-sandbox --disable-gpu --virtual-time-budget=1000 --dump-dom';
195
- const opened = await run(root, `${browser} ${quote(`file://${previewPath}`)}`);
196
- if (!/<\/?html[\s>]/i.test(opened))
197
- throw new Error('production_preview_not_opened');
198
- return { opened: true, outputDigest: built.outputDigest };
199
- }
200
- finally {
201
- await rm(previewPath, { force: true });
202
- }
203
- }
204
- throw new Error('invalid_production_stage');
205
- }
@@ -1,60 +0,0 @@
1
- const taskUrl = (input) => `${input.callbackUrl.replace(/\/+$/, '')}/internal/cloud-production/tasks/${input.task.taskId}`;
2
- /** Build output travels through the Runtime that leased the task; engineering files travel through Git. */
3
- export function productionOutputStore(input) {
4
- const object = (key) => `${taskUrl(input)}/objects/${encodeURIComponent(key)}`;
5
- const headers = { authorization: `Bearer ${input.runnerToken}`, 'x-playcraft-object-client': 'cli' };
6
- return {
7
- async get(key) {
8
- const response = await fetch(object(key), { headers, redirect: 'error', signal: AbortSignal.timeout(60_000) });
9
- if (response.status === 404)
10
- throw new Error('object_missing');
11
- if (!response.ok)
12
- throw new Error('object_get_failed');
13
- return Buffer.from(await response.arrayBuffer());
14
- },
15
- async put(key, body) {
16
- const response = await fetch(object(key), { method: 'PUT', body: new Uint8Array(body), redirect: 'error', signal: AbortSignal.timeout(60_000),
17
- headers: { ...headers, 'content-type': 'application/octet-stream' } });
18
- if (!response.ok)
19
- throw new Error(response.status === 409 ? 'object_conflict' : 'object_put_failed');
20
- },
21
- };
22
- }
23
- export async function verifyProductionLease(input) {
24
- let status;
25
- let reason;
26
- try {
27
- const response = await fetch(`${taskUrl(input)}/runner`, {
28
- headers: { authorization: `Bearer ${input.runnerToken}` }, redirect: 'error', signal: AbortSignal.timeout(10_000),
29
- });
30
- status = response.status;
31
- if (!response.ok) {
32
- const value = await response.json().catch(() => undefined);
33
- const body = value && typeof value === 'object' && !Array.isArray(value) ? value : {};
34
- reason = [body.reason, body.code, body.message, body.error]
35
- .find((value) => typeof value === 'string' && /^[a-z0-9_]{1,128}$/.test(value)
36
- && !value.includes(input.runnerToken));
37
- throw new Error('production_lease_unavailable');
38
- }
39
- reason = 'production_lease_invalid_response';
40
- const { task } = await response.json();
41
- if (!task || task.taskId !== input.task.taskId || task.attemptId !== input.task.attemptId || task.leaseOwner !== input.lease.owner || task.leaseFence !== input.lease.fence || task.status !== 'running' || task.cancelRequested) {
42
- reason = 'production_lease_mismatch';
43
- throw new Error('production_lease_unavailable');
44
- }
45
- }
46
- catch (error) {
47
- const cause = error instanceof Error ? error.cause : undefined;
48
- const causeCode = cause && typeof cause === 'object' && 'code' in cause && typeof cause.code === 'string'
49
- && /^[A-Za-z0-9_]{1,64}$/.test(cause.code) ? cause.code : undefined;
50
- // Callback diagnostics retain machine codes only; responses and credentials stay private.
51
- try {
52
- console.error(JSON.stringify({ event: 'production.lease_verification_failed', taskId: input.task.taskId,
53
- attemptId: input.task.attemptId, workspaceId: input.task.workspaceId, directoryName: input.directoryName,
54
- stage: input.stage, leaseFence: input.lease.fence, status, reason,
55
- errorType: error instanceof Error && /^[A-Za-z0-9_]{1,64}$/.test(error.name) ? error.name : 'UnknownError', causeCode }));
56
- }
57
- catch { /* Diagnostics must preserve the original failure. */ }
58
- throw error;
59
- }
60
- }
@@ -1,207 +0,0 @@
1
- import { closeCliCredentials } from './workspaces/cli-credentials.js';
2
- import { randomUUID } from 'node:crypto';
3
- import { mkdir } from 'node:fs/promises';
4
- import { createServer } from 'node:http';
5
- import { INCOMPATIBLE_EXIT_CODE, negotiateProtocol, } from '@playcraft/common/cloud-workspace/runtime';
6
- import { RuntimeJournal } from './persistence/journal.js';
7
- import { createCodexAppServerAdapter } from './codex/app-server.js';
8
- import { createLoopbackNativeAdapter } from './codex/loopback.js';
9
- import { attachNativeCollector } from './server/dispatch.js';
10
- import { handleRuntimeRequest } from './server/http.js';
11
- import { desktopHost, disposeDesktopHost } from './server/desktop-host.js';
12
- import { disposeTerminalHost, terminalHost } from './server/terminal-host.js';
13
- import { handleExecutionGroupCrash } from './server/execution-group.js';
14
- import { RuntimeProcessLock } from './server/lock.js';
15
- import { probeGitBinary } from './workspaces/git.js';
16
- import { WorkspaceGitCredentialBroker } from './workspaces/git-credential-broker.js';
17
- import { WorkspaceModelBroker } from './codex/model-broker.js';
18
- import { recoverInterruptedPreviews } from './previews/publish.js';
19
- import { recoverInterruptedInstalls } from './workspaces/dependencies.js';
20
- import { loadWorkspaceSkillArtifact } from './workspaces/skill-artifact-loader.js';
21
- import { workspaceContextFromRoot } from './workspaces/registry.js';
22
- import { observeWorkspaceArtifacts } from './workspaces/artifact-events.js';
23
- import { loadWorkspaceMcpConfig } from './codex/mcp-config.js';
24
- export async function startWorkspaceRuntime(config, options = {}) {
25
- process.env.PLAYCRAFT_SKIP_UPDATE_CHECK = '1';
26
- const negotiated = negotiateProtocol(config);
27
- if (!negotiated.ok) {
28
- const error = Object.assign(new Error('protocol_incompatible'), {
29
- code: 'protocol_incompatible',
30
- exitCode: INCOMPATIBLE_EXIT_CODE,
31
- });
32
- throw error;
33
- }
34
- const lock = new RuntimeProcessLock(config.stateDir);
35
- lock.acquire();
36
- let journal;
37
- let gitCredentials;
38
- try {
39
- journal = new RuntimeJournal(config.stateDir);
40
- await journal.load();
41
- const previousEpoch = journal.storedRuntimeEpoch();
42
- const previousGroup = journal.executionGroup();
43
- const previousIdentityMatches = journal.epochsSnapshot().some((epoch) => epoch.runtime_id === config.runtimeId && epoch.generation === config.generation && epoch.runtime_epoch === previousEpoch);
44
- await recoverInterruptedInstalls(journal);
45
- await recoverInterruptedPreviews(journal);
46
- await mkdir(config.workspaceRoot, { recursive: true, mode: 0o700 });
47
- const state = {
48
- config: { ...config, protocolMinor: negotiated.protocolMinor },
49
- configPath: options.configPath,
50
- journal,
51
- acceptedLeaseFence: journal.acceptedLeaseFence(),
52
- gitAvailable: await probeGitBinary(),
53
- native: options.nativeAdapter,
54
- runtimeEpoch: Math.max(config.runtimeEpoch, journal.storedRuntimeEpoch() ?? 0),
55
- executionQueue: Promise.resolve(),
56
- instanceToken: randomUUID(),
57
- };
58
- const native = state.native ??= defaultNativeAdapter(state);
59
- await journal.bindRuntime({
60
- runtimeId: config.runtimeId,
61
- generation: config.generation,
62
- runtimeEpoch: state.runtimeEpoch,
63
- });
64
- if (config.workspaceMode === 'multi') {
65
- gitCredentials = state.gitCredentials = new WorkspaceGitCredentialBroker(state);
66
- await gitCredentials.start();
67
- }
68
- const stopArtifactObserver = observeWorkspaceArtifacts(state);
69
- attachNativeCollector(state);
70
- native?.onUnexpectedExit?.((event) => {
71
- void handleExecutionGroupCrash(state, event.pid);
72
- });
73
- try {
74
- await native?.start?.();
75
- const group = native?.executionProcess?.();
76
- if (group) {
77
- let previousStopped = false;
78
- if (previousGroup.pid && previousGroup.pid !== group.pid) {
79
- try {
80
- process.kill(previousGroup.pid, 0);
81
- }
82
- catch (error) {
83
- previousStopped = error.code === 'ESRCH';
84
- }
85
- }
86
- // The supervisor advances the trusted config epoch only after stopping the old
87
- // native group. Reconfirm its recorded PID before publishing that replacement.
88
- if (previousIdentityMatches && previousEpoch !== undefined && config.runtimeEpoch > previousEpoch && previousStopped) {
89
- await journal.writeExecutionEpoch({
90
- runtimeEpoch: state.runtimeEpoch, ...group, previousPid: previousGroup.pid, stopConfirmed: true,
91
- });
92
- await journal.replaceSessions(journal.listSessions().map((session) => ({ ...session, recoverability: 'history_only' })));
93
- }
94
- else {
95
- await journal.noteExecutionGroup(group);
96
- }
97
- }
98
- }
99
- catch (error) {
100
- const code = error instanceof Error ? error.message : '';
101
- state.nativeError = code === 'codex_model_catalog_unavailable' ? code : 'codex_start_failed';
102
- console.error(`[workspace-runtime] ${state.nativeError}`);
103
- }
104
- const server = createServer((request, response) => {
105
- void handleRuntimeRequest(state, request, response);
106
- });
107
- server.on('upgrade', (request, socket, head) => {
108
- const pathname = new URL(request.url ?? '/', 'http://127.0.0.1').pathname;
109
- if (/^\/runtime\/terminals\/[^/]+\/connect$/.test(pathname)) {
110
- void terminalHost(state).handleUpgrade(request, socket, head);
111
- return;
112
- }
113
- if (pathname === '/runtime/desktop/connect') {
114
- desktopHost(state).handleUpgrade(request, socket, head);
115
- return;
116
- }
117
- socket.destroy();
118
- });
119
- const port = await listenOn(server, config.listen.host, config.listen.port);
120
- return {
121
- config: state.config,
122
- state,
123
- url: `http://${formatHost(config.listen.host)}:${port}`,
124
- async close() {
125
- const serverClosed = closeServer(server);
126
- await closeCliCredentials(state);
127
- await gitCredentials?.close();
128
- try {
129
- await disposeDesktopHost(state);
130
- }
131
- finally {
132
- disposeTerminalHost(state);
133
- try {
134
- await native?.close?.();
135
- }
136
- catch {
137
- /* adapter shutdown is best-effort */
138
- }
139
- await serverClosed;
140
- await stopArtifactObserver();
141
- await journal?.close();
142
- lock.release();
143
- }
144
- },
145
- };
146
- }
147
- catch (error) {
148
- await gitCredentials?.close().catch(() => undefined);
149
- await journal?.close().catch(() => undefined);
150
- lock.release();
151
- throw error;
152
- }
153
- }
154
- function listenOn(server, host, port) {
155
- return new Promise((resolve, reject) => {
156
- const onError = (error) => reject(error);
157
- server.once('error', onError);
158
- server.listen(port, host, () => {
159
- server.removeListener('error', onError);
160
- const address = server.address();
161
- if (!address || typeof address === 'string') {
162
- reject(new Error('listen_failed'));
163
- return;
164
- }
165
- resolve(address.port);
166
- });
167
- });
168
- }
169
- function closeServer(server) {
170
- return new Promise((resolve, reject) => {
171
- server.close((error) => {
172
- if (error)
173
- reject(error);
174
- else
175
- resolve();
176
- });
177
- });
178
- }
179
- function formatHost(host) {
180
- return host.includes(':') ? `[${host}]` : host;
181
- }
182
- function defaultNativeAdapter(state) {
183
- const config = state.config;
184
- if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'loopback')
185
- return createLoopbackNativeAdapter();
186
- const hasLauncher = Boolean(process.env.PLAYCRAFT_LAUNCHER_SOCKET);
187
- const multi = config.workspaceMode === 'multi';
188
- if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'codex' && !multi && !hasLauncher) {
189
- throw new Error('codex_requires_managed_launcher');
190
- }
191
- if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'codex' || (multi && hasLauncher)) {
192
- return createCodexAppServerAdapter({
193
- config,
194
- ...(multi ? { modelBroker: new WorkspaceModelBroker(state) } : {}),
195
- ...(multi ? { loadMcpConfig: async (cwd) => {
196
- const { workspaceId } = await workspaceContextFromRoot(state, cwd);
197
- return loadWorkspaceMcpConfig(state, workspaceId);
198
- } } : {}),
199
- loadSkillArtifact: async (cwd, entry) => {
200
- const { workspaceId, directoryName } = await workspaceContextFromRoot(state, cwd);
201
- return loadWorkspaceSkillArtifact(state, workspaceId, entry, directoryName === 'root' ? 'basic' : directoryName);
202
- },
203
- onSkillProcessRestart: process => state.journal.noteExecutionGroup(process),
204
- });
205
- }
206
- return undefined;
207
- }
@@ -1,21 +0,0 @@
1
- import { timingSafeEqual } from 'node:crypto';
2
- export function extractControlToken(headers) {
3
- const authorization = headerValue(headers.authorization);
4
- if (authorization?.startsWith('Bearer ')) {
5
- return authorization.slice('Bearer '.length).trim() || null;
6
- }
7
- const dedicated = headerValue(headers['x-playcraft-control-token']);
8
- return dedicated?.trim() || null;
9
- }
10
- export function controlTokenMatches(expected, actual) {
11
- if (!actual)
12
- return false;
13
- const left = Buffer.from(expected);
14
- const right = Buffer.from(actual);
15
- if (left.length !== right.length)
16
- return false;
17
- return timingSafeEqual(left, right);
18
- }
19
- function headerValue(value) {
20
- return Array.isArray(value) ? value[0] : value;
21
- }