@playcraft/cli 0.1.50-beta → 0.1.52

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 (406) hide show
  1. package/README.md +3 -62
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build-all.js +19 -5
  5. package/dist/commands/build.js +28 -15
  6. package/dist/commands/create.js +33 -26
  7. package/dist/commands/image.js +6 -2
  8. package/dist/commands/login.js +42 -84
  9. package/dist/commands/skills.js +0 -4
  10. package/dist/commands/tools-3d.js +0 -11
  11. package/dist/commands/tools-generation.js +137 -69
  12. package/dist/commands/tools-image-context.js +29 -0
  13. package/dist/commands/tools-utils.js +12 -0
  14. package/dist/commands/tools.js +2 -2
  15. package/dist/config.js +4 -59
  16. package/dist/index.js +3 -40
  17. package/dist/remix/clone.js +0 -2
  18. package/dist/remix/init-template.js +0 -2
  19. package/dist/remix/pull.js +0 -2
  20. package/dist/remix/push.js +1 -21
  21. package/dist/utils/agent-api-client.js +30 -210
  22. package/dist/utils/image-asset-context.js +228 -0
  23. package/dist/utils/playcraft-http-client.js +4 -6
  24. package/package.json +5 -15
  25. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  26. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  29. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  30. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  31. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  35. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  36. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  37. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  41. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  42. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  43. package/SKILLS_REGISTRY.md +0 -149
  44. package/dist/auth/account-activation.js +0 -157
  45. package/dist/auth/messages.js +0 -30
  46. package/dist/commands/build-temp.js +0 -26
  47. package/dist/commands/platform-skills.generated.js +0 -19
  48. package/dist/commands/playable.js +0 -53
  49. package/dist/commands/tools-batch.js +0 -113
  50. package/dist/commands/video.js +0 -122
  51. package/dist/commands/workspace-runtime.js +0 -54
  52. package/dist/commands/workspace.js +0 -40
  53. package/dist/project-skills/builtin-import.js +0 -225
  54. package/dist/project-skills/commands.js +0 -77
  55. package/dist/project-skills/lifecycle.js +0 -28
  56. package/dist/project-skills/local-run.js +0 -112
  57. package/dist/project-skills/local-store.js +0 -221
  58. package/dist/project-skills/messages.js +0 -80
  59. package/dist/project-skills/reconcile.js +0 -62
  60. package/dist/project-skills/remote-cache.js +0 -51
  61. package/dist/project-skills/validation.js +0 -19
  62. package/dist/recording/messages.js +0 -40
  63. package/dist/recording/project-digest.js +0 -85
  64. package/dist/recording/recorder.js +0 -293
  65. package/dist/recording/scenario.js +0 -50
  66. package/dist/skill-registry/client.js +0 -345
  67. package/dist/skill-registry/commands.js +0 -180
  68. package/dist/skill-registry/evaluation-client.js +0 -156
  69. package/dist/skill-registry/evaluation-commands.js +0 -174
  70. package/dist/skill-registry/messages.js +0 -177
  71. package/dist/skill-registry/package.js +0 -275
  72. package/dist/skill-registry/platform-package.js +0 -100
  73. package/dist/utils/environment-endpoints.js +0 -17
  74. package/dist/utils/error-diagnostics.js +0 -20
  75. package/dist/utils/tool-operation-journal.js +0 -124
  76. package/dist/utils/video-evidence-git.js +0 -81
  77. package/dist/video-replication/client.js +0 -234
  78. package/dist/video-replication/comparison-evidence.js +0 -149
  79. package/dist/video-replication/comparison-files.js +0 -57
  80. package/dist/video-replication/comparison-log.js +0 -72
  81. package/dist/video-replication/comparison-messages.js +0 -104
  82. package/dist/video-replication/comparison-output.js +0 -63
  83. package/dist/video-replication/comparison-preflight.js +0 -66
  84. package/dist/video-replication/comparison.js +0 -230
  85. package/dist/video-replication/diagnostics.js +0 -41
  86. package/dist/video-replication/evidence.js +0 -165
  87. package/dist/video-replication/media.js +0 -112
  88. package/dist/video-replication/messages.js +0 -97
  89. package/dist/workspace/messages.js +0 -67
  90. package/dist/workspace/transfer-client.js +0 -233
  91. package/dist/workspace/transfer-errors.js +0 -48
  92. package/dist/workspace-runtime/batch/content-changes.js +0 -30
  93. package/dist/workspace-runtime/batch/control.js +0 -86
  94. package/dist/workspace-runtime/batch/deliver.js +0 -173
  95. package/dist/workspace-runtime/batch/freeze.js +0 -101
  96. package/dist/workspace-runtime/batch/generate.js +0 -249
  97. package/dist/workspace-runtime/batch/git.js +0 -40
  98. package/dist/workspace-runtime/batch/occupancy.js +0 -8
  99. package/dist/workspace-runtime/batch/policy.js +0 -70
  100. package/dist/workspace-runtime/batch/prepare.js +0 -317
  101. package/dist/workspace-runtime/batch/processes.js +0 -72
  102. package/dist/workspace-runtime/batch/records.js +0 -113
  103. package/dist/workspace-runtime/batch/routes.js +0 -61
  104. package/dist/workspace-runtime/batch/source-candidate.js +0 -86
  105. package/dist/workspace-runtime/batch/source-capture.js +0 -146
  106. package/dist/workspace-runtime/batch/source-failure.js +0 -43
  107. package/dist/workspace-runtime/batch/source-publish.js +0 -130
  108. package/dist/workspace-runtime/codex/app-server.js +0 -1065
  109. package/dist/workspace-runtime/codex/compact.js +0 -46
  110. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  111. package/dist/workspace-runtime/codex/delivery-tools.js +0 -144
  112. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  113. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  114. package/dist/workspace-runtime/codex/loopback.js +0 -146
  115. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  116. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  117. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  118. package/dist/workspace-runtime/codex/permissions.js +0 -79
  119. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  120. package/dist/workspace-runtime/codex/tool-response.js +0 -10
  121. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  122. package/dist/workspace-runtime/codex/ui-tools.js +0 -203
  123. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  124. package/dist/workspace-runtime/main.js +0 -10
  125. package/dist/workspace-runtime/persistence/journal.js +0 -365
  126. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  127. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  128. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  129. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  130. package/dist/workspace-runtime/previews/diagnostics.js +0 -44
  131. package/dist/workspace-runtime/previews/output.js +0 -36
  132. package/dist/workspace-runtime/previews/publish.js +0 -283
  133. package/dist/workspace-runtime/previews/runtime-preview.js +0 -177
  134. package/dist/workspace-runtime/previews/single-file.js +0 -43
  135. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  136. package/dist/workspace-runtime/serve.js +0 -441
  137. package/dist/workspace-runtime/server/accept-operation.js +0 -61
  138. package/dist/workspace-runtime/server/asset-transfers.js +0 -63
  139. package/dist/workspace-runtime/server/auth.js +0 -21
  140. package/dist/workspace-runtime/server/connectivity.js +0 -209
  141. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  142. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  143. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  144. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  145. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  146. package/dist/workspace-runtime/server/dispatch.js +0 -1632
  147. package/dist/workspace-runtime/server/endpoints.js +0 -21
  148. package/dist/workspace-runtime/server/execution-group.js +0 -90
  149. package/dist/workspace-runtime/server/http.js +0 -1340
  150. package/dist/workspace-runtime/server/lock.js +0 -53
  151. package/dist/workspace-runtime/server/operation-record.js +0 -33
  152. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  153. package/dist/workspace-runtime/server/session-restore.js +0 -84
  154. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  155. package/dist/workspace-runtime/server/submit-operation.js +0 -41
  156. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  157. package/dist/workspace-runtime/server/types.js +0 -1
  158. package/dist/workspace-runtime/server/workspace-transfer.js +0 -168
  159. package/dist/workspace-runtime/verify-artifact.js +0 -59
  160. package/dist/workspace-runtime/workspaces/append-only-log.js +0 -62
  161. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  162. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  163. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -199
  164. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  165. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  166. package/dist/workspace-runtime/workspaces/asset-library-import.js +0 -366
  167. package/dist/workspace-runtime/workspaces/asset-transfer-dependencies.js +0 -81
  168. package/dist/workspace-runtime/workspaces/asset-transfer-publish.js +0 -434
  169. package/dist/workspace-runtime/workspaces/asset-transfer-storage.js +0 -389
  170. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -73
  171. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  172. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  173. package/dist/workspace-runtime/workspaces/binary-content.js +0 -65
  174. package/dist/workspace-runtime/workspaces/binary-write.js +0 -112
  175. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  176. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -115
  177. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  178. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  179. package/dist/workspace-runtime/workspaces/delivery-build.js +0 -331
  180. package/dist/workspace-runtime/workspaces/delivery-store.js +0 -168
  181. package/dist/workspace-runtime/workspaces/delivery.js +0 -64
  182. package/dist/workspace-runtime/workspaces/dependencies.js +0 -279
  183. package/dist/workspace-runtime/workspaces/developer-command.js +0 -98
  184. package/dist/workspace-runtime/workspaces/directories.js +0 -132
  185. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  186. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  187. package/dist/workspace-runtime/workspaces/directory-create.js +0 -57
  188. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  189. package/dist/workspace-runtime/workspaces/directory-mutations.js +0 -238
  190. package/dist/workspace-runtime/workspaces/directory-revisions.js +0 -56
  191. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  192. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  193. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  194. package/dist/workspace-runtime/workspaces/file-content.js +0 -48
  195. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  196. package/dist/workspace-runtime/workspaces/files.js +0 -150
  197. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  198. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  199. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  200. package/dist/workspace-runtime/workspaces/git.js +0 -670
  201. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  202. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -313
  203. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  204. package/dist/workspace-runtime/workspaces/operation-log.js +0 -23
  205. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  206. package/dist/workspace-runtime/workspaces/parameter-agent-inputs.js +0 -87
  207. package/dist/workspace-runtime/workspaces/parameter-agent-protocol.js +0 -29
  208. package/dist/workspace-runtime/workspaces/parameter-agent-store.js +0 -58
  209. package/dist/workspace-runtime/workspaces/parameter-agent.js +0 -282
  210. package/dist/workspace-runtime/workspaces/parameters.js +0 -295
  211. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  212. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  213. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  214. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  215. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  216. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  217. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  218. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  219. package/dist/workspace-runtime/workspaces/transfer-quota.js +0 -69
  220. package/dist/workspace-runtime/workspaces/transfer.js +0 -471
  221. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  222. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  223. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  224. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  225. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  226. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  227. package/project-template-v2/.claude/agents/artist.md +0 -82
  228. package/project-template-v2/.claude/agents/developer.md +0 -153
  229. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  230. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  231. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  232. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  233. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  234. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  235. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  236. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  237. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  238. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  239. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  240. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  241. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  242. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  243. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  244. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  245. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  246. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  247. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  248. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  249. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  250. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  251. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  252. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  253. package/project-template-v2/.claude/settings.json +0 -33
  254. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  255. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  256. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  257. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  258. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  259. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  260. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  261. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  262. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  263. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  264. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  265. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  266. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  267. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  268. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  269. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  270. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  271. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  272. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  273. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  274. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  275. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  276. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  277. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  278. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  279. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  280. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  281. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  282. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  283. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  284. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  285. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  286. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  287. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  288. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  289. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  290. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  291. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  292. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  293. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  294. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  295. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  296. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  297. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  298. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  299. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  300. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  301. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  302. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  303. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  304. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  305. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  306. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  307. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  308. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  309. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  310. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  311. package/project-template-v2/.claude/snapshot.mjs +0 -263
  312. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  313. package/project-template-v2/CLAUDE.md +0 -146
  314. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  315. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  316. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  317. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  318. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  319. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  320. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  321. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  322. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  323. package/project-template-v2/assets/models/.gitkeep +0 -0
  324. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  325. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  326. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  327. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  328. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  329. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  330. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  331. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  332. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  333. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  334. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  335. package/project-template-v2/docs/project-state.json +0 -60
  336. package/project-template-v2/docs/project-state.md +0 -72
  337. package/project-template-v2/docs/standards/README.md +0 -225
  338. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  339. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  340. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  341. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  342. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  343. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  344. package/project-template-v2/game/index.ts +0 -18
  345. package/project-template-v2/globals.d.ts +0 -51
  346. package/project-template-v2/index.css +0 -34
  347. package/project-template-v2/index.html +0 -18
  348. package/project-template-v2/main.ts +0 -9
  349. package/project-template-v2/package.json +0 -46
  350. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  351. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  352. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  353. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  354. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  355. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  356. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  357. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  358. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  359. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  360. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  361. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  362. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  363. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  364. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  365. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  366. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  367. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  368. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  369. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  370. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  371. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  372. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  373. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  374. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  375. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  376. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  377. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  378. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  379. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  380. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  381. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  382. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  383. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  384. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  385. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  386. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  387. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  388. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  389. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  390. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  391. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  392. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  393. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  394. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  395. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  396. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  397. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  398. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  399. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  400. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  401. package/project-template-v2/tsconfig.json +0 -20
  402. package/project-template-v2/vite.config.ts +0 -27
  403. package/project-templates/batch-locks/phaser.yaml +0 -922
  404. package/project-templates/batch-locks/threejs.yaml +0 -978
  405. package/project-templates/empty/AGENTS.md +0 -41
  406. package/project-templates/empty/gitignore +0 -33
