@playcraft/cli 0.1.40-beta → 0.1.41-prod

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (368) hide show
  1. package/README.md +3 -58
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build-all.js +19 -5
  5. package/dist/commands/build.js +28 -15
  6. package/dist/commands/create.js +33 -26
  7. package/dist/commands/image.js +6 -2
  8. package/dist/commands/login.js +42 -84
  9. package/dist/commands/skills.js +0 -4
  10. package/dist/commands/tools-3d.js +0 -11
  11. package/dist/commands/tools-generation.js +137 -69
  12. package/dist/commands/tools-image-context.js +29 -0
  13. package/dist/commands/tools-utils.js +12 -0
  14. package/dist/commands/tools.js +2 -2
  15. package/dist/config.js +4 -59
  16. package/dist/index.js +3 -40
  17. package/dist/remix/clone.js +0 -2
  18. package/dist/remix/init-template.js +0 -2
  19. package/dist/remix/pull.js +0 -2
  20. package/dist/remix/push.js +1 -21
  21. package/dist/utils/agent-api-client.js +30 -185
  22. package/dist/utils/image-asset-context.js +228 -0
  23. package/dist/utils/playcraft-http-client.js +4 -6
  24. package/package.json +3 -13
  25. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  26. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  29. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  30. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  31. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  35. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  36. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  37. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +135 -63
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  41. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  42. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  43. package/SKILLS_REGISTRY.md +0 -149
  44. package/dist/auth/account-activation.js +0 -157
  45. package/dist/auth/messages.js +0 -30
  46. package/dist/commands/build-temp.js +0 -26
  47. package/dist/commands/platform-skills.generated.js +0 -19
  48. package/dist/commands/playable.js +0 -53
  49. package/dist/commands/tools-batch.js +0 -87
  50. package/dist/commands/video.js +0 -111
  51. package/dist/commands/workspace-runtime.js +0 -54
  52. package/dist/commands/workspace.js +0 -35
  53. package/dist/project-skills/builtin-import.js +0 -225
  54. package/dist/project-skills/commands.js +0 -77
  55. package/dist/project-skills/lifecycle.js +0 -28
  56. package/dist/project-skills/local-run.js +0 -112
  57. package/dist/project-skills/local-store.js +0 -221
  58. package/dist/project-skills/messages.js +0 -80
  59. package/dist/project-skills/reconcile.js +0 -62
  60. package/dist/project-skills/remote-cache.js +0 -51
  61. package/dist/project-skills/validation.js +0 -19
  62. package/dist/recording/messages.js +0 -40
  63. package/dist/recording/project-digest.js +0 -85
  64. package/dist/recording/recorder.js +0 -293
  65. package/dist/recording/scenario.js +0 -50
  66. package/dist/skill-registry/client.js +0 -345
  67. package/dist/skill-registry/commands.js +0 -180
  68. package/dist/skill-registry/evaluation-client.js +0 -156
  69. package/dist/skill-registry/evaluation-commands.js +0 -174
  70. package/dist/skill-registry/messages.js +0 -177
  71. package/dist/skill-registry/package.js +0 -275
  72. package/dist/skill-registry/platform-package.js +0 -100
  73. package/dist/utils/environment-endpoints.js +0 -17
  74. package/dist/utils/tool-operation-journal.js +0 -124
  75. package/dist/utils/video-evidence-git.js +0 -81
  76. package/dist/video-replication/client.js +0 -222
  77. package/dist/video-replication/comparison-evidence.js +0 -149
  78. package/dist/video-replication/comparison-files.js +0 -57
  79. package/dist/video-replication/comparison-log.js +0 -72
  80. package/dist/video-replication/comparison-messages.js +0 -104
  81. package/dist/video-replication/comparison-output.js +0 -63
  82. package/dist/video-replication/comparison-preflight.js +0 -66
  83. package/dist/video-replication/comparison.js +0 -216
  84. package/dist/video-replication/evidence.js +0 -165
  85. package/dist/video-replication/media.js +0 -111
  86. package/dist/video-replication/messages.js +0 -89
  87. package/dist/workspace/messages.js +0 -35
  88. package/dist/workspace/transfer-client.js +0 -174
  89. package/dist/workspace-runtime/codex/app-server.js +0 -1040
  90. package/dist/workspace-runtime/codex/compact.js +0 -46
  91. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  92. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  93. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  94. package/dist/workspace-runtime/codex/loopback.js +0 -146
  95. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  96. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  97. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  98. package/dist/workspace-runtime/codex/permissions.js +0 -70
  99. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  100. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  101. package/dist/workspace-runtime/codex/ui-tools.js +0 -183
  102. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  103. package/dist/workspace-runtime/main.js +0 -10
  104. package/dist/workspace-runtime/persistence/journal.js +0 -365
  105. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  106. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  107. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  108. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  109. package/dist/workspace-runtime/previews/output.js +0 -36
  110. package/dist/workspace-runtime/previews/publish.js +0 -262
  111. package/dist/workspace-runtime/previews/single-file.js +0 -43
  112. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  113. package/dist/workspace-runtime/production/content-changes.js +0 -36
  114. package/dist/workspace-runtime/production/contracts.js +0 -19
  115. package/dist/workspace-runtime/production/controller.js +0 -218
  116. package/dist/workspace-runtime/production/dependencies.js +0 -60
  117. package/dist/workspace-runtime/production/native.js +0 -212
  118. package/dist/workspace-runtime/production/processes.js +0 -102
  119. package/dist/workspace-runtime/production/save-command.js +0 -35
  120. package/dist/workspace-runtime/production/source-archive.js +0 -137
  121. package/dist/workspace-runtime/production/source-copy.js +0 -91
  122. package/dist/workspace-runtime/production/stages.js +0 -334
  123. package/dist/workspace-runtime/production/storage.js +0 -75
  124. package/dist/workspace-runtime/serve.js +0 -214
  125. package/dist/workspace-runtime/server/auth.js +0 -21
  126. package/dist/workspace-runtime/server/connectivity.js +0 -201
  127. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  128. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  129. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  130. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  131. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  132. package/dist/workspace-runtime/server/dispatch.js +0 -1217
  133. package/dist/workspace-runtime/server/endpoints.js +0 -21
  134. package/dist/workspace-runtime/server/execution-group.js +0 -90
  135. package/dist/workspace-runtime/server/http.js +0 -1243
  136. package/dist/workspace-runtime/server/lock.js +0 -53
  137. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  138. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  139. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  140. package/dist/workspace-runtime/server/types.js +0 -1
  141. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  142. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  143. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  144. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  145. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  146. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  147. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  148. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  149. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  150. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  151. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  152. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  153. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  154. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  155. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  156. package/dist/workspace-runtime/workspaces/directories.js +0 -133
  157. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  158. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  159. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  160. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  161. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  162. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  163. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  164. package/dist/workspace-runtime/workspaces/files.js +0 -138
  165. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  166. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  167. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  168. package/dist/workspace-runtime/workspaces/git.js +0 -670
  169. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  170. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  171. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  172. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  173. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  174. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  175. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  176. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  177. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  178. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  179. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  180. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  181. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  182. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  183. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  184. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  185. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  186. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  187. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  188. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  189. package/project-template-v2/.claude/agents/artist.md +0 -82
  190. package/project-template-v2/.claude/agents/developer.md +0 -153
  191. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  192. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  193. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  194. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  195. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  196. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  197. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  198. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  199. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  200. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  201. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  202. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  203. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  204. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  205. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  206. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  207. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  208. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  209. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  210. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  211. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  212. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  213. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  214. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  215. package/project-template-v2/.claude/settings.json +0 -33
  216. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  219. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  220. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  221. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  222. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  223. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  224. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  225. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  226. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  227. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  228. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  229. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  230. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  236. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  237. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  238. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  239. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  240. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  241. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  242. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  243. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  244. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  245. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  246. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  247. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  248. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  249. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  250. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  251. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  252. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  253. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  254. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  255. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  256. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  257. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  258. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  259. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  260. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  261. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  262. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  263. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  264. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  269. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  270. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  271. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  272. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  273. package/project-template-v2/.claude/snapshot.mjs +0 -263
  274. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  275. package/project-template-v2/CLAUDE.md +0 -146
  276. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  277. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  278. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  281. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  282. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  283. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  284. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  285. package/project-template-v2/assets/models/.gitkeep +0 -0
  286. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  287. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  288. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  289. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  290. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  291. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  292. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  293. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  294. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  295. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  296. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  297. package/project-template-v2/docs/project-state.json +0 -60
  298. package/project-template-v2/docs/project-state.md +0 -72
  299. package/project-template-v2/docs/standards/README.md +0 -225
  300. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  301. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  302. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  303. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  304. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  305. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  306. package/project-template-v2/game/index.ts +0 -18
  307. package/project-template-v2/globals.d.ts +0 -51
  308. package/project-template-v2/index.css +0 -34
  309. package/project-template-v2/index.html +0 -18
  310. package/project-template-v2/main.ts +0 -9
  311. package/project-template-v2/package.json +0 -46
  312. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  313. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  314. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  315. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  316. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  317. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  318. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  319. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  320. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  321. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  322. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  323. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  324. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  325. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  326. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  327. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  328. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  329. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  330. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  331. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  332. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  333. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  334. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  335. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  336. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  337. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  338. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  339. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  340. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  341. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  342. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  343. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  344. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  345. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  346. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  347. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  348. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  349. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  350. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  351. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  354. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  355. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  356. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  357. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  358. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  359. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  360. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  361. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  362. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  363. package/project-template-v2/tsconfig.json +0 -20
  364. package/project-template-v2/vite.config.ts +0 -27
  365. package/project-templates/batch-locks/phaser.yaml +0 -922
  366. package/project-templates/batch-locks/threejs.yaml +0 -978
  367. package/project-templates/empty/AGENTS.md +0 -41
  368. package/project-templates/empty/gitignore +0 -33
