@playcraft/cli 0.1.38-beta → 0.1.39-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 (367) hide show
  1. package/README.md +3 -58
  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 +126 -68
  12. package/dist/commands/tools-image-context.js +23 -0
  13. package/dist/commands/tools.js +2 -2
  14. package/dist/config.js +4 -59
  15. package/dist/index.js +3 -40
  16. package/dist/remix/clone.js +0 -2
  17. package/dist/remix/init-template.js +0 -2
  18. package/dist/remix/pull.js +0 -2
  19. package/dist/remix/push.js +1 -21
  20. package/dist/utils/agent-api-client.js +30 -185
  21. package/dist/utils/image-asset-context.js +106 -0
  22. package/dist/utils/playcraft-http-client.js +4 -6
  23. package/package.json +3 -13
  24. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  25. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  26. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  29. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  30. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  31. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  35. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  36. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  37. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  41. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  42. package/SKILLS_REGISTRY.md +0 -149
  43. package/dist/auth/account-activation.js +0 -157
  44. package/dist/auth/messages.js +0 -30
  45. package/dist/commands/build-temp.js +0 -26
  46. package/dist/commands/platform-skills.generated.js +0 -19
  47. package/dist/commands/playable.js +0 -53
  48. package/dist/commands/tools-batch.js +0 -87
  49. package/dist/commands/video.js +0 -111
  50. package/dist/commands/workspace-runtime.js +0 -54
  51. package/dist/commands/workspace.js +0 -35
  52. package/dist/project-skills/builtin-import.js +0 -225
  53. package/dist/project-skills/commands.js +0 -77
  54. package/dist/project-skills/lifecycle.js +0 -28
  55. package/dist/project-skills/local-run.js +0 -112
  56. package/dist/project-skills/local-store.js +0 -221
  57. package/dist/project-skills/messages.js +0 -80
  58. package/dist/project-skills/reconcile.js +0 -62
  59. package/dist/project-skills/remote-cache.js +0 -51
  60. package/dist/project-skills/validation.js +0 -19
  61. package/dist/recording/messages.js +0 -40
  62. package/dist/recording/project-digest.js +0 -85
  63. package/dist/recording/recorder.js +0 -293
  64. package/dist/recording/scenario.js +0 -50
  65. package/dist/skill-registry/client.js +0 -345
  66. package/dist/skill-registry/commands.js +0 -180
  67. package/dist/skill-registry/evaluation-client.js +0 -156
  68. package/dist/skill-registry/evaluation-commands.js +0 -174
  69. package/dist/skill-registry/messages.js +0 -177
  70. package/dist/skill-registry/package.js +0 -275
  71. package/dist/skill-registry/platform-package.js +0 -100
  72. package/dist/utils/environment-endpoints.js +0 -17
  73. package/dist/utils/tool-operation-journal.js +0 -124
  74. package/dist/utils/video-evidence-git.js +0 -81
  75. package/dist/video-replication/client.js +0 -222
  76. package/dist/video-replication/comparison-evidence.js +0 -149
  77. package/dist/video-replication/comparison-files.js +0 -57
  78. package/dist/video-replication/comparison-log.js +0 -72
  79. package/dist/video-replication/comparison-messages.js +0 -104
  80. package/dist/video-replication/comparison-output.js +0 -63
  81. package/dist/video-replication/comparison-preflight.js +0 -66
  82. package/dist/video-replication/comparison.js +0 -216
  83. package/dist/video-replication/evidence.js +0 -165
  84. package/dist/video-replication/media.js +0 -111
  85. package/dist/video-replication/messages.js +0 -89
  86. package/dist/workspace/messages.js +0 -35
  87. package/dist/workspace/transfer-client.js +0 -174
  88. package/dist/workspace-runtime/codex/app-server.js +0 -1040
  89. package/dist/workspace-runtime/codex/compact.js +0 -46
  90. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  91. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  92. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  93. package/dist/workspace-runtime/codex/loopback.js +0 -146
  94. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  95. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  96. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  97. package/dist/workspace-runtime/codex/permissions.js +0 -70
  98. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  99. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  100. package/dist/workspace-runtime/codex/ui-tools.js +0 -183
  101. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  102. package/dist/workspace-runtime/main.js +0 -10
  103. package/dist/workspace-runtime/persistence/journal.js +0 -365
  104. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  105. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  106. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  107. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  108. package/dist/workspace-runtime/previews/output.js +0 -36
  109. package/dist/workspace-runtime/previews/publish.js +0 -262
  110. package/dist/workspace-runtime/previews/single-file.js +0 -43
  111. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  112. package/dist/workspace-runtime/production/content-changes.js +0 -36
  113. package/dist/workspace-runtime/production/contracts.js +0 -19
  114. package/dist/workspace-runtime/production/controller.js +0 -218
  115. package/dist/workspace-runtime/production/dependencies.js +0 -60
  116. package/dist/workspace-runtime/production/native.js +0 -212
  117. package/dist/workspace-runtime/production/processes.js +0 -102
  118. package/dist/workspace-runtime/production/save-command.js +0 -35
  119. package/dist/workspace-runtime/production/source-archive.js +0 -137
  120. package/dist/workspace-runtime/production/source-copy.js +0 -91
  121. package/dist/workspace-runtime/production/stages.js +0 -334
  122. package/dist/workspace-runtime/production/storage.js +0 -75
  123. package/dist/workspace-runtime/serve.js +0 -214
  124. package/dist/workspace-runtime/server/auth.js +0 -21
  125. package/dist/workspace-runtime/server/connectivity.js +0 -201
  126. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  127. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  128. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  129. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  130. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  131. package/dist/workspace-runtime/server/dispatch.js +0 -1217
  132. package/dist/workspace-runtime/server/endpoints.js +0 -21
  133. package/dist/workspace-runtime/server/execution-group.js +0 -90
  134. package/dist/workspace-runtime/server/http.js +0 -1243
  135. package/dist/workspace-runtime/server/lock.js +0 -53
  136. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  137. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  138. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  139. package/dist/workspace-runtime/server/types.js +0 -1
  140. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  141. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  142. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  143. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  144. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  145. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  146. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  147. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  148. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  149. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  150. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  151. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  152. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  153. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  154. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  155. package/dist/workspace-runtime/workspaces/directories.js +0 -133
  156. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  157. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  158. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  159. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  160. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  161. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  162. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  163. package/dist/workspace-runtime/workspaces/files.js +0 -120
  164. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  165. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  166. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  167. package/dist/workspace-runtime/workspaces/git.js +0 -670
  168. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  169. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  170. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  171. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  172. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  173. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  174. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  175. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  176. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  177. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  178. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  179. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  180. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  181. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  182. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  183. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  184. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  185. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  186. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  187. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  188. package/project-template-v2/.claude/agents/artist.md +0 -82
  189. package/project-template-v2/.claude/agents/developer.md +0 -153
  190. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  191. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  192. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  193. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  194. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  195. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  196. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  197. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  198. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  199. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  200. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  201. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  202. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  203. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  204. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  205. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  206. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  207. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  208. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  209. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  210. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  211. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  212. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  213. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  214. package/project-template-v2/.claude/settings.json +0 -33
  215. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  216. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  219. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  220. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  221. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  222. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  223. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  224. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  225. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  226. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  227. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  228. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  229. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  230. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  236. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  237. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  238. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  239. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  240. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  241. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  242. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  243. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  244. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  245. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  246. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  247. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  248. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  249. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  250. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  251. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  252. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  253. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  254. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  255. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  256. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  257. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  258. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  259. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  260. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  261. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  262. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  263. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  264. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  269. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  270. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  271. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  272. package/project-template-v2/.claude/snapshot.mjs +0 -263
  273. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  274. package/project-template-v2/CLAUDE.md +0 -146
  275. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  276. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  277. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  278. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  281. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  282. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  283. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  284. package/project-template-v2/assets/models/.gitkeep +0 -0
  285. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  286. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  287. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  288. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  289. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  290. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  291. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  292. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  293. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  294. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  295. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  296. package/project-template-v2/docs/project-state.json +0 -60
  297. package/project-template-v2/docs/project-state.md +0 -72
  298. package/project-template-v2/docs/standards/README.md +0 -225
  299. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  300. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  301. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  302. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  303. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  304. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  305. package/project-template-v2/game/index.ts +0 -18
  306. package/project-template-v2/globals.d.ts +0 -51
  307. package/project-template-v2/index.css +0 -34
  308. package/project-template-v2/index.html +0 -18
  309. package/project-template-v2/main.ts +0 -9
  310. package/project-template-v2/package.json +0 -46
  311. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  312. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  313. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  314. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  315. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  316. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  317. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  318. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  319. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  320. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  321. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  322. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  323. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  324. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  325. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  326. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  327. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  328. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  329. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  330. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  331. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  332. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  333. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  334. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  335. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  336. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  337. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  338. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  339. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  340. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  341. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  342. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  343. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  344. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  345. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  346. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  347. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  348. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  349. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  350. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  351. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  354. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  355. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  356. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  357. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  358. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  359. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  360. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  361. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  362. package/project-template-v2/tsconfig.json +0 -20
  363. package/project-template-v2/vite.config.ts +0 -27
  364. package/project-templates/batch-locks/phaser.yaml +0 -922
  365. package/project-templates/batch-locks/threejs.yaml +0 -978
  366. package/project-templates/empty/AGENTS.md +0 -41
  367. package/project-templates/empty/gitignore +0 -33
