@playcraft/cli 0.1.53-beta → 0.1.54

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