@@ -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,12 +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 { AccountActivationError, parseErrorPayload, pendingAccountActivationError, } from '../auth/account-activation.js';
10
6
  /**
11
7
  * 判断 token 是否为用户 PAT(Personal Access Token)。
12
8
  * PAT 以 "playcraft_pat_" 开头;沙箱 JWT 为三段式 base64。
@@ -19,8 +15,8 @@ function isPatToken(token) {
19
15
  * or from the CLI after `playcraft login`.
20
16
  *
21
17
  * 凭证解析优先级:
22
- * API URL : PLAYCRAFT_API_URL → sandbox global .playcraft.json → project .playcraft.json → ~/.playcraft/config.json → DEFAULT_PLAYCRAFT_CLOUD_BASE
23
- * 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)
24
20
  *
25
21
  * 鉴权 header 自动选择:
26
22
  * - 沙箱 JWT (非 PAT) → X-Sandbox-Token: <token>(后端 @SandboxToken 路由的沙箱分支)
@@ -29,7 +25,7 @@ function isPatToken(token) {
29
25
  export class AgentApiClient {
30
26
  apiUrl;
31
27
  token;
32
- credentialFile;
28
+ isPat;
33
29
  playcraftEnv;
34
30
  constructor() {
35
31
  const localConfig = AgentApiClient.loadLocalConfig();
@@ -40,7 +36,7 @@ export class AgentApiClient {
40
36
  globalConfig.backendUrl ||
41
37
  globalConfig.url ||
42
38
  DEFAULT_PLAYCRAFT_CLOUD_BASE).replace(/\/+$/, '');
43
- // Token: 环境变量 → 沙箱全局配置 → 项目配置 → 用户登录配置
39
+ // Token: 沙箱 token 环境变量 → 本地 .playcraft.json → 全局 login 配置(PAT)
44
40
  const token = process.env.PLAYCRAFT_SANDBOX_TOKEN ||
45
41
  localConfig.token ||
46
42
  globalConfig.token ||
@@ -51,147 +47,43 @@ export class AgentApiClient {
51
47
  }
52
48
  this.apiUrl = apiUrl;
53
49
  this.token = token;
54
- this.credentialFile = localConfig.credentialFile;
55
- 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();
56
54
  }
57
55
  /** 根据 token 类型构造鉴权 headers */
