@playcraft/cli 0.1.50-beta → 0.1.52

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 (406) hide show
  1. package/README.md +3 -62
  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 -210
  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 -113
  50. package/dist/commands/video.js +0 -122
  51. package/dist/commands/workspace-runtime.js +0 -54
  52. package/dist/commands/workspace.js +0 -40
  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/error-diagnostics.js +0 -20
  75. package/dist/utils/tool-operation-journal.js +0 -124
  76. package/dist/utils/video-evidence-git.js +0 -81
  77. package/dist/video-replication/client.js +0 -234
  78. package/dist/video-replication/comparison-evidence.js +0 -149
  79. package/dist/video-replication/comparison-files.js +0 -57
  80. package/dist/video-replication/comparison-log.js +0 -72
  81. package/dist/video-replication/comparison-messages.js +0 -104
  82. package/dist/video-replication/comparison-output.js +0 -63
  83. package/dist/video-replication/comparison-preflight.js +0 -66
  84. package/dist/video-replication/comparison.js +0 -230
  85. package/dist/video-replication/diagnostics.js +0 -41
  86. package/dist/video-replication/evidence.js +0 -165
  87. package/dist/video-replication/media.js +0 -112
  88. package/dist/video-replication/messages.js +0 -97
  89. package/dist/workspace/messages.js +0 -67
  90. package/dist/workspace/transfer-client.js +0 -233
  91. package/dist/workspace/transfer-errors.js +0 -48
  92. package/dist/workspace-runtime/batch/content-changes.js +0 -30
  93. package/dist/workspace-runtime/batch/control.js +0 -86
  94. package/dist/workspace-runtime/batch/deliver.js +0 -173
  95. package/dist/workspace-runtime/batch/freeze.js +0 -101
  96. package/dist/workspace-runtime/batch/generate.js +0 -249
  97. package/dist/workspace-runtime/batch/git.js +0 -40
  98. package/dist/workspace-runtime/batch/occupancy.js +0 -8
  99. package/dist/workspace-runtime/batch/policy.js +0 -70
  100. package/dist/workspace-runtime/batch/prepare.js +0 -317
  101. package/dist/workspace-runtime/batch/processes.js +0 -72
  102. package/dist/workspace-runtime/batch/records.js +0 -113
  103. package/dist/workspace-runtime/batch/routes.js +0 -61
  104. package/dist/workspace-runtime/batch/source-candidate.js +0 -86
  105. package/dist/workspace-runtime/batch/source-capture.js +0 -146
  106. package/dist/workspace-runtime/batch/source-failure.js +0 -43
  107. package/dist/workspace-runtime/batch/source-publish.js +0 -130
  108. package/dist/workspace-runtime/codex/app-server.js +0 -1065
  109. package/dist/workspace-runtime/codex/compact.js +0 -46
  110. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  111. package/dist/workspace-runtime/codex/delivery-tools.js +0 -144
  112. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  113. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  114. package/dist/workspace-runtime/codex/loopback.js +0 -146
  115. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  116. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  117. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  118. package/dist/workspace-runtime/codex/permissions.js +0 -79
  119. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  120. package/dist/workspace-runtime/codex/tool-response.js +0 -10
  121. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  122. package/dist/workspace-runtime/codex/ui-tools.js +0 -203
  123. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  124. package/dist/workspace-runtime/main.js +0 -10
  125. package/dist/workspace-runtime/persistence/journal.js +0 -365
  126. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  127. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  128. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  129. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  130. package/dist/workspace-runtime/previews/diagnostics.js +0 -44
  131. package/dist/workspace-runtime/previews/output.js +0 -36
  132. package/dist/workspace-runtime/previews/publish.js +0 -283
  133. package/dist/workspace-runtime/previews/runtime-preview.js +0 -177
  134. package/dist/workspace-runtime/previews/single-file.js +0 -43
  135. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  136. package/dist/workspace-runtime/serve.js +0 -441
  137. package/dist/workspace-runtime/server/accept-operation.js +0 -61
  138. package/dist/workspace-runtime/server/asset-transfers.js +0 -63
  139. package/dist/workspace-runtime/server/auth.js +0 -21
  140. package/dist/workspace-runtime/server/connectivity.js +0 -209
  141. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  142. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  143. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  144. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  145. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  146. package/dist/workspace-runtime/server/dispatch.js +0 -1632
  147. package/dist/workspace-runtime/server/endpoints.js +0 -21
  148. package/dist/workspace-runtime/server/execution-group.js +0 -90
  149. package/dist/workspace-runtime/server/http.js +0 -1340
  150. package/dist/workspace-runtime/server/lock.js +0 -53
  151. package/dist/workspace-runtime/server/operation-record.js +0 -33
  152. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  153. package/dist/workspace-runtime/server/session-restore.js +0 -84
  154. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  155. package/dist/workspace-runtime/server/submit-operation.js +0 -41
  156. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  157. package/dist/workspace-runtime/server/types.js +0 -1
  158. package/dist/workspace-runtime/server/workspace-transfer.js +0 -168
  159. package/dist/workspace-runtime/verify-artifact.js +0 -59
  160. package/dist/workspace-runtime/workspaces/append-only-log.js +0 -62
  161. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  162. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  163. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -199
  164. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  165. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  166. package/dist/workspace-runtime/workspaces/asset-library-import.js +0 -366
  167. package/dist/workspace-runtime/workspaces/asset-transfer-dependencies.js +0 -81
  168. package/dist/workspace-runtime/workspaces/asset-transfer-publish.js +0 -434
  169. package/dist/workspace-runtime/workspaces/asset-transfer-storage.js +0 -389
  170. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -73
  171. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  172. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  173. package/dist/workspace-runtime/workspaces/binary-content.js +0 -65
  174. package/dist/workspace-runtime/workspaces/binary-write.js +0 -112
  175. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  176. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -115
  177. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  178. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  179. package/dist/workspace-runtime/workspaces/delivery-build.js +0 -331
  180. package/dist/workspace-runtime/workspaces/delivery-store.js +0 -168
  181. package/dist/workspace-runtime/workspaces/delivery.js +0 -64
  182. package/dist/workspace-runtime/workspaces/dependencies.js +0 -279
  183. package/dist/workspace-runtime/workspaces/developer-command.js +0 -98
  184. package/dist/workspace-runtime/workspaces/directories.js +0 -132
  185. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  186. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  187. package/dist/workspace-runtime/workspaces/directory-create.js +0 -57
  188. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  189. package/dist/workspace-runtime/workspaces/directory-mutations.js +0 -238
  190. package/dist/workspace-runtime/workspaces/directory-revisions.js +0 -56
  191. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  192. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  193. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  194. package/dist/workspace-runtime/workspaces/file-content.js +0 -48
  195. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  196. package/dist/workspace-runtime/workspaces/files.js +0 -150
  197. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  198. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  199. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  200. package/dist/workspace-runtime/workspaces/git.js +0 -670
  201. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  202. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -313
  203. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  204. package/dist/workspace-runtime/workspaces/operation-log.js +0 -23
  205. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  206. package/dist/workspace-runtime/workspaces/parameter-agent-inputs.js +0 -87
  207. package/dist/workspace-runtime/workspaces/parameter-agent-protocol.js +0 -29
  208. package/dist/workspace-runtime/workspaces/parameter-agent-store.js +0 -58
  209. package/dist/workspace-runtime/workspaces/parameter-agent.js +0 -282
  210. package/dist/workspace-runtime/workspaces/parameters.js +0 -295
  211. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  212. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  213. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  214. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  215. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  216. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  217. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  218. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  219. package/dist/workspace-runtime/workspaces/transfer-quota.js +0 -69
  220. package/dist/workspace-runtime/workspaces/transfer.js +0 -471
  221. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  222. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  223. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  224. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  225. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  226. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  227. package/project-template-v2/.claude/agents/artist.md +0 -82
  228. package/project-template-v2/.claude/agents/developer.md +0 -153
  229. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  230. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  231. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  232. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  233. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  234. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  235. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  236. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  237. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  238. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  239. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  240. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  241. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  242. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  243. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  244. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  245. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  246. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  247. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  248. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  249. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  250. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  251. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  252. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  253. package/project-template-v2/.claude/settings.json +0 -33
  254. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  255. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  256. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  257. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  258. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  259. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  260. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  261. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  262. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  263. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  264. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  265. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  266. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  267. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  268. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  269. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  270. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  271. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  272. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  273. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  274. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  275. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  276. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  277. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  278. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  279. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  280. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  281. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  282. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  283. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  284. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  285. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  286. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  287. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  288. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  289. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  290. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  291. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  292. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  293. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  294. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  295. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  296. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  297. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  298. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  299. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  300. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  301. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  302. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  303. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  304. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  305. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  306. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  307. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  308. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  309. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  310. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  311. package/project-template-v2/.claude/snapshot.mjs +0 -263
  312. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  313. package/project-template-v2/CLAUDE.md +0 -146
  314. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  315. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  316. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  317. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  318. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  319. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  320. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  321. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  322. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  323. package/project-template-v2/assets/models/.gitkeep +0 -0
  324. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  325. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  326. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  327. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  328. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  329. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  330. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  331. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  332. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  333. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  334. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  335. package/project-template-v2/docs/project-state.json +0 -60
  336. package/project-template-v2/docs/project-state.md +0 -72
  337. package/project-template-v2/docs/standards/README.md +0 -225
  338. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  339. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  340. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  341. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  342. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  343. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  344. package/project-template-v2/game/index.ts +0 -18
  345. package/project-template-v2/globals.d.ts +0 -51
  346. package/project-template-v2/index.css +0 -34
  347. package/project-template-v2/index.html +0 -18
  348. package/project-template-v2/main.ts +0 -9
  349. package/project-template-v2/package.json +0 -46
  350. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  351. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  352. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  353. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  354. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  355. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  356. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  357. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  358. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  359. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  360. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  361. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  362. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  363. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  364. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  365. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  366. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  367. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  368. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  369. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  370. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  371. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  372. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  373. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  374. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  375. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  376. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  377. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  378. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  379. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  380. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  381. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  382. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  383. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  384. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  385. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  386. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  387. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  388. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  389. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  390. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  391. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  392. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  393. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  394. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  395. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  396. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  397. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  398. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  399. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  400. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  401. package/project-template-v2/tsconfig.json +0 -20
  402. package/project-template-v2/vite.config.ts +0 -27
  403. package/project-templates/batch-locks/phaser.yaml +0 -922
  404. package/project-templates/batch-locks/threejs.yaml +0 -978
  405. package/project-templates/empty/AGENTS.md +0 -41
  406. package/project-templates/empty/gitignore +0 -33
