@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,56 +0,0 @@
1
- import { randomUUID } from 'node:crypto';
2
- import { constants } from 'node:fs';
3
- import { chmod, lstat, open, readFile, rename, rm, writeFile } from 'node:fs/promises';
4
- import { join } from 'node:path';
5
- import { resolveCliPackageRoot } from '../../scaffold/compose.js';
6
- const START = '<!-- playcraft:workspace-artifacts:start -->';
7
- const END = '<!-- playcraft:workspace-artifacts:end -->';
8
- /** Refresh only the platform-owned section; project and user instructions remain intact. */
9
- export async function ensureWorkspaceArtifactInstructions(root) {
10
- const template = await readFile(join(resolveCliPackageRoot(), 'project-templates/empty/AGENTS.md'), 'utf8');
11
- const start = template.indexOf(START), end = template.indexOf(END, start);
12
- if (start < 0 || end < start)
13
- throw new Error('workspace_instructions_invalid');
14
- const section = template.slice(start, end + END.length);
15
- const path = join(root, 'AGENTS.md');
16
- const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK).catch(error => {
17
- if (error.code === 'ENOENT')
18
- return undefined;
19
- throw error;
20
- });
21
- let previous = '', mode = 0o664;
22
- try {
23
- if (handle) {
24
- const stat = await handle.stat();
25
- if (!stat.isFile() || stat.nlink !== 1 || stat.size > 1024 * 1024)
26
- throw new Error('workspace_instructions_invalid');
27
- mode = stat.mode & 0o777;
28
- previous = await handle.readFile('utf8');
29
- }
30
- }
31
- finally {
32
- await handle?.close();
33
- }
34
- const existingStart = previous.indexOf(START), existingEnd = previous.indexOf(END);
35
- if ((existingStart < 0) !== (existingEnd < 0) || existingEnd < existingStart ||
36
- previous.indexOf(START, existingStart + START.length) >= 0 || previous.indexOf(END, existingEnd + END.length) >= 0)
37
- throw new Error('workspace_instructions_invalid');
38
- const next = existingStart >= 0
39
- ? previous.slice(0, existingStart) + section + previous.slice(existingEnd + END.length)
40
- : `${previous}${previous ? (previous.endsWith('\n') ? '\n' : '\n\n') : '# PlayCraft Workspace\n\n'}${section}\n`;
41
- if (next === previous)
42
- return;
43
- const temporary = join(root, `.AGENTS.${randomUUID()}.tmp`);
44
- try {
45
- await writeFile(temporary, next, { flag: 'wx', mode });
46
- await chmod(temporary, mode);
47
- const current = await lstat(path).catch(error => { if (error.code === 'ENOENT')
48
- return undefined; throw error; });
49
- if (current && (!current.isFile() || current.isSymbolicLink() || current.nlink !== 1))
50
- throw new Error('workspace_instructions_invalid');
51
- await rename(temporary, path);
52
- }
53
- finally {
54
- await rm(temporary, { force: true });
55
- }
56
- }
@@ -1,313 +0,0 @@
1
- import JSON5 from 'json5';
2
- export class ParameterEditError extends Error {
3
- code;
4
- constructor(code) {
5
- super(code);
6
- this.code = code;
7
- this.name = 'ParameterEditError';
8
- }
9
- }
10
- /** Apply local JSON5 (JSON5 Data Interchange Format,JSON5 数据交换格式) edits without serializing unrelated fields. */
11
- export function editJson5Paths(source, changes) {
12
- const parsed = JSON5.parse(source);
13
- if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
14
- throw new ParameterEditError('parameter_document_invalid');
15
- }
16
- const paths = [];
17
- for (const change of changes) {
18
- if (change.fieldPath.length === 0 || change.fieldPath.some((key) => !key || ['__proto__', 'prototype', 'constructor'].includes(key))) {
19
- throw new ParameterEditError('parameter_value_invalid');
20
- }
21
- if (paths.some((other) => other.every((key, index) => key === change.fieldPath[index])
22
- || change.fieldPath.every((key, index) => key === other[index]))) {
23
- throw new ParameterEditError('parameter_changes_overlap');
24
- }
25
- if (change.op !== 'remove' && typeof change.value === 'number' && !Number.isFinite(change.value)) {
26
- throw new ParameterEditError('parameter_value_invalid');
27
- }
28
- paths.push(change.fieldPath);
29
- }
30
- let next = source;
31
- for (const change of changes)
32
- next = editJson5Object(next, skipTrivia(next, 0, next.length), change, 0);
33
- JSON5.parse(next);
34
- return next;
35
- }
36
- function editJson5Object(source, braceIndex, change, depth) {
37
- const object = readJson5Object(source, braceIndex);
38
- const memberIndex = object.members.findIndex((member) => member.name === change.fieldPath[depth]);
39
- const member = object.members[memberIndex];
40
- if (member && depth < change.fieldPath.length - 1) {
41
- if (source[member.value.start] !== '{')
42
- throw new ParameterEditError('parameter_value_invalid');
43
- return editJson5Object(source, member.value.start, change, depth + 1);
44
- }
45
- if (change.op === 'remove') {
46
- if (!member)
47
- return source;
48
- if (source[member.value.start] === '{' || source[member.value.start] === '[') {
49
- throw new ParameterEditError('parameter_value_invalid');
50
- }
51
- const comma = member.comma ?? object.members[memberIndex - 1]?.comma;
52
- const spans = [{ start: member.keyStart, end: member.value.end },
53
- ...(comma === undefined ? [] : [{ start: comma, end: comma + 1 }])].sort((left, right) => right.start - left.start);
54
- let next = source;
55
- for (const span of spans)
56
- next = `${next.slice(0, span.start)}${next.slice(span.end)}`;
57
- return next;
58
- }
59
- if (member) {
60
- if (source[member.value.start] === '{' || source[member.value.start] === '[') {
61
- throw new ParameterEditError('parameter_value_invalid');
62
- }
63
- return `${source.slice(0, member.value.start)}${formatJson5Value(change.value, source.slice(member.value.start, member.value.end))}${source.slice(member.value.end)}`;
64
- }
65
- const objectIndent = lineIndent(source, braceIndex);
66
- const first = object.members[0];
67
- const firstIndent = first ? lineIndent(source, first.keyStart) : undefined;
68
- const indentUnit = firstIndent && firstIndent.length > objectIndent.length
69
- ? firstIndent.slice(objectIndent.length) : ' ';
70
- const multiline = /[\r\n]/.test(source.slice(braceIndex, object.close));
71
- const eol = source.includes('\r\n') ? '\r\n' : '\n';
72
- const render = (index, indent) => {
73
- const key = formatJson5Key(change.fieldPath[index]);
74
- if (index === change.fieldPath.length - 1)
75
- return `${key}: ${formatJson5Value(change.value, '')}`;
76
- return multiline
77
- ? `${key}: {${eol}${indent}${indentUnit}${render(index + 1, indent + indentUnit)},${eol}${indent}}`
78
- : `${key}: { ${render(index + 1, indent + indentUnit)} }`;
79
- };
80
- let tailStart = object.close;
81
- while (tailStart > braceIndex + 1 && /\s/.test(source[tailStart - 1]))
82
- tailStart -= 1;
83
- const last = object.members.at(-1);
84
- const insertion = multiline
85
- ? `${eol}${objectIndent}${indentUnit}${render(depth, objectIndent + indentUnit)},${eol}${objectIndent}`
86
- : `${object.members.length > 0 ? ' ' : ''}${render(depth, objectIndent + indentUnit)}${last?.comma === undefined ? '' : ','}${source.slice(tailStart, object.close)}`;
87
- let next = `${source.slice(0, tailStart)}${insertion}${source.slice(object.close)}`;
88
- if (last && last.comma === undefined)
89
- next = `${next.slice(0, last.value.end)},${next.slice(last.value.end)}`;
90
- return next;
91
- }
92
- function readJson5Object(source, braceIndex) {
93
- if (source[braceIndex] !== '{')
94
- throw new ParameterEditError('parameter_document_invalid');
95
- const close = balancedEnd(source, braceIndex, source.length) - 1;
96
- const members = [];
97
- let index = skipTrivia(source, braceIndex + 1, close);
98
- while (index < close) {
99
- const keyStart = index;
100
- let keyEnd;
101
- if (source[index] === '"' || source[index] === "'")
102
- keyEnd = stringEnd(source, index, close);
103
- else {
104
- keyEnd = index;
105
- while (keyEnd < close && !/[\s:/]/.test(source[keyEnd]))
106
- keyEnd += 1;
107
- }
108
- const key = JSON5.parse(`{${source.slice(index, keyEnd)}: null}`);
109
- const name = Object.keys(key)[0];
110
- if (members.some((member) => member.name === name))
111
- throw new ParameterEditError('parameter_document_invalid');
112
- index = skipTrivia(source, keyEnd, close);
113
- if (source[index] !== ':')
114
- throw new ParameterEditError('parameter_document_invalid');
115
- const value = scanValue(source, index + 1, close);
116
- index = skipTrivia(source, value.end, close);
117
- const comma = source[index] === ',' ? index : undefined;
118
- members.push({ name, keyStart, value, comma });
119
- if (comma === undefined && index < close)
120
- throw new ParameterEditError('parameter_document_invalid');
121
- index = skipTrivia(source, comma === undefined ? index : index + 1, close);
122
- }
123
- return { close, members };
124
- }
125
- function lineIndent(source, index) {
126
- return source.slice(source.lastIndexOf('\n', index - 1) + 1, index).match(/^[\t ]*/)?.[0] ?? '';
127
- }
128
- function formatJson5Key(key) {
129
- return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
130
- }
131
- export function replaceJson5Path(source, fieldPath, value) {
132
- const span = findJson5ValueSpan(source, fieldPath);
133
- if (!span)
134
- throw new ParameterEditError('parameter_field_missing');
135
- const current = skipTrivia(source, span.start, span.end);
136
- if (source[current] === '{' || source[current] === '[') {
137
- throw new ParameterEditError('parameter_value_invalid');
138
- }
139
- return `${source.slice(0, span.start)}${formatJson5Value(value, source.slice(span.start, span.end))}${source.slice(span.end)}`;
140
- }
141
- export function replaceJson5Paths(source, changes) {
142
- const replacements = changes.map(({ fieldPath, value }) => {
143
- const span = findJson5ValueSpan(source, fieldPath);
144
- if (!span)
145
- throw new ParameterEditError('parameter_field_missing');
146
- const current = skipTrivia(source, span.start, span.end);
147
- if (source[current] === '{' || source[current] === '[')
148
- throw new ParameterEditError('parameter_value_invalid');
149
- return { ...span, value: formatJson5Value(value, source.slice(span.start, span.end)) };
150
- }).sort((left, right) => right.start - left.start);
151
- let next = source;
152
- let previousStart = source.length;
153
- for (const replacement of replacements) {
154
- if (replacement.end > previousStart)
155
- throw new ParameterEditError('parameter_changes_overlap');
156
- next = `${next.slice(0, replacement.start)}${replacement.value}${next.slice(replacement.end)}`;
157
- previousStart = replacement.start;
158
- }
159
- return next;
160
- }
161
- export function findJson5ValueSpan(source, fieldPath) {
162
- const start = skipTrivia(source, 0, source.length);
163
- if (source[start] !== '{')
164
- throw new ParameterEditError('parameter_document_invalid');
165
- return findInObject(source, start, source.length, fieldPath, 0);
166
- }
167
- function findInObject(source, braceIndex, end, fieldPath, depth) {
168
- let index = skipTrivia(source, braceIndex + 1, end);
169
- while (index < end) {
170
- if (source[index] === '}')
171
- return undefined;
172
- const key = parseKey(source, index, end);
173
- index = skipTrivia(source, key.end, end);
174
- if (source[index] !== ':')
175
- throw new ParameterEditError('parameter_document_invalid');
176
- const value = scanValue(source, index + 1, end);
177
- if (key.name === fieldPath[depth]) {
178
- if (depth === fieldPath.length - 1)
179
- return value;
180
- const nested = skipTrivia(source, value.start, end);
181
- if (source[nested] !== '{')
182
- throw new ParameterEditError('parameter_field_missing');
183
- return findInObject(source, nested, value.end, fieldPath, depth + 1);
184
- }
185
- index = skipTrivia(source, value.end, end);
186
- if (source[index] === ',')
187
- index = skipTrivia(source, index + 1, end);
188
- }
189
- throw new ParameterEditError('parameter_document_invalid');
190
- }
191
- function parseKey(source, start, end) {
192
- const index = skipTrivia(source, start, end);
193
- const first = source[index];
194
- if (first === '"' || first === "'") {
195
- const close = stringEnd(source, index, end);
196
- return { name: JSON5.parse(source.slice(index, close)), end: close };
197
- }
198
- if (!/[A-Za-z_$]/.test(first ?? ''))
199
- throw new ParameterEditError('parameter_document_invalid');
200
- let cursor = index + 1;
201
- while (cursor < end && /[A-Za-z0-9_$]/.test(source[cursor]))
202
- cursor += 1;
203
- return { name: source.slice(index, cursor), end: cursor };
204
- }
205
- function scanValue(source, from, end) {
206
- const start = skipTrivia(source, from, end);
207
- const first = source[start];
208
- if (first === '"' || first === "'")
209
- return { start, end: stringEnd(source, start, end) };
210
- if (first === '{' || first === '[')
211
- return { start, end: balancedEnd(source, start, end) };
212
- let cursor = start;
213
- while (cursor < end) {
214
- const current = source[cursor];
215
- if (/\s/.test(current) || current === ',' || current === '}' || current === ']' || current === '/')
216
- break;
217
- cursor += 1;
218
- }
219
- if (cursor === start)
220
- throw new ParameterEditError('parameter_document_invalid');
221
- return { start, end: cursor };
222
- }
223
- function balancedEnd(source, start, end) {
224
- const open = source[start];
225
- const close = open === '{' ? '}' : ']';
226
- let depth = 0;
227
- let index = start;
228
- while (index < end) {
229
- const current = source[index];
230
- if (current === '"' || current === "'") {
231
- index = stringEnd(source, index, end);
232
- continue;
233
- }
234
- if (current === '/' && source[index + 1] === '/') {
235
- index = skipTrivia(source, index, end);
236
- continue;
237
- }
238
- if (current === '/' && source[index + 1] === '*') {
239
- index = skipTrivia(source, index, end);
240
- continue;
241
- }
242
- if (current === open)
243
- depth += 1;
244
- else if (current === close) {
245
- depth -= 1;
246
- if (depth === 0)
247
- return index + 1;
248
- }
249
- index += 1;
250
- }
251
- throw new ParameterEditError('parameter_document_invalid');
252
- }
253
- function stringEnd(source, start, end) {
254
- const quote = source[start];
255
- let index = start + 1;
256
- while (index < end) {
257
- const current = source[index];
258
- if (current === '\\') {
259
- index += 2;
260
- continue;
261
- }
262
- if (current === quote)
263
- return index + 1;
264
- index += 1;
265
- }
266
- throw new ParameterEditError('parameter_document_invalid');
267
- }
268
- function skipTrivia(source, start, end) {
269
- let index = start;
270
- while (index < end) {
271
- const current = source[index];
272
- if (/\s/.test(current)) {
273
- index += 1;
274
- continue;
275
- }
276
- if (current === '/' && source[index + 1] === '/') {
277
- index += 2;
278
- while (index < end && source[index] !== '\n')
279
- index += 1;
280
- continue;
281
- }
282
- if (current === '/' && source[index + 1] === '*') {
283
- const close = source.indexOf('*/', index + 2);
284
- if (close < 0 || close >= end)
285
- throw new ParameterEditError('parameter_document_invalid');
286
- index = close + 2;
287
- continue;
288
- }
289
- break;
290
- }
291
- return index;
292
- }
293
- function formatJson5Value(value, previous) {
294
- if (typeof value === 'string') {
295
- const trimmed = previous.trim();
296
- if (trimmed.startsWith("'")) {
297
- const escaped = value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")
298
- .replace(/[\u0000-\u001f\u2028\u2029\ud800-\udfff]/g, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, '0')}`);
299
- return `'${escaped}'`;
300
- }
301
- return JSON.stringify(value);
302
- }
303
- if (typeof value === 'boolean' || value === null)
304
- return String(value);
305
- const trimmed = previous.trim();
306
- if (/^[-+]?0x[0-9a-fA-F]+$/.test(trimmed) && Number.isInteger(value)) {
307
- const sign = value < 0 ? '-' : trimmed.startsWith('+') ? '+' : '';
308
- const hex = Math.abs(value).toString(16);
309
- const upper = /[A-F]/.test(trimmed) && !/[a-f]/.test(trimmed);
310
- return `${sign}0x${upper ? hex.toUpperCase() : hex}`;
311
- }
312
- return Number.isInteger(value) ? String(value) : JSON.stringify(value);
313
- }
@@ -1,268 +0,0 @@
1
- import { createHash, randomUUID } from 'node:crypto';
2
- import { constants } from 'node:fs';
3
- import { chmod, lstat, mkdir, open, readdir, rename, rm, writeFile } from 'node:fs/promises';
4
- import { dirname, join } from 'node:path';
5
- import { WORKSPACE_USER_UPLOADS_DIRECTORY, WORKSPACE_LIBRARY_ATTACHMENT_MAX_BYTES, WORKSPACE_ATTACHMENT_MAX_COUNT, workspaceAttachmentSchema, workspaceLibraryAttachmentUploadSchema, workspaceLibraryFilePathSchema, } from '@playcraft/common/cloud-workspace/runtime';
6
- import { excludeFromGit } from './dependencies.js';
7
- const METADATA_MAX_BYTES = 1024 * 1024;
8
- const locks = new Map();
9
- const hash = (bytes) => createHash('sha256').update(bytes).digest('hex');
10
- async function safeDirectory(root, path, create = false) {
11
- let directory = root;
12
- for (const part of path.split('/').filter(Boolean)) {
13
- directory = join(directory, part);
14
- if (create)
15
- await mkdir(directory, { mode: 0o755 }).catch((error) => {
16
- if (error.code !== 'EEXIST')
17
- throw error;
18
- });
19
- const stat = await lstat(directory);
20
- if (!stat.isDirectory() || stat.isSymbolicLink())
21
- throw new Error('invalid_library_attachment');
22
- }
23
- return directory;
24
- }
25
- async function metadataDirectory(root, create = false) {
26
- return safeDirectory(root, `${WORKSPACE_USER_UPLOADS_DIRECTORY}/.metadata`, create);
27
- }
28
- export async function readLibraryAttachmentMetadata(root, id) {
29
- if (!/^[a-f0-9-]{36}$/.test(id))
30
- throw new Error('invalid_library_attachment');
31
- const directory = await metadataDirectory(root);
32
- const handle = await open(join(directory, `${id}.json`), constants.O_RDONLY | constants.O_NOFOLLOW);
33
- try {
34
- const stat = await handle.stat();
35
- if (!stat.isFile() || stat.nlink !== 1 || stat.size > METADATA_MAX_BYTES)
36
- throw new Error('invalid_library_attachment');
37
- const raw = JSON.parse(await handle.readFile('utf8'));
38
- const { sessionIds, unbound, clientRequestIds = [], ...publicFields } = raw;
39
- const attachment = workspaceAttachmentSchema.parse(publicFields);
40
- if (attachment.id !== id || !attachment.origin || !['file', 'bundle'].includes(attachment.kind ?? '') || !attachment.files?.length)
41
- throw new Error('invalid_library_attachment');
42
- const prefix = `${WORKSPACE_USER_UPLOADS_DIRECTORY}/${id}`;
43
- const expected = attachment.kind === 'bundle' ? prefix : `${prefix}/${attachment.files[0].path}`;
44
- if (attachment.path !== expected || (attachment.kind === 'file' && attachment.files.length !== 1))
45
- throw new Error('invalid_library_attachment');
46
- if (!Array.isArray(sessionIds) || sessionIds.some(session => typeof session !== 'string' || session.length > 128))
47
- throw new Error('invalid_library_attachment');
48
- if (!Array.isArray(clientRequestIds) || clientRequestIds.some(id => typeof id !== 'string' || !/^[a-f0-9-]{36}$/.test(id)))
49
- throw new Error('invalid_library_attachment');
50
- return { ...attachment, sessionIds: sessionIds, unbound: unbound === true, clientRequestIds: clientRequestIds };
51
- }
52
- finally {
53
- await handle.close();
54
- }
55
- }
56
- function publicAttachment({ sessionIds: _sessionIds, unbound: _unbound, clientRequestIds: _clientRequestIds, ...attachment }) {
57
- return attachment;
58
- }
59
- export async function openLibraryAttachmentFile(root, attachment, filePath) {
60
- const selected = filePath ?? (attachment.kind === 'file' ? attachment.files?.[0]?.path : undefined);
61
- const file = attachment.files?.find(file => file.path === selected);
62
- if (!file || !workspaceLibraryFilePathSchema.safeParse(selected).success)
63
- throw new Error('attachment_unavailable');
64
- const relative = `${WORKSPACE_USER_UPLOADS_DIRECTORY}/${attachment.id}/${file.path}`;
65
- await safeDirectory(root, dirname(relative));
66
- const handle = await open(join(root, relative), constants.O_RDONLY | constants.O_NOFOLLOW);
67
- try {
68
- const stat = await handle.stat();
69
- if (!stat.isFile() || stat.nlink !== 1 || stat.size !== file.size || stat.size > WORKSPACE_LIBRARY_ATTACHMENT_MAX_BYTES)
70
- throw new Error('attachment_unavailable');
71
- return { handle, name: file.path.split('/').at(-1), mimeType: file.mimeType, size: file.size, sha256: file.sha256 };
72
- }
73
- catch (error) {
74
- await handle.close();
75
- throw error;
76
- }
77
- }
78
- export async function resolveLibraryAttachment(root, id) {
79
- const record = await readLibraryAttachmentMetadata(root, id);
80
- let total = 0;
81
- for (const file of record.files) {
82
- const opened = await openLibraryAttachmentFile(root, record, file.path);
83
- try {
84
- if (hash(await opened.handle.readFile()) !== file.sha256)
85
- throw new Error('library_asset_changed');
86
- total += file.size;
87
- }
88
- finally {
89
- await opened.handle.close();
90
- }
91
- }
92
- if (total !== record.size || total > WORKSPACE_LIBRARY_ATTACHMENT_MAX_BYTES)
93
- throw new Error('invalid_library_attachment');
94
- return { ...publicAttachment(record), path: join(root, record.path) };
95
- }
96
- async function listLibraryRecords(root, sessionId) {
97
- let directory;
98
- try {
99
- directory = await metadataDirectory(root);
100
- }
101
- catch (error) {
102
- if (error.code === 'ENOENT')
103
- return [];
104
- throw error;
105
- }
106
- const attachments = [];
107
- for (const name of await readdir(directory)) {
108
- if (!/^[a-f0-9-]{36}\.json$/.test(name))
109
- continue;
110
- try {
111
- const record = await readLibraryAttachmentMetadata(root, name.slice(0, -5));
112
- if (record.unbound || (sessionId && record.sessionIds.includes(sessionId)))
113
- attachments.push(record);
114
- }
115
- catch { /* Legacy upload metadata and incomplete records are not library sources. */ }
116
- }
117
- return attachments.sort((a, b) => b.origin.importedAt.localeCompare(a.origin.importedAt));
118
- }
119
- export async function listWorkspaceLibraryAttachments(root, sessionId) {
120
- return (await listLibraryRecords(root, sessionId)).map(publicAttachment);
121
- }
122
- export async function listWorkspaceLibraryImportReceipts(root, sessionId) {
123
- const receipts = new Map();
124
- for (const record of await listLibraryRecords(root, sessionId)) {
125
- for (const id of record.clientRequestIds)
126
- receipts.set(id, [...(receipts.get(id) ?? []), record.id]);
127
- }
128
- return [...receipts].map(([clientRequestId, attachmentIds]) => ({ clientRequestId, attachmentIds }));
129
- }
130
- function attachmentId(asset) {
131
- const hex = hash(JSON.stringify([asset.assetId, asset.contentHash])).slice(0, 32).split('');
132
- hex[12] = '5';
133
- hex[16] = ['8', '9', 'a', 'b'][parseInt(hex[16], 16) % 4];
134
- const value = hex.join('');
135
- return `${value.slice(0, 8)}-${value.slice(8, 12)}-${value.slice(12, 16)}-${value.slice(16, 20)}-${value.slice(20)}`;
136
- }
137
- async function importAttachment(root, body) {
138
- const { asset, sessionId, clientRequestId } = workspaceLibraryAttachmentUploadSchema.parse(body);
139
- const previousImports = (await listLibraryRecords(root, sessionId)).filter(record => record.clientRequestIds.includes(clientRequestId));
140
- const replay = previousImports.find(record => record.origin.assetId === asset.assetId);
141
- if (replay) {
142
- await resolveLibraryAttachment(root, replay.id);
143
- return publicAttachment(replay);
144
- }
145
- if (previousImports.length >= WORKSPACE_ATTACHMENT_MAX_COUNT)
146
- throw new Error('library_attachment_limit');
147
- const files = asset.files.map(file => {
148
- const bytes = Buffer.from(file.content, 'base64');
149
- if (bytes.toString('base64') !== file.content || hash(bytes) !== file.sha256)
150
- throw new Error('library_asset_changed');
151
- return { ...file, bytes };
152
- });
153
- const size = files.reduce((sum, file) => sum + file.bytes.length, 0);
154
- if (size > WORKSPACE_LIBRARY_ATTACHMENT_MAX_BYTES)
155
- throw new Error('library_asset_too_large');
156
- const contentHash = hash(JSON.stringify(files.map(file => [file.path, file.sha256]).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)));
157
- if (asset.contentHash !== contentHash)
158
- throw new Error('library_asset_changed');
159
- const id = attachmentId(asset);
160
- await excludeFromGit(root, `/${WORKSPACE_USER_UPLOADS_DIRECTORY}/`);
161
- const uploads = await safeDirectory(root, WORKSPACE_USER_UPLOADS_DIRECTORY, true);
162
- const metadata = await metadataDirectory(root, true);
163
- let record;
164
- try {
165
- record = await readLibraryAttachmentMetadata(root, id);
166
- }
167
- catch (error) {
168
- if (error.code !== 'ENOENT')
169
- throw error;
170
- }
171
- if (record)
172
- await resolveLibraryAttachment(root, id);
173
- if (!record) {
174
- const temporary = join(uploads, `.import-${randomUUID()}`);
175
- const target = join(uploads, id);
176
- await mkdir(temporary, { mode: 0o755 });
177
- try {
178
- for (const file of files) {
179
- const parent = dirname(file.path);
180
- if (parent !== '.')
181
- await safeDirectory(temporary, parent, true);
182
- await writeFile(join(temporary, file.path), file.bytes, { flag: 'wx', mode: 0o644 });
183
- }
184
- const prefix = `${WORKSPACE_USER_UPLOADS_DIRECTORY}/${id}`;
185
- record = {
186
- id, name: asset.kind === 'file' ? files[0].path.split('/').at(-1) : asset.name,
187
- kind: asset.kind, size,
188
- mimeType: asset.kind === 'file' ? files[0].mimeType : 'application/vnd.playcraft.asset-bundle',
189
- path: asset.kind === 'file' ? `${prefix}/${files[0].path}` : prefix,
190
- origin: { kind: 'asset-library', assetId: asset.assetId, name: asset.name,
191
- libraryPath: asset.libraryPath, visibility: asset.visibility, teamId: asset.teamId,
192
- contentHash, importedAt: new Date().toISOString() },
193
- files: files.map(file => ({ path: file.path, size: file.bytes.length, mimeType: file.mimeType, sha256: file.sha256 })),
194
- sessionIds: [], unbound: !sessionId, clientRequestIds: [],
195
- };
196
- // Publish the complete directory before making the source visible through its metadata.
197
- let alreadyPublished = false;
198
- try {
199
- await safeDirectory(root, `${WORKSPACE_USER_UPLOADS_DIRECTORY}/${id}`);
200
- for (const file of record.files) {
201
- const opened = await openLibraryAttachmentFile(root, record, file.path);
202
- try {
203
- if (hash(await opened.handle.readFile()) !== file.sha256)
204
- throw new Error('library_asset_changed');
205
- }
206
- finally {
207
- await opened.handle.close();
208
- }
209
- }
210
- alreadyPublished = true;
211
- }
212
- catch (error) {
213
- if (error.code !== 'ENOENT')
214
- throw error;
215
- // A pre-existing incomplete directory must not be overwritten by a retry.
216
- try {
217
- await lstat(target);
218
- throw new Error('invalid_library_attachment');
219
- }
220
- catch (targetError) {
221
- if (targetError.code !== 'ENOENT')
222
- throw targetError;
223
- }
224
- }
225
- if (alreadyPublished)
226
- await rm(temporary, { recursive: true, force: true });
227
- else
228
- await rename(temporary, target);
229
- }
230
- catch (error) {
231
- await rm(temporary, { recursive: true, force: true });
232
- throw error;
233
- }
234
- }
235
- record.sessionIds = [...new Set([...record.sessionIds, ...(sessionId ? [sessionId] : [])])];
236
- record.clientRequestIds = [...new Set([...record.clientRequestIds, clientRequestId])];
237
- record.unbound ||= !sessionId;
238
- const tempMetadata = join(metadata, `.import-${randomUUID()}.json`);
239
- await writeFile(tempMetadata, JSON.stringify(record), { flag: 'wx', mode: 0o644 });
240
- await rename(tempMetadata, join(metadata, `${id}.json`));
241
- await chmod(join(uploads, id), 0o755);
242
- return publicAttachment(record);
243
- }
244
- export async function importWorkspaceLibraryAttachment(root, body) {
245
- const previous = locks.get(root) ?? Promise.resolve();
246
- const current = previous.catch(() => undefined).then(() => importAttachment(root, body));
247
- locks.set(root, current);
248
- try {
249
- return await current;
250
- }
251
- finally {
252
- if (locks.get(root) === current)
253
- locks.delete(root);
254
- }
255
- }
256
- export async function readLibraryAttachmentUpload(request) {
257
- const chunks = [];
258
- let size = 0;
259
- const limit = 4 * Math.ceil(WORKSPACE_LIBRARY_ATTACHMENT_MAX_BYTES / 3) + 1024 * 1024;
260
- for await (const chunk of request) {
261
- const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
262
- size += bytes.length;
263
- if (size > limit)
264
- throw new Error('library_asset_too_large');
265
- chunks.push(bytes);
266
- }
267
- return JSON.parse(Buffer.concat(chunks).toString('utf8'));
268
- }
@@ -1,23 +0,0 @@
1
- import { join } from 'node:path';
2
- import { AppendOnlyLog } from './append-only-log.js';
3
- export const OPERATION_LOG_MAX_BYTES = 2 * 1024 * 1024;
4
- const TRUNCATED = '[playcraft] log truncated; showing the tail\n';
5
- const OPERATION_ID = /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/i;
6
- /** Full build output for one operation, kept outside the checkout and capped at 2 MiB. */
7
- export class OperationLogStore {
8
- stateDir;
9
- constructor(stateDir) {
10
- this.stateDir = stateDir;
11
- }
12
- log(operationId) {
13
- if (!OPERATION_ID.test(operationId))
14
- throw new Error('invalid_operation_id');
15
- return new AppendOnlyLog(join(this.stateDir, 'operation-logs', `${operationId}.log`), OPERATION_LOG_MAX_BYTES, TRUNCATED);
16
- }
17
- async append(operationId, text) {
18
- await this.log(operationId).append(text);
19
- }
20
- async read(operationId, offset = 0) {
21
- return this.log(operationId).read(offset);
22
- }
23
- }
@@ -1,14 +0,0 @@
1
- import { selectPlatformSkillSnapshot } from '../../project-skills/builtin-import.js';
2
- /** Optional defaults may be omitted before a lock exists; never substitute unverified local copies. */
3
- export async function selectOptionalPlatformSkills(names, access) {
4
- try {
5
- return await selectPlatformSkillSnapshot(names, access);
6
- }
7
- catch (error) {
8
- // A changed runtime identity invalidates preparation itself, not just a default skill.
9
- if (error instanceof Error && error.message === 'workspace_skills_unavailable')
10
- throw error;
11
- // Selection has no project writes. The skills panel exposes absent defaults for explicit retry.
12
- return undefined;
13
- }
14
- }