58
56
  authHeaders() {
59
- let token = this.token;
60
- // Polling commands can outlive a credential: read the atomically refreshed file per request.
61
- if (this.credentialFile && !process.env.PLAYCRAFT_SANDBOX_TOKEN) {
62
- try {
63
- token = JSON.parse(readFileSync(this.credentialFile, 'utf8')).token || token;
64
- }
65
- catch { /* Keep the last credential if a local file is temporarily unavailable. */ }
66
- }
67
- const headers = isPatToken(token)
68
- ? { Authorization: `Bearer ${token}` }
69
- : { 'X-Sandbox-Token': token };
57
+ const headers = this.isPat
58
+ ? { Authorization: `Bearer ${this.token}` }
59
+ : { 'X-Sandbox-Token': this.token };
70
60
  if (this.playcraftEnv) {
71
61
  headers['playcraft-env'] = this.playcraftEnv;
72
62
  }
73
63
  return headers;
74
64
  }
75
- /** Deployment-relative pathname under /api/agent/tools (path may omit leading slash). */
65
+ /** Absolute pathname under /api/agent/tools (path may omit leading slash). */
76
66
  toolsRequestUrl(path) {
77
67
  const p = path.startsWith('/') ? path : `/${path}`;
78
- return businessEndpoint(this.apiUrl, `/api/agent/tools${p}`);
68
+ return new URL(`/api/agent/tools${p}`, this.apiUrl);
79
69
  }
