@playcraft/cli 0.1.27 → 0.1.29

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 (314) hide show
  1. package/README.md +3 -38
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build.js +4 -9
  5. package/dist/commands/create.js +33 -26
  6. package/dist/commands/image.js +6 -2
  7. package/dist/commands/login.js +42 -84
  8. package/dist/commands/skills.js +0 -2
  9. package/dist/commands/tools-3d.js +0 -11
  10. package/dist/commands/tools-generation.js +109 -68
  11. package/dist/commands/tools-image-context.js +23 -0
  12. package/dist/commands/tools.js +2 -2
  13. package/dist/config.js +4 -59
  14. package/dist/index.js +3 -34
  15. package/dist/remix/clone.js +0 -2
  16. package/dist/remix/init-template.js +0 -2
  17. package/dist/remix/pull.js +0 -2
  18. package/dist/remix/push.js +1 -21
  19. package/dist/utils/agent-api-client.js +30 -185
  20. package/dist/utils/image-asset-context.js +105 -0
  21. package/dist/utils/playcraft-http-client.js +4 -6
  22. package/package.json +5 -14
  23. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +81 -23
  24. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +81 -23
  25. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +81 -23
  26. package/dist/auth/account-activation.js +0 -157
  27. package/dist/auth/messages.js +0 -30
  28. package/dist/commands/platform-skills.generated.js +0 -19
  29. package/dist/commands/playable.js +0 -53
  30. package/dist/commands/tools-batch.js +0 -87
  31. package/dist/commands/video.js +0 -111
  32. package/dist/commands/workspace-runtime.js +0 -54
  33. package/dist/project-skills/builtin-import.js +0 -225
  34. package/dist/project-skills/commands.js +0 -77
  35. package/dist/project-skills/lifecycle.js +0 -28
  36. package/dist/project-skills/local-run.js +0 -112
  37. package/dist/project-skills/local-store.js +0 -221
  38. package/dist/project-skills/messages.js +0 -80
  39. package/dist/project-skills/reconcile.js +0 -62
  40. package/dist/project-skills/remote-cache.js +0 -51
  41. package/dist/project-skills/validation.js +0 -19
  42. package/dist/recording/messages.js +0 -40
  43. package/dist/recording/project-digest.js +0 -85
  44. package/dist/recording/recorder.js +0 -293
  45. package/dist/recording/scenario.js +0 -50
  46. package/dist/utils/environment-endpoints.js +0 -17
  47. package/dist/utils/tool-operation-journal.js +0 -124
  48. package/dist/utils/video-evidence-git.js +0 -81
  49. package/dist/video-replication/client.js +0 -222
  50. package/dist/video-replication/comparison-evidence.js +0 -149
  51. package/dist/video-replication/comparison-files.js +0 -57
  52. package/dist/video-replication/comparison-log.js +0 -72
  53. package/dist/video-replication/comparison-messages.js +0 -104
  54. package/dist/video-replication/comparison-output.js +0 -63
  55. package/dist/video-replication/comparison-preflight.js +0 -66
  56. package/dist/video-replication/comparison.js +0 -216
  57. package/dist/video-replication/evidence.js +0 -165
  58. package/dist/video-replication/media.js +0 -111
  59. package/dist/video-replication/messages.js +0 -89
  60. package/dist/workspace-runtime/codex/app-server.js +0 -636
  61. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  62. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -123
  63. package/dist/workspace-runtime/codex/launcher-client.js +0 -163
  64. package/dist/workspace-runtime/codex/loopback.js +0 -143
  65. package/dist/workspace-runtime/codex/model-broker.js +0 -258
  66. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  67. package/dist/workspace-runtime/main.js +0 -10
  68. package/dist/workspace-runtime/persistence/journal.js +0 -355
  69. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  70. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  71. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1057
  72. package/dist/workspace-runtime/previews/publish.js +0 -259
  73. package/dist/workspace-runtime/previews/single-file.js +0 -43
  74. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  75. package/dist/workspace-runtime/production/contracts.js +0 -17
  76. package/dist/workspace-runtime/production/controller.js +0 -207
  77. package/dist/workspace-runtime/production/dependencies.js +0 -60
  78. package/dist/workspace-runtime/production/native.js +0 -90
  79. package/dist/workspace-runtime/production/processes.js +0 -86
  80. package/dist/workspace-runtime/production/save-command.js +0 -24
  81. package/dist/workspace-runtime/production/source-copy.js +0 -91
  82. package/dist/workspace-runtime/production/stages.js +0 -202
  83. package/dist/workspace-runtime/production/storage.js +0 -32
  84. package/dist/workspace-runtime/serve.js +0 -202
  85. package/dist/workspace-runtime/server/auth.js +0 -21
  86. package/dist/workspace-runtime/server/connectivity.js +0 -201
  87. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  88. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  89. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  90. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  91. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  92. package/dist/workspace-runtime/server/dispatch.js +0 -903
  93. package/dist/workspace-runtime/server/endpoints.js +0 -19
  94. package/dist/workspace-runtime/server/execution-group.js +0 -85
  95. package/dist/workspace-runtime/server/http.js +0 -984
  96. package/dist/workspace-runtime/server/lock.js +0 -53
  97. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  98. package/dist/workspace-runtime/server/terminal-host.js +0 -294
  99. package/dist/workspace-runtime/server/types.js +0 -1
  100. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  101. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -195
  102. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  103. package/dist/workspace-runtime/workspaces/artifacts.js +0 -260
  104. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -111
  105. package/dist/workspace-runtime/workspaces/attachments.js +0 -175
  106. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  107. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  108. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  109. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  110. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  111. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  112. package/dist/workspace-runtime/workspaces/directories.js +0 -113
  113. package/dist/workspace-runtime/workspaces/directory-access.js +0 -29
  114. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  115. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  116. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  117. package/dist/workspace-runtime/workspaces/empty-template.js +0 -40
  118. package/dist/workspace-runtime/workspaces/files.js +0 -120
  119. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  120. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  121. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  122. package/dist/workspace-runtime/workspaces/git.js +0 -517
  123. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  124. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  125. package/dist/workspace-runtime/workspaces/prepare.js +0 -264
  126. package/dist/workspace-runtime/workspaces/registry.js +0 -226
  127. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  128. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -91
  129. package/dist/workspace-runtime/workspaces/skills.js +0 -189
  130. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  131. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  132. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  133. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  134. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  135. package/project-template-v2/.claude/agents/artist.md +0 -82
  136. package/project-template-v2/.claude/agents/developer.md +0 -153
  137. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  138. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  139. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  140. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  141. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  142. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  143. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  144. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  145. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  146. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  147. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  148. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  149. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  150. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  151. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  152. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  153. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  154. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  155. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  156. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  157. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  158. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  159. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  160. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  161. package/project-template-v2/.claude/settings.json +0 -33
  162. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  163. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  164. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  165. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  166. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  167. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  168. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  169. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  170. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  171. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  172. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  173. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  174. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  175. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  176. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  177. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  178. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  179. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  180. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  181. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  182. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  183. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  184. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  185. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  186. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  187. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  188. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  189. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  190. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  191. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  192. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  193. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  194. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  195. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  196. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  197. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  198. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  199. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  200. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  201. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  202. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  203. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  204. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  205. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  206. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  207. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  208. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  209. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  210. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  211. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  212. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  213. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  214. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  215. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  216. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  217. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  218. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  219. package/project-template-v2/.claude/snapshot.mjs +0 -263
  220. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  221. package/project-template-v2/CLAUDE.md +0 -146
  222. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  223. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  224. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  225. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  226. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  227. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  228. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  229. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  230. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  231. package/project-template-v2/assets/models/.gitkeep +0 -0
  232. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  233. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  234. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  235. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  236. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  237. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  238. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  239. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  240. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  241. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  242. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  243. package/project-template-v2/docs/project-state.json +0 -60
  244. package/project-template-v2/docs/project-state.md +0 -72
  245. package/project-template-v2/docs/standards/README.md +0 -225
  246. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  247. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  248. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  249. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  250. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  251. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  252. package/project-template-v2/game/index.ts +0 -18
  253. package/project-template-v2/globals.d.ts +0 -51
  254. package/project-template-v2/index.css +0 -34
  255. package/project-template-v2/index.html +0 -18
  256. package/project-template-v2/main.ts +0 -9
  257. package/project-template-v2/package.json +0 -46
  258. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  259. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  260. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  261. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  262. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  263. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  264. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  265. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  266. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  267. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  268. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  269. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  270. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  271. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  272. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  273. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  274. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  275. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  276. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  277. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  278. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  279. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  280. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  281. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  282. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  283. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  284. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  285. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  286. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  287. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  288. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  289. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  290. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  291. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  292. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  293. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  294. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  295. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  296. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  297. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  298. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  299. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  300. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  301. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  302. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  303. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  304. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  305. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  306. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  307. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  308. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  309. package/project-template-v2/tsconfig.json +0 -20
  310. package/project-template-v2/vite.config.ts +0 -27
  311. package/project-templates/batch-locks/phaser.yaml +0 -922
  312. package/project-templates/batch-locks/threejs.yaml +0 -978
  313. package/project-templates/empty/AGENTS.md +0 -25
  314. package/project-templates/empty/gitignore +0 -33
