@playcraft/cli 0.1.50-beta → 0.1.51

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
@@ -0,0 +1,29 @@
1
+ import { readImageAssetContext } from '../utils/image-asset-context.js';
2
+ import { collectReferenceImagePaths, handleError, parseImageTargetFieldPath } from './tools-utils.js';
3
+ export function registerImageContextCommand(tools) {
4
+ tools.command('image-context')
5
+ .description('Read image asset reference and delivery constraints locally; does not generate an image')
6
+ .requiredOption('--asset-path <path>', 'Existing image asset path relative to the project')
7
+ .option('--target-field-path <path>', 'Target image field as an array of keys, e.g. ["endUI","playButton"]', parseImageTargetFieldPath)
8
+ .option('--output-path <path>', 'Intended output path; checks shared asset protection before generation', collectReferenceImagePaths, [])
9
+ .option('--allowed-output-root <path>', 'Additional output directory authorized by the caller; does not allow external references', collectReferenceImagePaths, [])
10
+ .option('--reference-image <path>', 'Explicit local reference; may be repeated', collectReferenceImagePaths, [])
11
+ .option('--no-target-reference', 'Do not use the target schema or current asset as a reference')
12
+ .option('--prompt <text>', 'Generation request used to resolve background intent')
13
+ .option('--remove-background', 'Explicitly request verified transparency')
14
+ .option('--no-remove-background', 'Explicitly keep an opaque background')
15
+ .action(async (opts) => {
16
+ try {
17
+ console.log(JSON.stringify(await readImageAssetContext(opts.assetPath, process.cwd(), {
18
+ referenceImagePaths: opts.referenceImage, useTargetReference: opts.targetReference,
19
+ ...(opts.targetFieldPath ? { targetFieldPath: opts.targetFieldPath } : {}),
20
+ outputPaths: opts.outputPath,
21
+ allowedOutputRoots: opts.allowedOutputRoot,
22
+ prompt: opts.prompt, removeBackground: opts.removeBackground,
23
+ })));
24
+ }
25
+ catch (error) {
26
+ handleError(error);
27
+ }
28
+ });
29
+ }
@@ -1,8 +1,20 @@
1
1
  import { writeFileSync, mkdirSync, readFileSync } from 'fs';
2
2
  import { join, parse } from 'path';
3
3
  import { tmpdir } from 'os';
4
+ import { InvalidArgumentError } from 'commander';
4
5
  export const TMP_DIR = join(tmpdir(), 'playcraft');
5
6
  export const MAX_REFERENCE_IMAGES = 8;
7
+ export function parseImageTargetFieldPath(value) {
8
+ let parsed;
9
+ try {
10
+ parsed = JSON.parse(value);
11
+ }
12
+ catch { /* Report the expected shape below. */ }
13
+ if (!Array.isArray(parsed) || !parsed.length || parsed.some(key => typeof key !== 'string' || !key.length)) {
14
+ throw new InvalidArgumentError('Expected an array of field names, e.g. ["endUI","playButton"].');
15
+ }
16
+ return parsed;
17
+ }
6
18
  export function ensureTmpDir() {
7
19
  mkdirSync(TMP_DIR, { recursive: true });
8
20
  }
@@ -1,16 +1,16 @@
1
1
  import { registerGenerationCommands } from './tools-generation.js';
2
- import { registerBatchCommands } from './tools-batch.js';
3
2
  import { registerProjectCommands } from './tools-project.js';
4
3
  import { register3DCommands } from './tools-3d.js';
5
4
  import { registerDetectCommand } from './tools-detect.js';
6
5
  import { registerVideoReviewCommand } from './tools-video-review.js';
