@playcraft/cli 0.1.38-beta → 0.1.39-prod

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