claude-code-session-manager 0.97.0 → 0.100.0

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 (430) hide show
  1. package/README.md +3 -3
  2. package/bin/cli.cjs +16 -4
  3. package/bin/node-floor.cjs +41 -0
  4. package/dist/assets/{DataModel-D93FoaOm.js → DataModel-HdR0AxFq.js} +1 -1
  5. package/dist/assets/{History-CXxxqNP1.js → History-Dr4Jr_5z.js} +2 -2
  6. package/dist/assets/{Hooks-CzeYFQjq.js → Hooks-NhrvH3JP.js} +3 -3
  7. package/dist/assets/{Library-D2zPkwOC.js → Library-Dv_EtIMr.js} +1 -1
  8. package/dist/assets/{MarkdownEditor-DbinP78A.js → MarkdownEditor-DTKDWV_n.js} +1 -1
  9. package/dist/assets/{McpServers-Bu_sVGLr.js → McpServers-M034G9B3.js} +2 -2
  10. package/dist/assets/{Memory-BgiI6LZ_.js → Memory-DzF1B4gx.js} +6 -6
  11. package/dist/assets/{Permissions-C1MMzZRm.js → Permissions-DrgbSGWl.js} +3 -3
  12. package/dist/assets/{Plugins-Dhu6wAZi.js → Plugins-Bd3ef35w.js} +2 -2
  13. package/dist/assets/{ProvenanceBadge-C3AcWKMG.js → ProvenanceBadge-DcBHT1Iy.js} +1 -1
  14. package/dist/assets/{SaveBar-plwYm0iO.js → SaveBar-rimJem-Y.js} +1 -1
  15. package/dist/assets/Scheduler-DjgFJl2w.js +16 -0
  16. package/dist/assets/{ScopeSwitcher-DFy0vv_o.js → ScopeSwitcher-CnAzTBrl.js} +1 -1
  17. package/dist/assets/Settings-Dc1F_sSg.js +3 -0
  18. package/dist/assets/{SkillReferenceGraph-DsI7hRPB.js → SkillReferenceGraph-B9aZDecM.js} +1 -1
  19. package/dist/assets/{Skills-3E748UfB.js → Skills-DRXd18gu.js} +2 -2
  20. package/dist/assets/{SystemPrompt-BqmfUJOd.js → SystemPrompt-ahy5-Fwe.js} +1 -1
  21. package/dist/assets/{TagLibrary-CPz6fO8Q.js → TagLibrary-C_tToDeL.js} +1 -1
  22. package/dist/assets/{TiptapBody-D9EoBQ1P.js → TiptapBody-DvdefS6K.js} +1 -1
  23. package/dist/assets/{Toggle-BHAmZNDn.js → Toggle-6Jl5Njc6.js} +1 -1
  24. package/dist/assets/{index-CKH5Uxik.css → index-Bta-hwud.css} +1 -1
  25. package/dist/assets/{index-tn5JIVPj.js → index-vx8O73l8.js} +497 -502
  26. package/dist/assets/{settingsSchema-Crqy_aNz.js → settingsSchema-D6iRguNV.js} +1 -1
  27. package/dist/index.html +2 -2
  28. package/package.json +26 -29
  29. package/plugins/CLAUDE.md +6 -6
  30. package/plugins/session-manager-dev/skills/builder/4-manual/SKILL.md +23 -19
  31. package/plugins/session-manager-dev/skills/builder/SKILL.md +3 -3
  32. package/plugins/session-manager-dev/skills/develop/SKILL.md +254 -510
  33. package/plugins/session-manager-dev/skills/develop/standards.md +17 -22
  34. package/scripts/README.md +3 -11
  35. package/scripts/audit-ops-hygiene.cjs +3 -3
  36. package/scripts/hooks/lib/guard-prd-writes-policy.cjs +1 -1
  37. package/scripts/hooks/lib/guard-self-schedule-policy.cjs +1 -1
  38. package/scripts/mint-epic.cjs +2 -3
  39. package/scripts/scheduler-mcp-server.cjs +36 -7
  40. package/src/main/agentLibrary.cjs +22 -2
  41. package/src/main/build-info.json +4 -4
  42. package/src/main/config.cjs +41 -38
  43. package/src/main/docEdit.cjs +4 -1
  44. package/src/main/files.cjs +2 -5
  45. package/src/main/health.cjs +1 -1
  46. package/src/main/index.cjs +23 -10
  47. package/src/main/ipcSchemas.cjs +28 -35
  48. package/src/main/lib/agentPersonaSchema.cjs +13 -2
  49. package/src/main/lib/atomicFs.cjs +116 -0
  50. package/src/main/lib/branchSweep.cjs +13 -12
  51. package/src/main/lib/buildTarget.cjs +3 -3
  52. package/src/main/lib/claudeCliCaps.cjs +129 -0
  53. package/src/main/lib/credentials.cjs +2 -4
  54. package/src/main/lib/crossProjectFeedback.cjs +3 -3
  55. package/src/main/lib/cwdClassify.cjs +15 -3
  56. package/src/main/lib/definitionOfDone.cjs +207 -125
  57. package/src/main/lib/dodDrainHook.cjs +11 -5
  58. package/src/main/lib/epicMint.cjs +2 -4
  59. package/src/main/lib/epicStatusMirror.cjs +8 -10
  60. package/src/main/lib/epicWorktreeProjectConfig.cjs +2 -4
  61. package/src/main/lib/gateAuthority.cjs +96 -0
  62. package/src/main/lib/gitExec.cjs +69 -0
  63. package/src/main/lib/gitWorktree.cjs +656 -92
  64. package/src/main/lib/instanceLock.cjs +5 -8
  65. package/src/main/lib/launchFailure.cjs +2 -3
  66. package/src/main/lib/macroLibrary.cjs +386 -0
  67. package/src/main/lib/mcpToolCatalog.cjs +26 -17
  68. package/src/main/lib/needsReviewLedger.cjs +1 -1
  69. package/src/main/lib/opsErrorLog.cjs +11 -1
  70. package/src/main/lib/opsOwnership.cjs +0 -5
  71. package/src/main/lib/pidAlive.cjs +32 -0
  72. package/src/main/lib/prdCreate.cjs +153 -19
  73. package/src/main/lib/prdDisposition.cjs +2 -2
  74. package/src/main/lib/prdGateFiles.cjs +284 -0
  75. package/src/main/lib/prdLocations.cjs +61 -0
  76. package/src/main/lib/prdMigration.cjs +2 -3
  77. package/src/main/lib/prdSizing.cjs +2 -1
  78. package/src/main/lib/promptSessionSchema.cjs +10 -2
  79. package/src/main/lib/rcaReport.cjs +4 -6
  80. package/src/main/lib/reaperHelpers.cjs +8 -1
  81. package/src/main/lib/reservationExpiry.cjs +6 -1
  82. package/src/main/lib/reviewNotice.cjs +263 -0
  83. package/src/main/lib/runClaudeP.cjs +4 -1
  84. package/src/main/lib/schedulerPaths.cjs +22 -2
  85. package/src/main/lib/sessionSlots.cjs +2 -4
  86. package/src/main/lib/shippedPersonaSeeds.cjs +179 -0
  87. package/src/main/lib/timeoutShim.cjs +123 -0
  88. package/src/main/lib/timeoutShimScript.cjs +275 -0
  89. package/src/main/lib/upgradeDrain.cjs +4 -10
  90. package/src/main/lib/watchdogHelpers.cjs +33 -30
  91. package/src/main/lib/workTypeLibrary.cjs +7 -1
  92. package/src/main/promptSessionEvents.cjs +37 -13
  93. package/src/main/queueOps.cjs +17 -6
  94. package/src/main/scheduler.cjs +975 -203
  95. package/src/main/seedAgentPersonas.cjs +278 -23
  96. package/src/main/supervisor.cjs +4 -1
  97. package/src/main/templates/PRD_AUTHORING.md +126 -406
  98. package/src/preload/__tests__/preload-surface.test.cjs +68 -0
  99. package/src/preload/api.d.ts +41 -94
  100. package/src/preload/index.cjs +14 -9
  101. package/src/seed/agents/architect.md +1 -0
  102. package/src/seed/agents/dev-lead.md +17 -18
  103. package/src/seed/agents/project-home-builder.md +1 -0
  104. package/src/seed/agents/validator.md +10 -4
  105. package/dist/assets/HostBilko-nESrTRIg.js +0 -1
  106. package/dist/assets/Scheduler-BVYTeh39.js +0 -16
  107. package/dist/assets/Settings-DIhGgdfs.js +0 -3
  108. package/src/main/__tests__/activeIndexMerge.test.cjs +0 -235
  109. package/src/main/__tests__/agentEffortResolve.test.cjs +0 -117
  110. package/src/main/__tests__/agentLibrary.test.cjs +0 -276
  111. package/src/main/__tests__/agentModelResolve.test.cjs +0 -311
  112. package/src/main/__tests__/agentOverlayWrite.test.cjs +0 -95
  113. package/src/main/__tests__/bilkoHost-deriveSlug.test.cjs +0 -26
  114. package/src/main/__tests__/bilkoHost-integration.test.cjs +0 -118
  115. package/src/main/__tests__/bilkoHostCore.test.cjs +0 -72
  116. package/src/main/__tests__/broadcastCoalescer.test.cjs +0 -122
  117. package/src/main/__tests__/chat-cancel-terminal.test.cjs +0 -120
  118. package/src/main/__tests__/chat-dead-channels.test.cjs +0 -63
  119. package/src/main/__tests__/chat-exit-close-race.test.cjs +0 -146
  120. package/src/main/__tests__/chat-mcp-consent-notice.test.cjs +0 -139
  121. package/src/main/__tests__/chat-preamble-anchors.test.cjs +0 -100
  122. package/src/main/__tests__/chat-queue.test.cjs +0 -97
  123. package/src/main/__tests__/chat-stop-signal.test.cjs +0 -89
  124. package/src/main/__tests__/chatRunner-epic-worktree-execcwd.test.cjs +0 -125
  125. package/src/main/__tests__/chatRunner-session-flag-retry.test.cjs +0 -252
  126. package/src/main/__tests__/classifyPromptTicket.test.cjs +0 -101
  127. package/src/main/__tests__/classifyTranscriptLine.test.cjs +0 -201
  128. package/src/main/__tests__/computeDepHistorySatisfaction.test.cjs +0 -66
  129. package/src/main/__tests__/config-readText-bounded.test.cjs +0 -84
  130. package/src/main/__tests__/configWriteBoundaryOwners.test.cjs +0 -59
  131. package/src/main/__tests__/crossProjectFeedback.test.cjs +0 -334
  132. package/src/main/__tests__/crossProjectFeedbackRoutes.test.cjs +0 -161
  133. package/src/main/__tests__/dep-orphan-archive-health.test.cjs +0 -77
  134. package/src/main/__tests__/develop-skill-failure-modes.test.cjs +0 -70
  135. package/src/main/__tests__/docEdit.test.cjs +0 -244
  136. package/src/main/__tests__/dod-batchkey.test.cjs +0 -183
  137. package/src/main/__tests__/dod-drain-hook.test.cjs +0 -302
  138. package/src/main/__tests__/dod-report.test.cjs +0 -304
  139. package/src/main/__tests__/dod-reverify.test.cjs +0 -285
  140. package/src/main/__tests__/epicContextDigest.test.cjs +0 -174
  141. package/src/main/__tests__/epicMint.test.cjs +0 -332
  142. package/src/main/__tests__/epicMintTelemetryTap.test.cjs +0 -64
  143. package/src/main/__tests__/epicStatusMirror.test.cjs +0 -110
  144. package/src/main/__tests__/epicValidationHook.test.cjs +0 -291
  145. package/src/main/__tests__/exchanges.test.cjs +0 -122
  146. package/src/main/__tests__/exchangesPromptId.test.cjs +0 -61
  147. package/src/main/__tests__/extractJson.test.cjs +0 -51
  148. package/src/main/__tests__/files-reject-credentials.test.cjs +0 -40
  149. package/src/main/__tests__/fixtures/1218-fo-01-move-scripts-lib-into-src-main-lib.log +0 -556
  150. package/src/main/__tests__/flatPrdTickSweep.test.cjs +0 -110
  151. package/src/main/__tests__/health-build-freshness.test.cjs +0 -39
  152. package/src/main/__tests__/health-claude-md-budget.test.cjs +0 -57
  153. package/src/main/__tests__/health-credentials.test.cjs +0 -81
  154. package/src/main/__tests__/health-delegation-chain.test.cjs +0 -124
  155. package/src/main/__tests__/health-per-project-stall.test.cjs +0 -84
  156. package/src/main/__tests__/health-prd-migration.test.cjs +0 -37
  157. package/src/main/__tests__/health-queue-dispatch.test.cjs +0 -135
  158. package/src/main/__tests__/health-starve-escalation.test.cjs +0 -94
  159. package/src/main/__tests__/health-tick-liveness.test.cjs +0 -179
  160. package/src/main/__tests__/health-usage-poller.test.cjs +0 -144
  161. package/src/main/__tests__/health-worktree-cap-blocked.test.cjs +0 -65
  162. package/src/main/__tests__/heapSnapshot.test.cjs +0 -121
  163. package/src/main/__tests__/historyAggregatorIntraday.test.cjs +0 -313
  164. package/src/main/__tests__/historyDashboard.test.cjs +0 -163
  165. package/src/main/__tests__/historyRollup.test.cjs +0 -333
  166. package/src/main/__tests__/intradayRefresh.test.cjs +0 -39
  167. package/src/main/__tests__/ipcSchemas-dependsOn.test.cjs +0 -39
  168. package/src/main/__tests__/kg-augment.test.cjs +0 -195
  169. package/src/main/__tests__/loadGateDetailTick.test.cjs +0 -31
  170. package/src/main/__tests__/machineProfile.test.cjs +0 -152
  171. package/src/main/__tests__/mcpStatus.test.cjs +0 -61
  172. package/src/main/__tests__/memoryAggregate.test.cjs +0 -109
  173. package/src/main/__tests__/memoryStale.test.cjs +0 -88
  174. package/src/main/__tests__/needsReviewLedger.test.cjs +0 -162
  175. package/src/main/__tests__/openExternalApp-spawn-error.test.cjs +0 -25
  176. package/src/main/__tests__/opsErrorLog.test.cjs +0 -109
  177. package/src/main/__tests__/opsErrorLogTelemetryTap.test.cjs +0 -173
  178. package/src/main/__tests__/personaMerge.test.cjs +0 -169
  179. package/src/main/__tests__/planValidator.test.cjs +0 -125
  180. package/src/main/__tests__/pollLoop-dispatch-on-failure.test.cjs +0 -176
  181. package/src/main/__tests__/prd-group-allocator.test.cjs +0 -119
  182. package/src/main/__tests__/prdAdminRouteParity.test.cjs +0 -70
  183. package/src/main/__tests__/prdAdminRoutes.test.cjs +0 -718
  184. package/src/main/__tests__/prdAgentType.test.cjs +0 -103
  185. package/src/main/__tests__/prdAuthoringSeed.test.cjs +0 -39
  186. package/src/main/__tests__/prdCreate.test.cjs +0 -979
  187. package/src/main/__tests__/prdCreateDisposition.test.cjs +0 -201
  188. package/src/main/__tests__/prdCreatePlanId.test.cjs +0 -132
  189. package/src/main/__tests__/prdFrontmatterAgentType.test.cjs +0 -117
  190. package/src/main/__tests__/prdFrontmatterDependsOn.test.cjs +0 -136
  191. package/src/main/__tests__/prdFrontmatterDisposition.test.cjs +0 -125
  192. package/src/main/__tests__/prdFrontmatterQuietMachine.test.cjs +0 -108
  193. package/src/main/__tests__/prdLocations.test.cjs +0 -195
  194. package/src/main/__tests__/prdLocationsArchived.test.cjs +0 -201
  195. package/src/main/__tests__/prdMigration.test.cjs +0 -349
  196. package/src/main/__tests__/prdMigrationLegacyAdopt.test.cjs +0 -91
  197. package/src/main/__tests__/prdParserHighWater.test.cjs +0 -74
  198. package/src/main/__tests__/prdParserSourcePromptId.test.cjs +0 -65
  199. package/src/main/__tests__/prdSetDisposition.test.cjs +0 -222
  200. package/src/main/__tests__/prdSizing.test.cjs +0 -106
  201. package/src/main/__tests__/prdSourcePromptIdBackfill.test.cjs +0 -118
  202. package/src/main/__tests__/prdUpdateDependsOn.test.cjs +0 -160
  203. package/src/main/__tests__/proc-role-env.test.cjs +0 -125
  204. package/src/main/__tests__/procname-claude-spawn-sites.test.cjs +0 -304
  205. package/src/main/__tests__/procname-sm-processes.test.cjs +0 -127
  206. package/src/main/__tests__/projectHomeAdminRoutes.test.cjs +0 -177
  207. package/src/main/__tests__/projectPages.test.cjs +0 -137
  208. package/src/main/__tests__/promptSessionEvents.test.cjs +0 -234
  209. package/src/main/__tests__/promptSessionSchema.test.cjs +0 -101
  210. package/src/main/__tests__/promptSessionTranscript.test.cjs +0 -0
  211. package/src/main/__tests__/promptSessionsCreateEpicHandler.test.cjs +0 -159
  212. package/src/main/__tests__/pty-epic-worktree-spawn-cwd.test.cjs +0 -282
  213. package/src/main/__tests__/pty-session-open-telemetry.test.cjs +0 -96
  214. package/src/main/__tests__/pty-write-result.test.cjs +0 -46
  215. package/src/main/__tests__/queue-health-verdict.test.cjs +0 -170
  216. package/src/main/__tests__/queue-starvation-dispatch-driver.test.cjs +0 -286
  217. package/src/main/__tests__/queue-starvation-per-project.test.cjs +0 -147
  218. package/src/main/__tests__/queueHistory.test.cjs +0 -355
  219. package/src/main/__tests__/queueOps-interactive-ac-lint.test.cjs +0 -65
  220. package/src/main/__tests__/queueOpsArchiveDestination.test.cjs +0 -65
  221. package/src/main/__tests__/queueOpsAutoArchive.test.cjs +0 -154
  222. package/src/main/__tests__/rateLimitPollerStreak.test.cjs +0 -128
  223. package/src/main/__tests__/rcaReport.test.cjs +0 -266
  224. package/src/main/__tests__/reconcileFlatPrdSweep.test.cjs +0 -119
  225. package/src/main/__tests__/reconcileTiming.test.cjs +0 -135
  226. package/src/main/__tests__/runLogRetention.test.cjs +0 -489
  227. package/src/main/__tests__/runVerify-atomic-verdicts.test.cjs +0 -26
  228. package/src/main/__tests__/runVerify-blocked-by-foreign-wip.test.cjs +0 -58
  229. package/src/main/__tests__/runVerify-landed-commit-outranks.test.cjs +0 -191
  230. package/src/main/__tests__/runVerify-policy-denial.test.cjs +0 -89
  231. package/src/main/__tests__/runVerify-transcript-commit-evidence.test.cjs +0 -225
  232. package/src/main/__tests__/runVerify.test.cjs +0 -1784
  233. package/src/main/__tests__/scheduleJobSchema.test.cjs +0 -127
  234. package/src/main/__tests__/scheduleJobStatusDrift.test.cjs +0 -65
  235. package/src/main/__tests__/scheduleJobTransitions.test.cjs +0 -277
  236. package/src/main/__tests__/scheduleJobTransitionsGrep.test.cjs +0 -59
  237. package/src/main/__tests__/scheduleJobTransitionsTelemetryTap.test.cjs +0 -72
  238. package/src/main/__tests__/scheduler-admin-routes.test.cjs +0 -199
  239. package/src/main/__tests__/scheduler-adopted-run-supervision.test.cjs +0 -143
  240. package/src/main/__tests__/scheduler-already-satisfied-on-main.test.cjs +0 -105
  241. package/src/main/__tests__/scheduler-archive-completed-prd.test.cjs +0 -102
  242. package/src/main/__tests__/scheduler-archived-twin-guard.test.cjs +0 -155
  243. package/src/main/__tests__/scheduler-autofix-outcome.test.cjs +0 -188
  244. package/src/main/__tests__/scheduler-autofix-select.test.cjs +0 -439
  245. package/src/main/__tests__/scheduler-autopromote.test.cjs +0 -51
  246. package/src/main/__tests__/scheduler-bash-timeout-env.test.cjs +0 -101
  247. package/src/main/__tests__/scheduler-blocked-by-foreign-wip.test.cjs +0 -107
  248. package/src/main/__tests__/scheduler-boot-orphans.test.cjs +0 -153
  249. package/src/main/__tests__/scheduler-broadcast-reconcile.test.cjs +0 -121
  250. package/src/main/__tests__/scheduler-clear-queue-history.test.cjs +0 -134
  251. package/src/main/__tests__/scheduler-commit-guard-noop.test.cjs +0 -244
  252. package/src/main/__tests__/scheduler-committed-in-window.test.cjs +0 -182
  253. package/src/main/__tests__/scheduler-cross-project-batch.test.cjs +0 -43
  254. package/src/main/__tests__/scheduler-default-eligible-heal.test.cjs +0 -168
  255. package/src/main/__tests__/scheduler-dispatch-loop.test.cjs +0 -58
  256. package/src/main/__tests__/scheduler-effective-concurrency.test.cjs +0 -81
  257. package/src/main/__tests__/scheduler-epic-digest.test.cjs +0 -227
  258. package/src/main/__tests__/scheduler-failed-autoreset.test.cjs +0 -121
  259. package/src/main/__tests__/scheduler-finalize-dispatch-guards.test.cjs +0 -229
  260. package/src/main/__tests__/scheduler-find-prd-dir.test.cjs +0 -75
  261. package/src/main/__tests__/scheduler-fix-plan-path.test.cjs +0 -119
  262. package/src/main/__tests__/scheduler-force-tick-outcome.test.cjs +0 -46
  263. package/src/main/__tests__/scheduler-foreign-wip-manifest.test.cjs +0 -78
  264. package/src/main/__tests__/scheduler-gate-shadow.test.cjs +0 -119
  265. package/src/main/__tests__/scheduler-guard-verdict-autoresolve.test.cjs +0 -390
  266. package/src/main/__tests__/scheduler-heal-refusal.test.cjs +0 -61
  267. package/src/main/__tests__/scheduler-heartbeat-payload.test.cjs +0 -80
  268. package/src/main/__tests__/scheduler-inplace-salvage.test.cjs +0 -323
  269. package/src/main/__tests__/scheduler-integration-failure-stamp.test.cjs +0 -41
  270. package/src/main/__tests__/scheduler-investigation-clean-skip.test.cjs +0 -63
  271. package/src/main/__tests__/scheduler-investigation-prompt.test.cjs +0 -123
  272. package/src/main/__tests__/scheduler-job-budget.test.cjs +0 -172
  273. package/src/main/__tests__/scheduler-job-overrun.test.cjs +0 -175
  274. package/src/main/__tests__/scheduler-launch-failure.test.cjs +0 -199
  275. package/src/main/__tests__/scheduler-leftover-fields.test.cjs +0 -52
  276. package/src/main/__tests__/scheduler-leftover-quarantine.test.cjs +0 -199
  277. package/src/main/__tests__/scheduler-looks-done.test.cjs +0 -537
  278. package/src/main/__tests__/scheduler-manual-pause.test.cjs +0 -118
  279. package/src/main/__tests__/scheduler-mechanical-recovery.test.cjs +0 -245
  280. package/src/main/__tests__/scheduler-meta-code-sha.test.cjs +0 -46
  281. package/src/main/__tests__/scheduler-needs-review-autoresolve.test.cjs +0 -197
  282. package/src/main/__tests__/scheduler-never-stop.test.cjs +0 -157
  283. package/src/main/__tests__/scheduler-no-dead-end-status.test.cjs +0 -152
  284. package/src/main/__tests__/scheduler-no-orphan-run-dir.test.cjs +0 -81
  285. package/src/main/__tests__/scheduler-notify-originating-tab-transcript.test.cjs +0 -87
  286. package/src/main/__tests__/scheduler-notify-originating-tab.test.cjs +0 -343
  287. package/src/main/__tests__/scheduler-periodic-reverify-guard.test.cjs +0 -217
  288. package/src/main/__tests__/scheduler-porcelain-rename.test.cjs +0 -164
  289. package/src/main/__tests__/scheduler-prd-missing-skip.test.cjs +0 -161
  290. package/src/main/__tests__/scheduler-prd-persona-spawn.test.cjs +0 -178
  291. package/src/main/__tests__/scheduler-quarantine-autoresolve.test.cjs +0 -165
  292. package/src/main/__tests__/scheduler-quiet-machine-lease.test.cjs +0 -257
  293. package/src/main/__tests__/scheduler-rate-limit-cooldown-freshness.test.cjs +0 -123
  294. package/src/main/__tests__/scheduler-rate-limit-pause.test.cjs +0 -152
  295. package/src/main/__tests__/scheduler-rate-limit-spin-guard.test.cjs +0 -156
  296. package/src/main/__tests__/scheduler-reap-dead-running-jobs.test.cjs +0 -754
  297. package/src/main/__tests__/scheduler-reaper-helpers-basics.test.cjs +0 -87
  298. package/src/main/__tests__/scheduler-reconcile-cwd-preserve.test.cjs +0 -100
  299. package/src/main/__tests__/scheduler-reconcile-history-backfill.test.cjs +0 -105
  300. package/src/main/__tests__/scheduler-reconcile-invalid-repair.test.cjs +0 -203
  301. package/src/main/__tests__/scheduler-reconcile-quarantine.test.cjs +0 -247
  302. package/src/main/__tests__/scheduler-reset-job-fields-guard.test.cjs +0 -77
  303. package/src/main/__tests__/scheduler-resume-recovery.test.cjs +0 -254
  304. package/src/main/__tests__/scheduler-shard-quarantine.test.cjs +0 -115
  305. package/src/main/__tests__/scheduler-shared-tree-guard.test.cjs +0 -380
  306. package/src/main/__tests__/scheduler-sigterm-commit.test.cjs +0 -43
  307. package/src/main/__tests__/scheduler-stall-per-project.test.cjs +0 -126
  308. package/src/main/__tests__/scheduler-starve-escalation.test.cjs +0 -154
  309. package/src/main/__tests__/scheduler-stranded-autofix-park.test.cjs +0 -252
  310. package/src/main/__tests__/scheduler-stranded-investigation.test.cjs +0 -185
  311. package/src/main/__tests__/scheduler-stuck-failed-escalation.test.cjs +0 -136
  312. package/src/main/__tests__/scheduler-supervisor-record.test.cjs +0 -81
  313. package/src/main/__tests__/scheduler-tick-cancel-token.test.cjs +0 -54
  314. package/src/main/__tests__/scheduler-tick-wedge.test.cjs +0 -172
  315. package/src/main/__tests__/scheduler-transient-failure.test.cjs +0 -141
  316. package/src/main/__tests__/scheduler-unreadable-queue-guard.test.cjs +0 -62
  317. package/src/main/__tests__/scheduler-utilization-hold.test.cjs +0 -89
  318. package/src/main/__tests__/scheduler-verify-prd-path.test.cjs +0 -109
  319. package/src/main/__tests__/scheduler-worktree-cap-defer.test.cjs +0 -234
  320. package/src/main/__tests__/scheduler-worktree-exec-cwd.test.cjs +0 -120
  321. package/src/main/__tests__/scheduler-writeprd-epic-rollback.test.cjs +0 -105
  322. package/src/main/__tests__/schedulerBatchRootBlocker.test.cjs +0 -117
  323. package/src/main/__tests__/schedulerStateSidecarRestore.test.cjs +0 -110
  324. package/src/main/__tests__/seedAgentPersonas.test.cjs +0 -184
  325. package/src/main/__tests__/seedSchedulerMcp.test.cjs +0 -211
  326. package/src/main/__tests__/seedStatus.test.cjs +0 -100
  327. package/src/main/__tests__/seedValidatorPersona.test.cjs +0 -116
  328. package/src/main/__tests__/stop-signal-anchor.test.cjs +0 -75
  329. package/src/main/__tests__/telemetryClient.test.cjs +0 -1055
  330. package/src/main/__tests__/telemetryContract.test.cjs +0 -930
  331. package/src/main/__tests__/telemetrySettings.test.cjs +0 -210
  332. package/src/main/__tests__/transcripts-batch-flush.test.cjs +0 -249
  333. package/src/main/__tests__/transcripts-doFlush-array.test.cjs +0 -124
  334. package/src/main/__tests__/transcripts-paged-reads.test.cjs +0 -241
  335. package/src/main/__tests__/transcripts-worktree-epic-path.test.cjs +0 -154
  336. package/src/main/__tests__/transcriptsUsageFor.test.cjs +0 -206
  337. package/src/main/__tests__/uniquePrdNumbers.test.cjs +0 -153
  338. package/src/main/__tests__/usageSingleFlight.test.cjs +0 -169
  339. package/src/main/__tests__/validationSentinels.test.cjs +0 -84
  340. package/src/main/__tests__/workTypeLibrary.test.cjs +0 -89
  341. package/src/main/bilkoHost.cjs +0 -314
  342. package/src/main/bilkoHostCore.cjs +0 -89
  343. package/src/main/lib/__tests__/active-sessions.test.cjs +0 -251
  344. package/src/main/lib/__tests__/activeIndexRebuild.test.cjs +0 -179
  345. package/src/main/lib/__tests__/agentPersonaSchema.test.cjs +0 -67
  346. package/src/main/lib/__tests__/auditLog.test.cjs +0 -38
  347. package/src/main/lib/__tests__/bootSelfHeal.test.cjs +0 -107
  348. package/src/main/lib/__tests__/branchSweep.test.cjs +0 -164
  349. package/src/main/lib/__tests__/buildIdentity.test.cjs +0 -121
  350. package/src/main/lib/__tests__/buildTarget.test.cjs +0 -52
  351. package/src/main/lib/__tests__/childWithLog.test.cjs +0 -321
  352. package/src/main/lib/__tests__/coldBootPromptSessionsWrite.test.cjs +0 -87
  353. package/src/main/lib/__tests__/crashTelemetry.test.cjs +0 -103
  354. package/src/main/lib/__tests__/credentials-futile-refresh.test.cjs +0 -115
  355. package/src/main/lib/__tests__/cwdClassify.test.cjs +0 -111
  356. package/src/main/lib/__tests__/definitionOfDoneSequence.test.cjs +0 -95
  357. package/src/main/lib/__tests__/delegationReadiness.test.cjs +0 -1175
  358. package/src/main/lib/__tests__/dispatchLoop.test.cjs +0 -63
  359. package/src/main/lib/__tests__/effectiveModelInfo.test.cjs +0 -244
  360. package/src/main/lib/__tests__/ephemeralCwd.test.cjs +0 -91
  361. package/src/main/lib/__tests__/epicDelegationStats.test.cjs +0 -137
  362. package/src/main/lib/__tests__/epicSpawnCwd.test.cjs +0 -283
  363. package/src/main/lib/__tests__/epicSpawnPlan.test.cjs +0 -196
  364. package/src/main/lib/__tests__/epicTranscriptPath.test.cjs +0 -163
  365. package/src/main/lib/__tests__/epicWorktreeBoot.test.cjs +0 -136
  366. package/src/main/lib/__tests__/epicWorktreeMerge.test.cjs +0 -130
  367. package/src/main/lib/__tests__/epicWorktreeMint.test.cjs +0 -117
  368. package/src/main/lib/__tests__/epicWorktreeProjectConfig.test.cjs +0 -137
  369. package/src/main/lib/__tests__/fixChainDepth.test.cjs +0 -40
  370. package/src/main/lib/__tests__/fixtures/204-mercury-steam-horse.log.txt +0 -13
  371. package/src/main/lib/__tests__/fixtures/scheduler-machine.json.corrupt-1789147548 +0 -34
  372. package/src/main/lib/__tests__/gateFixtures.json +0 -20
  373. package/src/main/lib/__tests__/gitCacheBound.test.cjs +0 -69
  374. package/src/main/lib/__tests__/gitWorktree.test.cjs +0 -1478
  375. package/src/main/lib/__tests__/gitWorktreeSalvage.test.cjs +0 -107
  376. package/src/main/lib/__tests__/gitWorktreeSalvageDelta.test.cjs +0 -153
  377. package/src/main/lib/__tests__/guardShims.test.cjs +0 -158
  378. package/src/main/lib/__tests__/importReferences.spec.cjs +0 -56
  379. package/src/main/lib/__tests__/instanceLock.test.cjs +0 -173
  380. package/src/main/lib/__tests__/jobSupervisorRecord.test.cjs +0 -78
  381. package/src/main/lib/__tests__/jobWorktree.test.cjs +0 -199
  382. package/src/main/lib/__tests__/jobWorktreeBootLive.test.cjs +0 -82
  383. package/src/main/lib/__tests__/landedSinceRun.test.cjs +0 -133
  384. package/src/main/lib/__tests__/launchFailure.test.cjs +0 -220
  385. package/src/main/lib/__tests__/loadGate.test.cjs +0 -303
  386. package/src/main/lib/__tests__/localAdminHttp.test.cjs +0 -214
  387. package/src/main/lib/__tests__/loopDelay.test.cjs +0 -68
  388. package/src/main/lib/__tests__/mcpToolCatalog.test.cjs +0 -107
  389. package/src/main/lib/__tests__/modelCatalog.test.cjs +0 -202
  390. package/src/main/lib/__tests__/opsOwnership.test.cjs +0 -113
  391. package/src/main/lib/__tests__/opsRootAbsoluteCwd.test.cjs +0 -328
  392. package/src/main/lib/__tests__/opsRootNestedWrite.test.cjs +0 -51
  393. package/src/main/lib/__tests__/opsRootResolve.test.cjs +0 -149
  394. package/src/main/lib/__tests__/prdDeclaredPaths.test.cjs +0 -82
  395. package/src/main/lib/__tests__/prdDisposition.test.cjs +0 -224
  396. package/src/main/lib/__tests__/procIdentity.test.cjs +0 -119
  397. package/src/main/lib/__tests__/procName.test.cjs +0 -92
  398. package/src/main/lib/__tests__/projectBriefCore.test.cjs +0 -216
  399. package/src/main/lib/__tests__/projectRootResolve.test.cjs +0 -148
  400. package/src/main/lib/__tests__/queueHealth.test.cjs +0 -58
  401. package/src/main/lib/__tests__/queueStoreAtomicWrite.test.cjs +0 -88
  402. package/src/main/lib/__tests__/queueStoreMachineStateRecovery.test.cjs +0 -190
  403. package/src/main/lib/__tests__/quietMachineLease.test.cjs +0 -39
  404. package/src/main/lib/__tests__/rateLimitWindow.test.cjs +0 -88
  405. package/src/main/lib/__tests__/reaperHelpers.test.cjs +0 -577
  406. package/src/main/lib/__tests__/schedulerBatchDepends.test.cjs +0 -312
  407. package/src/main/lib/__tests__/schedulerBatchFairness.test.cjs +0 -213
  408. package/src/main/lib/__tests__/schedulerBatchLaunchHold.test.cjs +0 -125
  409. package/src/main/lib/__tests__/schedulerBatchProjectCap.test.cjs +0 -127
  410. package/src/main/lib/__tests__/schedulerBatchQuietMachine.test.cjs +0 -109
  411. package/src/main/lib/__tests__/schedulerMcpServerHeadlessRefusal.test.cjs +0 -71
  412. package/src/main/lib/__tests__/schedulerMcpServerHelp.test.cjs +0 -216
  413. package/src/main/lib/__tests__/schedulerMcpServerProjectHome.test.cjs +0 -183
  414. package/src/main/lib/__tests__/schedulerPaths.test.cjs +0 -226
  415. package/src/main/lib/__tests__/schedulerPathsWorktree.test.cjs +0 -133
  416. package/src/main/lib/__tests__/schedulerRuntimeState.test.cjs +0 -56
  417. package/src/main/lib/__tests__/sessionSlots.test.cjs +0 -144
  418. package/src/main/lib/__tests__/telemetryBacklog.test.cjs +0 -626
  419. package/src/main/lib/__tests__/telemetryBoot.test.cjs +0 -134
  420. package/src/main/lib/__tests__/telemetryConsent.test.cjs +0 -136
  421. package/src/main/lib/__tests__/telemetryCounters.test.cjs +0 -57
  422. package/src/main/lib/__tests__/telemetryCountersMetadataColumn.test.cjs +0 -98
  423. package/src/main/lib/__tests__/terminalRunOutcome.test.cjs +0 -200
  424. package/src/main/lib/__tests__/toolUseClassify.test.cjs +0 -53
  425. package/src/main/lib/__tests__/updateCheck.test.cjs +0 -63
  426. package/src/main/lib/__tests__/upgradeDrain.test.cjs +0 -130
  427. package/src/main/lib/__tests__/usageCircuit.test.cjs +0 -354
  428. package/src/main/lib/__tests__/watchdog-helpers.test.cjs +0 -375
  429. package/src/main/lib/__tests__/watchdog-relaunch.test.cjs +0 -266
  430. package/src/main/lib/kgExchangePairing.cjs +0 -75
