@playcraft/cli 0.1.29 → 0.1.30

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 (320) hide show
  1. package/README.md +38 -3
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/auth/account-activation.js +157 -0
  4. package/dist/auth/messages.js +30 -0
  5. package/dist/cli-root-help.js +2 -0
  6. package/dist/commands/build.js +9 -4
  7. package/dist/commands/create.js +26 -33
  8. package/dist/commands/image.js +2 -6
  9. package/dist/commands/login.js +84 -42
  10. package/dist/commands/platform-skills.generated.js +19 -0
  11. package/dist/commands/playable.js +53 -0
  12. package/dist/commands/skills.js +2 -0
  13. package/dist/commands/tools-3d.js +11 -0
  14. package/dist/commands/tools-batch.js +87 -0
  15. package/dist/commands/tools-generation.js +68 -109
  16. package/dist/commands/tools.js +2 -2
  17. package/dist/commands/video.js +111 -0
  18. package/dist/commands/workspace-runtime.js +54 -0
  19. package/dist/config.js +59 -4
  20. package/dist/index.js +34 -3
  21. package/dist/project-skills/builtin-import.js +225 -0
  22. package/dist/project-skills/commands.js +77 -0
  23. package/dist/project-skills/lifecycle.js +28 -0
  24. package/dist/project-skills/local-run.js +112 -0
  25. package/dist/project-skills/local-store.js +221 -0
  26. package/dist/project-skills/messages.js +80 -0
  27. package/dist/project-skills/reconcile.js +62 -0
  28. package/dist/project-skills/remote-cache.js +51 -0
  29. package/dist/project-skills/validation.js +19 -0
  30. package/dist/recording/messages.js +40 -0
  31. package/dist/recording/project-digest.js +85 -0
  32. package/dist/recording/recorder.js +293 -0
  33. package/dist/recording/scenario.js +50 -0
  34. package/dist/remix/clone.js +2 -0
  35. package/dist/remix/init-template.js +2 -0
  36. package/dist/remix/pull.js +2 -0
  37. package/dist/remix/push.js +21 -1
  38. package/dist/utils/agent-api-client.js +185 -30
  39. package/dist/utils/environment-endpoints.js +17 -0
  40. package/dist/utils/playcraft-http-client.js +6 -4
  41. package/dist/utils/tool-operation-journal.js +124 -0
  42. package/dist/utils/video-evidence-git.js +81 -0
  43. package/dist/video-replication/client.js +222 -0
  44. package/dist/video-replication/comparison-evidence.js +149 -0
  45. package/dist/video-replication/comparison-files.js +57 -0
  46. package/dist/video-replication/comparison-log.js +72 -0
  47. package/dist/video-replication/comparison-messages.js +104 -0
  48. package/dist/video-replication/comparison-output.js +63 -0
  49. package/dist/video-replication/comparison-preflight.js +66 -0
  50. package/dist/video-replication/comparison.js +216 -0
  51. package/dist/video-replication/evidence.js +165 -0
  52. package/dist/video-replication/media.js +111 -0
  53. package/dist/video-replication/messages.js +89 -0
  54. package/dist/workspace-runtime/codex/app-server.js +965 -0
  55. package/dist/workspace-runtime/codex/compact.js +46 -0
  56. package/dist/workspace-runtime/codex/config-toml.js +107 -0
  57. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +145 -0
  58. package/dist/workspace-runtime/codex/launcher-client.js +177 -0
  59. package/dist/workspace-runtime/codex/loopback.js +146 -0
  60. package/dist/workspace-runtime/codex/mcp-config.js +39 -0
  61. package/dist/workspace-runtime/codex/model-broker.js +263 -0
  62. package/dist/workspace-runtime/codex/native-adapter.js +9 -0
  63. package/dist/workspace-runtime/codex/permissions.js +70 -0
  64. package/dist/workspace-runtime/codex/work-mode.js +15 -0
  65. package/dist/workspace-runtime/main.js +10 -0
  66. package/dist/workspace-runtime/persistence/journal.js +355 -0
  67. package/dist/workspace-runtime/persistence/native-subagents.js +162 -0
  68. package/dist/workspace-runtime/persistence/sqlite-client.js +77 -0
  69. package/dist/workspace-runtime/persistence/sqlite-worker.js +1096 -0
  70. package/dist/workspace-runtime/previews/publish.js +259 -0
  71. package/dist/workspace-runtime/previews/single-file.js +43 -0
  72. package/dist/workspace-runtime/processes/managed-writes.js +69 -0
  73. package/dist/workspace-runtime/production/contracts.js +17 -0
  74. package/dist/workspace-runtime/production/controller.js +207 -0
  75. package/dist/workspace-runtime/production/dependencies.js +60 -0
  76. package/dist/workspace-runtime/production/native.js +196 -0
  77. package/dist/workspace-runtime/production/processes.js +86 -0
  78. package/dist/workspace-runtime/production/save-command.js +35 -0
  79. package/dist/workspace-runtime/production/source-copy.js +91 -0
  80. package/dist/workspace-runtime/production/stages.js +202 -0
  81. package/dist/workspace-runtime/production/storage.js +32 -0
  82. package/dist/workspace-runtime/serve.js +207 -0
  83. package/dist/workspace-runtime/server/auth.js +21 -0
  84. package/dist/workspace-runtime/server/connectivity.js +201 -0
  85. package/dist/workspace-runtime/server/desktop-host.js +429 -0
  86. package/dist/workspace-runtime/server/desktop-preview-config.js +81 -0
  87. package/dist/workspace-runtime/server/desktop-preview-service.js +157 -0
  88. package/dist/workspace-runtime/server/desktop-preview-static.js +53 -0
  89. package/dist/workspace-runtime/server/desktop-preview.js +189 -0
  90. package/dist/workspace-runtime/server/dispatch.js +1116 -0
  91. package/dist/workspace-runtime/server/endpoints.js +19 -0
  92. package/dist/workspace-runtime/server/execution-group.js +85 -0
  93. package/dist/workspace-runtime/server/http.js +1038 -0
  94. package/dist/workspace-runtime/server/lock.js +53 -0
  95. package/dist/workspace-runtime/server/rfb-watch-gate.js +168 -0
  96. package/dist/workspace-runtime/server/terminal-host.js +366 -0
  97. package/dist/workspace-runtime/server/types.js +1 -0
  98. package/dist/workspace-runtime/workspaces/artifact-events.js +55 -0
  99. package/dist/workspace-runtime/workspaces/artifact-files.js +195 -0
  100. package/dist/workspace-runtime/workspaces/artifact-receipts.js +89 -0
  101. package/dist/workspace-runtime/workspaces/artifacts.js +260 -0
  102. package/dist/workspace-runtime/workspaces/attachment-content.js +111 -0
  103. package/dist/workspace-runtime/workspaces/attachments.js +175 -0
  104. package/dist/workspace-runtime/workspaces/batch-commit.js +142 -0
  105. package/dist/workspace-runtime/workspaces/cli-context.js +23 -0
  106. package/dist/workspace-runtime/workspaces/cli-credentials.js +111 -0
  107. package/dist/workspace-runtime/workspaces/composer-context.js +125 -0
  108. package/dist/workspace-runtime/workspaces/context-error.js +2 -0
  109. package/dist/workspace-runtime/workspaces/dependencies.js +264 -0
  110. package/dist/workspace-runtime/workspaces/developer-command.js +64 -0
  111. package/dist/workspace-runtime/workspaces/directories.js +113 -0
  112. package/dist/workspace-runtime/workspaces/directory-access.js +29 -0
  113. package/dist/workspace-runtime/workspaces/directory-maintenance.js +111 -0
  114. package/dist/workspace-runtime/workspaces/directory-stats.js +49 -0
  115. package/dist/workspace-runtime/workspaces/disk-snapshot.js +31 -0
  116. package/dist/workspace-runtime/workspaces/empty-template.js +40 -0
  117. package/dist/workspace-runtime/workspaces/files-search.js +116 -0
  118. package/dist/workspace-runtime/workspaces/files.js +120 -0
  119. package/dist/workspace-runtime/workspaces/git-credential-broker.js +312 -0
  120. package/dist/workspace-runtime/workspaces/git-credential-helper.js +68 -0
  121. package/dist/workspace-runtime/workspaces/git-direct-store.js +155 -0
  122. package/dist/workspace-runtime/workspaces/git.js +517 -0
  123. package/dist/workspace-runtime/workspaces/json5-edit.js +170 -0
  124. package/dist/workspace-runtime/workspaces/parameters.js +272 -0
  125. package/dist/workspace-runtime/workspaces/prepare.js +264 -0
  126. package/dist/workspace-runtime/workspaces/registry.js +226 -0
  127. package/dist/workspace-runtime/workspaces/revisions.js +31 -0
  128. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +91 -0
  129. package/dist/workspace-runtime/workspaces/skills.js +189 -0
  130. package/dist/workspace-runtime/workspaces/video-attachments.js +49 -0
  131. package/package.json +14 -5
  132. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +23 -81
  133. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +25 -0
  134. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +79 -0
  135. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +29 -0
  136. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +37 -0
  137. package/project-template-v2/.claude/agents/artist.md +82 -0
  138. package/project-template-v2/.claude/agents/developer.md +153 -0
  139. package/project-template-v2/.claude/agents/game-designer.md +264 -0
  140. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +533 -0
  141. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +153 -0
  142. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +27 -0
  143. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +208 -0
  144. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +81 -0
  145. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +432 -0
  146. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +252 -0
  147. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +266 -0
  148. package/project-template-v2/.claude/agents/refs/framework-mda.md +147 -0
  149. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +123 -0
  150. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +88 -0
  151. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +67 -0
  152. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +120 -0
  153. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +300 -0
  154. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +495 -0
  155. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +1141 -0
  156. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +111 -0
  157. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +365 -0
  158. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +412 -0
  159. package/project-template-v2/.claude/agents/reviewer.md +75 -0
  160. package/project-template-v2/.claude/agents/technical-artist.md +86 -0
  161. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +243 -0
  162. package/project-template-v2/.claude/hooks/user-prompt.mjs +133 -0
  163. package/project-template-v2/.claude/settings.json +33 -0
  164. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +161 -0
  165. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +270 -0
  166. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +177 -0
  167. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +354 -0
  168. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +148 -0
  169. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +56 -0
  170. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +62 -0
  171. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +49 -0
  172. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +309 -0
  173. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +182 -0
  174. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +123 -0
  175. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +205 -0
  176. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +280 -0
  177. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +184 -0
  178. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +306 -0
  179. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +298 -0
  180. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +123 -0
  181. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +254 -0
  182. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +324 -0
  183. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +97 -0
  184. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +118 -0
  185. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +137 -0
  186. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +397 -0
  187. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +296 -0
  188. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +122 -0
  189. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +219 -0
  190. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +373 -0
  191. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +161 -0
  192. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +215 -0
  193. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +382 -0
  194. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +423 -0
  195. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +158 -0
  196. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +100 -0
  197. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +167 -0
  198. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +270 -0
  199. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +236 -0
  200. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +130 -0
  201. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +390 -0
  202. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +23 -0
  203. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +39 -0
  204. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +87 -0
  205. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +240 -0
  206. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +226 -0
  207. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +308 -0
  208. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +275 -0
  209. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +134 -0
  210. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +142 -0
  211. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +153 -0
  212. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +386 -0
  213. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +182 -0
  214. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +72 -0
  215. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +121 -0
  216. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +102 -0
  217. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +127 -0
  218. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +106 -0
  219. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +128 -0
  220. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +67 -0
  221. package/project-template-v2/.claude/snapshot.mjs +263 -0
  222. package/project-template-v2/.playcraft/skills.lock.json +152 -0
  223. package/project-template-v2/CLAUDE.md +146 -0
  224. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  225. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  226. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  227. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  228. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  229. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  230. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  231. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  232. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  233. package/project-template-v2/assets/models/.gitkeep +0 -0
  234. package/project-template-v2/docs/harness/iteration-1/context-flow.md +254 -0
  235. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +91 -0
  236. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +214 -0
  237. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +75 -0
  238. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +63 -0
  239. package/project-template-v2/docs/harness/iteration-2/context-flow.md +223 -0
  240. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +129 -0
  241. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +267 -0
  242. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +164 -0
  243. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +115 -0
  244. package/project-template-v2/docs/harness/orchestrator-flow.md +364 -0
  245. package/project-template-v2/docs/project-state.json +60 -0
  246. package/project-template-v2/docs/project-state.md +72 -0
  247. package/project-template-v2/docs/standards/README.md +225 -0
  248. package/project-template-v2/docs/standards/agent-behavior-standards.md +174 -0
  249. package/project-template-v2/docs/standards/artifacts/design-brief.md +19 -0
  250. package/project-template-v2/docs/standards/artifacts/design.md +22 -0
  251. package/project-template-v2/docs/standards/artifacts/game-code.md +41 -0
  252. package/project-template-v2/docs/standards/artifacts/todo-list.md +41 -0
  253. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +343 -0
  254. package/project-template-v2/game/index.ts +18 -0
  255. package/project-template-v2/globals.d.ts +51 -0
  256. package/project-template-v2/index.css +34 -0
  257. package/project-template-v2/index.html +18 -0
  258. package/project-template-v2/main.ts +9 -0
  259. package/project-template-v2/package.json +46 -0
  260. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +31 -0
  261. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +86 -0
  262. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +153 -0
  263. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +70 -0
  264. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +91 -0
  265. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +131 -0
  266. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +80 -0
  267. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +90 -0
  268. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +93 -0
  269. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +23 -0
  270. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +230 -0
  271. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +58 -0
  272. package/project-template-v2/skills/_shared/scripts/state-get.mjs +339 -0
  273. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +39 -0
  274. package/project-template-v2/skills/_shared/scripts/state-set.mjs +94 -0
  275. package/project-template-v2/skills/_shared/scripts/state-store.mjs +783 -0
  276. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +88 -0
  277. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +130 -0
  278. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +33 -0
  279. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +47 -0
  280. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +268 -0
  281. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +285 -0
  282. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +161 -0
  283. package/project-template-v2/skills/playable-autoplay/SKILL.md +176 -0
  284. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +4 -0
  285. package/project-template-v2/skills/playable-debug/SKILL.md +116 -0
  286. package/project-template-v2/skills/playable-debug/agents/openai.yaml +4 -0
  287. package/project-template-v2/skills/playable-debug/references/debug-config.md +40 -0
  288. package/project-template-v2/skills/playable-record/SKILL.md +140 -0
  289. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +104 -0
  290. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +141 -0
  291. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +425 -0
  292. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +261 -0
  293. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +398 -0
  294. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +322 -0
  295. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +105 -0
  296. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +230 -0
  297. package/project-template-v2/skills/playable-validate/SKILL.md +61 -0
  298. package/project-template-v2/skills/playable-validate/validation-rules.md +14 -0
  299. package/project-template-v2/skills/playable-verify-ui/SKILL.md +63 -0
  300. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +1 -0
  301. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +218 -0
  302. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +51 -0
  303. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +59 -0
  304. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +106 -0
  305. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +116 -0
  306. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +59 -0
  307. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +64 -0
  308. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +58 -0
  309. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +333 -0
  310. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  311. package/project-template-v2/tsconfig.json +20 -0
  312. package/project-template-v2/vite.config.ts +27 -0
  313. package/project-templates/batch-locks/phaser.yaml +922 -0
  314. package/project-templates/batch-locks/threejs.yaml +978 -0
  315. package/project-templates/empty/AGENTS.md +25 -0
  316. package/project-templates/empty/gitignore +33 -0
  317. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +23 -81
  318. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +23 -81
  319. package/dist/commands/tools-image-context.js +0 -23
  320. package/dist/utils/image-asset-context.js +0 -105
