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,626 +0,0 @@
1
- /**
2
- * telemetryBacklog.test.cjs — unit tests for the pre-existing error-log
3
- * backlog drainer (telemetryBacklog.cjs).
4
- *
5
- * Run: timeout 180 npx vitest run src/main/lib/__tests__/telemetryBacklog.test.cjs
6
- */
7
- 'use strict';
8
-
9
- import { test, expect, beforeEach, afterEach, vi } from 'vitest';
10
- const fsp = require('node:fs/promises');
11
- const fs = require('node:fs');
12
- const os = require('node:os');
13
- const path = require('node:path');
14
-
15
- const opsErrorLog = require('../opsErrorLog.cjs');
16
- const { isEphemeralCwd } = require('../ephemeralCwd.cjs');
17
- const { resolveProjectContext } = require('../projectRootResolve.cjs');
18
-
19
- const tmpDirs = [];
20
- let originalHome;
21
- let originalSmTelemetrySpool;
22
-
23
- beforeEach(() => {
24
- originalHome = process.env.HOME;
25
- originalSmTelemetrySpool = process.env.SM_TELEMETRY_SPOOL;
26
- });
27
-
28
- afterEach(async () => {
29
- if (originalHome !== undefined) process.env.HOME = originalHome;
30
- if (originalSmTelemetrySpool === undefined) delete process.env.SM_TELEMETRY_SPOOL; else process.env.SM_TELEMETRY_SPOOL = originalSmTelemetrySpool;
31
- vi.unstubAllGlobals();
32
- while (tmpDirs.length) {
33
- const d = tmpDirs.pop();
34
- await fsp.rm(d, { recursive: true, force: true });
35
- }
36
- });
37
-
38
- async function mkHome() {
39
- const dir = await fsp.mkdtemp(path.join(os.tmpdir(), 'sm-backlog-home-'));
40
- tmpDirs.push(dir);
41
- return dir;
42
- }
43
-
44
- async function mkProject(name) {
45
- const dir = await fsp.mkdtemp(path.join(os.tmpdir(), `sm-backlog-project-${name}-`));
46
- tmpDirs.push(dir);
47
- return dir;
48
- }
49
-
50
- function fakeProfile(overrides = {}) {
51
- return { appVersion: '0.83.0', platform: 'linux', arch: 'x64', machineDigest: 'deadbeefcafe', installChannel: 'dev', ...overrides };
52
- }
53
-
54
- /** Reloads the HOME-dependent modules (config.cjs computes allowedRoots from os.homedir() at require time). */
55
- function freshTelemetry(home) {
56
- process.env.HOME = home;
57
- // Explicit opt-in: overrides the test-environment no-op guard so this
58
- // suite's real telemetryClient calls actually persist into an isolated dir.
59
- process.env.SM_TELEMETRY_SPOOL = path.join(home, '.claude', 'session-manager');
60
- for (const p of ['../telemetryClient.cjs', '../../config.cjs', '../telemetrySettings.cjs', '../machineProfile.cjs']) {
61
- const resolved = require.resolve(p);
62
- delete require.cache[resolved];
63
- }
64
- const telemetryClient = require('../telemetryClient.cjs');
65
- const config = require('../../config.cjs');
66
- telemetryClient._setMachineProfileBuilder(async () => fakeProfile());
67
- return { telemetryClient, config };
68
- }
69
-
70
- function reloadBacklog() {
71
- const resolved = require.resolve('../telemetryBacklog.cjs');
72
- delete require.cache[resolved];
73
- return require('../telemetryBacklog.cjs');
74
- }
75
-
76
- function fetchStub(responder) {
77
- const calls = [];
78
- const fn = vi.fn(async (url, opts) => {
79
- const rec = { url, opts, body: JSON.parse(opts.body) };
80
- calls.push(rec);
81
- return responder(rec, calls.length);
82
- });
83
- fn.calls = calls;
84
- return fn;
85
- }
86
-
87
- function okAlways() {
88
- return fetchStub(() => ({ ok: true, status: 200 }));
89
- }
90
-
91
- function failAlways(status = 500) {
92
- return fetchStub(() => ({ ok: false, status }));
93
- }
94
-
95
- function writeErrorsFile(projectCwd, dateStr, lines, { trailingNewline = true } = {}) {
96
- const dir = opsErrorLog.logsDir(projectCwd);
97
- fs.mkdirSync(dir, { recursive: true });
98
- const file = path.join(dir, `errors-${dateStr}.jsonl`);
99
- const body = lines.map((l) => (typeof l === 'string' ? l : JSON.stringify(l))).join('\n');
100
- fs.writeFileSync(file, trailingNewline ? body + '\n' : body);
101
- return file;
102
- }
103
-
104
- /** A recent date string (within the 30-day retention floor) for fixture filenames. */
105
- function recentDateStr() {
106
- return new Date().toISOString().slice(0, 10);
107
- }
108
-
109
- function errLine(i, overrides = {}) {
110
- return {
111
- ts: new Date().toISOString(),
112
- level: 'error',
113
- scope: `synthetic-${i}`,
114
- tabId: null,
115
- epicId: null,
116
- tags: [`level:error`, `scope:synthetic-${i}`],
117
- message: `boom ${i}`,
118
- ...overrides,
119
- };
120
- }
121
-
122
- function makeDeps({ home, telemetryClient, config, tabCwds }) {
123
- return {
124
- sessionsStore: { load: async () => ({ tabs: tabCwds.map((cwd) => ({ cwd })), activeTabId: null }) },
125
- isEphemeralCwd,
126
- resolveProjectContext,
127
- telemetryClient,
128
- opsErrorLog,
129
- config,
130
- fs,
131
- fsp,
132
- };
133
- }
134
-
135
- function watermarksFileFor(home) {
136
- return path.join(home, '.claude', 'session-manager', 'telemetry-watermarks.json');
137
- }
138
-
139
- async function readWatermarks(home) {
140
- try {
141
- return JSON.parse(await fsp.readFile(watermarksFileFor(home), 'utf8'));
142
- } catch {
143
- return {};
144
- }
145
- }
146
-
147
- // ─── exports + basic shape ─────────────────────────────────────────────
148
-
149
- test('exports drainBacklog + reconcileWatermarks returning the documented summary shape', async () => {
150
- const home = await mkHome();
151
- const project = await mkProject('shape');
152
- const { telemetryClient, config } = freshTelemetry(home);
153
- telemetryClient._setFetchImpl(okAlways());
154
- const backlog = reloadBacklog();
155
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
156
-
157
- const summary = await backlog.drainBacklog({ now: Date.now(), limit: 500, deps });
158
- for (const key of ['projectsScanned', 'filesScanned', 'linesEnqueued', 'linesConfirmed', 'linesSkipped', 'filesCompleted', 'watermarksRewound']) {
159
- expect(typeof summary[key]).toBe('number');
160
- }
161
- expect(typeof backlog.reconcileWatermarks).toBe('function');
162
- });
163
-
164
- // ─── project enumeration ────────────────────────────────────────────────
165
-
166
- test('duplicate cwds across tabs are visited once; a missing cwd is skipped without throwing', async () => {
167
- const home = await mkHome();
168
- const project = await mkProject('dedupe');
169
- writeErrorsFile(project, recentDateStr(), [errLine(1)]);
170
- const missing = path.join(os.tmpdir(), 'sm-backlog-does-not-exist-' + Date.now());
171
-
172
- const { telemetryClient, config } = freshTelemetry(home);
173
- telemetryClient._setFetchImpl(okAlways());
174
- const backlog = reloadBacklog();
175
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project, project, missing] });
176
-
177
- const summary = await expect(backlog.drainBacklog({ now: Date.now(), deps })).resolves.toBeDefined();
178
- const s = await backlog.drainBacklog({ now: Date.now(), deps });
179
- // Second call: file already fully drained+confirmed on the first call, so
180
- // the single deduped project contributes zero further lines.
181
- expect(s.linesEnqueued).toBe(0);
182
- });
183
-
184
- test('an ephemeral epic-worktree cwd is never scanned as its own project', async () => {
185
- const home = await mkHome();
186
- const ephemeral = path.join(process.env.SM_WORKTREE_ROOT || os.tmpdir(), 'session-manager-epic-worktrees', 'abc123', 'psess-xyz');
187
- const opsDir = path.join(ephemeral, 'session-manager-operations', 'logs');
188
- fs.mkdirSync(opsDir, { recursive: true });
189
- fs.writeFileSync(path.join(opsDir, `errors-${recentDateStr()}.jsonl`), JSON.stringify(errLine(1)) + '\n');
190
-
191
- const { telemetryClient, config } = freshTelemetry(home);
192
- telemetryClient._setFetchImpl(okAlways());
193
- const backlog = reloadBacklog();
194
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [ephemeral] });
195
-
196
- const summary = await backlog.drainBacklog({ now: Date.now(), deps });
197
- expect(summary.projectsScanned).toBe(0);
198
- expect(summary.linesEnqueued).toBe(0);
199
- });
200
-
201
- // ─── log files are never modified ──────────────────────────────────────
202
-
203
- test('log files are never modified — mtime and byte length unchanged after a full drain', async () => {
204
- const home = await mkHome();
205
- const project = await mkProject('readonly');
206
- const file = writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2), { not: 'valid error shape but still json' }]);
207
- const before = fs.statSync(file);
208
- const beforeBytes = fs.readFileSync(file);
209
-
210
- const { telemetryClient, config } = freshTelemetry(home);
211
- telemetryClient._setFetchImpl(okAlways());
212
- const backlog = reloadBacklog();
213
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
214
- await backlog.drainBacklog({ now: Date.now(), deps });
215
-
216
- const after = fs.statSync(file);
217
- const afterBytes = fs.readFileSync(file);
218
- expect(after.mtimeMs).toBe(before.mtimeMs);
219
- expect(afterBytes.length).toBe(beforeBytes.length);
220
- expect(Buffer.compare(afterBytes, beforeBytes)).toBe(0);
221
- });
222
-
223
- // ─── two-phase watermark ────────────────────────────────────────────────
224
-
225
- test('a drain whose flush fails leaves bytesConfirmed at its previous value while bytesEnqueued advances', async () => {
226
- const home = await mkHome();
227
- const project = await mkProject('flushfail');
228
- writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2)]);
229
-
230
- const { telemetryClient, config } = freshTelemetry(home);
231
- telemetryClient._setFetchImpl(failAlways(500));
232
- const backlog = reloadBacklog();
233
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
234
-
235
- await backlog.drainBacklog({ now: Date.now(), deps });
236
-
237
- const wm = await readWatermarks(home);
238
- const [key, entry] = Object.entries(wm)[0];
239
- expect(entry.bytesEnqueued).toBeGreaterThan(0);
240
- expect(entry.bytesConfirmed).toBe(0);
241
- });
242
-
243
- // ─── deterministic recordId ─────────────────────────────────────────────
244
-
245
- test('re-draining the same file after a forced watermark rewind produces identical recordIds', async () => {
246
- const home = await mkHome();
247
- const project = await mkProject('detid');
248
- writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2)]);
249
-
250
- // flush always fails, so bytesConfirmed stays at 0 while bytesEnqueued
251
- // advances — this is the exact invariant a real rewind (bytesEnqueued ->
252
- // bytesConfirmed) restores, so rewinding to 0 here mirrors what
253
- // reconcileWatermarks would actually do after a detected loss.
254
- const { telemetryClient, config } = freshTelemetry(home);
255
- telemetryClient._setFetchImpl(failAlways(500));
256
- const backlog = reloadBacklog();
257
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
258
-
259
- const spy = vi.spyOn(telemetryClient, 'reportError');
260
- await backlog.drainBacklog({ now: Date.now(), deps });
261
- const firstIds = spy.mock.calls.map((c) => c[0].recordId).sort();
262
- expect(firstIds.length).toBe(2);
263
-
264
- // Force a rewind directly on the watermark file (simulating reconcileWatermarks having found a loss).
265
- const wm = await readWatermarks(home);
266
- const key = Object.keys(wm)[0];
267
- expect(wm[key].bytesConfirmed).toBe(0);
268
- wm[key].bytesEnqueued = wm[key].bytesConfirmed;
269
- await config.writeJson(watermarksFileFor(home), wm);
270
-
271
- spy.mockClear();
272
- await backlog.drainBacklog({ now: Date.now(), deps });
273
- const secondIds = spy.mock.calls.map((c) => c[0].recordId).sort();
274
-
275
- expect(secondIds).toEqual(firstIds);
276
- });
277
-
278
- // ─── boot reconciliation (anti-loss) ────────────────────────────────────
279
-
280
- test('boot reconciliation re-sends a record that was enqueued then evicted from the queue before delivery, exactly once', async () => {
281
- const home = await mkHome();
282
- const project = await mkProject('reconcile');
283
- writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2)]);
284
-
285
- // Round 1: enqueue succeeds (accepted into telemetryClient's durable queue)
286
- // but flush fails, so nothing is delivered yet.
287
- let { telemetryClient, config } = freshTelemetry(home);
288
- telemetryClient._setFetchImpl(failAlways(500));
289
- let backlog = reloadBacklog();
290
- let deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
291
- await backlog.drainBacklog({ now: Date.now(), deps });
292
-
293
- // Simulate queue eviction without delivery: wipe the durable queue file.
294
- await fsp.writeFile(telemetryClient.queuePath(), '', 'utf8');
295
-
296
- // "Restart": fresh telemetryClient + fresh drainer, same HOME (same config dir).
297
- ({ telemetryClient, config } = freshTelemetry(home));
298
- const fetch2 = okAlways();
299
- telemetryClient._setFetchImpl(fetch2);
300
- backlog = reloadBacklog();
301
- deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
302
-
303
- const reconcileSummary = await backlog.reconcileWatermarks({ now: Date.now(), deps });
304
- expect(reconcileSummary.watermarksRewound).toBe(1);
305
-
306
- const spy = vi.spyOn(telemetryClient, 'reportError');
307
- const drainSummary = await backlog.drainBacklog({ now: Date.now(), deps });
308
- expect(spy.mock.calls.length).toBe(2); // both lines re-sent exactly once
309
- expect(drainSummary.linesEnqueued).toBe(2);
310
-
311
- const wm = await readWatermarks(home);
312
- const entry = Object.values(wm)[0];
313
- expect(entry.bytesConfirmed).toBe(entry.bytesEnqueued);
314
- expect(entry.completedAt).toBeTruthy();
315
- });
316
-
317
- // ─── anti-over-traffic (the acceptance test for the whole design) ──────
318
-
319
- test('draining an unchanged fixture tree twice in the same process produces ZERO outbound records the second time', async () => {
320
- const home = await mkHome();
321
- const project = await mkProject('notwice');
322
- writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2), errLine(3)]);
323
-
324
- const { telemetryClient, config } = freshTelemetry(home);
325
- const fetchFn = okAlways();
326
- telemetryClient._setFetchImpl(fetchFn);
327
- const backlog = reloadBacklog();
328
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
329
-
330
- await backlog.drainBacklog({ now: Date.now(), deps });
331
- const callsAfterFirst = fetchFn.calls.length;
332
- expect(callsAfterFirst).toBeGreaterThan(0);
333
-
334
- await backlog.drainBacklog({ now: Date.now(), deps });
335
- expect(fetchFn.calls.length).toBe(callsAfterFirst); // zero additional outbound records
336
- });
337
-
338
- test('draining the same unchanged tree across a simulated restart also produces ZERO outbound records', async () => {
339
- const home = await mkHome();
340
- const project = await mkProject('norestart');
341
- writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2), errLine(3)]);
342
-
343
- let { telemetryClient, config } = freshTelemetry(home);
344
- telemetryClient._setFetchImpl(okAlways());
345
- let backlog = reloadBacklog();
346
- let deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
347
- await backlog.drainBacklog({ now: Date.now(), deps });
348
-
349
- // Fresh client + fresh drainer, same HOME/config dir — a simulated restart.
350
- ({ telemetryClient, config } = freshTelemetry(home));
351
- const fetch2 = okAlways();
352
- telemetryClient._setFetchImpl(fetch2);
353
- backlog = reloadBacklog();
354
- deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
355
-
356
- await backlog.drainBacklog({ now: Date.now(), deps });
357
- expect(fetch2.calls.length).toBe(0);
358
- });
359
-
360
- // ─── resume-on-append ───────────────────────────────────────────────────
361
-
362
- test('resumes from the byte offset on append — draining twice after appending enqueues only the new lines', async () => {
363
- const home = await mkHome();
364
- const project = await mkProject('append');
365
- const file = writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2)]);
366
-
367
- const { telemetryClient, config } = freshTelemetry(home);
368
- telemetryClient._setFetchImpl(okAlways());
369
- const backlog = reloadBacklog();
370
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
371
-
372
- const spy = vi.spyOn(telemetryClient, 'reportError');
373
- await backlog.drainBacklog({ now: Date.now(), deps });
374
- expect(spy.mock.calls.length).toBe(2);
375
- spy.mockClear();
376
-
377
- fs.appendFileSync(file, JSON.stringify(errLine(3)) + '\n' + JSON.stringify(errLine(4)) + '\n');
378
- const summary = await backlog.drainBacklog({ now: Date.now(), deps });
379
- expect(spy.mock.calls.length).toBe(2);
380
- expect(summary.linesEnqueued).toBe(2);
381
- });
382
-
383
- // ─── truncation/rotation safety ─────────────────────────────────────────
384
-
385
- test('a file smaller than its recorded bytesEnqueued is re-read from zero rather than seeking past EOF', async () => {
386
- const home = await mkHome();
387
- const project = await mkProject('truncate');
388
- const file = writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2), errLine(3)]);
389
-
390
- const { telemetryClient, config } = freshTelemetry(home);
391
- telemetryClient._setFetchImpl(okAlways());
392
- const backlog = reloadBacklog();
393
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
394
- await backlog.drainBacklog({ now: Date.now(), deps });
395
-
396
- // Truncate/rotate: file replaced with a single, shorter line.
397
- fs.writeFileSync(file, JSON.stringify(errLine(99)) + '\n');
398
-
399
- const spy = vi.spyOn(telemetryClient, 'reportError');
400
- await backlog.drainBacklog({ now: Date.now(), deps });
401
- // Re-read from zero: the new (shorter) content at offset 0 was parsed and
402
- // handed to telemetryClient — note this deliberately does NOT assert
403
- // delivery, since a byte-offset-derived recordId for offset 0 collides
404
- // with the prior (already-delivered) content that also started at offset
405
- // 0; telemetryClient's own dedup correctly treats that recordId as already
406
- // sent. What truncation safety guarantees is "read from zero, not past
407
- // EOF" — not that a same-offset rewrite bypasses the client's dedup.
408
- expect(spy.mock.calls.some((c) => c[0].name === 'synthetic-99')).toBe(true);
409
- const wm = await readWatermarks(home);
410
- expect(Object.values(wm)[0].bytesEnqueued).toBe(fs.statSync(file).size);
411
- });
412
-
413
- // ─── malformed lines + truncated trailing line ──────────────────────────
414
-
415
- test('malformed JSON lines are skipped, still advance the offset, and never throw; a truncated trailing line is left for the next drain', async () => {
416
- const home = await mkHome();
417
- const project = await mkProject('malformed');
418
- const file = writeErrorsFile(
419
- project,
420
- recentDateStr(),
421
- [JSON.stringify(errLine(1)), 'not valid json at all {{{', JSON.stringify(errLine(2))],
422
- );
423
- // Append an in-progress (no trailing newline) partial line.
424
- fs.appendFileSync(file, '{"level":"error","scope":"partial-in-progr');
425
-
426
- const { telemetryClient, config } = freshTelemetry(home);
427
- telemetryClient._setFetchImpl(okAlways());
428
- const backlog = reloadBacklog();
429
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
430
-
431
- const summary = await backlog.drainBacklog({ now: Date.now(), deps });
432
- expect(summary.linesSkipped).toBe(1);
433
- expect(summary.linesEnqueued).toBe(2);
434
-
435
- const wm = await readWatermarks(home);
436
- const entry = Object.values(wm)[0];
437
- const size = fs.statSync(file).size;
438
- expect(entry.bytesEnqueued).toBeLessThan(size); // trailing partial line left unconsumed
439
- });
440
-
441
- // ─── per-drain budget ────────────────────────────────────────────────────
442
-
443
- test('a 1200-line fixture drains as 500, then 500, then 200 (oldest file first, default budget)', async () => {
444
- const home = await mkHome();
445
- const project = await mkProject('budget');
446
- const lines = Array.from({ length: 1200 }, (_, i) => errLine(i));
447
- writeErrorsFile(project, recentDateStr(), lines);
448
-
449
- const { telemetryClient, config } = freshTelemetry(home);
450
- telemetryClient._setFetchImpl(okAlways());
451
- const backlog = reloadBacklog();
452
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
453
-
454
- const s1 = await backlog.drainBacklog({ now: Date.now(), limit: 500, deps });
455
- const s2 = await backlog.drainBacklog({ now: Date.now(), limit: 500, deps });
456
- const s3 = await backlog.drainBacklog({ now: Date.now(), limit: 500, deps });
457
-
458
- expect(s1.linesEnqueued).toBe(500);
459
- expect(s2.linesEnqueued).toBe(500);
460
- expect(s3.linesEnqueued).toBe(200);
461
- });
462
-
463
- // ─── retention floor ─────────────────────────────────────────────────────
464
-
465
- test('a log file older than the 30-day retention floor is marked completed WITHOUT being opened for read', async () => {
466
- const home = await mkHome();
467
- const project = await mkProject('retention');
468
- const oldDate = new Date(Date.now() - 45 * 24 * 60 * 60 * 1000);
469
- const dateStr = oldDate.toISOString().slice(0, 10);
470
- writeErrorsFile(project, dateStr, [errLine(1), errLine(2)]);
471
-
472
- const { telemetryClient, config } = freshTelemetry(home);
473
- const fetchFn = okAlways();
474
- telemetryClient._setFetchImpl(fetchFn);
475
- const backlog = reloadBacklog();
476
- const readSpy = vi.spyOn(fsp, 'readFile');
477
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
478
-
479
- const summary = await backlog.drainBacklog({ now: Date.now(), deps });
480
- expect(summary.filesCompleted).toBe(1);
481
- expect(fetchFn.calls.length).toBe(0);
482
- const logFile = path.join(opsErrorLog.logsDir(project), `errors-${dateStr}.jsonl`);
483
- expect(readSpy.mock.calls.some((c) => c[0] === logFile)).toBe(false);
484
- readSpy.mockRestore();
485
- });
486
-
487
- // ─── completed-file fast path ────────────────────────────────────────────
488
-
489
- test('a fully-confirmed file is stamped completed and skipped by later scans without any content-read syscall', async () => {
490
- const home = await mkHome();
491
- const project = await mkProject('completed');
492
- const file = writeErrorsFile(project, recentDateStr(), [errLine(1)]);
493
-
494
- const { telemetryClient, config } = freshTelemetry(home);
495
- telemetryClient._setFetchImpl(okAlways());
496
- const backlog = reloadBacklog();
497
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
498
- await backlog.drainBacklog({ now: Date.now(), deps });
499
-
500
- const wm = await readWatermarks(home);
501
- expect(Object.values(wm)[0].completedAt).toBeTruthy();
502
-
503
- // A cheap stat (to detect append/truncate) is fine; a full content read
504
- // ("re-opened") is not, on a file whose size hasn't changed since completion.
505
- const readSpy = vi.spyOn(fsp, 'readFile');
506
- await backlog.drainBacklog({ now: Date.now(), deps });
507
- expect(readSpy.mock.calls.some((c) => c[0] === file)).toBe(false);
508
- readSpy.mockRestore();
509
- });
510
-
511
- // ─── level routing ────────────────────────────────────────────────────────
512
-
513
- test('level "warn" lines route to logLine, level "error" lines route to reportError, carrying scope/tags/cwd', async () => {
514
- const home = await mkHome();
515
- const project = await mkProject('levels');
516
- writeErrorsFile(project, recentDateStr(), [
517
- { level: 'error', scope: 'chatRunner', tags: ['t1'], message: 'e' },
518
- { level: 'warn', scope: 'pty', tags: ['t2'], message: 'w' },
519
- ]);
520
-
521
- const { telemetryClient, config } = freshTelemetry(home);
522
- telemetryClient._setFetchImpl(okAlways());
523
- const backlog = reloadBacklog();
524
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
525
-
526
- const errSpy = vi.spyOn(telemetryClient, 'reportError');
527
- const logSpy = vi.spyOn(telemetryClient, 'logLine');
528
- await backlog.drainBacklog({ now: Date.now(), deps });
529
-
530
- expect(errSpy.mock.calls.length).toBe(1);
531
- expect(errSpy.mock.calls[0][0].context.scope).toBe('chatRunner');
532
- expect(errSpy.mock.calls[0][0].context.cwd).toBe(project);
533
- expect(logSpy.mock.calls.length).toBe(1);
534
- expect(logSpy.mock.calls[0][0].fields.scope).toBe('pty');
535
- expect(logSpy.mock.calls[0][0].fields.cwd).toBe(project);
536
- });
537
-
538
- // ─── boot wiring: invoked on ready, once more per new version ───────────
539
-
540
- test('bootDrain always drains with reason "boot", and drains a second time with reason "version-change" exactly once per new version', async () => {
541
- const home = await mkHome();
542
- const project = await mkProject('wiring');
543
- writeErrorsFile(project, recentDateStr(), [errLine(1)]);
544
-
545
- const { telemetryClient, config } = freshTelemetry(home);
546
- telemetryClient._setFetchImpl(okAlways());
547
- const backlog = reloadBacklog();
548
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
549
- // Each internal drainBacklog() call enumerates projects twice (once for
550
- // its own reconcileWatermarks() pass, once for the drain pass itself) via
551
- // sessionsStore.load() — counting those calls in multiples of 2 tells us
552
- // how many actual drain passes bootDrain performed, without reaching into
553
- // module internals.
554
- const loadSpy = vi.spyOn(deps.sessionsStore, 'load');
555
-
556
- await backlog.bootDrain({ now: Date.now(), appVersion: '1.0.0', deps });
557
- expect(loadSpy.mock.calls.length).toBe(4); // 2 drain passes: boot + version-change (first time seeing 1.0.0)
558
-
559
- loadSpy.mockClear();
560
- await backlog.bootDrain({ now: Date.now(), appVersion: '1.0.0', deps });
561
- expect(loadSpy.mock.calls.length).toBe(2); // 1 drain pass: same version again — no second version-change drain
562
-
563
- loadSpy.mockClear();
564
- await backlog.bootDrain({ now: Date.now(), appVersion: '2.0.0', deps });
565
- expect(loadSpy.mock.calls.length).toBe(4); // 2 drain passes: new version — exactly one more version-change drain
566
- });
567
-
568
- // ─── fully contained: never throws ──────────────────────────────────────
569
-
570
- test('drainBacklog resolves (never rejects) when readdir fails, telemetryClient throws, and the watermarks file is corrupt', async () => {
571
- const home = await mkHome();
572
- await fsp.mkdir(path.join(home, '.claude', 'session-manager'), { recursive: true });
573
- await fsp.writeFile(watermarksFileFor(home), 'not valid { json', 'utf8');
574
- const project = await mkProject('contained');
575
- writeErrorsFile(project, recentDateStr(), [errLine(1)]);
576
-
577
- const backlog = reloadBacklog();
578
- const throwingFs = {
579
- ...fs,
580
- readdirSync: () => { throw new Error('boom readdir'); },
581
- };
582
- const throwingClient = {
583
- reportError: async () => { throw new Error('boom client'); },
584
- logLine: async () => { throw new Error('boom client'); },
585
- flush: async () => { throw new Error('boom flush'); },
586
- isPending: async () => { throw new Error('boom pending'); },
587
- sentPath: () => path.join(home, '.claude', 'session-manager', 'telemetry-sent.json'),
588
- };
589
- const deps = {
590
- sessionsStore: { load: async () => ({ tabs: [{ cwd: project }] }) },
591
- isEphemeralCwd,
592
- resolveProjectContext,
593
- telemetryClient: throwingClient,
594
- opsErrorLog,
595
- config: require('../../config.cjs'),
596
- fs: throwingFs,
597
- fsp,
598
- };
599
-
600
- await expect(backlog.drainBacklog({ now: Date.now(), deps })).resolves.toBeDefined();
601
- const summary = await backlog.drainBacklog({ now: Date.now(), deps });
602
- expect(summary.projectsScanned).toBe(1);
603
- expect(summary.filesScanned).toBe(0); // readdirSync throws -> no files found, no throw
604
- });
605
-
606
- // ─── lastRunSummary (Settings inspector, PRD 1142) ──────────────────────
607
-
608
- test('lastRunSummary() is null before any drain, then reflects the most recent drainBacklog() call including watermarksRewound', async () => {
609
- const home = await mkHome();
610
- const project = await mkProject('last-run-summary');
611
- const { telemetryClient, config } = freshTelemetry(home);
612
- telemetryClient._setFetchImpl(okAlways());
613
- const backlog = reloadBacklog();
614
- expect(backlog.lastRunSummary()).toBeNull();
615
-
616
- writeErrorsFile(project, recentDateStr(), [errLine(1), errLine(2)]);
617
- const deps = makeDeps({ home, telemetryClient, config, tabCwds: [project] });
618
- const summary = await backlog.drainBacklog({ now: Date.now(), deps, reason: 'boot' });
619
-
620
- const last = backlog.lastRunSummary();
621
- expect(last).not.toBeNull();
622
- expect(last.reason).toBe('boot');
623
- expect(last.linesEnqueued).toBe(summary.linesEnqueued);
624
- expect(last.watermarksRewound).toBe(summary.watermarksRewound);
625
- expect(typeof last.ranAt).toBe('string');
626
- });