@playcraft/cli 0.1.40-beta → 0.1.42

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