@@ -0,0 +1,19 @@
1
+ import { chmod, rename, writeFile } from 'node:fs/promises';
2
+ import { applySandboxEndpointPatch } from '@playcraft/common/cloud-workspace/runtime';
3
+ /** Persist the new public entrance, then publish it to the running process. A restart is not required. */
4
+ export async function applyRuntimeEndpointPatch(state, patch) {
5
+ const next = applySandboxEndpointPatch(state.config, patch);
6
+ const changed = next.publicBaseUrl !== state.config.publicBaseUrl;
7
+ const result = { changed, publicBaseUrl: next.publicBaseUrl };
8
+ if (!changed)
9
+ return result;
10
+ if (!state.configPath) {
11
+ throw new Error('endpoint_config_path_missing');
12
+ }
13
+ const temporary = `${state.configPath}.${process.pid}.tmp`;
14
+ await writeFile(temporary, `${JSON.stringify(next)}\n`, { mode: 0o600 });
15
+ await chmod(temporary, 0o600);
16
+ await rename(temporary, state.configPath);
17
+ state.config = next;
18
+ return result;
19
+ }
@@ -0,0 +1,85 @@
1
+ function enqueue(state, action) {
2
+ const run = state.executionQueue.then(action, action);
3
+ state.executionQueue = run.then(() => undefined, () => undefined);
4
+ return run;
5
+ }
6
+ function processAlive(pid) {
7
+ try {
8
+ process.kill(pid, 0);
9
+ return true;
10
+ }
11
+ catch {
12
+ return false;
13
+ }
14
+ }
15
+ function requireRestartable(state) {
16
+ const native = state.native;
17
+ if (!native?.executionProcess || !native.replaceProcess) {
18
+ throw new Error('execution_group_unavailable');
19
+ }
20
+ return native;
21
+ }
22
+ async function demoteSessions(state) {
23
+ await state.journal.replaceSessions(state.journal.listSessions().map((session) => ({ ...session, recoverability: 'history_only' })));
24
+ }
25
+ async function advanceEpoch(state, input) {
26
+ const runtimeEpoch = state.runtimeEpoch + 1;
27
+ await state.journal.writeExecutionEpoch({
28
+ runtimeEpoch,
29
+ pid: input.pid,
30
+ startedAt: input.startedAt,
31
+ previousPid: input.previousPid,
32
+ stopConfirmed: input.stopConfirmed,
33
+ });
34
+ state.runtimeEpoch = runtimeEpoch;
35
+ await demoteSessions(state);
36
+ }
37
+ export async function replaceExecutionGroup(state, options) {
38
+ return enqueue(state, async () => {
39
+ const native = requireRestartable(state);
40
+ const previous = native.executionProcess();
41
+ if (!previous)
42
+ throw new Error('execution_group_missing');
43
+ const next = await native.replaceProcess();
44
+ await advanceEpoch(state, {
45
+ pid: next.pid,
46
+ startedAt: next.startedAt,
47
+ previousPid: previous.pid,
48
+ stopConfirmed: false,
49
+ });
50
+ if (options.confirmStop)
51
+ await confirmStopped(state, previous.pid);
52
+ return {
53
+ runtimeEpoch: state.runtimeEpoch,
54
+ stopConfirmed: state.journal.executionGroup().stopConfirmed,
55
+ pid: next.pid,
56
+ previousPid: previous.pid,
57
+ };
58
+ });
59
+ }
60
+ export async function confirmExecutionGroupStopped(state, previousPid) {
61
+ return enqueue(state, () => confirmStopped(state, previousPid));
62
+ }
63
+ async function confirmStopped(state, previousPid) {
64
+ if (processAlive(previousPid))
65
+ return false;
66
+ await state.journal.setExecutionStopConfirmed(true);
67
+ return true;
68
+ }
69
+ export async function handleExecutionGroupCrash(state, exitedPid) {
70
+ return enqueue(state, async () => {
71
+ const group = state.journal.executionGroup();
72
+ if (group.pid !== exitedPid)
73
+ return;
74
+ const native = state.native;
75
+ if (!native?.replaceProcess)
76
+ return;
77
+ const next = await native.replaceProcess();
78
+ await advanceEpoch(state, {
79
+ pid: next.pid,
80
+ startedAt: next.startedAt,
81
+ previousPid: exitedPid,
82
+ stopConfirmed: true,
83
+ });
84
+ });
85
+ }