@playcraft/cli 0.1.34 → 0.1.35-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 (347) hide show
  1. package/README.md +3 -56
  2. package/dist/agent/local-backend.js +1 -1
  3. package/dist/cli-root-help.js +0 -2
  4. package/dist/commands/build.js +4 -9
  5. package/dist/commands/create.js +33 -26
  6. package/dist/commands/image.js +6 -2
  7. package/dist/commands/login.js +42 -84
  8. package/dist/commands/skills.js +0 -2
  9. package/dist/commands/tools-3d.js +0 -11
  10. package/dist/commands/tools-generation.js +109 -68
  11. package/dist/commands/tools-image-context.js +23 -0
  12. package/dist/commands/tools.js +2 -2
  13. package/dist/config.js +4 -59
  14. package/dist/index.js +3 -36
  15. package/dist/remix/clone.js +0 -2
  16. package/dist/remix/init-template.js +0 -2
  17. package/dist/remix/pull.js +0 -2
  18. package/dist/remix/push.js +1 -21
  19. package/dist/utils/agent-api-client.js +30 -185
  20. package/dist/utils/image-asset-context.js +105 -0
  21. package/dist/utils/playcraft-http-client.js +4 -6
  22. package/package.json +3 -12
  23. package/project-template/.claude/agents/refs/ta-image-generation-detail.md +67 -123
  24. package/project-template/.claude/skills/playcraft-image-generation/SKILL.md +105 -44
  25. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  26. package/project-template/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  27. package/project-template/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  28. package/project-template/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +36 -39
  29. package/project-templates/phaser/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  30. package/project-templates/phaser/.claude/skills/playcraft-image-generation/SKILL.md +105 -44
  31. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  32. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  33. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  34. package/project-templates/phaser/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +36 -39
  35. package/project-templates/threejs/.claude/agents/refs/ta-image-generation-detail.md +59 -59
  36. package/project-templates/threejs/.claude/skills/playcraft-image-generation/SKILL.md +105 -44
  37. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +42 -33
  38. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +18 -20
  39. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +6 -7
  40. package/project-templates/threejs/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +36 -39
  41. package/dist/auth/account-activation.js +0 -157
  42. package/dist/auth/messages.js +0 -30
  43. package/dist/commands/platform-skills.generated.js +0 -19
  44. package/dist/commands/playable.js +0 -53
  45. package/dist/commands/tools-batch.js +0 -87
  46. package/dist/commands/video.js +0 -111
  47. package/dist/commands/workspace-runtime.js +0 -54
  48. package/dist/commands/workspace.js +0 -35
  49. package/dist/project-skills/builtin-import.js +0 -225
  50. package/dist/project-skills/commands.js +0 -77
  51. package/dist/project-skills/lifecycle.js +0 -28
  52. package/dist/project-skills/local-run.js +0 -112
  53. package/dist/project-skills/local-store.js +0 -221
  54. package/dist/project-skills/messages.js +0 -80
  55. package/dist/project-skills/reconcile.js +0 -62
  56. package/dist/project-skills/remote-cache.js +0 -51
  57. package/dist/project-skills/validation.js +0 -19
  58. package/dist/recording/messages.js +0 -40
  59. package/dist/recording/project-digest.js +0 -85
  60. package/dist/recording/recorder.js +0 -293
  61. package/dist/recording/scenario.js +0 -50
  62. package/dist/utils/environment-endpoints.js +0 -17
  63. package/dist/utils/tool-operation-journal.js +0 -124
  64. package/dist/utils/video-evidence-git.js +0 -81
  65. package/dist/video-replication/client.js +0 -222
  66. package/dist/video-replication/comparison-evidence.js +0 -149
  67. package/dist/video-replication/comparison-files.js +0 -57
  68. package/dist/video-replication/comparison-log.js +0 -72
  69. package/dist/video-replication/comparison-messages.js +0 -104
  70. package/dist/video-replication/comparison-output.js +0 -63
  71. package/dist/video-replication/comparison-preflight.js +0 -66
  72. package/dist/video-replication/comparison.js +0 -216
  73. package/dist/video-replication/evidence.js +0 -165
  74. package/dist/video-replication/media.js +0 -111
  75. package/dist/video-replication/messages.js +0 -89
  76. package/dist/workspace/messages.js +0 -35
  77. package/dist/workspace/transfer-client.js +0 -174
  78. package/dist/workspace-runtime/codex/app-server.js +0 -965
  79. package/dist/workspace-runtime/codex/compact.js +0 -46
  80. package/dist/workspace-runtime/codex/config-toml.js +0 -107
  81. package/dist/workspace-runtime/codex/jsonrpc-stdio.js +0 -145
  82. package/dist/workspace-runtime/codex/launcher-client.js +0 -177
  83. package/dist/workspace-runtime/codex/loopback.js +0 -146
  84. package/dist/workspace-runtime/codex/mcp-config.js +0 -39
  85. package/dist/workspace-runtime/codex/model-broker.js +0 -263
  86. package/dist/workspace-runtime/codex/native-adapter.js +0 -9
  87. package/dist/workspace-runtime/codex/permissions.js +0 -70
  88. package/dist/workspace-runtime/codex/work-mode.js +0 -15
  89. package/dist/workspace-runtime/main.js +0 -10
  90. package/dist/workspace-runtime/persistence/journal.js +0 -355
  91. package/dist/workspace-runtime/persistence/native-subagents.js +0 -162
  92. package/dist/workspace-runtime/persistence/sqlite-client.js +0 -77
  93. package/dist/workspace-runtime/persistence/sqlite-worker.js +0 -1096
  94. package/dist/workspace-runtime/previews/output.js +0 -36
  95. package/dist/workspace-runtime/previews/publish.js +0 -262
  96. package/dist/workspace-runtime/previews/single-file.js +0 -43
  97. package/dist/workspace-runtime/processes/managed-writes.js +0 -69
  98. package/dist/workspace-runtime/production/contracts.js +0 -17
  99. package/dist/workspace-runtime/production/controller.js +0 -207
  100. package/dist/workspace-runtime/production/dependencies.js +0 -60
  101. package/dist/workspace-runtime/production/native.js +0 -203
  102. package/dist/workspace-runtime/production/processes.js +0 -86
  103. package/dist/workspace-runtime/production/save-command.js +0 -35
  104. package/dist/workspace-runtime/production/source-copy.js +0 -91
  105. package/dist/workspace-runtime/production/stages.js +0 -205
  106. package/dist/workspace-runtime/production/storage.js +0 -60
  107. package/dist/workspace-runtime/serve.js +0 -207
  108. package/dist/workspace-runtime/server/auth.js +0 -21
  109. package/dist/workspace-runtime/server/connectivity.js +0 -201
  110. package/dist/workspace-runtime/server/desktop-host.js +0 -429
  111. package/dist/workspace-runtime/server/desktop-preview-config.js +0 -81
  112. package/dist/workspace-runtime/server/desktop-preview-service.js +0 -157
  113. package/dist/workspace-runtime/server/desktop-preview-static.js +0 -53
  114. package/dist/workspace-runtime/server/desktop-preview.js +0 -189
  115. package/dist/workspace-runtime/server/dispatch.js +0 -1183
  116. package/dist/workspace-runtime/server/endpoints.js +0 -19
  117. package/dist/workspace-runtime/server/execution-group.js +0 -85
  118. package/dist/workspace-runtime/server/http.js +0 -1127
  119. package/dist/workspace-runtime/server/lock.js +0 -53
  120. package/dist/workspace-runtime/server/rfb-watch-gate.js +0 -168
  121. package/dist/workspace-runtime/server/terminal-host.js +0 -366
  122. package/dist/workspace-runtime/server/types.js +0 -1
  123. package/dist/workspace-runtime/server/workspace-transfer.js +0 -99
  124. package/dist/workspace-runtime/workspaces/archive.js +0 -207
  125. package/dist/workspace-runtime/workspaces/artifact-events.js +0 -55
  126. package/dist/workspace-runtime/workspaces/artifact-files.js +0 -197
  127. package/dist/workspace-runtime/workspaces/artifact-receipts.js +0 -89
  128. package/dist/workspace-runtime/workspaces/artifacts.js +0 -282
  129. package/dist/workspace-runtime/workspaces/attachment-content.js +0 -123
  130. package/dist/workspace-runtime/workspaces/attachments.js +0 -181
  131. package/dist/workspace-runtime/workspaces/batch-commit.js +0 -142
  132. package/dist/workspace-runtime/workspaces/cli-context.js +0 -23
  133. package/dist/workspace-runtime/workspaces/cli-credentials.js +0 -111
  134. package/dist/workspace-runtime/workspaces/composer-context.js +0 -125
  135. package/dist/workspace-runtime/workspaces/context-error.js +0 -2
  136. package/dist/workspace-runtime/workspaces/dependencies.js +0 -264
  137. package/dist/workspace-runtime/workspaces/developer-command.js +0 -64
  138. package/dist/workspace-runtime/workspaces/directories.js +0 -123
  139. package/dist/workspace-runtime/workspaces/directory-access.js +0 -37
  140. package/dist/workspace-runtime/workspaces/directory-attachments.js +0 -245
  141. package/dist/workspace-runtime/workspaces/directory-maintenance.js +0 -111
  142. package/dist/workspace-runtime/workspaces/directory-stats.js +0 -49
  143. package/dist/workspace-runtime/workspaces/disk-snapshot.js +0 -31
  144. package/dist/workspace-runtime/workspaces/empty-template.js +0 -40
  145. package/dist/workspace-runtime/workspaces/files-search.js +0 -116
  146. package/dist/workspace-runtime/workspaces/files.js +0 -120
  147. package/dist/workspace-runtime/workspaces/git-credential-broker.js +0 -312
  148. package/dist/workspace-runtime/workspaces/git-credential-helper.js +0 -68
  149. package/dist/workspace-runtime/workspaces/git-direct-store.js +0 -155
  150. package/dist/workspace-runtime/workspaces/git.js +0 -670
  151. package/dist/workspace-runtime/workspaces/instructions.js +0 -56
  152. package/dist/workspace-runtime/workspaces/json5-edit.js +0 -170
  153. package/dist/workspace-runtime/workspaces/library-attachments.js +0 -268
  154. package/dist/workspace-runtime/workspaces/parameters.js +0 -272
  155. package/dist/workspace-runtime/workspaces/prepare.js +0 -264
  156. package/dist/workspace-runtime/workspaces/registry.js +0 -236
  157. package/dist/workspace-runtime/workspaces/revisions.js +0 -31
  158. package/dist/workspace-runtime/workspaces/shared-git.js +0 -40
  159. package/dist/workspace-runtime/workspaces/skill-artifact-loader.js +0 -91
  160. package/dist/workspace-runtime/workspaces/skills.js +0 -189
  161. package/dist/workspace-runtime/workspaces/transfer.js +0 -288
  162. package/dist/workspace-runtime/workspaces/turn-changes.js +0 -75
  163. package/dist/workspace-runtime/workspaces/video-attachments.js +0 -49
  164. package/project-template/.claude/skills/playcraft-replica-validation/SKILL.md +0 -25
  165. package/project-template/.claude/skills/playcraft-replica-validation/references/contracts.md +0 -79
  166. package/project-template/.claude/skills/playcraft-video-understanding/SKILL.md +0 -29
  167. package/project-template/.claude/skills/playcraft-video-understanding/references/contracts.md +0 -37
  168. package/project-template-v2/.claude/agents/artist.md +0 -82
  169. package/project-template-v2/.claude/agents/developer.md +0 -153
  170. package/project-template-v2/.claude/agents/game-designer.md +0 -264
  171. package/project-template-v2/.claude/agents/refs/artist-art-style-catalog.md +0 -533
  172. package/project-template-v2/.claude/agents/refs/artist-color-audio-recipes.md +0 -153
  173. package/project-template-v2/.claude/agents/refs/artist-dimension-axis.md +0 -27
  174. package/project-template-v2/.claude/agents/refs/artist-master-composite-recipes.md +0 -208
  175. package/project-template-v2/.claude/agents/refs/atom-skill-library.md +0 -81
  176. package/project-template-v2/.claude/agents/refs/developer-impl-cookbook.md +0 -432
  177. package/project-template-v2/.claude/agents/refs/framework-5-component-filter.md +0 -252
  178. package/project-template-v2/.claude/agents/refs/framework-game-feel-juice.md +0 -266
  179. package/project-template-v2/.claude/agents/refs/framework-mda.md +0 -147
  180. package/project-template-v2/.claude/agents/refs/game-designer-gameplay-sufficiency.md +0 -123
  181. package/project-template-v2/.claude/agents/refs/ta-3d-flip-recipe.md +0 -88
  182. package/project-template-v2/.claude/agents/refs/ta-atlas-deliverable-standard.md +0 -67
  183. package/project-template-v2/.claude/agents/refs/ta-batch-pipeline-recipes.md +0 -120
  184. package/project-template-v2/.claude/agents/refs/ta-image-generation-detail.md +0 -300
  185. package/project-template-v2/.claude/agents/refs/ta-image-ops-reference.md +0 -495
  186. package/project-template-v2/.claude/agents/refs/ta-pipeline-cookbook.md +0 -1141
  187. package/project-template-v2/.claude/agents/refs/ta-tools-reference.md +0 -111
  188. package/project-template-v2/.claude/agents/refs/ta-vfx-preset-catalog.md +0 -365
  189. package/project-template-v2/.claude/agents/refs/threejs-cannon-pitfalls.md +0 -412
  190. package/project-template-v2/.claude/agents/reviewer.md +0 -75
  191. package/project-template-v2/.claude/agents/technical-artist.md +0 -86
  192. package/project-template-v2/.claude/hooks/snapshot-milestone.mjs +0 -243
  193. package/project-template-v2/.claude/hooks/user-prompt.mjs +0 -133
  194. package/project-template-v2/.claude/settings.json +0 -33
  195. package/project-template-v2/.claude/skills/brainstorming/SKILL.md +0 -161
  196. package/project-template-v2/.claude/skills/brainstorming/scripts/frame-template.html +0 -270
  197. package/project-template-v2/.claude/skills/brainstorming/scripts/helper.js +0 -177
  198. package/project-template-v2/.claude/skills/brainstorming/scripts/server.cjs +0 -354
  199. package/project-template-v2/.claude/skills/brainstorming/scripts/start-server.sh +0 -148
  200. package/project-template-v2/.claude/skills/brainstorming/scripts/stop-server.sh +0 -56
  201. package/project-template-v2/.claude/skills/brainstorming/scripts/wait-for-selection.sh +0 -62
  202. package/project-template-v2/.claude/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  203. package/project-template-v2/.claude/skills/brainstorming/visual-companion.md +0 -309
  204. package/project-template-v2/.claude/skills/playcraft-ad-psychology/SKILL.md +0 -182
  205. package/project-template-v2/.claude/skills/playcraft-art-style-guide/SKILL.md +0 -123
  206. package/project-template-v2/.claude/skills/playcraft-asset-state-sheet/SKILL.md +0 -205
  207. package/project-template-v2/.claude/skills/playcraft-audio-generation/SKILL.md +0 -280
  208. package/project-template-v2/.claude/skills/playcraft-batch-pipeline/SKILL.md +0 -184
  209. package/project-template-v2/.claude/skills/playcraft-build-optimizer/SKILL.md +0 -306
  210. package/project-template-v2/.claude/skills/playcraft-image-generation/SKILL.md +0 -298
  211. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/build-sprite-sheet.template.mjs +0 -123
  212. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/compare-style.template.mjs +0 -254
  213. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch-sprite.template.mjs +0 -324
  214. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-batch.template.mjs +0 -97
  215. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/gen-edit-variants.template.mjs +0 -118
  216. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/process-batch.template.mjs +0 -137
  217. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/prompt-cookbook.md +0 -397
  218. package/project-template-v2/.claude/skills/playcraft-image-generation/reference/validate-sprite-sheet.template.mjs +0 -296
  219. package/project-template-v2/.claude/skills/playcraft-image-ops/SKILL.md +0 -122
  220. package/project-template-v2/.claude/skills/playcraft-image-processing/SKILL.md +0 -219
  221. package/project-template-v2/.claude/skills/playcraft-masking/SKILL.md +0 -373
  222. package/project-template-v2/.claude/skills/playcraft-playable-optimization/SKILL.md +0 -161
  223. package/project-template-v2/.claude/skills/playcraft-research/SKILL.md +0 -215
  224. package/project-template-v2/.claude/skills/playcraft-skill-recommender/SKILL.md +0 -382
  225. package/project-template-v2/.claude/skills/playcraft-sprite-generation/SKILL.md +0 -423
  226. package/project-template-v2/.claude/skills/playcraft-sprite-remix/SKILL.md +0 -158
  227. package/project-template-v2/.claude/skills/playcraft-sprite-sheet/SKILL.md +0 -100
  228. package/project-template-v2/.claude/skills/playcraft-storyboard/SKILL.md +0 -167
  229. package/project-template-v2/.claude/skills/playcraft-style-qa/SKILL.md +0 -270
  230. package/project-template-v2/.claude/skills/playcraft-text-rendering/SKILL.md +0 -236
  231. package/project-template-v2/.claude/skills/playcraft-vfx-animation/SKILL.md +0 -130
  232. package/project-template-v2/.claude/skills/playwright-cli/SKILL.md +0 -390
  233. package/project-template-v2/.claude/skills/playwright-cli/references/element-attributes.md +0 -23
  234. package/project-template-v2/.claude/skills/playwright-cli/references/playwright-tests.md +0 -39
  235. package/project-template-v2/.claude/skills/playwright-cli/references/request-mocking.md +0 -87
  236. package/project-template-v2/.claude/skills/playwright-cli/references/running-code.md +0 -240
  237. package/project-template-v2/.claude/skills/playwright-cli/references/session-management.md +0 -226
  238. package/project-template-v2/.claude/skills/playwright-cli/references/spec-driven-testing.md +0 -308
  239. package/project-template-v2/.claude/skills/playwright-cli/references/storage-state.md +0 -275
  240. package/project-template-v2/.claude/skills/playwright-cli/references/test-generation.md +0 -134
  241. package/project-template-v2/.claude/skills/playwright-cli/references/tracing.md +0 -142
  242. package/project-template-v2/.claude/skills/playwright-cli/references/video-recording.md +0 -153
  243. package/project-template-v2/.claude/skills/session-analyzer/SKILL.md +0 -386
  244. package/project-template-v2/.claude/skills/session-analyzer/scripts/execution-breakdown.mjs +0 -182
  245. package/project-template-v2/.claude/skills/session-analyzer/scripts/find-turns.mjs +0 -72
  246. package/project-template-v2/.claude/skills/session-analyzer/scripts/heavy-output.mjs +0 -121
  247. package/project-template-v2/.claude/skills/session-analyzer/scripts/resolve-session.mjs +0 -102
  248. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-stats.mjs +0 -127
  249. package/project-template-v2/.claude/skills/session-analyzer/scripts/subagent-tool-timeline.mjs +0 -106
  250. package/project-template-v2/.claude/skills/session-analyzer/scripts/time-gaps.mjs +0 -128
  251. package/project-template-v2/.claude/skills/session-analyzer/scripts/turn-timeline.mjs +0 -67
  252. package/project-template-v2/.claude/snapshot.mjs +0 -263
  253. package/project-template-v2/.playcraft/skills.lock.json +0 -152
  254. package/project-template-v2/CLAUDE.md +0 -146
  255. package/project-template-v2/assets/audio/bgm/.gitkeep +0 -0
  256. package/project-template-v2/assets/audio/sfx/.gitkeep +0 -0
  257. package/project-template-v2/assets/bundles/.gitkeep +0 -0
  258. package/project-template-v2/assets/images/bg/.gitkeep +0 -0
  259. package/project-template-v2/assets/images/reference/.gitkeep +0 -0
  260. package/project-template-v2/assets/images/storyboard/.gitkeep +0 -0
  261. package/project-template-v2/assets/images/tiles/.gitkeep +0 -0
  262. package/project-template-v2/assets/images/ui/.gitkeep +0 -0
  263. package/project-template-v2/assets/images/vfx/.gitkeep +0 -0
  264. package/project-template-v2/assets/models/.gitkeep +0 -0
  265. package/project-template-v2/docs/harness/iteration-1/context-flow.md +0 -254
  266. package/project-template-v2/docs/harness/iteration-1/generate-flow.md +0 -91
  267. package/project-template-v2/docs/harness/iteration-1/ideate-flow.md +0 -214
  268. package/project-template-v2/docs/harness/iteration-1/optimize-flow.md +0 -75
  269. package/project-template-v2/docs/harness/iteration-1/wrapup-flow.md +0 -63
  270. package/project-template-v2/docs/harness/iteration-2/context-flow.md +0 -223
  271. package/project-template-v2/docs/harness/iteration-2/generate-flow.md +0 -129
  272. package/project-template-v2/docs/harness/iteration-2/ideate-flow.md +0 -267
  273. package/project-template-v2/docs/harness/iteration-2/optimize-flow.md +0 -164
  274. package/project-template-v2/docs/harness/iteration-2/wrapup-flow.md +0 -115
  275. package/project-template-v2/docs/harness/orchestrator-flow.md +0 -364
  276. package/project-template-v2/docs/project-state.json +0 -60
  277. package/project-template-v2/docs/project-state.md +0 -72
  278. package/project-template-v2/docs/standards/README.md +0 -225
  279. package/project-template-v2/docs/standards/agent-behavior-standards.md +0 -174
  280. package/project-template-v2/docs/standards/artifacts/design-brief.md +0 -19
  281. package/project-template-v2/docs/standards/artifacts/design.md +0 -22
  282. package/project-template-v2/docs/standards/artifacts/game-code.md +0 -41
  283. package/project-template-v2/docs/standards/artifacts/todo-list.md +0 -41
  284. package/project-template-v2/docs/standards/iter1-agent-behavior-standards.md +0 -343
  285. package/project-template-v2/game/index.ts +0 -18
  286. package/project-template-v2/globals.d.ts +0 -51
  287. package/project-template-v2/index.css +0 -34
  288. package/project-template-v2/index.html +0 -18
  289. package/project-template-v2/main.ts +0 -9
  290. package/project-template-v2/package.json +0 -46
  291. package/project-template-v2/skills/_shared/scripts/dispatch-clear.mjs +0 -31
  292. package/project-template-v2/skills/_shared/scripts/dispatch-set.mjs +0 -86
  293. package/project-template-v2/skills/_shared/scripts/dod-check.mjs +0 -153
  294. package/project-template-v2/skills/_shared/scripts/handoff-append.mjs +0 -70
  295. package/project-template-v2/skills/_shared/scripts/lib/validator-artifacts.mjs +0 -91
  296. package/project-template-v2/skills/_shared/scripts/pipeline/dod-config.mjs +0 -131
  297. package/project-template-v2/skills/_shared/scripts/pipeline/index.mjs +0 -80
  298. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-1-core.mjs +0 -90
  299. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-2-wrap.mjs +0 -93
  300. package/project-template-v2/skills/_shared/scripts/pipeline/iteration-3-visual.mjs +0 -23
  301. package/project-template-v2/skills/_shared/scripts/render-project-state.mjs +0 -230
  302. package/project-template-v2/skills/_shared/scripts/state-advance-stage.mjs +0 -58
  303. package/project-template-v2/skills/_shared/scripts/state-get.mjs +0 -339
  304. package/project-template-v2/skills/_shared/scripts/state-handoff.mjs +0 -39
  305. package/project-template-v2/skills/_shared/scripts/state-set.mjs +0 -94
  306. package/project-template-v2/skills/_shared/scripts/state-store.mjs +0 -783
  307. package/project-template-v2/skills/_shared/scripts/todo-add.mjs +0 -88
  308. package/project-template-v2/skills/_shared/scripts/todo-get.mjs +0 -130
  309. package/project-template-v2/skills/_shared/scripts/todo-remove.mjs +0 -33
  310. package/project-template-v2/skills/_shared/scripts/todo-set.mjs +0 -47
  311. package/project-template-v2/skills/_shared/scripts/verify-asset-code-sync.mjs +0 -268
  312. package/project-template-v2/skills/_shared/scripts/verify-env.mjs +0 -285
  313. package/project-template-v2/skills/_shared/scripts/verify-placeholders.mjs +0 -161
  314. package/project-template-v2/skills/playable-autoplay/SKILL.md +0 -176
  315. package/project-template-v2/skills/playable-autoplay/agents/openai.yaml +0 -4
  316. package/project-template-v2/skills/playable-debug/SKILL.md +0 -116
  317. package/project-template-v2/skills/playable-debug/agents/openai.yaml +0 -4
  318. package/project-template-v2/skills/playable-debug/references/debug-config.md +0 -40
  319. package/project-template-v2/skills/playable-record/SKILL.md +0 -140
  320. package/project-template-v2/skills/playable-record/scripts/lib/dev-server.mjs +0 -104
  321. package/project-template-v2/skills/playable-record/scripts/lib/record-audio-bridge.js +0 -141
  322. package/project-template-v2/skills/playable-record/scripts/record-playable.mjs +0 -425
  323. package/project-template-v2/skills/playable-record/scripts/verify-contract.mjs +0 -261
  324. package/project-template-v2/skills/playable-record/scripts/verify-firstwin.mjs +0 -398
  325. package/project-template-v2/skills/playable-record/scripts/verify-fusion.mjs +0 -322
  326. package/project-template-v2/skills/playable-record/scripts/verify-lifecycle.mjs +0 -105
  327. package/project-template-v2/skills/playable-record/scripts/verify-vlm-video.mjs +0 -230
  328. package/project-template-v2/skills/playable-validate/SKILL.md +0 -61
  329. package/project-template-v2/skills/playable-validate/validation-rules.md +0 -14
  330. package/project-template-v2/skills/playable-verify-ui/SKILL.md +0 -63
  331. package/project-template-v2/skills/playable-verify-ui/scripts/lib/__init__.py +0 -1
  332. package/project-template-v2/skills/playable-verify-ui/scripts/lib/config_expr.js +0 -218
  333. package/project-template-v2/skills/playable-verify-ui/scripts/lib/node_utils.js +0 -51
  334. package/project-template-v2/skills/playable-verify-ui/scripts/lib/profile_loader.py +0 -59
  335. package/project-template-v2/skills/playable-verify-ui/scripts/lib/report.py +0 -106
  336. package/project-template-v2/skills/playable-verify-ui/scripts/lib/runtime_contract.js +0 -116
  337. package/project-template-v2/skills/playable-verify-ui/scripts/verify_fetch_antipatterns.py +0 -59
  338. package/project-template-v2/skills/playable-verify-ui/scripts/verify_hardcoded_layout.js +0 -64
  339. package/project-template-v2/skills/playable-verify-ui/scripts/verify_runtime_contract.js +0 -58
  340. package/project-template-v2/skills/playable-verify-ui/scripts/verify_text_overlap.py +0 -333
  341. package/project-template-v2/ta-workspace/scripts/.gitkeep +0 -0
  342. package/project-template-v2/tsconfig.json +0 -20
  343. package/project-template-v2/vite.config.ts +0 -27
  344. package/project-templates/batch-locks/phaser.yaml +0 -922
  345. package/project-templates/batch-locks/threejs.yaml +0 -978
  346. package/project-templates/empty/AGENTS.md +0 -39
  347. package/project-templates/empty/gitignore +0 -33
