claude-code-session-manager 0.98.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 (431) 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-DCEgMTjH.js → DataModel-HdR0AxFq.js} +1 -1
  5. package/dist/assets/{History-Bfdoywlh.js → History-Dr4Jr_5z.js} +2 -2
  6. package/dist/assets/{Hooks-CKDJjTJV.js → Hooks-NhrvH3JP.js} +3 -3
  7. package/dist/assets/{Library-7akfgy67.js → Library-Dv_EtIMr.js} +1 -1
  8. package/dist/assets/{MarkdownEditor-DDesiqet.js → MarkdownEditor-DTKDWV_n.js} +1 -1
  9. package/dist/assets/{McpServers-D4lZtXof.js → McpServers-M034G9B3.js} +2 -2
  10. package/dist/assets/{Memory-CeI8G1w5.js → Memory-DzF1B4gx.js} +6 -6
  11. package/dist/assets/{Permissions-BGleLja4.js → Permissions-DrgbSGWl.js} +3 -3
  12. package/dist/assets/{Plugins-P4eCXy_S.js → Plugins-Bd3ef35w.js} +2 -2
  13. package/dist/assets/{ProvenanceBadge-BFczzI1B.js → ProvenanceBadge-DcBHT1Iy.js} +1 -1
  14. package/dist/assets/{SaveBar-l9jnEMES.js → SaveBar-rimJem-Y.js} +1 -1
  15. package/dist/assets/Scheduler-DjgFJl2w.js +16 -0
  16. package/dist/assets/{ScopeSwitcher-CjJi8ST5.js → ScopeSwitcher-CnAzTBrl.js} +1 -1
  17. package/dist/assets/Settings-Dc1F_sSg.js +3 -0
  18. package/dist/assets/{SkillReferenceGraph-CjbO01Sg.js → SkillReferenceGraph-B9aZDecM.js} +1 -1
  19. package/dist/assets/{Skills-BxZ9_fCR.js → Skills-DRXd18gu.js} +2 -2
  20. package/dist/assets/{SystemPrompt-D8vfFb8b.js → SystemPrompt-ahy5-Fwe.js} +1 -1
  21. package/dist/assets/{TagLibrary-2vzUo7YL.js → TagLibrary-C_tToDeL.js} +1 -1
  22. package/dist/assets/{TiptapBody-B8ZfbK90.js → TiptapBody-DvdefS6K.js} +1 -1
  23. package/dist/assets/{Toggle-BbW4nGGf.js → Toggle-6Jl5Njc6.js} +1 -1
  24. package/dist/assets/{index-CKH5Uxik.css → index-Bta-hwud.css} +1 -1
  25. package/dist/assets/{index-Cd98Q1lD.js → index-vx8O73l8.js} +497 -502
  26. package/dist/assets/{settingsSchema-IhUfucCF.js → settingsSchema-D6iRguNV.js} +1 -1
  27. package/dist/index.html +2 -2
  28. package/package.json +25 -29
  29. package/plugins/CLAUDE.md +6 -6
  30. package/plugins/session-manager-dev/skills/builder/4-manual/SKILL.md +21 -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 +121 -12
  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 +12 -25
  91. package/src/main/lib/workTypeLibrary.cjs +7 -1
  92. package/src/main/promptSessionEvents.cjs +37 -13
  93. package/src/main/scheduler.cjs +910 -198
  94. package/src/main/seedAgentPersonas.cjs +278 -23
  95. package/src/main/supervisor.cjs +4 -1
  96. package/src/main/templates/PRD_AUTHORING.md +126 -406
  97. package/src/preload/__tests__/preload-surface.test.cjs +68 -0
  98. package/src/preload/api.d.ts +41 -94
  99. package/src/preload/index.cjs +14 -9
  100. package/src/seed/agents/architect.md +1 -0
  101. package/src/seed/agents/dev-lead.md +17 -18
  102. package/src/seed/agents/project-home-builder.md +1 -0
  103. package/src/seed/agents/validator.md +10 -4
  104. package/dist/assets/HostBilko-CDVHE0hT.js +0 -1
  105. package/dist/assets/Scheduler-C_phpeUS.js +0 -16
  106. package/dist/assets/Settings-BIwZ3FGQ.js +0 -3
  107. package/src/main/__tests__/activeIndexMerge.test.cjs +0 -235
  108. package/src/main/__tests__/agentEffortResolve.test.cjs +0 -117
  109. package/src/main/__tests__/agentLibrary.test.cjs +0 -276
  110. package/src/main/__tests__/agentModelResolve.test.cjs +0 -311
  111. package/src/main/__tests__/agentOverlayWrite.test.cjs +0 -95
  112. package/src/main/__tests__/bilkoHost-deriveSlug.test.cjs +0 -26
  113. package/src/main/__tests__/bilkoHost-integration.test.cjs +0 -118
  114. package/src/main/__tests__/bilkoHostCore.test.cjs +0 -72
  115. package/src/main/__tests__/broadcastCoalescer.test.cjs +0 -122
  116. package/src/main/__tests__/chat-cancel-terminal.test.cjs +0 -120
  117. package/src/main/__tests__/chat-dead-channels.test.cjs +0 -63
  118. package/src/main/__tests__/chat-exit-close-race.test.cjs +0 -146
  119. package/src/main/__tests__/chat-mcp-consent-notice.test.cjs +0 -139
  120. package/src/main/__tests__/chat-preamble-anchors.test.cjs +0 -100
  121. package/src/main/__tests__/chat-queue.test.cjs +0 -97
  122. package/src/main/__tests__/chat-stop-signal.test.cjs +0 -89
  123. package/src/main/__tests__/chatRunner-epic-worktree-execcwd.test.cjs +0 -125
  124. package/src/main/__tests__/chatRunner-session-flag-retry.test.cjs +0 -252
  125. package/src/main/__tests__/classifyPromptTicket.test.cjs +0 -101
  126. package/src/main/__tests__/classifyTranscriptLine.test.cjs +0 -201
  127. package/src/main/__tests__/computeDepHistorySatisfaction.test.cjs +0 -66
  128. package/src/main/__tests__/config-readText-bounded.test.cjs +0 -84
  129. package/src/main/__tests__/configWriteBoundaryOwners.test.cjs +0 -59
  130. package/src/main/__tests__/crossProjectFeedback.test.cjs +0 -334
  131. package/src/main/__tests__/crossProjectFeedbackRoutes.test.cjs +0 -161
  132. package/src/main/__tests__/dep-orphan-archive-health.test.cjs +0 -77
  133. package/src/main/__tests__/develop-skill-failure-modes.test.cjs +0 -70
  134. package/src/main/__tests__/docEdit.test.cjs +0 -244
  135. package/src/main/__tests__/dod-batchkey.test.cjs +0 -183
  136. package/src/main/__tests__/dod-drain-hook.test.cjs +0 -302
  137. package/src/main/__tests__/dod-report.test.cjs +0 -304
  138. package/src/main/__tests__/dod-reverify.test.cjs +0 -285
  139. package/src/main/__tests__/epicContextDigest.test.cjs +0 -174
  140. package/src/main/__tests__/epicMint.test.cjs +0 -332
  141. package/src/main/__tests__/epicMintTelemetryTap.test.cjs +0 -64
  142. package/src/main/__tests__/epicStatusMirror.test.cjs +0 -110
  143. package/src/main/__tests__/epicValidationHook.test.cjs +0 -291
  144. package/src/main/__tests__/exchanges.test.cjs +0 -122
  145. package/src/main/__tests__/exchangesPromptId.test.cjs +0 -61
  146. package/src/main/__tests__/extractJson.test.cjs +0 -51
  147. package/src/main/__tests__/files-reject-credentials.test.cjs +0 -40
  148. package/src/main/__tests__/fixtures/1218-fo-01-move-scripts-lib-into-src-main-lib.log +0 -556
  149. package/src/main/__tests__/flatPrdTickSweep.test.cjs +0 -110
  150. package/src/main/__tests__/health-build-freshness.test.cjs +0 -39
  151. package/src/main/__tests__/health-claude-md-budget.test.cjs +0 -57
  152. package/src/main/__tests__/health-credentials.test.cjs +0 -81
  153. package/src/main/__tests__/health-delegation-chain.test.cjs +0 -124
  154. package/src/main/__tests__/health-per-project-stall.test.cjs +0 -84
  155. package/src/main/__tests__/health-prd-migration.test.cjs +0 -37
  156. package/src/main/__tests__/health-queue-dispatch.test.cjs +0 -135
  157. package/src/main/__tests__/health-starve-escalation.test.cjs +0 -94
  158. package/src/main/__tests__/health-tick-liveness.test.cjs +0 -179
  159. package/src/main/__tests__/health-usage-poller.test.cjs +0 -144
  160. package/src/main/__tests__/health-worktree-cap-blocked.test.cjs +0 -65
  161. package/src/main/__tests__/heapSnapshot.test.cjs +0 -121
  162. package/src/main/__tests__/historyAggregatorIntraday.test.cjs +0 -313
  163. package/src/main/__tests__/historyDashboard.test.cjs +0 -163
  164. package/src/main/__tests__/historyRollup.test.cjs +0 -333
  165. package/src/main/__tests__/intradayRefresh.test.cjs +0 -39
  166. package/src/main/__tests__/ipcSchemas-dependsOn.test.cjs +0 -39
  167. package/src/main/__tests__/kg-augment.test.cjs +0 -195
  168. package/src/main/__tests__/loadGateDetailTick.test.cjs +0 -31
  169. package/src/main/__tests__/machineProfile.test.cjs +0 -152
  170. package/src/main/__tests__/mcpStatus.test.cjs +0 -61
  171. package/src/main/__tests__/memoryAggregate.test.cjs +0 -109
  172. package/src/main/__tests__/memoryStale.test.cjs +0 -88
  173. package/src/main/__tests__/needsReviewLedger.test.cjs +0 -162
  174. package/src/main/__tests__/openExternalApp-spawn-error.test.cjs +0 -25
  175. package/src/main/__tests__/opsErrorLog.test.cjs +0 -109
  176. package/src/main/__tests__/opsErrorLogTelemetryTap.test.cjs +0 -173
  177. package/src/main/__tests__/personaMerge.test.cjs +0 -169
  178. package/src/main/__tests__/planValidator.test.cjs +0 -125
  179. package/src/main/__tests__/pollLoop-dispatch-on-failure.test.cjs +0 -176
  180. package/src/main/__tests__/prd-group-allocator.test.cjs +0 -119
  181. package/src/main/__tests__/prdAdminRouteParity.test.cjs +0 -70
  182. package/src/main/__tests__/prdAdminRoutes.test.cjs +0 -718
  183. package/src/main/__tests__/prdAgentType.test.cjs +0 -103
  184. package/src/main/__tests__/prdAuthoringSeed.test.cjs +0 -39
  185. package/src/main/__tests__/prdCreate.test.cjs +0 -979
  186. package/src/main/__tests__/prdCreateAdoption.test.cjs +0 -205
  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 -211
  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-mutate-reentrancy.test.cjs +0 -117
  282. package/src/main/__tests__/scheduler-needs-review-autoresolve.test.cjs +0 -197
  283. package/src/main/__tests__/scheduler-never-stop.test.cjs +0 -157
  284. package/src/main/__tests__/scheduler-no-dead-end-status.test.cjs +0 -152
  285. package/src/main/__tests__/scheduler-no-orphan-run-dir.test.cjs +0 -81
  286. package/src/main/__tests__/scheduler-notify-originating-tab-transcript.test.cjs +0 -87
  287. package/src/main/__tests__/scheduler-notify-originating-tab.test.cjs +0 -343
  288. package/src/main/__tests__/scheduler-periodic-reverify-guard.test.cjs +0 -217
  289. package/src/main/__tests__/scheduler-porcelain-rename.test.cjs +0 -164
  290. package/src/main/__tests__/scheduler-prd-missing-skip.test.cjs +0 -161
  291. package/src/main/__tests__/scheduler-prd-persona-spawn.test.cjs +0 -178
  292. package/src/main/__tests__/scheduler-quarantine-autoresolve.test.cjs +0 -165
  293. package/src/main/__tests__/scheduler-quiet-machine-lease.test.cjs +0 -257
  294. package/src/main/__tests__/scheduler-rate-limit-cooldown-freshness.test.cjs +0 -123
  295. package/src/main/__tests__/scheduler-rate-limit-pause.test.cjs +0 -152
  296. package/src/main/__tests__/scheduler-rate-limit-spin-guard.test.cjs +0 -156
  297. package/src/main/__tests__/scheduler-reap-dead-running-jobs.test.cjs +0 -754
  298. package/src/main/__tests__/scheduler-reaper-helpers-basics.test.cjs +0 -87
  299. package/src/main/__tests__/scheduler-reconcile-cwd-preserve.test.cjs +0 -100
  300. package/src/main/__tests__/scheduler-reconcile-history-backfill.test.cjs +0 -105
  301. package/src/main/__tests__/scheduler-reconcile-invalid-repair.test.cjs +0 -203
  302. package/src/main/__tests__/scheduler-reconcile-quarantine.test.cjs +0 -247
  303. package/src/main/__tests__/scheduler-reset-job-fields-guard.test.cjs +0 -77
  304. package/src/main/__tests__/scheduler-resume-recovery.test.cjs +0 -254
  305. package/src/main/__tests__/scheduler-shard-quarantine.test.cjs +0 -115
  306. package/src/main/__tests__/scheduler-shared-tree-guard.test.cjs +0 -380
  307. package/src/main/__tests__/scheduler-sigterm-commit.test.cjs +0 -43
  308. package/src/main/__tests__/scheduler-stall-per-project.test.cjs +0 -126
  309. package/src/main/__tests__/scheduler-starve-escalation.test.cjs +0 -154
  310. package/src/main/__tests__/scheduler-stranded-autofix-park.test.cjs +0 -252
  311. package/src/main/__tests__/scheduler-stranded-investigation.test.cjs +0 -185
  312. package/src/main/__tests__/scheduler-stuck-failed-escalation.test.cjs +0 -136
  313. package/src/main/__tests__/scheduler-supervisor-record.test.cjs +0 -81
  314. package/src/main/__tests__/scheduler-tick-cancel-token.test.cjs +0 -54
  315. package/src/main/__tests__/scheduler-tick-wedge.test.cjs +0 -172
  316. package/src/main/__tests__/scheduler-transient-failure.test.cjs +0 -141
  317. package/src/main/__tests__/scheduler-unreadable-queue-guard.test.cjs +0 -62
  318. package/src/main/__tests__/scheduler-utilization-hold.test.cjs +0 -89
  319. package/src/main/__tests__/scheduler-verify-prd-path.test.cjs +0 -109
  320. package/src/main/__tests__/scheduler-worktree-cap-defer.test.cjs +0 -234
  321. package/src/main/__tests__/scheduler-worktree-exec-cwd.test.cjs +0 -120
  322. package/src/main/__tests__/scheduler-writeprd-epic-rollback.test.cjs +0 -105
  323. package/src/main/__tests__/schedulerBatchRootBlocker.test.cjs +0 -117
  324. package/src/main/__tests__/schedulerStateSidecarRestore.test.cjs +0 -110
  325. package/src/main/__tests__/seedAgentPersonas.test.cjs +0 -184
  326. package/src/main/__tests__/seedSchedulerMcp.test.cjs +0 -211
  327. package/src/main/__tests__/seedStatus.test.cjs +0 -100
  328. package/src/main/__tests__/seedValidatorPersona.test.cjs +0 -116
  329. package/src/main/__tests__/stop-signal-anchor.test.cjs +0 -75
  330. package/src/main/__tests__/telemetryClient.test.cjs +0 -1055
  331. package/src/main/__tests__/telemetryContract.test.cjs +0 -930
  332. package/src/main/__tests__/telemetrySettings.test.cjs +0 -210
  333. package/src/main/__tests__/transcripts-batch-flush.test.cjs +0 -249
  334. package/src/main/__tests__/transcripts-doFlush-array.test.cjs +0 -124
  335. package/src/main/__tests__/transcripts-paged-reads.test.cjs +0 -241
  336. package/src/main/__tests__/transcripts-worktree-epic-path.test.cjs +0 -154
  337. package/src/main/__tests__/transcriptsUsageFor.test.cjs +0 -206
  338. package/src/main/__tests__/uniquePrdNumbers.test.cjs +0 -153
  339. package/src/main/__tests__/usageSingleFlight.test.cjs +0 -169
  340. package/src/main/__tests__/validationSentinels.test.cjs +0 -84
  341. package/src/main/__tests__/workTypeLibrary.test.cjs +0 -89
  342. package/src/main/bilkoHost.cjs +0 -314
  343. package/src/main/bilkoHostCore.cjs +0 -89
  344. package/src/main/lib/__tests__/active-sessions.test.cjs +0 -251
  345. package/src/main/lib/__tests__/activeIndexRebuild.test.cjs +0 -179
  346. package/src/main/lib/__tests__/agentPersonaSchema.test.cjs +0 -67
  347. package/src/main/lib/__tests__/auditLog.test.cjs +0 -38
  348. package/src/main/lib/__tests__/bootSelfHeal.test.cjs +0 -107
  349. package/src/main/lib/__tests__/branchSweep.test.cjs +0 -164
  350. package/src/main/lib/__tests__/buildIdentity.test.cjs +0 -121
  351. package/src/main/lib/__tests__/buildTarget.test.cjs +0 -52
  352. package/src/main/lib/__tests__/childWithLog.test.cjs +0 -321
  353. package/src/main/lib/__tests__/coldBootPromptSessionsWrite.test.cjs +0 -87
  354. package/src/main/lib/__tests__/crashTelemetry.test.cjs +0 -103
  355. package/src/main/lib/__tests__/credentials-futile-refresh.test.cjs +0 -115
  356. package/src/main/lib/__tests__/cwdClassify.test.cjs +0 -111
  357. package/src/main/lib/__tests__/definitionOfDoneSequence.test.cjs +0 -95
  358. package/src/main/lib/__tests__/delegationReadiness.test.cjs +0 -1175
  359. package/src/main/lib/__tests__/dispatchLoop.test.cjs +0 -63
  360. package/src/main/lib/__tests__/effectiveModelInfo.test.cjs +0 -244
  361. package/src/main/lib/__tests__/ephemeralCwd.test.cjs +0 -91
  362. package/src/main/lib/__tests__/epicDelegationStats.test.cjs +0 -137
  363. package/src/main/lib/__tests__/epicSpawnCwd.test.cjs +0 -283
  364. package/src/main/lib/__tests__/epicSpawnPlan.test.cjs +0 -196
  365. package/src/main/lib/__tests__/epicTranscriptPath.test.cjs +0 -163
  366. package/src/main/lib/__tests__/epicWorktreeBoot.test.cjs +0 -136
  367. package/src/main/lib/__tests__/epicWorktreeMerge.test.cjs +0 -130
  368. package/src/main/lib/__tests__/epicWorktreeMint.test.cjs +0 -117
  369. package/src/main/lib/__tests__/epicWorktreeProjectConfig.test.cjs +0 -137
  370. package/src/main/lib/__tests__/fixChainDepth.test.cjs +0 -40
  371. package/src/main/lib/__tests__/fixtures/204-mercury-steam-horse.log.txt +0 -13
  372. package/src/main/lib/__tests__/fixtures/scheduler-machine.json.corrupt-1789147548 +0 -34
  373. package/src/main/lib/__tests__/gateFixtures.json +0 -20
  374. package/src/main/lib/__tests__/gitCacheBound.test.cjs +0 -69
  375. package/src/main/lib/__tests__/gitWorktree.test.cjs +0 -1478
  376. package/src/main/lib/__tests__/gitWorktreeSalvage.test.cjs +0 -107
  377. package/src/main/lib/__tests__/gitWorktreeSalvageDelta.test.cjs +0 -153
  378. package/src/main/lib/__tests__/guardShims.test.cjs +0 -158
  379. package/src/main/lib/__tests__/importReferences.spec.cjs +0 -56
  380. package/src/main/lib/__tests__/instanceLock.test.cjs +0 -173
  381. package/src/main/lib/__tests__/jobSupervisorRecord.test.cjs +0 -78
  382. package/src/main/lib/__tests__/jobWorktree.test.cjs +0 -199
  383. package/src/main/lib/__tests__/jobWorktreeBootLive.test.cjs +0 -82
  384. package/src/main/lib/__tests__/landedSinceRun.test.cjs +0 -133
  385. package/src/main/lib/__tests__/launchFailure.test.cjs +0 -220
  386. package/src/main/lib/__tests__/loadGate.test.cjs +0 -303
  387. package/src/main/lib/__tests__/localAdminHttp.test.cjs +0 -214
  388. package/src/main/lib/__tests__/loopDelay.test.cjs +0 -68
  389. package/src/main/lib/__tests__/mcpToolCatalog.test.cjs +0 -107
  390. package/src/main/lib/__tests__/modelCatalog.test.cjs +0 -202
  391. package/src/main/lib/__tests__/opsOwnership.test.cjs +0 -113
  392. package/src/main/lib/__tests__/opsRootAbsoluteCwd.test.cjs +0 -328
  393. package/src/main/lib/__tests__/opsRootNestedWrite.test.cjs +0 -51
  394. package/src/main/lib/__tests__/opsRootResolve.test.cjs +0 -149
  395. package/src/main/lib/__tests__/prdDeclaredPaths.test.cjs +0 -82
  396. package/src/main/lib/__tests__/prdDisposition.test.cjs +0 -224
  397. package/src/main/lib/__tests__/procIdentity.test.cjs +0 -119
  398. package/src/main/lib/__tests__/procName.test.cjs +0 -92
  399. package/src/main/lib/__tests__/projectBriefCore.test.cjs +0 -216
  400. package/src/main/lib/__tests__/projectRootResolve.test.cjs +0 -148
  401. package/src/main/lib/__tests__/queueHealth.test.cjs +0 -58
  402. package/src/main/lib/__tests__/queueStoreAtomicWrite.test.cjs +0 -88
  403. package/src/main/lib/__tests__/queueStoreMachineStateRecovery.test.cjs +0 -190
  404. package/src/main/lib/__tests__/quietMachineLease.test.cjs +0 -39
  405. package/src/main/lib/__tests__/rateLimitWindow.test.cjs +0 -88
  406. package/src/main/lib/__tests__/reaperHelpers.test.cjs +0 -577
  407. package/src/main/lib/__tests__/schedulerBatchDepends.test.cjs +0 -312
  408. package/src/main/lib/__tests__/schedulerBatchFairness.test.cjs +0 -213
  409. package/src/main/lib/__tests__/schedulerBatchLaunchHold.test.cjs +0 -125
  410. package/src/main/lib/__tests__/schedulerBatchProjectCap.test.cjs +0 -127
  411. package/src/main/lib/__tests__/schedulerBatchQuietMachine.test.cjs +0 -109
  412. package/src/main/lib/__tests__/schedulerMcpServerHeadlessRefusal.test.cjs +0 -71
  413. package/src/main/lib/__tests__/schedulerMcpServerHelp.test.cjs +0 -216
  414. package/src/main/lib/__tests__/schedulerMcpServerProjectHome.test.cjs +0 -183
  415. package/src/main/lib/__tests__/schedulerPaths.test.cjs +0 -226
  416. package/src/main/lib/__tests__/schedulerPathsWorktree.test.cjs +0 -133
  417. package/src/main/lib/__tests__/schedulerRuntimeState.test.cjs +0 -56
  418. package/src/main/lib/__tests__/sessionSlots.test.cjs +0 -144
  419. package/src/main/lib/__tests__/telemetryBacklog.test.cjs +0 -626
  420. package/src/main/lib/__tests__/telemetryBoot.test.cjs +0 -134
  421. package/src/main/lib/__tests__/telemetryConsent.test.cjs +0 -136
  422. package/src/main/lib/__tests__/telemetryCounters.test.cjs +0 -57
  423. package/src/main/lib/__tests__/telemetryCountersMetadataColumn.test.cjs +0 -98
  424. package/src/main/lib/__tests__/terminalRunOutcome.test.cjs +0 -200
  425. package/src/main/lib/__tests__/toolUseClassify.test.cjs +0 -53
  426. package/src/main/lib/__tests__/updateCheck.test.cjs +0 -63
  427. package/src/main/lib/__tests__/upgradeDrain.test.cjs +0 -130
  428. package/src/main/lib/__tests__/usageCircuit.test.cjs +0 -354
  429. package/src/main/lib/__tests__/watchdog-helpers.test.cjs +0 -441
  430. package/src/main/lib/__tests__/watchdog-relaunch.test.cjs +0 -266
  431. 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
- });