claude-code-session-manager 0.98.0 → 0.101.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 (441) 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-CXaH2GED.js +1 -0
  5. package/dist/assets/{History-Bfdoywlh.js → History-Cerii-HA.js} +2 -2
  6. package/dist/assets/{Hooks-CKDJjTJV.js → Hooks-aXMb5LDy.js} +3 -3
  7. package/dist/assets/{Library-7akfgy67.js → Library-WrJFKEOJ.js} +1 -1
  8. package/dist/assets/{MarkdownEditor-DDesiqet.js → MarkdownEditor-D1BMCXS7.js} +1 -1
  9. package/dist/assets/{McpServers-D4lZtXof.js → McpServers-Cf0davLd.js} +2 -2
  10. package/dist/assets/{Memory-CeI8G1w5.js → Memory-Dn6NHWPe.js} +6 -6
  11. package/dist/assets/Permissions-CTVuFPjg.js +3 -0
  12. package/dist/assets/{Plugins-P4eCXy_S.js → Plugins-C2TyF8Mn.js} +2 -2
  13. package/dist/assets/ProvenanceBadge-F_jwHSwE.js +1 -0
  14. package/dist/assets/{SaveBar-l9jnEMES.js → SaveBar-DA1KVJST.js} +1 -1
  15. package/dist/assets/Scheduler-Bm6Q_hlu.js +16 -0
  16. package/dist/assets/{ScopeSwitcher-CjJi8ST5.js → ScopeSwitcher-BygZlJca.js} +1 -1
  17. package/dist/assets/Settings-BYCiv5KV.js +3 -0
  18. package/dist/assets/{SkillReferenceGraph-CjbO01Sg.js → SkillReferenceGraph-CcLnl9np.js} +1 -1
  19. package/dist/assets/{Skills-BxZ9_fCR.js → Skills-ChffsdTD.js} +2 -2
  20. package/dist/assets/{SystemPrompt-D8vfFb8b.js → SystemPrompt-dNkfHE_M.js} +1 -1
  21. package/dist/assets/{TagLibrary-2vzUo7YL.js → TagLibrary-jVlEuB0m.js} +1 -1
  22. package/dist/assets/{TiptapBody-B8ZfbK90.js → TiptapBody-6_cdwcP0.js} +1 -1
  23. package/dist/assets/{Toggle-BbW4nGGf.js → Toggle-CVXqGpAP.js} +1 -1
  24. package/dist/assets/ViewTabs-DO1YVbpc.js +1 -0
  25. package/dist/assets/{index-CKH5Uxik.css → index-D89EUizB.css} +1 -1
  26. package/dist/assets/{index-Cd98Q1lD.js → index-DbCQPWWY.js} +747 -752
  27. package/dist/assets/{settingsSchema-IhUfucCF.js → settingsSchema-Wrvn-Yz1.js} +1 -1
  28. package/dist/index.html +2 -2
  29. package/package.json +25 -29
  30. package/plugins/CLAUDE.md +6 -6
  31. package/plugins/session-manager-dev/skills/builder/4-manual/SKILL.md +21 -19
  32. package/plugins/session-manager-dev/skills/builder/SKILL.md +3 -3
  33. package/plugins/session-manager-dev/skills/develop/SKILL.md +254 -510
  34. package/plugins/session-manager-dev/skills/develop/standards.md +17 -22
  35. package/scripts/README.md +3 -11
  36. package/scripts/audit-ops-hygiene.cjs +3 -3
  37. package/scripts/hooks/lib/guard-prd-writes-policy.cjs +1 -1
  38. package/scripts/hooks/lib/guard-self-schedule-policy.cjs +1 -1
  39. package/scripts/mint-epic.cjs +2 -3
  40. package/scripts/scheduler-mcp-server.cjs +64 -7
  41. package/src/main/agentLibrary.cjs +22 -2
  42. package/src/main/build-info.json +4 -4
  43. package/src/main/chatRunner.cjs +4 -3
  44. package/src/main/config.cjs +41 -38
  45. package/src/main/docEdit.cjs +4 -1
  46. package/src/main/files.cjs +2 -5
  47. package/src/main/health.cjs +1 -1
  48. package/src/main/index.cjs +40 -11
  49. package/src/main/ipcSchemas.cjs +35 -34
  50. package/src/main/lib/agentPersonaSchema.cjs +13 -2
  51. package/src/main/lib/atomicFs.cjs +116 -0
  52. package/src/main/lib/branchSweep.cjs +13 -12
  53. package/src/main/lib/buildTarget.cjs +3 -3
  54. package/src/main/lib/builtinMacros.cjs +39 -0
  55. package/src/main/lib/claudeCliCaps.cjs +129 -0
  56. package/src/main/lib/credentials.cjs +2 -4
  57. package/src/main/lib/crossProjectFeedback.cjs +3 -3
  58. package/src/main/lib/cwdClassify.cjs +15 -3
  59. package/src/main/lib/definitionOfDone.cjs +207 -125
  60. package/src/main/lib/dodDrainHook.cjs +11 -5
  61. package/src/main/lib/epicMint.cjs +2 -4
  62. package/src/main/lib/epicStatusMirror.cjs +8 -10
  63. package/src/main/lib/epicWorktreeProjectConfig.cjs +2 -4
  64. package/src/main/lib/gateAuthority.cjs +96 -0
  65. package/src/main/lib/gitExec.cjs +69 -0
  66. package/src/main/lib/gitWorktree.cjs +656 -92
  67. package/src/main/lib/instanceLock.cjs +5 -8
  68. package/src/main/lib/launchFailure.cjs +2 -3
  69. package/src/main/lib/macroLibrary.cjs +480 -0
  70. package/src/main/lib/mcpToolCatalog.cjs +49 -17
  71. package/src/main/lib/needsReviewLedger.cjs +1 -1
  72. package/src/main/lib/opsErrorLog.cjs +11 -1
  73. package/src/main/lib/opsOwnership.cjs +5 -9
  74. package/src/main/lib/pidAlive.cjs +32 -0
  75. package/src/main/lib/prdCreate.cjs +121 -12
  76. package/src/main/lib/prdDisposition.cjs +2 -2
  77. package/src/main/lib/prdGateFiles.cjs +284 -0
  78. package/src/main/lib/prdLocations.cjs +61 -0
  79. package/src/main/lib/prdMigration.cjs +2 -3
  80. package/src/main/lib/prdSizing.cjs +2 -1
  81. package/src/main/lib/projectHomeAdminRoutes.cjs +136 -21
  82. package/src/main/lib/promptSessionSchema.cjs +10 -2
  83. package/src/main/lib/rcaReport.cjs +4 -6
  84. package/src/main/lib/reaperHelpers.cjs +8 -1
  85. package/src/main/lib/reservationExpiry.cjs +6 -1
  86. package/src/main/lib/reviewNotice.cjs +263 -0
  87. package/src/main/lib/runClaudeP.cjs +4 -1
  88. package/src/main/lib/schedulerPaths.cjs +22 -2
  89. package/src/main/lib/sessionSlots.cjs +2 -4
  90. package/src/main/lib/shippedPersonaSeeds.cjs +226 -0
  91. package/src/main/lib/smfileHeaders.cjs +66 -0
  92. package/src/main/lib/timeoutShim.cjs +123 -0
  93. package/src/main/lib/timeoutShimScript.cjs +275 -0
  94. package/src/main/lib/upgradeDrain.cjs +4 -10
  95. package/src/main/lib/watchdogHelpers.cjs +12 -25
  96. package/src/main/lib/workTypeLibrary.cjs +7 -1
  97. package/src/main/projectPages.cjs +43 -13
  98. package/src/main/promptSessionEvents.cjs +37 -13
  99. package/src/main/scheduler.cjs +910 -198
  100. package/src/main/seedAgentPersonas.cjs +279 -24
  101. package/src/main/supervisor.cjs +4 -1
  102. package/src/main/templates/PRD_AUTHORING.md +126 -406
  103. package/src/preload/__tests__/preload-surface.test.cjs +68 -0
  104. package/src/preload/api.d.ts +53 -94
  105. package/src/preload/index.cjs +14 -9
  106. package/src/seed/agents/architect.md +2 -0
  107. package/src/seed/agents/demo-video-builder.md +84 -0
  108. package/src/seed/agents/dev-lead.md +18 -18
  109. package/src/seed/agents/project-home-builder.md +66 -35
  110. package/src/seed/agents/validator.md +10 -4
  111. package/dist/assets/DataModel-DCEgMTjH.js +0 -1
  112. package/dist/assets/HostBilko-CDVHE0hT.js +0 -1
  113. package/dist/assets/Permissions-BGleLja4.js +0 -3
  114. package/dist/assets/ProvenanceBadge-BFczzI1B.js +0 -1
  115. package/dist/assets/Scheduler-C_phpeUS.js +0 -16
  116. package/dist/assets/Settings-BIwZ3FGQ.js +0 -3
  117. package/src/main/__tests__/activeIndexMerge.test.cjs +0 -235
  118. package/src/main/__tests__/agentEffortResolve.test.cjs +0 -117
  119. package/src/main/__tests__/agentLibrary.test.cjs +0 -276
  120. package/src/main/__tests__/agentModelResolve.test.cjs +0 -311
  121. package/src/main/__tests__/agentOverlayWrite.test.cjs +0 -95
  122. package/src/main/__tests__/bilkoHost-deriveSlug.test.cjs +0 -26
  123. package/src/main/__tests__/bilkoHost-integration.test.cjs +0 -118
  124. package/src/main/__tests__/bilkoHostCore.test.cjs +0 -72
  125. package/src/main/__tests__/broadcastCoalescer.test.cjs +0 -122
  126. package/src/main/__tests__/chat-cancel-terminal.test.cjs +0 -120
  127. package/src/main/__tests__/chat-dead-channels.test.cjs +0 -63
  128. package/src/main/__tests__/chat-exit-close-race.test.cjs +0 -146
  129. package/src/main/__tests__/chat-mcp-consent-notice.test.cjs +0 -139
  130. package/src/main/__tests__/chat-preamble-anchors.test.cjs +0 -100
  131. package/src/main/__tests__/chat-queue.test.cjs +0 -97
  132. package/src/main/__tests__/chat-stop-signal.test.cjs +0 -89
  133. package/src/main/__tests__/chatRunner-epic-worktree-execcwd.test.cjs +0 -125
  134. package/src/main/__tests__/chatRunner-session-flag-retry.test.cjs +0 -252
  135. package/src/main/__tests__/classifyPromptTicket.test.cjs +0 -101
  136. package/src/main/__tests__/classifyTranscriptLine.test.cjs +0 -201
  137. package/src/main/__tests__/computeDepHistorySatisfaction.test.cjs +0 -66
  138. package/src/main/__tests__/config-readText-bounded.test.cjs +0 -84
  139. package/src/main/__tests__/configWriteBoundaryOwners.test.cjs +0 -59
  140. package/src/main/__tests__/crossProjectFeedback.test.cjs +0 -334
  141. package/src/main/__tests__/crossProjectFeedbackRoutes.test.cjs +0 -161
  142. package/src/main/__tests__/dep-orphan-archive-health.test.cjs +0 -77
  143. package/src/main/__tests__/develop-skill-failure-modes.test.cjs +0 -70
  144. package/src/main/__tests__/docEdit.test.cjs +0 -244
  145. package/src/main/__tests__/dod-batchkey.test.cjs +0 -183
  146. package/src/main/__tests__/dod-drain-hook.test.cjs +0 -302
  147. package/src/main/__tests__/dod-report.test.cjs +0 -304
  148. package/src/main/__tests__/dod-reverify.test.cjs +0 -285
  149. package/src/main/__tests__/epicContextDigest.test.cjs +0 -174
  150. package/src/main/__tests__/epicMint.test.cjs +0 -332
  151. package/src/main/__tests__/epicMintTelemetryTap.test.cjs +0 -64
  152. package/src/main/__tests__/epicStatusMirror.test.cjs +0 -110
  153. package/src/main/__tests__/epicValidationHook.test.cjs +0 -291
  154. package/src/main/__tests__/exchanges.test.cjs +0 -122
  155. package/src/main/__tests__/exchangesPromptId.test.cjs +0 -61
  156. package/src/main/__tests__/extractJson.test.cjs +0 -51
  157. package/src/main/__tests__/files-reject-credentials.test.cjs +0 -40
  158. package/src/main/__tests__/fixtures/1218-fo-01-move-scripts-lib-into-src-main-lib.log +0 -556
  159. package/src/main/__tests__/flatPrdTickSweep.test.cjs +0 -110
  160. package/src/main/__tests__/health-build-freshness.test.cjs +0 -39
  161. package/src/main/__tests__/health-claude-md-budget.test.cjs +0 -57
  162. package/src/main/__tests__/health-credentials.test.cjs +0 -81
  163. package/src/main/__tests__/health-delegation-chain.test.cjs +0 -124
  164. package/src/main/__tests__/health-per-project-stall.test.cjs +0 -84
  165. package/src/main/__tests__/health-prd-migration.test.cjs +0 -37
  166. package/src/main/__tests__/health-queue-dispatch.test.cjs +0 -135
  167. package/src/main/__tests__/health-starve-escalation.test.cjs +0 -94
  168. package/src/main/__tests__/health-tick-liveness.test.cjs +0 -179
  169. package/src/main/__tests__/health-usage-poller.test.cjs +0 -144
  170. package/src/main/__tests__/health-worktree-cap-blocked.test.cjs +0 -65
  171. package/src/main/__tests__/heapSnapshot.test.cjs +0 -121
  172. package/src/main/__tests__/historyAggregatorIntraday.test.cjs +0 -313
  173. package/src/main/__tests__/historyDashboard.test.cjs +0 -163
  174. package/src/main/__tests__/historyRollup.test.cjs +0 -333
  175. package/src/main/__tests__/intradayRefresh.test.cjs +0 -39
  176. package/src/main/__tests__/ipcSchemas-dependsOn.test.cjs +0 -39
  177. package/src/main/__tests__/kg-augment.test.cjs +0 -195
  178. package/src/main/__tests__/loadGateDetailTick.test.cjs +0 -31
  179. package/src/main/__tests__/machineProfile.test.cjs +0 -152
  180. package/src/main/__tests__/mcpStatus.test.cjs +0 -61
  181. package/src/main/__tests__/memoryAggregate.test.cjs +0 -109
  182. package/src/main/__tests__/memoryStale.test.cjs +0 -88
  183. package/src/main/__tests__/needsReviewLedger.test.cjs +0 -162
  184. package/src/main/__tests__/openExternalApp-spawn-error.test.cjs +0 -25
  185. package/src/main/__tests__/opsErrorLog.test.cjs +0 -109
  186. package/src/main/__tests__/opsErrorLogTelemetryTap.test.cjs +0 -173
  187. package/src/main/__tests__/personaMerge.test.cjs +0 -169
  188. package/src/main/__tests__/planValidator.test.cjs +0 -125
  189. package/src/main/__tests__/pollLoop-dispatch-on-failure.test.cjs +0 -176
  190. package/src/main/__tests__/prd-group-allocator.test.cjs +0 -119
  191. package/src/main/__tests__/prdAdminRouteParity.test.cjs +0 -70
  192. package/src/main/__tests__/prdAdminRoutes.test.cjs +0 -718
  193. package/src/main/__tests__/prdAgentType.test.cjs +0 -103
  194. package/src/main/__tests__/prdAuthoringSeed.test.cjs +0 -39
  195. package/src/main/__tests__/prdCreate.test.cjs +0 -979
  196. package/src/main/__tests__/prdCreateAdoption.test.cjs +0 -205
  197. package/src/main/__tests__/prdCreateDisposition.test.cjs +0 -201
  198. package/src/main/__tests__/prdCreatePlanId.test.cjs +0 -132
  199. package/src/main/__tests__/prdFrontmatterAgentType.test.cjs +0 -117
  200. package/src/main/__tests__/prdFrontmatterDependsOn.test.cjs +0 -136
  201. package/src/main/__tests__/prdFrontmatterDisposition.test.cjs +0 -125
  202. package/src/main/__tests__/prdFrontmatterQuietMachine.test.cjs +0 -108
  203. package/src/main/__tests__/prdLocations.test.cjs +0 -195
  204. package/src/main/__tests__/prdLocationsArchived.test.cjs +0 -201
  205. package/src/main/__tests__/prdMigration.test.cjs +0 -349
  206. package/src/main/__tests__/prdMigrationLegacyAdopt.test.cjs +0 -91
  207. package/src/main/__tests__/prdParserHighWater.test.cjs +0 -74
  208. package/src/main/__tests__/prdParserSourcePromptId.test.cjs +0 -65
  209. package/src/main/__tests__/prdSetDisposition.test.cjs +0 -222
  210. package/src/main/__tests__/prdSizing.test.cjs +0 -106
  211. package/src/main/__tests__/prdSourcePromptIdBackfill.test.cjs +0 -118
  212. package/src/main/__tests__/prdUpdateDependsOn.test.cjs +0 -160
  213. package/src/main/__tests__/proc-role-env.test.cjs +0 -125
  214. package/src/main/__tests__/procname-claude-spawn-sites.test.cjs +0 -304
  215. package/src/main/__tests__/procname-sm-processes.test.cjs +0 -127
  216. package/src/main/__tests__/projectHomeAdminRoutes.test.cjs +0 -177
  217. package/src/main/__tests__/projectPages.test.cjs +0 -137
  218. package/src/main/__tests__/promptSessionEvents.test.cjs +0 -234
  219. package/src/main/__tests__/promptSessionSchema.test.cjs +0 -101
  220. package/src/main/__tests__/promptSessionTranscript.test.cjs +0 -0
  221. package/src/main/__tests__/promptSessionsCreateEpicHandler.test.cjs +0 -159
  222. package/src/main/__tests__/pty-epic-worktree-spawn-cwd.test.cjs +0 -282
  223. package/src/main/__tests__/pty-session-open-telemetry.test.cjs +0 -96
  224. package/src/main/__tests__/pty-write-result.test.cjs +0 -46
  225. package/src/main/__tests__/queue-health-verdict.test.cjs +0 -170
  226. package/src/main/__tests__/queue-starvation-dispatch-driver.test.cjs +0 -286
  227. package/src/main/__tests__/queue-starvation-per-project.test.cjs +0 -147
  228. package/src/main/__tests__/queueHistory.test.cjs +0 -355
  229. package/src/main/__tests__/queueOps-interactive-ac-lint.test.cjs +0 -65
  230. package/src/main/__tests__/queueOpsArchiveDestination.test.cjs +0 -65
  231. package/src/main/__tests__/queueOpsAutoArchive.test.cjs +0 -211
  232. package/src/main/__tests__/rateLimitPollerStreak.test.cjs +0 -128
  233. package/src/main/__tests__/rcaReport.test.cjs +0 -266
  234. package/src/main/__tests__/reconcileFlatPrdSweep.test.cjs +0 -119
  235. package/src/main/__tests__/reconcileTiming.test.cjs +0 -135
  236. package/src/main/__tests__/runLogRetention.test.cjs +0 -489
  237. package/src/main/__tests__/runVerify-atomic-verdicts.test.cjs +0 -26
  238. package/src/main/__tests__/runVerify-blocked-by-foreign-wip.test.cjs +0 -58
  239. package/src/main/__tests__/runVerify-landed-commit-outranks.test.cjs +0 -191
  240. package/src/main/__tests__/runVerify-policy-denial.test.cjs +0 -89
  241. package/src/main/__tests__/runVerify-transcript-commit-evidence.test.cjs +0 -225
  242. package/src/main/__tests__/runVerify.test.cjs +0 -1784
  243. package/src/main/__tests__/scheduleJobSchema.test.cjs +0 -127
  244. package/src/main/__tests__/scheduleJobStatusDrift.test.cjs +0 -65
  245. package/src/main/__tests__/scheduleJobTransitions.test.cjs +0 -277
  246. package/src/main/__tests__/scheduleJobTransitionsGrep.test.cjs +0 -59
  247. package/src/main/__tests__/scheduleJobTransitionsTelemetryTap.test.cjs +0 -72
  248. package/src/main/__tests__/scheduler-admin-routes.test.cjs +0 -199
  249. package/src/main/__tests__/scheduler-adopted-run-supervision.test.cjs +0 -143
  250. package/src/main/__tests__/scheduler-already-satisfied-on-main.test.cjs +0 -105
  251. package/src/main/__tests__/scheduler-archive-completed-prd.test.cjs +0 -102
  252. package/src/main/__tests__/scheduler-archived-twin-guard.test.cjs +0 -155
  253. package/src/main/__tests__/scheduler-autofix-outcome.test.cjs +0 -188
  254. package/src/main/__tests__/scheduler-autofix-select.test.cjs +0 -439
  255. package/src/main/__tests__/scheduler-autopromote.test.cjs +0 -51
  256. package/src/main/__tests__/scheduler-bash-timeout-env.test.cjs +0 -101
  257. package/src/main/__tests__/scheduler-blocked-by-foreign-wip.test.cjs +0 -107
  258. package/src/main/__tests__/scheduler-boot-orphans.test.cjs +0 -153
  259. package/src/main/__tests__/scheduler-broadcast-reconcile.test.cjs +0 -121
  260. package/src/main/__tests__/scheduler-clear-queue-history.test.cjs +0 -134
  261. package/src/main/__tests__/scheduler-commit-guard-noop.test.cjs +0 -244
  262. package/src/main/__tests__/scheduler-committed-in-window.test.cjs +0 -182
  263. package/src/main/__tests__/scheduler-cross-project-batch.test.cjs +0 -43
  264. package/src/main/__tests__/scheduler-default-eligible-heal.test.cjs +0 -168
  265. package/src/main/__tests__/scheduler-dispatch-loop.test.cjs +0 -58
  266. package/src/main/__tests__/scheduler-effective-concurrency.test.cjs +0 -81
  267. package/src/main/__tests__/scheduler-epic-digest.test.cjs +0 -227
  268. package/src/main/__tests__/scheduler-failed-autoreset.test.cjs +0 -121
  269. package/src/main/__tests__/scheduler-finalize-dispatch-guards.test.cjs +0 -229
  270. package/src/main/__tests__/scheduler-find-prd-dir.test.cjs +0 -75
  271. package/src/main/__tests__/scheduler-fix-plan-path.test.cjs +0 -119
  272. package/src/main/__tests__/scheduler-force-tick-outcome.test.cjs +0 -46
  273. package/src/main/__tests__/scheduler-foreign-wip-manifest.test.cjs +0 -78
  274. package/src/main/__tests__/scheduler-gate-shadow.test.cjs +0 -119
  275. package/src/main/__tests__/scheduler-guard-verdict-autoresolve.test.cjs +0 -390
  276. package/src/main/__tests__/scheduler-heal-refusal.test.cjs +0 -61
  277. package/src/main/__tests__/scheduler-heartbeat-payload.test.cjs +0 -80
  278. package/src/main/__tests__/scheduler-inplace-salvage.test.cjs +0 -323
  279. package/src/main/__tests__/scheduler-integration-failure-stamp.test.cjs +0 -41
  280. package/src/main/__tests__/scheduler-investigation-clean-skip.test.cjs +0 -63
  281. package/src/main/__tests__/scheduler-investigation-prompt.test.cjs +0 -123
  282. package/src/main/__tests__/scheduler-job-budget.test.cjs +0 -172
  283. package/src/main/__tests__/scheduler-job-overrun.test.cjs +0 -175
  284. package/src/main/__tests__/scheduler-launch-failure.test.cjs +0 -199
  285. package/src/main/__tests__/scheduler-leftover-fields.test.cjs +0 -52
  286. package/src/main/__tests__/scheduler-leftover-quarantine.test.cjs +0 -199
  287. package/src/main/__tests__/scheduler-looks-done.test.cjs +0 -537
  288. package/src/main/__tests__/scheduler-manual-pause.test.cjs +0 -118
  289. package/src/main/__tests__/scheduler-mechanical-recovery.test.cjs +0 -245
  290. package/src/main/__tests__/scheduler-meta-code-sha.test.cjs +0 -46
  291. package/src/main/__tests__/scheduler-mutate-reentrancy.test.cjs +0 -117
  292. package/src/main/__tests__/scheduler-needs-review-autoresolve.test.cjs +0 -197
  293. package/src/main/__tests__/scheduler-never-stop.test.cjs +0 -157
  294. package/src/main/__tests__/scheduler-no-dead-end-status.test.cjs +0 -152
  295. package/src/main/__tests__/scheduler-no-orphan-run-dir.test.cjs +0 -81
  296. package/src/main/__tests__/scheduler-notify-originating-tab-transcript.test.cjs +0 -87
  297. package/src/main/__tests__/scheduler-notify-originating-tab.test.cjs +0 -343
  298. package/src/main/__tests__/scheduler-periodic-reverify-guard.test.cjs +0 -217
  299. package/src/main/__tests__/scheduler-porcelain-rename.test.cjs +0 -164
  300. package/src/main/__tests__/scheduler-prd-missing-skip.test.cjs +0 -161
  301. package/src/main/__tests__/scheduler-prd-persona-spawn.test.cjs +0 -178
  302. package/src/main/__tests__/scheduler-quarantine-autoresolve.test.cjs +0 -165
  303. package/src/main/__tests__/scheduler-quiet-machine-lease.test.cjs +0 -257
  304. package/src/main/__tests__/scheduler-rate-limit-cooldown-freshness.test.cjs +0 -123
  305. package/src/main/__tests__/scheduler-rate-limit-pause.test.cjs +0 -152
  306. package/src/main/__tests__/scheduler-rate-limit-spin-guard.test.cjs +0 -156
  307. package/src/main/__tests__/scheduler-reap-dead-running-jobs.test.cjs +0 -754
  308. package/src/main/__tests__/scheduler-reaper-helpers-basics.test.cjs +0 -87
  309. package/src/main/__tests__/scheduler-reconcile-cwd-preserve.test.cjs +0 -100
  310. package/src/main/__tests__/scheduler-reconcile-history-backfill.test.cjs +0 -105
  311. package/src/main/__tests__/scheduler-reconcile-invalid-repair.test.cjs +0 -203
  312. package/src/main/__tests__/scheduler-reconcile-quarantine.test.cjs +0 -247
  313. package/src/main/__tests__/scheduler-reset-job-fields-guard.test.cjs +0 -77
  314. package/src/main/__tests__/scheduler-resume-recovery.test.cjs +0 -254
  315. package/src/main/__tests__/scheduler-shard-quarantine.test.cjs +0 -115
  316. package/src/main/__tests__/scheduler-shared-tree-guard.test.cjs +0 -380
  317. package/src/main/__tests__/scheduler-sigterm-commit.test.cjs +0 -43
  318. package/src/main/__tests__/scheduler-stall-per-project.test.cjs +0 -126
  319. package/src/main/__tests__/scheduler-starve-escalation.test.cjs +0 -154
  320. package/src/main/__tests__/scheduler-stranded-autofix-park.test.cjs +0 -252
  321. package/src/main/__tests__/scheduler-stranded-investigation.test.cjs +0 -185
  322. package/src/main/__tests__/scheduler-stuck-failed-escalation.test.cjs +0 -136
  323. package/src/main/__tests__/scheduler-supervisor-record.test.cjs +0 -81
  324. package/src/main/__tests__/scheduler-tick-cancel-token.test.cjs +0 -54
  325. package/src/main/__tests__/scheduler-tick-wedge.test.cjs +0 -172
  326. package/src/main/__tests__/scheduler-transient-failure.test.cjs +0 -141
  327. package/src/main/__tests__/scheduler-unreadable-queue-guard.test.cjs +0 -62
  328. package/src/main/__tests__/scheduler-utilization-hold.test.cjs +0 -89
  329. package/src/main/__tests__/scheduler-verify-prd-path.test.cjs +0 -109
  330. package/src/main/__tests__/scheduler-worktree-cap-defer.test.cjs +0 -234
  331. package/src/main/__tests__/scheduler-worktree-exec-cwd.test.cjs +0 -120
  332. package/src/main/__tests__/scheduler-writeprd-epic-rollback.test.cjs +0 -105
  333. package/src/main/__tests__/schedulerBatchRootBlocker.test.cjs +0 -117
  334. package/src/main/__tests__/schedulerStateSidecarRestore.test.cjs +0 -110
  335. package/src/main/__tests__/seedAgentPersonas.test.cjs +0 -184
  336. package/src/main/__tests__/seedSchedulerMcp.test.cjs +0 -211
  337. package/src/main/__tests__/seedStatus.test.cjs +0 -100
  338. package/src/main/__tests__/seedValidatorPersona.test.cjs +0 -116
  339. package/src/main/__tests__/stop-signal-anchor.test.cjs +0 -75
  340. package/src/main/__tests__/telemetryClient.test.cjs +0 -1055
  341. package/src/main/__tests__/telemetryContract.test.cjs +0 -930
  342. package/src/main/__tests__/telemetrySettings.test.cjs +0 -210
  343. package/src/main/__tests__/transcripts-batch-flush.test.cjs +0 -249
  344. package/src/main/__tests__/transcripts-doFlush-array.test.cjs +0 -124
  345. package/src/main/__tests__/transcripts-paged-reads.test.cjs +0 -241
  346. package/src/main/__tests__/transcripts-worktree-epic-path.test.cjs +0 -154
  347. package/src/main/__tests__/transcriptsUsageFor.test.cjs +0 -206
  348. package/src/main/__tests__/uniquePrdNumbers.test.cjs +0 -153
  349. package/src/main/__tests__/usageSingleFlight.test.cjs +0 -169
  350. package/src/main/__tests__/validationSentinels.test.cjs +0 -84
  351. package/src/main/__tests__/workTypeLibrary.test.cjs +0 -89
  352. package/src/main/bilkoHost.cjs +0 -314
  353. package/src/main/bilkoHostCore.cjs +0 -89
  354. package/src/main/lib/__tests__/active-sessions.test.cjs +0 -251
  355. package/src/main/lib/__tests__/activeIndexRebuild.test.cjs +0 -179
  356. package/src/main/lib/__tests__/agentPersonaSchema.test.cjs +0 -67
  357. package/src/main/lib/__tests__/auditLog.test.cjs +0 -38
  358. package/src/main/lib/__tests__/bootSelfHeal.test.cjs +0 -107
  359. package/src/main/lib/__tests__/branchSweep.test.cjs +0 -164
  360. package/src/main/lib/__tests__/buildIdentity.test.cjs +0 -121
  361. package/src/main/lib/__tests__/buildTarget.test.cjs +0 -52
  362. package/src/main/lib/__tests__/childWithLog.test.cjs +0 -321
  363. package/src/main/lib/__tests__/coldBootPromptSessionsWrite.test.cjs +0 -87
  364. package/src/main/lib/__tests__/crashTelemetry.test.cjs +0 -103
  365. package/src/main/lib/__tests__/credentials-futile-refresh.test.cjs +0 -115
  366. package/src/main/lib/__tests__/cwdClassify.test.cjs +0 -111
  367. package/src/main/lib/__tests__/definitionOfDoneSequence.test.cjs +0 -95
  368. package/src/main/lib/__tests__/delegationReadiness.test.cjs +0 -1175
  369. package/src/main/lib/__tests__/dispatchLoop.test.cjs +0 -63
  370. package/src/main/lib/__tests__/effectiveModelInfo.test.cjs +0 -244
  371. package/src/main/lib/__tests__/ephemeralCwd.test.cjs +0 -91
  372. package/src/main/lib/__tests__/epicDelegationStats.test.cjs +0 -137
  373. package/src/main/lib/__tests__/epicSpawnCwd.test.cjs +0 -283
  374. package/src/main/lib/__tests__/epicSpawnPlan.test.cjs +0 -196
  375. package/src/main/lib/__tests__/epicTranscriptPath.test.cjs +0 -163
  376. package/src/main/lib/__tests__/epicWorktreeBoot.test.cjs +0 -136
  377. package/src/main/lib/__tests__/epicWorktreeMerge.test.cjs +0 -130
  378. package/src/main/lib/__tests__/epicWorktreeMint.test.cjs +0 -117
  379. package/src/main/lib/__tests__/epicWorktreeProjectConfig.test.cjs +0 -137
  380. package/src/main/lib/__tests__/fixChainDepth.test.cjs +0 -40
  381. package/src/main/lib/__tests__/fixtures/204-mercury-steam-horse.log.txt +0 -13
  382. package/src/main/lib/__tests__/fixtures/scheduler-machine.json.corrupt-1789147548 +0 -34
  383. package/src/main/lib/__tests__/gateFixtures.json +0 -20
  384. package/src/main/lib/__tests__/gitCacheBound.test.cjs +0 -69
  385. package/src/main/lib/__tests__/gitWorktree.test.cjs +0 -1478
  386. package/src/main/lib/__tests__/gitWorktreeSalvage.test.cjs +0 -107
  387. package/src/main/lib/__tests__/gitWorktreeSalvageDelta.test.cjs +0 -153
  388. package/src/main/lib/__tests__/guardShims.test.cjs +0 -158
  389. package/src/main/lib/__tests__/importReferences.spec.cjs +0 -56
  390. package/src/main/lib/__tests__/instanceLock.test.cjs +0 -173
  391. package/src/main/lib/__tests__/jobSupervisorRecord.test.cjs +0 -78
  392. package/src/main/lib/__tests__/jobWorktree.test.cjs +0 -199
  393. package/src/main/lib/__tests__/jobWorktreeBootLive.test.cjs +0 -82
  394. package/src/main/lib/__tests__/landedSinceRun.test.cjs +0 -133
  395. package/src/main/lib/__tests__/launchFailure.test.cjs +0 -220
  396. package/src/main/lib/__tests__/loadGate.test.cjs +0 -303
  397. package/src/main/lib/__tests__/localAdminHttp.test.cjs +0 -214
  398. package/src/main/lib/__tests__/loopDelay.test.cjs +0 -68
  399. package/src/main/lib/__tests__/mcpToolCatalog.test.cjs +0 -107
  400. package/src/main/lib/__tests__/modelCatalog.test.cjs +0 -202
  401. package/src/main/lib/__tests__/opsOwnership.test.cjs +0 -113
  402. package/src/main/lib/__tests__/opsRootAbsoluteCwd.test.cjs +0 -328
  403. package/src/main/lib/__tests__/opsRootNestedWrite.test.cjs +0 -51
  404. package/src/main/lib/__tests__/opsRootResolve.test.cjs +0 -149
  405. package/src/main/lib/__tests__/prdDeclaredPaths.test.cjs +0 -82
  406. package/src/main/lib/__tests__/prdDisposition.test.cjs +0 -224
  407. package/src/main/lib/__tests__/procIdentity.test.cjs +0 -119
  408. package/src/main/lib/__tests__/procName.test.cjs +0 -92
  409. package/src/main/lib/__tests__/projectBriefCore.test.cjs +0 -216
  410. package/src/main/lib/__tests__/projectRootResolve.test.cjs +0 -148
  411. package/src/main/lib/__tests__/queueHealth.test.cjs +0 -58
  412. package/src/main/lib/__tests__/queueStoreAtomicWrite.test.cjs +0 -88
  413. package/src/main/lib/__tests__/queueStoreMachineStateRecovery.test.cjs +0 -190
  414. package/src/main/lib/__tests__/quietMachineLease.test.cjs +0 -39
  415. package/src/main/lib/__tests__/rateLimitWindow.test.cjs +0 -88
  416. package/src/main/lib/__tests__/reaperHelpers.test.cjs +0 -577
  417. package/src/main/lib/__tests__/schedulerBatchDepends.test.cjs +0 -312
  418. package/src/main/lib/__tests__/schedulerBatchFairness.test.cjs +0 -213
  419. package/src/main/lib/__tests__/schedulerBatchLaunchHold.test.cjs +0 -125
  420. package/src/main/lib/__tests__/schedulerBatchProjectCap.test.cjs +0 -127
  421. package/src/main/lib/__tests__/schedulerBatchQuietMachine.test.cjs +0 -109
  422. package/src/main/lib/__tests__/schedulerMcpServerHeadlessRefusal.test.cjs +0 -71
  423. package/src/main/lib/__tests__/schedulerMcpServerHelp.test.cjs +0 -216
  424. package/src/main/lib/__tests__/schedulerMcpServerProjectHome.test.cjs +0 -183
  425. package/src/main/lib/__tests__/schedulerPaths.test.cjs +0 -226
  426. package/src/main/lib/__tests__/schedulerPathsWorktree.test.cjs +0 -133
  427. package/src/main/lib/__tests__/schedulerRuntimeState.test.cjs +0 -56
  428. package/src/main/lib/__tests__/sessionSlots.test.cjs +0 -144
  429. package/src/main/lib/__tests__/telemetryBacklog.test.cjs +0 -626
  430. package/src/main/lib/__tests__/telemetryBoot.test.cjs +0 -134
  431. package/src/main/lib/__tests__/telemetryConsent.test.cjs +0 -136
  432. package/src/main/lib/__tests__/telemetryCounters.test.cjs +0 -57
  433. package/src/main/lib/__tests__/telemetryCountersMetadataColumn.test.cjs +0 -98
  434. package/src/main/lib/__tests__/terminalRunOutcome.test.cjs +0 -200
  435. package/src/main/lib/__tests__/toolUseClassify.test.cjs +0 -53
  436. package/src/main/lib/__tests__/updateCheck.test.cjs +0 -63
  437. package/src/main/lib/__tests__/upgradeDrain.test.cjs +0 -130
  438. package/src/main/lib/__tests__/usageCircuit.test.cjs +0 -354
  439. package/src/main/lib/__tests__/watchdog-helpers.test.cjs +0 -441
  440. package/src/main/lib/__tests__/watchdog-relaunch.test.cjs +0 -266
  441. package/src/main/lib/kgExchangePairing.cjs +0 -75
