@playcraft/cli 0.1.41-prod → 0.1.43-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 (378) hide show
  1. package/README.md +62 -3
  2. package/SKILLS_REGISTRY.md +149 -0
  3. package/dist/agent/local-backend.js +1 -1
  4. package/dist/auth/account-activation.js +157 -0
  5. package/dist/auth/messages.js +30 -0
  6. package/dist/cli-root-help.js +2 -0
  7. package/dist/commands/build-all.js +5 -19
  8. package/dist/commands/build-temp.js +26 -0
  9. package/dist/commands/build.js +15 -28
  10. package/dist/commands/create.js +26 -33
  11. package/dist/commands/image.js +2 -6
  12. package/dist/commands/login.js +84 -42
  13. package/dist/commands/platform-skills.generated.js +19 -0
  14. package/dist/commands/playable.js +53 -0
  15. package/dist/commands/skills.js +4 -0
  16. package/dist/commands/tools-3d.js +11 -0
  17. package/dist/commands/tools-batch.js +87 -0
  18. package/dist/commands/tools-generation.js +69 -137
  19. package/dist/commands/tools-utils.js +0 -12
  20. package/dist/commands/tools.js +2 -2
  21. package/dist/commands/video.js +122 -0
  22. package/dist/commands/workspace-runtime.js +54 -0
  23. package/dist/commands/workspace.js +40 -0
  24. package/dist/config.js +59 -4
  25. package/dist/index.js +40 -3
  26. package/dist/project-skills/builtin-import.js +225 -0
  27. package/dist/project-skills/commands.js +77 -0
  28. package/dist/project-skills/lifecycle.js +28 -0
  29. package/dist/project-skills/local-run.js +112 -0
  30. package/dist/project-skills/local-store.js +221 -0
  31. package/dist/project-skills/messages.js +80 -0
  32. package/dist/project-skills/reconcile.js +62 -0
  33. package/dist/project-skills/remote-cache.js +51 -0
  34. package/dist/project-skills/validation.js +19 -0
  35. package/dist/recording/messages.js +40 -0
  36. package/dist/recording/project-digest.js +85 -0
  37. package/dist/recording/recorder.js +293 -0
  38. package/dist/recording/scenario.js +50 -0
  39. package/dist/remix/clone.js +2 -0
  40. package/dist/remix/init-template.js +2 -0
  41. package/dist/remix/pull.js +2 -0
  42. package/dist/remix/push.js +21 -1
  43. package/dist/skill-registry/client.js +345 -0
  44. package/dist/skill-registry/commands.js +180 -0
  45. package/dist/skill-registry/evaluation-client.js +156 -0
  46. package/dist/skill-registry/evaluation-commands.js +174 -0
  47. package/dist/skill-registry/messages.js +177 -0
  48. package/dist/skill-registry/package.js +275 -0
  49. package/dist/skill-registry/platform-package.js +100 -0
  50. package/dist/utils/agent-api-client.js +210 -30
  51. package/dist/utils/environment-endpoints.js +17 -0
  52. package/dist/utils/error-diagnostics.js +20 -0
  53. package/dist/utils/playcraft-http-client.js +6 -4
  54. package/dist/utils/tool-operation-journal.js +124 -0
  55. package/dist/utils/video-evidence-git.js +81 -0
  56. package/dist/video-replication/client.js +234 -0
  57. package/dist/video-replication/comparison-evidence.js +149 -0
  58. package/dist/video-replication/comparison-files.js +57 -0
  59. package/dist/video-replication/comparison-log.js +72 -0
  60. package/dist/video-replication/comparison-messages.js +104 -0
  61. package/dist/video-replication/comparison-output.js +63 -0
  62. package/dist/video-replication/comparison-preflight.js +66 -0
  63. package/dist/video-replication/comparison.js +230 -0
  64. package/dist/video-replication/diagnostics.js +41 -0
  65. package/dist/video-replication/evidence.js +165 -0
  66. package/dist/video-replication/media.js +112 -0
  67. package/dist/video-replication/messages.js +97 -0
  68. package/dist/workspace/messages.js +67 -0
  69. package/dist/workspace/transfer-client.js +233 -0
  70. package/dist/workspace/transfer-errors.js +48 -0
  71. package/dist/workspace-runtime/codex/app-server.js +1040 -0
  72. package/dist/workspace-runtime/codex/compact.js +46 -0
  73. package/dist/workspace-runtime/codex/config-toml.js +107 -0
  74. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +145 -0
  75. package/dist/workspace-runtime/codex/launcher-client.js +177 -0
  76. package/dist/workspace-runtime/codex/loopback.js +146 -0
  77. package/dist/workspace-runtime/codex/mcp-config.js +39 -0
  78. package/dist/workspace-runtime/codex/model-broker.js +263 -0
  79. package/dist/workspace-runtime/codex/native-adapter.js +9 -0
  80. package/dist/workspace-runtime/codex/permissions.js +70 -0
  81. package/dist/workspace-runtime/codex/thread-image.js +38 -0
  82. package/dist/workspace-runtime/codex/ui-instructions.js +4 -0
  83. package/dist/workspace-runtime/codex/ui-tools.js +186 -0
  84. package/dist/workspace-runtime/codex/work-mode.js +15 -0
  85. package/dist/workspace-runtime/main.js +10 -0
  86. package/dist/workspace-runtime/persistence/journal.js +365 -0
  87. package/dist/workspace-runtime/persistence/native-subagents.js +162 -0
  88. package/dist/workspace-runtime/persistence/sqlite-client.js +77 -0
  89. package/dist/workspace-runtime/persistence/sqlite-worker.js +1161 -0
  90. package/dist/workspace-runtime/persistence/stopped-execution.js +77 -0
  91. package/dist/workspace-runtime/previews/output.js +36 -0
  92. package/dist/workspace-runtime/previews/publish.js +262 -0
  93. package/dist/workspace-runtime/previews/single-file.js +43 -0
  94. package/dist/workspace-runtime/processes/managed-writes.js +69 -0
  95. package/dist/workspace-runtime/production/content-changes.js +36 -0
  96. package/dist/workspace-runtime/production/contracts.js +19 -0
  97. package/dist/workspace-runtime/production/controller.js +225 -0
  98. package/dist/workspace-runtime/production/dependencies.js +60 -0
  99. package/dist/workspace-runtime/production/native.js +239 -0
  100. package/dist/workspace-runtime/production/processes.js +102 -0
  101. package/dist/workspace-runtime/production/save-command.js +35 -0
  102. package/dist/workspace-runtime/production/source-archive.js +137 -0
  103. package/dist/workspace-runtime/production/source-copy.js +92 -0
  104. package/dist/workspace-runtime/production/stages.js +354 -0
  105. package/dist/workspace-runtime/production/storage.js +75 -0
  106. package/dist/workspace-runtime/serve.js +281 -0
  107. package/dist/workspace-runtime/server/auth.js +21 -0
  108. package/dist/workspace-runtime/server/connectivity.js +201 -0
  109. package/dist/workspace-runtime/server/desktop-host.js +429 -0
  110. package/dist/workspace-runtime/server/desktop-preview-config.js +81 -0
  111. package/dist/workspace-runtime/server/desktop-preview-service.js +157 -0
  112. package/dist/workspace-runtime/server/desktop-preview-static.js +53 -0
  113. package/dist/workspace-runtime/server/desktop-preview.js +189 -0
  114. package/dist/workspace-runtime/server/dispatch.js +1335 -0
  115. package/dist/workspace-runtime/server/endpoints.js +21 -0
  116. package/dist/workspace-runtime/server/execution-group.js +90 -0
  117. package/dist/workspace-runtime/server/http.js +1291 -0
  118. package/dist/workspace-runtime/server/lock.js +53 -0
  119. package/dist/workspace-runtime/server/rfb-watch-gate.js +168 -0
  120. package/dist/workspace-runtime/server/session-restore.js +84 -0
  121. package/dist/workspace-runtime/server/source-uploader.js +138 -0
  122. package/dist/workspace-runtime/server/terminal-host.js +366 -0
  123. package/dist/workspace-runtime/server/types.js +1 -0
  124. package/dist/workspace-runtime/server/workspace-transfer.js +168 -0
  125. package/dist/workspace-runtime/workspaces/archive.js +207 -0
  126. package/dist/workspace-runtime/workspaces/artifact-events.js +55 -0
  127. package/dist/workspace-runtime/workspaces/artifact-files.js +199 -0
  128. package/dist/workspace-runtime/workspaces/artifact-receipts.js +89 -0
  129. package/dist/workspace-runtime/workspaces/artifacts.js +282 -0
  130. package/dist/workspace-runtime/workspaces/asset-library-import.js +366 -0
  131. package/dist/workspace-runtime/workspaces/attachment-content.js +73 -0
  132. package/dist/workspace-runtime/workspaces/attachments.js +185 -0
  133. package/dist/workspace-runtime/workspaces/batch-commit.js +142 -0
  134. package/dist/workspace-runtime/workspaces/binary-content.js +65 -0
  135. package/dist/workspace-runtime/workspaces/binary-write.js +112 -0
  136. package/dist/workspace-runtime/workspaces/cli-context.js +23 -0
  137. package/dist/workspace-runtime/workspaces/cli-credentials.js +111 -0
  138. package/dist/workspace-runtime/workspaces/composer-context.js +147 -0
  139. package/dist/workspace-runtime/workspaces/context-error.js +2 -0
  140. package/dist/workspace-runtime/workspaces/dependencies.js +264 -0
  141. package/dist/workspace-runtime/workspaces/developer-command.js +64 -0
  142. package/dist/workspace-runtime/workspaces/directories.js +137 -0
  143. package/dist/workspace-runtime/workspaces/directory-access.js +37 -0
  144. package/dist/workspace-runtime/workspaces/directory-attachments.js +245 -0
  145. package/dist/workspace-runtime/workspaces/directory-create.js +57 -0
  146. package/dist/workspace-runtime/workspaces/directory-maintenance.js +111 -0
  147. package/dist/workspace-runtime/workspaces/directory-stats.js +49 -0
  148. package/dist/workspace-runtime/workspaces/disk-snapshot.js +31 -0
  149. package/dist/workspace-runtime/workspaces/empty-template.js +42 -0
  150. package/dist/workspace-runtime/workspaces/file-content.js +48 -0
  151. package/dist/workspace-runtime/workspaces/files-search.js +116 -0
  152. package/dist/workspace-runtime/workspaces/files.js +150 -0
  153. package/dist/workspace-runtime/workspaces/git-credential-broker.js +312 -0
  154. package/dist/workspace-runtime/workspaces/git-credential-helper.js +68 -0
  155. package/dist/workspace-runtime/workspaces/git-direct-store.js +155 -0
  156. package/dist/workspace-runtime/workspaces/git.js +670 -0
  157. package/dist/workspace-runtime/workspaces/instructions.js +56 -0
  158. package/dist/workspace-runtime/workspaces/json5-edit.js +170 -0
  159. package/dist/workspace-runtime/workspaces/library-attachments.js +268 -0
  160. package/dist/workspace-runtime/workspaces/optional-platform-skills.js +14 -0
  161. package/dist/workspace-runtime/workspaces/parameters.js +272 -0
  162. package/dist/workspace-runtime/workspaces/prepare.js +278 -0
  163. package/dist/workspace-runtime/workspaces/registry.js +251 -0
  164. package/dist/workspace-runtime/workspaces/remix-references.js +301 -0
  165. package/dist/workspace-runtime/workspaces/revisions.js +31 -0
  166. package/dist/workspace-runtime/workspaces/session-image.js +104 -0
  167. package/dist/workspace-runtime/workspaces/shared-git.js +40 -0
  168. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +95 -0
  169. package/dist/workspace-runtime/workspaces/skills.js +191 -0
  170. package/dist/workspace-runtime/workspaces/transfer-quota.js +69 -0
  171. package/dist/workspace-runtime/workspaces/transfer.js +471 -0
  172. package/dist/workspace-runtime/workspaces/turn-changes.js +75 -0
  173. package/dist/workspace-runtime/workspaces/video-attachments.js +49 -0
  174. package/package.json +15 -5
  175. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +123 -67
  176. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +63 -135
  177. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +33 -42
  178. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +20 -18
  179. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +7 -6
  180. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  181. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +25 -0
  182. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +79 -0
  183. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +29 -0
  184. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +37 -0
  185. package/project-template-v2/.claude/agents/artist.md +82 -0
  186. package/project-template-v2/.claude/agents/developer.md +153 -0
  187. package/project-template-v2/.claude/agents/game-designer.md +264 -0
  188. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +533 -0
  189. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +153 -0
  190. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +27 -0
  191. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +208 -0
  192. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +81 -0
  193. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +432 -0
  194. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +252 -0
  195. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +266 -0
  196. package/project-template-v2/.claude/agents/refs/framework-mda.md +147 -0
  197. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +123 -0
  198. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +88 -0
  199. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +67 -0
  200. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +120 -0
  201. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +300 -0
  202. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +495 -0
  203. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +1141 -0
  204. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +111 -0
  205. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +365 -0
  206. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +412 -0
  207. package/project-template-v2/.claude/agents/reviewer.md +75 -0
  208. package/project-template-v2/.claude/agents/technical-artist.md +86 -0
  209. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +243 -0
  210. package/project-template-v2/.claude/hooks/user-prompt.mjs +133 -0
  211. package/project-template-v2/.claude/settings.json +33 -0
  212. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +161 -0
  213. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +270 -0
  214. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +177 -0
  215. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +354 -0
  216. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +148 -0
  217. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +56 -0
  218. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +62 -0
  219. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +49 -0
  220. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +309 -0
  221. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +182 -0
  222. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +123 -0
  223. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +205 -0
  224. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +280 -0
  225. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +184 -0
  226. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +306 -0
  227. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +298 -0
  228. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +123 -0
  229. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +254 -0
  230. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +324 -0
  231. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +97 -0
  232. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +118 -0
  233. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +137 -0
  234. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +397 -0
  235. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +296 -0
  236. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +122 -0
  237. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +219 -0
  238. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +373 -0
  239. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +161 -0
  240. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +215 -0
  241. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +382 -0
  242. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +423 -0
  243. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +158 -0
  244. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +100 -0
  245. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +167 -0
  246. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +270 -0
  247. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +236 -0
  248. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +130 -0
  249. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +390 -0
  250. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +23 -0
  251. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +39 -0
  252. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +87 -0
  253. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +240 -0
  254. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +226 -0
  255. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +308 -0
  256. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +275 -0
  257. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +134 -0
  258. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +142 -0
  259. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +153 -0
  260. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +386 -0
  261. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +182 -0
  262. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +72 -0
  263. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +121 -0
  264. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +102 -0
  265. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +127 -0
  266. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +106 -0
  267. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +128 -0
  268. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +67 -0
  269. package/project-template-v2/.claude/snapshot.mjs +263 -0
  270. package/project-template-v2/.playcraft/skills.lock.json +152 -0
  271. package/project-template-v2/CLAUDE.md +146 -0
  272. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  273. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  274. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  275. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  276. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  277. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  278. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  279. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  280. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  281. package/project-template-v2/assets/models/.gitkeep +0 -0
  282. package/project-template-v2/docs/harness/iteration-1/context-flow.md +254 -0
  283. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +91 -0
  284. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +214 -0
  285. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +75 -0
  286. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +63 -0
  287. package/project-template-v2/docs/harness/iteration-2/context-flow.md +223 -0
  288. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +129 -0
  289. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +267 -0
  290. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +164 -0
  291. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +115 -0
  292. package/project-template-v2/docs/harness/orchestrator-flow.md +364 -0
  293. package/project-template-v2/docs/project-state.json +60 -0
  294. package/project-template-v2/docs/project-state.md +72 -0
  295. package/project-template-v2/docs/standards/README.md +225 -0
  296. package/project-template-v2/docs/standards/agent-behavior-standards.md +174 -0
  297. package/project-template-v2/docs/standards/artifacts/design-brief.md +19 -0
  298. package/project-template-v2/docs/standards/artifacts/design.md +22 -0
  299. package/project-template-v2/docs/standards/artifacts/game-code.md +41 -0
  300. package/project-template-v2/docs/standards/artifacts/todo-list.md +41 -0
  301. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +343 -0
  302. package/project-template-v2/game/index.ts +18 -0
  303. package/project-template-v2/globals.d.ts +51 -0
  304. package/project-template-v2/index.css +34 -0
  305. package/project-template-v2/index.html +18 -0
  306. package/project-template-v2/main.ts +9 -0
  307. package/project-template-v2/package.json +46 -0
  308. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +31 -0
  309. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +86 -0
  310. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +153 -0
  311. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +70 -0
  312. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +91 -0
  313. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +131 -0
  314. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +80 -0
  315. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +90 -0
  316. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +93 -0
  317. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +23 -0
  318. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +230 -0
  319. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +58 -0
  320. package/project-template-v2/skills/_shared/scripts/state-get.mjs +339 -0
  321. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +39 -0
  322. package/project-template-v2/skills/_shared/scripts/state-set.mjs +94 -0
  323. package/project-template-v2/skills/_shared/scripts/state-store.mjs +783 -0
  324. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +88 -0
  325. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +130 -0
  326. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +33 -0
  327. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +47 -0
  328. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +268 -0
  329. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +285 -0
  330. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +161 -0
  331. package/project-template-v2/skills/playable-autoplay/SKILL.md +176 -0
  332. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +4 -0
  333. package/project-template-v2/skills/playable-debug/SKILL.md +116 -0
  334. package/project-template-v2/skills/playable-debug/agents/openai.yaml +4 -0
  335. package/project-template-v2/skills/playable-debug/references/debug-config.md +40 -0
  336. package/project-template-v2/skills/playable-record/SKILL.md +140 -0
  337. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +104 -0
  338. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +141 -0
  339. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +425 -0
  340. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +261 -0
  341. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +398 -0
  342. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +322 -0
  343. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +105 -0
  344. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +230 -0
  345. package/project-template-v2/skills/playable-validate/SKILL.md +61 -0
  346. package/project-template-v2/skills/playable-validate/validation-rules.md +14 -0
  347. package/project-template-v2/skills/playable-verify-ui/SKILL.md +63 -0
  348. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +1 -0
  349. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +218 -0
  350. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +51 -0
  351. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +59 -0
  352. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +106 -0
  353. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +116 -0
  354. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +59 -0
  355. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +64 -0
  356. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +58 -0
  357. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +333 -0
  358. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  359. package/project-template-v2/tsconfig.json +20 -0
  360. package/project-template-v2/vite.config.ts +27 -0
  361. package/project-templates/batch-locks/phaser.yaml +922 -0
  362. package/project-templates/batch-locks/threejs.yaml +978 -0
  363. package/project-templates/empty/AGENTS.md +41 -0
  364. package/project-templates/empty/gitignore +33 -0
  365. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  366. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +63 -135
  367. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +33 -42
  368. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +20 -18
  369. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +7 -6
  370. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  371. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  372. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +63 -135
  373. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +33 -42
  374. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +20 -18
  375. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +7 -6
  376. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +39 -39
  377. package/dist/commands/tools-image-context.js +0 -29
  378. package/dist/utils/image-asset-context.js +0 -228
