@playcraft/cli 0.1.38-beta → 0.1.39-prod

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