80
- async post(path, body, options) {
81
- const url = this.toolsRequestUrl(path);
82
- const serializedBody = JSON.stringify(body);
83
- if (serializedBody === undefined)
84
- throw new Error('Tool request body is required');
85
- const recoverId = options?.requestId ?? process.env.PLAYCRAFT_TOOL_REQUEST_ID;
86
- const operation = beginToolOperation(url.pathname, serializedBody, recoverId, {
87
- 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),
88
79
  });
89
- const unknownOutcome = `Tool request ${operation.requestId}: the outcome is unknown. Rerun the same command to ` +
90
- `continue this request: it returns the result if the request finished, or finishes it if ` +
91
- `the tool can be safely redone; it never starts a second operation. Record: ${operation.file}.`;
92
- try {
93
- try {
94
- await options?.onPrepared?.({ requestId: operation.requestId, file: operation.file });
95
- }
96
- catch {
97
- operation.reject();
98
- throw new ToolRequestError('Tool request preparation failed; no operation was sent');
99
- }
100
- const capabilityResponse = await fetch(this.toolsRequestUrl(AGENT_TOOL_OPERATION_CAPABILITIES_PATH), {
101
- headers: this.authHeaders(),
102
- redirect: 'error',
103
- signal: options?.signal
104
- ? AbortSignal.any([options.signal, AbortSignal.timeout(30_000)])
105
- : AbortSignal.timeout(30_000),
106
- });
107
- if (!capabilityResponse.ok) {
108
- if (capabilityResponse.status === 403) {
109
- const pending = pendingAccountActivationError(403, parseErrorPayload(await capabilityResponse.clone().text().catch(() => '')));
110
- if (pending) {
111
- if (operation.createdNew && !operation.settledOnly)
112
- operation.reject();
113
- throw pending;
114
- }
115
- }
116
- await capabilityResponse.body?.cancel();
117
- throw new ToolRequestError(`Business tool protocol unavailable (${capabilityResponse.status}); no operation was sent`);
118
- }
119
- const capabilities = (await capabilityResponse.json());
120
- if (capabilities.protocol !== AGENT_TOOL_OPERATION_PROTOCOL ||
121
- capabilities.settledOnly !== true)
122
- throw new ToolRequestError('Business tool protocol is incompatible; no operation was sent');
123
- const res = await fetch(url, {
124
- method: 'POST',
125
- redirect: 'error',
126
- signal: options?.signal
127
- ? AbortSignal.any([options.signal, AbortSignal.timeout(30 * 60_000)])
128
- : AbortSignal.timeout(30 * 60_000),
129
- headers: {
130
- 'Content-Type': 'application/json',
131
- ...this.authHeaders(),
132
- [AGENT_TOOL_OPERATION_HEADERS.protocol]: AGENT_TOOL_OPERATION_PROTOCOL,
133
- [AGENT_TOOL_OPERATION_HEADERS.requestId]: operation.requestId,
134
- ...(operation.settledOnly ? { [AGENT_TOOL_OPERATION_HEADERS.settledOnly]: 'true' } : {}),
135
- },
136
- body: serializedBody,
137
- });
138
- if (res.headers.get(AGENT_TOOL_OPERATION_HEADERS.protocol) !== AGENT_TOOL_OPERATION_PROTOCOL ||
139
- res.headers.get(AGENT_TOOL_OPERATION_HEADERS.requestId) !== operation.requestId) {
140
- if (res.status === 403) {
141
- const pending = pendingAccountActivationError(403, parseErrorPayload(await res.clone().text().catch(() => '')));
142
- if (pending) {
143
- if (operation.createdNew && !operation.settledOnly)
144
- operation.reject();
145
- throw pending;
146
- }
147
- }
148
- await res.body?.cancel();
149
- // Possibly an instance that ignores identities: a rerun may only read the receipt.
150
- operation.requireReceipt();
151
- throw new Error('Business did not acknowledge a durable receipt; outcome remains unconfirmed');
152
- }
153
- if (!res.ok) {
154
- const text = await res.text().catch(() => res.statusText);
155
- const pending = pendingAccountActivationError(res.status, parseErrorPayload(text));
156
- if (pending)
157
- throw pending;
158
- const code = errorCode(text);
159
- if (res.status === 409 && code === 'business_operation_in_progress')
160
- throw new ToolRequestError(`API 409: ${text}\nTool request ${operation.requestId} is still running. Rerun the ` +
161
- 'same command later to get its result.');
162
- if (res.status === 409 && code === 'business_operation_requires_reconciliation')
163
- throw new ToolRequestError(recoverId !== undefined
164
- ? // A receipt query never runs the request, even for a tool that can be safely redone.
165
- `API 409: ${text}\nTool request ${operation.requestId} has no settled result yet. ` +
166
- 'Rerun the same command without PLAYCRAFT_TOOL_REQUEST_ID: a tool that can be ' +
167
- 'safely redone continues this request; any other tool then needs reconciliation.'
168
- : `API 409: ${text}\nTool request ${operation.requestId} needs reconciliation: its ` +
169
- 'outcome is unknown, and rerunning the same command will not run it again. Only ' +
170
- 'after confirming it had no effect, rerun with PLAYCRAFT_TOOL_NEW_REQUEST=1 to ' +
171
- 'start a new operation.');
172
- if (res.status >= 400 && res.status < 500) {
173
- // The request itself was refused and not carried out: a rerun is a new operation.
174
- operation.reject();
175
- throw new ToolRequestError(`API ${res.status}: ${text}`);
176
- }
177
- throw new Error(`API ${res.status}: ${text}`);
178
- }
179
- const result = (await res.json());
180
- operation.complete();
181
- return result;
182
- }
183
- catch (error) {
184
- if (error instanceof ToolRequestError || error instanceof AccountActivationError)
185
- throw error;
186
- throw new Error(`${error instanceof Error ? error.message : String(error)}\n${operation.settledOnly
187
- ? `Tool request ${operation.requestId}; record: ${operation.file}. Its settled result is not available yet.`
188
- : unknownOutcome}`);
189
- }
190
- finally {
191
- operation.release();
80
+ if (!res.ok) {
81
+ const text = await res.text().catch(() => res.statusText);
82
+ throw new Error(`API ${res.status}: ${text}`);
192
83
  }
84
+ return res.json();
193
85
  }