@@ -0,0 +1,365 @@
1
+ import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
2
+ import { existsSync } from 'node:fs';
3
+ import { dirname, join } from 'node:path';
4
+ import { workspaceRegistrationSchema, operationRecordSchema, pendingSourceEventSchema, replayPinResultSchema, retainedRangeHasGap, sourceAckSchema, sourceEventKey, sourceEventReceiptSchema, terminalRecordSchema, } from '@playcraft/common/cloud-workspace/runtime';
5
+ import { SqliteWorkerClient } from './sqlite-client.js';
6
+ export const RUNTIME_STATE_FILE = 'runtime-state.sqlite';
7
+ export const LEGACY_JOURNAL_FILE = 'journal.json';
8
+ export const LEGACY_JOURNAL_SENTINEL = 'PLAYCRAFT_RUNTIME_STATE_SQLITE\n';
9
+ export class RuntimeJournal {
10
+ filePath;
11
+ legacyPath;
12
+ client;
13
+ listeners = new Set();
14
+ maintenance;
15
+ engineInfo;
16
+ epochs = [];
17
+ readToken = '';
18
+ inboxPending = 0;
19
+ locks = new Map();
20
+ snapshot = emptySnapshot();
21
+ constructor(stateDir) {
22
+ this.filePath = join(stateDir, RUNTIME_STATE_FILE);
23
+ this.legacyPath = join(stateDir, LEGACY_JOURNAL_FILE);
24
+ }
25
+ async exclusive(key, action) {
26
+ const previous = this.locks.get(key) ?? Promise.resolve();
27
+ let release;
28
+ const current = new Promise((resolve) => {
29
+ release = resolve;
30
+ });
31
+ this.locks.set(key, current);
32
+ await previous;
33
+ try {
34
+ return await action();
35
+ }
36
+ finally {
37
+ release();
38
+ if (this.locks.get(key) === current)
39
+ this.locks.delete(key);
40
+ }
41
+ }
42
+ async load() {
43
+ await mkdir(dirname(this.filePath), { recursive: true, mode: 0o700 });
44
+ const legacy = await readLegacy(this.legacyPath, this.filePath);
45
+ const started = await SqliteWorkerClient.open(this.filePath, legacy?.value ?? null);
46
+ this.client = started.client;
47
+ this.apply(started.opened);
48
+ if (legacy?.readable)
49
+ await writeFile(this.legacyPath, LEGACY_JOURNAL_SENTINEL, { mode: 0o600 });
50
+ this.maintenance = setInterval(() => {
51
+ void this.client?.request('maintain').catch(() => undefined);
52
+ }, 30_000);
53
+ this.maintenance.unref?.();
54
+ }
55
+ async close() {
56
+ if (this.maintenance)
57
+ clearInterval(this.maintenance);
58
+ await this.client?.close();
59
+ this.client = undefined;
60
+ }
61
+ engine() {
62
+ if (!this.engineInfo)
63
+ throw new Error('sqlite_engine_unavailable');
64
+ return this.engineInfo;
65
+ }
66
+ sourceReadToken() {
67
+ return this.readToken;
68
+ }
69
+ pendingInbox() {
70
+ return this.inboxPending;
71
+ }
72
+ epochsSnapshot() {
73
+ return this.epochs.map((epoch) => ({ ...epoch }));
74
+ }
75
+ onSourceEvent(listener) {
76
+ this.listeners.add(listener);
77
+ return () => this.listeners.delete(listener);
78
+ }
79
+ getWorkspace(workspaceId) {
80
+ return this.snapshot.workspaces[workspaceId];
81
+ }
82
+ async putWorkspace(binding) {
83
+ const parsed = workspaceRegistrationSchema.parse(binding);
84
+ await this.run('upsertRecord', { bucket: 'workspaces', key: parsed.workspaceId, body: parsed });
85
+ }
86
+ async forgetWorkspaces() {
87
+ await this.run('forgetWorkspaces', {});
88
+ }
89
+ findSessionCreation(sessionId) {
90
+ return Object.values(this.snapshot.operations).find((item) => item.kind === 'session.create' && item.sessionId === sessionId);
91
+ }
92
+ findTerminalCreation(terminalId) {
93
+ return Object.values(this.snapshot.operations).find((item) => item.kind === 'terminal.create' && item.terminalId === terminalId);
94
+ }
95
+ getOperation(scopeKey) {
96
+ return this.snapshot.operations[scopeKey];
97
+ }
98
+ getOperationById(operationId) {
99
+ return Object.values(this.snapshot.operations).find((operation) => operation.operationId === operationId);
100
+ }
101
+ listOperations() {
102
+ return Object.entries(this.snapshot.operations).map(([scopeKey, operation]) => ({ scopeKey, operation }));
103
+ }
104
+ getReceipt(key) {
105
+ return this.snapshot.receipts[key];
106
+ }
107
+ getSession(sessionId) {
108
+ return this.snapshot.sessions[sessionId];
109
+ }
110
+ listSessions() {
111
+ return Object.values(this.snapshot.sessions);
112
+ }
113
+ getTerminal(terminalId) {
114
+ return this.snapshot.terminals[terminalId];
115
+ }
116
+ listTerminals(workspaceId) {
117
+ return Object.values(this.snapshot.terminals).filter((item) => !workspaceId || item.workspaceId === workspaceId);
118
+ }
119
+ listManagedWrites(workspaceId) {
120
+ return Object.values(this.snapshot.managedWrites).filter((item) => !workspaceId || item.workspaceId === workspaceId);
121
+ }
122
+ getManagedWrite(writeId) {
123
+ return this.snapshot.managedWrites[writeId];
124
+ }
125
+ async putManagedWrite(record) {
126
+ await this.run('upsertRecord', { bucket: 'managed_writes', key: record.writeId, body: record });
127
+ }
128
+ getWorkspaceDependencies(workspaceId) {
129
+ return this.snapshot.workspaceDependencies[workspaceId];
130
+ }
131
+ listWorkspaceDependencies() {
132
+ return Object.values(this.snapshot.workspaceDependencies);
133
+ }
134
+ async putWorkspaceDependencies(record) {
135
+ await this.run('upsertRecord', {
136
+ bucket: 'workspace_dependencies',
137
+ key: record.workspaceId,
138
+ body: record,
139
+ });
140
+ }
141
+ fileRevisions(workspaceId) {
142
+ return { ...(workspaceId ? this.snapshot.workspaceFileRevisions[workspaceId] ?? {} : this.snapshot.fileRevisions) };
143
+ }
144
+ fileRevision(path, workspaceId) {
145
+ return this.fileRevisions(workspaceId)[path]?.revision ?? 0;
146
+ }
147
+ destroyed() {
148
+ return this.snapshot.destroyed;
149
+ }
150
+ lastSourceSequence() {
151
+ return this.snapshot.lastSourceSequence;
152
+ }
153
+ acceptedLeaseFence() {
154
+ return this.snapshot.acceptedLeaseFence;
155
+ }
156
+ storedRuntimeEpoch() {
157
+ return this.snapshot.runtimeEpoch;
158
+ }
159
+ executionGroup() {
160
+ return { ...this.snapshot.executionGroup };
161
+ }
162
+ stoppedRuntimeEpochs() {
163
+ return [...(this.snapshot.stoppedRuntimeEpochs ?? [])];
164
+ }
165
+ getApproval(sessionId, approvalId) {
166
+ return this.snapshot.approvals[`${sessionId}:${approvalId}`];
167
+ }
168
+ listApprovals() {
169
+ return Object.values(this.snapshot.approvals);
170
+ }
171
+ async putApproval(approval) {
172
+ await this.run('upsertRecord', { bucket: 'approvals', key: `${approval.sessionId}:${approval.approvalId}`, body: approval });
173
+ }
174
+ async noteExecutionGroup(group) {
175
+ await this.run('noteExecutionGroup', { group });
176
+ }
177
+ async writeExecutionEpoch(input) {
178
+ await this.run('writeExecutionEpoch', input);
179
+ }
180
+ async setExecutionStopConfirmed(stopConfirmed) {
181
+ await this.run('setStopConfirmed', { stopConfirmed });
182
+ }
183
+ async bindRuntime(input) {
184
+ await this.run('bindRuntime', input);
185
+ }
186
+ listEvents(afterSequence = 0) {
187
+ return Object.values(this.snapshot.events)
188
+ .filter((event) => event.source.sourceSequence > afterSequence)
189
+ .sort((left, right) => left.source.sourceSequence - right.source.sourceSequence || left.source.runtimeEpoch - right.source.runtimeEpoch);
190
+ }
191
+ readSourcePage(input) {
192
+ const epoch = this.epochs.find((item) => item.runtime_id === input.runtimeId && item.generation === input.generation && item.runtime_epoch === input.runtimeEpoch);
193
+ const retainedFrom = epoch?.retained_from ?? 1;
194
+ const highWater = epoch?.local_durable_through ?? 0;
195
+ const coveredThrough = input.after;
196
+ if (retainedRangeHasGap(retainedFrom, coveredThrough)) {
197
+ return { ok: false, code: 'source_gap', retainedFrom, highWater, coveredThrough, ...identity(input) };
198
+ }
199
+ const matched = Object.values(this.snapshot.events)
200
+ .filter((event) => event.source.runtimeId === input.runtimeId &&
201
+ event.source.generation === input.generation &&
202
+ event.source.runtimeEpoch === input.runtimeEpoch &&
203
+ event.source.sourceSequence > input.after)
204
+ .sort((left, right) => left.source.sourceSequence - right.source.sourceSequence);
205
+ const first = matched[0];
206
+ if (first && first.source.sourceSequence > input.after + 1) {
207
+ return { ok: false, code: 'source_gap', retainedFrom, highWater, coveredThrough, ...identity(input) };
208
+ }
209
+ const events = matched.slice(0, input.limit ?? 100);
210
+ const nextAfter = events.at(-1)?.source.sourceSequence ?? input.after;
211
+ return { ok: true, events, retainedFrom, highWater, nextAfter, ...identity(input) };
212
+ }
213
+ async allocateSourceEvent(input) {
214
+ const result = await this.run('allocateEvent', input);
215
+ const event = result.committedEvents?.[0];
216
+ if (!event)
217
+ throw new Error('source_event_missing');
218
+ return event;
219
+ }
220
+ async commitSourceIdentity(event) {
221
+ await this.run('commitIdentity', { event: pendingSourceEventSchema.parse(event) });
222
+ }
223
+ async ingestNative(input) {
224
+ const result = await this.run('ingest', input);
225
+ return result.committedEvents ?? [];
226
+ }
227
+ async bindTurn(input) {
228
+ const result = await this.run('bindTurn', input);
229
+ return result.committedEvents ?? [];
230
+ }
231
+ async acknowledgeSource(ack) {
232
+ await this.run('ack', sourceAckSchema.parse(ack));
233
+ }
234
+ async createReplayPin(input) {
235
+ const result = await this.run('createPin', { identity: input, ttlMs: input.ttlMs });
236
+ return replayPinResultSchema.parse(result.pin);
237
+ }
238
+ async deleteReplayPin(pinId) {
239
+ await this.run('deletePin', { pinId });
240
+ }
241
+ async reclaimSourceEvents(minRetainMs = 0) {
242
+ await this.run('reclaim', { minRetainMs });
243
+ }
244
+ async putOperation(scopeKey, operation) {
245
+ const parsed = operationRecordSchema.parse(operation);
246
+ await this.run('putOperation', { scopeKey, operation: parsed });
247
+ return this.snapshot.operations[scopeKey] ?? parsed;
248
+ }
249
+ async putSession(binding) {
250
+ await this.run('upsertRecord', { bucket: 'sessions', key: binding.sessionId, body: binding });
251
+ }
252
+ async putTerminal(record) {
253
+ const parsed = terminalRecordSchema.parse(record);
254
+ await this.run('upsertRecord', { bucket: 'terminals', key: parsed.terminalId, body: parsed });
255
+ return parsed;
256
+ }
257
+ async putFileRevision(path, record, workspaceId) {
258
+ if (workspaceId) {
259
+ await this.run('upsertRecord', { bucket: `workspace_files:${workspaceId}`, key: path, body: record });
260
+ return;
261
+ }
262
+ await this.run('upsertRecord', { bucket: 'file_revisions', key: path, body: record });
263
+ }
264
+ async markDestroyed() {
265
+ await this.run('setDestroyed', {});
266
+ }
267
+ async replaceSessions(sessions) {
268
+ await this.run('replaceBucket', {
269
+ bucket: 'sessions',
270
+ entries: sessions.map((session) => ({ key: session.sessionId, body: session })),
271
+ });
272
+ }
273
+ async setAcceptedLeaseFence(value) {
274
+ await this.run('setAcceptedFence', { value });
275
+ }
276
+ async putReceipt(receipt, sourceSequence) {
277
+ const parsed = sourceEventReceiptSchema.parse(receipt);
278
+ await this.run('upsertRecord', { bucket: 'receipts', key: sourceEventKey(parsed.source), body: parsed });
279
+ void sourceSequence;
280
+ }
281
+ async appendEvent(event) {
282
+ const parsed = pendingSourceEventSchema.parse(event);
283
+ await this.commitSourceIdentity(parsed);
284
+ return this.snapshot.events[sourceEventKey(parsed.source)] ?? parsed;
285
+ }
286
+ async run(type, payload) {
287
+ if (!this.client)
288
+ throw new Error('sqlite_not_open');
289
+ const result = await this.client.request(type, payload);
290
+ this.apply(result);
291
+ for (const event of result.committedEvents ?? []) {
292
+ for (const listener of this.listeners)
293
+ listener(event);
294
+ }
295
+ return result;
296
+ }
297
+ apply(dump) {
298
+ const group = dump.snapshot.executionGroup;
299
+ const events = dump.snapshot.events ?? this.snapshot.events;
300
+ // Keep history in place: copying it on every streamed delta grows quadratically.
301
+ for (const event of dump.committedEvents ?? [])
302
+ events[sourceEventKey(event.source)] = event;
303
+ for (const event of dump.eventChanges ?? [])
304
+ events[sourceEventKey(event.source)] = event;
305
+ this.snapshot = {
306
+ ...emptySnapshot(),
307
+ ...dump.snapshot,
308
+ events,
309
+ executionGroup: {
310
+ stopConfirmed: group?.stopConfirmed === true,
311
+ replaced: group?.replaced === true,
312
+ pid: group?.pid,
313
+ startedAt: group?.startedAt,
314
+ previousPid: group?.previousPid,
315
+ },
316
+ };
317
+ this.epochs = dump.epochs ?? [];
318
+ this.readToken = dump.sourceReadToken ?? this.readToken;
319
+ this.inboxPending = dump.pendingInbox ?? 0;
320
+ if (dump.engine)
321
+ this.engineInfo = dump.engine;
322
+ }
323
+ }
324
+ async function readLegacy(legacyPath, sqlitePath) {
325
+ if (!existsSync(legacyPath))
326
+ return null;
327
+ const text = await readFile(legacyPath, 'utf8');
328
+ if (text.startsWith(LEGACY_JOURNAL_SENTINEL.trim())) {
329
+ if (!existsSync(sqlitePath))
330
+ throw new Error('runtime_state_missing');
331
+ return null;
332
+ }
333
+ let value;
334
+ try {
335
+ value = JSON.parse(text);
336
+ }
337
+ catch {
338
+ throw new Error('legacy_journal_unreadable');
339
+ }
340
+ if (!existsSync(`${legacyPath}.bak`))
341
+ await copyFile(legacyPath, `${legacyPath}.bak`);
342
+ return { value, readable: true };
343
+ }
344
+ function identity(input) {
345
+ return { runtimeId: input.runtimeId, generation: input.generation, runtimeEpoch: input.runtimeEpoch };
346
+ }
347
+ function emptySnapshot() {
348
+ return {
349
+ workspaces: {},
350
+ workspaceFileRevisions: {},
351
+ operations: {},
352
+ receipts: {},
353
+ events: {},
354
+ sessions: {},
355
+ terminals: {},
356
+ fileRevisions: {},
357
+ approvals: {},
358
+ managedWrites: {},
359
+ workspaceDependencies: {},
360
+ executionGroup: { stopConfirmed: false, replaced: false },
361
+ lastSourceSequence: 0,
362
+ acceptedLeaseFence: 0,
363
+ destroyed: false,
364
+ };
365
+ }
@@ -0,0 +1,162 @@
1
+ import { operationRecordSchema } from '@playcraft/common/cloud-workspace/runtime';
2
+ /** Native ancestry is durable platform metadata, never inferred from an arbitrary turn identifier. */
3
+ export function nativeEventOwner(database, threadId, turnId) {
4
+ if (!threadId)
5
+ return undefined;
6
+ const direct = sessionsForThread(database, threadId);
7
+ if (direct.length) {
8
+ if (direct.length !== 1)
9
+ return undefined;
10
+ const session = direct[0];
11
+ const operation = readOperation(database, 'turn_id', turnId ?? text(session.activeTurnId), threadId);
12
+ if (turnId && !ownsOperation(session, threadId, operation))
13
+ return undefined;
14
+ return { session, operation: ownsOperation(session, threadId, operation) ? operation : undefined };
15
+ }
16
+ const link = readRecord(database, 'native_subagent_threads', threadId);
17
+ if (!link || link.operationConfirmed === false)
18
+ return undefined;
19
+ const roots = sessionsForThread(database, link.rootThreadId);
20
+ if (roots.length !== 1)
21
+ return undefined;
22
+ const session = roots[0];
23
+ if (session.sessionId !== link.sessionId || session.workspaceId !== link.workspaceId)
24
+ return undefined;
25
+ const turnKey = turnId ? JSON.stringify([threadId, turnId]) : undefined;
26
+ const pinned = turnKey ? readRecord(database, 'native_subagent_turns', turnKey) : undefined;
27
+ const pending = turnKey && !pinned ? readRecord(database, 'native_subagent_pending_followups', threadId) : undefined;
28
+ if (pending) {
29
+ const followup = readOperation(database, 'scope_key', text(pending.operationScopeKey));
30
+ if (followup?.operation.status === 'accepted' && followup.operation.nativeTurnId === session.activeTurnId)
31
+ return undefined;
32
+ database.prepare('DELETE FROM records WHERE bucket = ? AND record_key = ?').run('native_subagent_pending_followups', threadId);
33
+ }
34
+ const scopeKey = text(pinned?.operationScopeKey) ?? link.operationScopeKey;
35
+ const operation = scopeKey
36
+ ? readOperation(database, 'scope_key', scopeKey)
37
+ : readOperation(database, 'turn_id', text(session.activeTurnId), link.rootThreadId);
38
+ if (!ownsOperation(session, link.rootThreadId, operation))
39
+ return undefined;
40
+ if (turnKey && !pinned)
41
+ writeRecord(database, 'native_subagent_turns', turnKey, { operationScopeKey: operation.scopeKey });
42
+ const { sessionId: _, workspaceId: __, operationScopeKey: ___, operationConfirmed: ____, ...subAgent } = link;
43
+ return { session, operation, subAgent };
44
+ }
45
+ /** Only native thread ancestry or a spawn from an already owned thread can introduce a child. */
46
+ export function learnNativeSubagents(database, method, params, threadId, turnId) {
47
+ const payload = record(params);
48
+ if (method === 'thread/started') {
49
+ const thread = record(payload.thread);
50
+ const spawn = record(record(record(thread.source).subAgent).thread_spawn);
51
+ const childId = text(thread.id);
52
+ const parentId = text(thread.parentThreadId) ?? text(spawn.parent_thread_id);
53
+ if (!childId || !parentId || (text(thread.parentThreadId) && text(spawn.parent_thread_id) && thread.parentThreadId !== spawn.parent_thread_id))
54
+ return [];
55
+ const owner = nativeEventOwner(database, parentId);
56
+ if (!owner)
57
+ return [];
58
+ const changed = remember(database, childId, parentId, owner, {
59
+ agentNickname: text(thread.agentNickname) ?? text(spawn.agent_nickname),
60
+ agentRole: text(thread.agentRole) ?? text(spawn.agent_role),
61
+ agentPath: text(spawn.agent_path),
62
+ }, false);
63
+ return changed ? [childId] : [];
64
+ }
65
+ if (method !== 'item/started' && method !== 'item/completed')
66
+ return [];
67
+ const item = record(payload.item);
68
+ if (item.type !== 'collabAgentToolCall' || item.senderThreadId !== threadId)
69
+ return [];
70
+ const owner = nativeEventOwner(database, threadId, turnId);
71
+ if (!owner || !owner.operation)
72
+ return [];
73
+ const receivers = Array.isArray(item.receiverThreadIds) ? item.receiverThreadIds.filter((id) => typeof id === 'string' && id.length > 0) : [];
74
+ const changed = [];
75
+ for (const childId of receivers) {
76
+ if (item.tool === 'spawnAgent') {
77
+ if (remember(database, childId, threadId, owner, {}))
78
+ changed.push(childId);
79
+ }
80
+ else if (['sendInput', 'resumeAgent', 'sendMessage', 'followupTask'].includes(String(item.tool))) {
81
+ const existing = readRecord(database, 'native_subagent_threads', childId);
82
+ if (!existing || existing.sessionId !== owner.session.sessionId || existing.rootThreadId !== (owner.subAgent?.rootThreadId ?? threadId))
83
+ continue;
84
+ if (method === 'item/started' && item.status === 'inProgress' && existing.operationScopeKey !== owner.operation.scopeKey) {
85
+ writeRecord(database, 'native_subagent_pending_followups', childId, { itemId: item.id, operationScopeKey: owner.operation.scopeKey });
86
+ continue;
87
+ }
88
+ if (method !== 'item/completed')
89
+ continue;
90
+ const pending = readRecord(database, 'native_subagent_pending_followups', childId);
91
+ if (pending?.itemId === item.id)
92
+ database.prepare('DELETE FROM records WHERE bucket = ? AND record_key = ?').run('native_subagent_pending_followups', childId);
93
+ if (item.status === 'completed' && existing.operationScopeKey !== owner.operation.scopeKey)
94
+ writeRecord(database, 'native_subagent_threads', childId, { ...existing, operationScopeKey: owner.operation.scopeKey });
95
+ if (pending?.itemId === item.id || item.status === 'completed')
96
+ changed.push(childId);
97
+ }
98
+ }
99
+ return changed;
100
+ }
101
+ export function nativeSubagentThreads(database, rootThreadId) {
102
+ const rows = database.prepare("SELECT record_key FROM records WHERE bucket = 'native_subagent_threads' AND json_extract(body_json, '$.rootThreadId') = ?")
103
+ .all(rootThreadId);
104
+ return rows.map(row => row.record_key);
105
+ }
106
+ export function clearPendingNativeFollowups(database) {
107
+ const rows = database.prepare("SELECT record_key FROM records WHERE bucket = 'native_subagent_pending_followups'")
108
+ .all();
109
+ database.prepare("DELETE FROM records WHERE bucket = 'native_subagent_pending_followups'").run();
110
+ return rows.map(row => row.record_key);
111
+ }
112
+ function remember(database, childId, parentId, owner, metadata, confirmed = true) {
113
+ if (childId === parentId || sessionsForThread(database, childId).length)
114
+ return false;
115
+ const rootThreadId = owner.subAgent?.rootThreadId ?? text(owner.session.threadId);
116
+ if (childId === rootThreadId)
117
+ return false;
118
+ const previous = readRecord(database, 'native_subagent_threads', childId);
119
+ if (previous && (previous.parentThreadId !== parentId || previous.rootThreadId !== rootThreadId || previous.sessionId !== owner.session.sessionId))
120
+ return false;
121
+ const defined = Object.fromEntries(Object.entries(metadata).filter(([, value]) => value !== undefined));
122
+ // Thread ancestry contains no parent turn. Wait for its spawn item before archiving events
123
+ // against an operation: a parent agent may still be running an older, pinned turn.
124
+ const wasConfirmed = previous && previous.operationConfirmed !== false;
125
+ const next = { ...previous, ...defined, threadId: childId, parentThreadId: parentId, rootThreadId,
126
+ sessionId: String(owner.session.sessionId), workspaceId: text(owner.session.workspaceId),
127
+ operationConfirmed: Boolean(wasConfirmed || confirmed),
128
+ operationScopeKey: wasConfirmed ? previous.operationScopeKey : confirmed ? owner.operation?.scopeKey : undefined };
129
+ if (JSON.stringify(previous) === JSON.stringify(next))
130
+ return false;
131
+ writeRecord(database, 'native_subagent_threads', childId, next);
132
+ return true;
133
+ }
134
+ function ownsOperation(session, rootThreadId, found) {
135
+ return Boolean(found && ['session.turn', 'session.review', 'session.compact'].includes(found.operation.kind) && found.operation.sessionId === session.sessionId &&
136
+ (found.operation.workspaceId === undefined || found.operation.workspaceId === session.workspaceId) && found.operation.nativeThreadId === rootThreadId);
137
+ }
138
+ function readOperation(database, column, value, threadId) {
139
+ if (!value)
140
+ return undefined;
141
+ const row = database.prepare(`SELECT scope_key, operation_json FROM operation_intents WHERE ${column} = ?${threadId ? ' AND thread_id = ?' : ''}${column === 'turn_id' ? " AND json_extract(operation_json, '$.kind') IN ('session.turn', 'session.review', 'session.compact')" : ''}`)
142
+ .get(...(threadId ? [value, threadId] : [value]));
143
+ if (!row)
144
+ return undefined;
145
+ const parsed = operationRecordSchema.safeParse(JSON.parse(row.operation_json));
146
+ return parsed.success ? { scopeKey: row.scope_key, operation: parsed.data } : undefined;
147
+ }
148
+ function sessionsForThread(database, threadId) {
149
+ const rows = database.prepare("SELECT body_json FROM records WHERE bucket = 'sessions' AND json_extract(body_json, '$.threadId') = ?")
150
+ .all(threadId);
151
+ return rows.map(row => record(JSON.parse(row.body_json)));
152
+ }
153
+ function readRecord(database, bucket, key) {
154
+ const row = database.prepare('SELECT body_json FROM records WHERE bucket = ? AND record_key = ?').get(bucket, key);
155
+ return row ? record(JSON.parse(row.body_json)) : undefined;
156
+ }
157
+ function writeRecord(database, bucket, key, value) {
158
+ database.prepare('INSERT INTO records (bucket, record_key, body_json) VALUES (?, ?, ?) ON CONFLICT(bucket, record_key) DO UPDATE SET body_json = excluded.body_json')
159
+ .run(bucket, key, JSON.stringify(value));
160
+ }
161
+ function text(value) { return typeof value === 'string' && value.length > 0 ? value : undefined; }
162
+ function record(value) { return value && typeof value === 'object' && !Array.isArray(value) ? value : {}; }
@@ -0,0 +1,77 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { fileURLToPath } from 'node:url';
3
+ import { Worker } from 'node:worker_threads';
4
+ export class SqliteWorkerClient {
5
+ nextId = 1;
6
+ pending = new Map();
7
+ chain = Promise.resolve();
8
+ worker;
9
+ constructor(worker) {
10
+ this.worker = worker;
11
+ worker.on('message', (message) => {
12
+ const waiter = this.pending.get(message.id);
13
+ if (!waiter)
14
+ return;
15
+ this.pending.delete(message.id);
16
+ if (message.ok)
17
+ waiter.resolve(message.result);
18
+ else
19
+ waiter.reject(new Error(message.error || 'sqlite_worker_failed'));
20
+ });
21
+ worker.on('error', (error) => {
22
+ for (const waiter of this.pending.values())
23
+ waiter.reject(error);
24
+ this.pending.clear();
25
+ });
26
+ }
27
+ static async open(filePath, legacy) {
28
+ const url = workerUrl();
29
+ const execArgv = url.pathname.endsWith('.ts') ? ['--import', sourceResolver()] : [];
30
+ const client = new SqliteWorkerClient(new Worker(url, { execArgv, env: { ...process.env, NODE_OPTIONS: '' } }));
31
+ try {
32
+ const opened = await client.request('open', { filePath, legacy });
33
+ return { client, opened };
34
+ }
35
+ catch (error) {
36
+ await client.close().catch(() => undefined);
37
+ throw error;
38
+ }
39
+ }
40
+ request(type, payload) {
41
+ const run = this.chain.then(() => this.send(type, payload));
42
+ this.chain = run.then(() => undefined, () => undefined);
43
+ return run;
44
+ }
45
+ async close() {
46
+ await this.request('close', {}).catch(() => undefined);
47
+ await this.worker.terminate();
48
+ }
49
+ send(type, payload) {
50
+ const id = this.nextId;
51
+ this.nextId += 1;
52
+ return new Promise((resolve, reject) => {
53
+ this.pending.set(id, { resolve: (value) => resolve(value), reject });
54
+ this.worker.postMessage({ id, type, payload });
55
+ });
56
+ }
57
+ }
58
+ function workerUrl() {
59
+ const compiled = new URL('./sqlite-worker.js', import.meta.url);
60
+ if (existsSync(fileURLToPath(compiled)))
61
+ return compiled;
62
+ return new URL('./sqlite-worker.ts', import.meta.url);
63
+ }
64
+ /** Source tests use Node's type stripping, with relative emitted imports resolved to their sources. */
65
+ function sourceResolver() {
66
+ return `data:text/javascript,${encodeURIComponent(`
67
+ import { registerHooks } from 'node:module';
68
+ import { existsSync } from 'node:fs';
69
+ registerHooks({ resolve(specifier, context, next) {
70
+ if (context.parentURL?.endsWith('.ts') && specifier.startsWith('./') && specifier.endsWith('.js')) {
71
+ const source = new URL(specifier.slice(0, -3) + '.ts', context.parentURL);
72
+ if (existsSync(source)) return next(source.href, context);
73
+ }
74
+ return next(specifier, context);
75
+ } });
76
+ `)}`;
77
+ }