@playcraft/cli 0.1.40-beta → 0.1.41-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 (368) 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 +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 -185
  22. package/dist/utils/image-asset-context.js +228 -0
  23. package/dist/utils/playcraft-http-client.js +4 -6
  24. package/package.json +3 -13
  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 -87
  50. package/dist/commands/video.js +0 -111
  51. package/dist/commands/workspace-runtime.js +0 -54
  52. package/dist/commands/workspace.js +0 -35
  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/tool-operation-journal.js +0 -124
  75. package/dist/utils/video-evidence-git.js +0 -81
  76. package/dist/video-replication/client.js +0 -222
  77. package/dist/video-replication/comparison-evidence.js +0 -149
  78. package/dist/video-replication/comparison-files.js +0 -57
  79. package/dist/video-replication/comparison-log.js +0 -72
  80. package/dist/video-replication/comparison-messages.js +0 -104
  81. package/dist/video-replication/comparison-output.js +0 -63
  82. package/dist/video-replication/comparison-preflight.js +0 -66
  83. package/dist/video-replication/comparison.js +0 -216
  84. package/dist/video-replication/evidence.js +0 -165
  85. package/dist/video-replication/media.js +0 -111
  86. package/dist/video-replication/messages.js +0 -89
  87. package/dist/workspace/messages.js +0 -35
  88. package/dist/workspace/transfer-client.js +0 -174
  89. package/dist/workspace-runtime/codex/app-server.js +0 -1040
  90. package/dist/workspace-runtime/codex/compact.js +0 -46
  91. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  92. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  93. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  94. package/dist/workspace-runtime/codex/loopback.js +0 -146
  95. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  96. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  97. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  98. package/dist/workspace-runtime/codex/permissions.js +0 -70
  99. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  100. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  101. package/dist/workspace-runtime/codex/ui-tools.js +0 -183
  102. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  103. package/dist/workspace-runtime/main.js +0 -10
  104. package/dist/workspace-runtime/persistence/journal.js +0 -365
  105. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  106. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  107. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  108. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  109. package/dist/workspace-runtime/previews/output.js +0 -36
  110. package/dist/workspace-runtime/previews/publish.js +0 -262
  111. package/dist/workspace-runtime/previews/single-file.js +0 -43
  112. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  113. package/dist/workspace-runtime/production/content-changes.js +0 -36
  114. package/dist/workspace-runtime/production/contracts.js +0 -19
  115. package/dist/workspace-runtime/production/controller.js +0 -218
  116. package/dist/workspace-runtime/production/dependencies.js +0 -60
  117. package/dist/workspace-runtime/production/native.js +0 -212
  118. package/dist/workspace-runtime/production/processes.js +0 -102
  119. package/dist/workspace-runtime/production/save-command.js +0 -35
  120. package/dist/workspace-runtime/production/source-archive.js +0 -137
  121. package/dist/workspace-runtime/production/source-copy.js +0 -91
  122. package/dist/workspace-runtime/production/stages.js +0 -334
  123. package/dist/workspace-runtime/production/storage.js +0 -75
  124. package/dist/workspace-runtime/serve.js +0 -214
  125. package/dist/workspace-runtime/server/auth.js +0 -21
  126. package/dist/workspace-runtime/server/connectivity.js +0 -201
  127. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  128. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  129. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  130. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  131. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  132. package/dist/workspace-runtime/server/dispatch.js +0 -1217
  133. package/dist/workspace-runtime/server/endpoints.js +0 -21
  134. package/dist/workspace-runtime/server/execution-group.js +0 -90
  135. package/dist/workspace-runtime/server/http.js +0 -1243
  136. package/dist/workspace-runtime/server/lock.js +0 -53
  137. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  138. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  139. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  140. package/dist/workspace-runtime/server/types.js +0 -1
  141. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  142. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  143. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  144. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  145. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  146. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  147. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  148. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  149. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  150. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  151. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  152. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  153. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  154. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  155. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  156. package/dist/workspace-runtime/workspaces/directories.js +0 -133
  157. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  158. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  159. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  160. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  161. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  162. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  163. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  164. package/dist/workspace-runtime/workspaces/files.js +0 -138
  165. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  166. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  167. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  168. package/dist/workspace-runtime/workspaces/git.js +0 -670
  169. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  170. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  171. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  172. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  173. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  174. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  175. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  176. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  177. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  178. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  179. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  180. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  181. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  182. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  183. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  184. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  185. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  186. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  187. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  188. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  189. package/project-template-v2/.claude/agents/artist.md +0 -82
  190. package/project-template-v2/.claude/agents/developer.md +0 -153
  191. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  192. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  193. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  194. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  195. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  196. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  197. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  198. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  199. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  200. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  201. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  202. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  203. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  204. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  205. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  206. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  207. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  208. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  209. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  210. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  211. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  212. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  213. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  214. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  215. package/project-template-v2/.claude/settings.json +0 -33
  216. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  219. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  220. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  221. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  222. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  223. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  224. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  225. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  226. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  227. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  228. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  229. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  230. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  236. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  237. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  238. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  239. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  240. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  241. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  242. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  243. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  244. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  245. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  246. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  247. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  248. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  249. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  250. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  251. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  252. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  253. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  254. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  255. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  256. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  257. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  258. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  259. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  260. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  261. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  262. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  263. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  264. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  269. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  270. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  271. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  272. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  273. package/project-template-v2/.claude/snapshot.mjs +0 -263
  274. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  275. package/project-template-v2/CLAUDE.md +0 -146
  276. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  277. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  278. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  281. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  282. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  283. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  284. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  285. package/project-template-v2/assets/models/.gitkeep +0 -0
  286. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  287. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  288. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  289. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  290. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  291. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  292. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  293. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  294. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  295. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  296. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  297. package/project-template-v2/docs/project-state.json +0 -60
  298. package/project-template-v2/docs/project-state.md +0 -72
  299. package/project-template-v2/docs/standards/README.md +0 -225
  300. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  301. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  302. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  303. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  304. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  305. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  306. package/project-template-v2/game/index.ts +0 -18
  307. package/project-template-v2/globals.d.ts +0 -51
  308. package/project-template-v2/index.css +0 -34
  309. package/project-template-v2/index.html +0 -18
  310. package/project-template-v2/main.ts +0 -9
  311. package/project-template-v2/package.json +0 -46
  312. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  313. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  314. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  315. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  316. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  317. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  318. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  319. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  320. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  321. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  322. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  323. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  324. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  325. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  326. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  327. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  328. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  329. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  330. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  331. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  332. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  333. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  334. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  335. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  336. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  337. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  338. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  339. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  340. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  341. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  342. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  343. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  344. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  345. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  346. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  347. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  348. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  349. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  350. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  351. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  354. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  355. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  356. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  357. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  358. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  359. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  360. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  361. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  362. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  363. package/project-template-v2/tsconfig.json +0 -20
  364. package/project-template-v2/vite.config.ts +0 -27
  365. package/project-templates/batch-locks/phaser.yaml +0 -922
  366. package/project-templates/batch-locks/threejs.yaml +0 -978
  367. package/project-templates/empty/AGENTS.md +0 -41
  368. 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
- }