@playcraft/cli 0.1.53-beta → 0.1.54

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (400) hide show
  1. package/README.md +3 -62
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build-all.js +19 -5
  5. package/dist/commands/build.js +28 -15
  6. package/dist/commands/create.js +33 -26
  7. package/dist/commands/login.js +42 -84
  8. package/dist/commands/skills.js +0 -4
  9. package/dist/commands/tools-3d.js +0 -11
  10. package/dist/commands/tools-generation.js +0 -6
  11. package/dist/commands/tools.js +0 -2
  12. package/dist/config.js +4 -59
  13. package/dist/index.js +3 -42
  14. package/dist/remix/clone.js +0 -2
  15. package/dist/remix/init-template.js +0 -2
  16. package/dist/remix/pull.js +0 -2
  17. package/dist/remix/push.js +1 -21
  18. package/dist/utils/agent-api-client.js +30 -210
  19. package/dist/utils/playcraft-http-client.js +4 -6
  20. package/package.json +5 -15
  21. package/SKILLS_REGISTRY.md +0 -149
  22. package/dist/auth/account-activation.js +0 -157
  23. package/dist/auth/messages.js +0 -30
  24. package/dist/commands/build-temp.js +0 -26
  25. package/dist/commands/platform-skills.generated.js +0 -19
  26. package/dist/commands/playable.js +0 -53
  27. package/dist/commands/preview-runtime.js +0 -21
  28. package/dist/commands/tools-batch.js +0 -113
  29. package/dist/commands/video.js +0 -122
  30. package/dist/commands/workspace-runtime.js +0 -54
  31. package/dist/commands/workspace.js +0 -40
  32. package/dist/preview-runtime/distribution.js +0 -77
  33. package/dist/project-skills/builtin-import.js +0 -225
  34. package/dist/project-skills/commands.js +0 -77
  35. package/dist/project-skills/lifecycle.js +0 -28
  36. package/dist/project-skills/local-run.js +0 -112
  37. package/dist/project-skills/local-store.js +0 -221
  38. package/dist/project-skills/messages.js +0 -80
  39. package/dist/project-skills/reconcile.js +0 -62
  40. package/dist/project-skills/remote-cache.js +0 -51
  41. package/dist/project-skills/validation.js +0 -19
  42. package/dist/recording/messages.js +0 -40
  43. package/dist/recording/project-digest.js +0 -85
  44. package/dist/recording/recorder.js +0 -293
  45. package/dist/recording/scenario.js +0 -50
  46. package/dist/skill-registry/client.js +0 -345
  47. package/dist/skill-registry/commands.js +0 -180
  48. package/dist/skill-registry/evaluation-client.js +0 -156
  49. package/dist/skill-registry/evaluation-commands.js +0 -174
  50. package/dist/skill-registry/messages.js +0 -177
  51. package/dist/skill-registry/package.js +0 -275
  52. package/dist/skill-registry/platform-package.js +0 -100
  53. package/dist/utils/environment-endpoints.js +0 -17
  54. package/dist/utils/error-diagnostics.js +0 -20
  55. package/dist/utils/tool-operation-journal.js +0 -124
  56. package/dist/utils/video-evidence-git.js +0 -81
  57. package/dist/video-replication/client.js +0 -234
  58. package/dist/video-replication/comparison-evidence.js +0 -149
  59. package/dist/video-replication/comparison-files.js +0 -57
  60. package/dist/video-replication/comparison-log.js +0 -72
  61. package/dist/video-replication/comparison-messages.js +0 -104
  62. package/dist/video-replication/comparison-output.js +0 -63
  63. package/dist/video-replication/comparison-preflight.js +0 -66
  64. package/dist/video-replication/comparison.js +0 -230
  65. package/dist/video-replication/diagnostics.js +0 -41
  66. package/dist/video-replication/evidence.js +0 -165
  67. package/dist/video-replication/media.js +0 -112
  68. package/dist/video-replication/messages.js +0 -97
  69. package/dist/workspace/messages.js +0 -67
  70. package/dist/workspace/transfer-client.js +0 -237
  71. package/dist/workspace/transfer-errors.js +0 -48
  72. package/dist/workspace-runtime/batch/content-changes.js +0 -30
  73. package/dist/workspace-runtime/batch/control.js +0 -86
  74. package/dist/workspace-runtime/batch/deliver.js +0 -173
  75. package/dist/workspace-runtime/batch/freeze.js +0 -101
  76. package/dist/workspace-runtime/batch/generate.js +0 -249
  77. package/dist/workspace-runtime/batch/git.js +0 -40
  78. package/dist/workspace-runtime/batch/occupancy.js +0 -8
  79. package/dist/workspace-runtime/batch/policy.js +0 -70
  80. package/dist/workspace-runtime/batch/prepare.js +0 -317
  81. package/dist/workspace-runtime/batch/processes.js +0 -72
  82. package/dist/workspace-runtime/batch/records.js +0 -113
  83. package/dist/workspace-runtime/batch/routes.js +0 -61
  84. package/dist/workspace-runtime/batch/source-candidate.js +0 -86
  85. package/dist/workspace-runtime/batch/source-capture.js +0 -146
  86. package/dist/workspace-runtime/batch/source-failure.js +0 -43
  87. package/dist/workspace-runtime/batch/source-publish.js +0 -130
  88. package/dist/workspace-runtime/codex/app-server.js +0 -1065
  89. package/dist/workspace-runtime/codex/compact.js +0 -46
  90. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  91. package/dist/workspace-runtime/codex/delivery-tools.js +0 -144
  92. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  93. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  94. package/dist/workspace-runtime/codex/loopback.js +0 -146
  95. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  96. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  97. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  98. package/dist/workspace-runtime/codex/permissions.js +0 -79
  99. package/dist/workspace-runtime/codex/thread-image.js +0 -38
  100. package/dist/workspace-runtime/codex/tool-response.js +0 -10
  101. package/dist/workspace-runtime/codex/ui-instructions.js +0 -4
  102. package/dist/workspace-runtime/codex/ui-tools.js +0 -203
  103. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  104. package/dist/workspace-runtime/main.js +0 -10
  105. package/dist/workspace-runtime/persistence/journal.js +0 -365
  106. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  107. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  108. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1161
  109. package/dist/workspace-runtime/persistence/stopped-execution.js +0 -77
  110. package/dist/workspace-runtime/previews/diagnostics.js +0 -44
  111. package/dist/workspace-runtime/previews/output.js +0 -36
  112. package/dist/workspace-runtime/previews/publish.js +0 -283
  113. package/dist/workspace-runtime/previews/runtime-preview.js +0 -251
  114. package/dist/workspace-runtime/previews/single-file.js +0 -43
  115. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  116. package/dist/workspace-runtime/serve.js +0 -441
  117. package/dist/workspace-runtime/server/accept-operation.js +0 -61
  118. package/dist/workspace-runtime/server/asset-transfers.js +0 -63
  119. package/dist/workspace-runtime/server/auth.js +0 -21
  120. package/dist/workspace-runtime/server/connectivity.js +0 -211
  121. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  122. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  123. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  124. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  125. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  126. package/dist/workspace-runtime/server/dispatch.js +0 -1655
  127. package/dist/workspace-runtime/server/endpoints.js +0 -21
  128. package/dist/workspace-runtime/server/execution-group.js +0 -90
  129. package/dist/workspace-runtime/server/http.js +0 -1339
  130. package/dist/workspace-runtime/server/lock.js +0 -53
  131. package/dist/workspace-runtime/server/operation-record.js +0 -33
  132. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  133. package/dist/workspace-runtime/server/session-restore.js +0 -84
  134. package/dist/workspace-runtime/server/source-uploader.js +0 -138
  135. package/dist/workspace-runtime/server/submit-operation.js +0 -41
  136. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  137. package/dist/workspace-runtime/server/types.js +0 -1
  138. package/dist/workspace-runtime/server/workspace-transfer.js +0 -168
  139. package/dist/workspace-runtime/verify-artifact.js +0 -59
  140. package/dist/workspace-runtime/workspaces/append-only-log.js +0 -62
  141. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  142. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  143. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -199
  144. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  145. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  146. package/dist/workspace-runtime/workspaces/asset-library-import.js +0 -387
  147. package/dist/workspace-runtime/workspaces/asset-publication-access.js +0 -25
  148. package/dist/workspace-runtime/workspaces/asset-transfer-dependencies.js +0 -81
  149. package/dist/workspace-runtime/workspaces/asset-transfer-publish.js +0 -438
  150. package/dist/workspace-runtime/workspaces/asset-transfer-storage.js +0 -389
  151. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -73
  152. package/dist/workspace-runtime/workspaces/attachments.js +0 -185
  153. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  154. package/dist/workspace-runtime/workspaces/binary-content.js +0 -65
  155. package/dist/workspace-runtime/workspaces/binary-write.js +0 -117
  156. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  157. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -115
  158. package/dist/workspace-runtime/workspaces/composer-context.js +0 -147
  159. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  160. package/dist/workspace-runtime/workspaces/delivery-build.js +0 -331
  161. package/dist/workspace-runtime/workspaces/delivery-store.js +0 -168
  162. package/dist/workspace-runtime/workspaces/delivery.js +0 -64
  163. package/dist/workspace-runtime/workspaces/dependencies.js +0 -279
  164. package/dist/workspace-runtime/workspaces/developer-command.js +0 -98
  165. package/dist/workspace-runtime/workspaces/directories.js +0 -132
  166. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  167. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  168. package/dist/workspace-runtime/workspaces/directory-create.js +0 -57
  169. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  170. package/dist/workspace-runtime/workspaces/directory-mutations.js +0 -238
  171. package/dist/workspace-runtime/workspaces/directory-revisions.js +0 -56
  172. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  173. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  174. package/dist/workspace-runtime/workspaces/empty-template.js +0 -42
  175. package/dist/workspace-runtime/workspaces/file-content.js +0 -48
  176. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  177. package/dist/workspace-runtime/workspaces/files.js +0 -150
  178. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  179. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  180. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  181. package/dist/workspace-runtime/workspaces/git.js +0 -670
  182. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  183. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -313
  184. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  185. package/dist/workspace-runtime/workspaces/operation-log.js +0 -23
  186. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +0 -14
  187. package/dist/workspace-runtime/workspaces/parameter-agent-inputs.js +0 -97
  188. package/dist/workspace-runtime/workspaces/parameter-agent-protocol.js +0 -40
  189. package/dist/workspace-runtime/workspaces/parameter-agent-store.js +0 -58
  190. package/dist/workspace-runtime/workspaces/parameter-agent.js +0 -284
  191. package/dist/workspace-runtime/workspaces/parameter-assets.js +0 -189
  192. package/dist/workspace-runtime/workspaces/parameters.js +0 -329
  193. package/dist/workspace-runtime/workspaces/prepare.js +0 -278
  194. package/dist/workspace-runtime/workspaces/registry.js +0 -251
  195. package/dist/workspace-runtime/workspaces/remix-references.js +0 -301
  196. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  197. package/dist/workspace-runtime/workspaces/session-image.js +0 -104
  198. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  199. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -95
  200. package/dist/workspace-runtime/workspaces/skills.js +0 -191
  201. package/dist/workspace-runtime/workspaces/theme-asset-index.js +0 -157
  202. package/dist/workspace-runtime/workspaces/transfer-quota.js +0 -69
  203. package/dist/workspace-runtime/workspaces/transfer.js +0 -471
  204. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  205. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  206. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  207. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  208. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  209. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  210. package/project-template-v2/.claude/agents/artist.md +0 -82
  211. package/project-template-v2/.claude/agents/developer.md +0 -153
  212. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  213. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  214. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  215. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  216. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  217. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  218. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  219. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  220. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  221. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  222. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  223. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  224. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  225. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  226. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  227. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  228. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  229. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  230. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  231. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  232. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  233. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  234. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  235. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  236. package/project-template-v2/.claude/settings.json +0 -33
  237. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  238. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  239. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  240. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  241. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  242. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  243. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  244. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  245. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  246. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  247. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  248. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  249. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  250. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  251. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  252. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -370
  253. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  254. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  255. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -333
  256. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -95
  257. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  258. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -136
  259. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  260. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  261. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  262. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  263. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  264. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  265. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  266. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  267. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  268. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  269. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  270. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  271. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  272. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  273. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  274. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  275. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  276. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  277. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  278. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  279. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  280. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  281. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  282. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  283. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  284. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  285. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  286. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  287. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  288. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  289. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  290. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  291. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  292. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  293. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  294. package/project-template-v2/.claude/snapshot.mjs +0 -263
  295. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  296. package/project-template-v2/CLAUDE.md +0 -146
  297. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  298. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  299. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  300. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  301. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  302. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  303. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  304. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  305. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  306. package/project-template-v2/assets/models/.gitkeep +0 -0
  307. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  308. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  309. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  310. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  311. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  312. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  313. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  314. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  315. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  316. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  317. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  318. package/project-template-v2/docs/project-state.json +0 -60
  319. package/project-template-v2/docs/project-state.md +0 -72
  320. package/project-template-v2/docs/standards/README.md +0 -225
  321. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  322. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  323. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  324. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  325. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  326. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  327. package/project-template-v2/game/index.ts +0 -18
  328. package/project-template-v2/globals.d.ts +0 -51
  329. package/project-template-v2/index.css +0 -34
  330. package/project-template-v2/index.html +0 -18
  331. package/project-template-v2/main.ts +0 -9
  332. package/project-template-v2/package.json +0 -46
  333. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  334. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  335. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  336. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  337. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  338. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  339. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  340. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  341. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  342. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  343. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  344. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  345. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  346. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  347. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  348. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  349. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  350. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  351. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  352. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  353. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  354. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  355. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  356. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  357. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  358. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  359. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  360. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  361. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  362. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  363. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  364. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  365. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  366. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  367. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  368. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  369. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  370. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  371. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  372. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  373. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  374. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  375. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  376. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  377. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  378. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  379. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  380. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  381. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  382. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  383. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  384. package/project-template-v2/tsconfig.json +0 -20
  385. package/project-template-v2/vite.config.ts +0 -27
  386. package/project-templates/batch-locks/phaser.yaml +0 -922
  387. package/project-templates/batch-locks/threejs.yaml +0 -978
  388. package/project-templates/empty/AGENTS.md +0 -41
  389. package/project-templates/empty/gitignore +0 -33
  390. package/templates/preview-runtime/v1/README.md +0 -71
  391. package/templates/preview-runtime/v1/build-preview.mjs +0 -1324
  392. package/templates/preview-runtime/v1/manifest.json +0 -17
  393. package/templates/preview-runtime/v1/release-guard.mjs +0 -87
  394. package/templates/preview-runtime/v1/runtime.d.mts +0 -3
  395. package/templates/preview-runtime/v1/runtime.d.ts +0 -3
  396. package/templates/preview-runtime/v1/runtime.mjs +0 -1121
  397. package/templates/preview-runtime/v1/types/adapters.d.ts +0 -26
  398. package/templates/preview-runtime/v1/types/preview.d.ts +0 -23
  399. package/templates/preview-runtime/v1/types/protocol.d.ts +0 -94
  400. package/templates/preview-runtime/v1/types/runtime.d.ts +0 -14
