@playcraft/cli 0.1.23 → 0.1.24

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