@@ -1,63 +0,0 @@
1
- 'use strict';
2
- import { describe, it, expect, vi } from 'vitest';
3
- const fs = require('node:fs');
4
- const os = require('node:os');
5
- const path = require('node:path');
6
- const { getUpdateStatus, isBehind } = require('../updateCheck.cjs');
7
-
8
- function mk(over = {}) {
9
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'upd-'));
10
- const fetchJson = vi.fn().mockResolvedValue({ latest: '0.91.1' });
11
- const writeJson = vi.fn(async (f, data) => { fs.writeFileSync(f, JSON.stringify(data)); });
12
- const deps = {
13
- app: { getVersion: () => '0.89.0', getPath: () => dir },
14
- env: {}, now: () => 1_000_000, packageName: () => 'pkg-x', fetchJson, writeJson, ...over,
15
- };
16
- return { dir, fetchJson, writeJson, deps, cache: path.join(dir, 'update-check.json') };
17
- }
18
-
19
- describe('getUpdateStatus', () => {
20
- it('fresh fetch populates the cache and reports behind', async () => {
21
- const t = mk();
22
- expect(await getUpdateStatus({ deps: t.deps })).toEqual({ current: '0.89.0', latest: '0.91.1', behind: true });
23
- expect(t.fetchJson).toHaveBeenCalledWith('https://registry.npmjs.org/-/package/pkg-x/dist-tags', 3000);
24
- expect(JSON.parse(fs.readFileSync(t.cache, 'utf8'))).toEqual({ checkedAt: 1_000_000, latest: '0.91.1' });
25
- });
26
- it('cache hit inside 6h makes no network call', async () => {
27
- const t = mk();
28
- fs.writeFileSync(t.cache, JSON.stringify({ checkedAt: 1_000_000 - 1000, latest: '0.91.1' }));
29
- expect((await getUpdateStatus({ deps: t.deps })).behind).toBe(true);
30
- expect(t.fetchJson).not.toHaveBeenCalled();
31
- });
32
- it('expired cache refetches', async () => {
33
- const t = mk({ now: () => 1_000_000 + 6 * 3600_000 + 1 });
34
- fs.writeFileSync(t.cache, JSON.stringify({ checkedAt: 1_000_000, latest: '0.90.0' }));
35
- expect((await getUpdateStatus({ deps: t.deps })).latest).toBe('0.91.1');
36
- expect(t.fetchJson).toHaveBeenCalledTimes(1);
37
- });
38
- it('corrupt cache is a miss', async () => {
39
- const t = mk();
40
- fs.writeFileSync(t.cache, '{nope');
41
- expect((await getUpdateStatus({ deps: t.deps })).latest).toBe('0.91.1');
42
- });
43
- it('offline falls back to latest null', async () => {
44
- const t = mk({ fetchJson: vi.fn().mockRejectedValue(new Error('ENOTFOUND')) });
45
- expect(await getUpdateStatus({ deps: t.deps })).toEqual({ current: '0.89.0', latest: null, behind: false });
46
- });
47
- it('SM_UPDATE_CHECK=0 and E2E short-circuit with no network call', async () => {
48
- for (const env of [{ SM_UPDATE_CHECK: '0' }, { SM_E2E: '1' }]) {
49
- const t = mk({ env });
50
- expect(await getUpdateStatus({ deps: t.deps })).toEqual({ current: '0.89.0', latest: null, behind: false });
51
- expect(t.fetchJson).not.toHaveBeenCalled();
52
- }
53
- });
54
- });
55
-
56
- describe('isBehind', () => {
57
- it('compares numeric triples', () => {
58
- expect(isBehind('0.89.0', '0.91.1')).toBe(true);
59
- expect(isBehind('0.91.1', '0.91.1')).toBe(false);
60
- expect(isBehind('0.100.0', '0.91.1')).toBe(false);
61
- expect(isBehind('0.92.0', '0.91.1')).toBe(false);
62
- });
63
- });
@@ -1,130 +0,0 @@
1
- 'use strict';
2
-
3
- // Run: timeout 120 npx vitest run src/main/lib/__tests__/upgradeDrain.test.cjs
4
-
5
- const assert = require('node:assert/strict');
6
- const fs = require('node:fs');
7
- const os = require('node:os');
8
- const path = require('node:path');
9
- const ud = require('../upgradeDrain.cjs');
10
-
11
- const T0 = Date.parse('2026-09-18T00:00:00Z');
12
- const req = (extra = {}) => ({ reason: 'r', requestedBy: 'u', requestedAt: new Date(T0).toISOString(), ...extra });
13
- const ev = (o) => ud.evaluateDrain({ now: T0 + 1000, ...o }).action;
14
-
15
- function tmp() { return fs.mkdtempSync(path.join(os.tmpdir(), 'upgrade-drain-')); }
16
-
17
- describe('evaluateDrain state machine', () => {
18
- test('no request → none', () => {
19
- assert.equal(ev({ request: null, queueSnapshot: { running: 2 }, drainState: null }), 'none');
20
- });
21
- test('pending request, drain not active → pause (even when idle)', () => {
22
- assert.equal(ev({ request: req(), queueSnapshot: { running: 0, investigating: 0 }, drainState: null }), 'pause');
23
- assert.equal(ev({ request: req(), queueSnapshot: { running: 3 }, drainState: null }), 'pause');
24
- });
25
- test('drain active + running or investigating → wait', () => {
26
- assert.equal(ev({ request: req(), queueSnapshot: { running: 1, investigating: 0 }, drainState: { active: true } }), 'wait');
27
- assert.equal(ev({ request: req(), queueSnapshot: { running: 0, investigating: 1 }, drainState: { active: true } }), 'wait');
28
- });
29
- test('drain active + zero busy → restart', () => {
30
- assert.equal(ev({ request: req(), queueSnapshot: { running: 0, investigating: 0 }, drainState: { active: true } }), 'restart');
31
- });
32
- test('deadline converts to abort, default 4 h', () => {
33
- const now = T0 + ud.DEFAULT_DRAIN_DEADLINE_MS;
34
- assert.equal(ud.DEFAULT_DRAIN_DEADLINE_MS, 4 * 60 * 60_000);
35
- assert.equal(ud.evaluateDrain({ request: req(), queueSnapshot: { running: 1 }, drainState: { active: true }, now }).action, 'abort');
36
- assert.equal(ud.evaluateDrain({ request: req(), queueSnapshot: { running: 1 }, drainState: { active: true }, now: now - 1 }).action, 'wait');
37
- assert.equal(ud.evaluateDrain({ request: req(), queueSnapshot: {}, drainState: { active: true }, now: T0 + 500, deadlineMs: 100 }).action, 'abort');
38
- });
39
- test('completed request → none; stale drain without request → abort', () => {
40
- assert.equal(ev({ request: req({ drainCompletedAt: 'x' }), queueSnapshot: {}, drainState: { active: true } }), 'none');
41
- assert.equal(ev({ request: null, queueSnapshot: {}, drainState: { active: true } }), 'abort');
42
- });
43
- test('a rate-limit pause during a drain does not change the verdict: drain is its own field', () => {
44
- // evaluateDrain never sees state.paused; a rate_limit pause overwriting
45
- // `paused` leaves the drain field (and the verdict) untouched.
46
- const state = { paused: { reason: 'rate_limit' }, drain: { active: true } };
47
- assert.equal(ev({ request: req(), queueSnapshot: { running: 0, investigating: 0 }, drainState: state.drain }), 'restart');
48
- assert.equal(ud.effectivePaused(state).reason, 'rate_limit');
49
- assert.equal(ud.effectivePaused({ paused: null, drain: { active: true } }).reason, 'drain-for-upgrade');
50
- assert.equal(ud.effectivePaused({ paused: null, drain: null }), null);
51
- });
52
- });
53
-
54
- describe('request file lifecycle', () => {
55
- test('requestRestart writes atomically and is idempotent while pending', () => {
56
- const dir = tmp();
57
- try {
58
- const file = path.join(dir, 'restart-request.json');
59
- const a = ud.requestRestart({ reason: 'x', requestedBy: 'user' }, { file, now: T0 });
60
- const b = ud.requestRestart({ reason: 'y', requestedBy: 'auto' }, { file, now: T0 + 5000 });
61
- assert.deepEqual(b, a, 'a second request must not reset the deadline');
62
- assert.deepEqual(fs.readdirSync(dir), ['restart-request.json'], 'no tmp file left behind');
63
- assert.equal(ud.readRestartRequest(file).requestedBy, 'user');
64
- } finally { fs.rmSync(dir, { recursive: true, force: true }); }
65
- });
66
- test('stampDrainCompleted marks it; a new request after completion starts fresh', () => {
67
- const dir = tmp();
68
- try {
69
- const file = path.join(dir, 'restart-request.json');
70
- ud.requestRestart({ reason: 'x', requestedBy: 'u' }, { file, now: T0 });
71
- assert.ok(ud.stampDrainCompleted(T0 + 1, file).drainCompletedAt);
72
- const fresh = ud.requestRestart({ reason: 'again', requestedBy: 'u' }, { file, now: T0 + 9 });
73
- assert.equal(fresh.reason, 'again');
74
- assert.equal(fresh.drainCompletedAt, undefined);
75
- } finally { fs.rmSync(dir, { recursive: true, force: true }); }
76
- });
77
- test('abort retires the request file', () => {
78
- const dir = tmp();
79
- try {
80
- const file = path.join(dir, 'restart-request.json');
81
- ud.requestRestart({ reason: 'x', requestedBy: 'u' }, { file, now: T0 });
82
- ud.retireRestartRequest(file);
83
- assert.equal(ud.readRestartRequest(file), null);
84
- ud.retireRestartRequest(file); // absent → no throw
85
- // With the request gone, a re-evaluation is 'none' — no abort flap.
86
- assert.equal(ev({ request: ud.readRestartRequest(file), queueSnapshot: {}, drainState: null }), 'none');
87
- } finally { fs.rmSync(dir, { recursive: true, force: true }); }
88
- });
89
- });
90
-
91
- describe('boot', () => {
92
- test('clears a leftover drain whose request is complete or gone; keeps a pending one', () => {
93
- assert.equal(ud.bootDrainAction({ drainState: { active: true }, request: req({ drainCompletedAt: 'x' }) }), 'clear');
94
- assert.equal(ud.bootDrainAction({ drainState: { active: true }, request: null }), 'clear');
95
- assert.equal(ud.bootDrainAction({ drainState: { active: true }, request: req() }), 'keep');
96
- assert.equal(ud.bootDrainAction({ drainState: null, request: req() }), 'none');
97
- });
98
- });
99
-
100
- describe('automatic trigger', () => {
101
- test('only when both shas are known and differ — never from npm', () => {
102
- assert.equal(ud.installedBuildDiffers({ running: 'aaa', installed: 'bbb' }), true);
103
- assert.equal(ud.installedBuildDiffers({ running: 'aaa', installed: 'aaa' }), false);
104
- assert.equal(ud.installedBuildDiffers({ running: null, installed: 'bbb' }), false);
105
- assert.equal(ud.installedBuildDiffers({ running: 'aaa', installed: null }), false);
106
- });
107
- });
108
-
109
- describe('queueBusyCount', () => {
110
- test('counts running + investigating only', () => {
111
- const jobs = [{ status: 'running' }, { status: 'investigating' }, { status: 'pending' }, { status: 'needs_review' }];
112
- assert.equal(ud.queueBusyCount(jobs), 2);
113
- assert.equal(ud.queueBusyCount(jobs, 1), 3);
114
- });
115
- });
116
-
117
- describe('restarting marker', () => {
118
- test('active until expiry, then lapses', () => {
119
- const dir = tmp();
120
- try {
121
- const file = path.join(dir, 'restarting.json');
122
- assert.equal(ud.isRestartingMarkerActive({ file, now: T0 }), false);
123
- ud.markRestarting({ file, now: T0, ttlMs: 1000 });
124
- assert.equal(ud.isRestartingMarkerActive({ file, now: T0 + 999 }), true);
125
- assert.equal(ud.isRestartingMarkerActive({ file, now: T0 + 1000 }), false);
126
- ud.clearRestartingMarker(file);
127
- assert.equal(ud.isRestartingMarkerActive({ file, now: T0 }), false);
128
- } finally { fs.rmSync(dir, { recursive: true, force: true }); }
129
- });
130
- });
@@ -1,354 +0,0 @@
1
- /**
2
- * usageCircuit.test.cjs — breaker transitions, jitter bounds, bindingWindow
3
- * fallback, reset freshness, degraded-budget floor/cap, singleFlight dedup.
4
- *
5
- * Run: timeout 300 npx vitest run src/main/lib/__tests__/usageCircuit.test.cjs
6
- */
7
-
8
- 'use strict';
9
-
10
- import { test } from 'vitest';
11
- const assert = require('node:assert/strict');
12
- const {
13
- createUsageCircuit,
14
- backoffWithJitter,
15
- isResetFresh,
16
- bindingWindow,
17
- degradedBudget,
18
- singleFlight,
19
- } = require('../usageCircuit.cjs');
20
-
21
- test('state machine: closed -> open after 3 consecutive failures', () => {
22
- let nowMs = 0;
23
- const circuit = createUsageCircuit({ now: () => nowMs });
24
- assert.strictEqual(circuit.state(), 'closed');
25
- circuit.recordFailure('meter_rate_limited');
26
- assert.strictEqual(circuit.state(), 'closed');
27
- circuit.recordFailure('meter_rate_limited');
28
- assert.strictEqual(circuit.state(), 'closed');
29
- circuit.recordFailure('meter_rate_limited');
30
- assert.strictEqual(circuit.state(), 'open');
31
- });
32
-
33
- test('open -> half_open after the backoff interval elapses, exactly one probe granted', () => {
34
- let nowMs = 0;
35
- const circuit = createUsageCircuit({ now: () => nowMs });
36
- circuit.recordFailure('a');
37
- circuit.recordFailure('a');
38
- circuit.recordFailure('a');
39
- assert.strictEqual(circuit.state(), 'open');
40
-
41
- nowMs += 10_000; // still inside the (>=15s) minimum backoff window
42
- assert.strictEqual(circuit.state(), 'open');
43
-
44
- nowMs += 60 * 60 * 1000; // well past any possible backoff interval
45
- assert.strictEqual(circuit.state(), 'half_open');
46
- // Re-querying before the probe's result is recorded must not grant a second probe.
47
- assert.strictEqual(circuit.state(), 'half_open');
48
- });
49
-
50
- test('half_open -> closed on a successful probe, resetting backoff', () => {
51
- let nowMs = 0;
52
- const circuit = createUsageCircuit({ now: () => nowMs });
53
- circuit.recordFailure('a');
54
- circuit.recordFailure('a');
55
- circuit.recordFailure('a');
56
- nowMs += 60 * 60 * 1000;
57
- assert.strictEqual(circuit.state(), 'half_open');
58
- circuit.recordSuccess({ five_hour: { utilization: 10, resets_at: null } });
59
- assert.strictEqual(circuit.state(), 'closed');
60
- });
61
-
62
- test('half_open -> open on a failed probe, with backoff doubled (probe takes longer to reopen)', () => {
63
- let nowMs = 0;
64
- const circuit = createUsageCircuit({ now: () => nowMs });
65
- circuit.recordFailure('a');
66
- circuit.recordFailure('a');
67
- circuit.recordFailure('a');
68
- nowMs += 60 * 60 * 1000;
69
- assert.strictEqual(circuit.state(), 'half_open');
70
- circuit.recordFailure('a');
71
- assert.strictEqual(circuit.state(), 'open');
72
- nowMs += 25_000; // below the doubled 2nd-stage backoff's own 30s floor
73
- assert.strictEqual(circuit.state(), 'open');
74
- nowMs += 60 * 60 * 1000;
75
- assert.strictEqual(circuit.state(), 'half_open');
76
- });
77
-
78
- test('backoffWithJitter: 1000 samples stay within [0.5x, 1.0x] of the doubled base, floor 30s / cap 8min', () => {
79
- for (let i = 0; i < 1000; i++) {
80
- const first = backoffWithJitter(0);
81
- assert.ok(first >= 15_000 && first <= 30_000, `first=${first}`);
82
-
83
- const second = backoffWithJitter(30_000);
84
- assert.ok(second >= 30_000 && second <= 60_000, `second=${second}`);
85
-
86
- const atCap = backoffWithJitter(8 * 60 * 1000);
87
- assert.ok(atCap >= 4 * 60 * 1000 && atCap <= 8 * 60 * 1000, `atCap=${atCap}`);
88
-
89
- const beyondCap = backoffWithJitter(20 * 60 * 1000); // doubling would exceed the 8min cap
90
- assert.ok(beyondCap >= 4 * 60 * 1000 && beyondCap <= 8 * 60 * 1000, `beyondCap=${beyondCap}`);
91
- }
92
- });
93
-
94
- test('isResetFresh: past -> false, future -> true, null -> false', () => {
95
- const now = Date.parse('2026-09-13T12:00:00Z');
96
- assert.strictEqual(isResetFresh('2026-09-13T11:59:59Z', now), false); // past
97
- assert.strictEqual(isResetFresh('2026-09-13T12:00:00Z', now), false); // at now
98
- assert.strictEqual(isResetFresh('2026-09-13T12:00:01Z', now), true); // future
99
- assert.strictEqual(isResetFresh(null, now), false);
100
- assert.strictEqual(isResetFresh(undefined, now), false);
101
- assert.strictEqual(isResetFresh('not-a-date', now), false);
102
- });
103
-
104
- const REAL_LIMITS = [
105
- { kind: 'session', group: 'session', percent: 6, severity: 'normal', resets_at: '2026-09-22T00:40:00.280514+00:00', scope: null, is_active: false },
106
- { kind: 'weekly_all', group: 'weekly', percent: 64, severity: 'normal', resets_at: '2026-09-24T17:00:00.280532+00:00', scope: null, is_active: true },
107
- { kind: 'weekly_scoped', group: 'weekly', percent: 18, severity: 'normal', resets_at: '2026-09-24T17:00:00.280763+00:00', scope: { model: { id: null, display_name: 'Fable' }, surface: null }, is_active: false },
108
- ];
109
-
110
- test('bindingWindow: verbatim real payload selects weekly_all 64', () => {
111
- const payload = {
112
- five_hour: { utilization: 6, resets_at: '2026-09-22T00:40:00.280514+00:00' },
113
- seven_day: { utilization: 64, resets_at: '2026-09-24T17:00:00.280532+00:00' },
114
- limits: REAL_LIMITS,
115
- };
116
- assert.deepStrictEqual(bindingWindow(payload), {
117
- name: 'weekly_all',
118
- utilization: 64,
119
- resets_at: '2026-09-24T17:00:00.280532+00:00',
120
- });
121
- });
122
-
123
- test('bindingWindow: max percent wins over is_active (session 95 beats weekly_all 64)', () => {
124
- const win = bindingWindow({
125
- limits: [
126
- { kind: 'session', percent: 95, resets_at: '2026-09-22T00:40:00Z', scope: null, is_active: false },
127
- { kind: 'weekly_all', percent: 64, resets_at: '2026-09-24T17:00:00Z', scope: null, is_active: true },
128
- ],
129
- });
130
- assert.strictEqual(win.name, 'session');
131
- assert.strictEqual(win.utilization, 95);
132
- });
133
-
134
- test('bindingWindow: is_active breaks a percent tie', () => {
135
- const win = bindingWindow({
136
- limits: [
137
- { kind: 'session', percent: 50, resets_at: null, scope: null, is_active: false },
138
- { kind: 'weekly_all', percent: 50, resets_at: null, scope: null, is_active: true },
139
- ],
140
- });
141
- assert.strictEqual(win.name, 'weekly_all');
142
- });
143
-
144
- test('bindingWindow: a high weekly_scoped entry is never selected', () => {
145
- const win = bindingWindow({
146
- limits: [
147
- { kind: 'session', percent: 6, resets_at: null, scope: null, is_active: false },
148
- { kind: 'weekly_all', percent: 10, resets_at: null, scope: null, is_active: true },
149
- { kind: 'weekly_scoped', percent: 99, resets_at: null, scope: { model: { display_name: 'Fable' } }, is_active: false },
150
- ],
151
- });
152
- assert.strictEqual(win.name, 'weekly_all');
153
- assert.strictEqual(win.utilization, 10);
154
- });
155
-
156
- test('bindingWindow: percent over 100 is returned raw, not clamped', () => {
157
- const win = bindingWindow({ limits: [{ kind: 'session', percent: 112, resets_at: null, scope: null }] });
158
- assert.strictEqual(win.utilization, 112);
159
- });
160
-
161
- test('bindingWindow: null resets_at backfills from the matching flat window', () => {
162
- const win = bindingWindow({
163
- five_hour: { utilization: 40, resets_at: '2026-09-22T00:40:00Z' },
164
- seven_day: { utilization: 5, resets_at: '2026-09-24T17:00:00Z' },
165
- limits: [
166
- { kind: 'session', percent: 40, resets_at: null, scope: null },
167
- { kind: 'weekly_all', percent: 5, resets_at: null, scope: null },
168
- ],
169
- });
170
- assert.strictEqual(win.name, 'session');
171
- assert.strictEqual(win.resets_at, '2026-09-22T00:40:00Z');
172
- });
173
-
174
- test('bindingWindow: limits[] absent falls back to five_hour', () => {
175
- const payload = { five_hour: { utilization: 42, resets_at: '2026-09-13T15:00:00Z' } };
176
- const win = bindingWindow(payload);
177
- assert.strictEqual(win.name, 'five_hour');
178
- assert.strictEqual(win.utilization, 42);
179
- });
180
-
181
- test('bindingWindow: limits[] with only scoped / non-finite entries falls back to five_hour', () => {
182
- const payload = {
183
- five_hour: { utilization: 12, resets_at: null },
184
- limits: [
185
- { kind: 'weekly_scoped', percent: 81, resets_at: null, scope: { model: { display_name: 'Fable' } } },
186
- { kind: 'session', resets_at: null, scope: null },
187
- ],
188
- };
189
- const win = bindingWindow(payload);
190
- assert.strictEqual(win.name, 'five_hour');
191
- assert.strictEqual(win.utilization, 12);
192
- });
193
-
194
- test('degradedBudget: a last-good binding window that genuinely read 0% carries forward as 0, not 100', () => {
195
- const payload = { five_hour: { utilization: 0, resets_at: null } };
196
- assert.strictEqual(degradedBudget(payload, {}).utilization, 0);
197
- });
198
-
199
- test('degradedBudget: no payload ever received (null/absent) still yields 100, never a blind 0', () => {
200
- assert.strictEqual(degradedBudget(null, {}).utilization, 100);
201
- assert.strictEqual(degradedBudget(undefined, {}).utilization, 100);
202
- });
203
-
204
- test('degradedBudget: a degraded cycle after a real-shape poll carries forward the real percent (64), not 100', () => {
205
- const payload = {
206
- limits: [
207
- { kind: 'session', percent: 6, resets_at: null, scope: null, is_active: false },
208
- { kind: 'weekly_all', percent: 64, resets_at: '2026-09-24T17:00:00Z', scope: null, is_active: true },
209
- ],
210
- };
211
- assert.strictEqual(degradedBudget(payload, {}).utilization, 64);
212
- });
213
-
214
- test('degradedBudget: carries forward the real last-good BINDING (weekly_all) utilization, e.g. 81%, never 0', () => {
215
- const payload = {
216
- five_hour: { utilization: 0, resets_at: null },
217
- limits: [
218
- { kind: 'session', is_active: false, percent: 0, resets_at: null, scope: null },
219
- { kind: 'weekly_all', is_active: true, percent: 81, resets_at: '2026-09-19T00:00:00Z', scope: null },
220
- ],
221
- };
222
- const { utilization } = degradedBudget(payload, {});
223
- assert.strictEqual(utilization, 81);
224
- });
225
-
226
- test('degradedBudget: caps concurrency at 2 regardless of a higher configured cap', () => {
227
- const payload = { five_hour: { utilization: 30, resets_at: null } };
228
- const { concurrencyCap } = degradedBudget(payload, { configuredCap: 5 });
229
- assert.strictEqual(concurrencyCap, 2);
230
- });
231
-
232
- test('degradedBudget: respects a configured cap below 2', () => {
233
- const payload = { five_hour: { utilization: 30, resets_at: null } };
234
- const { concurrencyCap } = degradedBudget(payload, { configuredCap: 1 });
235
- assert.strictEqual(concurrencyCap, 1);
236
- });
237
-
238
- test('degradedBudget: an executor-observed 429 whose window has not passed pins utilization to 100', () => {
239
- const payload = { five_hour: { utilization: 5, resets_at: null } };
240
- const now = Date.parse('2026-09-13T12:00:00Z');
241
- const { utilization } = degradedBudget(payload, {
242
- observed429: true,
243
- resetsAt: '2026-09-13T13:00:00Z', // still in the future
244
- now,
245
- });
246
- assert.strictEqual(utilization, 100);
247
- });
248
-
249
- test('degradedBudget: once the 429 window passes, it stops pinning to 100 and falls back to real utilization', () => {
250
- const payload = { five_hour: { utilization: 5, resets_at: null } };
251
- const now = Date.parse('2026-09-13T12:00:00Z');
252
- const { utilization } = degradedBudget(payload, {
253
- observed429: true,
254
- resetsAt: '2026-09-13T11:00:00Z', // already passed
255
- now,
256
- });
257
- assert.strictEqual(utilization, 5);
258
- });
259
-
260
- test('singleFlight: concurrent callers share the same in-flight promise, fn invoked once', async () => {
261
- let calls = 0;
262
- let resolveFn;
263
- const fn = () => new Promise((resolve) => { resolveFn = resolve; calls += 1; });
264
- const wrapped = singleFlight(fn);
265
-
266
- const p1 = wrapped();
267
- const p2 = wrapped();
268
- assert.strictEqual(p1, p2);
269
- assert.strictEqual(calls, 1);
270
- resolveFn('done');
271
- assert.strictEqual(await p1, 'done');
272
-
273
- const p3 = wrapped();
274
- assert.notStrictEqual(p3, p1);
275
- assert.strictEqual(calls, 2);
276
- resolveFn('done2');
277
- await p3;
278
- });
279
-
280
- test('openedAt: null while closed, stamped the moment it opens, stays stamped through a failed half_open probe, clears on success', () => {
281
- let nowMs = 1000;
282
- const circuit = createUsageCircuit({ now: () => nowMs });
283
- assert.strictEqual(circuit.openedAt(), null);
284
- circuit.recordFailure('a');
285
- circuit.recordFailure('a');
286
- assert.strictEqual(circuit.openedAt(), null); // still closed, 2 of 3
287
- circuit.recordFailure('a');
288
- assert.strictEqual(circuit.state(), 'open');
289
- assert.strictEqual(circuit.openedAt(), 1000);
290
-
291
- nowMs += 60 * 60 * 1000;
292
- assert.strictEqual(circuit.state(), 'half_open');
293
- assert.strictEqual(circuit.openedAt(), 1000); // unchanged through the probe
294
-
295
- circuit.recordFailure('a'); // failed probe -> reopens
296
- assert.strictEqual(circuit.state(), 'open');
297
- assert.strictEqual(circuit.openedAt(), 1000); // still the ORIGINAL open time, not re-stamped
298
-
299
- circuit.recordSuccess({});
300
- assert.strictEqual(circuit.openedAt(), null);
301
- });
302
-
303
- test('getConsecutiveFailures: tracks failures, resets on success', () => {
304
- const circuit = createUsageCircuit({ now: () => 0 });
305
- assert.strictEqual(circuit.getConsecutiveFailures(), 0);
306
- circuit.recordFailure('a');
307
- circuit.recordFailure('a');
308
- assert.strictEqual(circuit.getConsecutiveFailures(), 2);
309
- circuit.recordSuccess({});
310
- assert.strictEqual(circuit.getConsecutiveFailures(), 0);
311
- });
312
-
313
- test('SM_USAGE_CIRCUIT=0 bypasses the breaker entirely: state stays closed no matter how many failures', () => {
314
- const prev = process.env.SM_USAGE_CIRCUIT;
315
- process.env.SM_USAGE_CIRCUIT = '0';
316
- try {
317
- const circuit = createUsageCircuit({ now: () => 0 });
318
- circuit.recordFailure('a');
319
- circuit.recordFailure('a');
320
- circuit.recordFailure('a');
321
- circuit.recordFailure('a');
322
- assert.strictEqual(circuit.state(), 'closed');
323
- assert.strictEqual(circuit.openedAt(), null);
324
- } finally {
325
- if (prev === undefined) delete process.env.SM_USAGE_CIRCUIT; else process.env.SM_USAGE_CIRCUIT = prev;
326
- }
327
- });
328
-
329
- test('SM_USAGE_DEGRADED_CAP overrides degradedBudget concurrencyCap outright, bypassing min(cap, 2)', () => {
330
- const prev = process.env.SM_USAGE_DEGRADED_CAP;
331
- process.env.SM_USAGE_DEGRADED_CAP = '7';
332
- try {
333
- const payload = { five_hour: { utilization: 30, resets_at: null } };
334
- const { concurrencyCap } = degradedBudget(payload, { configuredCap: 2 });
335
- assert.strictEqual(concurrencyCap, 7);
336
- } finally {
337
- if (prev === undefined) delete process.env.SM_USAGE_DEGRADED_CAP; else process.env.SM_USAGE_DEGRADED_CAP = prev;
338
- }
339
- });
340
-
341
- test('singleFlight: de-dupes even when fn rejects, next call gets a fresh attempt', async () => {
342
- let calls = 0;
343
- const fn = () => (calls++ === 0 ? Promise.reject(new Error('boom')) : Promise.resolve('ok'));
344
- const wrapped = singleFlight(fn);
345
-
346
- const p1 = wrapped();
347
- const p2 = wrapped();
348
- assert.strictEqual(p1, p2);
349
- await assert.rejects(p1, /boom/);
350
-
351
- const p3 = wrapped();
352
- assert.strictEqual(await p3, 'ok');
353
- assert.strictEqual(calls, 2);
354
- });