@playcraft/cli 0.1.38-beta → 0.1.39-prod

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (367) hide show
  1. package/README.md +3 -58
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build-all.js +19 -5
  5. package/dist/commands/build.js +28 -15
  6. package/dist/commands/create.js +33 -26
  7. package/dist/commands/image.js +6 -2
  8. package/dist/commands/login.js +42 -84
  9. package/dist/commands/skills.js +0 -4
  10. package/dist/commands/tools-3d.js +0 -11
  11. package/dist/commands/tools-generation.js +126 -68
  12. package/dist/commands/tools-image-context.js +23 -0
  13. package/dist/commands/tools.js +2 -2
  14. package/dist/config.js +4 -59
  15. package/dist/index.js +3 -40
  16. package/dist/remix/clone.js +0 -2
  17. package/dist/remix/init-template.js +0 -2
  18. package/dist/remix/pull.js +0 -2
  19. package/dist/remix/push.js +1 -21
  20. package/dist/utils/agent-api-client.js +30 -185
  21. package/dist/utils/image-asset-context.js +106 -0
  22. package/dist/utils/playcraft-http-client.js +4 -6
  23. package/package.json +3 -13
  24. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  25. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  26. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  29. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  30. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  31. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  35. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  36. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  37. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  41. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  42. package/SKILLS_REGISTRY.md +0 -149
  43. package/dist/auth/account-activation.js +0 -157
  44. package/dist/auth/messages.js +0 -30
  45. package/dist/commands/build-temp.js +0 -26
  46. package/dist/commands/platform-skills.generated.js +0 -19
  47. package/dist/commands/playable.js +0 -53
  48. package/dist/commands/tools-batch.js +0 -87
  49. package/dist/commands/video.js +0 -111
  50. package/dist/commands/workspace-runtime.js +0 -54
  51. package/dist/commands/workspace.js +0 -35
  52. package/dist/project-skills/builtin-import.js +0 -225
  53. package/dist/project-skills/commands.js +0 -77
  54. package/dist/project-skills/lifecycle.js +0 -28
  55. package/dist/project-skills/local-run.js +0 -112
  56. package/dist/project-skills/local-store.js +0 -221
  57. package/dist/project-skills/messages.js +0 -80
  58. package/dist/project-skills/reconcile.js +0 -62
  59. package/dist/project-skills/remote-cache.js +0 -51
  60. package/dist/project-skills/validation.js +0 -19
  61. package/dist/recording/messages.js +0 -40
  62. package/dist/recording/project-digest.js +0 -85
  63. package/dist/recording/recorder.js +0 -293
  64. package/dist/recording/scenario.js +0 -50
  65. package/dist/skill-registry/client.js +0 -345
  66. package/dist/skill-registry/commands.js +0 -180
  67. package/dist/skill-registry/evaluation-client.js +0 -156
  68. package/dist/skill-registry/evaluation-commands.js +0 -174
  69. package/dist/skill-registry/messages.js +0 -177
  70. package/dist/skill-registry/package.js +0 -275
  71. package/dist/skill-registry/platform-package.js +0 -100
  72. package/dist/utils/environment-endpoints.js +0 -17
  73. package/dist/utils/tool-operation-journal.js +0 -124
  74. package/dist/utils/video-evidence-git.js +0 -81
  75. package/dist/video-replication/client.js +0 -222
  76. package/dist/video-replication/comparison-evidence.js +0 -149
  77. package/dist/video-replication/comparison-files.js +0 -57
  78. package/dist/video-replication/comparison-log.js +0 -72
  79. package/dist/video-replication/comparison-messages.js +0 -104
  80. package/dist/video-replication/comparison-output.js +0 -63
  81. package/dist/video-replication/comparison-preflight.js +0 -66
  82. package/dist/video-replication/comparison.js +0 -216
  83. package/dist/video-replication/evidence.js +0 -165
  84. package/dist/video-replication/media.js +0 -111
  85. package/dist/video-replication/messages.js +0 -89
  86. package/dist/workspace/messages.js +0 -35
  87. package/dist/workspace/transfer-client.js +0 -174
  88. package/dist/workspace-runtime/codex/app-server.js +0 -1040
  89. package/dist/workspace-runtime/codex/compact.js +0 -46
  90. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  91. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  92. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  93. package/dist/workspace-runtime/codex/loopback.js +0 -146
  94. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  95. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  96. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  97. package/dist/workspace-runtime/codex/permissions.js +0 -70
  98. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  99. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  100. package/dist/workspace-runtime/codex/ui-tools.js +0 -183
  101. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  102. package/dist/workspace-runtime/main.js +0 -10
  103. package/dist/workspace-runtime/persistence/journal.js +0 -365
  104. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  105. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  106. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  107. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  108. package/dist/workspace-runtime/previews/output.js +0 -36
  109. package/dist/workspace-runtime/previews/publish.js +0 -262
  110. package/dist/workspace-runtime/previews/single-file.js +0 -43
  111. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  112. package/dist/workspace-runtime/production/content-changes.js +0 -36
  113. package/dist/workspace-runtime/production/contracts.js +0 -19
  114. package/dist/workspace-runtime/production/controller.js +0 -218
  115. package/dist/workspace-runtime/production/dependencies.js +0 -60
  116. package/dist/workspace-runtime/production/native.js +0 -212
  117. package/dist/workspace-runtime/production/processes.js +0 -102
  118. package/dist/workspace-runtime/production/save-command.js +0 -35
  119. package/dist/workspace-runtime/production/source-archive.js +0 -137
  120. package/dist/workspace-runtime/production/source-copy.js +0 -91
  121. package/dist/workspace-runtime/production/stages.js +0 -334
  122. package/dist/workspace-runtime/production/storage.js +0 -75
  123. package/dist/workspace-runtime/serve.js +0 -214
  124. package/dist/workspace-runtime/server/auth.js +0 -21
  125. package/dist/workspace-runtime/server/connectivity.js +0 -201
  126. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  127. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  128. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  129. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  130. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  131. package/dist/workspace-runtime/server/dispatch.js +0 -1217
  132. package/dist/workspace-runtime/server/endpoints.js +0 -21
  133. package/dist/workspace-runtime/server/execution-group.js +0 -90
  134. package/dist/workspace-runtime/server/http.js +0 -1243
  135. package/dist/workspace-runtime/server/lock.js +0 -53
  136. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  137. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  138. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  139. package/dist/workspace-runtime/server/types.js +0 -1
  140. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  141. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  142. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  143. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  144. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  145. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  146. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  147. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  148. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  149. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  150. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  151. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  152. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  153. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  154. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  155. package/dist/workspace-runtime/workspaces/directories.js +0 -133
  156. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  157. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  158. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  159. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  160. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  161. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  162. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  163. package/dist/workspace-runtime/workspaces/files.js +0 -120
  164. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  165. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  166. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  167. package/dist/workspace-runtime/workspaces/git.js +0 -670
  168. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  169. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  170. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  171. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  172. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  173. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  174. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  175. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  176. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  177. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  178. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  179. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  180. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  181. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  182. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  183. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  184. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  185. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  186. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  187. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  188. package/project-template-v2/.claude/agents/artist.md +0 -82
  189. package/project-template-v2/.claude/agents/developer.md +0 -153
  190. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  191. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  192. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  193. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  194. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  195. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  196. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  197. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  198. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  199. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  200. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  201. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  202. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  203. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  204. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  205. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  206. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  207. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  208. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  209. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  210. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  211. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  212. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  213. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  214. package/project-template-v2/.claude/settings.json +0 -33
  215. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  216. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  219. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  220. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  221. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  222. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  223. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  224. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  225. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  226. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  227. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  228. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  229. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  230. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  236. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  237. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  238. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  239. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  240. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  241. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  242. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  243. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  244. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  245. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  246. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  247. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  248. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  249. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  250. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  251. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  252. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  253. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  254. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  255. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  256. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  257. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  258. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  259. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  260. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  261. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  262. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  263. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  264. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  269. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  270. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  271. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  272. package/project-template-v2/.claude/snapshot.mjs +0 -263
  273. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  274. package/project-template-v2/CLAUDE.md +0 -146
  275. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  276. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  277. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  278. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  281. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  282. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  283. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  284. package/project-template-v2/assets/models/.gitkeep +0 -0
  285. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  286. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  287. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  288. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  289. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  290. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  291. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  292. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  293. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  294. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  295. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  296. package/project-template-v2/docs/project-state.json +0 -60
  297. package/project-template-v2/docs/project-state.md +0 -72
  298. package/project-template-v2/docs/standards/README.md +0 -225
  299. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  300. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  301. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  302. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  303. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  304. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  305. package/project-template-v2/game/index.ts +0 -18
  306. package/project-template-v2/globals.d.ts +0 -51
  307. package/project-template-v2/index.css +0 -34
  308. package/project-template-v2/index.html +0 -18
  309. package/project-template-v2/main.ts +0 -9
  310. package/project-template-v2/package.json +0 -46
  311. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  312. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  313. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  314. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  315. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  316. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  317. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  318. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  319. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  320. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  321. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  322. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  323. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  324. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  325. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  326. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  327. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  328. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  329. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  330. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  331. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  332. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  333. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  334. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  335. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  336. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  337. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  338. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  339. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  340. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  341. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  342. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  343. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  344. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  345. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  346. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  347. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  348. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  349. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  350. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  351. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  354. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  355. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  356. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  357. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  358. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  359. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  360. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  361. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  362. package/project-template-v2/tsconfig.json +0 -20
  363. package/project-template-v2/vite.config.ts +0 -27
  364. package/project-templates/batch-locks/phaser.yaml +0 -922
  365. package/project-templates/batch-locks/threejs.yaml +0 -978
  366. package/project-templates/empty/AGENTS.md +0 -41
  367. package/project-templates/empty/gitignore +0 -33
