@playcraft/cli 0.1.40-beta → 0.1.42

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