@@ -1,69 +0,0 @@
1
- import { spawn } from 'node:child_process';
2
- import { setTimeout as delay } from 'node:timers/promises';
3
- export const MANAGED_WRITE_SOURCES = ['manual', 'agent', 'background'];
4
- const BACKGROUND_WRITER = `
5
- const fs = require('node:fs');
6
- const file = process.argv[1];
7
- if (!file) process.exit(1);
8
- fs.appendFileSync(file, 'background\\n');
9
- const timer = setInterval(() => {
10
- try { fs.appendFileSync(file, 'x'); }
11
- catch { clearInterval(timer); process.exit(0); }
12
- }, 200);
13
- `;
14
- /** `true` alive, `false` confirmed exited, `undefined` when the probe cannot tell. */
15
- export function probeProcess(pid) {
16
- try {
17
- process.kill(pid, 0);
18
- return true;
19
- }
20
- catch (error) {
21
- if (error.code === 'ESRCH')
22
- return false;
23
- return undefined;
24
- }
25
- }
26
- export function spawnBackgroundWriter(absolutePath) {
27
- const child = spawn(process.execPath, ['-e', BACKGROUND_WRITER, absolutePath], {
28
- detached: true,
29
- stdio: 'ignore',
30
- });
31
- child.unref();
32
- if (!child.pid)
33
- throw new Error('background_write_failed');
34
- return child.pid;
35
- }
36
- export async function stopBackgroundWriter(pid) {
37
- signal(pid, 'SIGTERM');
38
- if (await waitUntilStopped(pid, 2_000))
39
- return true;
40
- signal(pid, 'SIGKILL');
41
- return waitUntilStopped(pid, 2_000);
42
- }
43
- function signal(pid, name) {
44
- try {
45
- process.kill(-pid, name);
46
- }
47
- catch (error) {
48
- if (error.code !== 'ESRCH')
49
- return;
50
- try {
51
- process.kill(pid, name);
52
- }
53
- catch {
54
- /* already gone */
55
- }
56
- }
57
- }
58
- async function waitUntilStopped(pid, timeoutMs) {
59
- const deadline = Date.now() + timeoutMs;
60
- while (Date.now() < deadline) {
61
- const alive = probeProcess(pid);
62
- if (alive === false)
63
- return true;
64
- if (alive === undefined)
65
- return false;
66
- await delay(50);
67
- }
68
- return probeProcess(pid) === false;
69
- }
@@ -1,441 +0,0 @@
1
- import { closeCliCredentials } from './workspaces/cli-credentials.js';
2
- import { randomUUID } from 'node:crypto';
3
- import { mkdir, readdir } from 'node:fs/promises';
4
- import { createServer } from 'node:http';
5
- import { createPlatformAdapter } from '@playcraft/build';
6
- import { INCOMPATIBLE_EXIT_CODE, negotiateProtocol, transitionOperation, directoryMutationReceiptSchema, productionSessionAttemptId, } from '@playcraft/common/cloud-workspace/runtime';
7
- import { RuntimeJournal } from './persistence/journal.js';
8
- import { createCodexAppServerAdapter } from './codex/app-server.js';
9
- import { trustedMemberPolicy } from './batch/policy.js';
10
- import { batchDirectoryHeld } from './batch/occupancy.js';
11
- import { createLoopbackNativeAdapter } from './codex/loopback.js';
12
- import { attachNativeCollector, recoverInterruptedParameterVerifications, stopParameterVerifications } from './server/dispatch.js';
13
- import { handleRuntimeRequest } from './server/http.js';
14
- import { desktopHost, disposeDesktopHost } from './server/desktop-host.js';
15
- import { disposeTerminalHost, terminalHost } from './server/terminal-host.js';
16
- import { handleExecutionGroupCrash } from './server/execution-group.js';
17
- import { RuntimeProcessLock } from './server/lock.js';
18
- import { probeGitBinary } from './workspaces/git.js';
19
- import { WorkspaceGitCredentialBroker } from './workspaces/git-credential-broker.js';
20
- import { WorkspaceModelBroker } from './codex/model-broker.js';
21
- import { recoverInterruptedPreviews } from './previews/publish.js';
22
- import { recoverInterruptedInstalls } from './workspaces/dependencies.js';
23
- import { DeliveryStore, recoverInterruptedDeliveries } from './workspaces/delivery-store.js';
24
- import { loadWorkspaceSkillArtifact } from './workspaces/skill-artifact-loader.js';
25
- import { workspaceContextFromRoot, workspaceRoot } from './workspaces/registry.js';
26
- import { recoverInterruptedLibraryImports } from './workspaces/asset-library-import.js';
27
- import { recoverAssetTransfers } from './workspaces/asset-transfer-publish.js';
28
- import { recoverWorkspaceDirectoryMutation } from './workspaces/directory-mutations.js';
29
- import { observeWorkspaceDirectories } from './workspaces/directory-revisions.js';
30
- import { observeWorkspaceBinaryFile } from './workspaces/binary-write.js';
31
- import { revisionScope } from './workspaces/registry.js';
32
- import { observeWorkspaceArtifacts } from './workspaces/artifact-events.js';
33
- import { loadWorkspaceMcpConfig } from './codex/mcp-config.js';
34
- import { startSourceEventUploader, stopSourceEventUploader } from './server/source-uploader.js';
35
- import { submitTrustedOperation } from './server/submit-operation.js';
36
- export async function startWorkspaceRuntime(config, options = {}) {
37
- process.env.PLAYCRAFT_SKIP_UPDATE_CHECK = '1';
38
- const negotiated = negotiateProtocol(config);
39
- if (!negotiated.ok) {
40
- const error = Object.assign(new Error('protocol_incompatible'), {
41
- code: 'protocol_incompatible',
42
- exitCode: INCOMPATIBLE_EXIT_CODE,
43
- });
44
- throw error;
45
- }
46
- const lock = new RuntimeProcessLock(config.stateDir);
47
- lock.acquire();
48
- let journal;
49
- let gitCredentials;
50
- let runtimeState;
51
- try {
52
- journal = new RuntimeJournal(config.stateDir);
53
- await journal.load();
54
- const previousEpoch = journal.storedRuntimeEpoch();
55
- const previousGroup = journal.executionGroup();
56
- const previousIdentityMatches = journal.epochsSnapshot().some((epoch) => epoch.runtime_id === config.runtimeId && epoch.generation === config.generation && epoch.runtime_epoch === previousEpoch);
57
- await recoverInterruptedInstalls(journal);
58
- await recoverInterruptedPreviews(journal);
59
- await recoverInterruptedParameterVerifications(journal);
60
- await recoverInterruptedDeliveries(config.stateDir);
61
- await mkdir(config.workspaceRoot, { recursive: true, mode: 0o700 });
62
- const state = runtimeState = {
63
- config: { ...config, protocolMinor: negotiated.protocolMinor },
64
- configPath: options.configPath,
65
- journal,
66
- acceptedLeaseFence: journal.acceptedLeaseFence(),
67
- gitAvailable: await probeGitBinary(),
68
- native: options.nativeAdapter,
69
- runtimeEpoch: Math.max(config.runtimeEpoch, journal.storedRuntimeEpoch() ?? 0),
70
- executionQueue: Promise.resolve(),
71
- instanceToken: randomUUID(),
72
- };
73
- const recoveredImports = new Map();
74
- const recoveredChanges = [];
75
- const recoveredWrites = [];
76
- const recoverLibraryImports = async (root) => {
77
- const result = await recoverInterruptedLibraryImports(root).catch(() => undefined);
78
- for (const published of result?.published ?? []) {
79
- const previous = recoveredImports.get(published.operationId) ?? { paths: [], assetIds: [] };
80
- recoveredImports.set(published.operationId, { paths: [...new Set([...previous.paths, ...published.paths])],
81
- assetIds: [...new Set([...previous.assetIds, published.assetId])] });
82
- }
83
- };
84
- if (config.workspaceMode === 'multi') {
85
- for (const entry of await readdir(config.workspaceRoot, { withFileTypes: true })) {
86
- if (!entry.isDirectory())
87
- continue;
88
- const binding = journal.getWorkspace(entry.name);
89
- if (!binding)
90
- continue;
91
- for (const directory of new Set(['basic', ...(binding.directories ?? []).map(item => item.directoryName)])) {
92
- const root = await workspaceRoot(state, binding.workspaceId, directory).catch(() => undefined);
93
- if (root)
94
- await recoverLibraryImports(root);
95
- }
96
- }
97
- }
98
- else
99
- await recoverLibraryImports(config.workspaceRoot);
100
- for (const { scopeKey, operation } of journal.listOperations()) {
101
- if (operation.kind !== 'asset.library.import' || !['queued', 'dispatched', 'accepted', 'uncertain'].includes(operation.status))
102
- continue;
103
- const published = recoveredImports.get(operation.operationId);
104
- const result = operation.result && 'paths' in operation.result ? { ...operation.result,
105
- paths: [...new Set([...operation.result.paths, ...(published?.paths ?? [])])],
106
- failures: operation.result.failures.filter(failure => !published?.assetIds.includes(failure.assetId)),
107
- } : undefined;
108
- const root = await workspaceRoot(state, operation.workspaceId, operation.directoryName).catch(() => undefined);
109
- if (root && result)
110
- for (const path of result.paths) {
111
- const file = await observeWorkspaceBinaryFile(root, path).catch(() => undefined);
112
- if (!file)
113
- continue;
114
- const scope = revisionScope(state, operation.workspaceId, operation.directoryName);
115
- const previous = journal.fileRevisions(scope)[path];
116
- await journal.putFileRevision(path, { revision: (previous?.revision ?? 0) + 1, contentHash: file.contentHash }, scope);
117
- }
118
- let next = operation;
119
- if (result && !result.failures.length) {
120
- if (next.status === 'queued')
121
- next = transitionOperation(next, 'dispatched');
122
- if (next.status === 'dispatched')
123
- next = transitionOperation(next, 'accepted');
124
- next = transitionOperation(next, 'completed', { result });
125
- }
126
- else
127
- next = transitionOperation(next, 'failed', { error: 'asset_library_import_interrupted', ...(result ? { result } : {}) });
128
- await journal.putOperation(scopeKey, next);
129
- if (operation.workspaceId && result?.paths.length)
130
- recoveredChanges.push({ workspaceId: operation.workspaceId,
131
- directoryName: operation.directoryName ?? 'basic', paths: result.paths });
132
- }
133
- const recoveredBundles = new Map();
134
- const transferScopes = new Set();
135
- for (const { operation } of journal.listOperations()) {
136
- if (operation.kind !== 'asset.bundle.save')
137
- continue;
138
- const directoryName = operation.directoryName ?? 'basic';
139
- const key = `${operation.workspaceId ?? ''}:${directoryName}`;
140
- if (transferScopes.has(key))
141
- continue;
142
- transferScopes.add(key);
143
- const root = await workspaceRoot(state, operation.workspaceId, directoryName).catch(() => undefined);
144
- if (!root)
145
- continue;
146
- const recovered = await recoverAssetTransfers(root, { environment: config.environment, userId: config.userId,
147
- workspaceId: operation.workspaceId ?? '', directoryName }).catch(() => []);
148
- for (const item of recovered)
149
- recoveredBundles.set(item.operationId, item);
150
- }
151
- for (const { scopeKey, operation } of journal.listOperations()) {
152
- if (operation.kind !== 'asset.bundle.save' || !['queued', 'dispatched', 'accepted', 'uncertain'].includes(operation.status))
153
- continue;
154
- const recovered = recoveredBundles.get(operation.operationId), receipt = recovered?.receipt;
155
- let next = operation;
156
- if (receipt) {
157
- const paths = [...receipt.files.map(file => file.path), ...(receipt.directories ?? [])];
158
- const scope = revisionScope(state, operation.workspaceId, operation.directoryName);
159
- for (const file of receipt.files) {
160
- const previous = journal.fileRevisions(scope)[file.path];
161
- const revision = previous ? previous.revision + (previous.contentHash === file.contentHash ? 0 : 1) : 1;
162
- await journal.putFileRevision(file.path, { revision,
163
- contentHash: file.contentHash }, scope);
164
- const metadata = recovered?.manifest.files.find(item => item.path === file.path);
165
- recoveredWrites.push({ ...file, revision, writer: 'manual', workspaceId: operation.workspaceId,
166
- directoryName: operation.directoryName ?? 'basic', operationId: operation.operationId, transferId: receipt.transferId,
167
- ...(metadata?.processing ? { processing: metadata.processing } : {}), recovered: true });
168
- }
169
- if (next.status === 'queued')
170
- next = transitionOperation(next, 'dispatched');
171
- if (next.status === 'dispatched')
172
- next = transitionOperation(next, 'accepted');
173
- next = transitionOperation(next, 'completed', { result: { paths, skippedPaths: [], failures: [], bundleReceipt: receipt } });
174
- if (operation.workspaceId)
175
- recoveredChanges.push({ workspaceId: operation.workspaceId, directoryName: operation.directoryName ?? 'basic', paths, source: 'asset.bundle.save' });
176
- }
177
- else
178
- next = transitionOperation(next, 'failed', { error: 'asset_bundle_save_interrupted' });
179
- await journal.putOperation(scopeKey, next);
180
- }
181
- for (const { scopeKey, operation } of journal.listOperations()) {
182
- if (!['directory.rename', 'directory.delete'].includes(operation.kind)
183
- || !['queued', 'dispatched', 'accepted', 'uncertain'].includes(operation.status))
184
- continue;
185
- const kind = operation.kind;
186
- let next = operation;
187
- try {
188
- const root = await workspaceRoot(state, operation.workspaceId, operation.directoryName);
189
- const receipt = await recoverWorkspaceDirectoryMutation(root, kind, { operationId: operation.operationId,
190
- operationPayloadHash: operation.payloadHash, scope: scopeKey, assertCurrent: async () => {
191
- if ((operation.leaseFence ?? 0) < state.acceptedLeaseFence || state.journal.destroyed())
192
- throw new Error('stale_lease');
193
- if (operation.sessionId && productionSessionAttemptId(operation.sessionId))
194
- throw new Error('production_session_readonly');
195
- if (await batchDirectoryHeld(state, operation.workspaceId, operation.directoryName))
196
- throw new Error('batch_workspace_readonly');
197
- } });
198
- if (!receipt)
199
- throw new Error('directory_mutation_interrupted');
200
- await observeWorkspaceDirectories(root, journal, revisionScope(state, operation.workspaceId, operation.directoryName));
201
- const paths = [receipt.path, ...(receipt.newPath ? [receipt.newPath] : [])];
202
- if (next.status === 'queued')
203
- next = transitionOperation(next, 'dispatched');
204
- if (next.status === 'dispatched')
205
- next = transitionOperation(next, 'accepted');
206
- next = transitionOperation(next, 'completed', { result: { paths, skippedPaths: [], failures: [], directoryMutation: directoryMutationReceiptSchema.parse(receipt) } });
207
- if (operation.workspaceId)
208
- recoveredChanges.push({ workspaceId: operation.workspaceId,
209
- directoryName: operation.directoryName ?? 'basic', paths, source: kind });
210
- }
211
- catch (error) {
212
- const reason = String(error?.code ?? (error instanceof Error ? error.message : ''));
213
- const code = ['directory_mutation_interrupted', 'stale_lease', 'production_session_readonly', 'batch_workspace_readonly',
214
- 'directory_exists', 'directory_not_found', 'revision_conflict', 'directory_conflict', 'invalid_workspace_path', 'workspace_permission_denied']
215
- .includes(reason) ? reason : 'directory_recovery_required';
216
- next = transitionOperation(next, code === 'directory_mutation_interrupted' ? 'failed' : 'uncertain', { error: code });
217
- }
218
- await journal.putOperation(scopeKey, next);
219
- }
220
- const native = state.native ??= defaultNativeAdapter(state);
221
- await journal.bindRuntime({
222
- runtimeId: config.runtimeId,
223
- generation: config.generation,
224
- runtimeEpoch: state.runtimeEpoch,
225
- });
226
- for (const payload of recoveredWrites)
227
- await journal.allocateSourceEvent({ runtimeId: config.runtimeId,
228
- generation: config.generation, runtimeEpoch: state.runtimeEpoch, workspaceId: payload.workspaceId,
229
- type: 'file.written', occurredAt: new Date().toISOString(), payload });
230
- for (const change of recoveredChanges)
231
- await journal.allocateSourceEvent({ runtimeId: config.runtimeId,
232
- generation: config.generation, runtimeEpoch: state.runtimeEpoch, workspaceId: change.workspaceId,
233
- type: 'files.changed', occurredAt: new Date().toISOString(), payload: { ...change, source: change.source ?? 'asset.library.import', recovered: true },
234
- });
235
- startSourceEventUploader(state);
236
- if (config.workspaceMode === 'multi') {
237
- gitCredentials = state.gitCredentials = new WorkspaceGitCredentialBroker(state);
238
- await gitCredentials.start();
239
- }
240
- const stopArtifactObserver = observeWorkspaceArtifacts(state);
241
- attachNativeCollector(state);
242
- native?.onUnexpectedExit?.((event) => {
243
- void handleExecutionGroupCrash(state, event.pid);
244
- });
245
- try {
246
- await native?.start?.();
247
- const group = native?.executionProcess?.();
248
- if (group) {
249
- let previousStopped = false;
250
- if (previousGroup.pid && previousGroup.pid !== group.pid) {
251
- try {
252
- process.kill(previousGroup.pid, 0);
253
- }
254
- catch (error) {
255
- previousStopped = error.code === 'ESRCH';
256
- }
257
- }
258
- // The supervisor advances the trusted config epoch only after stopping the old
259
- // native group. Reconfirm its recorded PID before publishing that replacement.
260
- if (previousIdentityMatches && previousEpoch !== undefined && config.runtimeEpoch > previousEpoch && previousStopped) {
261
- await journal.writeExecutionEpoch({
262
- runtimeEpoch: state.runtimeEpoch, ...group, previousPid: previousGroup.pid, previousRuntimeEpoch: previousEpoch, stopConfirmed: true,
263
- });
264
- await journal.replaceSessions(journal.listSessions().map((session) => ({ ...session, recoverability: 'history_only' })));
265
- }
266
- else {
267
- await journal.noteExecutionGroup(group);
268
- }
269
- }
270
- }
271
- catch (error) {
272
- const code = error instanceof Error ? error.message : '';
273
- state.nativeError = code === 'codex_model_catalog_unavailable' ? code : 'codex_start_failed';
274
- console.error(`[workspace-runtime] ${state.nativeError}`);
275
- }
276
- const server = createServer((request, response) => {
277
- void handleRuntimeRequest(state, request, response);
278
- });
279
- server.on('upgrade', (request, socket, head) => {
280
- const pathname = new URL(request.url ?? '/', 'http://127.0.0.1').pathname;
281
- if (/^\/runtime\/terminals\/[^/]+\/connect$/.test(pathname)) {
282
- void terminalHost(state).handleUpgrade(request, socket, head);
283
- return;
284
- }
285
- if (pathname === '/runtime/desktop/connect') {
286
- desktopHost(state).handleUpgrade(request, socket, head);
287
- return;
288
- }
289
- socket.destroy();
290
- });
291
- const port = await listenOn(server, config.listen.host, config.listen.port);
292
- return {
293
- config: state.config,
294
- state,
295
- url: `http://${formatHost(config.listen.host)}:${port}`,
296
- async close() {
297
- const serverClosed = closeServer(server);
298
- await stopParameterVerifications(state);
299
- await closeCliCredentials(state);
300
- await gitCredentials?.close();
301
- try {
302
- await disposeDesktopHost(state);
303
- }
304
- finally {
305
- disposeTerminalHost(state);
306
- try {
307
- await native?.close?.();
308
- }
309
- catch {
310
- /* adapter shutdown is best-effort */
311
- }
312
- await serverClosed;
313
- await stopArtifactObserver();
314
- stopSourceEventUploader(state);
315
- await journal?.close();
316
- lock.release();
317
- }
318
- },
319
- };
320
- }
321
- catch (error) {
322
- if (runtimeState)
323
- stopSourceEventUploader(runtimeState);
324
- await gitCredentials?.close().catch(() => undefined);
325
- await journal?.close().catch(() => undefined);
326
- lock.release();
327
- throw error;
328
- }
329
- }
330
- function listenOn(server, host, port) {
331
- return new Promise((resolve, reject) => {
332
- const onError = (error) => reject(error);
333
- server.once('error', onError);
334
- server.listen(port, host, () => {
335
- server.removeListener('error', onError);
336
- const address = server.address();
337
- if (!address || typeof address === 'string') {
338
- reject(new Error('listen_failed'));
339
- return;
340
- }
341
- resolve(address.port);
342
- });
343
- });
344
- }
345
- function closeServer(server) {
346
- return new Promise((resolve, reject) => {
347
- server.close((error) => {
348
- if (error)
349
- reject(error);
350
- else
351
- resolve();
352
- });
353
- });
354
- }
355
- function formatHost(host) {
356
- return host.includes(':') ? `[${host}]` : host;
357
- }
358
- function deliveryToolHandlers(state) {
359
- const contextFor = async (input) => {
360
- if (input.workspaceId)
361
- return { workspaceId: input.workspaceId, directoryName: input.directoryName ?? 'basic' };
362
- if (state.config.workspaceMode !== 'multi' || !input.cwd)
363
- throw new Error('feature_unavailable');
364
- return workspaceContextFromRoot(state, input.cwd);
365
- };
366
- return {
367
- async build(input) {
368
- const { workspaceId, directoryName } = await contextFor(input);
369
- if (directoryName === 'root')
370
- throw new Error('invalid_workspace_directory');
371
- const builds = [];
372
- for (const channel of input.channels) {
373
- const operation = await submitTrustedOperation(state, {
374
- kind: 'delivery.build',
375
- workspaceId,
376
- directoryName,
377
- ...(input.sessionId ? { sessionId: input.sessionId } : {}),
378
- clientRequestId: `${input.clientRequestId.slice(0, 80)}:${channel}`,
379
- payload: {
380
- channel,
381
- format: input.format ?? createPlatformAdapter({ platform: channel, format: 'html' }).getDefaultFormat(),
382
- actor: 'agent',
383
- },
384
- });
385
- let record;
386
- for (let attempt = 0; attempt < 40 && !record; attempt++) {
387
- record = await new DeliveryStore(state.config.stateDir, workspaceId).read(operation.operationId);
388
- if (!record)
389
- await new Promise(resolve => setTimeout(resolve, 25));
390
- }
391
- builds.push({
392
- buildId: operation.operationId,
393
- channel,
394
- status: record?.status ?? operation.status,
395
- ...(record?.queuePosition ? { queuePosition: record.queuePosition } : {}),
396
- });
397
- }
398
- return { builds };
399
- },
400
- async get(input) {
401
- const { workspaceId, directoryName } = await contextFor(input);
402
- const store = new DeliveryStore(state.config.stateDir, workspaceId);
403
- const record = input.buildId
404
- ? await store.read(input.buildId)
405
- : (await store.list(directoryName, input.channel, 20))[0];
406
- if (!record || record.directoryName !== directoryName)
407
- throw new Error('delivery_build_not_found');
408
- const log = await store.readLog(record.buildId, 0).catch(() => undefined);
409
- return { build: record, ...(log ? { logTail: log.text.slice(-4_000) } : {}) };
410
- },
411
- };
412
- }
413
- function defaultNativeAdapter(state) {
414
- const config = state.config;
415
- if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'loopback')
416
- return createLoopbackNativeAdapter();
417
- const hasLauncher = Boolean(process.env.PLAYCRAFT_LAUNCHER_SOCKET);
418
- const multi = config.workspaceMode === 'multi';
419
- if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'codex' && !multi && !hasLauncher) {
420
- throw new Error('codex_requires_managed_launcher');
421
- }
422
- if (process.env.PLAYCRAFT_NATIVE_ADAPTER === 'codex' || (multi && hasLauncher)) {
423
- return createCodexAppServerAdapter({
424
- config,
425
- workspaceUi: true,
426
- deliveryTools: deliveryToolHandlers(state),
427
- ...(multi ? { modelBroker: new WorkspaceModelBroker(state) } : {}),
428
- ...(multi ? { loadMcpConfig: async (cwd) => {
429
- const { workspaceId } = await workspaceContextFromRoot(state, cwd);
430
- return loadWorkspaceMcpConfig(state, workspaceId);
431
- } } : {}),
432
- loadSkillArtifact: async (cwd, entry) => {
433
- const { workspaceId, directoryName } = await workspaceContextFromRoot(state, cwd);
434
- return loadWorkspaceSkillArtifact(state, workspaceId, entry, directoryName === 'root' ? 'basic' : directoryName);
435
- },
436
- onSkillProcessRestart: process => state.journal.noteExecutionGroup(process),
437
- trustedExecution: sessionId => trustedMemberPolicy(state, sessionId),
438
- });
439
- }
440
- return undefined;
441
- }
@@ -1,61 +0,0 @@
1
- import { assertLeaseFence, hashOperationPayload, isLostThreadError, operationScopeKey, resolveIdempotentAccept, runtimeError, } from '@playcraft/common/cloud-workspace/runtime';
2
- import { canExecuteKind, executeOperation } from './dispatch.js';
3
- import { buildOperationRecord } from './operation-record.js';
4
- /**
5
- * Shared operation acceptance: lease fence, idempotency, capability, record creation and
6
- * execution. HTTP supplies its transport/session checks through `validate`; in-sandbox Agent
7
- * tools pass none. The callback runs only when a new operation is about to be created.
8
- */
9
- export async function acceptOperationCore(state, parsed, options) {
10
- const payloadHash = hashOperationPayload(parsed.payload);
11
- const scopeKey = operationScopeKey({
12
- environment: state.config.environment,
13
- userId: state.config.userId,
14
- kind: parsed.kind,
15
- clientRequestId: parsed.clientRequestId,
16
- workspaceId: parsed.workspaceId,
17
- directoryName: parsed.directoryName,
18
- sessionId: parsed.sessionId,
19
- });
20
- return state.journal.exclusive(scopeKey, async () => {
21
- // Recheck after a concurrent dispatcher may have advanced the fence while this request waited.
22
- if (assertLeaseFence(options.leaseFence, state.acceptedLeaseFence) !== 'ok') {
23
- return rejected(409, runtimeError('stale_lease', 'leaseFence is behind the accepted dispatcher'));
24
- }
25
- const existing = state.journal.getOperation(scopeKey);
26
- const decision = resolveIdempotentAccept(existing, payloadHash);
27
- if (decision.action === 'conflict') {
28
- return rejected(409, runtimeError('idempotency_conflict', 'clientRequestId reused with a different payload', {
29
- operationId: decision.operation.operationId,
30
- }));
31
- }
32
- const retryWithRecovery = decision.action === 'reuse' && parsed.kind === 'session.turn'
33
- && Boolean(parsed.sessionRecovery) && decision.operation.status === 'failed'
34
- && isLostThreadError(decision.operation.error);
35
- if (decision.action === 'reuse' && !retryWithRecovery) {
36
- if (decision.operation.status === 'uncertain') {
37
- return rejected(409, runtimeError('uncertain_operation', decision.operation.error ?? 'native_receipt_lost', {
38
- operationId: decision.operation.operationId,
39
- }));
40
- }
41
- return { rejected: false, operation: decision.operation, executed: decision.operation, reused: true };
42
- }
43
- const validation = await options.validate?.(scopeKey);
44
- if (validation)
45
- return { rejected: true, refusal: validation };
46
- const executable = canExecuteKind(state, parsed.kind);
47
- const operation = buildOperationRecord(state, parsed, payloadHash, options.leaseFence, executable);
48
- if (!executable) {
49
- const saved = await state.journal.putOperation(scopeKey, operation);
50
- return rejected(409, runtimeError('capability_unavailable', state.journal.destroyed() ? 'runtime_destroyed' : state.nativeError ?? 'adapter_not_started', { operationId: saved.operationId }));
51
- }
52
- state.acceptedLeaseFence = Math.max(state.acceptedLeaseFence, options.leaseFence);
53
- await state.journal.setAcceptedLeaseFence(state.acceptedLeaseFence);
54
- const queued = await state.journal.putOperation(scopeKey, operation);
55
- const executed = await executeOperation(state, scopeKey, queued, options.executionPayload, parsed.sessionRecovery);
56
- return { rejected: false, operation: queued, executed, reused: false };
57
- });
58
- }
59
- function rejected(status, body) {
60
- return { rejected: true, refusal: { status, body } };
61
- }
@@ -1,63 +0,0 @@
1
- import { ASSET_TRANSFER_BODY_MAX_BYTES, ASSET_TRANSFER_CHUNK_BODY_MAX_BYTES } from '@playcraft/common/cloud-workspace/runtime';
2
- import { batchDirectoryHeld } from '../batch/occupancy.js';
3
- import { revisionScope, workspaceRoot } from '../workspaces/registry.js';
4
- import { AssetTransferError, cancelAssetTransfer, createAssetTransfer, getAssetTransfer, putAssetTransferChunk } from '../workspaces/asset-transfer-storage.js';
5
- export async function handleAssetTransferRequest(state, request, url) {
6
- const route = /^\/runtime\/asset-transfers(?:\/([^/]+)(?:\/(chunks))?)?$/.exec(url.pathname);
7
- if (!route)
8
- return undefined;
9
- const workspaceId = url.searchParams.get('workspaceId') ?? '';
10
- const directoryName = url.searchParams.get('directoryName') ?? 'basic';
11
- try {
12
- if (state.journal.destroyed())
13
- throw new AssetTransferError('runtime_destroyed');
14
- if (!/^(basic|remix-[a-z0-9][a-z0-9-]{3,63})$/.test(directoryName))
15
- throw new AssetTransferError('invalid_workspace_directory', 400);
16
- const [, id, action] = route;
17
- const valid = !id && request.method === 'POST' || id && !action && ['GET', 'DELETE'].includes(request.method ?? '')
18
- || id && action === 'chunks' && request.method === 'PUT';
19
- if (!valid)
20
- return { status: 405, body: { error: 'asset_transfer_method_not_allowed' } };
21
- const scope = { workspaceId, directoryName, environment: state.config.environment, userId: state.config.userId };
22
- const body = ['POST', 'PUT'].includes(request.method ?? '')
23
- ? await readTransferJson(request, action ? ASSET_TRANSFER_CHUNK_BODY_MAX_BYTES : ASSET_TRANSFER_BODY_MAX_BYTES) : undefined;
24
- return await state.journal.exclusive(`directory:${workspaceId}:${directoryName}`, async () => state.journal.exclusive(`workspace:${revisionScope(state, workspaceId, directoryName) ?? 'single'}`, async () => {
25
- if (state.journal.destroyed())
26
- throw new AssetTransferError('runtime_destroyed');
27
- if (request.method !== 'GET' && await batchDirectoryHeld(state, workspaceId, directoryName))
28
- throw new AssetTransferError('batch_workspace_readonly');
29
- const root = await workspaceRoot(state, workspaceId, directoryName);
30
- const result = !id ? await createAssetTransfer(root, scope, body)
31
- : action ? await putAssetTransferChunk(root, scope, id, body)
32
- : request.method === 'GET' ? await getAssetTransfer(root, scope, id) : await cancelAssetTransfer(root, scope, id);
33
- return { status: 200, body: result };
34
- }));
35
- }
36
- catch (error) {
37
- if (error instanceof AssetTransferError)
38
- return { status: error.status, body: { error: error.code } };
39
- if (error.name === 'ZodError')
40
- return { status: 400, body: { error: 'invalid_asset_transfer' } };
41
- throw error;
42
- }
43
- }
44
- async function readTransferJson(request, limit) {
45
- const length = request.headers['content-length'];
46
- if (length && (!/^\d+$/.test(length) || Number(length) > limit))
47
- throw new AssetTransferError('asset_transfer_too_large', 413);
48
- const parts = [];
49
- let size = 0;
50
- for await (const data of request) {
51
- const bytes = Buffer.isBuffer(data) ? data : Buffer.from(data);
52
- size += bytes.length;
53
- if (size > limit)
54
- throw new AssetTransferError('asset_transfer_too_large', 413);
55
- parts.push(bytes);
56
- }
57
- try {
58
- return JSON.parse(Buffer.concat(parts).toString('utf8'));
59
- }
60
- catch {
61
- throw new AssetTransferError('invalid_asset_transfer', 400);
62
- }
63
- }
@@ -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
- }