@@ -1,77 +0,0 @@
1
- import { operationRecordSchema, transitionOperation } from '@playcraft/common/cloud-workspace/runtime';
2
- const STOP_BUCKET = 'stopped_execution_epochs';
3
- const ACTIVE_OPERATIONS = new Set(['queued', 'dispatched', 'accepted', 'uncertain']);
4
- /** Called only inside the journal writer transaction after authoritative process-stop evidence. */
5
- export function settleStoppedExecution(database, scope, pid, occurredAt, writer) {
6
- const key = JSON.stringify([scope.runtimeId, scope.generation, scope.runtimeEpoch]);
7
- if (!readRecord(database, STOP_BUCKET, key))
8
- writeRecord(database, STOP_BUCKET, key, { ...scope, pid, occurredAt });
9
- const events = [];
10
- const stoppedSessions = new Set();
11
- const rows = database.prepare(`SELECT scope_key, operation_json FROM operation_intents
12
- WHERE json_extract(operation_json, '$.generation') = ? AND json_extract(operation_json, '$.runtimeEpoch') = ?
13
- AND json_extract(operation_json, '$.kind') IN ('session.turn', 'session.review', 'session.compact')`)
14
- .all(scope.generation, scope.runtimeEpoch);
15
- for (const row of rows) {
16
- const operation = operationRecordSchema.parse(JSON.parse(row.operation_json));
17
- const binding = readRecord(database, 'operation_execution_scopes', JSON.stringify([row.scope_key, operation.operationId]));
18
- const source = database.prepare('SELECT 1 FROM source_events WHERE runtime_id = ? AND generation = ? AND runtime_epoch = ? AND operation_id = ? LIMIT 1')
19
- .get(scope.runtimeId, scope.generation, scope.runtimeEpoch, operation.operationId);
20
- if ((!binding || binding.runtimeId !== scope.runtimeId || binding.generation !== scope.generation || binding.runtimeEpoch !== scope.runtimeEpoch) && !source)
21
- continue;
22
- if (operation.sessionId)
23
- stoppedSessions.add(operation.sessionId);
24
- const session = operation.sessionId ? readRecord(database, 'sessions', operation.sessionId) : undefined;
25
- const appendTerminal = (threadId, turnId, subAgent) => {
26
- const existing = database.prepare(`SELECT 1 FROM source_events WHERE runtime_id = ? AND generation = ? AND runtime_epoch = ?
27
- AND thread_id = ? AND turn_id = ? AND type IN ('turn/completed', 'turn.completed', 'turn.interrupted', 'turn.failed') LIMIT 1`)
28
- .get(scope.runtimeId, scope.generation, scope.runtimeEpoch, threadId, turnId);
29
- if (existing)
30
- return;
31
- const payload = { sessionId: operation.sessionId, workspaceId: operation.workspaceId,
32
- threadId, turnId, turn: { id: turnId, status: 'interrupted' }, reason: 'execution_group_stopped', subAgent };
33
- events.push(...writer.allocate({ ...scope, type: 'turn.interrupted', payload, occurredAt,
34
- sessionId: operation.sessionId, workspaceId: operation.workspaceId, operationId: operation.operationId, threadId, turnId }).committedEvents);
35
- };
36
- const children = database.prepare(`SELECT record_key, body_json FROM records WHERE bucket = 'native_subagent_turns'
37
- AND json_extract(body_json, '$.operationScopeKey') = ?`).all(row.scope_key);
38
- for (const child of children) {
39
- const [threadId, turnId] = JSON.parse(child.record_key);
40
- const link = readRecord(database, 'native_subagent_threads', threadId);
41
- if (!link || link.sessionId !== operation.sessionId || link.workspaceId !== operation.workspaceId || link.rootThreadId !== operation.nativeThreadId)
42
- continue;
43
- const { sessionId: _, workspaceId: __, operationScopeKey: ___, operationConfirmed: ____, ...subAgent } = link;
44
- appendTerminal(threadId, turnId, subAgent);
45
- }
46
- if (!ACTIVE_OPERATIONS.has(operation.status))
47
- continue;
48
- if (operation.nativeThreadId && operation.nativeTurnId)
49
- appendTerminal(operation.nativeThreadId, operation.nativeTurnId);
50
- writer.putOperation(row.scope_key, { ...transitionOperation(operation, 'interrupted', { error: 'execution_group_stopped' }), updatedAt: occurredAt });
51
- if (session && session.threadId === operation.nativeThreadId &&
52
- (session.activeTurnId === operation.nativeTurnId || (!session.activeTurnId && !operation.nativeTurnId && session.turnStatus === 'starting'))) {
53
- writeRecord(database, 'sessions', operation.sessionId, { ...session, turnStatus: 'interrupted', turnBlock: undefined,
54
- activeTurnId: undefined, recoverability: 'history_only' });
55
- }
56
- }
57
- for (const row of database.prepare("SELECT record_key, body_json FROM records WHERE bucket = 'approvals'").all()) {
58
- const approval = JSON.parse(row.body_json);
59
- if (approval.status === 'pending' && approval.runtimeId === scope.runtimeId && approval.generation === scope.generation &&
60
- approval.runtimeEpoch === scope.runtimeEpoch && stoppedSessions.has(String(approval.sessionId)))
61
- writeRecord(database, 'approvals', row.record_key, { ...approval, status: 'expired' });
62
- }
63
- return events;
64
- }
65
- export function stoppedExecutionEpochs(database, runtimeId, generation) {
66
- const rows = database.prepare(`SELECT body_json FROM records WHERE bucket = ?
67
- AND json_extract(body_json, '$.runtimeId') = ? AND json_extract(body_json, '$.generation') = ?`).all(STOP_BUCKET, runtimeId, generation);
68
- return rows.map(row => Number(JSON.parse(row.body_json).runtimeEpoch)).sort((a, b) => a - b);
69
- }
70
- function readRecord(database, bucket, key) {
71
- const row = database.prepare('SELECT body_json FROM records WHERE bucket = ? AND record_key = ?').get(bucket, key);
72
- return row ? JSON.parse(row.body_json) : undefined;
73
- }
74
- function writeRecord(database, bucket, key, value) {
75
- database.prepare('INSERT INTO records (bucket, record_key, body_json) VALUES (?, ?, ?) ON CONFLICT(bucket, record_key) DO UPDATE SET body_json = excluded.body_json')
76
- .run(bucket, key, JSON.stringify(value));
77
- }
@@ -1,36 +0,0 @@
1
- import { randomUUID } from 'node:crypto';
2
- import { chmod, lstat, mkdir, realpath, rename, rm, writeFile } from 'node:fs/promises';
3
- import { dirname, join, relative } from 'node:path';
4
- import { WORKSPACE_PLAYABLE_OUTPUT_PATH } from '@playcraft/common/cloud-workspace/runtime';
5
- /** Persist only validated, self-contained build bytes; unrelated delivery files are preserved. */
6
- export async function saveWorkspacePlayableOutput(root, bytes) {
7
- const workspace = await realpath(root);
8
- let directory = workspace;
9
- for (const segment of dirname(WORKSPACE_PLAYABLE_OUTPUT_PATH).split('/')) {
10
- directory = join(directory, segment);
11
- const created = await mkdir(directory, { mode: 0o2775 }).then(() => true, error => {
12
- if (error.code !== 'EEXIST')
13
- throw error;
14
- return false;
15
- });
16
- const stat = await lstat(directory);
17
- if (!stat.isDirectory() || stat.isSymbolicLink() || relative(workspace, await realpath(directory)) !== relative(workspace, directory))
18
- throw new Error('preview_build_failed');
19
- if (created)
20
- await chmod(directory, 0o2775);
21
- }
22
- const target = join(workspace, WORKSPACE_PLAYABLE_OUTPUT_PATH);
23
- const temporary = join(directory, `.playable-${randomUUID()}.tmp`);
24
- try {
25
- await writeFile(temporary, bytes, { flag: 'wx', mode: 0o664 });
26
- await chmod(temporary, 0o664);
27
- const stat = await lstat(target).catch(error => { if (error.code === 'ENOENT')
28
- return undefined; throw error; });
29
- if (stat && (!stat.isFile() || stat.isSymbolicLink() || stat.nlink !== 1))
30
- throw new Error('preview_build_failed');
31
- await rename(temporary, target);
32
- }
33
- finally {
34
- await rm(temporary, { force: true });
35
- }
36
- }
@@ -1,262 +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, WORKSPACE_ARTIFACT_OUTPUT_DIRECTORY, 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
- import { saveWorkspacePlayableOutput } from './output.js';
13
- const BUILD_TIMEOUT_MS = 10 * 60_000;
14
- /** Build output and the builder's own scratch folder live in the checkout, hidden from Git. */
15
- const OUTPUT_FOLDER = '.playcraft-preview-out';
16
- const BUILDER_TEMP_FOLDER = '.playcraft-temp';
17
- /**
18
- * The generic single-file build. `--mode full` keeps the builder from asking which stages to run.
19
- * Group-writable output lets the control user, a member of the development group, remove it.
20
- */
21
- const BUILD_COMMAND = 'umask 002 && playcraft build --mode full --platform playcraft --format html';
22
- class PreviewFailure extends Error {
23
- code;
24
- constructor(code) {
25
- super(code);
26
- this.code = code;
27
- }
28
- }
29
- const running = new WeakMap();
30
- /**
31
- * Checks what can be checked before the operation is accepted. The build itself runs later in
32
- * `runPreviewPublish`; the dispatch request returns as soon as the operation is accepted.
33
- */
34
- export async function previewWorkspaceRoot(state, operation) {
35
- if (!operation.workspaceId || !/^[A-Za-z0-9_-]+$/.test(operation.operationId)) {
36
- throw new PreviewFailure('invalid_preview_publish');
37
- }
38
- if (operation.sessionId !== undefined) {
39
- const session = state.journal.getSession(operation.sessionId);
40
- if (!session || (state.config.workspaceMode === 'multi' && (session.workspaceId !== operation.workspaceId || (session.directoryName ?? 'basic') !== (operation.directoryName ?? 'basic')))) {
41
- throw new PreviewFailure('session_workspace_mismatch');
42
- }
43
- }
44
- return workspaceRoot(state, operation.workspaceId, operation.directoryName);
45
- }
46
- /** Tracks a background publish so tests and shutdown can wait for it. */
47
- export function trackPreviewPublish(state, task) {
48
- const tasks = running.get(state) ?? new Set();
49
- running.set(state, tasks);
50
- const tracked = task.finally(() => tasks.delete(tracked));
51
- tasks.add(tracked);
52
- }
53
- export async function settlePreviewPublishes(state) {
54
- await Promise.all([...(running.get(state) ?? [])]);
55
- }
56
- /** A publish cut off by a restart has no build left running; it is closed rather than left accepted. */
57
- export async function recoverInterruptedPreviews(journal) {
58
- for (const { scopeKey, operation } of journal.listOperations()) {
59
- if (operation.kind !== 'preview.publish' || operation.status !== 'accepted')
60
- continue;
61
- await journal.putOperation(scopeKey, transitionOperation(operation, 'interrupted', { error: 'preview_interrupted' }));
62
- }
63
- }
64
- export async function runPreviewPublish(state, operation, root) {
65
- const workspaceId = operation.workspaceId;
66
- const scope = operation.sessionId === undefined
67
- ? {}
68
- : { sessionId: operation.sessionId, clientRequestId: operation.clientRequestId };
69
- const outputDir = join(root, OUTPUT_FOLDER, operation.operationId);
70
- const output = { log: '' };
71
- try {
72
- await ensureDependencies(state, revisionScope(state, workspaceId, operation.directoryName) ?? workspaceId, root, output);
73
- await excludeFromGit(root, `/${OUTPUT_FOLDER}/`);
74
- await excludeFromGit(root, `/${BUILDER_TEMP_FOLDER}/`);
75
- await excludeFromGit(root, `/${WORKSPACE_ARTIFACT_OUTPUT_DIRECTORY}/`);
76
- await buildPreview(state, root, outputDir, operation.operationId, output);
77
- const bytes = await readSingleHtml(outputDir);
78
- if (bytes.byteLength > PREVIEW_HTML_MAX_BYTES)
79
- throw new PreviewFailure('preview_not_single_file');
80
- if (findExternalLocalReferences(bytes.toString('utf8')).length > 0) {
81
- throw new PreviewFailure('preview_not_single_file');
82
- }
83
- await saveWorkspacePlayableOutput(root, bytes);
84
- const contentDigest = createHash('sha256').update(bytes).digest('hex');
85
- const contentMd5 = createHash('md5').update(bytes).digest('base64');
86
- const source = await sourceRevision(root);
87
- const reserved = previewReservationSchema.parse(await postControl(state, '/runtime/internal/preview-reservations', {
88
- workspaceId,
89
- directoryName: operation.directoryName ?? 'basic',
90
- ...scope,
91
- operationId: operation.operationId,
92
- contentDigest,
93
- contentMd5,
94
- sizeBytes: bytes.byteLength,
95
- gitHead: source.head,
96
- dirty: source.dirty,
97
- cliVersion: state.config.cliVersion,
98
- }));
99
- if (reserved.sessionId !== operation.sessionId)
100
- throw new PreviewFailure('preview_scope_mismatch');
101
- if (!reserved.alreadyUploaded) {
102
- const uploaded = await fetch(reserved.uploadUrl, {
103
- method: 'PUT',
104
- redirect: 'error',
105
- signal: AbortSignal.timeout(120_000),
106
- headers: {
107
- 'content-type': 'text/html; charset=utf-8',
108
- 'content-md5': contentMd5,
109
- 'content-length': String(bytes.byteLength),
110
- },
111
- body: new Uint8Array(bytes),
112
- });
113
- await uploaded.body?.cancel();
114
- if (!uploaded.ok)
115
- throw new PreviewFailure('preview_upload_failed');
116
- }
117
- const published = previewPublishResultSchema.parse(await postControl(state, '/runtime/internal/preview-completions', {
118
- workspaceId,
119
- directoryName: operation.directoryName ?? 'basic',
120
- ...scope,
121
- operationId: operation.operationId,
122
- artifactId: reserved.artifactId,
123
- expectedPublishRevision: reserved.expectedPublishRevision,
124
- logTail: tail(output.log),
125
- }));
126
- if (published.sessionId !== operation.sessionId || published.previewId !== reserved.previewId ||
127
- published.artifactId !== reserved.artifactId) {
128
- throw new PreviewFailure('preview_scope_mismatch');
129
- }
130
- if (published.status === 'conflict')
131
- throw new PreviewFailure('publish_conflict');
132
- return published;
133
- }
134
- catch (error) {
135
- const code = error instanceof PreviewFailure ? error.code : 'preview_build_failed';
136
- if (code !== 'publish_conflict') {
137
- await postControl(state, '/runtime/internal/preview-failures', {
138
- workspaceId,
139
- directoryName: operation.directoryName ?? 'basic',
140
- ...scope,
141
- operationId: operation.operationId,
142
- error: code,
143
- logTail: tail(output.log || (error instanceof Error ? error.message : '')),
144
- }).catch(() => undefined);
145
- }
146
- throw new PreviewFailure(code);
147
- }
148
- finally {
149
- await rm(outputDir, { recursive: true, force: true }).catch(() => undefined);
150
- }
151
- }
152
- export function previewFailureCode(error) {
153
- const code = error instanceof PreviewFailure
154
- ? error.code
155
- : error instanceof Error && /^[a-z_]+$/.test(error.message)
156
- ? error.message
157
- : 'preview_build_failed';
158
- return code.slice(0, 256);
159
- }
160
- /**
161
- * Checks the install against the current manifest and lockfile before building, so a package
162
- * Codex added since the workspace opened is installed first. A running install is joined rather
163
- * than started twice; a failed one is retried once here.
164
- */
165
- async function ensureDependencies(state, workspaceId, root, output) {
166
- await scheduleDependencyInstall(state, workspaceId, root);
167
- const dependencies = readDependencies(state, workspaceId);
168
- if (dependencies.status !== 'ready' && dependencies.status !== 'none') {
169
- output.log = [dependencies.error, dependencies.logTail].filter(Boolean).join('\n');
170
- throw new PreviewFailure('dependencies_not_ready');
171
- }
172
- }
173
- async function buildPreview(state, root, outputDir, operationId, output) {
174
- // Tests replace the build; the real one needs a project and the published CLI.
175
- const planned = process.env.PLAYCRAFT_PREVIEW_BUILD_COMMAND || BUILD_COMMAND;
176
- const outcome = await runDeveloperCommand(state, {
177
- processId: `preview-${operationId}`,
178
- cwd: root,
179
- command: `${planned} --output ${shellQuote(outputDir)} .`,
180
- timeoutMs: BUILD_TIMEOUT_MS,
181
- onOutput: (chunk) => {
182
- output.log = (output.log + String(chunk)).slice(-64 * 1024);
183
- },
184
- });
185
- if (outcome.code !== 0)
186
- throw new PreviewFailure('preview_build_failed');
187
- }
188
- /** Reads the one HTML file without following links, so the uploaded bytes are what was checked. */
189
- async function readSingleHtml(outputDir) {
190
- const listed = await readdir(outputDir, { withFileTypes: true }).catch(() => {
191
- throw new PreviewFailure('preview_not_single_file');
192
- });
193
- const entries = listed.map((entry) => ({
194
- name: entry.name,
195
- kind: entry.isSymbolicLink() ? 'symlink' : entry.isFile() ? 'file' : 'dir',
196
- }));
197
- const classified = classifyPreviewOutput(entries);
198
- if (!classified.ok)
199
- throw new PreviewFailure('preview_not_single_file');
200
- const source = join(outputDir, classified.entry);
201
- const stat = await lstat(source);
202
- if (!stat.isFile())
203
- throw new PreviewFailure('preview_not_single_file');
204
- const handle = await open(source, constants.O_RDONLY | constants.O_NOFOLLOW);
205
- try {
206
- return await handle.readFile();
207
- }
208
- finally {
209
- await handle.close();
210
- }
211
- }
212
- async function sourceRevision(root) {
213
- const head = await git(root, ['rev-parse', 'HEAD']);
214
- const status = await git(root, ['status', '--porcelain']);
215
- const revision = head.stdout.trim();
216
- if (head.code !== 0 || !/^[0-9a-f]{7,64}$/i.test(revision))
217
- return { dirty: true };
218
- return { head: revision, dirty: status.code !== 0 || status.stdout.trim().length > 0 };
219
- }
220
- function git(cwd, args) {
221
- return new Promise((resolve) => {
222
- const child = spawn('git', args, { cwd, stdio: ['ignore', 'pipe', 'ignore'] });
223
- let stdout = '';
224
- child.stdout.on('data', (chunk) => {
225
- stdout = (stdout + String(chunk)).slice(-8_000);
226
- });
227
- child.once('error', () => resolve({ code: null, stdout }));
228
- child.once('close', (code) => resolve({ code, stdout }));
229
- });
230
- }
231
- async function postControl(state, path, body) {
232
- const endpoint = platformEndpoint(state.config.publicBaseUrl, path);
233
- const response = await fetch(endpoint, {
234
- method: 'POST',
235
- redirect: 'error',
236
- signal: AbortSignal.timeout(60_000),
237
- headers: {
238
- authorization: `Bearer ${state.config.controlToken}`,
239
- 'playcraft-env': state.config.environment,
240
- 'content-type': 'application/json',
241
- },
242
- body: JSON.stringify({
243
- runtimeId: state.config.runtimeId,
244
- generation: state.config.generation,
245
- runtimeEpoch: state.runtimeEpoch,
246
- ...body,
247
- }),
248
- });
249
- const payload = (await response.json().catch(() => ({})));
250
- if (!response.ok) {
251
- const record = (payload && typeof payload === 'object' ? payload : {});
252
- const reason = typeof record.reason === 'string' ? record.reason : typeof record.error === 'string' ? record.error : '';
253
- throw new PreviewFailure(/^[a-z_]{1,64}$/.test(reason) ? reason : 'preview_upload_failed');
254
- }
255
- return payload;
256
- }
257
- function shellQuote(value) {
258
- return `'${value.replace(/'/g, `'\\''`)}'`;
259
- }
260
- function tail(value) {
261
- return value.slice(-PREVIEW_LOG_TAIL_MAX);
262
- }
@@ -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,36 +0,0 @@
1
- import { execFile } from 'node:child_process';
2
- import { promisify } from 'node:util';
3
- const execute = promisify(execFile);
4
- const reference = /^(?:[a-f0-9]{40}|[a-f0-9]{64})$/;
5
- const excludedDirectories = new Set(['node_modules', 'dist', 'build', 'coverage', 'docs', 'test', 'tests', '__tests__']);
6
- const contentExtension = /\.(?:[cm]?[jt]sx?|vue|svelte|html?|css|s[ac]ss|less|json5?|ya?ml|xml|glsl|wgsl|vert|frag|lua|py|svg|png|jpe?g|webp|avif|gif|bmp|mp[34]|wav|ogg|m4a|webm|glb|gltf|fbx|obj|bin|atlas|woff2?|ttf|otf)$/i;
7
- function contentPath(path) {
8
- const parts = path.split('/');
9
- if (parts.some(part => part.startsWith('.') || excludedDirectories.has(part)))
10
- return false;
11
- const name = parts.at(-1);
12
- if (/^(?:package(?:-lock)?\.json|npm-shrinkwrap\.json|pnpm-lock\.yaml|yarn\.lock|bun\.lockb?|tsconfig(?:\.[^.]+)?\.json|(?:vite|vitest|webpack|eslint|prettier)\.config\..+)$/i.test(name))
13
- return false;
14
- return contentExtension.test(name);
15
- }
16
- /** A completed native turn is useful only when code, runtime configuration, or assets changed. */
17
- export async function requireProductionContentChanges(root, before, after) {
18
- if (!reference.test(before) || !reference.test(after))
19
- throw new Error('production_change_reference_invalid');
20
- const { stdout } = await execute('git', ['-c', 'core.hooksPath=/dev/null', '-c', 'core.fsmonitor=false', '-C', root,
21
- 'diff', '--raw', '--no-abbrev', '--no-renames', '-z', before, after, '--'], {
22
- timeout: 90_000, maxBuffer: 64 * 1024 * 1024,
23
- env: { PATH: process.env.PATH, HOME: root, GIT_CONFIG_GLOBAL: '/dev/null', GIT_CONFIG_NOSYSTEM: '1', GIT_TERMINAL_PROMPT: '0' },
24
- });
25
- const records = stdout.split('\0'), paths = [];
26
- for (let index = 0; index + 1 < records.length; index += 2) {
27
- const [oldMode, newMode, oldBlob, newBlob] = records[index].slice(1).split(' ');
28
- const path = records[index + 1];
29
- if ((oldMode === '100644' || oldMode === '100755' || newMode === '100644' || newMode === '100755')
30
- && oldBlob !== newBlob && contentPath(path))
31
- paths.push(path);
32
- }
33
- if (!paths.length)
34
- throw new Error('production_generation_no_content_change');
35
- return paths;
36
- }
@@ -1,19 +0,0 @@
1
- import { z } from 'zod';
2
- import { workspacePreparationSchema } from '@playcraft/common/cloud-workspace/runtime';
3
- export const productionStageNames = ['capture-source', 'prepare', 'generate', 'freeze', 'save', 'build', 'preview'];
4
- export const productionExecutionRequestSchema = z.object({
5
- action: z.enum(['stage', 'stop', 'reconcile']),
6
- task: z.object({ taskId: z.string().uuid(), attemptId: z.string().uuid(), batchId: z.string().uuid(), workspaceId: z.string().uuid(),
7
- environment: z.string().min(1), userId: z.string().min(1), payload: z.record(z.unknown()), }).passthrough(),
8
- lease: z.object({ taskId: z.string().uuid(), attemptId: z.string().uuid(), owner: z.string().min(1), fence: z.number().int().positive() }).strict(),
9
- 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(),
10
- callbackUrl: z.string().url(), runnerToken: z.string().min(1), payload: z.record(z.unknown()),
11
- stage: z.enum(productionStageNames).optional(),
12
- stages: z.array(z.object({ stage: z.enum(productionStageNames), requestId: z.string(), status: z.string(),
13
- result: z.record(z.unknown()).optional(), payload: z.record(z.unknown()).optional() }).passthrough()).optional(),
14
- source: z.object({ workspaceId: z.string().uuid(), generation: z.number().int().positive(), runtimeId: z.string().min(1) }).optional(),
15
- model: z.object({ endpoint: z.string().url(), token: z.string().min(1), model: z.string().min(1) }).optional(),
16
- git: z.object({ repositoryUrl: z.string().min(1), branchName: z.string().min(1), username: z.string().optional(), password: z.string().optional() }).optional(),
17
- repairSnapshot: z.unknown().optional(), repairSource: z.unknown().optional(), repairCommitHash: z.string().optional(),
18
- repairPreparation: z.custom(value => workspacePreparationSchema.safeParse(value).success).optional(),
19
- }).strict();