@@ -1,56 +0,0 @@
1
- import { createHash } from 'node:crypto';
2
- import { lstat } from 'node:fs/promises';
3
- import { join } from 'node:path';
4
- import { isMutableWorkspaceDirectoryPath } from '@playcraft/common/cloud-workspace/runtime';
5
- import { listWorkspaceFiles } from './files.js';
6
- /** Reuse the listing's streamed hashes; only directory and preservation-marker metadata is sampled again. */
7
- export async function observeWorkspaceDirectories(root, journal, scope, listed) {
8
- const previous = journal.fileRevisions(scope);
9
- const result = listed ?? await listWorkspaceFiles(root, previous);
10
- const directoryRevisions = {};
11
- const fingerprints = new Map();
12
- for (const path of result.directories ?? []) {
13
- if (!isMutableWorkspaceDirectoryPath(path)
14
- || result.unreadablePaths?.some(item => item === path || item.startsWith(`${path}/`)))
15
- continue;
16
- const stat = await lstat(join(root, ...path.split('/')));
17
- if (!stat.isDirectory() || stat.isSymbolicLink())
18
- continue;
19
- const marker = await lstat(join(root, ...path.split('/'), '.gitkeep')).catch(error => {
20
- if (error.code !== 'ENOENT')
21
- throw error;
22
- return undefined;
23
- });
24
- fingerprints.set(path, JSON.stringify([path, stat.dev, stat.ino, stat.mtimeMs, stat.ctimeMs,
25
- marker && [marker.dev, marker.ino, marker.size, marker.mtimeMs, marker.ctimeMs]]));
26
- }
27
- for (const [path] of fingerprints) {
28
- const hash = createHash('sha256').update('directory\0');
29
- for (const [child, metadata] of fingerprints)
30
- if (child === path || child.startsWith(`${path}/`))
31
- hash.update(metadata);
32
- for (const file of result.files)
33
- if (file.path.startsWith(`${path}/`))
34
- hash.update(JSON.stringify([file.path, file.contentHash, file.size]));
35
- const contentHash = hash.digest('hex');
36
- const old = previous[path];
37
- const revision = old ? old.revision + Number(old.contentHash !== contentHash) : 0;
38
- if (!old || old.contentHash !== contentHash)
39
- await journal.putFileRevision(path, { revision, contentHash }, scope);
40
- directoryRevisions[path] = revision;
41
- }
42
- for (const file of result.files) {
43
- const old = previous[file.path];
44
- const revision = old ? old.revision + Number(old.contentHash !== file.contentHash) : 0;
45
- if (!old || old.contentHash !== file.contentHash)
46
- await journal.putFileRevision(file.path, { revision, contentHash: file.contentHash }, scope);
47
- file.revision = revision;
48
- }
49
- // Retain tombstones so recreating the same path cannot satisfy an old revision.
50
- const present = new Set([...result.files.map(file => file.path), ...(result.directories ?? [])]);
51
- for (const [path, old] of Object.entries(previous)) {
52
- if (old.contentHash && !present.has(path) && !result.unreadablePaths?.some(item => path === item || path.startsWith(`${item}/`)))
53
- await journal.putFileRevision(path, { revision: old.revision + 1, contentHash: '' }, scope);
54
- }
55
- return { ...result, directoryRevisions };
56
- }
@@ -1,49 +0,0 @@
1
- import { execFile } from 'node:child_process';
2
- import { promisify } from 'node:util';
3
- import { workspaceRoot, WorkspaceContextError } from './registry.js';
4
- const execute = promisify(execFile);
5
- /** Measures registered checkouts only when requested; journal activity never scans private neighboring workspaces. */
6
- export async function readWorkspaceDirectoryStats(state, workspaceId) {
7
- const binding = state.journal.getWorkspace(workspaceId);
8
- if (!binding)
9
- throw new WorkspaceContextError('workspace_not_registered');
10
- const names = [...new Set(['basic', ...(binding.directories ?? []).map(directory => directory.directoryName)])];
11
- const operations = state.journal.listOperations().map(item => item.operation).filter(operation => operation.workspaceId === workspaceId);
12
- const events = state.journal.listEvents().flatMap(event => {
13
- const payload = event.payload && typeof event.payload === 'object' ? event.payload : {};
14
- const session = typeof payload.sessionId === 'string' ? state.journal.getSession(payload.sessionId) : undefined;
15
- if ((payload.workspaceId ?? session?.workspaceId) !== workspaceId)
16
- return [];
17
- return [{ directoryName: String(payload.directoryName ?? session?.directoryName ?? 'basic'), occurredAt: event.occurredAt }];
18
- });
19
- const latest = (dates) => {
20
- const timestamps = dates.map(value => Date.parse(value)).filter(Number.isFinite);
21
- return timestamps.length ? new Date(Math.max(...timestamps)).toISOString() : null;
22
- };
23
- const directories = [];
24
- for (const directoryName of names) {
25
- const lastUsedAt = latest([...operations.filter(operation => (operation.directoryName ?? 'basic') === directoryName).map(operation => operation.updatedAt),
26
- ...events.filter(event => event.directoryName === directoryName).map(event => event.occurredAt)]);
27
- if (binding.directories?.some(directory => directory.directoryName === directoryName && directory.status === 'reclaimed')) {
28
- directories.push({ directoryName, sizeBytes: 0, lastUsedAt, status: 'reclaimed' });
29
- continue;
30
- }
31
- let root;
32
- try {
33
- root = await workspaceRoot(state, workspaceId, directoryName);
34
- }
35
- catch (error) {
36
- if (!(error instanceof WorkspaceContextError) || error.message !== 'workspace_not_prepared')
37
- throw error;
38
- directories.push({ directoryName, sizeBytes: 0, lastUsedAt, status: 'missing' });
39
- continue;
40
- }
41
- const output = await execute('du', ['-sk', root], { timeout: 30_000, maxBuffer: 4096 });
42
- const blocks = Number(output.stdout.trim().split(/\s+/)[0]);
43
- if (!Number.isSafeInteger(blocks) || blocks < 0 || !Number.isSafeInteger(blocks * 1024))
44
- throw new Error('workspace_directory_stats_invalid');
45
- directories.push({ directoryName, sizeBytes: blocks * 1024, lastUsedAt, status: 'present' });
46
- }
47
- return { workspaceId, sizeBytes: directories.reduce((sum, directory) => sum + directory.sizeBytes, 0),
48
- lastUsedAt: latest([...operations.map(operation => operation.updatedAt), ...events.map(event => event.occurredAt)]), directories };
49
- }
@@ -1,31 +0,0 @@
1
- import { createHash } from 'node:crypto';
2
- import { constants } from 'node:fs';
3
- import { open } from 'node:fs/promises';
4
- import { ASSET_TRANSFER_FILE_MAX_BYTES } from '@playcraft/common/cloud-workspace/runtime';
5
- export async function sampleDiskFile(path) {
6
- const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
7
- try {
8
- const before = await handle.stat();
9
- if (!before.isFile() || before.size > ASSET_TRANSFER_FILE_MAX_BYTES)
10
- throw new Error('snapshot_body_missing');
11
- const digest = createHash('sha256');
12
- const chunk = Buffer.allocUnsafe(64 * 1024);
13
- let position = 0;
14
- for (;;) {
15
- const { bytesRead } = await handle.read(chunk, 0, chunk.length, position);
16
- if (!bytesRead)
17
- break;
18
- digest.update(chunk.subarray(0, bytesRead));
19
- position += bytesRead;
20
- if (position > ASSET_TRANSFER_FILE_MAX_BYTES)
21
- throw new Error('snapshot_body_missing');
22
- }
23
- const after = await handle.stat();
24
- if (before.size !== after.size || before.mtimeMs !== after.mtimeMs || before.ctimeMs !== after.ctimeMs || position !== before.size)
25
- throw new Error('snapshot_body_missing');
26
- return { hash: digest.digest('hex'), size: position, mode: before.mode & 0o777, modifiedAt: before.mtime.toISOString() };
27
- }
28
- finally {
29
- await handle.close();
30
- }
31
- }
@@ -1,42 +0,0 @@
1
- import { cp, mkdir } from 'node:fs/promises';
2
- import { join } from 'node:path';
3
- import { resolveCliPackageRoot } from '../../scaffold/compose.js';
4
- import { importBuiltinProjectSkills } from '../../project-skills/builtin-import.js';
5
- import { createHash } from 'node:crypto';
6
- import { canonicalProjectSkillsJson } from '@playcraft/common/project-skills';
7
- import { syncLocalProjectSkills } from '../../project-skills/local-store.js';
8
- import { selectOptionalPlatformSkills } from './optional-platform-skills.js';
9
- export const EMPTY_WORKSPACE_REPOSITORY_SKILLS = [
10
- 'playcraft-skill-recommender',
11
- 'playcraft-image-generation',
12
- 'playcraft-audio-generation',
13
- 'playcraft-image-processing',
14
- 'playcraft-build-optimizer',
15
- ];
16
- export const EMPTY_WORKSPACE_PLATFORM_SKILLS = ['playcraft-video-understanding', 'playcraft-replica-validation'];
17
- export const EMPTY_WORKSPACE_DEFAULT_SKILLS = [...EMPTY_WORKSPACE_REPOSITORY_SKILLS, ...EMPTY_WORKSPACE_PLATFORM_SKILLS];
18
- /** Only called in a new, unpublished staging directory; existing workspaces are never scaffolded. */
19
- export async function scaffoldEmptyWorkspace(root, skillCache, access) {
20
- const selected = await selectOptionalPlatformSkills([...EMPTY_WORKSPACE_PLATFORM_SKILLS], access);
21
- const cliRoot = resolveCliPackageRoot();
22
- const template = join(cliRoot, 'project-templates', 'empty');
23
- for (const [source, target] of [
24
- ['gitignore', '.gitignore'],
25
- ['AGENTS.md', 'AGENTS.md'],
26
- ]) {
27
- await cp(join(template, source), join(root, target), { force: false, errorOnExist: true });
28
- }
29
- const skills = join(root, '.agents', 'skills');
30
- await mkdir(skills, { recursive: true });
31
- for (const name of EMPTY_WORKSPACE_REPOSITORY_SKILLS) {
32
- await cp(join(cliRoot, 'project-template', '.claude', 'skills', name), join(skills, name), {
33
- recursive: true,
34
- force: false,
35
- errorOnExist: true,
36
- });
37
- }
38
- const snapshot = await syncLocalProjectSkills(root, skillCache);
39
- if (selected)
40
- await importBuiltinProjectSkills(root, { names: [...EMPTY_WORKSPACE_PLATFORM_SKILLS], expectedDeclarationHash: snapshot.lock.declarationHash,
41
- expectedLockHash: createHash('sha256').update(canonicalProjectSkillsJson(snapshot.lock)).digest('hex') }, skillCache, access, selected, true);
42
- }
@@ -1,48 +0,0 @@
1
- import { constants } from 'node:fs';
2
- import { lstat, open } from 'node:fs/promises';
3
- import { basename, extname } from 'node:path';
4
- import { workspaceRelativePathSchema } from '@playcraft/common/cloud-workspace/runtime';
5
- import { artifactMime, artifactPath } from './artifact-files.js';
6
- import { serveOpenedWorkspaceContent } from './binary-content.js';
7
- import { InvalidWorkspacePathError, resolveWorkspaceFile } from './files.js';
8
- const additionalMediaTypes = {
9
- '.aac': 'audio/aac', '.opus': 'audio/ogg', '.oga': 'audio/ogg', '.aif': 'audio/aiff', '.aiff': 'audio/aiff',
10
- '.bmp': 'image/bmp', '.ico': 'image/vnd.microsoft.icon', '.heic': 'image/heic', '.heif': 'image/heif',
11
- '.tif': 'image/tiff', '.tiff': 'image/tiff',
12
- };
13
- export async function serveWorkspaceFileContent(root, path, request, response) {
14
- let handle;
15
- let size;
16
- try {
17
- if (!workspaceRelativePathSchema.safeParse(path).success)
18
- throw new InvalidWorkspacePathError(path);
19
- // Check every component before resolving, so missing files cannot create parent directories.
20
- await artifactPath(root, path);
21
- const target = await resolveWorkspaceFile(root, path);
22
- handle = await open(target, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
23
- const stat = await handle.stat();
24
- if (!stat.isFile() || stat.nlink !== 1)
25
- throw new Error('file_not_found');
26
- // Bind the open handle to the authorized file even if a parent changed during open.
27
- const verified = await artifactPath(root, path);
28
- const current = await lstat(verified);
29
- if (!current.isFile() || current.nlink !== 1 || current.dev !== stat.dev || current.ino !== stat.ino)
30
- throw new InvalidWorkspacePathError(path);
31
- size = stat.size;
32
- }
33
- catch (error) {
34
- await handle?.close();
35
- const code = error?.code;
36
- const invalid = error instanceof InvalidWorkspacePathError || (error instanceof Error && error.message === 'invalid_artifact_path');
37
- const denied = code === 'EACCES' || code === 'EPERM';
38
- response.writeHead(invalid ? 400 : denied ? 403 : 404, { 'content-type': 'application/json', 'cache-control': 'no-store' });
39
- response.end(JSON.stringify({ error: invalid ? 'invalid_workspace_path' : denied ? 'workspace_permission_denied' : 'file_not_found' }));
40
- return;
41
- }
42
- await serveOpenedWorkspaceContent({
43
- handle,
44
- name: basename(path),
45
- mimeType: additionalMediaTypes[extname(path).toLowerCase()] ?? artifactMime(path),
46
- size,
47
- }, request, response);
48
- }
@@ -1,116 +0,0 @@
1
- import { createHash } from 'node:crypto';
2
- import { lstat, opendir, realpath } from 'node:fs/promises';
3
- import { join, relative, sep } from 'node:path';
4
- import { workspaceFileSearchQuerySchema, workspaceRelativePathSchema, } from '@playcraft/common/cloud-workspace/runtime';
5
- const SKIP_DIRECTORIES = new Set(['.git', 'node_modules', '.playcraft', '.next', 'dist', 'build', 'coverage', '.turbo']);
6
- const SCAN_PAGE_ENTRIES = 1000;
7
- export class InvalidWorkspaceSearchError extends Error {
8
- code;
9
- constructor(code = 'invalid_workspace_search') {
10
- super(code);
11
- this.code = code;
12
- this.name = 'InvalidWorkspaceSearchError';
13
- }
14
- }
15
- /** Enumerates names only. The cursor is scoped to the resolved checkout and query, never to a caller supplied path. */
16
- export async function searchWorkspaceFiles(root, query, options = {}) {
17
- const parsed = workspaceFileSearchQuerySchema.safeParse(query);
18
- if (!parsed.success)
19
- throw new InvalidWorkspaceSearchError();
20
- options.signal?.throwIfAborted();
21
- const rootReal = await realpath(root);
22
- const needle = parsed.data.query.toLocaleLowerCase();
23
- const scope = createHash('sha256').update(rootReal).update('\0').update(needle).digest('hex');
24
- const start = decodeCursor(parsed.data.cursor, scope);
25
- const files = [];
26
- let offset = 0;
27
- for await (const path of walk(rootReal, rootReal, options.signal)) {
28
- options.signal?.throwIfAborted();
29
- offset += 1;
30
- if (offset <= start)
31
- continue;
32
- if (path && path.toLocaleLowerCase().includes(needle)) {
33
- const target = join(rootReal, ...path.split('/'));
34
- const info = await lstat(target).catch(ignoreUnavailable);
35
- const targetReal = info?.isFile() && !info.isSymbolicLink() ? await realpath(target).catch(ignoreUnavailable) : undefined;
36
- if (targetReal && inside(rootReal, targetReal))
37
- files.push({ path });
38
- }
39
- if (files.length >= parsed.data.limit || offset - start >= SCAN_PAGE_ENTRIES) {
40
- return { files, truncated: true, nextCursor: encodeCursor(scope, offset) };
41
- }
42
- }
43
- return { files, truncated: false };
44
- }
45
- async function* walk(root, current, signal) {
46
- signal?.throwIfAborted();
47
- const currentInfo = await lstat(current).catch(ignoreUnavailable);
48
- if (!currentInfo?.isDirectory() || currentInfo.isSymbolicLink())
49
- return;
50
- const resolved = await realpath(current).catch(ignoreUnavailable);
51
- if (!resolved || !inside(root, resolved))
52
- return;
53
- const directory = await opendir(resolved).catch(ignoreUnavailable);
54
- if (!directory)
55
- return;
56
- // Recheck after opening: a concurrently replaced directory must not reveal another checkout's paths.
57
- const openedPath = await realpath(current).catch(ignoreUnavailable);
58
- if (openedPath !== resolved || !inside(root, openedPath)) {
59
- await directory.close();
60
- return;
61
- }
62
- for await (const entry of directory) {
63
- signal?.throwIfAborted();
64
- if (['.git', 'node_modules', '.playcraft'].includes(entry.name)) {
65
- yield undefined;
66
- continue;
67
- }
68
- const child = join(resolved, entry.name);
69
- const path = relative(root, child).split(sep).join('/');
70
- if (!workspaceRelativePathSchema.safeParse(path).success) {
71
- yield undefined;
72
- continue;
73
- }
74
- if (entry.isDirectory()) {
75
- yield undefined;
76
- if (!SKIP_DIRECTORIES.has(entry.name))
77
- yield* walk(root, child, signal);
78
- continue;
79
- }
80
- if (!entry.isFile()) {
81
- yield undefined;
82
- continue;
83
- }
84
- yield path;
85
- }
86
- }
87
- function inside(root, path) {
88
- const value = relative(root, path);
89
- return value === '' || (value !== '..' && !value.startsWith(`..${sep}`) && !value.startsWith(sep));
90
- }
91
- function ignoreUnavailable(error) {
92
- if (['ENOENT', 'ENOTDIR', 'EACCES'].includes(error.code ?? ''))
93
- return undefined;
94
- throw error;
95
- }
96
- function encodeCursor(scope, offset) {
97
- return Buffer.from(JSON.stringify({ v: 1, scope, offset })).toString('base64url');
98
- }
99
- function decodeCursor(cursor, scope) {
100
- if (!cursor)
101
- return 0;
102
- try {
103
- if (!/^[A-Za-z0-9_-]+$/.test(cursor))
104
- throw new Error();
105
- const value = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
106
- if (typeof value !== 'object' || value === null)
107
- throw new Error();
108
- const { v, scope: suppliedScope, offset } = value;
109
- if (v !== 1 || suppliedScope !== scope || typeof offset !== 'number' || !Number.isSafeInteger(offset) || offset < 0)
110
- throw new Error();
111
- return offset;
112
- }
113
- catch {
114
- throw new InvalidWorkspaceSearchError('invalid_workspace_search_cursor');
115
- }
116
- }
@@ -1,150 +0,0 @@
1
- import { lstat, mkdir, readdir, readFile, realpath, writeFile } from 'node:fs/promises';
2
- import { createHash } from 'node:crypto';
3
- import { dirname, join, relative, resolve, sep } from 'node:path';
4
- import { hashWorkspaceFileContent, workspaceFileContentSchema, workspaceFileListSchema, workspaceRelativePathSchema, } from '@playcraft/common/cloud-workspace/runtime';
5
- import { sampleDiskFile } from './disk-snapshot.js';
6
- const SKIP_DIRECTORY_NAMES = new Set(['.git', 'node_modules', '.playcraft-temp']);
7
- const LARGE_FILE_STREAM_THRESHOLD = 8 * 1024 * 1024;
8
- export class InvalidWorkspacePathError extends Error {
9
- code = 'invalid_workspace_path';
10
- constructor(path) {
11
- super(path);
12
- this.name = 'InvalidWorkspacePathError';
13
- }
14
- }
15
- export async function ensureWorkspaceRoot(root) {
16
- await mkdir(root, { recursive: true, mode: 0o700 });
17
- return realpath(root);
18
- }
19
- export async function resolveWorkspaceFile(root, relativePath) {
20
- const parsed = workspaceRelativePathSchema.safeParse(relativePath);
21
- if (!parsed.success)
22
- throw new InvalidWorkspacePathError(relativePath);
23
- const rootReal = await ensureWorkspaceRoot(root);
24
- const target = resolve(rootReal, ...parsed.data.split('/'));
25
- assertInsideRoot(rootReal, target);
26
- try {
27
- const existing = await realpath(target);
28
- assertInsideRoot(rootReal, existing);
29
- return existing;
30
- }
31
- catch (error) {
32
- if (error.code !== 'ENOENT')
33
- throw error;
34
- await assertParentInsideRoot(rootReal, dirname(target));
35
- return target;
36
- }
37
- }
38
- export async function writeWorkspaceFile(root, relativePath, content) {
39
- const target = await resolveWorkspaceFile(root, relativePath);
40
- await mkdir(dirname(target), { recursive: true, mode: 0o700 });
41
- const bytes = Buffer.from(content, 'utf8');
42
- await writeFile(target, bytes, { mode: 0o600 });
43
- return { path: relativePath, contentHash: hashWorkspaceFileContent(content), size: bytes.byteLength };
44
- }
45
- export async function readWorkspaceFile(root, relativePath, revisions) {
46
- const target = await resolveWorkspaceFile(root, relativePath);
47
- const content = await readFile(target, 'utf8');
48
- const contentHash = hashWorkspaceFileContent(content);
49
- return workspaceFileContentSchema.parse({
50
- path: relativePath,
51
- revision: revisions[relativePath]?.revision ?? 0,
52
- contentHash,
53
- content,
54
- });
55
- }
56
- export async function listWorkspaceFiles(root, revisions) {
57
- const rootReal = await ensureWorkspaceRoot(root);
58
- const files = [];
59
- const directories = new Set();
60
- const unreadablePaths = new Set();
61
- for (const relativePath of await walkWorkspaceFiles(rootReal, rootReal, unreadablePaths, directories)) {
62
- const target = join(rootReal, ...relativePath.split('/'));
63
- try {
64
- const stat = await lstat(target);
65
- if (stat.size > LARGE_FILE_STREAM_THRESHOLD) {
66
- const sampled = await sampleDiskFile(target);
67
- files.push({ path: relativePath, revision: revisions[relativePath]?.revision ?? 0, contentHash: sampled.hash, size: sampled.size, modifiedAt: sampled.modifiedAt });
68
- continue;
69
- }
70
- const content = await readFile(target);
71
- const after = await lstat(target);
72
- if (stat.ino !== after.ino || stat.size !== after.size || stat.mtimeMs !== after.mtimeMs || stat.ctimeMs !== after.ctimeMs || content.length !== after.size) {
73
- const sampled = await sampleDiskFile(target);
74
- files.push({ path: relativePath, revision: revisions[relativePath]?.revision ?? 0, contentHash: sampled.hash, size: sampled.size, modifiedAt: sampled.modifiedAt });
75
- continue;
76
- }
77
- files.push({
78
- path: relativePath,
79
- revision: revisions[relativePath]?.revision ?? 0,
80
- contentHash: createHash('sha256').update(content).digest('hex'),
81
- size: content.byteLength,
82
- modifiedAt: after.mtime.toISOString(),
83
- });
84
- }
85
- catch (error) {
86
- if (!isPermissionDenied(error))
87
- throw error;
88
- unreadablePaths.add(relativePath);
89
- }
90
- }
91
- files.sort((left, right) => left.path.localeCompare(right.path));
92
- return workspaceFileListSchema.parse({ files, directories: [...directories].sort(), ...(unreadablePaths.size ? { unreadablePaths: [...unreadablePaths].sort() } : {}) });
93
- }
94
- async function walkWorkspaceFiles(rootReal, current, unreadablePaths, directories) {
95
- const entries = await readdir(current, { withFileTypes: true });
96
- const paths = [];
97
- for (const entry of entries) {
98
- const child = join(current, entry.name);
99
- try {
100
- if (entry.isDirectory()) {
101
- if (SKIP_DIRECTORY_NAMES.has(entry.name) || entry.name === '.' || entry.name === '..')
102
- continue;
103
- const childReal = await realpath(child);
104
- assertInsideRoot(rootReal, childReal);
105
- const children = await walkWorkspaceFiles(rootReal, childReal, unreadablePaths, directories);
106
- directories.add(toPosixRelative(rootReal, childReal));
107
- paths.push(...children);
108
- continue;
109
- }
110
- if (!entry.isFile() || entry.name === '.gitkeep')
111
- continue;
112
- const childReal = await realpath(child);
113
- assertInsideRoot(rootReal, childReal);
114
- paths.push(toPosixRelative(rootReal, childReal));
115
- }
116
- catch (error) {
117
- if (!isPermissionDenied(error))
118
- throw error;
119
- unreadablePaths.add(toPosixRelative(rootReal, child));
120
- }
121
- }
122
- return paths;
123
- }
124
- function isPermissionDenied(error) {
125
- return ['EACCES', 'EPERM'].includes(String(error?.code));
126
- }
127
- async function assertParentInsideRoot(rootReal, parent) {
128
- if (parent === rootReal)
129
- return;
130
- try {
131
- const parentReal = await realpath(parent);
132
- assertInsideRoot(rootReal, parentReal);
133
- }
134
- catch (error) {
135
- if (error.code !== 'ENOENT')
136
- throw error;
137
- await mkdir(parent, { recursive: true, mode: 0o700 });
138
- const parentReal = await realpath(parent);
139
- assertInsideRoot(rootReal, parentReal);
140
- }
141
- }
142
- function assertInsideRoot(rootReal, target) {
143
- const rel = relative(rootReal, target);
144
- if (rel === '' || rel.startsWith(`..${sep}`) || rel === '..' || rel.startsWith('..')) {
145
- throw new InvalidWorkspacePathError(target);
146
- }
147
- }
148
- function toPosixRelative(rootReal, target) {
149
- return relative(rootReal, target).split(sep).join('/');
150
- }