@@ -1,241 +0,0 @@
1
- /**
2
- * transcripts-paged-reads.test.cjs — unit tests for the line-offset index +
3
- * paged-read API that replaced transcripts.cjs's 500-entry ring buffer
4
- * (PRD 979). Covers:
5
- * - scrolling to the top of a >500-event session returns the genuine first
6
- * event via readPage/pageEvents, not a truncated window
7
- * - paging is a bounded positional read, never a whole-file materialization
8
- * - bounded memory: indexing a huge number of lines (plus one multi-MB
9
- * line) keeps the persisted index far smaller than the raw content
10
- * - inode-change rotation and truncation invalidate and rebuild the index
11
- * - a partial trailing line is never indexed until it completes
12
- * - a malformed JSON line still occupies its index slot (line numbering
13
- * stays correct)
14
- * - release()/re-subscribe fast-resume preserves the index, not just offset
15
- * - paging never re-emits to OTEL (only the live doFlush ingest path does)
16
- *
17
- * Run: timeout 120 npx vitest run src/main/__tests__/transcripts-paged-reads.test.cjs
18
- */
19
-
20
- 'use strict';
21
-
22
- import { test, expect, beforeEach, afterEach, vi } from 'vitest';
23
-
24
- const fs = require('node:fs');
25
- const os = require('node:os');
26
- const path = require('node:path');
27
-
28
- const { subscribe, release, closeTab, transcriptPath, pageEvents } = require('../transcripts.cjs');
29
- const otel = require('../otel.cjs');
30
-
31
- let cwd;
32
-
33
- beforeEach(() => {
34
- cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'sm-paged-test-'));
35
- });
36
-
37
- afterEach(() => {
38
- fs.rmSync(cwd, { recursive: true, force: true });
39
- // writeTranscript mkdir -p's this run's folder under the REAL
40
- // ~/.claude/projects (that's where transcriptPath resolves to), so leaving
41
- // it behind accumulates one phantom project directory per test run. Thousands
42
- // had piled up before this cleanup existed, and Home counted every one as a
43
- // project. Remove it with the tmp cwd it mirrors.
44
- fs.rmSync(path.dirname(transcriptPath(cwd, 'x')), { recursive: true, force: true });
45
- });
46
-
47
- function writeTranscript(cwdArg, sessionId, lines) {
48
- const filePath = transcriptPath(cwdArg, sessionId);
49
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
50
- fs.writeFileSync(filePath, lines.map((l) => JSON.stringify(l)).join('\n') + '\n');
51
- return filePath;
52
- }
53
-
54
- test('paging to line 0 of a >500-event session returns the genuine first event', async () => {
55
- const sessionId = 'sess-page-top';
56
- const tabId = 'tab-page-top';
57
- const lines = Array.from({ length: 800 }, (_, i) => ({
58
- type: 'user',
59
- message: { content: [{ type: 'text', text: `event number ${i}` }] },
60
- }));
61
- writeTranscript(cwd, sessionId, lines);
62
-
63
- const res = await subscribe({ tabId, cwd, sessionUuid: sessionId });
64
- expect(res.ok).toBe(true);
65
-
66
- const top = await pageEvents(tabId, 0, 0);
67
- expect(top.totalLines).toBe(800);
68
- expect(top.events).toHaveLength(1);
69
- expect(top.events[0].data).toBe('event number 0');
70
- expect(top.events[0].lineNumber).toBe(0);
71
-
72
- const bottom = await pageEvents(tabId, 799, 799);
73
- expect(bottom.events[0].data).toBe('event number 799');
74
-
75
- closeTab(tabId);
76
- });
77
-
78
- test('bounded memory: indexing many lines plus one multi-MB line keeps the index far smaller than the raw content', async () => {
79
- const sessionId = 'sess-bounded';
80
- const tabId = 'tab-bounded';
81
- const NUM_LINES = 20000;
82
- const bigLineIndex = 10000;
83
- const bigText = 'x'.repeat(5 * 1024 * 1024); // 5MB single line
84
- const lines = Array.from({ length: NUM_LINES }, (_, i) => {
85
- if (i === bigLineIndex) {
86
- return { type: 'user', message: { content: [{ type: 'text', text: bigText }] } };
87
- }
88
- return { type: 'user', message: { content: [{ type: 'text', text: `line ${i}` }] } };
89
- });
90
- writeTranscript(cwd, sessionId, lines);
91
-
92
- const res = await subscribe({ tabId, cwd, sessionUuid: sessionId });
93
- expect(res.ok).toBe(true);
94
-
95
- const sub = require('../transcripts.cjs').__getSubForTest?.(tabId);
96
- // Fall back to reading the module's internal state via pageEvents' totalLines
97
- // if the internal accessor isn't exported; either way, assert the ceiling on
98
- // what actually persists: the index itself, not the file content.
99
- const { totalLines } = await pageEvents(tabId, 0, 0);
100
- expect(totalLines).toBe(NUM_LINES);
101
-
102
- // Each index entry is two small integers (byteOffset, byteLength). Even a
103
- // generous 64 bytes/entry ceiling for NUM_LINES entries is three orders of
104
- // magnitude below the 5MB+ raw content of the one huge line — proving the
105
- // index never holds the line's actual text.
106
- const CEILING_BYTES = NUM_LINES * 64;
107
- expect(CEILING_BYTES).toBeLessThan(bigText.length);
108
- if (sub) {
109
- const approxIndexBytes = sub.lineIndex.length * 16; // 2 numbers/entry
110
- expect(approxIndexBytes).toBeLessThan(CEILING_BYTES);
111
- // The big line's text must not appear anywhere in the index entries.
112
- for (const entry of sub.lineIndex) {
113
- expect(Object.keys(entry).sort()).toEqual(['byteLength', 'byteOffset']);
114
- }
115
- }
116
-
117
- closeTab(tabId);
118
- });
119
-
120
- test('inode-change rotation invalidates and rebuilds the index — no stale offsets served', async () => {
121
- const sessionId = 'sess-rotate';
122
- const tabId = 'tab-rotate';
123
- const filePath = writeTranscript(cwd, sessionId, [
124
- { type: 'user', message: { content: [{ type: 'text', text: 'old-a' }] } },
125
- { type: 'user', message: { content: [{ type: 'text', text: 'old-b' }] } },
126
- ]);
127
-
128
- const res = await subscribe({ tabId, cwd, sessionUuid: sessionId });
129
- expect(res.ok).toBe(true);
130
- let page = await pageEvents(tabId, 0, 1);
131
- expect(page.totalLines).toBe(2);
132
-
133
- // Simulate log rotation: unlink + recreate (new inode) with different content.
134
- fs.unlinkSync(filePath);
135
- fs.writeFileSync(filePath, [{ type: 'user', message: { content: [{ type: 'text', text: 'new-a' }] } }].map((l) => JSON.stringify(l)).join('\n') + '\n');
136
-
137
- // The chokidar watcher on the live sub picks up the rotation and rebuilds
138
- // the index via readDelta's inode-change reset — poll (bounded) rather
139
- // than assume a fixed debounce delay.
140
- // 30s ceiling, not 5s: the watcher event is starved under heavy CPU contention; the loop
141
- // exits the instant the condition holds so idle cost is unchanged.
142
- const deadline = Date.now() + 30000;
143
- while (Date.now() < deadline) {
144
- page = await pageEvents(tabId, 0, 0);
145
- if (page.totalLines === 1 && page.events[0]?.data === 'new-a') break;
146
- await new Promise((r) => setTimeout(r, 50));
147
- }
148
- expect(page.totalLines).toBe(1);
149
- expect(page.events[0].data).toBe('new-a');
150
- closeTab(tabId);
151
- }, 40000);
152
-
153
- test('a partial trailing line is not indexed until it completes', async () => {
154
- const sessionId = 'sess-partial';
155
- const tabId = 'tab-partial';
156
- const filePath = transcriptPath(cwd, sessionId);
157
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
158
- const complete = JSON.stringify({ type: 'user', message: { content: [{ type: 'text', text: 'first' }] } });
159
- // No trailing newline — this line is "still being written".
160
- fs.writeFileSync(filePath, complete + '\n' + '{"type":"user","message":{"content":[{"type":"text","text":"unfinishe');
161
-
162
- const res = await subscribe({ tabId, cwd, sessionUuid: sessionId });
163
- expect(res.ok).toBe(true);
164
- let page = await pageEvents(tabId, 0, 10);
165
- expect(page.totalLines).toBe(1);
166
- expect(page.events[0].data).toBe('first');
167
-
168
- closeTab(tabId);
169
- });
170
-
171
- test('a malformed JSON line still occupies its index slot — line numbering stays correct', async () => {
172
- const sessionId = 'sess-malformed';
173
- const tabId = 'tab-malformed';
174
- const filePath = transcriptPath(cwd, sessionId);
175
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
176
- const body = [
177
- JSON.stringify({ type: 'user', message: { content: [{ type: 'text', text: 'ok-0' }] } }),
178
- 'not valid json {{{',
179
- JSON.stringify({ type: 'user', message: { content: [{ type: 'text', text: 'ok-2' }] } }),
180
- ].join('\n') + '\n';
181
- fs.writeFileSync(filePath, body);
182
-
183
- const res = await subscribe({ tabId, cwd, sessionUuid: sessionId });
184
- expect(res.ok).toBe(true);
185
- const page = await pageEvents(tabId, 0, 2);
186
- expect(page.totalLines).toBe(3);
187
- // Malformed line 1 produces no event, but line 2's numbering is unaffected.
188
- expect(page.events.map((e) => e.lineNumber)).toEqual([0, 2]);
189
- expect(page.events[1].data).toBe('ok-2');
190
-
191
- closeTab(tabId);
192
- });
193
-
194
- test('release()/re-subscribe fast-resume preserves the index rather than re-reading from byte 0', async () => {
195
- const sessionId = 'sess-resume';
196
- const tabId = 'tab-resume';
197
- writeTranscript(cwd, sessionId, [
198
- { type: 'user', message: { content: [{ type: 'text', text: 'a' }] } },
199
- { type: 'user', message: { content: [{ type: 'text', text: 'b' }] } },
200
- ]);
201
-
202
- const res = await subscribe({ tabId, cwd, sessionUuid: sessionId });
203
- expect(res.ok).toBe(true);
204
- const before = await pageEvents(tabId, 0, 1);
205
- expect(before.totalLines).toBe(2);
206
-
207
- release(tabId); // view-switch away — sub stays cached
208
- // Re-subscribing the same tab should promote it back from the LRU cache
209
- // rather than re-reading the transcript from scratch.
210
- const res2 = await subscribe({ tabId, cwd, sessionUuid: sessionId });
211
- expect(res2.ok).toBe(true);
212
- const after = await pageEvents(tabId, 0, 1);
213
- expect(after.totalLines).toBe(2);
214
- expect(after.events.map((e) => e.data)).toEqual(['a', 'b']);
215
-
216
- closeTab(tabId);
217
- });
218
-
219
- test('paging never re-emits to OTEL — only the live doFlush ingest path records', async () => {
220
- const sessionId = 'sess-otel';
221
- const tabId = 'tab-otel';
222
- writeTranscript(cwd, sessionId, [
223
- { type: 'user', message: { content: 'one' } },
224
- { type: 'user', message: { content: 'two' } },
225
- ]);
226
-
227
- const spy = vi.spyOn(otel, 'recordTranscriptEvent');
228
- const res = await subscribe({ tabId, cwd, sessionUuid: sessionId });
229
- expect(res.ok).toBe(true);
230
- const callsAfterSubscribe = spy.mock.calls.length;
231
- expect(callsAfterSubscribe).toBeGreaterThan(0); // initial drain recorded both events
232
-
233
- // Page over the same range repeatedly — must not add more OTEL calls.
234
- await pageEvents(tabId, 0, 1);
235
- await pageEvents(tabId, 0, 1);
236
- await pageEvents(tabId, 0, 0);
237
- expect(spy.mock.calls.length).toBe(callsAfterSubscribe);
238
-
239
- spy.mockRestore();
240
- closeTab(tabId);
241
- });
@@ -1,154 +0,0 @@
1
- /**
2
- * transcripts-worktree-epic-path.test.cjs — transcriptPath()/subscribe() resolve
3
- * an Epic's transcript through epicTranscriptPath (worktree encoding), while a
4
- * non-Epic tab keeps the plain project encoding. Includes a parity check of the
5
- * renderer's transcriptExists() (EpicTerminalPane's resume-vs-create decision)
6
- * against the REAL transcriptPath instead of a constant mock.
7
- *
8
- * Run: timeout 120 npx vitest run src/main/__tests__/transcripts-worktree-epic-path.test.cjs
9
- */
10
-
11
- 'use strict';
12
-
13
- import { test, expect, beforeAll, afterAll, beforeEach, afterEach, vi } from 'vitest';
14
- import { transcriptExists } from '../../renderer/lib/transcriptExists';
15
-
16
- const fs = require('node:fs');
17
- const os = require('node:os');
18
- const path = require('node:path');
19
-
20
- let tmpHome;
21
- let originalHome;
22
- let tr;
23
- let resolver;
24
- let encodeCwd;
25
- let proj;
26
- const SID = 'b8a5d6f4-0092-4db0-a687-009241f2a8b2';
27
- const WT = '/tmp/sm-wt-test-epic-worktree-dir';
28
-
29
- beforeAll(() => {
30
- originalHome = process.env.HOME;
31
- tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'sm-transcripts-wt-home-'));
32
- process.env.HOME = tmpHome;
33
- tr = require('../transcripts.cjs');
34
- resolver = require('../lib/epicTranscriptPath.cjs');
35
- ({ encodeCwd } = require('../lib/encodeCwd.cjs'));
36
- });
37
-
38
- afterAll(() => {
39
- process.env.HOME = originalHome;
40
- fs.rmSync(tmpHome, { recursive: true, force: true });
41
- });
42
-
43
- beforeEach(() => {
44
- resolver.__resetCacheForTests();
45
- proj = fs.mkdtempSync(path.join(os.tmpdir(), 'sm-transcripts-wt-proj-'));
46
- });
47
-
48
- afterEach(() => {
49
- fs.rmSync(proj, { recursive: true, force: true });
50
- fs.rmSync(path.join(tmpHome, '.claude'), { recursive: true, force: true });
51
- vi.unstubAllGlobals();
52
- });
53
-
54
- const projectsDir = () => path.join(tmpHome, '.claude', 'projects');
55
- const plain = (cwd, id = SID) => path.join(projectsDir(), encodeCwd(cwd), `${id}.jsonl`);
56
-
57
- function writeIndex(sessionId = SID) {
58
- const dir = path.join(proj, 'session-manager-operations', 'prompt-sessions');
59
- fs.mkdirSync(dir, { recursive: true });
60
- const s = { id: 'epic-1', cwd: proj, claudeSessionId: sessionId, status: 'active', worktree: { dir: WT, branch: 'sm-epic/epic-1', baseCwd: proj, status: 'active' } };
61
- fs.writeFileSync(path.join(dir, 'active-index.json'), JSON.stringify({ sessions: { 'epic-1': s }, events: {} }));
62
- }
63
-
64
- function writeTranscript(p, body = '{"type":"user"}\n') {
65
- fs.mkdirSync(path.dirname(p), { recursive: true });
66
- fs.writeFileSync(p, body);
67
- }
68
-
69
- test('worktree-present: transcript only under the worktree encoding resolves there', () => {
70
- writeIndex();
71
- fs.mkdirSync(WT, { recursive: true });
72
- try {
73
- writeTranscript(plain(WT));
74
- expect(tr.transcriptPath(proj, SID)).toBe(plain(WT));
75
- } finally {
76
- fs.rmSync(WT, { recursive: true, force: true });
77
- }
78
- });
79
-
80
- test('worktree-swept: worktree dir gone from disk, transcript still found', () => {
81
- writeIndex();
82
- expect(fs.existsSync(WT)).toBe(false);
83
- writeTranscript(plain(WT));
84
- expect(tr.transcriptPath(proj, SID)).toBe(plain(WT));
85
- });
86
-
87
- test('non-Epic tab resolves to exactly the pre-change path, even when an Epic exists', () => {
88
- writeIndex();
89
- writeTranscript(plain(WT));
90
- const rawTab = 'raw-tab-id-123';
91
- expect(tr.transcriptPath(proj, rawTab)).toBe(path.join(os.homedir(), '.claude', 'projects', encodeCwd(proj), `${rawTab}.jsonl`));
92
- // no index at all
93
- const other = fs.mkdtempSync(path.join(os.tmpdir(), 'sm-transcripts-wt-other-'));
94
- try {
95
- expect(tr.transcriptPath(other, SID)).toBe(plain(other));
96
- expect(path.isAbsolute(tr.transcriptPath(other, SID))).toBe(true);
97
- } finally {
98
- fs.rmSync(other, { recursive: true, force: true });
99
- }
100
- });
101
-
102
- test('zero-byte transcript counts as existing and does not break usageFor', async () => {
103
- writeIndex();
104
- writeTranscript(plain(WT), '');
105
- expect(tr.transcriptPath(proj, SID)).toBe(plain(WT));
106
- const out = await tr.usageFor(proj, [SID]);
107
- expect(out).toHaveProperty(SID);
108
- });
109
-
110
- test('subscribe does NOT mkdir when a transcript exists elsewhere (worktree encoding)', async () => {
111
- writeIndex();
112
- writeTranscript(plain(WT));
113
- const before = fs.readdirSync(projectsDir()).sort();
114
- const res = await tr.subscribe({ tabId: 'tab-wt', cwd: proj, sessionUuid: SID });
115
- try {
116
- expect(res.ok).toBe(true);
117
- expect(res.path).toBe(plain(WT));
118
- expect(fs.readdirSync(projectsDir()).sort()).toEqual(before);
119
- expect(fs.existsSync(path.dirname(plain(proj)))).toBe(false);
120
- } finally {
121
- tr.closeTab('tab-wt');
122
- }
123
- });
124
-
125
- test('subscribe of a brand-new Epic watches the spawn-cwd path and creates its dir', async () => {
126
- writeIndex();
127
- const res = await tr.subscribe({ tabId: 'tab-new', cwd: proj, sessionUuid: SID });
128
- try {
129
- expect(res.ok).toBe(true);
130
- // no transcript anywhere → resolver's first candidate (spawn cwd), whose dir the CLI will write
131
- expect(fs.existsSync(path.dirname(res.path))).toBe(true);
132
- expect(fs.existsSync(res.path)).toBe(false);
133
- } finally {
134
- tr.closeTab('tab-new');
135
- }
136
- });
137
-
138
- test('parity: renderer transcriptExists (Terminal resume decision) sees a worktree-only transcript', async () => {
139
- writeIndex();
140
- vi.stubGlobal('window', {
141
- api: {
142
- transcripts: { pathFor: async (c, s) => tr.transcriptPath(c, s) },
143
- config: { exists: async (p) => fs.existsSync(p) },
144
- },
145
- });
146
- expect(await transcriptExists(proj, SID)).toBe(false);
147
- writeTranscript(plain(WT));
148
- expect(await transcriptExists(proj, SID)).toBe(true);
149
- // zero-byte still "exists"
150
- writeTranscript(plain(WT), '');
151
- expect(await transcriptExists(proj, SID)).toBe(true);
152
- // raw tab never resolves into the Epic's worktree encoding
153
- expect(await transcriptExists(proj, 'raw-tab')).toBe(false);
154
- });
@@ -1,206 +0,0 @@
1
- /**
2
- * transcriptsUsageFor.test.cjs — unit tests for transcripts.cjs's usageFor(),
3
- * the batched token-usage reader backing the `transcript:usageFor` IPC (Epics
4
- * workspace tokens metric).
5
- *
6
- * Run: timeout 120 npx vitest run src/main/__tests__/transcriptsUsageFor.test.cjs
7
- */
8
-
9
- 'use strict';
10
-
11
- import { test, expect, beforeEach, afterEach, vi } from 'vitest';
12
-
13
- const fs = require('node:fs');
14
- const os = require('node:os');
15
- const path = require('node:path');
16
-
17
- const { usageFor, transcriptPath } = require('../transcripts.cjs');
18
-
19
- let cwd;
20
-
21
- beforeEach(() => {
22
- cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'sm-usage-test-'));
23
- });
24
-
25
- afterEach(() => {
26
- fs.rmSync(cwd, { recursive: true, force: true });
27
- // writeTranscript mkdir -p's this run's folder under the REAL
28
- // ~/.claude/projects (that's where transcriptPath resolves to), so leaving
29
- // it behind accumulates one phantom project directory per test run. Thousands
30
- // had piled up before this cleanup existed, and Home counted every one as a
31
- // project. Remove it with the tmp cwd it mirrors.
32
- fs.rmSync(path.dirname(transcriptPath(cwd, 'x')), { recursive: true, force: true });
33
- });
34
-
35
- function writeTranscript(cwdArg, sessionId, lines) {
36
- const filePath = transcriptPath(cwdArg, sessionId);
37
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
38
- fs.writeFileSync(filePath, lines.map((l) => JSON.stringify(l)).join('\n') + '\n');
39
- return filePath;
40
- }
41
-
42
- test('sums input/output tokens across usage events in a session transcript', async () => {
43
- const sessionId = 'sess-aaaa-1111';
44
- writeTranscript(cwd, sessionId, [
45
- { type: 'assistant', usage: { input_tokens: 100, output_tokens: 20 } },
46
- { type: 'assistant', usage: { input_tokens: 50, output_tokens: 10 } },
47
- { type: 'user', message: { content: 'no usage here' } },
48
- ]);
49
-
50
- const result = await usageFor(cwd, [sessionId]);
51
- expect(result[sessionId]).toEqual({ inputTokens: 150, outputTokens: 30 });
52
- });
53
-
54
- test('maps a session with no transcript file to null', async () => {
55
- const result = await usageFor(cwd, ['no-such-session']);
56
- expect(result['no-such-session']).toBeNull();
57
- });
58
-
59
- test('batches multiple sessions in one call', async () => {
60
- writeTranscript(cwd, 'sess-a', [{ usage: { input_tokens: 5, output_tokens: 1 } }]);
61
- writeTranscript(cwd, 'sess-b', [{ usage: { input_tokens: 7, output_tokens: 2 } }]);
62
-
63
- const result = await usageFor(cwd, ['sess-a', 'sess-b', 'sess-missing']);
64
- expect(result).toEqual({
65
- 'sess-a': { inputTokens: 5, outputTokens: 1 },
66
- 'sess-b': { inputTokens: 7, outputTokens: 2 },
67
- 'sess-missing': null,
68
- });
69
- });
70
-
71
- test('a repeat call against an unchanged file returns the same cached totals', async () => {
72
- const sessionId = 'sess-cache';
73
- writeTranscript(cwd, sessionId, [{ usage: { input_tokens: 10, output_tokens: 5 } }]);
74
-
75
- const first = await usageFor(cwd, [sessionId]);
76
- const second = await usageFor(cwd, [sessionId]);
77
- expect(second[sessionId]).toEqual(first[sessionId]);
78
- expect(second[sessionId]).toEqual({ inputTokens: 10, outputTokens: 5 });
79
- });
80
-
81
- test('a growing transcript is re-summed after the file mtime/size change', async () => {
82
- const sessionId = 'sess-grow';
83
- writeTranscript(cwd, sessionId, [{ usage: { input_tokens: 10, output_tokens: 5 } }]);
84
- const before = await usageFor(cwd, [sessionId]);
85
- expect(before[sessionId]).toEqual({ inputTokens: 10, outputTokens: 5 });
86
-
87
- // Force a distinct mtime — some filesystems have coarse mtime resolution.
88
- const filePath = transcriptPath(cwd, sessionId);
89
- const future = new Date(Date.now() + 5000);
90
- fs.appendFileSync(filePath, JSON.stringify({ usage: { input_tokens: 3, output_tokens: 1 } }) + '\n');
91
- fs.utimesSync(filePath, future, future);
92
-
93
- const after = await usageFor(cwd, [sessionId]);
94
- expect(after[sessionId]).toEqual({ inputTokens: 13, outputTokens: 6 });
95
- });
96
-
97
- // ── incremental tail parse + bounded cache ─────────────────────────────────
98
-
99
- const fsp = require('node:fs/promises');
100
- const transcripts = require('../transcripts.cjs');
101
-
102
- function fromScratch(filePath) {
103
- let inputTokens = 0;
104
- let outputTokens = 0;
105
- for (const line of fs.readFileSync(filePath, 'utf8').split('\n')) {
106
- if (!line) continue;
107
- let o;
108
- try { o = JSON.parse(line); } catch { continue; }
109
- const u = o.usage || {};
110
- inputTokens += u.input_tokens ?? 0;
111
- outputTokens += u.output_tokens ?? 0;
112
- }
113
- return { inputTokens, outputTokens };
114
- }
115
-
116
- test('incremental result equals a from-scratch parse across 5 appends (partial line + repeated id)', async () => {
117
- const sessionId = 'sess-incr';
118
- const filePath = writeTranscript(cwd, sessionId, [
119
- { id: 'm1', usage: { input_tokens: 10, output_tokens: 1 } },
120
- ]);
121
- const check = async () => {
122
- const r = await usageFor(cwd, [sessionId]);
123
- expect(r[sessionId]).toEqual(fromScratch(filePath));
124
- };
125
- await check();
126
- const l2 = JSON.stringify({ id: 'm2', usage: { input_tokens: 20, output_tokens: 2 } });
127
- // 1: append ending mid-line
128
- fs.appendFileSync(filePath, l2.slice(0, 15));
129
- await check();
130
- // 2: complete that line
131
- fs.appendFileSync(filePath, l2.slice(15) + '\n');
132
- await check();
133
- // 3: repeat an earlier message id (full parse sums it again)
134
- fs.appendFileSync(filePath, JSON.stringify({ id: 'm1', usage: { input_tokens: 10, output_tokens: 1 } }) + '\n');
135
- await check();
136
- // 4: non-usage + malformed line
137
- fs.appendFileSync(filePath, JSON.stringify({ type: 'user' }) + '\nnot json\n');
138
- await check();
139
- // 5: multibyte content then usage
140
- fs.appendFileSync(filePath, JSON.stringify({ t: 'héllo 日本', usage: { input_tokens: 4, output_tokens: 4 } }) + '\n');
141
- await check();
142
- expect((await usageFor(cwd, [sessionId]))[sessionId]).toEqual({ inputTokens: 44, outputTokens: 8 });
143
- });
144
-
145
- test('the call after a one-line append reads < 4 KB from disk', async () => {
146
- const sessionId = 'sess-bytes';
147
- const big = Array.from({ length: 2000 }, (_, i) => ({ i, pad: 'x'.repeat(100), usage: { input_tokens: 1, output_tokens: 1 } }));
148
- const filePath = writeTranscript(cwd, sessionId, big);
149
- await usageFor(cwd, [sessionId]);
150
- expect(fs.statSync(filePath).size).toBeGreaterThan(200_000);
151
-
152
- fs.appendFileSync(filePath, JSON.stringify({ usage: { input_tokens: 5, output_tokens: 5 } }) + '\n');
153
- const fh = await fsp.open(filePath, 'r');
154
- const proto = Object.getPrototypeOf(fh);
155
- await fh.close();
156
- const orig = proto.read;
157
- const lengths = [];
158
- const spy = vi.spyOn(proto, 'read').mockImplementation(function (buf, off, len, pos) {
159
- lengths.push(len);
160
- return orig.call(this, buf, off, len, pos);
161
- });
162
- try {
163
- const r = await usageFor(cwd, [sessionId]);
164
- expect(r[sessionId]).toEqual({ inputTokens: 2005, outputTokens: 2005 });
165
- } finally {
166
- spy.mockRestore();
167
- }
168
- expect(lengths.length).toBeGreaterThan(0);
169
- expect(lengths.reduce((a, b) => a + b, 0)).toBeLessThan(4096);
170
- });
171
-
172
- test('truncation / replacement triggers a full re-parse', async () => {
173
- const sessionId = 'sess-trunc';
174
- const filePath = writeTranscript(cwd, sessionId, [
175
- { usage: { input_tokens: 100, output_tokens: 100 } },
176
- { usage: { input_tokens: 100, output_tokens: 100 } },
177
- ]);
178
- await usageFor(cwd, [sessionId]);
179
- fs.writeFileSync(filePath, JSON.stringify({ usage: { input_tokens: 1, output_tokens: 2 } }) + '\n');
180
- expect((await usageFor(cwd, [sessionId]))[sessionId]).toEqual({ inputTokens: 1, outputTokens: 2 });
181
- });
182
-
183
- test('usageCache is bounded and evicts the least-recently-used entry', async () => {
184
- const cache = transcripts.__usageCacheForTest;
185
- const max = transcripts.__usageCacheMaxForTest;
186
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'sm-usage-lru-'));
187
- try {
188
- const files = [];
189
- for (let i = 0; i < max + 5; i++) {
190
- const f = path.join(dir, `s${i}.jsonl`);
191
- fs.writeFileSync(f, JSON.stringify({ usage: { input_tokens: 1, output_tokens: 1 } }) + '\n');
192
- files.push(f);
193
- }
194
- const before = cache.size;
195
- for (const f of files) {
196
- // usageForOne is reached through usageFor's path; call via a cwd-independent route.
197
- await transcripts.__usageForOneForTest(f);
198
- }
199
- expect(cache.size).toBeLessThanOrEqual(max);
200
- expect(before).toBeLessThanOrEqual(max);
201
- expect(cache.has(files[0])).toBe(false);
202
- expect(cache.has(files[files.length - 1])).toBe(true);
203
- } finally {
204
- fs.rmSync(dir, { recursive: true, force: true });
205
- }
206
- });