@@ -1,295 +0,0 @@
1
- import { readdir, readFile, realpath } from 'node:fs/promises';
2
- import { createHash } from 'node:crypto';
3
- import { relative, resolve, sep } from 'node:path';
4
- import JSON5 from 'json5';
5
- import { parameterDocumentSchema, parameterPatchPayloadSchema, validateParameterChange, workspaceRelativePathSchema, WORKSPACE_FILE_CONTENT_MAX, } from '@playcraft/common/cloud-workspace/runtime';
6
- import { InvalidWorkspacePathError, writeWorkspaceFile, } from './files.js';
7
- import { editJson5Paths, ParameterEditError } from './json5-edit.js';
8
- const MANIFEST_PATH = '.playcraft/workspace.json';
9
- const DEFAULT_SCHEMA_PATH = 'src/theme/theme.schema.json5';
10
- const THEME_INDEX_PATH = 'src/theme/index.ts';
11
- const THEME_ROOT = 'src/theme';
12
- export async function readWorkspaceParameters(root, revisions) {
13
- for (let attempt = 0; attempt < 3; attempt++) {
14
- const located = await locateParameterFiles(root);
15
- const before = await sourceFingerprint(root, located);
16
- const document = await readParameterDocuments(root, revisions, located);
17
- const after = await sourceFingerprint(root, await locateParameterFiles(root));
18
- if (before === after)
19
- return parameterDocumentSchema.parse({ ...document, sourceFingerprint: after });
20
- }
21
- throw new ParameterEditError('parameter_source_changed');
22
- }
23
- async function sourceFingerprint(root, located) {
24
- const sources = await Promise.all([
25
- located.schemaPath ? readOptionalText(root, located.schemaPath) : undefined,
26
- located.schemaPath ? readOptionalText(root, platformI18nPath(located.schemaPath)) : undefined,
27
- readOptionalText(root, MANIFEST_PATH),
28
- readOptionalText(root, THEME_INDEX_PATH),
29
- ]);
30
- return createHash('sha256').update(JSON.stringify({
31
- schemaPath: located.schemaPath ?? null,
32
- dataPath: located.dataPath ?? null,
33
- themeId: located.themeId ?? null,
34
- sources: sources.map((text) => text === undefined ? null : createHash('sha256').update(text).digest('hex')),
35
- })).digest('hex');
36
- }
37
- async function readParameterDocuments(root, revisions, located) {
38
- if (located.errors.some((item) => item.reason === 'parameter_manifest_invalid')) {
39
- return parameterDocumentSchema.parse({ status: 'invalid', errors: located.errors });
40
- }
41
- if (!located.schemaPath) {
42
- return parameterDocumentSchema.parse({
43
- status: 'missing',
44
- ...(located.errors.length > 0 ? { errors: located.errors } : {}),
45
- });
46
- }
47
- const schemaFile = await readOptionalJson5(root, located.schemaPath);
48
- if (schemaFile.status === 'missing') {
49
- return parameterDocumentSchema.parse({
50
- status: 'missing',
51
- schemaPath: located.schemaPath,
52
- themeId: located.themeId,
53
- });
54
- }
55
- if (schemaFile.status === 'invalid') {
56
- return parameterDocumentSchema.parse({
57
- status: 'invalid',
58
- schemaPath: located.schemaPath,
59
- themeId: located.themeId,
60
- errors: [{ path: located.schemaPath, reason: schemaFile.reason }],
61
- });
62
- }
63
- const i18nPath = platformI18nPath(located.schemaPath);
64
- const platformFile = await readOptionalJson5(root, i18nPath);
65
- const schemaDocument = {
66
- schemaPath: located.schemaPath,
67
- themeId: located.themeId,
68
- schema: schemaFile.value,
69
- schemaHash: schemaFile.contentHash,
70
- schemaRevision: revisions[located.schemaPath]?.revision ?? 0,
71
- ...(platformFile.status === 'ok' ? { platformI18n: platformFile.value, platformI18nPath: i18nPath } : {}),
72
- };
73
- if (platformFile.status === 'invalid') {
74
- return parameterDocumentSchema.parse({
75
- ...schemaDocument,
76
- status: 'invalid',
77
- errors: [{ path: i18nPath, reason: platformFile.reason }],
78
- });
79
- }
80
- if (!located.dataPath) {
81
- return parameterDocumentSchema.parse({
82
- ...schemaDocument,
83
- status: 'schema_only',
84
- ...(located.errors.length > 0 ? { errors: located.errors } : {}),
85
- });
86
- }
87
- const dataFile = await readOptionalJson5(root, located.dataPath);
88
- if (dataFile.status === 'missing') {
89
- return parameterDocumentSchema.parse({
90
- ...schemaDocument,
91
- status: 'schema_only',
92
- dataPath: located.dataPath,
93
- });
94
- }
95
- if (dataFile.status === 'invalid') {
96
- return parameterDocumentSchema.parse({
97
- ...schemaDocument,
98
- status: 'invalid',
99
- dataPath: located.dataPath,
100
- errors: [{ path: located.dataPath, reason: dataFile.reason }],
101
- });
102
- }
103
- return parameterDocumentSchema.parse({
104
- ...schemaDocument,
105
- status: 'ready',
106
- dataPath: located.dataPath,
107
- data: dataFile.value,
108
- dataHash: dataFile.contentHash,
109
- dataRevision: revisions[located.dataPath]?.revision ?? 0,
110
- });
111
- }
112
- export async function patchWorkspaceParameters(root, revisions, payload, observed) {
113
- const parsed = parameterPatchPayloadSchema.parse(payload);
114
- const document = await readWorkspaceParameters(root, revisions);
115
- if (document.status === 'invalid')
116
- throw new ParameterEditError('parameter_document_invalid');
117
- if (document.status === 'missing' || document.status === 'schema_only' || !document.dataPath) {
118
- throw new ParameterEditError('parameter_data_missing');
119
- }
120
- if ((parsed.sourceFingerprint && parsed.sourceFingerprint !== document.sourceFingerprint)
121
- || (observed && observed.dataPath !== document.dataPath)) {
122
- throw new ParameterEditError('parameter_source_conflict');
123
- }
124
- const changes = 'changes' in parsed ? parsed.changes : [{ fieldPath: parsed.fieldPath, value: parsed.value }];
125
- for (const change of changes) {
126
- const validationError = validateParameterChange(document.schema, document.data, change);
127
- if (validationError)
128
- throw new ParameterEditError(validationError);
129
- }
130
- const source = await readOptionalText(root, document.dataPath);
131
- if (source === undefined)
132
- throw new ParameterEditError('parameter_data_missing');
133
- if (observed && createHash('sha256').update(source).digest('hex') !== observed.contentHash) {
134
- throw new ParameterEditError('revision_conflict');
135
- }
136
- const next = editJson5Paths(source, changes);
137
- JSON5.parse(next);
138
- if (Buffer.byteLength(next, 'utf8') > WORKSPACE_FILE_CONTENT_MAX) {
139
- throw new ParameterEditError('parameter_document_invalid');
140
- }
141
- const current = await locateParameterFiles(root);
142
- if (await sourceFingerprint(root, current) !== document.sourceFingerprint) {
143
- throw new ParameterEditError('parameter_source_conflict');
144
- }
145
- return writeWorkspaceFile(root, document.dataPath, next);
146
- }
147
- async function locateParameterFiles(root) {
148
- const manifest = await readOptionalJson5(root, MANIFEST_PATH);
149
- if (manifest.status === 'invalid') {
150
- return { errors: [{ path: MANIFEST_PATH, reason: 'parameter_manifest_invalid' }] };
151
- }
152
- if (manifest.status === 'ok') {
153
- const declared = declaredPaths(manifest.value);
154
- if (!declared) {
155
- return { errors: [{ path: MANIFEST_PATH, reason: 'parameter_manifest_invalid' }] };
156
- }
157
- if (declared.schemaPath || declared.dataPath)
158
- return { ...declared, errors: [] };
159
- if (declared.themeId) {
160
- return {
161
- schemaPath: DEFAULT_SCHEMA_PATH,
162
- dataPath: `${THEME_ROOT}/${declared.themeId}/theme.data.json5`,
163
- themeId: declared.themeId,
164
- errors: [],
165
- };
166
- }
167
- }
168
- const schemaExists = (await readOptionalJson5(root, DEFAULT_SCHEMA_PATH)).status !== 'missing';
169
- const theme = await readDeclaredTheme(root);
170
- const dataPath = theme
171
- ? `${THEME_ROOT}/${theme}/theme.data.json5`
172
- : await uniqueThemeDataPath(root);
173
- if (!schemaExists) {
174
- return { themeId: theme, errors: [] };
175
- }
176
- if (!theme && (await listThemeDataFiles(root)).length > 1) {
177
- return {
178
- schemaPath: DEFAULT_SCHEMA_PATH,
179
- errors: [{ path: THEME_INDEX_PATH, reason: 'theme_data_ambiguous' }],
180
- };
181
- }
182
- return {
183
- schemaPath: DEFAULT_SCHEMA_PATH,
184
- dataPath,
185
- themeId: theme,
186
- errors: [],
187
- };
188
- }
189
- function declaredPaths(value) {
190
- if (!value || typeof value !== 'object' || Array.isArray(value))
191
- return undefined;
192
- const parameters = value.parameters;
193
- if (parameters === undefined)
194
- return {};
195
- if (!parameters || typeof parameters !== 'object' || Array.isArray(parameters))
196
- return undefined;
197
- const record = parameters;
198
- if (Object.keys(record).some((key) => !['schemaPath', 'dataPath', 'themeId'].includes(key))) {
199
- return undefined;
200
- }
201
- const schemaPath = record.schemaPath === undefined ? undefined : workspaceRelativePathSchema.safeParse(record.schemaPath);
202
- const dataPath = record.dataPath === undefined ? undefined : workspaceRelativePathSchema.safeParse(record.dataPath);
203
- const themeId = record.themeId === undefined
204
- ? undefined
205
- : typeof record.themeId === 'string' && record.themeId.trim() && record.themeId.length <= 128
206
- ? record.themeId.trim()
207
- : undefined;
208
- if (record.schemaPath !== undefined && !schemaPath?.success)
209
- return undefined;
210
- if (record.dataPath !== undefined && !dataPath?.success)
211
- return undefined;
212
- if (record.themeId !== undefined && !themeId)
213
- return undefined;
214
- return {
215
- schemaPath: schemaPath?.success ? schemaPath.data : undefined,
216
- dataPath: dataPath?.success ? dataPath.data : undefined,
217
- themeId,
218
- };
219
- }
220
- async function readDeclaredTheme(root) {
221
- const contents = await readOptionalText(root, THEME_INDEX_PATH);
222
- if (!contents)
223
- return undefined;
224
- const text = contents.replace(/\/\*[\s\S]*?\*\//g, '').replace(/^\s*\/\/.*$/gm, '');
225
- const match = text.match(/export\s+\{\s*default\s*\}\s+from\s+['"]\.\/([^'"]+)['"]/);
226
- const themeId = match?.[1]?.trim();
227
- return themeId && workspaceRelativePathSchema.safeParse(`${THEME_ROOT}/${themeId}/theme.data.json5`).success
228
- ? themeId
229
- : undefined;
230
- }
231
- async function uniqueThemeDataPath(root) {
232
- const files = await listThemeDataFiles(root);
233
- return files.length === 1 ? files[0] : undefined;
234
- }
235
- async function listThemeDataFiles(root) {
236
- try {
237
- const rootReal = await realpath(root);
238
- const themeRoot = resolve(rootReal, ...THEME_ROOT.split('/'));
239
- const entries = await readdir(themeRoot, { withFileTypes: true });
240
- const files = [];
241
- for (const entry of entries) {
242
- if (!entry.isDirectory() || entry.name.startsWith('.'))
243
- continue;
244
- const relativePath = `${THEME_ROOT}/${entry.name}/theme.data.json5`;
245
- if ((await readOptionalText(root, relativePath)) !== undefined)
246
- files.push(relativePath);
247
- }
248
- return files;
249
- }
250
- catch (error) {
251
- if (error.code === 'ENOENT')
252
- return [];
253
- throw error;
254
- }
255
- }
256
- async function readOptionalJson5(root, relativePath) {
257
- const text = await readOptionalText(root, relativePath);
258
- if (text === undefined)
259
- return { status: 'missing' };
260
- try {
261
- return { status: 'ok', value: JSON5.parse(text), contentHash: createHash('sha256').update(text).digest('hex') };
262
- }
263
- catch {
264
- return { status: 'invalid', reason: 'parameter_document_invalid' };
265
- }
266
- }
267
- async function readOptionalText(root, relativePath) {
268
- const parsed = workspaceRelativePathSchema.safeParse(relativePath);
269
- if (!parsed.success)
270
- return undefined;
271
- try {
272
- const rootReal = await realpath(root);
273
- const target = resolve(rootReal, ...parsed.data.split('/'));
274
- const text = await readFile(target, 'utf8');
275
- const existing = await realpath(target);
276
- const rel = relative(rootReal, existing);
277
- if (rel === '' || rel === '..' || rel.startsWith(`..${sep}`) || rel.startsWith('..')) {
278
- throw new InvalidWorkspacePathError(relativePath);
279
- }
280
- if (Buffer.byteLength(text, 'utf8') > WORKSPACE_FILE_CONTENT_MAX) {
281
- throw new ParameterEditError('parameter_document_invalid');
282
- }
283
- return text;
284
- }
285
- catch (error) {
286
- if (error instanceof ParameterEditError || error instanceof InvalidWorkspacePathError)
287
- throw error;
288
- if (error.code === 'ENOENT')
289
- return undefined;
290
- throw error;
291
- }
292
- }
293
- function platformI18nPath(schemaPath) {
294
- return [...schemaPath.split('/').slice(0, -1), 'i18n.platform.json5'].join('/');
295
- }
@@ -1,278 +0,0 @@
1
- import { spawn } from 'node:child_process';
2
- import { randomUUID } from 'node:crypto';
3
- import { lstat, mkdir, readFile, realpath, rename, rm, writeFile } from 'node:fs/promises';
4
- import { join } from 'node:path';
5
- import { isLocalWorkspaceGitAuthMode, isLocalWorkspaceGitEnvironment, matchWorkspaceGitGatewayCloneUrl, sameWorkspaceRegistration, workspacePreparationSchema, workspaceRegistrationSchema, workspaceDirectoryNameSchema, } from '@playcraft/common/cloud-workspace/runtime';
6
- import { WorkspaceContextError } from './context-error.js';
7
- import { workspacePlatformSkillAccess } from './skill-artifact-loader.js';
8
- import { scaffoldEmptyWorkspace } from './empty-template.js';
9
- const SKILL_PREPARATION_ERRORS = new Set([
10
- 'workspace_skills_unavailable',
11
- 'workspace_skills_platform_required',
12
- 'workspace_skills_platform_unavailable',
13
- 'workspace_skills_artifact_unavailable',
14
- 'workspace_skills_artifact_too_large',
15
- 'workspace_skills_digest_mismatch',
16
- 'workspace_skills_invalid',
17
- 'workspace_skills_invalid_bundle',
18
- 'workspace_skills_builtin_unknown',
19
- 'workspace_skills_builtin_conflict',
20
- ]);
21
- /** The caller holds the Workspace lock. Only an absent, never-published directory may be prepared. */
22
- export async function prepareWorkspaceCheckout(state, binding, input, leaseFence, directoryName = 'basic', recovery = false) {
23
- const preparation = workspacePreparationSchema.safeParse(input);
24
- if (!preparation.success)
25
- throw new WorkspaceContextError('invalid_workspace_preparation');
26
- const standalone = binding.targetKind === 'standalone';
27
- if (standalone !== (preparation.data.mode === 'empty'))
28
- throw new WorkspaceContextError('invalid_workspace_preparation');
29
- const clone = preparation.data.mode === 'clone' ? preparation.data : undefined;
30
- const source = binding.repositoryUrl ? parseCloneSource(binding.repositoryUrl) : undefined;
31
- const direct = isLocalWorkspaceGitAuthMode(clone?.authMode);
32
- if (direct && (!isLocalWorkspaceGitEnvironment(state.config.environment) || !clone?.directAccess
33
- || clone.directAccess.repositoryUrl !== binding.repositoryUrl))
34
- throw new WorkspaceContextError('workspace_git_gateway_unavailable');
35
- const parent = await realpath(state.config.workspaceRoot);
36
- const workspace = join(parent, binding.workspaceId);
37
- workspaceDirectoryNameSchema.parse(directoryName);
38
- const target = join(workspace, directoryName);
39
- const receiptDir = join(state.config.stateDir, 'workspace-preparations');
40
- await mkdir(receiptDir, { recursive: true, mode: 0o700 });
41
- const receiptPath = join(receiptDir, `${binding.workspaceId}${directoryName === 'basic' ? '' : `--${directoryName}`}.json`);
42
- let previous = await readReceipt(receiptPath, binding);
43
- if (recovery && previous?.status === 'published')
44
- previous = undefined;
45
- if (previous?.status === 'published')
46
- throw new WorkspaceContextError('workspace_recovery_required');
47
- if (await exists(target))
48
- throw new WorkspaceContextError('workspace_checkout_conflict');
49
- if (await exists(workspace)) {
50
- const stat = await lstat(workspace);
51
- if (!stat.isDirectory() || stat.isSymbolicLink() || await realpath(workspace) !== workspace)
52
- throw new WorkspaceContextError('invalid_workspace_directory');
53
- }
54
- // An unfinished checkout recorded before the fork instructions were known must be cloned again.
55
- const forkMatches = !previous || samePendingFork(previous.binding, binding);
56
- if (previous && !forkMatches)
57
- await rm(join(parent, previous.stagingName), { recursive: true, force: true });
58
- const receipt = previous && forkMatches ? previous : {
59
- binding,
60
- stagingName: `.prepare-${binding.workspaceId}-${randomUUID()}`,
61
- status: 'cloning',
62
- };
63
- const staging = join(parent, receipt.stagingName);
64
- const assertCurrent = () => {
65
- if (state.journal.destroyed())
66
- throw new WorkspaceContextError('runtime_destroyed');
67
- if (leaseFence < state.acceptedLeaseFence)
68
- throw new WorkspaceContextError('stale_lease');
69
- };
70
- assertCurrent();
71
- if (receipt.status === 'cloning') {
72
- // Persist ownership before creating/removing a staging directory, so a crash can be retried.
73
- await writeReceipt(receiptPath, receipt);
74
- await rm(staging, { recursive: true, force: true });
75
- await mkdir(staging, { mode: 0o700 });
76
- const access = clone?.gitAccess;
77
- const credential = clone?.directAccess ?? access;
78
- const now = Date.now();
79
- if (access &&
80
- (Date.parse(access.issuedAt) > now || Date.parse(access.expiresAt) <= now + 10_000)) {
81
- await rm(staging, { recursive: true, force: true });
82
- throw new WorkspaceContextError('workspace_git_access_expired');
83
- }
84
- const transport = clone?.transport;
85
- if (transport && !matchWorkspaceGitGatewayCloneUrl(transport.cloneUrl, state.config.gitGatewayOrigins, binding.repositoryUrl).ok) {
86
- await rm(staging, { recursive: true, force: true });
87
- throw new WorkspaceContextError('workspace_git_gateway_unavailable');
88
- }
89
- const deadline = Math.min(now + 90_000, access ? Date.parse(access.expiresAt) : Infinity);
90
- const env = {
91
- PATH: process.env.PATH,
92
- HOME: state.config.stateDir,
93
- GIT_CONFIG_NOSYSTEM: '1',
94
- GIT_CONFIG_GLOBAL: '/dev/null',
95
- GIT_TERMINAL_PROMPT: '0',
96
- GIT_ALLOW_PROTOCOL: 'http:https',
97
- };
98
- // The authenticated registration already carries this operation's scoped credential.
99
- // No publisher ledger is mounted in the sandbox; secrets exist only in this child environment.
100
- if (credential) {
101
- env.GIT_CONFIG_COUNT = transport ? '2' : '1';
102
- env.GIT_CONFIG_KEY_0 = `http.${transport?.cloneUrl ?? source.href}.extraHeader`;
103
- env.GIT_CONFIG_VALUE_0 = `Authorization: Basic ${Buffer.from(`${credential.username}:${credential.password}`).toString('base64')}`;
104
- if (transport) {
105
- env.GIT_CONFIG_KEY_1 = `url.${transport.cloneUrl}.insteadOf`;
106
- env.GIT_CONFIG_VALUE_1 = binding.repositoryUrl;
107
- }
108
- }
109
- try {
110
- if (standalone) {
111
- await runGit(['init', '--initial-branch=main', staging], env, deadline);
112
- await scaffoldEmptyWorkspace(staging, join(state.config.stateDir, 'skill-artifacts'), workspacePlatformSkillAccess(state, binding.workspaceId));
113
- }
114
- else {
115
- const fork = binding.pendingFork;
116
- const cloneBranch = fork?.sourceBranchName ?? binding.branchName;
117
- await runGit(['check-ref-format', '--branch', binding.branchName], env, deadline);
118
- await runGit(['check-ref-format', '--branch', cloneBranch], env, deadline);
119
- await runGit([
120
- 'clone',
121
- '--no-checkout',
122
- '--single-branch',
123
- '--branch',
124
- cloneBranch,
125
- '--',
126
- binding.repositoryUrl,
127
- staging,
128
- ], env, deadline);
129
- // Checkout never receives the temporary credential and never invokes repository hooks or global filters.
130
- clearCloneSecrets(env);
131
- if (fork) {
132
- await runGit(['-C', staging, 'checkout', '-b', binding.branchName, fork.sourceCommit], env, deadline);
133
- }
134
- else {
135
- await runGit(['-C', staging, 'checkout', '--force', binding.branchName], env, deadline);
136
- }
137
- }
138
- assertCurrent();
139
- receipt.status = 'ready';
140
- await writeReceipt(receiptPath, receipt);
141
- }
142
- catch (error) {
143
- await rm(staging, { recursive: true, force: true });
144
- if (error instanceof WorkspaceContextError)
145
- throw error;
146
- if (standalone && error instanceof Error && SKILL_PREPARATION_ERRORS.has(error.message))
147
- throw new WorkspaceContextError(error.message);
148
- throw new WorkspaceContextError('workspace_clone_failed');
149
- }
150
- finally {
151
- clearCloneSecrets(env);
152
- }
153
- }
154
- const stat = await lstat(staging).catch(() => undefined);
155
- if (!stat?.isDirectory() || stat.isSymbolicLink())
156
- throw new WorkspaceContextError('workspace_recovery_required');
157
- assertCurrent();
158
- if (await exists(target))
159
- throw new WorkspaceContextError('workspace_checkout_conflict');
160
- if (await exists(workspace)) {
161
- const stat = await lstat(workspace);
162
- if (!stat.isDirectory() || stat.isSymbolicLink() || await realpath(workspace) !== workspace)
163
- throw new WorkspaceContextError('invalid_workspace_directory');
164
- }
165
- await mkdir(workspace, { recursive: true, mode: 0o700 });
166
- await rename(staging, target);
167
- receipt.status = 'published';
168
- await writeReceipt(receiptPath, receipt);
169
- }
170
- function clearCloneSecrets(env) {
171
- for (const key of [
172
- 'GIT_CONFIG_COUNT',
173
- 'GIT_CONFIG_KEY_0',
174
- 'GIT_CONFIG_VALUE_0',
175
- 'GIT_CONFIG_KEY_1',
176
- 'GIT_CONFIG_VALUE_1',
177
- ]) {
178
- delete env[key];
179
- }
180
- }
181
- function parseCloneSource(value) {
182
- try {
183
- const source = new URL(value);
184
- if ((source.protocol !== 'https:' &&
185
- !(source.protocol === 'http:' &&
186
- ['127.0.0.1', '[::1]', 'localhost'].includes(source.hostname))) ||
187
- source.username ||
188
- source.password ||
189
- source.search ||
190
- source.hash)
191
- throw new Error();
192
- return source;
193
- }
194
- catch {
195
- throw new WorkspaceContextError('workspace_clone_transport_unavailable');
196
- }
197
- }
198
- async function exists(path) {
199
- try {
200
- await lstat(path);
201
- return true;
202
- }
203
- catch (error) {
204
- if (error.code === 'ENOENT')
205
- return false;
206
- throw error;
207
- }
208
- }
209
- function samePendingFork(left, right) {
210
- const fork = (value) => value.targetKind === 'standalone' ? undefined : value.pendingFork;
211
- return JSON.stringify(fork(left) ?? null) === JSON.stringify(fork(right) ?? null);
212
- }
213
- async function readReceipt(path, binding) {
214
- try {
215
- const value = JSON.parse(await readFile(path, 'utf8'));
216
- const parsed = workspaceRegistrationSchema.parse(value.binding);
217
- if (!sameWorkspaceRegistration(parsed, binding) ||
218
- !['cloning', 'ready', 'published'].includes(value.status) ||
219
- !new RegExp(`^\\.prepare-${binding.workspaceId}-[0-9a-f-]{36}$`).test(value.stagingName))
220
- throw new Error();
221
- return { binding: parsed, stagingName: value.stagingName, status: value.status };
222
- }
223
- catch (error) {
224
- if (error.code === 'ENOENT')
225
- return undefined;
226
- throw new WorkspaceContextError('workspace_preparation_receipt_invalid');
227
- }
228
- }
229
- async function writeReceipt(path, value) {
230
- const temp = `${path}.tmp`;
231
- await writeFile(temp, `${JSON.stringify(value)}\n`, { mode: 0o600 });
232
- await rename(temp, path);
233
- }
234
- function runGit(args, env, deadline) {
235
- return new Promise((resolve, reject) => {
236
- let timedOut = false;
237
- const child = spawn('git', [
238
- '-c',
239
- 'core.hooksPath=/dev/null',
240
- '-c',
241
- 'credential.helper=',
242
- '-c',
243
- 'http.followRedirects=false',
244
- '-c',
245
- 'init.templateDir=',
246
- ...args,
247
- ], {
248
- env,
249
- detached: process.platform !== 'win32',
250
- stdio: 'ignore',
251
- });
252
- const timer = setTimeout(() => {
253
- timedOut = true;
254
- try {
255
- if (process.platform !== 'win32' && child.pid)
256
- process.kill(-child.pid, 'SIGKILL');
257
- else
258
- child.kill('SIGKILL');
259
- }
260
- catch {
261
- /* The process may have already exited. */
262
- }
263
- }, Math.max(1, deadline - Date.now()));
264
- child.once('error', () => {
265
- clearTimeout(timer);
266
- reject(new WorkspaceContextError('workspace_clone_failed'));
267
- });
268
- child.once('exit', (code) => {
269
- clearTimeout(timer);
270
- if (timedOut)
271
- reject(new WorkspaceContextError('workspace_clone_timeout'));
272
- else if (code === 0)
273
- resolve();
274
- else
275
- reject(new WorkspaceContextError('workspace_clone_failed'));
276
- });
277
- });
278
- }