@playcraft/cli 0.1.40-beta → 0.1.42

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