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,302 +0,0 @@
1
- /**
2
- * dod-drain-hook.test.cjs — drives the DoD drain handler.
3
- *
4
- * Run: timeout 300 npx vitest run src/main/__tests__/dod-drain-hook.test.cjs
5
- *
6
- * Scenarios:
7
- * 1. Drain with completed jobs → writes report once.
8
- * 2. Second drain over same completed set → no-op (idempotent).
9
- * 3. SM_DOD_DISABLE=1 → no report.
10
- * 4. state.paused set → no report.
11
- * 5. cancelToken.cancelled = true → no report.
12
- */
13
-
14
- 'use strict';
15
-
16
- import { test, beforeEach, afterEach } from 'vitest';
17
- const assert = require('node:assert/strict');
18
- const os = require('node:os');
19
- const fs = require('node:fs');
20
- const path = require('node:path');
21
- const { runDefinitionOfDoneOnDrain } = require('../lib/dodDrainHook.cjs');
22
- const { readWatermark } = require('../lib/definitionOfDone.cjs');
23
-
24
- // ─── helpers ──────────────────────────────────────────────────────────────────
25
-
26
- function makeTmpDir() {
27
- return fs.mkdtempSync(path.join(os.tmpdir(), 'dod-drain-hook-test-'));
28
- }
29
-
30
- function rmdir(dir) {
31
- try { fs.rmSync(dir, { recursive: true, force: true }); } catch { /* */ }
32
- }
33
-
34
- /** Write a minimal PRD and return a completed-job record. */
35
- function writePrd(prdsDir, slug, cwd) {
36
- const body = [
37
- '---',
38
- `title: ${slug}`,
39
- `cwd: ${cwd}`,
40
- 'estimateMinutes: 5',
41
- '---',
42
- '',
43
- '# Goal',
44
- '',
45
- 'Test fixture.',
46
- '',
47
- '# Acceptance criteria',
48
- '',
49
- '- [ ] `timeout 10 node -e "process.exit(0)"` passes.',
50
- '',
51
- '# Out of scope',
52
- '',
53
- '- N/A',
54
- ].join('\n');
55
- fs.writeFileSync(path.join(prdsDir, `${slug}.md`), body);
56
- return { slug, cwd, status: 'completed', runId: '2026-06-14T00-00-00-000Z' };
57
- }
58
-
59
- /** Count DoD report files under runsDir (shallow scan). */
60
- function countReports(runsDir) {
61
- let count = 0;
62
- try {
63
- for (const entry of fs.readdirSync(runsDir, { withFileTypes: true })) {
64
- if (!entry.isDirectory()) continue;
65
- const dir = path.join(runsDir, entry.name);
66
- for (const f of fs.readdirSync(dir)) {
67
- if (f.startsWith('definition-of-done-')) count++;
68
- }
69
- }
70
- } catch { /* runsDir may not exist */ }
71
- return count;
72
- }
73
-
74
- // ─── tests ────────────────────────────────────────────────────────────────────
75
-
76
- test('drain with completed jobs writes exactly one report', async () => {
77
- const tmpDir = makeTmpDir();
78
- const prdsDir = path.join(tmpDir, 'prds');
79
- const runsDir = path.join(tmpDir, 'runs');
80
- const cwd = path.join(tmpDir, 'project');
81
- fs.mkdirSync(prdsDir);
82
- fs.mkdirSync(cwd);
83
-
84
- const job = writePrd(prdsDir, '101-test', cwd);
85
- const state = { paused: null, jobs: [job] };
86
- const cancelToken = { cancelled: false };
87
- const savedDisable = process.env.SM_DOD_DISABLE;
88
- delete process.env.SM_DOD_DISABLE;
89
-
90
- try {
91
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
92
- assert.strictEqual(countReports(runsDir), 1);
93
- } finally {
94
- if (savedDisable !== undefined) process.env.SM_DOD_DISABLE = savedDisable;
95
- rmdir(tmpDir);
96
- }
97
- });
98
-
99
- test('second drain over same completed set is a no-op (idempotent)', async () => {
100
- const tmpDir = makeTmpDir();
101
- const prdsDir = path.join(tmpDir, 'prds');
102
- const runsDir = path.join(tmpDir, 'runs');
103
- const cwd = path.join(tmpDir, 'project');
104
- fs.mkdirSync(prdsDir);
105
- fs.mkdirSync(cwd);
106
-
107
- const job = writePrd(prdsDir, '102-test', cwd);
108
- const state = { paused: null, jobs: [job] };
109
- const cancelToken = { cancelled: false };
110
- const savedDisable = process.env.SM_DOD_DISABLE;
111
- delete process.env.SM_DOD_DISABLE;
112
-
113
- try {
114
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
115
- const afterFirst = countReports(runsDir);
116
- assert.strictEqual(afterFirst, 1, 'first call must write one report');
117
-
118
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
119
- const afterSecond = countReports(runsDir);
120
- assert.strictEqual(afterSecond, 1, 'second call with same jobs must be no-op');
121
- } finally {
122
- if (savedDisable !== undefined) process.env.SM_DOD_DISABLE = savedDisable;
123
- rmdir(tmpDir);
124
- }
125
- });
126
-
127
- test('SM_DOD_DISABLE=1 → no report written', async () => {
128
- const tmpDir = makeTmpDir();
129
- const prdsDir = path.join(tmpDir, 'prds');
130
- const runsDir = path.join(tmpDir, 'runs');
131
- const cwd = path.join(tmpDir, 'project');
132
- fs.mkdirSync(prdsDir);
133
- fs.mkdirSync(cwd);
134
-
135
- writePrd(prdsDir, '103-test', cwd);
136
- const job = { slug: '103-test', cwd, status: 'completed', runId: '2026-06-14T00-00-00-001Z' };
137
- const state = { paused: null, jobs: [job] };
138
- const cancelToken = { cancelled: false };
139
- const savedDisable = process.env.SM_DOD_DISABLE;
140
- process.env.SM_DOD_DISABLE = '1';
141
-
142
- try {
143
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
144
- assert.strictEqual(countReports(runsDir), 0, 'SM_DOD_DISABLE=1 must suppress the report');
145
- } finally {
146
- if (savedDisable !== undefined) process.env.SM_DOD_DISABLE = savedDisable;
147
- else delete process.env.SM_DOD_DISABLE;
148
- rmdir(tmpDir);
149
- }
150
- });
151
-
152
- test('paused state → no report written', async () => {
153
- const tmpDir = makeTmpDir();
154
- const prdsDir = path.join(tmpDir, 'prds');
155
- const runsDir = path.join(tmpDir, 'runs');
156
- const cwd = path.join(tmpDir, 'project');
157
- fs.mkdirSync(prdsDir);
158
- fs.mkdirSync(cwd);
159
-
160
- writePrd(prdsDir, '104-test', cwd);
161
- const job = { slug: '104-test', cwd, status: 'completed', runId: '2026-06-14T00-00-00-002Z' };
162
- const state = { paused: { reason: 'rate_limit', since: new Date().toISOString(), resumeAt: null }, jobs: [job] };
163
- const cancelToken = { cancelled: false };
164
- const savedDisable = process.env.SM_DOD_DISABLE;
165
- delete process.env.SM_DOD_DISABLE;
166
-
167
- try {
168
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
169
- assert.strictEqual(countReports(runsDir), 0, 'paused state must suppress the report');
170
- } finally {
171
- if (savedDisable !== undefined) process.env.SM_DOD_DISABLE = savedDisable;
172
- rmdir(tmpDir);
173
- }
174
- });
175
-
176
- test('first-ever drain (no watermark file) processes all completed jobs', async () => {
177
- const tmpDir = makeTmpDir();
178
- const prdsDir = path.join(tmpDir, 'prds');
179
- const runsDir = path.join(tmpDir, 'runs');
180
- const cwd = path.join(tmpDir, 'project');
181
- fs.mkdirSync(prdsDir);
182
- fs.mkdirSync(cwd);
183
-
184
- const jobA = writePrd(prdsDir, '106-old', cwd);
185
- jobA.finishedAt = '2020-01-01T00:00:00.000Z';
186
- const jobB = writePrd(prdsDir, '107-new', cwd);
187
- jobB.finishedAt = '2026-07-11T00:00:00.000Z';
188
- const state = { paused: null, jobs: [jobA, jobB] };
189
- const cancelToken = { cancelled: false };
190
- const savedDisable = process.env.SM_DOD_DISABLE;
191
- delete process.env.SM_DOD_DISABLE;
192
-
193
- try {
194
- assert.strictEqual(readWatermark(runsDir), null, 'no watermark should exist yet');
195
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
196
- assert.strictEqual(countReports(runsDir), 1);
197
-
198
- const reportsRoot = fs.readdirSync(runsDir, { withFileTypes: true }).filter(e => e.isDirectory());
199
- const reportFile = reportsRoot
200
- .map(e => path.join(runsDir, e.name))
201
- .flatMap(dir => fs.readdirSync(dir).filter(f => f.startsWith('definition-of-done-')).map(f => path.join(dir, f)))[0];
202
- const contents = fs.readFileSync(reportFile, 'utf8');
203
- assert.match(contents, /106-old/, 'first-ever drain must include old job too');
204
- assert.match(contents, /107-new/);
205
- } finally {
206
- if (savedDisable !== undefined) process.env.SM_DOD_DISABLE = savedDisable;
207
- rmdir(tmpDir);
208
- }
209
- });
210
-
211
- test('subsequent drain with a persisted watermark only reverifies newer jobs', async () => {
212
- const tmpDir = makeTmpDir();
213
- const prdsDir = path.join(tmpDir, 'prds');
214
- const runsDir = path.join(tmpDir, 'runs');
215
- const cwd = path.join(tmpDir, 'project');
216
- fs.mkdirSync(prdsDir);
217
- fs.mkdirSync(cwd);
218
- fs.mkdirSync(runsDir, { recursive: true });
219
- fs.writeFileSync(
220
- path.join(runsDir, '.dod-watermark.json'),
221
- JSON.stringify({ lastFinishedAt: '2026-01-01T00:00:00.000Z' })
222
- );
223
-
224
- const jobOld = writePrd(prdsDir, '108-old', cwd);
225
- jobOld.finishedAt = '2025-01-01T00:00:00.000Z';
226
- const jobNew = writePrd(prdsDir, '109-new', cwd);
227
- jobNew.finishedAt = '2026-07-11T00:00:00.000Z';
228
- const state = { paused: null, jobs: [jobOld, jobNew] };
229
- const cancelToken = { cancelled: false };
230
- const savedDisable = process.env.SM_DOD_DISABLE;
231
- delete process.env.SM_DOD_DISABLE;
232
-
233
- try {
234
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
235
- assert.strictEqual(countReports(runsDir), 1);
236
-
237
- const reportsRoot = fs.readdirSync(runsDir, { withFileTypes: true }).filter(e => e.isDirectory());
238
- const reportFile = reportsRoot
239
- .map(e => path.join(runsDir, e.name))
240
- .flatMap(dir => fs.readdirSync(dir).filter(f => f.startsWith('definition-of-done-')).map(f => path.join(dir, f)))[0];
241
- const contents = fs.readFileSync(reportFile, 'utf8');
242
- assert.doesNotMatch(contents, /108-old/, 'jobs finished before the watermark must be excluded');
243
- assert.match(contents, /109-new/, 'jobs finished after the watermark must be included');
244
- } finally {
245
- if (savedDisable !== undefined) process.env.SM_DOD_DISABLE = savedDisable;
246
- rmdir(tmpDir);
247
- }
248
- });
249
-
250
- test('watermark advances after a report so a repeat drain over the same jobs is a no-op', async () => {
251
- const tmpDir = makeTmpDir();
252
- const prdsDir = path.join(tmpDir, 'prds');
253
- const runsDir = path.join(tmpDir, 'runs');
254
- const cwd = path.join(tmpDir, 'project');
255
- fs.mkdirSync(prdsDir);
256
- fs.mkdirSync(cwd);
257
-
258
- const job = writePrd(prdsDir, '110-test', cwd);
259
- job.finishedAt = '2026-07-11T00:00:00.000Z';
260
- const state = { paused: null, jobs: [job] };
261
- const cancelToken = { cancelled: false };
262
- const savedDisable = process.env.SM_DOD_DISABLE;
263
- delete process.env.SM_DOD_DISABLE;
264
-
265
- try {
266
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
267
- assert.strictEqual(countReports(runsDir), 1, 'first drain writes one report');
268
- assert.strictEqual(readWatermark(runsDir), job.finishedAt, 'watermark must advance to the covered job\'s finishedAt');
269
-
270
- // Second drain with a fresh job list containing the same already-covered job.
271
- const state2 = { paused: null, jobs: [{ ...job }] };
272
- await runDefinitionOfDoneOnDrain(state2, { cancelToken, prdsDir, runsDir });
273
- assert.strictEqual(countReports(runsDir), 1, 'repeat drain over the same (now-old) job must be a no-op');
274
- } finally {
275
- if (savedDisable !== undefined) process.env.SM_DOD_DISABLE = savedDisable;
276
- rmdir(tmpDir);
277
- }
278
- });
279
-
280
- test('cancelToken.cancelled=true → no report written', async () => {
281
- const tmpDir = makeTmpDir();
282
- const prdsDir = path.join(tmpDir, 'prds');
283
- const runsDir = path.join(tmpDir, 'runs');
284
- const cwd = path.join(tmpDir, 'project');
285
- fs.mkdirSync(prdsDir);
286
- fs.mkdirSync(cwd);
287
-
288
- writePrd(prdsDir, '105-test', cwd);
289
- const job = { slug: '105-test', cwd, status: 'completed', runId: '2026-06-14T00-00-00-003Z' };
290
- const state = { paused: null, jobs: [job] };
291
- const cancelToken = { cancelled: true };
292
- const savedDisable = process.env.SM_DOD_DISABLE;
293
- delete process.env.SM_DOD_DISABLE;
294
-
295
- try {
296
- await runDefinitionOfDoneOnDrain(state, { cancelToken, prdsDir, runsDir });
297
- assert.strictEqual(countReports(runsDir), 0, 'cancelled token must suppress the report');
298
- } finally {
299
- if (savedDisable !== undefined) process.env.SM_DOD_DISABLE = savedDisable;
300
- rmdir(tmpDir);
301
- }
302
- });
@@ -1,304 +0,0 @@
1
- /**
2
- * dod-report.test.cjs — unit tests for flagRiskySurfaces + writeReport.
3
- *
4
- * Run: timeout 300 npx vitest run src/main/__tests__/dod-report.test.cjs
5
- *
6
- * Fixtures: os.tmpdir() only — never writes into real runs/.
7
- */
8
-
9
- 'use strict';
10
-
11
- import { test } from 'vitest';
12
- const assert = require('node:assert/strict');
13
- const os = require('node:os');
14
- const fs = require('node:fs');
15
- const path = require('node:path');
16
- const { flagRiskySurfaces, writeReport } = require('../lib/definitionOfDone.cjs');
17
-
18
- // ─── helpers ──────────────────────────────────────────────────────────────────
19
-
20
- function makeTmpDir() {
21
- return fs.mkdtempSync(path.join(os.tmpdir(), 'dod-report-test-'));
22
- }
23
-
24
- function rmdir(dir) {
25
- try { fs.rmSync(dir, { recursive: true, force: true }); } catch { /* */ }
26
- }
27
-
28
- function writePrd(prdsDir, slug, implNotes, cwd) {
29
- const body = [
30
- '---',
31
- `title: ${slug}`,
32
- `cwd: ${cwd}`,
33
- 'estimateMinutes: 5',
34
- '---',
35
- '',
36
- '# Goal',
37
- '',
38
- 'Test fixture.',
39
- '',
40
- '# Acceptance criteria',
41
- '',
42
- '- [ ] `timeout 10 node -e "process.exit(0)"` passes.',
43
- '',
44
- '# Implementation notes',
45
- '',
46
- implNotes,
47
- '',
48
- '# Out of scope',
49
- '',
50
- '- N/A',
51
- ].join('\n');
52
- fs.writeFileSync(path.join(prdsDir, `${slug}.md`), body);
53
- return { slug, cwd };
54
- }
55
-
56
- // ─── flagRiskySurfaces: money-path ────────────────────────────────────────────
57
-
58
- test('flagRiskySurfaces: flags money-path when impl notes reference payment', () => {
59
- const tmpDir = makeTmpDir();
60
- const prdsDir = path.join(tmpDir, 'prds');
61
- const cwd = path.join(tmpDir, 'project');
62
- fs.mkdirSync(prdsDir);
63
- fs.mkdirSync(cwd);
64
- const job = writePrd(prdsDir, '201-billing', '- Edit `src/payment-processor.js`\n- Update order schema', cwd);
65
- try {
66
- const flags = flagRiskySurfaces([job], { prdsDir });
67
- assert.strictEqual(flags.length, 1);
68
- assert.strictEqual(flags[0].slug, '201-billing');
69
- assert.ok(flags[0].surfaces.includes('money-path'), `expected money-path in ${JSON.stringify(flags[0].surfaces)}`);
70
- } finally {
71
- rmdir(tmpDir);
72
- }
73
- });
74
-
75
- test('flagRiskySurfaces: flags auth when impl notes reference auth/token', () => {
76
- const tmpDir = makeTmpDir();
77
- const prdsDir = path.join(tmpDir, 'prds');
78
- const cwd = path.join(tmpDir, 'project');
79
- fs.mkdirSync(prdsDir);
80
- fs.mkdirSync(cwd);
81
- const job = writePrd(prdsDir, '202-auth', '- Modify `src/auth-middleware.py`\n- Update token refresh logic', cwd);
82
- try {
83
- const flags = flagRiskySurfaces([job], { prdsDir });
84
- assert.strictEqual(flags.length, 1);
85
- assert.ok(flags[0].surfaces.includes('auth'));
86
- } finally {
87
- rmdir(tmpDir);
88
- }
89
- });
90
-
91
- test('flagRiskySurfaces: flags migration when impl notes reference .sql file', () => {
92
- const tmpDir = makeTmpDir();
93
- const prdsDir = path.join(tmpDir, 'prds');
94
- const cwd = path.join(tmpDir, 'project');
95
- fs.mkdirSync(prdsDir);
96
- fs.mkdirSync(cwd);
97
- const job = writePrd(prdsDir, '203-schema', '- Run `db/migrations/0042_users.sql`', cwd);
98
- try {
99
- const flags = flagRiskySurfaces([job], { prdsDir });
100
- assert.strictEqual(flags.length, 1);
101
- assert.ok(flags[0].surfaces.includes('migration'));
102
- } finally {
103
- rmdir(tmpDir);
104
- }
105
- });
106
-
107
- test('flagRiskySurfaces: clean job is not returned', () => {
108
- const tmpDir = makeTmpDir();
109
- const prdsDir = path.join(tmpDir, 'prds');
110
- const cwd = path.join(tmpDir, 'project');
111
- fs.mkdirSync(prdsDir);
112
- fs.mkdirSync(cwd);
113
- const job = writePrd(prdsDir, '204-clean', '- Update `src/ui/button.tsx`\n- Add tooltip component', cwd);
114
- try {
115
- const flags = flagRiskySurfaces([job], { prdsDir });
116
- assert.strictEqual(flags.length, 0);
117
- } finally {
118
- rmdir(tmpDir);
119
- }
120
- });
121
-
122
- test('flagRiskySurfaces: job with no PRD file is skipped (not thrown)', () => {
123
- const tmpDir = makeTmpDir();
124
- const prdsDir = path.join(tmpDir, 'prds');
125
- const cwd = path.join(tmpDir, 'project');
126
- fs.mkdirSync(prdsDir);
127
- fs.mkdirSync(cwd);
128
- try {
129
- const flags = flagRiskySurfaces([{ slug: '205-missing', cwd }], { prdsDir });
130
- assert.strictEqual(flags.length, 0);
131
- } finally {
132
- rmdir(tmpDir);
133
- }
134
- });
135
-
136
- test('flagRiskySurfaces: mixed batch returns only risky jobs', () => {
137
- const tmpDir = makeTmpDir();
138
- const prdsDir = path.join(tmpDir, 'prds');
139
- const cwd = path.join(tmpDir, 'project');
140
- fs.mkdirSync(prdsDir);
141
- fs.mkdirSync(cwd);
142
- const jobRisky = writePrd(prdsDir, '206-risky', '- Modify `src/trade-engine.js`', cwd);
143
- const jobClean = writePrd(prdsDir, '207-clean', '- Update `src/tooltip.tsx`', cwd);
144
- try {
145
- const flags = flagRiskySurfaces([jobRisky, jobClean], { prdsDir });
146
- assert.strictEqual(flags.length, 1);
147
- assert.strictEqual(flags[0].slug, '206-risky');
148
- } finally {
149
- rmdir(tmpDir);
150
- }
151
- });
152
-
153
- // ─── writeReport: structure ────────────────────────────────────────────────────
154
-
155
- test('writeReport: all three jobs appear in AC table', () => {
156
- const tmpDir = makeTmpDir();
157
- const runsDir = path.join(tmpDir, 'runs');
158
- const acResults = [
159
- { slug: '101-pass', status: 'pass', code: 0, ms: 500 },
160
- { slug: '102-fail', status: 'fail', code: 1, ms: 300 },
161
- { slug: '103-risky', status: 'pass', code: 0, ms: 400 },
162
- ];
163
- const riskFlags = [{ slug: '103-risky', surfaces: ['money-path'] }];
164
- try {
165
- const reportPath = writeReport('abcd1234', { acResults, riskFlags, runsDir });
166
- assert.ok(fs.existsSync(reportPath), `report missing at ${reportPath}`);
167
- const content = fs.readFileSync(reportPath, 'utf8');
168
- assert.ok(content.includes('101-pass'), 'missing 101-pass in table');
169
- assert.ok(content.includes('102-fail'), 'missing 102-fail in table');
170
- assert.ok(content.includes('103-risky'), 'missing 103-risky in table');
171
- } finally {
172
- rmdir(tmpDir);
173
- }
174
- });
175
-
176
- test('writeReport: fail and risky slug both appear in needs-attention list', () => {
177
- const tmpDir = makeTmpDir();
178
- const runsDir = path.join(tmpDir, 'runs');
179
- const acResults = [
180
- { slug: '101-pass', status: 'pass', code: 0, ms: 500 },
181
- { slug: '102-fail', status: 'fail', code: 1, ms: 300 },
182
- { slug: '103-risky', status: 'pass', code: 0, ms: 400 },
183
- ];
184
- const riskFlags = [{ slug: '103-risky', surfaces: ['money-path'] }];
185
- try {
186
- const reportPath = writeReport('abcd1234', { acResults, riskFlags, runsDir });
187
- const content = fs.readFileSync(reportPath, 'utf8');
188
- // Both should appear in the Needs Human Attention section
189
- const attentionIdx = content.indexOf('## Needs Human Attention');
190
- assert.ok(attentionIdx !== -1, 'missing Needs Human Attention section');
191
- const attentionSection = content.slice(attentionIdx);
192
- assert.ok(attentionSection.includes('102-fail'), '102-fail missing from attention list');
193
- assert.ok(attentionSection.includes('103-risky'), '103-risky missing from attention list');
194
- // Clean pass should NOT be in attention list
195
- const passInAttention = attentionSection.includes('101-pass');
196
- assert.ok(!passInAttention, '101-pass should not appear in attention list');
197
- } finally {
198
- rmdir(tmpDir);
199
- }
200
- });
201
-
202
- test('writeReport: report states review is recommended, not auto-run', () => {
203
- const tmpDir = makeTmpDir();
204
- const runsDir = path.join(tmpDir, 'runs');
205
- try {
206
- const reportPath = writeReport('abcd1234', { acResults: [], riskFlags: [], runsDir });
207
- const content = fs.readFileSync(reportPath, 'utf8');
208
- assert.ok(
209
- content.toLowerCase().includes('recommended') && content.toLowerCase().includes('not auto-run'),
210
- 'report must state review is recommended, not auto-run'
211
- );
212
- } finally {
213
- rmdir(tmpDir);
214
- }
215
- });
216
-
217
- test('writeReport: no .tmp files left after write', () => {
218
- const tmpDir = makeTmpDir();
219
- const runsDir = path.join(tmpDir, 'runs');
220
- const acResults = [{ slug: '101-pass', status: 'pass', code: 0, ms: 100 }];
221
- try {
222
- writeReport('deadbeef', { acResults, riskFlags: [], runsDir });
223
- // Walk all files in runsDir recursively, check none end in .tmp-*
224
- function findTmps(dir) {
225
- const hits = [];
226
- try {
227
- for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
228
- const full = path.join(dir, e.name);
229
- if (e.isDirectory()) hits.push(...findTmps(full));
230
- else if (e.name.includes('.tmp-')) hits.push(full);
231
- }
232
- } catch { /* */ }
233
- return hits;
234
- }
235
- const tmps = findTmps(runsDir);
236
- assert.deepStrictEqual(tmps, [], `found leftover tmp files: ${tmps.join(', ')}`);
237
- } finally {
238
- rmdir(tmpDir);
239
- }
240
- });
241
-
242
- test('writeReport: second call with same batchKey produces clean report, no tmp files', () => {
243
- const tmpDir = makeTmpDir();
244
- const runsDir = path.join(tmpDir, 'runs');
245
- const acResults = [
246
- { slug: '101-pass', status: 'pass', code: 0, ms: 100 },
247
- { slug: '102-fail', status: 'fail', code: 1, ms: 200 },
248
- ];
249
- const riskFlags = [{ slug: '101-pass', surfaces: ['auth'] }];
250
- try {
251
- writeReport('cafebabe', { acResults, riskFlags, runsDir });
252
- // Small delay to guarantee different timestamp dir
253
- const t = Date.now() + 2;
254
- while (Date.now() < t) { /* busy wait 2ms */ }
255
- const report2 = writeReport('cafebabe', { acResults, riskFlags, runsDir });
256
-
257
- // Second report must exist and be valid
258
- assert.ok(fs.existsSync(report2));
259
- const content = fs.readFileSync(report2, 'utf8');
260
-
261
- // No duplicate rows in the AC table — slice only the AC table section.
262
- const acStart = content.indexOf('## AC Results');
263
- const riskStart = content.indexOf('## Risk Flags');
264
- const acSection = content.slice(acStart, riskStart === -1 ? undefined : riskStart);
265
- const passCount = (acSection.match(/101-pass/g) || []).length;
266
- const failCount = (acSection.match(/102-fail/g) || []).length;
267
- assert.strictEqual(passCount, 1, `101-pass appears ${passCount} times in AC table`);
268
- assert.strictEqual(failCount, 1, `102-fail appears ${failCount} times in AC table`);
269
-
270
- // No tmp files anywhere
271
- function findTmps(dir) {
272
- const hits = [];
273
- try {
274
- for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
275
- const full = path.join(dir, e.name);
276
- if (e.isDirectory()) hits.push(...findTmps(full));
277
- else if (e.name.includes('.tmp-')) hits.push(full);
278
- }
279
- } catch { /* */ }
280
- return hits;
281
- }
282
- assert.deepStrictEqual(findTmps(runsDir), []);
283
- } finally {
284
- rmdir(tmpDir);
285
- }
286
- });
287
-
288
- test('writeReport: report filename contains the batchKey', () => {
289
- const tmpDir = makeTmpDir();
290
- const runsDir = path.join(tmpDir, 'runs');
291
- try {
292
- const reportPath = writeReport('feed1234', { acResults: [], riskFlags: [], runsDir });
293
- assert.ok(path.basename(reportPath).includes('feed1234'));
294
- } finally {
295
- rmdir(tmpDir);
296
- }
297
- });
298
-
299
- test('writeReport: invalid batchKey throws', () => {
300
- assert.throws(
301
- () => writeReport('not-hex!!', { acResults: [], riskFlags: [] }),
302
- /invalid batchKey/
303
- );
304
- });