@@ -1,121 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * heavy-output.mjs — Find turns with heavy thinking/writing output in a session/subagent
4
- *
5
- * Identifies which turns generated the most content (large thinking blocks, big file writes)
6
- * to understand where the model spent its output budget.
7
- *
8
- * Usage:
9
- * node heavy-output.mjs <file.jsonl>
10
- * node heavy-output.mjs <file.jsonl> --min-kb 3 (minimum 3KB, default 5)
11
- * node heavy-output.mjs <file.jsonl> --top 20 (show top 20, default 15)
12
- *
13
- * Output: sorted list of heaviest output turns with content breakdown
14
- */
15
-
16
- import { readFileSync } from 'fs';
17
-
18
- const filePath = process.argv[2];
19
- const minIdx = process.argv.indexOf('--min-kb');
20
- const minKB = minIdx >= 0 ? parseFloat(process.argv[minIdx + 1]) : 5;
21
- const topIdx = process.argv.indexOf('--top');
22
- const topN = topIdx >= 0 ? parseInt(process.argv[topIdx + 1], 10) : 15;
23
-
24
- if (!filePath) {
25
- console.error('Usage: node heavy-output.mjs <file.jsonl> [--min-kb <N>] [--top <N>]');
26
- process.exit(1);
27
- }
28
-
29
- const lines = readFileSync(filePath, 'utf8').trim().split('\n');
30
- const heavyTurns = [];
31
-
32
- lines.forEach((line, idx) => {
33
- try {
34
- const obj = JSON.parse(line);
35
- if (obj.type !== 'assistant') return;
36
-
37
- const blocks = obj.message?.content || [];
38
- let thinkLen = 0;
39
- let textLen = 0;
40
- let writeBytes = 0;
41
- let toolNames = [];
42
- let writePaths = [];
43
-
44
- for (const b of blocks) {
45
- if (b.type === 'thinking') {
46
- thinkLen += b.thinking.length;
47
- } else if (b.type === 'text') {
48
- textLen += b.text.length;
49
- } else if (b.type === 'tool_use') {
50
- toolNames.push(b.name);
51
- if (b.name === 'Write' && b.input?.content) {
52
- writeBytes += b.input.content.length;
53
- writePaths.push(b.input.file_path?.split(/[/\\]/).pop() || '?');
54
- } else if (b.name === 'Edit' && b.input?.new_string) {
55
- writeBytes += b.input.new_string.length;
56
- writePaths.push(b.input.file_path?.split(/[/\\]/).pop() || '?');
57
- }
58
- }
59
- }
60
-
61
- const totalKB = (thinkLen + textLen + writeBytes) / 1024;
62
- if (totalKB >= minKB) {
63
- heavyTurns.push({
64
- line: idx + 1,
65
- ts: obj.timestamp,
66
- thinkKB: (thinkLen / 1024).toFixed(1),
67
- textKB: (textLen / 1024).toFixed(1),
68
- writeKB: (writeBytes / 1024).toFixed(1),
69
- totalKB: totalKB.toFixed(1),
70
- toolNames,
71
- writePaths,
72
- });
73
- }
74
- } catch (e) { /* skip */ }
75
- });
76
-
77
- heavyTurns.sort((a, b) => parseFloat(b.totalKB) - parseFloat(a.totalKB));
78
- const shown = heavyTurns.slice(0, topN);
79
-
80
- const totalOutput = heavyTurns.reduce((sum, t) => sum + parseFloat(t.totalKB), 0);
81
-
82
- console.log(`=== HEAVY OUTPUT ANALYSIS ===`);
83
- console.log(`File: ${filePath}`);
84
- console.log(`Turns with output >= ${minKB}KB: ${heavyTurns.length}`);
85
- console.log(`Total heavy output: ${totalOutput.toFixed(1)}KB`);
86
- console.log('');
87
-
88
- console.log('=== TOP HEAVY TURNS ===\n');
89
- console.log('Line'.padEnd(8) + 'Time'.padEnd(10) + 'Think'.padEnd(9) + 'Text'.padEnd(8) + 'Write'.padEnd(9) + 'Total'.padEnd(9) + 'Details');
90
- console.log('-'.repeat(90));
91
-
92
- shown.forEach(t => {
93
- const time = t.ts ? new Date(t.ts).toISOString().substring(11, 19) : '??:??:??';
94
- let details = '';
95
- if (parseFloat(t.thinkKB) > 0 && t.toolNames.length === 0) {
96
- details = '[pure thinking]';
97
- } else if (t.writePaths.length > 0) {
98
- details = t.writePaths.join(', ');
99
- } else if (t.toolNames.length > 0) {
100
- details = t.toolNames.join(', ');
101
- }
102
-
103
- console.log(
104
- `L${t.line}`.padEnd(8) +
105
- time.padEnd(10) +
106
- `${t.thinkKB}KB`.padEnd(9) +
107
- `${t.textKB}KB`.padEnd(8) +
108
- `${t.writeKB}KB`.padEnd(9) +
109
- `${t.totalKB}KB`.padEnd(9) +
110
- details.substring(0, 40)
111
- );
112
- });
113
-
114
- // Category breakdown
115
- console.log('\n=== OUTPUT CATEGORY BREAKDOWN ===');
116
- const totalThink = heavyTurns.reduce((s, t) => s + parseFloat(t.thinkKB), 0);
117
- const totalText = heavyTurns.reduce((s, t) => s + parseFloat(t.textKB), 0);
118
- const totalWrite = heavyTurns.reduce((s, t) => s + parseFloat(t.writeKB), 0);
119
- console.log(` Thinking: ${totalThink.toFixed(1)}KB (${(totalThink / totalOutput * 100).toFixed(0)}%)`);
120
- console.log(` Text: ${totalText.toFixed(1)}KB (${(totalText / totalOutput * 100).toFixed(0)}%)`);
121
- console.log(` File writes: ${totalWrite.toFixed(1)}KB (${(totalWrite / totalOutput * 100).toFixed(0)}%)`);
@@ -1,102 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * resolve-session.mjs — Resolve a project name + session ID to the actual file path
4
- *
5
- * Searches across all three session stores (Claude Code, Claude Internal, CodeBuddy).
6
- *
7
- * Usage:
8
- * node resolve-session.mjs <project-keyword> <session-uuid>
9
- * node resolve-session.mjs tencent-test10 55f43f72-d61e-4847-8133-be9d600d9816
10
- * node resolve-session.mjs <project-keyword> (list all sessions for matching project)
11
- *
12
- * Output: full path to session.jsonl + subagents directory
13
- */
14
-
15
- import { readdirSync, existsSync, statSync } from 'fs';
16
- import { join } from 'path';
17
- import { homedir } from 'os';
18
-
19
- const keyword = process.argv[2];
20
- const sessionId = process.argv[3];
21
-
22
- if (!keyword) {
23
- console.error('Usage: node resolve-session.mjs <project-keyword> [session-uuid]');
24
- process.exit(1);
25
- }
26
-
27
- const home = homedir();
28
- const stores = [
29
- { name: 'Claude Code', path: join(home, '.claude', 'projects') },
30
- { name: 'CodeBuddy', path: join(home, '.codebuddy', 'projects') },
31
- ];
32
-
33
- const matches = [];
34
-
35
- for (const store of stores) {
36
- if (!existsSync(store.path)) continue;
37
- const projects = readdirSync(store.path);
38
- const matching = projects.filter(p => p.toLowerCase().includes(keyword.toLowerCase()));
39
-
40
- for (const proj of matching) {
41
- const projPath = join(store.path, proj);
42
- const stat = statSync(projPath);
43
- if (!stat.isDirectory()) continue;
44
-
45
- if (sessionId) {
46
- // Look for specific session
47
- const sessionFile = join(projPath, `${sessionId}.jsonl`);
48
- if (existsSync(sessionFile)) {
49
- const subagentsDir = join(projPath, sessionId, 'subagents');
50
- const hasSubagents = existsSync(subagentsDir);
51
- matches.push({ store: store.name, project: proj, sessionFile, subagentsDir: hasSubagents ? subagentsDir : null });
52
- }
53
- } else {
54
- // List all sessions in project
55
- const files = readdirSync(projPath).filter(f => f.endsWith('.jsonl'));
56
- for (const f of files) {
57
- const fullPath = join(projPath, f);
58
- const size = statSync(fullPath).size;
59
- const sid = f.replace('.jsonl', '');
60
- const subDir = join(projPath, sid, 'subagents');
61
- const subCount = existsSync(subDir) ? readdirSync(subDir).filter(s => s.endsWith('.jsonl')).length : 0;
62
- matches.push({ store: store.name, project: proj, file: f, path: fullPath, sizeKB: (size / 1024).toFixed(0), subagents: subCount });
63
- }
64
- }
65
- }
66
- }
67
-
68
- if (matches.length === 0) {
69
- console.log(`No matches found for keyword "${keyword}"${sessionId ? ` / session "${sessionId}"` : ''}`);
70
- process.exit(1);
71
- }
72
-
73
- if (sessionId) {
74
- console.log('=== SESSION RESOLVED ===');
75
- matches.forEach(m => {
76
- console.log(`Store: ${m.store}`);
77
- console.log(`Project: ${m.project}`);
78
- console.log(`Session JSONL: ${m.sessionFile}`);
79
- if (m.subagentsDir) {
80
- console.log(`Subagents dir: ${m.subagentsDir}`);
81
- const subFiles = readdirSync(m.subagentsDir).filter(f => f.endsWith('.jsonl'));
82
- console.log(`Subagent count: ${subFiles.length}`);
83
- subFiles.forEach(f => console.log(` - ${f}`));
84
- } else {
85
- console.log('Subagents: none');
86
- }
87
- });
88
- } else {
89
- console.log(`=== SESSIONS IN "${keyword}" PROJECTS ===\n`);
90
- matches.sort((a, b) => parseInt(b.sizeKB) - parseInt(a.sizeKB));
91
- console.log('Store'.padEnd(18) + 'Size'.padEnd(10) + 'Subs'.padEnd(6) + 'Session');
92
- console.log('-'.repeat(80));
93
- matches.forEach(m => {
94
- console.log(
95
- m.store.padEnd(18) +
96
- `${m.sizeKB}KB`.padEnd(10) +
97
- String(m.subagents).padEnd(6) +
98
- m.file.replace('.jsonl', '')
99
- );
100
- });
101
- console.log(`\nTotal: ${matches.length} sessions`);
102
- }
@@ -1,127 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * subagent-stats.mjs — Extract execution stats for all Agent calls in a session/turn
4
- *
5
- * Usage:
6
- * node subagent-stats.mjs <session.jsonl>
7
- * node subagent-stats.mjs <session.jsonl> <startLine> <endLine>
8
- *
9
- * Output: for each Agent tool_result, prints agentId, type, duration, tokens, tool counts
10
- */
11
-
12
- import { readFileSync } from 'fs';
13
-
14
- const sessionPath = process.argv[2];
15
- const startLine = process.argv[3] ? parseInt(process.argv[3], 10) : 1;
16
- const endLine = process.argv[4] ? parseInt(process.argv[4], 10) : Infinity;
17
-
18
- if (!sessionPath) {
19
- console.error('Usage: node subagent-stats.mjs <session.jsonl> [startLine] [endLine]');
20
- process.exit(1);
21
- }
22
-
23
- const lines = readFileSync(sessionPath, 'utf8').trim().split('\n');
24
- const end = Math.min(endLine, lines.length);
25
-
26
- // Phase 1: Find all Agent tool_use calls
27
- const agentCalls = [];
28
- for (let i = startLine - 1; i < end; i++) {
29
- try {
30
- const obj = JSON.parse(lines[i]);
31
- if (obj.type === 'assistant') {
32
- const blocks = obj.message?.content || [];
33
- for (const b of blocks) {
34
- if (b.type === 'tool_use' && b.name === 'Agent') {
35
- agentCalls.push({
36
- line: i + 1,
37
- ts: obj.timestamp,
38
- toolUseId: b.id,
39
- description: b.input?.description || '',
40
- prompt: (b.input?.prompt || '').substring(0, 80),
41
- subagentType: b.input?.subagent_type || 'general-purpose',
42
- });
43
- }
44
- }
45
- }
46
- } catch (e) { /* skip */ }
47
- }
48
-
49
- // Phase 2: Find corresponding tool_results
50
- for (const call of agentCalls) {
51
- for (let i = call.line; i < end; i++) {
52
- try {
53
- const obj = JSON.parse(lines[i]);
54
- if (obj.type === 'user' && obj.toolUseResult?.agentId) {
55
- // Check if this result matches our call
56
- const content = obj.message?.content;
57
- if (Array.isArray(content) && content[0]?.tool_use_id === call.toolUseId) {
58
- const r = obj.toolUseResult;
59
- call.result = {
60
- line: i + 1,
61
- ts: obj.timestamp,
62
- agentId: r.agentId,
63
- agentType: r.agentType || call.subagentType,
64
- status: r.status,
65
- totalDurationMs: r.totalDurationMs,
66
- totalTokens: r.totalTokens,
67
- totalToolUseCount: r.totalToolUseCount,
68
- toolStats: r.toolStats,
69
- };
70
- break;
71
- }
72
- }
73
- } catch (e) { /* skip */ }
74
- }
75
- }
76
-
77
- // Output
78
- console.log(`=== SUBAGENT STATS (Lines ${startLine}-${end}) ===`);
79
- console.log(`Found ${agentCalls.length} Agent calls\n`);
80
-
81
- agentCalls.forEach((call, idx) => {
82
- console.log(`--- Agent #${idx + 1}: ${call.description} ---`);
83
- console.log(` Type: ${call.subagentType}`);
84
- console.log(` Called at: L${call.line} | ${call.ts}`);
85
- console.log(` Prompt: ${call.prompt}...`);
86
-
87
- if (call.result) {
88
- const r = call.result;
89
- const durationMin = (r.totalDurationMs / 1000 / 60).toFixed(1);
90
- const durationSec = (r.totalDurationMs / 1000).toFixed(1);
91
- console.log(` Returned at: L${r.line} | ${r.ts}`);
92
- console.log(` Agent ID: ${r.agentId}`);
93
- console.log(` Status: ${r.status}`);
94
- console.log(` Duration: ${durationSec}s (${durationMin} min)`);
95
- console.log(` Tokens: ${r.totalTokens}`);
96
- console.log(` Tool calls: ${r.totalToolUseCount}`);
97
- if (r.toolStats) {
98
- const s = r.toolStats;
99
- console.log(` Tool breakdown: Read=${s.readCount || 0} | Search=${s.searchCount || 0} | Bash=${s.bashCount || 0} | Edit=${s.editFileCount || 0} | Other=${s.otherToolCount || 0}`);
100
- console.log(` Lines: +${s.linesAdded || 0} / -${s.linesRemoved || 0}`);
101
- }
102
- } else {
103
- console.log(` [NO RESULT FOUND - may be outside line range or still running]`);
104
- }
105
- console.log('');
106
- });
107
-
108
- // Summary table
109
- if (agentCalls.length > 1) {
110
- console.log('=== SUMMARY TABLE ===');
111
- console.log('Agent'.padEnd(40) + 'Duration'.padEnd(12) + 'Tokens'.padEnd(10) + 'Tools'.padEnd(8) + 'Lines+');
112
- console.log('-'.repeat(78));
113
- agentCalls.forEach(call => {
114
- if (call.result) {
115
- const r = call.result;
116
- const dur = (r.totalDurationMs / 1000).toFixed(0) + 's';
117
- const lines = r.toolStats ? `+${r.toolStats.linesAdded || 0}` : '-';
118
- console.log(
119
- call.description.substring(0, 38).padEnd(40) +
120
- dur.padEnd(12) +
121
- String(r.totalTokens || 0).padEnd(10) +
122
- String(r.totalToolUseCount || 0).padEnd(8) +
123
- lines
124
- );
125
- }
126
- });
127
- }
@@ -1,106 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * subagent-tool-timeline.mjs — Parse a subagent's JSONL to show all tool calls in sequence
4
- *
5
- * Usage:
6
- * node subagent-tool-timeline.mjs <subagent.jsonl>
7
- * node subagent-tool-timeline.mjs <subagent.jsonl> --compact
8
- *
9
- * Output: numbered tool call list with timestamps and input previews
10
- */
11
-
12
- import { readFileSync } from 'fs';
13
-
14
- const filePath = process.argv[2];
15
- const compact = process.argv.includes('--compact');
16
-
17
- if (!filePath) {
18
- console.error('Usage: node subagent-tool-timeline.mjs <subagent.jsonl> [--compact]');
19
- process.exit(1);
20
- }
21
-
22
- const lines = readFileSync(filePath, 'utf8').trim().split('\n');
23
- const toolCalls = [];
24
- let startTs = null;
25
- let endTs = null;
26
-
27
- lines.forEach((line, idx) => {
28
- try {
29
- const obj = JSON.parse(line);
30
- const ts = obj.timestamp;
31
- if (ts) {
32
- if (!startTs) startTs = ts;
33
- endTs = ts;
34
- }
35
-
36
- if (obj.type === 'assistant') {
37
- const blocks = obj.message?.content || [];
38
- for (const b of blocks) {
39
- if (b.type === 'tool_use') {
40
- const inputStr = JSON.stringify(b.input || {});
41
- toolCalls.push({
42
- line: idx + 1,
43
- ts,
44
- name: b.name,
45
- id: b.id,
46
- inputPreview: compact ? inputStr.substring(0, 60) : inputStr.substring(0, 150),
47
- // For Write/Edit, capture file path
48
- filePath: b.input?.file_path || '',
49
- // For Bash, capture command
50
- command: b.input?.command?.substring(0, 80) || '',
51
- });
52
- }
53
- }
54
- }
55
- } catch (e) { /* skip */ }
56
- });
57
-
58
- const totalDuration = startTs && endTs
59
- ? ((new Date(endTs).getTime() - new Date(startTs).getTime()) / 1000).toFixed(1)
60
- : '?';
61
-
62
- console.log(`=== SUBAGENT TOOL TIMELINE ===`);
63
- console.log(`File: ${filePath}`);
64
- console.log(`Duration: ${totalDuration}s | Tool calls: ${toolCalls.length}`);
65
- console.log('');
66
-
67
- // Group by phase (consecutive same-type operations)
68
- toolCalls.forEach((tc, i) => {
69
- const time = tc.ts ? new Date(tc.ts).toISOString().substring(11, 19) : '??:??:??';
70
- const num = String(i + 1).padStart(3, ' ');
71
-
72
- if (compact) {
73
- // Compact: one line per call
74
- let detail = '';
75
- if (tc.name === 'Write' || tc.name === 'Edit' || tc.name === 'Read') {
76
- const fname = tc.filePath.split(/[/\\]/).pop();
77
- detail = fname;
78
- } else if (tc.name === 'Bash') {
79
- detail = tc.command.substring(0, 50);
80
- } else {
81
- detail = tc.inputPreview.substring(0, 50);
82
- }
83
- console.log(`${num}. ${time} ${tc.name.padEnd(6)} ${detail}`);
84
- } else {
85
- // Full: name + input preview
86
- console.log(`${num}. [L${tc.line}] ${time} ${tc.name}`);
87
- if (tc.name === 'Write' || tc.name === 'Edit' || tc.name === 'Read') {
88
- console.log(` file: ${tc.filePath}`);
89
- } else if (tc.name === 'Bash') {
90
- console.log(` cmd: ${tc.command}`);
91
- } else if (tc.name === 'Grep' || tc.name === 'Glob') {
92
- console.log(` ${tc.inputPreview}`);
93
- } else {
94
- console.log(` ${tc.inputPreview}`);
95
- }
96
- }
97
- });
98
-
99
- // Tool count summary
100
- console.log('');
101
- console.log('=== TOOL COUNT SUMMARY ===');
102
- const counts = {};
103
- toolCalls.forEach(tc => { counts[tc.name] = (counts[tc.name] || 0) + 1; });
104
- Object.entries(counts).sort((a, b) => b[1] - a[1]).forEach(([name, count]) => {
105
- console.log(` ${name}: ${count}`);
106
- });
@@ -1,128 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * time-gaps.mjs — Find the largest time gaps in a session/subagent JSONL
4
- *
5
- * Identifies performance bottlenecks: long thinking pauses, slow tool executions,
6
- * and external command waits.
7
- *
8
- * Usage:
9
- * node time-gaps.mjs <file.jsonl>
10
- * node time-gaps.mjs <file.jsonl> --threshold 5 (gaps > 5s, default 10)
11
- * node time-gaps.mjs <file.jsonl> --top 20 (show top 20, default 10)
12
- *
13
- * Output: sorted list of time gaps with before/after context
14
- */
15
-
16
- import { readFileSync } from 'fs';
17
-
18
- const filePath = process.argv[2];
19
- const thresholdIdx = process.argv.indexOf('--threshold');
20
- const threshold = thresholdIdx >= 0 ? parseFloat(process.argv[thresholdIdx + 1]) * 1000 : 10000;
21
- const topIdx = process.argv.indexOf('--top');
22
- const topN = topIdx >= 0 ? parseInt(process.argv[topIdx + 1], 10) : 10;
23
-
24
- if (!filePath) {
25
- console.error('Usage: node time-gaps.mjs <file.jsonl> [--threshold <seconds>] [--top <N>]');
26
- process.exit(1);
27
- }
28
-
29
- const lines = readFileSync(filePath, 'utf8').trim().split('\n');
30
-
31
- // Collect all timestamped events with description
32
- const events = [];
33
- lines.forEach((line, idx) => {
34
- try {
35
- const obj = JSON.parse(line);
36
- if (!obj.timestamp) return;
37
- const ts = new Date(obj.timestamp).getTime();
38
- let desc = obj.type;
39
-
40
- if (obj.type === 'assistant') {
41
- const blocks = obj.message?.content || [];
42
- const tools = blocks.filter(b => b.type === 'tool_use').map(b => b.name);
43
- const hasThink = blocks.some(b => b.type === 'thinking');
44
- const hasText = blocks.some(b => b.type === 'text');
45
- const thinkSize = blocks.filter(b => b.type === 'thinking').reduce((sum, b) => sum + b.thinking.length, 0);
46
-
47
- if (tools.length) {
48
- desc = `TOOL[${tools.join(',')}]`;
49
- } else {
50
- desc = (hasThink ? `THINK(${(thinkSize / 1024).toFixed(1)}KB)` : '') + (hasText ? '+TEXT' : '');
51
- }
52
- } else if (obj.type === 'user') {
53
- const content = obj.message?.content;
54
- if (typeof content === 'string') {
55
- desc = `USER: ${content.substring(0, 40)}`;
56
- } else if (Array.isArray(content) && content[0]?.type === 'tool_result') {
57
- const toolName = ''; // We don't have it here, but we can infer from context
58
- const isErr = content[0].is_error;
59
- desc = `RESULT${isErr ? '(ERR)' : ''}`;
60
- }
61
- }
62
-
63
- events.push({ line: idx + 1, ts, desc });
64
- } catch (e) { /* skip */ }
65
- });
66
-
67
- if (events.length < 2) {
68
- console.log('Not enough timestamped events to analyze.');
69
- process.exit(0);
70
- }
71
-
72
- // Find gaps
73
- const gaps = [];
74
- for (let i = 1; i < events.length; i++) {
75
- const gap = events[i].ts - events[i - 1].ts;
76
- if (gap >= threshold) {
77
- gaps.push({
78
- from: events[i - 1],
79
- to: events[i],
80
- gapMs: gap,
81
- });
82
- }
83
- }
84
-
85
- gaps.sort((a, b) => b.gapMs - a.gapMs);
86
- const shown = gaps.slice(0, topN);
87
-
88
- const totalDuration = events[events.length - 1].ts - events[0].ts;
89
- const totalGapTime = gaps.reduce((sum, g) => sum + g.gapMs, 0);
90
-
91
- console.log(`=== TIME GAP ANALYSIS ===`);
92
- console.log(`File: ${filePath}`);
93
- console.log(`Total duration: ${(totalDuration / 1000).toFixed(1)}s`);
94
- console.log(`Gaps > ${(threshold / 1000).toFixed(0)}s: ${gaps.length} found`);
95
- console.log(`Total gap time: ${(totalGapTime / 1000).toFixed(1)}s (${(totalGapTime / totalDuration * 100).toFixed(1)}% of duration)`);
96
- console.log('');
97
-
98
- console.log(`=== TOP ${shown.length} GAPS (sorted by duration) ===\n`);
99
- shown.forEach((g, i) => {
100
- const dur = (g.gapMs / 1000).toFixed(1);
101
- const pct = (g.gapMs / totalDuration * 100).toFixed(1);
102
- console.log(`#${i + 1}: ${dur}s (${pct}% of total)`);
103
- console.log(` FROM: L${g.from.line} | ${g.from.desc}`);
104
- console.log(` TO: L${g.to.line} | ${g.to.desc}`);
105
-
106
- // Classify the gap
107
- let category = 'unknown';
108
- if (g.to.desc.startsWith('THINK')) category = 'LLM thinking (output generation)';
109
- else if (g.to.desc.startsWith('TOOL')) category = 'LLM deciding next tool call';
110
- else if (g.to.desc === 'RESULT' || g.to.desc === 'RESULT(ERR)') category = 'Tool execution (external command)';
111
- else if (g.from.desc.startsWith('TOOL[Bash]')) category = 'Bash command execution';
112
- console.log(` TYPE: ${category}`);
113
- console.log('');
114
- });
115
-
116
- // Summary by category
117
- console.log('=== GAP CATEGORY SUMMARY ===');
118
- const categories = {};
119
- gaps.forEach(g => {
120
- let cat = 'other';
121
- if (g.to.desc.startsWith('THINK')) cat = 'LLM thinking';
122
- else if (g.to.desc.startsWith('TOOL')) cat = 'LLM tool decision';
123
- else if (g.to.desc.includes('RESULT')) cat = 'Tool execution';
124
- categories[cat] = (categories[cat] || 0) + g.gapMs;
125
- });
126
- Object.entries(categories).sort((a, b) => b[1] - a[1]).forEach(([cat, ms]) => {
127
- console.log(` ${cat}: ${(ms / 1000).toFixed(1)}s (${(ms / totalDuration * 100).toFixed(1)}%)`);
128
- });
@@ -1,67 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * turn-timeline.mjs — Parse and display event timeline for a specific turn range
4
- *
5
- * Usage:
6
- * node turn-timeline.mjs <session.jsonl> <startLine> [endLine]
7
- *
8
- * Output: chronological event list with timestamps, types, and previews
9
- * If endLine is omitted, reads to end of file.
10
- */
11
-
12
- import { readFileSync } from 'fs';
13
-
14
- const sessionPath = process.argv[2];
15
- const startLine = parseInt(process.argv[3], 10);
16
- const endLine = process.argv[4] ? parseInt(process.argv[4], 10) : Infinity;
17
-
18
- if (!sessionPath || isNaN(startLine)) {
19
- console.error('Usage: node turn-timeline.mjs <session.jsonl> <startLine> [endLine]');
20
- process.exit(1);
21
- }
22
-
23
- const lines = readFileSync(sessionPath, 'utf8').trim().split('\n');
24
- const end = Math.min(endLine, lines.length);
25
-
26
- console.log(`=== TURN TIMELINE: Lines ${startLine}-${end} ===\n`);
27
-
28
- for (let i = startLine - 1; i < end; i++) {
29
- const lineNum = i + 1;
30
- try {
31
- const obj = JSON.parse(lines[i]);
32
- const ts = obj.timestamp ? new Date(obj.timestamp).toISOString().substring(11, 19) : ' ';
33
-
34
- if (obj.type === 'assistant') {
35
- const blocks = obj.message?.content || [];
36
- for (const b of blocks) {
37
- if (b.type === 'thinking') {
38
- const len = b.thinking.length;
39
- const sizeTag = len > 10000 ? ` [${(len / 1024).toFixed(1)}KB]` : '';
40
- console.log(`[${lineNum}] ${ts} THINK${sizeTag}: ${b.thinking.substring(0, 120)}`);
41
- } else if (b.type === 'text') {
42
- console.log(`[${lineNum}] ${ts} TEXT: ${b.text.substring(0, 150)}`);
43
- } else if (b.type === 'tool_use') {
44
- const inputPreview = JSON.stringify(b.input).substring(0, 100);
45
- console.log(`[${lineNum}] ${ts} TOOL: ${b.name} | ${inputPreview}`);
46
- }
47
- }
48
- } else if (obj.type === 'user') {
49
- const content = obj.message?.content;
50
- if (typeof content === 'string') {
51
- console.log(`[${lineNum}] ${ts} USER: ${content.substring(0, 150)}`);
52
- } else if (Array.isArray(content) && content[0]?.type === 'tool_result') {
53
- const isErr = content[0].is_error;
54
- const c = content[0].content;
55
- const preview = typeof c === 'string' ? c.substring(0, 100) : JSON.stringify(c).substring(0, 100);
56
- console.log(`[${lineNum}] ${ts} RESULT${isErr ? '(ERR)' : '(OK)'}: ${preview}`);
57
- } else if (obj.promptSource === 'system' || obj.origin?.kind === 'task-notification') {
58
- const text = Array.isArray(content) && content[0]?.text
59
- ? content[0].text.substring(0, 100)
60
- : typeof content === 'string' ? content.substring(0, 100) : '';
61
- console.log(`[${lineNum}] ${ts} NOTIFY: ${text}`);
62
- }
63
- } else if (obj.type === 'system') {
64
- console.log(`[${lineNum}] ${ts} SYSTEM: ${obj.subtype || ''}`);
65
- }
66
- } catch (e) { /* skip */ }
67
- }