@playcraft/cli 0.1.54 → 0.1.55-beta

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