194
- async get(path, params, options) {
86
+ async get(path, params) {
195
87
  const url = this.toolsRequestUrl(path);
196
88
  if (params) {
197
89
  for (const [k, v] of Object.entries(params)) {
@@ -201,62 +93,27 @@ export class AgentApiClient {
201
93
  }
202
94
  const res = await fetch(url, {
203
95
  headers: this.authHeaders(),
204
- redirect: 'error',
205
- signal: options?.signal ?? AbortSignal.timeout(30_000),
206
96
  });
207
97
  if (!res.ok) {
208
98
  const text = await res.text().catch(() => res.statusText);
209
- const pending = pendingAccountActivationError(res.status, parseErrorPayload(text));
210
- if (pending)
211
- throw pending;
212
99
  throw new Error(`API ${res.status}: ${text}`);
213
100
  }
214
101
  return res.json();
215
102
  }
216
- /** Stream only to the authenticated, same-service video upload endpoint. */
217
- async putVideoMedia(path, body, headers, signal) {
218
- if (!/^\/video-media\/[a-f0-9-]{36}\/content\?/.test(path))
219
- throw new Error('invalid_video_upload_target');
220
- const url = this.toolsRequestUrl(path);
221
- const keys = [...url.searchParams.keys()].sort();
222
- if (keys.join(',') !== 'expires,signature,workspaceId')
223
- throw new Error('invalid_video_upload_target');
224
- const allowed = new Set(['content-type', 'content-md5', 'content-length']);
225
- if (Object.keys(headers).some(key => !allowed.has(key.toLowerCase())))
226
- throw new Error('invalid_video_upload_headers');
227
- const response = await fetch(url, {
228
- method: 'PUT', redirect: 'error', signal,
229
- headers: { ...headers, ...this.authHeaders() },
230
- body: body,
231
- duplex: 'half',
232
- });
233
- if (!response.ok) {
234
- await response.body?.cancel();
235
- throw new Error(`video_upload_failed:${response.status}`);
236
- }
237
- await response.body?.cancel();
238
- }
239
103
  /**
240
104
  * 按顺序搜索本地 .playcraft.json 文件(沙箱内或项目目录)。
241
105
  * 与全局 login 配置(~/.playcraft/config.json)不同,前者专用于沙箱 token。
242
106
  */
243
107
  static loadLocalConfig() {
244
- const ancestors = [];
245
- for (let directory = process.cwd();; directory = dirname(directory)) {
246
- ancestors.push(join(directory, '.playcraft.json'));
247
- if (dirname(directory) === directory)
248
- break;
249
- }
250
108
  const searchPaths = [
251
- process.env.PLAYCRAFT_SANDBOX_CONFIG_PATH || '/workspaces/.playcraft.json',
252
- ...ancestors,
109
+ join(process.cwd(), '.playcraft.json'),
253
110
  '/project/.playcraft.json',
254
111
  join(homedir(), '.playcraft.json'),
255
112
  ];
256
113
  for (const p of searchPaths) {
257
114
  if (existsSync(p)) {
258
115
  try {
259
- return { ...JSON.parse(readFileSync(p, 'utf-8')), credentialFile: p };
116
+ return JSON.parse(readFileSync(p, 'utf-8'));
260
117
  }
261
118
  catch {
262
119
  continue;
@@ -266,15 +123,3 @@ export class AgentApiClient {
266
123
  return { apiUrl: '', token: '' };
267
124
  }
268
125
  }
269
- /** A failure whose meaning is settled; no recovery hint applies. */
270
- class ToolRequestError extends Error {
271
- }
272
- function errorCode(text) {
273
- try {
274
- const message = JSON.parse(text).message;
275
- return typeof message === 'string' ? message : undefined;
276
- }
277
- catch {
278
- return undefined;
279
- }
280
- }