@@ -1,259 +0,0 @@
1
- import { createHash } from 'node:crypto';
2
- import { spawn } from 'node:child_process';
3
- import { platformEndpoint } from '@playcraft/common/cloud-workspace/runtime';
4
- import { constants } from 'node:fs';
5
- import { lstat, open, readdir, rm } from 'node:fs/promises';
6
- import { join } from 'node:path';
7
- import { PREVIEW_HTML_MAX_BYTES, PREVIEW_LOG_TAIL_MAX, previewPublishResultSchema, previewReservationSchema, transitionOperation, } from '@playcraft/common/cloud-workspace/runtime';
8
- import { excludeFromGit, readDependencies, scheduleDependencyInstall, } from '../workspaces/dependencies.js';
9
- import { runDeveloperCommand } from '../workspaces/developer-command.js';
10
- import { revisionScope, workspaceRoot } from '../workspaces/registry.js';
11
- import { classifyPreviewOutput, findExternalLocalReferences } from './single-file.js';
12
- const BUILD_TIMEOUT_MS = 10 * 60_000;
13
- /** Build output and the builder's own scratch folder live in the checkout, hidden from Git. */
14
- const OUTPUT_FOLDER = '.playcraft-preview-out';
15
- const BUILDER_TEMP_FOLDER = '.playcraft-temp';
16
- /**
17
- * The generic single-file build. `--mode full` keeps the builder from asking which stages to run.
18
- * Group-writable output lets the control user, a member of the development group, remove it.
19
- */
20
- const BUILD_COMMAND = 'umask 002 && playcraft build --mode full --platform playcraft --format html';
21
- class PreviewFailure extends Error {
22
- code;
23
- constructor(code) {
24
- super(code);
25
- this.code = code;
26
- }
27
- }
28
- const running = new WeakMap();
29
- /**
30
- * Checks what can be checked before the operation is accepted. The build itself runs later in
31
- * `runPreviewPublish`; the dispatch request returns as soon as the operation is accepted.
32
- */
33
- export async function previewWorkspaceRoot(state, operation) {
34
- if (!operation.workspaceId || !/^[A-Za-z0-9_-]+$/.test(operation.operationId)) {
35
- throw new PreviewFailure('invalid_preview_publish');
36
- }
37
- if (operation.sessionId !== undefined) {
38
- const session = state.journal.getSession(operation.sessionId);
39
- if (!session || (state.config.workspaceMode === 'multi' && (session.workspaceId !== operation.workspaceId || (session.directoryName ?? 'basic') !== (operation.directoryName ?? 'basic')))) {
40
- throw new PreviewFailure('session_workspace_mismatch');
41
- }
42
- }
43
- return workspaceRoot(state, operation.workspaceId, operation.directoryName);
44
- }
45
- /** Tracks a background publish so tests and shutdown can wait for it. */
46
- export function trackPreviewPublish(state, task) {
47
- const tasks = running.get(state) ?? new Set();
48
- running.set(state, tasks);
49
- const tracked = task.finally(() => tasks.delete(tracked));
50
- tasks.add(tracked);
51
- }
52
- export async function settlePreviewPublishes(state) {
53
- await Promise.all([...(running.get(state) ?? [])]);
54
- }
55
- /** A publish cut off by a restart has no build left running; it is closed rather than left accepted. */
56
- export async function recoverInterruptedPreviews(journal) {
57
- for (const { scopeKey, operation } of journal.listOperations()) {
58
- if (operation.kind !== 'preview.publish' || operation.status !== 'accepted')
59
- continue;
60
- await journal.putOperation(scopeKey, transitionOperation(operation, 'interrupted', { error: 'preview_interrupted' }));
61
- }
62
- }
63
- export async function runPreviewPublish(state, operation, root) {
64
- const workspaceId = operation.workspaceId;
65
- const scope = operation.sessionId === undefined
66
- ? {}
67
- : { sessionId: operation.sessionId, clientRequestId: operation.clientRequestId };
68
- const outputDir = join(root, OUTPUT_FOLDER, operation.operationId);
69
- const output = { log: '' };
70
- try {
71
- await ensureDependencies(state, revisionScope(state, workspaceId, operation.directoryName) ?? workspaceId, root, output);
72
- await excludeFromGit(root, `/${OUTPUT_FOLDER}/`);
73
- await excludeFromGit(root, `/${BUILDER_TEMP_FOLDER}/`);
74
- await buildPreview(state, root, outputDir, operation.operationId, output);
75
- const bytes = await readSingleHtml(outputDir);
76
- if (bytes.byteLength > PREVIEW_HTML_MAX_BYTES)
77
- throw new PreviewFailure('preview_not_single_file');
78
- if (findExternalLocalReferences(bytes.toString('utf8')).length > 0) {
79
- throw new PreviewFailure('preview_not_single_file');
80
- }
81
- const contentDigest = createHash('sha256').update(bytes).digest('hex');
82
- const contentMd5 = createHash('md5').update(bytes).digest('base64');
83
- const source = await sourceRevision(root);
84
- const reserved = previewReservationSchema.parse(await postControl(state, '/runtime/internal/preview-reservations', {
85
- workspaceId,
86
- directoryName: operation.directoryName ?? 'basic',
87
- ...scope,
88
- operationId: operation.operationId,
89
- contentDigest,
90
- contentMd5,
91
- sizeBytes: bytes.byteLength,
92
- gitHead: source.head,
93
- dirty: source.dirty,
94
- cliVersion: state.config.cliVersion,
95
- }));
96
- if (reserved.sessionId !== operation.sessionId)
97
- throw new PreviewFailure('preview_scope_mismatch');
98
- if (!reserved.alreadyUploaded) {
99
- const uploaded = await fetch(reserved.uploadUrl, {
100
- method: 'PUT',
101
- redirect: 'error',
102
- signal: AbortSignal.timeout(120_000),
103
- headers: {
104
- 'content-type': 'text/html; charset=utf-8',
105
- 'content-md5': contentMd5,
106
- 'content-length': String(bytes.byteLength),
107
- },
108
- body: new Uint8Array(bytes),
109
- });
110
- await uploaded.body?.cancel();
111
- if (!uploaded.ok)
112
- throw new PreviewFailure('preview_upload_failed');
113
- }
114
- const published = previewPublishResultSchema.parse(await postControl(state, '/runtime/internal/preview-completions', {
115
- workspaceId,
116
- directoryName: operation.directoryName ?? 'basic',
117
- ...scope,
118
- operationId: operation.operationId,
119
- artifactId: reserved.artifactId,
120
- expectedPublishRevision: reserved.expectedPublishRevision,
121
- logTail: tail(output.log),
122
- }));
123
- if (published.sessionId !== operation.sessionId || published.previewId !== reserved.previewId ||
124
- published.artifactId !== reserved.artifactId) {
125
- throw new PreviewFailure('preview_scope_mismatch');
126
- }
127
- if (published.status === 'conflict')
128
- throw new PreviewFailure('publish_conflict');
129
- return published;
130
- }
131
- catch (error) {
132
- const code = error instanceof PreviewFailure ? error.code : 'preview_build_failed';
133
- if (code !== 'publish_conflict') {
134
- await postControl(state, '/runtime/internal/preview-failures', {
135
- workspaceId,
136
- directoryName: operation.directoryName ?? 'basic',
137
- ...scope,
138
- operationId: operation.operationId,
139
- error: code,
140
- logTail: tail(output.log || (error instanceof Error ? error.message : '')),
141
- }).catch(() => undefined);
142
- }
143
- throw new PreviewFailure(code);
144
- }
145
- finally {
146
- await rm(outputDir, { recursive: true, force: true }).catch(() => undefined);
147
- }
148
- }
149
- export function previewFailureCode(error) {
150
- const code = error instanceof PreviewFailure
151
- ? error.code
152
- : error instanceof Error && /^[a-z_]+$/.test(error.message)
153
- ? error.message
154
- : 'preview_build_failed';
155
- return code.slice(0, 256);
156
- }
157
- /**
158
- * Checks the install against the current manifest and lockfile before building, so a package
159
- * Codex added since the workspace opened is installed first. A running install is joined rather
160
- * than started twice; a failed one is retried once here.
161
- */
162
- async function ensureDependencies(state, workspaceId, root, output) {
163
- await scheduleDependencyInstall(state, workspaceId, root);
164
- const dependencies = readDependencies(state, workspaceId);
165
- if (dependencies.status !== 'ready' && dependencies.status !== 'none') {
166
- output.log = [dependencies.error, dependencies.logTail].filter(Boolean).join('\n');
167
- throw new PreviewFailure('dependencies_not_ready');
168
- }
169
- }
170
- async function buildPreview(state, root, outputDir, operationId, output) {
171
- // Tests replace the build; the real one needs a project and the published CLI.
172
- const planned = process.env.PLAYCRAFT_PREVIEW_BUILD_COMMAND || BUILD_COMMAND;
173
- const outcome = await runDeveloperCommand(state, {
174
- processId: `preview-${operationId}`,
175
- cwd: root,
176
- command: `${planned} --output ${shellQuote(outputDir)} .`,
177
- timeoutMs: BUILD_TIMEOUT_MS,
178
- onOutput: (chunk) => {
179
- output.log = (output.log + String(chunk)).slice(-64 * 1024);
180
- },
181
- });
182
- if (outcome.code !== 0)
183
- throw new PreviewFailure('preview_build_failed');
184
- }
185
- /** Reads the one HTML file without following links, so the uploaded bytes are what was checked. */
186
- async function readSingleHtml(outputDir) {
187
- const listed = await readdir(outputDir, { withFileTypes: true }).catch(() => {
188
- throw new PreviewFailure('preview_not_single_file');
189
- });
190
- const entries = listed.map((entry) => ({
191
- name: entry.name,
192
- kind: entry.isSymbolicLink() ? 'symlink' : entry.isFile() ? 'file' : 'dir',
193
- }));
194
- const classified = classifyPreviewOutput(entries);
195
- if (!classified.ok)
196
- throw new PreviewFailure('preview_not_single_file');
197
- const source = join(outputDir, classified.entry);
198
- const stat = await lstat(source);
199
- if (!stat.isFile())
200
- throw new PreviewFailure('preview_not_single_file');
201
- const handle = await open(source, constants.O_RDONLY | constants.O_NOFOLLOW);
202
- try {
203
- return await handle.readFile();
204
- }
205
- finally {
206
- await handle.close();
207
- }
208
- }
209
- async function sourceRevision(root) {
210
- const head = await git(root, ['rev-parse', 'HEAD']);
211
- const status = await git(root, ['status', '--porcelain']);
212
- const revision = head.stdout.trim();
213
- if (head.code !== 0 || !/^[0-9a-f]{7,64}$/i.test(revision))
214
- return { dirty: true };
215
- return { head: revision, dirty: status.code !== 0 || status.stdout.trim().length > 0 };
216
- }
217
- function git(cwd, args) {
218
- return new Promise((resolve) => {
219
- const child = spawn('git', args, { cwd, stdio: ['ignore', 'pipe', 'ignore'] });
220
- let stdout = '';
221
- child.stdout.on('data', (chunk) => {
222
- stdout = (stdout + String(chunk)).slice(-8_000);
223
- });
224
- child.once('error', () => resolve({ code: null, stdout }));
225
- child.once('close', (code) => resolve({ code, stdout }));
226
- });
227
- }
228
- async function postControl(state, path, body) {
229
- const endpoint = platformEndpoint(state.config.publicBaseUrl, path);
230
- const response = await fetch(endpoint, {
231
- method: 'POST',
232
- redirect: 'error',
233
- signal: AbortSignal.timeout(60_000),
234
- headers: {
235
- authorization: `Bearer ${state.config.controlToken}`,
236
- 'playcraft-env': state.config.environment,
237
- 'content-type': 'application/json',
238
- },
239
- body: JSON.stringify({
240
- runtimeId: state.config.runtimeId,
241
- generation: state.config.generation,
242
- runtimeEpoch: state.runtimeEpoch,
243
- ...body,
244
- }),
245
- });
246
- const payload = (await response.json().catch(() => ({})));
247
- if (!response.ok) {
248
- const record = (payload && typeof payload === 'object' ? payload : {});
249
- const reason = typeof record.reason === 'string' ? record.reason : typeof record.error === 'string' ? record.error : '';
250
- throw new PreviewFailure(/^[a-z_]{1,64}$/.test(reason) ? reason : 'preview_upload_failed');
251
- }
252
- return payload;
253
- }
254
- function shellQuote(value) {
255
- return `'${value.replace(/'/g, `'\\''`)}'`;
256
- }
257
- function tail(value) {
258
- return value.slice(-PREVIEW_LOG_TAIL_MAX);
259
- }
@@ -1,43 +0,0 @@
1
- const LOCAL_ATTR = /<(?:script|img|link|source|video|audio|iframe)\b[^>]*?\b(?:src|href)\s*=\s*["']([^"']+)["']/gi;
2
- /** A CSS `url(`, not the tail of a name such as `createObjectURL(` or `getAudioURL(`. */
3
- const CSS_URL = /(?<![\w$.-])url\(\s*["']?([^"')]+)["']?\s*\)/gi;
4
- /** An inline script's body, kept apart from its tag so `<script src>` is still checked. */
5
- const SCRIPT_BODY = /(<script\b[^>]*>)[\s\S]*?(<\/script\s*>)/gi;
6
- /**
7
- * A reference the sealed document would load from the local build, not from the network or inline
8
- * data. Inline script code is not read: inlined libraries call functions named `…URL(` and build
9
- * `"url(" + src + ")"` strings at run time, and neither is a file the document loads.
10
- */
11
- export function findExternalLocalReferences(html) {
12
- const markup = html.replace(SCRIPT_BODY, '$1$2');
13
- const found = new Set();
14
- for (const expression of [LOCAL_ATTR, CSS_URL]) {
15
- expression.lastIndex = 0;
16
- for (const match of markup.matchAll(expression)) {
17
- const value = (match[1] ?? '').trim();
18
- if (isLocalReference(value))
19
- found.add(value);
20
- }
21
- }
22
- return [...found];
23
- }
24
- export function classifyPreviewOutput(entries) {
25
- if (entries.length !== 1)
26
- return { ok: false };
27
- const only = entries[0];
28
- if (!only || only.kind !== 'file' || !only.name.toLowerCase().endsWith('.html'))
29
- return { ok: false };
30
- if (only.name.includes('/') || only.name.includes('\\') || only.name === '.' || only.name === '..') {
31
- return { ok: false };
32
- }
33
- return { ok: true, entry: only.name };
34
- }
35
- function isLocalReference(value) {
36
- if (!value || value.startsWith('#') || value.startsWith('data:') || value.startsWith('blob:'))
37
- return false;
38
- if (/^(https?:|mailto:|javascript:)/i.test(value))
39
- return false;
40
- if (value.startsWith('//'))
41
- return false;
42
- return true;
43
- }
@@ -1,69 +0,0 @@
1
- import { spawn } from 'node:child_process';
2
- import { setTimeout as delay } from 'node:timers/promises';
3
- export const MANAGED_WRITE_SOURCES = ['manual', 'agent', 'background'];
4
- const BACKGROUND_WRITER = `
5
- const fs = require('node:fs');
6
- const file = process.argv[1];
7
- if (!file) process.exit(1);
8
- fs.appendFileSync(file, 'background\\n');
9
- const timer = setInterval(() => {
10
- try { fs.appendFileSync(file, 'x'); }
11
- catch { clearInterval(timer); process.exit(0); }
12
- }, 200);
13
- `;
14
- /** `true` alive, `false` confirmed exited, `undefined` when the probe cannot tell. */
15
- export function probeProcess(pid) {
16
- try {
17
- process.kill(pid, 0);
18
- return true;
19
- }
20
- catch (error) {
21
- if (error.code === 'ESRCH')
22
- return false;
23
- return undefined;
24
- }
25
- }
26
- export function spawnBackgroundWriter(absolutePath) {
27
- const child = spawn(process.execPath, ['-e', BACKGROUND_WRITER, absolutePath], {
28
- detached: true,
29
- stdio: 'ignore',
30
- });
31
- child.unref();
32
- if (!child.pid)
33
- throw new Error('background_write_failed');
34
- return child.pid;
35
- }
36
- export async function stopBackgroundWriter(pid) {
37
- signal(pid, 'SIGTERM');
38
- if (await waitUntilStopped(pid, 2_000))
39
- return true;
40
- signal(pid, 'SIGKILL');
41
- return waitUntilStopped(pid, 2_000);
42
- }
43
- function signal(pid, name) {
44
- try {
45
- process.kill(-pid, name);
46
- }
47
- catch (error) {
48
- if (error.code !== 'ESRCH')
49
- return;
50
- try {
51
- process.kill(pid, name);
52
- }
53
- catch {
54
- /* already gone */
55
- }
56
- }
57
- }
58
- async function waitUntilStopped(pid, timeoutMs) {
59
- const deadline = Date.now() + timeoutMs;
60
- while (Date.now() < deadline) {
61
- const alive = probeProcess(pid);
62
- if (alive === false)
63
- return true;
64
- if (alive === undefined)
65
- return false;
66
- await delay(50);
67
- }
68
- return probeProcess(pid) === false;
69
- }
@@ -1,17 +0,0 @@
1
- import { z } from 'zod';
2
- export const productionStageNames = ['capture-source', 'prepare', 'generate', 'freeze', 'save', 'build', 'preview'];
3
- export const productionExecutionRequestSchema = z.object({
4
- action: z.enum(['stage', 'stop', 'reconcile']),
5
- task: z.object({ taskId: z.string().uuid(), attemptId: z.string().uuid(), batchId: z.string().uuid(), workspaceId: z.string().uuid(),
6
- environment: z.string().min(1), userId: z.string().min(1), payload: z.record(z.unknown()), }).passthrough(),
7
- lease: z.object({ taskId: z.string().uuid(), attemptId: z.string().uuid(), owner: z.string().min(1), fence: z.number().int().positive() }).strict(),
8
- directoryName: z.string().regex(/^(?:basic|remix-[a-z0-9][a-z0-9-]{3,63})$/).default('basic'), generation: z.number().int().positive(), runtimeEpoch: z.number().int().nonnegative(),
9
- callbackUrl: z.string().url(), runnerToken: z.string().min(1), payload: z.record(z.unknown()),
10
- stage: z.enum(productionStageNames).optional(),
11
- stages: z.array(z.object({ stage: z.enum(productionStageNames), requestId: z.string(), status: z.string(),
12
- result: z.record(z.unknown()).optional(), payload: z.record(z.unknown()).optional() }).passthrough()).optional(),
13
- source: z.object({ workspaceId: z.string().uuid(), generation: z.number().int().positive(), runtimeId: z.string().min(1) }).optional(),
14
- model: z.object({ endpoint: z.string().url(), token: z.string().min(1), model: z.string().min(1) }).optional(),
15
- git: z.object({ repositoryUrl: z.string().min(1), branchName: z.string().min(1), username: z.string().optional(), password: z.string().optional() }).optional(),
16
- repairSnapshot: z.unknown().optional(), repairSource: z.unknown().optional(), repairCommitHash: z.string().optional(),
17
- }).strict();
@@ -1,207 +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') {
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
- if (attempt && !attempt.stopped && attempt.workspaceId === workspaceId && attempt.directoryName === directoryName)
54
- return true;
55
- }
56
- return false;
57
- }
58
- export async function executeSandboxProduction(state, raw) {
59
- const input = productionExecutionRequestSchema.parse(raw);
60
- if (input.task.environment !== state.config.environment || input.task.userId !== state.config.userId
61
- || input.generation !== state.config.generation || input.runtimeEpoch !== state.runtimeEpoch
62
- || input.lease.taskId !== input.task.taskId || input.lease.attemptId !== input.task.attemptId)
63
- throw new Error('production_scope_mismatch');
64
- return state.journal.exclusive(`directory:${input.task.workspaceId}:${input.directoryName}`, () => state.journal.exclusive(`production:${input.task.attemptId}`, async () => {
65
- const path = attemptPath(state, input.task.attemptId);
66
- let attempt = await read(path);
67
- if (attempt && (attempt.taskId !== input.task.taskId || attempt.workspaceId !== input.task.workspaceId
68
- || attempt.directoryName !== input.directoryName || attempt.fence > input.lease.fence
69
- || (attempt.fence === input.lease.fence && attempt.owner !== input.lease.owner)))
70
- throw new Error('production_scope_mismatch');
71
- if (input.action !== 'stage')
72
- return stopOrReconcile(state, input, attempt);
73
- if (!input.stage)
74
- throw new Error('invalid_production_stage');
75
- if (attempt?.stopped || attempt?.cancelling)
76
- return { status: 'failed', result: { error: 'production_execution_stopped' } };
77
- const file = receiptPath(state, input.task.attemptId, input.stage);
78
- const old = await read(file);
79
- const payloadHash = hashOperationPayload(input.payload);
80
- if (old) {
81
- if (old.payloadHash !== payloadHash)
82
- throw new Error('production_payload_conflict');
83
- // Existing intent only reports evidence. It never authorizes a second native turn.
84
- return { status: old.status, result: old.result };
85
- }
86
- if (active.get(state)?.has(input.task.attemptId))
87
- throw new Error('production_stage_still_running');
88
- await verifyProductionLease(input);
89
- if (!attempt) {
90
- if (input.stage === 'capture-source' || input.stage === 'prepare')
91
- await settleDependencyInstalls(state);
92
- if (state.journal.getWorkspace(input.task.workspaceId)?.directories?.some(directory => directory.directoryName === input.directoryName && directory.status === 'reclaimed'))
93
- throw new Error('production_directory_reclaimed');
94
- if (await workspaceDirectoryOccupied(state, input.task.workspaceId, input.directoryName))
95
- throw new Error('production_directory_occupied');
96
- attempt = { taskId: input.task.taskId, attemptId: input.task.attemptId, workspaceId: input.task.workspaceId,
97
- directoryName: input.directoryName, owner: input.lease.owner, fence: input.lease.fence, stopped: false };
98
- }
99
- attempt.owner = input.lease.owner;
100
- attempt.fence = input.lease.fence;
101
- await write(state, path, attempt);
102
- const receipt = { status: 'unknown', result: { error: 'production_stage_running' },
103
- taskId: input.task.taskId, attemptId: input.task.attemptId, requestId: `${input.task.attemptId}:${input.stage}`,
104
- stage: input.stage, workspaceId: input.task.workspaceId, directoryName: input.directoryName,
105
- fence: input.lease.fence, payloadHash, startedAt: new Date().toISOString(), processes: [] };
106
- await write(state, file, receipt);
107
- const running = active.get(state) ?? new Map();
108
- active.set(state, running);
109
- const entry = { task: Promise.resolve(receipt), stops: [] };
110
- entry.task = runStage(state, input, receipt, entry).finally(() => running.delete(input.task.attemptId));
111
- running.set(input.task.attemptId, entry);
112
- // Returning from the lock lets stop and reconciliation reach the in-flight native group.
113
- return { status: 'unknown', result: { error: 'production_stage_running' } };
114
- })).then(async (result) => {
115
- const current = active.get(state)?.get(input.task.attemptId);
116
- return input.action === 'stage' && current ? current.task : result;
117
- });
118
- }
119
- async function runStage(state, input, receipt, running) {
120
- const file = receiptPath(state, input.task.attemptId, input.stage);
121
- let writes = Promise.resolve();
122
- const recordProcess = async (process) => {
123
- const at = receipt.processes.findIndex(value => value.pid === process.pid);
124
- if (at === -1)
125
- receipt.processes.push(process);
126
- else
127
- receipt.processes[at] = process;
128
- writes = writes.then(() => write(state, file, receipt));
129
- await writes;
130
- const attempt = await read(attemptPath(state, input.task.attemptId));
131
- if (attempt?.cancelling && !process.stopped) {
132
- process.stopped = await stopProductionGroup(process);
133
- throw new Error('production_execution_stopped');
134
- }
135
- };
136
- try {
137
- receipt.result = await executeProductionStage(state, input, recordProcess, stop => running.stops.push(stop));
138
- await verifyProductionLease(input);
139
- receipt.status = 'completed';
140
- }
141
- catch (error) {
142
- const code = error instanceof Error && /^[a-z0-9_]+$/.test(error.message) ? error.message : 'production_stage_failed';
143
- receipt.status = code.includes('unknown') || code.includes('unavailable') ? 'unknown' : 'failed';
144
- receipt.result = { error: code };
145
- }
146
- if (receipt.processes.some(process => !process.stopped && !groupExited(process.pid))) {
147
- receipt.status = 'unknown';
148
- receipt.result = { error: 'production_stop_unconfirmed' };
149
- }
150
- receipt.finishedAt = new Date().toISOString();
151
- await writes;
152
- await write(state, file, receipt);
153
- return { status: receipt.status, result: receipt.result };
154
- }
155
- async function attemptReceipts(state, attemptId) {
156
- const files = await readdir(receiptsRoot(state)).catch(() => []);
157
- const receipts = [];
158
- for (const file of files.filter(value => value.startsWith(`${attemptId}-`) && value.endsWith('.json'))) {
159
- const receipt = await read(join(receiptsRoot(state), file));
160
- if (receipt)
161
- receipts.push(receipt);
162
- }
163
- return receipts;
164
- }
165
- async function stopOrReconcile(state, input, old) {
166
- const attempt = old ?? { taskId: input.task.taskId, attemptId: input.task.attemptId, workspaceId: input.task.workspaceId,
167
- directoryName: input.directoryName, owner: input.lease.owner, fence: input.lease.fence, stopped: false };
168
- attempt.owner = input.lease.owner;
169
- attempt.fence = input.lease.fence;
170
- attempt.cancelling = true;
171
- await write(state, attemptPath(state, attempt.attemptId), attempt);
172
- const running = active.get(state)?.get(attempt.attemptId);
173
- await Promise.allSettled(running?.stops.map(stop => stop()) ?? []);
174
- const receipts = await attemptReceipts(state, attempt.attemptId);
175
- let groupsStopped = true;
176
- for (const receipt of receipts) {
177
- for (const process of receipt.processes) {
178
- process.stopped = await stopProductionGroup(process);
179
- if (!process.stopped)
180
- groupsStopped = false;
181
- }
182
- await write(state, receiptPath(state, receipt.attemptId, receipt.stage), receipt);
183
- }
184
- if (running)
185
- await Promise.race([running.task.catch(() => undefined), new Promise(resolve => setTimeout(resolve, 5000))]);
186
- const dispatchStopped = !active.get(state)?.has(attempt.attemptId);
187
- attempt.stopped = groupsStopped && dispatchStopped;
188
- await write(state, attemptPath(state, attempt.attemptId), attempt);
189
- const durable = await attemptReceipts(state, attempt.attemptId);
190
- return { status: attempt.stopped ? 'completed' : 'unknown', result: {
191
- executionStopped: attempt.stopped, managedWritesStopped: attempt.stopped,
192
- receipts: Object.fromEntries(durable.map(receipt => [receipt.stage, { status: receipt.status, result: receipt.result }])),
193
- } };
194
- }
195
- export async function sandboxProductionReceipt(state, operationId, identity) {
196
- if (!/^[a-f0-9-]{36}:(capture-source|prepare|generate|freeze|save|build|preview)$/.test(operationId))
197
- throw new Error('production_receipt_invalid');
198
- const [attemptId, stage] = operationId.split(':');
199
- const receipt = await read(receiptPath(state, attemptId, stage));
200
- if (!receipt || receipt.taskId !== identity.taskId || receipt.attemptId !== identity.attemptId || receipt.workspaceId !== identity.workspaceId
201
- || receipt.directoryName !== identity.directoryName || receipt.fence > identity.fence)
202
- throw new Error('production_receipt_scope_mismatch');
203
- const attempt = await read(attemptPath(state, identity.attemptId));
204
- if (!attempt || attempt.owner !== identity.owner || attempt.fence !== identity.fence)
205
- throw new Error('production_receipt_scope_mismatch');
206
- return { status: receipt.status, result: receipt.result };
207
- }
@@ -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
- }