6
+ import { registerImageContextCommand } from './tools-image-context.js';
7
7
  export function registerToolsCommands(program) {
8
8
  const tools = program
9
9
  .command('tools')
10
10
  .description('后端 /api/agent/tools;运行 playcraft login 后即可直接使用,也支持 .playcraft.json 或 PLAYCRAFT_SANDBOX_TOKEN 环境变量');
11
11
  registerGenerationCommands(tools);
12
+ registerImageContextCommand(tools);
12
13
  registerProjectCommands(tools);
13
- registerBatchCommands(tools);
14
14
  register3DCommands(tools);
15
15
  registerDetectCommand(tools);
16
16
  registerVideoReviewCommand(tools);
package/dist/config.js CHANGED
@@ -2,8 +2,7 @@ import { cosmiconfig } from 'cosmiconfig';
2
2
  import { z } from 'zod';
3
3
  import path from 'path';
4
4
  import { homedir } from 'os';
5
- import { chmodSync, mkdirSync, renameSync, rmSync, writeFileSync, readFileSync } from 'fs';
6
- import { randomUUID } from 'node:crypto';
5
+ import { mkdirSync, writeFileSync, readFileSync } from 'fs';
7
6
  import 'dotenv/config';
8
7
  export const ConfigSchema = z.object({
9
8
  projectId: z.string().optional(),
@@ -19,33 +18,6 @@ const explorer = cosmiconfig('playcraft', {
19
18
  });
20
19
  const GLOBAL_CONFIG_DIR = path.join(homedir(), '.playcraft');
21
20
  const GLOBAL_CONFIG_FILE = path.join(GLOBAL_CONFIG_DIR, 'config.json');
22
- export function normalizeEnvironmentBaseUrl(raw) {
23
- try {
24
- const url = new URL(raw);
25
- if (!['http:', 'https:'].includes(url.protocol) || url.username || url.password)
26
- return undefined;
27
- url.hash = '';
28
- url.search = '';
29
- url.pathname = url.pathname.replace(/\/+$/, '').replace(/\/api$/, '');
30
- return url.toString().replace(/\/+$/, '');
31
- }
32
- catch {
33
- return undefined;
34
- }
35
- }
36
- export function readEnvironmentProfile(config, baseUrl) {
37
- const key = normalizeEnvironmentBaseUrl(baseUrl);
38
- const profiles = config.environmentProfiles;
39
- if (!key || !profiles || typeof profiles !== 'object' || Array.isArray(profiles))
40
- return undefined;
41
- const profile = profiles[key];
42
- if (!profile || typeof profile !== 'object' || Array.isArray(profile))
43
- return undefined;
44
- const value = profile;
45
- if (typeof value.token !== 'string' || !value.token || normalizeEnvironmentBaseUrl(value.backendUrl) !== key)
46
- return undefined;
47
- return value;
48
- }
49
21
  export function loadGlobalConfig() {
50
22
  try {
51
23
  const content = readFileSync(GLOBAL_CONFIG_FILE, 'utf-8');
@@ -56,8 +28,7 @@ export function loadGlobalConfig() {
56
28
  }
57
29
  }
58
30
  export function saveGlobalConfig(partial) {
59
- mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true, mode: 0o700 });
60
- chmodSync(GLOBAL_CONFIG_DIR, 0o700);
31
+ mkdirSync(GLOBAL_CONFIG_DIR, { recursive: true });
61
32
  let existing = {};
62
33
  try {
63
34
  existing = JSON.parse(readFileSync(GLOBAL_CONFIG_FILE, 'utf-8'));
@@ -66,25 +37,7 @@ export function saveGlobalConfig(partial) {
66
37
  // ignore
67
38
  }
68
39
  const merged = { ...existing, ...partial };
69
- const temporary = path.join(GLOBAL_CONFIG_DIR, `.config-${randomUUID()}.tmp`);
70
- try {
71
- writeFileSync(temporary, JSON.stringify(merged, null, 2), { encoding: 'utf-8', flag: 'wx', mode: 0o600 });
72
- renameSync(temporary, GLOBAL_CONFIG_FILE);
73
- }
74
- finally {
75
- rmSync(temporary, { force: true });
76
- }
77
- }
78
- export function saveEnvironmentProfile(baseUrl, profile) {
79
- const key = normalizeEnvironmentBaseUrl(baseUrl);
80
- if (!key)
81
- throw new Error('Invalid environment address');
82
- const current = loadGlobalConfig();
83
- const profiles = current.environmentProfiles && typeof current.environmentProfiles === 'object'
84
- && !Array.isArray(current.environmentProfiles) ? current.environmentProfiles : {};
85
- saveGlobalConfig({ environmentProfiles: { ...profiles,
86
- [key]: { ...profile, backendUrl: key, updatedAt: new Date().toISOString() } },
87
- token: profile.token, url: key, backendUrl: key });
40
+ writeFileSync(GLOBAL_CONFIG_FILE, JSON.stringify(merged, null, 2), 'utf-8');
88
41
  }
89
42
  export async function loadConfig(cliOptions) {
90
43
  const result = await explorer.search(cliOptions.dir || process.cwd());
@@ -93,20 +46,12 @@ export async function loadConfig(cliOptions) {
93
46
  ? (fileConfig.agent || {})
94
47
  : fileConfig;
95
48
  const globalConfig = loadGlobalConfig();
96
- const explicitTarget = cliOptions.url || process.env.PLAYCRAFT_URL || agentConfig.url;
97
- const targetUrl = explicitTarget || globalConfig.url;
98
- const profile = typeof targetUrl === 'string' ? readEnvironmentProfile(globalConfig, targetUrl) : undefined;
99
- const legacyTarget = typeof globalConfig.backendUrl === 'string' ? globalConfig.backendUrl
100
- : typeof globalConfig.url === 'string' ? globalConfig.url : undefined;
101
- const legacyToken = !explicitTarget || (legacyTarget && normalizeEnvironmentBaseUrl(String(targetUrl)) === normalizeEnvironmentBaseUrl(legacyTarget))
102
- ? globalConfig.token : undefined;
103
49
  const config = ConfigSchema.parse({
104
50
  ...globalConfig,
105
51
  ...agentConfig,
106
52
  ...cliOptions,
107
53
  projectId: cliOptions.projectId || process.env.PLAYCRAFT_PROJECT_ID || agentConfig.projectId || globalConfig.projectId,
108
- url: targetUrl,
109
- token: cliOptions.token || process.env.PLAYCRAFT_TOKEN || agentConfig.token || profile?.token || legacyToken,
54
+ token: cliOptions.token || process.env.PLAYCRAFT_TOKEN || agentConfig.token || globalConfig.token,
110
55
  port: cliOptions.port || (process.env.PLAYCRAFT_PORT ? parseInt(process.env.PLAYCRAFT_PORT) : undefined) || agentConfig.port || globalConfig.port,
111
56
  mode: cliOptions.mode || process.env.PLAYCRAFT_MODE || agentConfig.mode || globalConfig.mode,
112
57
  skillsDir: cliOptions.skillsDir || process.env.AGENT_SKILLS_DIR || agentConfig.skillsDir || globalConfig.skillsDir,
package/dist/index.js CHANGED
@@ -1,6 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { Command, CommanderError } from 'commander';
3
- import { accountActivationMessage } from './auth/messages.js';
2
+ import { Command } from 'commander';
4
3
  import { readFileSync } from 'fs';
5
4
  import { fileURLToPath } from 'url';
6
5
  import { dirname, join } from 'path';
@@ -28,28 +27,16 @@ import { registerLevelsCommands } from './commands/levels.js';
28
27
  import { registerPatternsCommands } from './commands/patterns.js';
29
28
  import { registerPradCommands } from './commands/prad.js';
30
29
  import { register3DCommands } from './commands/3d.js';
31
- import { registerWorkspaceRuntimeCommands } from './commands/workspace-runtime.js';
32
- import { registerWorkspaceCommands } from './commands/workspace.js';
33
- import { registerVideoCommands } from './commands/video.js';
34
- import { registerPlayableCommands } from './commands/playable.js';
35
- import { videoMessage } from './video-replication/messages.js';
36
30
  import { CLI_ROOT_DESCRIPTION, getCliTopicsHelpText, registerRootProgramHelp, } from './cli-root-help.js';
37
31
  const __filename = fileURLToPath(import.meta.url);
38
32
  const __dirname = dirname(__filename);
39
33
  const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
40
34
  const program = new Command();
41
- const structuredVideoTopic = ['video', 'playable'].includes(process.argv[2] ?? '');
42
- const registryTopic = process.argv[2] === 'skills' && process.argv[3] === 'registry';
43
- if (structuredVideoTopic)
44
- program.exitOverride();
45
35
  program.name('playcraft').description(CLI_ROOT_DESCRIPTION).version(packageJson.version);
46
- // Registry upload commands use --version for the skill, after the command name.
47
- if (registryTopic)
48
- program.enablePositionalOptions();
49
36
  registerRootProgramHelp(program);
50
37
  // 版本检查(非阻塞,后台执行)
51
38
  // 只在非 upgrade 命令时检查,避免重复提示
52
- if (!structuredVideoTopic && !registryTopic && !process.argv.includes('upgrade') && !process.argv.includes('workspace-runtime')) {
39
+ if (!process.argv.includes('upgrade')) {
53
40
  checkForUpdates(packageJson);
54
41
  }
55
42
  // create 命令
@@ -78,8 +65,6 @@ program
78
65
  .command('login')
79
66
  .description('登录 PlayCraft 账号并获取 CLI token')
80
67
  .option('--url <url>', 'Portal / API 基址(默认 https://playcraft.aix.intlgame.com,可用环境变量 PLAYCRAFT_URL 覆盖)')
81
- .option('--activate', accountActivationMessage('activateOption'))
82
- .option('--token <token>', accountActivationMessage('tokenOption'))
83
68
  .action(async (options) => {
84
69
  const { loginCommand } = await import('./commands/login.js');
85
70
  await loginCommand(options);
@@ -383,26 +368,4 @@ registerPatternsCommands(program);
383
368
  registerPradCommands(program);
384
369
  // 3D model utilities (playcraft 3d <command>)
385
370
  register3DCommands(program);
386
- registerWorkspaceRuntimeCommands(program);
387
- registerWorkspaceCommands(program);
388
- registerVideoCommands(program);
389
- registerPlayableCommands(program);
390
- if (structuredVideoTopic) {
391
- try {
392
- await program.parseAsync(process.argv);
393
- }
394
- catch (error) {
395
- if (!(error instanceof CommanderError))
396
- throw error;
397
- if (error.exitCode === 0)
398
- process.exitCode = 0;
399
- else {
400
- const command = [process.argv[2], process.argv[3]?.startsWith('-') ? undefined : process.argv[3]].filter(Boolean).join(' ');
401
- process.stdout.write(`${JSON.stringify({ schemaVersion: 'playcraft.video-cli.v1', command, state: 'failed', ok: false,
402
- error: { code: 'invalidArguments', message: videoMessage('invalidArguments') } })}\n`);
403
- process.exitCode = 64;
404
- }
405
- }
406
- }
407
- else
408
- program.parse(process.argv);
371
+ program.parse(process.argv);
@@ -1,4 +1,3 @@
1
- import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
2
1
  import { spawnSync } from 'node:child_process';
3
2
  import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
4
3
  import path from 'node:path';
@@ -152,7 +151,6 @@ export async function remixClone(options) {
152
151
  };
153
152
  writePlaycraftMeta(targetDir, meta);
154
153
  configureRepoCredentialHelper(targetDir);
155
- await prepareLocalSkillLifecycle(targetDir, 'checkout');
156
154
  let projectType;
157
155
  try {
158
156
  const project = await client.get(`/projects/${encodeURIComponent(projectId)}`);
@@ -1,4 +1,3 @@
1
- import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
2
1
  import * as path from 'node:path';
3
2
  import { applyEnginePackToProject, bakeFullTemplate, KNOWN_ADAPTERS, readAdapterFromAtomTree, readEngineMarker, resolveCliPackageRoot, } from '../scaffold/compose.js';
4
3
  import { autoLinkSkillsFromAtomTree } from '../commands/skills.js';
@@ -69,7 +68,6 @@ export async function initTemplateCommand(opts) {
69
68
  console.log(` ⚠ auto-link skipped: ${err.message}`);
70
69
  }
71
70
  }
72
- await prepareLocalSkillLifecycle(projectDir, 'create');
73
71
  console.log('\n下一步:');
74
72
  console.log(' npm install');
75
73
  console.log(' 阅读 .claude/skills/<atom>/SKILL.md(已自动 link)并填 logs/developer-log.md § Skill Preflight');
@@ -1,4 +1,3 @@
1
- import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
2
1
  import { spawnSync } from 'node:child_process';
3
2
  import { existsSync } from 'node:fs';
4
3
  import path from 'node:path';
@@ -45,7 +44,6 @@ export async function remixPull(options = {}) {
45
44
  const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
46
45
  throw new Error(detail || `git pull 失败(exit ${result.status})`);
47
46
  }
48
- await prepareLocalSkillLifecycle(repoDir, 'checkout');
49
47
  if (options.json) {
50
48
  console.log(JSON.stringify({
51
49
  schemaVersion: '1.0',
@@ -1,6 +1,3 @@
1
- import { prepareLocalSkillLifecycle } from '../project-skills/lifecycle.js';
2
- import { reconcileLocalProjectSkills } from '../project-skills/reconcile.js';
3
- import { projectSkillsMessage as skillMessage } from '../project-skills/messages.js';
4
1
  import { spawnSync } from 'node:child_process';
5
2
  import { existsSync } from 'node:fs';
6
3
  import path from 'node:path';
@@ -44,7 +41,6 @@ export async function remixPush(options = {}) {
44
41
  process.stderr.write(`[push] ${meta.cloneUrl}\n`);
45
42
  process.stderr.write(`[push] branch=${meta.branch} dir=${repoDir}\n`);
46
43
  }
47
- const skills = await prepareLocalSkillLifecycle(repoDir, 'push');
48
44
  const result = runAuthenticatedGit(['push', ...effectiveArgs], {
49
45
  cwd: repoDir,
50
46
  token: client.token,
@@ -54,24 +50,10 @@ export async function remixPush(options = {}) {
54
50
  const detail = [result.stderr, result.stdout].filter(Boolean).join('\n').trim();
55
51
  throw new Error(detail || `git push 失败(exit ${result.status})`);
56
52
  }
57
- let skillIndex;
58
- let skillIndexFailed = false;
59
- if (skills.managed) {
60
- try {
61
- skillIndex = await reconcileLocalProjectSkills(repoDir, { url: options.url, token: options.token });
62
- }
63
- catch (error) {
64
- skillIndexFailed = true;
65
- skillIndex = { indexed: false, message: skillMessage('pushIndexFailed'), detail: error instanceof Error ? error.message : String(error) };
66
- process.exitCode = 1;
67
- }
68
- if (!options.json)
69
- process.stderr.write(`${JSON.stringify(skillIndex)}\n`);
70
- }
71
53
  if (options.json) {
72
54
  console.log(JSON.stringify({
73
55
  schemaVersion: '1.0',
74
- ok: !skillIndexFailed,
56
+ ok: true,
75
57
  command: 'remix.push',
76
58
  requestId: client.requestId,
77
59
  data: {
@@ -80,8 +62,6 @@ export async function remixPush(options = {}) {
80
62
  cloneUrl: meta.cloneUrl,
81
63
  dir: repoDir,
82
64
  gitArgs: effectiveArgs,
83
- gitPushed: true,
84
- skills: skillIndex,
85
65
  },
86
66
  }));
87
67
  return;
@@ -1,13 +1,8 @@
1
1
  import { readFileSync, existsSync } from 'fs';
2
- import { dirname, join } from 'path';
2
+ import { join } from 'path';
3
3
  import { homedir } from 'os';
4
4
  import { loadGlobalConfig } from '../config.js';
5
5
  import { DEFAULT_PLAYCRAFT_CLOUD_BASE } from '../commands/login.js';
6
- import { AGENT_TOOL_OPERATION_PROTOCOL, AGENT_TOOL_OPERATION_HEADERS, AGENT_TOOL_OPERATION_CAPABILITIES_PATH, } from '@playcraft/common/agent-tools';
7
- import { beginToolOperation } from './tool-operation-journal.js';
8
- import { businessEndpoint } from './environment-endpoints.js';
9
- import { redactDiagnosticText } from './error-diagnostics.js';
10
- import { AccountActivationError, parseErrorPayload, pendingAccountActivationError, } from '../auth/account-activation.js';
11
6
  /**
12
7
  * 判断 token 是否为用户 PAT(Personal Access Token)。
13
8
  * PAT 以 "playcraft_pat_" 开头;沙箱 JWT 为三段式 base64。
@@ -20,8 +15,8 @@ function isPatToken(token) {
20
15
  * or from the CLI after `playcraft login`.
21
16
  *
22
17
  * 凭证解析优先级:
23
- * API URL : PLAYCRAFT_API_URL → sandbox global .playcraft.json → project .playcraft.json → ~/.playcraft/config.json → DEFAULT_PLAYCRAFT_CLOUD_BASE
24
- * Token : PLAYCRAFT_SANDBOX_TOKEN → sandbox global .playcraft.json → project .playcraft.json → ~/.playcraft/config.json token (PAT)
18
+ * API URL : PLAYCRAFT_API_URL → .playcraft.json → ~/.playcraft/config.json → DEFAULT_PLAYCRAFT_CLOUD_BASE
19
+ * Token : PLAYCRAFT_SANDBOX_TOKEN → .playcraft.json token → ~/.playcraft/config.json token (PAT)
25
20
  *
26
21
  * 鉴权 header 自动选择:
27
22
  * - 沙箱 JWT (非 PAT) → X-Sandbox-Token: <token>(后端 @SandboxToken 路由的沙箱分支)
@@ -30,7 +25,7 @@ function isPatToken(token) {
30
25
  export class AgentApiClient {
31
26
  apiUrl;
32
27
  token;
33
- credentialFile;
28
+ isPat;
34
29
  playcraftEnv;
35
30
  constructor() {
36
31
  const localConfig = AgentApiClient.loadLocalConfig();
@@ -41,7 +36,7 @@ export class AgentApiClient {
41
36
  globalConfig.backendUrl ||
42
37
  globalConfig.url ||
43
38
  DEFAULT_PLAYCRAFT_CLOUD_BASE).replace(/\/+$/, '');
44
- // Token: 环境变量 → 沙箱全局配置 → 项目配置 → 用户登录配置
39
+ // Token: 沙箱 token 环境变量 → 本地 .playcraft.json → 全局 login 配置(PAT)
45
40
  const token = process.env.PLAYCRAFT_SANDBOX_TOKEN ||
46
41
  localConfig.token ||
47
42
  globalConfig.token ||
@@ -52,149 +47,43 @@ export class AgentApiClient {
52
47
  }
53
48
  this.apiUrl = apiUrl;
54
49
  this.token = token;
55
- this.credentialFile = localConfig.credentialFile;
56
- this.playcraftEnv = (process.env.PLAYCRAFT_ENV || localConfig.env || '').trim();
50
+ this.isPat = isPatToken(token);
51
+ this.playcraftEnv = (process.env.PLAYCRAFT_ENV ||
52
+ localConfig.env ||
53
+ '').trim();
57
54
  }
58
55
  /** 根据 token 类型构造鉴权 headers */
59
56
  authHeaders() {
60
- let token = this.token;
61
- // Polling commands can outlive a credential: read the atomically refreshed file per request.
62
- if (this.credentialFile && !process.env.PLAYCRAFT_SANDBOX_TOKEN) {
63
- try {
64
- token = JSON.parse(readFileSync(this.credentialFile, 'utf8')).token || token;
65
- }
66
- catch { /* Keep the last credential if a local file is temporarily unavailable. */ }
67
- }
68
- const headers = isPatToken(token)
69
- ? { Authorization: `Bearer ${token}` }
70
- : { 'X-Sandbox-Token': token };
57
+ const headers = this.isPat
58
+ ? { Authorization: `Bearer ${this.token}` }
59
+ : { 'X-Sandbox-Token': this.token };
71
60
  if (this.playcraftEnv) {
72
61
  headers['playcraft-env'] = this.playcraftEnv;
73
62
  }
74
63
  return headers;
75
64
  }
76
- /** Deployment-relative pathname under /api/agent/tools (path may omit leading slash). */
65
+ /** Absolute pathname under /api/agent/tools (path may omit leading slash). */
77
66
  toolsRequestUrl(path) {
78
67
  const p = path.startsWith('/') ? path : `/${path}`;
79
- return businessEndpoint(this.apiUrl, `/api/agent/tools${p}`);
68
+ return new URL(`/api/agent/tools${p}`, this.apiUrl);
80
69
  }
81
- async post(path, body, options) {
82
- const url = this.toolsRequestUrl(path);
83
- const serializedBody = JSON.stringify(body);
84
- if (serializedBody === undefined)
85
- throw new Error('Tool request body is required');
86
- const recoverId = options?.requestId ?? process.env.PLAYCRAFT_TOOL_REQUEST_ID;
87
- const operation = beginToolOperation(url.pathname, serializedBody, recoverId, {
88
- newRequest: options?.newRequest ?? process.env.PLAYCRAFT_TOOL_NEW_REQUEST === '1',
70
+ async post(path, body) {
71
+ const url = this.toolsRequestUrl(path).href;
72
+ const res = await fetch(url, {
73
+ method: 'POST',
74
+ headers: {
75
+ 'Content-Type': 'application/json',
76
+ ...this.authHeaders(),
77
+ },
78
+ body: JSON.stringify(body),
89
79
  });
90
- const unknownOutcome = `Tool request ${operation.requestId}: the outcome is unknown. Rerun the same command to ` +
91
- `continue this request: it returns the result if the request finished, or finishes it if ` +
92
- `the tool can be safely redone; it never starts a second operation. Record: ${operation.file}.`;
93
- try {
94
- try {
95
- await options?.onPrepared?.({ requestId: operation.requestId, file: operation.file });
96
- }
97
- catch {
98
- operation.reject();
99
- throw new ToolRequestError('Tool request preparation failed; no operation was sent');
100
- }
101
- const capabilityResponse = await fetch(this.toolsRequestUrl(AGENT_TOOL_OPERATION_CAPABILITIES_PATH), {
102
- headers: this.authHeaders(),
103
- redirect: 'error',
104
- signal: options?.signal
105
- ? AbortSignal.any([options.signal, AbortSignal.timeout(30_000)])
106
- : AbortSignal.timeout(30_000),
107
- });
108
- if (!capabilityResponse.ok) {
109
- if (capabilityResponse.status === 403) {
110
- const pending = pendingAccountActivationError(403, parseErrorPayload(await capabilityResponse.clone().text().catch(() => '')));
111
- if (pending) {
112
- if (operation.createdNew && !operation.settledOnly)
113
- operation.reject();
114
- throw pending;
115
- }
116
- }
117
- await capabilityResponse.body?.cancel();
118
- throw new ToolRequestError(`Business tool protocol unavailable (${capabilityResponse.status}); no operation was sent`);
119
- }
120
- const capabilities = (await capabilityResponse.json());
121
- if (capabilities.protocol !== AGENT_TOOL_OPERATION_PROTOCOL ||
122
- capabilities.settledOnly !== true)
123
- throw new ToolRequestError('Business tool protocol is incompatible; no operation was sent');
124
- const res = await fetch(url, {
125
- method: 'POST',
126
- redirect: 'error',
127
- signal: options?.signal
128
- ? AbortSignal.any([options.signal, AbortSignal.timeout(30 * 60_000)])
129
- : AbortSignal.timeout(30 * 60_000),
130
- headers: {
131
- 'Content-Type': 'application/json',
132
- ...this.authHeaders(),
133
- [AGENT_TOOL_OPERATION_HEADERS.protocol]: AGENT_TOOL_OPERATION_PROTOCOL,
134
- [AGENT_TOOL_OPERATION_HEADERS.requestId]: operation.requestId,
135
- ...(operation.settledOnly ? { [AGENT_TOOL_OPERATION_HEADERS.settledOnly]: 'true' } : {}),
136
- },
137
- body: serializedBody,
138
- });
139
- if (res.headers.get(AGENT_TOOL_OPERATION_HEADERS.protocol) !== AGENT_TOOL_OPERATION_PROTOCOL ||
140
- res.headers.get(AGENT_TOOL_OPERATION_HEADERS.requestId) !== operation.requestId) {
141
- const text = await res.text().catch(() => res.statusText);
142
- if (res.status === 403) {
143
- const pending = pendingAccountActivationError(403, parseErrorPayload(text));
144
- if (pending) {
145
- if (operation.createdNew && !operation.settledOnly)
146
- operation.reject();
147
- throw pending;
148
- }
149
- }
150
- // Possibly an instance that ignores identities: a rerun may only read the receipt.
151
- operation.requireReceipt();
152
- const reason = responseErrorReason(text) || redactDiagnosticText(res.statusText);
153
- throw new Error(`Server response ${res.status}${reason ? `: ${reason}` : ''}; ` +
154
- 'Business did not acknowledge a durable receipt; outcome remains unconfirmed');
155
- }
156
- if (!res.ok) {
157
- const text = await res.text().catch(() => res.statusText);
158
- const pending = pendingAccountActivationError(res.status, parseErrorPayload(text));
159
- if (pending)
160
- throw pending;
161
- const code = errorCode(text);
162
- if (res.status === 409 && code === 'business_operation_in_progress')
163
- throw new ToolRequestError(`API 409: ${text}\nTool request ${operation.requestId} is still running. Rerun the ` +
164
- 'same command later to get its result.');
165
- if (res.status === 409 && code === 'business_operation_requires_reconciliation')
166
- throw new ToolRequestError(recoverId !== undefined
167
- ? // A receipt query never runs the request, even for a tool that can be safely redone.
168
- `API 409: ${text}\nTool request ${operation.requestId} has no settled result yet. ` +
169
- 'Rerun the same command without PLAYCRAFT_TOOL_REQUEST_ID: a tool that can be ' +
170
- 'safely redone continues this request; any other tool then needs reconciliation.'
171
- : `API 409: ${text}\nTool request ${operation.requestId} needs reconciliation: its ` +
172
- 'outcome is unknown, and rerunning the same command will not run it again. Only ' +
173
- 'after confirming it had no effect, rerun with PLAYCRAFT_TOOL_NEW_REQUEST=1 to ' +
174
- 'start a new operation.');
175
- if (res.status >= 400 && res.status < 500) {
176
- // The request itself was refused and not carried out: a rerun is a new operation.
177
- operation.reject();
178
- throw new ToolRequestError(`API ${res.status}: ${text}`);
179
- }
180
- throw new Error(`API ${res.status}: ${text}`);
181
- }
182
- const result = (await res.json());
183
- operation.complete();
184
- return result;
185
- }
186
- catch (error) {
187
- if (error instanceof ToolRequestError || error instanceof AccountActivationError)
188
- throw error;
189
- throw new Error(`${error instanceof Error ? error.message : String(error)}\n${operation.settledOnly
190
- ? `Tool request ${operation.requestId}; record: ${operation.file}. Its settled result is not available yet.`
191
- : unknownOutcome}`, { cause: error });
192
- }
193
- finally {
194
- operation.release();
80
+ if (!res.ok) {
81
+ const text = await res.text().catch(() => res.statusText);
82
+ throw new Error(`API ${res.status}: ${text}`);
195
83
  }
84
+ return res.json();
196
85
  }
197
- async get(path, params, options) {
86
+ async get(path, params) {
198
87
  const url = this.toolsRequestUrl(path);
199
88
  if (params) {
200
89
  for (const [k, v] of Object.entries(params)) {
@@ -204,66 +93,27 @@ export class AgentApiClient {
204
93
  }
205
94
  const res = await fetch(url, {
206
95
  headers: this.authHeaders(),
207
- redirect: 'error',
208
- signal: options?.signal ?? AbortSignal.timeout(30_000),
209
96
  });
210
97
  if (!res.ok) {
211
98
  const text = await res.text().catch(() => res.statusText);
212
- const pending = pendingAccountActivationError(res.status, parseErrorPayload(text));
213
- if (pending)
214
- throw pending;
215
99
  throw new Error(`API ${res.status}: ${text}`);
216
100
  }
217
101
  return res.json();
218
102
  }
219
- /** Stream only to the authenticated, same-service video upload endpoint. */
220
- async putVideoMedia(path, body, headers, signal) {
221
- if (!/^\/video-media\/[a-f0-9-]{36}\/content\?/.test(path))
222
- throw new Error('invalid_video_upload_target');
223
- const url = this.toolsRequestUrl(path);
224
- const keys = [...url.searchParams.keys()].sort();
225
- if (keys.join(',') !== 'expires,signature,workspaceId')
226
- throw new Error('invalid_video_upload_target');
227
- const allowed = new Set(['content-type', 'content-md5', 'content-length']);
228
- if (Object.keys(headers).some(key => !allowed.has(key.toLowerCase())))
229
- throw new Error('invalid_video_upload_headers');
230
- const response = await fetch(url, {
231
- method: 'PUT', redirect: 'error', signal,
232
- headers: { ...headers, ...this.authHeaders() },
233
- body: body,
234
- duplex: 'half',
235
- });
236
- if (!response.ok) {
237
- const text = await response.text().catch(() => response.statusText);
238
- const pending = pendingAccountActivationError(response.status, parseErrorPayload(text));
239
- if (pending)
240
- throw pending;
241
- const reason = responseErrorReason(text) || redactDiagnosticText(response.statusText);
242
- throw new Error(`video_upload_failed:${response.status}${reason ? `: ${reason}` : ''}`);
243
- }
244
- await response.body?.cancel();
245
- }
246
103
  /**
247
104
  * 按顺序搜索本地 .playcraft.json 文件(沙箱内或项目目录)。
248
105
  * 与全局 login 配置(~/.playcraft/config.json)不同,前者专用于沙箱 token。
249
106
  */
250
107
  static loadLocalConfig() {
251
- const ancestors = [];
252
- for (let directory = process.cwd();; directory = dirname(directory)) {
253
- ancestors.push(join(directory, '.playcraft.json'));
254
- if (dirname(directory) === directory)
255
- break;
256
- }
257
108
  const searchPaths = [
258
- process.env.PLAYCRAFT_SANDBOX_CONFIG_PATH || '/workspaces/.playcraft.json',
259
- ...ancestors,
109
+ join(process.cwd(), '.playcraft.json'),
260
110
  '/project/.playcraft.json',
261
111
  join(homedir(), '.playcraft.json'),
262
112
  ];
263
113
  for (const p of searchPaths) {
264
114
  if (existsSync(p)) {
265
115
  try {
266
- return { ...JSON.parse(readFileSync(p, 'utf-8')), credentialFile: p };
116
+ return JSON.parse(readFileSync(p, 'utf-8'));
267
117
  }
268
118
  catch {
269
119
  continue;
@@ -273,33 +123,3 @@ export class AgentApiClient {
273
123
  return { apiUrl: '', token: '' };
274
124
  }
275
125
  }
276
- /** A failure whose meaning is settled; no recovery hint applies. */
277
- class ToolRequestError extends Error {
278
- }
279
- function responseErrorReason(text) {
280
- const payload = parseErrorPayload(text);
281
- const readable = (value, depth = 0) => {
282
- if (typeof value === 'string')
283
- return value;
284
- if (Array.isArray(value))
285
- return value.filter(item => typeof item === 'string').join('; ');
286
- if (!value || typeof value !== 'object' || depth > 2)
287
- return '';
288
- const fields = value;
289
- const message = readable(fields.message, depth + 1) || readable(fields.reason, depth + 1) ||
290
- readable(fields.detail, depth + 1) || readable(fields.error, depth + 1);
291
- const code = typeof fields.code === 'string' ? fields.code : '';
292
- return code && message && code !== message ? `${code}: ${message}` : message || code;
293
- };
294
- // Select diagnostic fields instead of printing the response object and its other data.
295
- return redactDiagnosticText(payload === undefined ? text : readable(payload)).slice(0, 2_000);
296
- }
297
- function errorCode(text) {
298
- try {
299
- const message = JSON.parse(text).message;
300
- return typeof message === 'string' ? message : undefined;
301
- }
302
- catch {
303
- return undefined;
304
- }
305
- }