@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,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
- }