@@ -1,218 +0,0 @@
1
- import { mkdir, readFile, readdir, rename, writeFile } from 'node:fs/promises';
2
- import { join } from 'node:path';
3
- import { randomUUID } from 'node:crypto';
4
- import { execFile } from 'node:child_process';
5
- import { promisify } from 'node:util';
6
- import { hashOperationPayload } from '@playcraft/common/cloud-workspace/runtime';
7
- import { productionExecutionRequestSchema } from './contracts.js';
8
- import { executeProductionStage } from './stages.js';
9
- import { groupExited, stopProductionGroup } from './processes.js';
10
- import { workspaceDirectoryOccupied } from '../workspaces/directory-maintenance.js';
11
- import { settleDependencyInstalls } from '../workspaces/dependencies.js';
12
- import { verifyProductionLease } from './storage.js';
13
- const execute = promisify(execFile);
14
- const active = new WeakMap();
15
- const receiptsRoot = (state) => join(state.config.stateDir, 'production-receipts');
16
- const attemptPath = (state, id) => join(receiptsRoot(state), `${id}.attempt.json`);
17
- const receiptPath = (state, id, stage) => join(receiptsRoot(state), `${id}-${stage}.json`);
18
- async function read(path) {
19
- try {
20
- return JSON.parse(await readFile(path, 'utf8'));
21
- }
22
- catch (error) {
23
- if (error.code === 'ENOENT')
24
- return undefined;
25
- throw error;
26
- }
27
- }
28
- async function write(state, path, value) {
29
- await mkdir(receiptsRoot(state), { recursive: true, mode: 0o700 });
30
- const temporary = `${path}.${randomUUID()}.tmp`;
31
- await writeFile(temporary, JSON.stringify(value), { mode: 0o600 });
32
- await rename(temporary, path);
33
- }
34
- export async function productionCapability(state) {
35
- if (state.config.workspaceMode !== 'multi' || state.journal.destroyed())
36
- throw new Error('production_executor_unavailable');
37
- const command = process.env.PLAYCRAFT_PRODUCTION_CODEX_COMMAND ?? process.env.PLAYCRAFT_CODEX_COMMAND ?? 'codex';
38
- const binary = command.endsWith('.mjs') || command.endsWith('.js') ? process.execPath : command;
39
- await Promise.all([execute('git', ['--version']), execute('pnpm', ['--version']),
40
- execute(binary, binary === process.execPath ? [command, '--version'] : ['--version'])]);
41
- return { available: true, protocol: 1 };
42
- }
43
- export async function productionDirectoryBusy(state, workspaceId, directoryName = 'basic', excludeAttemptId, ignoreSourceCaptures = false) {
44
- if (!workspaceId)
45
- return false;
46
- const files = await readdir(receiptsRoot(state)).catch(error => {
47
- if (error.code === 'ENOENT')
48
- return [];
49
- throw error;
50
- });
51
- for (const file of files.filter(value => value.endsWith('.attempt.json'))) {
52
- const attempt = await read(join(receiptsRoot(state), file));
53
- // Missing attemptId is still occupancy. Comparing it with !== treats undefined !== undefined as "not this attempt".
54
- const excluded = excludeAttemptId !== undefined && attempt?.attemptId === excludeAttemptId;
55
- if (attempt && !excluded && !(ignoreSourceCaptures && attempt.sourceCapture)
56
- && !attempt.stopped && attempt.workspaceId === workspaceId && attempt.directoryName === directoryName)
57
- return true;
58
- }
59
- return false;
60
- }
61
- export async function executeSandboxProduction(state, raw) {
62
- const input = productionExecutionRequestSchema.parse(raw);
63
- if (input.task.environment !== state.config.environment || input.task.userId !== state.config.userId
64
- || input.generation !== state.config.generation || input.runtimeEpoch !== state.runtimeEpoch
65
- || input.lease.taskId !== input.task.taskId || input.lease.attemptId !== input.task.attemptId)
66
- throw new Error('production_scope_mismatch');
67
- return state.journal.exclusive(`directory:${input.task.workspaceId}:${input.directoryName}`, () => state.journal.exclusive(`production:${input.task.attemptId}`, async () => {
68
- const path = attemptPath(state, input.task.attemptId);
69
- let attempt = await read(path);
70
- if (attempt && (attempt.taskId !== input.task.taskId || attempt.workspaceId !== input.task.workspaceId
71
- || attempt.directoryName !== input.directoryName || attempt.fence > input.lease.fence
72
- || (attempt.fence === input.lease.fence && attempt.owner !== input.lease.owner)))
73
- throw new Error('production_scope_mismatch');
74
- if (input.action !== 'stage')
75
- return stopOrReconcile(state, input, attempt);
76
- if (!input.stage)
77
- throw new Error('invalid_production_stage');
78
- if (attempt?.stopped || attempt?.cancelling)
79
- return { status: 'failed', result: { error: 'production_execution_stopped' } };
80
- const file = receiptPath(state, input.task.attemptId, input.stage);
81
- const old = await read(file);
82
- const payloadHash = hashOperationPayload(input.payload);
83
- if (old) {
84
- if (old.payloadHash !== payloadHash)
85
- throw new Error('production_payload_conflict');
86
- // Existing intent only reports evidence. It never authorizes a second native turn.
87
- return { status: old.status, result: old.result };
88
- }
89
- if (active.get(state)?.has(input.task.attemptId))
90
- throw new Error('production_stage_still_running');
91
- await verifyProductionLease(input);
92
- if (!attempt) {
93
- if (input.stage === 'capture-source' || input.stage === 'prepare')
94
- await settleDependencyInstalls(state);
95
- if (state.journal.getWorkspace(input.task.workspaceId)?.directories?.some(directory => directory.directoryName === input.directoryName && directory.status === 'reclaimed'))
96
- throw new Error('production_directory_reclaimed');
97
- const manifest = input.task.payload.manifest;
98
- const sourceCapture = input.stage === 'capture-source' && manifest && typeof manifest === 'object'
99
- && 'executionMode' in manifest && manifest.executionMode === 'direct-source';
100
- if (!sourceCapture && await workspaceDirectoryOccupied(state, input.task.workspaceId, input.directoryName))
101
- throw new Error('production_directory_occupied');
102
- attempt = { taskId: input.task.taskId, attemptId: input.task.attemptId, workspaceId: input.task.workspaceId,
103
- directoryName: input.directoryName, owner: input.lease.owner, fence: input.lease.fence, stopped: false,
104
- ...(sourceCapture ? { sourceCapture: true } : {}) };
105
- }
106
- attempt.owner = input.lease.owner;
107
- attempt.fence = input.lease.fence;
108
- await write(state, path, attempt);
109
- const receipt = { status: 'unknown', result: { error: 'production_stage_running' },
110
- taskId: input.task.taskId, attemptId: input.task.attemptId, requestId: `${input.task.attemptId}:${input.stage}`,
111
- stage: input.stage, workspaceId: input.task.workspaceId, directoryName: input.directoryName,
112
- fence: input.lease.fence, payloadHash, startedAt: new Date().toISOString(), processes: [] };
113
- await write(state, file, receipt);
114
- const running = active.get(state) ?? new Map();
115
- active.set(state, running);
116
- const entry = { task: Promise.resolve(receipt), stops: [] };
117
- entry.task = runStage(state, input, receipt, entry).finally(() => running.delete(input.task.attemptId));
118
- running.set(input.task.attemptId, entry);
119
- // Returning from the lock lets stop and reconciliation reach the in-flight native group.
120
- return { status: 'unknown', result: { error: 'production_stage_running' } };
121
- })).then(async (result) => {
122
- const current = active.get(state)?.get(input.task.attemptId);
123
- return input.action === 'stage' && current ? current.task : result;
124
- });
125
- }
126
- async function runStage(state, input, receipt, running) {
127
- const file = receiptPath(state, input.task.attemptId, input.stage);
128
- let writes = Promise.resolve();
129
- const recordProcess = async (process) => {
130
- const at = receipt.processes.findIndex(value => value.pid === process.pid);
131
- if (at === -1)
132
- receipt.processes.push(process);
133
- else
134
- receipt.processes[at] = process;
135
- writes = writes.then(() => write(state, file, receipt));
136
- await writes;
137
- const attempt = await read(attemptPath(state, input.task.attemptId));
138
- if (attempt?.cancelling && !process.stopped) {
139
- process.stopped = await stopProductionGroup(process);
140
- throw new Error('production_execution_stopped');
141
- }
142
- };
143
- try {
144
- receipt.result = await executeProductionStage(state, input, recordProcess, stop => running.stops.push(stop));
145
- await verifyProductionLease(input);
146
- receipt.status = 'completed';
147
- }
148
- catch (error) {
149
- const code = error instanceof Error && /^[a-z0-9_]+$/.test(error.message) ? error.message : 'production_stage_failed';
150
- receipt.status = code.includes('unknown') || code.includes('unavailable') ? 'unknown' : 'failed';
151
- receipt.result = { error: code };
152
- }
153
- if (receipt.processes.some(process => !process.stopped && !groupExited(process.pid))) {
154
- receipt.status = 'unknown';
155
- receipt.result = { error: 'production_stop_unconfirmed' };
156
- }
157
- receipt.finishedAt = new Date().toISOString();
158
- await writes;
159
- await write(state, file, receipt);
160
- return { status: receipt.status, result: receipt.result };
161
- }
162
- async function attemptReceipts(state, attemptId) {
163
- const files = await readdir(receiptsRoot(state)).catch(error => {
164
- if (error.code === 'ENOENT')
165
- return [];
166
- throw error;
167
- });
168
- const receipts = [];
169
- for (const file of files.filter(value => value.startsWith(`${attemptId}-`) && value.endsWith('.json'))) {
170
- const receipt = await read(join(receiptsRoot(state), file));
171
- if (receipt)
172
- receipts.push(receipt);
173
- }
174
- return receipts;
175
- }
176
- async function stopOrReconcile(state, input, old) {
177
- const attempt = old ?? { taskId: input.task.taskId, attemptId: input.task.attemptId, workspaceId: input.task.workspaceId,
178
- directoryName: input.directoryName, owner: input.lease.owner, fence: input.lease.fence, stopped: false };
179
- attempt.owner = input.lease.owner;
180
- attempt.fence = input.lease.fence;
181
- attempt.cancelling = true;
182
- await write(state, attemptPath(state, attempt.attemptId), attempt);
183
- const running = active.get(state)?.get(attempt.attemptId);
184
- await Promise.allSettled(running?.stops.map(stop => stop()) ?? []);
185
- const receipts = await attemptReceipts(state, attempt.attemptId);
186
- // The stage owns receipt writes; an earlier snapshot must not overwrite its terminal receipt.
187
- for (const receipt of receipts) {
188
- for (const process of receipt.processes) {
189
- await stopProductionGroup(process);
190
- }
191
- }
192
- if (running)
193
- await Promise.race([running.task.catch(() => undefined), new Promise(resolve => setTimeout(resolve, 5000))]);
194
- const dispatchStopped = !active.get(state)?.has(attempt.attemptId);
195
- // A launch can publish its receipt after cancellation's first snapshot.
196
- const durable = await attemptReceipts(state, attempt.attemptId);
197
- // An unfinished receipt may omit a process whose registration could not be persisted.
198
- attempt.stopped = dispatchStopped && durable.every(receipt => Boolean(receipt.finishedAt)
199
- && receipt.processes.every(process => process.stopped || groupExited(process.pid)));
200
- await write(state, attemptPath(state, attempt.attemptId), attempt);
201
- return { status: attempt.stopped ? 'completed' : 'unknown', result: {
202
- executionStopped: attempt.stopped, managedWritesStopped: attempt.stopped,
203
- receipts: Object.fromEntries(durable.map(receipt => [receipt.stage, { status: receipt.status, result: receipt.result }])),
204
- } };
205
- }
206
- export async function sandboxProductionReceipt(state, operationId, identity) {
207
- if (!/^[a-f0-9-]{36}:(capture-source|prepare|generate|freeze|save|build|preview)$/.test(operationId))
208
- throw new Error('production_receipt_invalid');
209
- const [attemptId, stage] = operationId.split(':');
210
- const receipt = await read(receiptPath(state, attemptId, stage));
211
- if (!receipt || receipt.taskId !== identity.taskId || receipt.attemptId !== identity.attemptId || receipt.workspaceId !== identity.workspaceId
212
- || receipt.directoryName !== identity.directoryName || receipt.fence > identity.fence)
213
- throw new Error('production_receipt_scope_mismatch');
214
- const attempt = await read(attemptPath(state, identity.attemptId));
215
- if (!attempt || attempt.owner !== identity.owner || attempt.fence !== identity.fence)
216
- throw new Error('production_receipt_scope_mismatch');
217
- return { status: receipt.status, result: receipt.result };
218
- }
@@ -1,60 +0,0 @@
1
- import { readFile } from 'node:fs/promises';
2
- import { createHash } from 'node:crypto';
3
- import { join } from 'node:path';
4
- const LOCKS = [
5
- ['package-lock.json', 'npm'], ['npm-shrinkwrap.json', 'npm'], ['pnpm-lock.yaml', 'pnpm'],
6
- ['yarn.lock', 'yarn'], ['bun.lock', 'bun'], ['bun.lockb', 'bun'],
7
- ];
8
- const hash = (body) => createHash('sha256').update(body).digest('hex');
9
- async function optional(path) {
10
- try {
11
- return await readFile(path);
12
- }
13
- catch (error) {
14
- if (error.code === 'ENOENT')
15
- return undefined;
16
- throw error;
17
- }
18
- }
19
- /** Resolve one locked toolchain. A conflicting lock or floating declaration never silently selects npm. */
20
- export async function resolveProductionDependencies(root) {
21
- const packageBody = await readFile(join(root, 'package.json'));
22
- const pkg = JSON.parse(packageBody.toString());
23
- const bodies = new Map();
24
- const managers = new Set();
25
- for (const [name, manager] of LOCKS) {
26
- const body = await optional(join(root, name));
27
- if (body) {
28
- bodies.set(name, body);
29
- managers.add(manager);
30
- }
31
- }
32
- if (!managers.size)
33
- throw new Error('production_dependency_lock_required');
34
- if (managers.size !== 1)
35
- throw new Error('production_dependency_locks_conflict');
36
- const manager = [...managers][0];
37
- if (manager !== 'pnpm')
38
- throw new Error('production_pnpm_required_convert_first');
39
- const declared = typeof pkg.packageManager === 'string'
40
- ? /^(npm|pnpm|yarn|bun)@(\d+\.\d+\.\d+)(?:\+sha(?:224|512)\.[a-fA-F0-9]+)?$/.exec(pkg.packageManager) : undefined;
41
- if (pkg.packageManager !== undefined && !declared)
42
- throw new Error('production_package_manager_declaration_invalid');
43
- if (declared && declared[1] !== manager)
44
- throw new Error('production_package_manager_lock_mismatch');
45
- const modernYarn = false;
46
- const pnpmLock = bodies.get('pnpm-lock.yaml')?.toString();
47
- const oldPnpm = /^lockfileVersion:\s*['\"]?6(?:\.|['\"]?\s*$)/m.test(pnpmLock ?? '');
48
- const version = declared?.[2] ?? (oldPnpm ? '8.15.9' : '9.15.9');
49
- return { manager, version, reference: declared ? String(pkg.packageManager) : `${manager}@${version}`, modernYarn,
50
- locks: Object.fromEntries([...bodies].map(([name, body]) => [name, hash(body)])), packageDigest: hash(packageBody) };
51
- }
52
- export async function verifyProductionDependencyLocks(root, policy) {
53
- for (const [name] of LOCKS) {
54
- const body = await optional(join(root, name));
55
- if ((body ? hash(body) : undefined) !== policy.locks[name])
56
- throw new Error('production_dependency_lock_changed');
57
- }
58
- if (hash(await readFile(join(root, 'package.json'))) !== policy.packageDigest)
59
- throw new Error('production_dependency_manifest_changed');
60
- }
@@ -1,212 +0,0 @@
1
- import { join } from 'node:path';
2
- import { lstat, mkdir } from 'node:fs/promises';
3
- import { hashOperationPayload, operationScopeKey, productionSessionId, transitionOperation } from '@playcraft/common/cloud-workspace/runtime';
4
- import { createCodexAppServerAdapter } from '../codex/app-server.js';
5
- import { ingestCollected, publishSourceEvents, recordNativeEvents } from '../server/dispatch.js';
6
- import { verifyProductionLease } from './storage.js';
7
- import { processBirth, stopProductionGroup } from './processes.js';
8
- import { openDirectoryToDevelopment } from '../workspaces/directory-access.js';
9
- import { loadWorkspaceMcpConfig } from '../codex/mcp-config.js';
10
- export async function runProductionNative(state, input, root, record, track) {
11
- if (!input.model)
12
- throw new Error('production_model_configuration_required');
13
- const temporaryRoot = join(root, '.playcraft-temp');
14
- const existing = await lstat(temporaryRoot).catch(error => {
15
- if (error.code === 'ENOENT')
16
- return undefined;
17
- throw error;
18
- });
19
- if (existing && (!existing.isDirectory() || existing.isSymbolicLink()))
20
- throw new Error('production_source_path_invalid');
21
- await mkdir(temporaryRoot, { recursive: true });
22
- await openDirectoryToDevelopment(temporaryRoot, (await lstat(root)).gid);
23
- const groups = [];
24
- const adapter = createCodexAppServerAdapter({ config: { ...state.config, workspaceMode: 'single', workspaceRoot: root },
25
- command: process.env.PLAYCRAFT_PRODUCTION_CODEX_COMMAND,
26
- homeDir: process.env.PLAYCRAFT_LAUNCHER_SOCKET
27
- ? `/var/lib/playcraft/codex/production-${input.task.attemptId}` : join(state.config.stateDir, 'production-native', input.task.attemptId),
28
- model: input.model.model, processGroup: true,
29
- loadMcpConfig: () => loadWorkspaceMcpConfig(state, input.task.workspaceId),
30
- fixedExecution: { cwd: root, approvalPolicy: 'never', sandboxPolicy: { type: 'workspaceWrite', writableRoots: [root],
31
- networkAccess: true, excludeTmpdirEnvVar: true, excludeSlashTmp: true } },
32
- fixedThreadConfig: { model: input.model.model, modelProvider: 'playcraft_production', config: {
33
- approval_policy: 'never', sandbox_mode: 'workspace-write',
34
- 'sandbox_workspace_write.writable_roots': [root],
35
- 'sandbox_workspace_write.network_access': true,
36
- 'sandbox_workspace_write.exclude_tmpdir_env_var': true,
37
- 'sandbox_workspace_write.exclude_slash_tmp': true,
38
- 'shell_environment_policy.set': { PLAYCRAFT_TOOL_REQUEST_DIR: join(temporaryRoot, 'tool-requests'), PLAYCRAFT_SKIP_UPDATE_CHECK: '1',
39
- TMPDIR: temporaryRoot, npm_config_cache: join(temporaryRoot, 'npm-cache'), npm_config_store_dir: join(temporaryRoot, 'pnpm-store') },
40
- 'model_providers.playcraft_production': { name: 'PlayCraft Production', base_url: input.model.endpoint,
41
- wire_api: 'responses', requires_openai_auth: false, http_headers: { Authorization: `Bearer ${input.model.token}` } },
42
- } },
43
- onSkillProcessRestart: async (process) => {
44
- const group = { pid: process.pid, birth: await processBirth(process.pid), stopped: false };
45
- groups.push(group);
46
- await record(group);
47
- },
48
- });
49
- const sessionId = productionSessionId(input.task.attemptId);
50
- const prompt = String(input.payload.prompt ?? '');
51
- const now = new Date().toISOString();
52
- const operation = {
53
- operationId: `${input.task.attemptId}:generate`, clientRequestId: `${input.task.attemptId}:generate`,
54
- environment: input.task.environment, userId: input.task.userId, workspaceId: input.task.workspaceId,
55
- directoryName: input.directoryName, sessionId, kind: 'session.turn', status: 'dispatched',
56
- generation: state.config.generation, runtimeEpoch: state.runtimeEpoch,
57
- payloadHash: hashOperationPayload({ text: prompt }), createdAt: now, updatedAt: now,
58
- };
59
- const scopeKey = operationScopeKey(operation);
60
- let collecting = Promise.resolve();
61
- let notifying;
62
- let pendingNotifications = [];
63
- const notify = (events) => {
64
- // Notifications only wake the source archive; every event already belongs to the durable journal.
65
- pendingNotifications = [...pendingNotifications, ...events].slice(-100);
66
- notifying ??= (async () => {
67
- while (pendingNotifications.length) {
68
- const page = pendingNotifications;
69
- pendingNotifications = [];
70
- await publishSourceEvents(state, page);
71
- }
72
- })().finally(() => {
73
- notifying = undefined;
74
- if (pendingNotifications.length)
75
- notify([]);
76
- });
77
- };
78
- let archiveError;
79
- let shutdownError;
80
- let cancelled = false;
81
- let rootThreadId;
82
- let rootTurnId;
83
- let completedTurn;
84
- let timeout;
85
- let leaseCheck;
86
- let completion;
87
- const done = new Promise(resolve => { completion = resolve; });
88
- track(async () => {
89
- cancelled = true;
90
- completion('unknown');
91
- await adapter.close?.();
92
- await collecting;
93
- });
94
- const unsubscribe = adapter.onCollected?.(event => {
95
- if (event.kind === 'process_exit')
96
- completion('unknown');
97
- else {
98
- const params = event.params && typeof event.params === 'object'
99
- ? event.params : {};
100
- // The prompt is recorded before dispatch; Codex may echo the same user message afterward.
101
- if (params.item?.type !== 'userMessage' || params.threadId !== rootThreadId) {
102
- collecting = collecting.then(async () => notify(await ingestCollected(state, {
103
- ...event, params: { ...params, directoryName: input.directoryName },
104
- }, false))).catch(error => {
105
- archiveError ??= error;
106
- completion('unknown');
107
- });
108
- }
109
- }
110
- if (event.method === 'turn/completed') {
111
- const value = event.params;
112
- if (value.threadId === rootThreadId && value.turn?.id) {
113
- completedTurn = value.turn;
114
- if (value.turn.id === rootTurnId)
115
- completion(value.turn.status === 'completed' ? 'completed' : 'failed');
116
- }
117
- }
118
- });
119
- try {
120
- await adapter.start();
121
- const process = adapter.executionProcess?.();
122
- if (!process)
123
- throw new Error('production_process_not_started');
124
- const group = { pid: process.pid, birth: await processBirth(process.pid), stopped: false };
125
- groups.push(group);
126
- await record(group);
127
- const thread = await adapter.startThread({ sessionId, cwd: root });
128
- rootThreadId = thread.threadId;
129
- // A production thread lives in its own Codex home and must never resume through the main adapter.
130
- await state.journal.putSession({ sessionId, workspaceId: input.task.workspaceId, directoryName: input.directoryName,
131
- threadId: thread.threadId, cwd: root, recoverability: 'history_only', turnStatus: 'starting' });
132
- const creation = { ...operation, operationId: `${input.task.attemptId}:session.create`,
133
- clientRequestId: `${input.task.attemptId}:session.create`, kind: 'session.create', status: 'completed',
134
- payloadHash: hashOperationPayload({}), nativeThreadId: thread.threadId };
135
- await state.journal.putOperation(operationScopeKey(creation), creation);
136
- await state.journal.putOperation(scopeKey, { ...operation, nativeThreadId: thread.threadId });
137
- notify(await recordNativeEvents(state, creation, [{ type: 'session.created', occurredAt: now, payload: {
138
- sessionId, threadId: thread.threadId, batchId: input.task.batchId, attemptId: input.task.attemptId,
139
- taskId: input.task.taskId, readonly: true, recoverability: 'history_only',
140
- } }], false));
141
- notify(await recordNativeEvents(state, operation, [{ type: 'item/completed', occurredAt: now, payload: {
142
- item: { id: `${sessionId}-prompt`, type: 'userMessage', content: [{ type: 'text', text: prompt }] },
143
- } }], false));
144
- const turn = await adapter.startTurn({ sessionId, threadId: thread.threadId, text: prompt,
145
- clientRequestId: operation.clientRequestId, persistReservation: async ({ nativeRequestId }) => {
146
- await state.journal.putOperation(scopeKey, { ...operation, nativeThreadId: thread.threadId, nativeRequestId });
147
- } });
148
- if (turn.outcome !== 'accepted')
149
- throw new Error(turn.outcome === 'failed' ? 'production_native_failed' : 'production_native_start_unknown');
150
- rootTurnId = turn.turnId;
151
- const reserved = state.journal.getOperation(scopeKey);
152
- const released = await state.journal.bindTurn({ scopeKey, sessionId, threadId: thread.threadId, turnId: turn.turnId,
153
- operation: transitionOperation(reserved, 'accepted', { nativeThreadId: thread.threadId, nativeTurnId: turn.turnId }) });
154
- if (released.length)
155
- notify(released);
156
- if (completedTurn?.id === rootTurnId)
157
- completion(completedTurn.status === 'completed' ? 'completed' : 'failed');
158
- timeout = setTimeout(() => completion('unknown'), 30 * 60_000);
159
- let checking = false;
160
- let consecutiveLeaseFailures = 0;
161
- leaseCheck = setInterval(() => {
162
- if (checking)
163
- return;
164
- checking = true;
165
- void verifyProductionLease(input).then(() => { consecutiveLeaseFailures = 0; }).catch(async () => {
166
- consecutiveLeaseFailures += 1;
167
- if (consecutiveLeaseFailures >= 2) {
168
- completion('unknown');
169
- await adapter.close?.().catch(() => undefined);
170
- }
171
- }).finally(() => { checking = false; });
172
- }, 5000);
173
- const status = await done;
174
- if (status !== 'completed')
175
- throw new Error(status === 'failed' ? 'production_native_failed' : 'production_native_unknown');
176
- }
177
- finally {
178
- clearInterval(leaseCheck);
179
- clearTimeout(timeout);
180
- await adapter.close?.().catch(error => { shutdownError = error; });
181
- unsubscribe?.();
182
- await collecting;
183
- for (const group of groups)
184
- await record({ ...group, stopped: await stopProductionGroup(group) });
185
- const latest = state.journal.getOperation(scopeKey);
186
- if (latest && ['dispatched', 'accepted', 'uncertain'].includes(latest.status)) {
187
- const status = cancelled ? 'interrupted' : 'failed';
188
- await state.journal.putOperation(scopeKey, transitionOperation(latest, status, {
189
- error: cancelled ? 'production_execution_stopped' : 'production_native_unknown',
190
- }));
191
- const session = state.journal.getSession(sessionId);
192
- if (session) {
193
- await state.journal.putSession({ ...session, turnStatus: status, turnBlock: undefined });
194
- notify(await recordNativeEvents(state, latest, [{ type: `turn.${status}`, occurredAt: new Date().toISOString(),
195
- payload: { turnId: latest.nativeTurnId, error: cancelled ? 'production_execution_stopped' : 'production_native_unknown' } }], false));
196
- }
197
- }
198
- if (archiveError)
199
- throw new Error('production_chat_archive_failed');
200
- if (shutdownError) {
201
- const error = shutdownError;
202
- const known = new Set(['launcher_output_drain_unconfirmed', 'launcher_instance_changed',
203
- 'execution_identity_mismatch', 'launcher_request_timeout', 'launcher_connection_closed',
204
- 'codex_group_stop_unconfirmed', 'codex_stdio_stop_unconfirmed', 'EACCES', 'EPERM', 'ENOTEMPTY', 'EIO']);
205
- const reason = [error?.code, error?.message].find(value => typeof value === 'string' && known.has(value));
206
- // Exception text can contain credentials or command output; only fixed machine codes leave the guest.
207
- console.error(JSON.stringify({ event: 'production.native_shutdown_failed', taskId: input.task.taskId,
208
- attemptId: input.task.attemptId, stage: input.stage, reason: reason ?? 'unknown' }));
209
- throw new Error('production_native_stop_unknown');
210
- }
211
- }
212
- }
@@ -1,102 +0,0 @@
1
- import { spawn, execFile } from 'node:child_process';
2
- import { promisify } from 'node:util';
3
- import { readFile } from 'node:fs/promises';
4
- import { setTimeout as delay } from 'node:timers/promises';
5
- import { startLauncherProcess } from '../codex/launcher-client.js';
6
- export async function processBirth(pid) {
7
- if (process.platform !== 'linux') {
8
- return promisify(execFile)('ps', ['-p', String(pid), '-o', 'lstart='], { timeout: 2000 }).then(value => value.stdout.trim() || undefined, () => undefined);
9
- }
10
- try {
11
- const stat = await readFile(`/proc/${pid}/stat`, 'utf8');
12
- return stat.slice(stat.lastIndexOf(')') + 2).split(' ')[19];
13
- }
14
- catch {
15
- return undefined;
16
- }
17
- }
18
- export function groupExited(pid) {
19
- try {
20
- process.kill(-pid, 0);
21
- return false;
22
- }
23
- catch (error) {
24
- return error.code === 'ESRCH';
25
- }
26
- }
27
- export async function stopProductionGroup(record) {
28
- if (record.stopped || groupExited(record.pid))
29
- return true;
30
- if (record.birth && await processBirth(record.pid) !== record.birth)
31
- return false;
32
- for (const signal of ['SIGTERM', 'SIGKILL']) {
33
- try {
34
- process.kill(-record.pid, signal);
35
- }
36
- catch { /* Recheck whether the whole group exited. */ }
37
- const deadline = Date.now() + 2000;
38
- while (Date.now() < deadline) {
39
- if (groupExited(record.pid))
40
- return true;
41
- await delay(25);
42
- }
43
- }
44
- return groupExited(record.pid);
45
- }
46
- /** Only the save stage receives repository credentials; build and install receive none. */
47
- export async function runProductionCommand(state, input) {
48
- const launcher = !input.trusted ? process.env.PLAYCRAFT_LAUNCHER_SOCKET : undefined;
49
- const launched = launcher ? await startLauncherProcess({ socketPath: launcher, processId: input.processId,
50
- runtimeEpoch: state.runtimeEpoch, argv: ['/usr/bin/bash', '-lc', input.command], cwd: input.cwd, env: input.env ?? {} }) : undefined;
51
- const local = launched ? undefined : spawn('bash', ['-lc', input.command], { cwd: input.cwd,
52
- env: { PATH: process.env.PATH, HOME: state.config.stateDir, ...input.env }, detached: true, stdio: ['ignore', 'pipe', 'pipe'] });
53
- const exited = new Promise(resolve => {
54
- if (launched)
55
- launched.onExit(resolve);
56
- else {
57
- local.once('error', () => resolve(undefined));
58
- local.once('close', resolve);
59
- }
60
- });
61
- const pid = launched?.pid ?? local?.pid;
62
- if (!pid)
63
- throw new Error('production_process_not_started');
64
- const record = { pid, birth: await processBirth(pid), stopped: false };
65
- let output = '';
66
- const collect = (chunk) => { output = (output + String(chunk)).slice(-64 * 1024); };
67
- (launched?.stdout ?? local.stdout).on('data', collect);
68
- (launched?.stderr ?? local.stderr).on('data', collect);
69
- launched?.stdin?.end();
70
- let stopping;
71
- const stop = () => stopping ??= launched
72
- ? launched.stop().then(() => true, () => false)
73
- : stopProductionGroup(record);
74
- // Register before persisting: cancellation can arrive while the launch receipt is written.
75
- input.track(async () => {
76
- if (await stop()) {
77
- record.stopped = true;
78
- await input.record(record);
79
- }
80
- });
81
- let timedOut = false;
82
- let timeout;
83
- try {
84
- await input.record(record);
85
- const code = await Promise.race([exited, new Promise(resolve => {
86
- timeout = setTimeout(() => {
87
- timedOut = true;
88
- void stop().then(() => resolve(undefined), () => resolve(undefined));
89
- }, input.timeoutMs);
90
- })]);
91
- const stopped = await stop();
92
- await input.record({ ...record, stopped });
93
- return { code: timedOut ? undefined : code, output, stopped };
94
- }
95
- catch (error) {
96
- record.stopped = await stop();
97
- throw error;
98
- }
99
- finally {
100
- clearTimeout(timeout);
101
- }
102
- }
@@ -1,35 +0,0 @@
1
- export function productionSaveCommand() {
2
- return `set -eu
3
- status=0
4
- remote=$(git -c protocol.version=0 -c core.hooksPath=/dev/null ls-remote --exit-code --heads "$PRODUCTION_REPOSITORY" "refs/heads/$PRODUCTION_BRANCH") || status=$?
5
- if [ "$status" != 0 ] && [ "$status" != 2 ]; then exit "$status"; fi
6
- if [ "\${PRODUCTION_EXPECTED_PARENT+x}" = x ]; then
7
- actual=$(printf '%s' "$remote" | cut -f1)
8
- test "$actual" = "$PRODUCTION_EXPECTED_PARENT" || { printf 'production_git_parent_changed\\n' >&2; exit 1; }
9
- fi
10
- if [ -n "$remote" ]; then
11
- parent=$(printf '%s' "$remote" | cut -f1)
12
- git -c protocol.version=0 -c core.hooksPath=/dev/null fetch --no-tags --no-recurse-submodules "$PRODUCTION_REPOSITORY" "refs/heads/$PRODUCTION_BRANCH"
13
- test "$(git rev-parse FETCH_HEAD)" = "$parent"
14
- git -c core.hooksPath=/dev/null -c core.fsmonitor=false reset --soft FETCH_HEAD
15
- fi
16
- git -c core.hooksPath=/dev/null -c core.fsmonitor=false add -A .
17
- if [ -n "$(git ls-files -- .playcraft.json playcraft.config.json ':(glob)**/.playcraft.json' ':(glob)**/playcraft.config.json')" ]; then
18
- printf 'production_git_private_path\\n' >&2
19
- exit 1
20
- fi
21
- git diff --cached --quiet || git -c core.hooksPath=/dev/null commit -m "Save generated engineering"
22
- git -c protocol.version=0 -c core.hooksPath=/dev/null -c remote.origin.url="$PRODUCTION_REPOSITORY" -c remote.origin.pushurl="$PRODUCTION_REPOSITORY" push --set-upstream origin HEAD:"refs/heads/$PRODUCTION_BRANCH"
23
- git rev-parse HEAD`;
24
- }
25
- /** Commits generated engineering locally inside the sandbox without pushing a branch to remote origin. */
26
- export function productionLocalCommitCommand() {
27
- return `set -eu
28
- git -c core.hooksPath=/dev/null -c core.fsmonitor=false add -A .
29
- if [ -n "$(git ls-files -- .playcraft.json playcraft.config.json ':(glob)**/.playcraft.json' ':(glob)**/playcraft.config.json')" ]; then
30
- printf 'production_git_private_path\\n' >&2
31
- exit 1
32
- fi
33
- git diff --cached --quiet || git -c core.hooksPath=/dev/null commit -m "Save generated engineering"
34
- git rev-parse HEAD`;
35
- }