patchwarden 1.5.0 → 1.6.1

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 (597) hide show
  1. package/PatchWarden.cmd +32 -2
  2. package/README.en.md +194 -26
  3. package/README.md +160 -22
  4. package/dist/assessments/agentAssessor.d.ts +1 -1
  5. package/dist/assessments/agentAssessor.js +24 -15
  6. package/dist/assessments/assessmentStore.d.ts +1 -1
  7. package/dist/assessments/assessmentStore.js +44 -36
  8. package/dist/assessments/confirmCli.js +5 -4
  9. package/dist/config.d.ts +22 -0
  10. package/dist/config.js +98 -11
  11. package/dist/control/fileManager.d.ts +2 -0
  12. package/dist/control/fileManager.js +39 -0
  13. package/dist/control/middleware/auth.d.ts +16 -0
  14. package/dist/control/middleware/auth.js +17 -0
  15. package/dist/control/middleware/static.d.ts +3 -0
  16. package/dist/control/middleware/static.js +78 -0
  17. package/dist/control/routeTable.d.ts +24 -0
  18. package/dist/control/routeTable.js +263 -0
  19. package/dist/control/routes/audit.d.ts +15 -0
  20. package/dist/control/routes/audit.js +287 -0
  21. package/dist/control/routes/evidence.d.ts +4 -0
  22. package/dist/control/routes/evidence.js +96 -0
  23. package/dist/control/routes/lineage.d.ts +3 -0
  24. package/dist/control/routes/lineage.js +71 -0
  25. package/dist/control/routes/policy.d.ts +3 -0
  26. package/dist/control/routes/policy.js +81 -0
  27. package/dist/control/routes/process.d.ts +12 -0
  28. package/dist/control/routes/process.js +487 -0
  29. package/dist/control/routes/sessions.d.ts +30 -0
  30. package/dist/control/routes/sessions.js +287 -0
  31. package/dist/control/routes/status.d.ts +51 -0
  32. package/dist/control/routes/status.js +307 -0
  33. package/dist/control/routes/taskActions.d.ts +21 -0
  34. package/dist/control/routes/taskActions.js +197 -0
  35. package/dist/control/routes/tasks.d.ts +24 -0
  36. package/dist/control/routes/tasks.js +309 -0
  37. package/dist/control/routes/workspace.d.ts +15 -0
  38. package/dist/control/routes/workspace.js +220 -0
  39. package/dist/control/runtime.d.ts +92 -0
  40. package/dist/control/runtime.js +425 -0
  41. package/dist/control/server.d.ts +13 -0
  42. package/dist/control/server.js +150 -0
  43. package/dist/control/shared.d.ts +59 -0
  44. package/dist/control/shared.js +341 -0
  45. package/dist/controlCenter.d.ts +6 -0
  46. package/dist/controlCenter.js +7 -2197
  47. package/dist/direct/directAudit.js +234 -225
  48. package/dist/direct/directGuards.d.ts +2 -1
  49. package/dist/direct/directGuards.js +72 -37
  50. package/dist/direct/directPatch.d.ts +6 -1
  51. package/dist/direct/directPatch.js +55 -8
  52. package/dist/direct/directSessionStore.d.ts +16 -6
  53. package/dist/direct/directSessionStore.js +127 -35
  54. package/dist/direct/directVerification.js +8 -16
  55. package/dist/doctor.d.ts +18 -1
  56. package/dist/doctor.js +614 -373
  57. package/dist/goal/acceptanceEngine.d.ts +1 -1
  58. package/dist/goal/goalProgress.js +75 -69
  59. package/dist/goal/goalReport.d.ts +54 -0
  60. package/dist/goal/goalReport.js +197 -0
  61. package/dist/goal/goalStatus.d.ts +8 -0
  62. package/dist/goal/goalStatus.js +10 -3
  63. package/dist/goal/goalStore.d.ts +9 -2
  64. package/dist/goal/goalStore.js +152 -45
  65. package/dist/goal/handoffExport.js +6 -6
  66. package/dist/goal/specKitImport.d.ts +63 -0
  67. package/dist/goal/specKitImport.js +221 -0
  68. package/dist/goal/subgoalSync.js +13 -10
  69. package/dist/goal/worktreeManager.d.ts +2 -0
  70. package/dist/goal/worktreeManager.js +209 -136
  71. package/dist/httpServer.js +126 -44
  72. package/dist/index.js +7 -4
  73. package/dist/logging.d.ts +7 -1
  74. package/dist/logging.js +13 -3
  75. package/dist/policy/projectPolicy.js +5 -2
  76. package/dist/release/releaseGate.d.ts +1 -1
  77. package/dist/release/releaseGate.js +78 -25
  78. package/dist/runner/agentInvocation.d.ts +14 -0
  79. package/dist/runner/agentInvocation.js +96 -4
  80. package/dist/runner/changeCapture.d.ts +14 -6
  81. package/dist/runner/changeCapture.js +287 -81
  82. package/dist/runner/cli.js +7 -6
  83. package/dist/runner/postTaskCleanup.js +60 -7
  84. package/dist/runner/processSecurity.d.ts +56 -0
  85. package/dist/runner/processSecurity.js +373 -0
  86. package/dist/runner/runTask.d.ts +1 -1
  87. package/dist/runner/runTask.js +339 -287
  88. package/dist/runner/simpleProcess.d.ts +3 -0
  89. package/dist/runner/simpleProcess.js +52 -38
  90. package/dist/{taskProgress.d.ts → runner/taskProgress.d.ts} +1 -1
  91. package/dist/{taskProgress.js → runner/taskProgress.js} +2 -2
  92. package/dist/{taskRuntime.d.ts → runner/taskRuntime.d.ts} +1 -1
  93. package/dist/{taskRuntime.js → runner/taskRuntime.js} +3 -2
  94. package/dist/runner/taskStatusStore.d.ts +11 -0
  95. package/dist/runner/taskStatusStore.js +24 -0
  96. package/dist/runner/watch.d.ts +14 -1
  97. package/dist/runner/watch.js +265 -54
  98. package/dist/security/contentRedaction.d.ts +6 -0
  99. package/dist/security/contentRedaction.js +24 -2
  100. package/dist/security/discoveryTokenStore.d.ts +3 -2
  101. package/dist/security/discoveryTokenStore.js +17 -2
  102. package/dist/security/loopbackHost.d.ts +2 -0
  103. package/dist/security/loopbackHost.js +16 -0
  104. package/dist/security/pathGuard.js +32 -17
  105. package/dist/security/planGuard.js +2 -1
  106. package/dist/security/runtimeGuard.js +9 -6
  107. package/dist/security/secretComparison.d.ts +3 -0
  108. package/dist/security/secretComparison.js +11 -0
  109. package/dist/security/sensitiveGuard.d.ts +5 -0
  110. package/dist/security/sensitiveGuard.js +27 -8
  111. package/dist/security/toolInvocationGuard.d.ts +2 -2
  112. package/dist/security/toolInvocationGuard.js +1 -1
  113. package/dist/security/workspaceRootGuard.d.ts +8 -0
  114. package/dist/security/workspaceRootGuard.js +47 -0
  115. package/dist/smoke-test.js +280 -273
  116. package/dist/tools/catalog/index.d.ts +4 -0
  117. package/dist/tools/catalog/index.js +4 -0
  118. package/dist/tools/{toolCatalog.js → catalog/toolCatalog.js} +3 -12
  119. package/dist/tools/{toolRegistry.d.ts → catalog/toolRegistry.d.ts} +3 -3
  120. package/dist/tools/{toolRegistry.js → catalog/toolRegistry.js} +28 -15
  121. package/dist/tools/definitions/toolDefs.d.ts +18 -0
  122. package/dist/tools/definitions/toolDefs.js +1177 -0
  123. package/dist/tools/{auditSession.d.ts → diagnostics/auditSession.d.ts} +1 -1
  124. package/dist/tools/{auditSession.js → diagnostics/auditSession.js} +2 -2
  125. package/dist/tools/{auditTask.d.ts → diagnostics/auditTask.d.ts} +8 -63
  126. package/dist/tools/{auditTask.js → diagnostics/auditTask.js} +111 -37
  127. package/dist/tools/{healthCheck.d.ts → diagnostics/healthCheck.d.ts} +6 -6
  128. package/dist/tools/{healthCheck.js → diagnostics/healthCheck.js} +10 -10
  129. package/dist/tools/diagnostics/index.d.ts +6 -0
  130. package/dist/tools/diagnostics/index.js +6 -0
  131. package/dist/tools/{safeStatus.d.ts → diagnostics/safeStatus.d.ts} +3 -3
  132. package/dist/tools/{safeStatus.js → diagnostics/safeStatus.js} +6 -6
  133. package/dist/tools/{safeViews.d.ts → diagnostics/safeViews.d.ts} +14 -10
  134. package/dist/tools/{safeViews.js → diagnostics/safeViews.js} +25 -15
  135. package/dist/tools/{schemaDriftCheck.d.ts → diagnostics/schemaDriftCheck.d.ts} +1 -1
  136. package/dist/tools/{schemaDriftCheck.js → diagnostics/schemaDriftCheck.js} +2 -2
  137. package/dist/tools/{createDirectSession.d.ts → direct/createDirectSession.d.ts} +1 -1
  138. package/dist/tools/{createDirectSession.js → direct/createDirectSession.js} +8 -8
  139. package/dist/tools/{finalizeDirectSession.d.ts → direct/finalizeDirectSession.d.ts} +2 -2
  140. package/dist/tools/direct/finalizeDirectSession.js +86 -0
  141. package/dist/tools/direct/index.d.ts +3 -0
  142. package/dist/tools/direct/index.js +3 -0
  143. package/dist/tools/{runDirectVerificationBundle.js → direct/runDirectVerificationBundle.js} +2 -2
  144. package/dist/tools/{discoverTools.d.ts → discovery/discoverTools.d.ts} +2 -2
  145. package/dist/tools/{discoverTools.js → discovery/discoverTools.js} +5 -5
  146. package/dist/tools/{explainTool.d.ts → discovery/explainTool.d.ts} +2 -2
  147. package/dist/tools/{explainTool.js → discovery/explainTool.js} +2 -2
  148. package/dist/tools/discovery/index.d.ts +3 -0
  149. package/dist/tools/discovery/index.js +3 -0
  150. package/dist/tools/{invokeDiscoveredTool.d.ts → discovery/invokeDiscoveredTool.d.ts} +2 -2
  151. package/dist/tools/{invokeDiscoveredTool.js → discovery/invokeDiscoveredTool.js} +5 -5
  152. package/dist/tools/dispatch/coreDispatch.d.ts +9 -0
  153. package/dist/tools/dispatch/coreDispatch.js +283 -0
  154. package/dist/tools/dispatch/diagnosticDispatch.d.ts +12 -0
  155. package/dist/tools/dispatch/diagnosticDispatch.js +80 -0
  156. package/dist/tools/dispatch/directDispatch.d.ts +8 -0
  157. package/dist/tools/dispatch/directDispatch.js +116 -0
  158. package/dist/tools/dispatch/goalDispatch.d.ts +8 -0
  159. package/dist/tools/dispatch/goalDispatch.js +92 -0
  160. package/dist/tools/dispatch/releaseDispatch.d.ts +8 -0
  161. package/dist/tools/dispatch/releaseDispatch.js +46 -0
  162. package/dist/tools/dispatch/types.d.ts +23 -0
  163. package/dist/tools/dispatch/types.js +15 -0
  164. package/dist/tools/dispatch/validation.d.ts +7 -0
  165. package/dist/tools/dispatch/validation.js +71 -0
  166. package/dist/tools/{getPlan.js → goals/getPlan.js} +4 -4
  167. package/dist/tools/{goalSubgoalTask.d.ts → goals/goalSubgoalTask.d.ts} +2 -2
  168. package/dist/tools/goals/goalSubgoalTask.js +118 -0
  169. package/dist/tools/goals/index.d.ts +3 -0
  170. package/dist/tools/goals/index.js +3 -0
  171. package/dist/tools/{savePlan.js → goals/savePlan.js} +28 -8
  172. package/dist/tools/registry.d.ts +10 -14
  173. package/dist/tools/registry.js +47 -1651
  174. package/dist/tools/{checkReleaseGate.d.ts → release/checkReleaseGate.d.ts} +1 -1
  175. package/dist/tools/{checkReleaseGate.js → release/checkReleaseGate.js} +3 -3
  176. package/dist/tools/release/index.d.ts +2 -0
  177. package/dist/tools/release/index.js +2 -0
  178. package/dist/tools/{releaseMode.d.ts → release/releaseMode.d.ts} +2 -2
  179. package/dist/tools/{releaseMode.js → release/releaseMode.js} +46 -26
  180. package/dist/tools/tasks/cancelTask.d.ts +11 -0
  181. package/dist/tools/tasks/cancelTask.js +85 -0
  182. package/dist/tools/{createTask.d.ts → tasks/createTask.d.ts} +12 -4
  183. package/dist/tools/{createTask.js → tasks/createTask.js} +46 -31
  184. package/dist/tools/{diagnoseTask.d.ts → tasks/diagnoseTask.d.ts} +1 -1
  185. package/dist/tools/{diagnoseTask.js → tasks/diagnoseTask.js} +8 -8
  186. package/dist/tools/{evidencePack.d.ts → tasks/evidencePack.d.ts} +6 -0
  187. package/dist/tools/tasks/evidencePack.js +387 -0
  188. package/dist/tools/{getTaskFile.js → tasks/getTaskFile.js} +4 -4
  189. package/dist/tools/{getTaskStatus.d.ts → tasks/getTaskStatus.d.ts} +6 -1
  190. package/dist/tools/{getTaskStatus.js → tasks/getTaskStatus.js} +5 -5
  191. package/dist/tools/{getTaskStdoutTail.js → tasks/getTaskStdoutTail.js} +13 -11
  192. package/dist/tools/{getTaskSummary.js → tasks/getTaskSummary.js} +33 -26
  193. package/dist/tools/tasks/index.d.ts +18 -0
  194. package/dist/tools/tasks/index.js +18 -0
  195. package/dist/tools/tasks/killTask.d.ts +1 -0
  196. package/dist/tools/{listTasks.d.ts → tasks/listTasks.d.ts} +1 -1
  197. package/dist/tools/{listTasks.js → tasks/listTasks.js} +3 -3
  198. package/dist/tools/{reconcileTasks.d.ts → tasks/reconcileTasks.d.ts} +1 -1
  199. package/dist/tools/{reconcileTasks.js → tasks/reconcileTasks.js} +64 -66
  200. package/dist/tools/{retryTask.d.ts → tasks/retryTask.d.ts} +2 -2
  201. package/dist/tools/tasks/retryTask.js +60 -0
  202. package/dist/tools/{runTaskLoop.d.ts → tasks/runTaskLoop.d.ts} +6 -6
  203. package/dist/tools/{runTaskLoop.js → tasks/runTaskLoop.js} +59 -31
  204. package/dist/tools/tasks/runVerification.js +38 -0
  205. package/dist/tools/{taskLineage.js → tasks/taskLineage.js} +8 -7
  206. package/dist/tools/{taskOutputs.js → tasks/taskOutputs.js} +17 -16
  207. package/dist/tools/{androidDoctor.js → workspace/androidDoctor.js} +16 -10
  208. package/dist/tools/{applyPatch.d.ts → workspace/applyPatch.d.ts} +1 -1
  209. package/dist/tools/workspace/applyPatch.js +53 -0
  210. package/dist/tools/{discardWorktree.js → workspace/discardWorktree.js} +3 -3
  211. package/dist/tools/workspace/index.d.ts +10 -0
  212. package/dist/tools/workspace/index.js +10 -0
  213. package/dist/tools/{listAgents.d.ts → workspace/listAgents.d.ts} +5 -0
  214. package/dist/tools/{listAgents.js → workspace/listAgents.js} +8 -4
  215. package/dist/tools/{listWorkspace.js → workspace/listWorkspace.js} +3 -3
  216. package/dist/tools/{mergeWorktree.js → workspace/mergeWorktree.js} +3 -3
  217. package/dist/tools/{readWorkspaceFile.js → workspace/readWorkspaceFile.js} +8 -8
  218. package/dist/tools/{recommendAgentForTask.js → workspace/recommendAgentForTask.js} +3 -3
  219. package/dist/tools/{searchWorkspace.js → workspace/searchWorkspace.js} +5 -5
  220. package/dist/tools/{syncFile.d.ts → workspace/syncFile.d.ts} +1 -1
  221. package/dist/tools/workspace/syncFile.js +134 -0
  222. package/dist/utils/atomicFile.d.ts +7 -0
  223. package/dist/utils/atomicFile.js +48 -0
  224. package/dist/utils/boundedFile.d.ts +8 -0
  225. package/dist/utils/boundedFile.js +93 -0
  226. package/dist/utils/lockedJsonFile.d.ts +15 -0
  227. package/dist/utils/lockedJsonFile.js +224 -0
  228. package/dist/utils/platform.d.ts +11 -0
  229. package/dist/utils/platform.js +26 -0
  230. package/dist/utils/stableJson.d.ts +2 -0
  231. package/dist/utils/stableJson.js +12 -0
  232. package/dist/version.d.ts +3 -2
  233. package/dist/version.js +3 -2
  234. package/dist/watcherStatus.d.ts +2 -2
  235. package/dist/watcherStatus.js +18 -0
  236. package/docs/CODE_WIKI.md +1648 -0
  237. package/docs/agentseal-integration.md +150 -0
  238. package/docs/architecture.md +23 -0
  239. package/docs/assets/patchwarden-desktop-onboarding.png +0 -0
  240. package/docs/assets/patchwarden-oss-demo.gif +0 -0
  241. package/docs/control-center/README.md +4 -4
  242. package/docs/dashboard-overview.md +86 -0
  243. package/docs/demo.md +8 -0
  244. package/docs/desktop-app.md +175 -0
  245. package/docs/direct-session-workflow.md +98 -0
  246. package/docs/evidence-pack-schema.md +215 -0
  247. package/docs/lineage-evidence-pack-workflow.md +127 -0
  248. package/docs/mcp-inspector-testing.md +200 -0
  249. package/docs/open-source-application.md +168 -0
  250. package/docs/opencode-worker.md +151 -0
  251. package/docs/openhands-worker.md +181 -0
  252. package/docs/release-checklist.md +1 -1
  253. package/docs/release-evidence.md +82 -0
  254. package/docs/spec-kit-integration.md +131 -0
  255. package/docs/task-safe-review-workflow.md +98 -0
  256. package/docs/threat-model.md +97 -0
  257. package/docs/user-feedback.md +40 -0
  258. package/docs/why-patchwarden.md +110 -0
  259. package/examples/config.example.json +4 -2
  260. package/package.json +28 -11
  261. package/scripts/README.md +15 -6
  262. package/scripts/build.js +11 -0
  263. package/scripts/checks/brand-check.js +3 -0
  264. package/scripts/checks/build-output-check.js +37 -0
  265. package/scripts/checks/control-center-smoke.js +447 -6
  266. package/scripts/checks/control-smoke.js +19 -8
  267. package/scripts/checks/http-mcp-smoke.js +82 -4
  268. package/scripts/checks/lifecycle-smoke.js +39 -33
  269. package/scripts/checks/mcp-manifest-check.js +1 -1
  270. package/scripts/checks/mcp-smoke.js +30 -4
  271. package/scripts/checks/package-manifest-check.js +20 -7
  272. package/scripts/checks/unit-tests.js +3 -5
  273. package/scripts/checks/watcher-supervisor-smoke.js +9 -0
  274. package/scripts/control/get-patchwarden-health.ps1 +1 -1
  275. package/scripts/control/manage-patchwarden.ps1 +69 -4
  276. package/scripts/control/provision-patchwarden-tunnel.ps1 +127 -0
  277. package/scripts/control/run-background-supervisor.ps1 +41 -0
  278. package/scripts/control/start-patchwarden-tunnel.ps1 +126 -32
  279. package/scripts/generate-demo-gif.py +320 -0
  280. package/{PatchWarden-Control-Tray.cmd → scripts/launchers/PatchWarden-Control-Tray.cmd} +3 -3
  281. package/scripts/launchers/PatchWarden-Control.cmd +6 -0
  282. package/{PatchWarden-Desktop.cmd → scripts/launchers/PatchWarden-Desktop.cmd} +2 -2
  283. package/scripts/launchers/Restart-PatchWarden-Control.cmd +6 -0
  284. package/{Stop-PatchWarden.cmd → scripts/launchers/Stop-PatchWarden.cmd} +2 -2
  285. package/scripts/lib/clean-generated-output.js +11 -0
  286. package/scripts/lib/file-discovery.js +12 -0
  287. package/scripts/release/desktop-preflight.js +211 -0
  288. package/scripts/release/pack-clean.js +59 -14
  289. package/src/assessments/agentAssessor.ts +29 -15
  290. package/src/assessments/assessmentStore.ts +55 -43
  291. package/src/assessments/confirmCli.ts +5 -4
  292. package/src/config.ts +105 -11
  293. package/src/control/fileManager.ts +40 -0
  294. package/src/control/middleware/auth.ts +35 -0
  295. package/src/control/middleware/static.ts +84 -0
  296. package/src/control/routeTable.ts +301 -0
  297. package/src/control/routes/audit.ts +329 -0
  298. package/src/control/routes/evidence.ts +107 -0
  299. package/src/control/routes/lineage.ts +92 -0
  300. package/src/control/routes/policy.ts +81 -0
  301. package/src/control/routes/process.ts +505 -0
  302. package/src/control/routes/sessions.ts +314 -0
  303. package/src/control/routes/status.ts +405 -0
  304. package/src/control/routes/taskActions.ts +214 -0
  305. package/src/control/routes/tasks.ts +331 -0
  306. package/src/control/routes/workspace.ts +234 -0
  307. package/src/control/runtime.ts +508 -0
  308. package/src/control/server.ts +165 -0
  309. package/src/control/shared.ts +360 -0
  310. package/src/controlCenter.ts +7 -2347
  311. package/src/direct/directAudit.ts +17 -9
  312. package/src/direct/directGuards.ts +100 -51
  313. package/src/direct/directPatch.ts +95 -8
  314. package/src/direct/directSessionStore.ts +211 -55
  315. package/src/direct/directVerification.ts +9 -23
  316. package/src/doctor.ts +766 -492
  317. package/src/goal/acceptanceEngine.ts +1 -1
  318. package/src/goal/goalProgress.ts +17 -13
  319. package/src/goal/goalReport.ts +263 -0
  320. package/src/goal/goalStatus.ts +25 -3
  321. package/src/goal/goalStore.ts +241 -54
  322. package/src/goal/handoffExport.ts +6 -6
  323. package/src/goal/specKitImport.ts +355 -0
  324. package/src/goal/subgoalSync.ts +15 -10
  325. package/src/goal/worktreeManager.ts +139 -22
  326. package/src/httpServer.ts +130 -44
  327. package/src/index.ts +7 -4
  328. package/src/logging.ts +20 -4
  329. package/src/policy/projectPolicy.ts +5 -2
  330. package/src/release/releaseGate.ts +74 -27
  331. package/src/runner/agentInvocation.ts +126 -4
  332. package/src/runner/changeCapture.ts +342 -80
  333. package/src/runner/cli.ts +7 -6
  334. package/src/runner/postTaskCleanup.ts +55 -7
  335. package/src/runner/processSecurity.ts +433 -0
  336. package/src/runner/runTask.ts +441 -292
  337. package/src/runner/simpleProcess.ts +68 -33
  338. package/src/{taskProgress.ts → runner/taskProgress.ts} +3 -3
  339. package/src/{taskRuntime.ts → runner/taskRuntime.ts} +4 -3
  340. package/src/runner/taskStatusStore.ts +54 -0
  341. package/src/runner/watch.ts +290 -57
  342. package/src/security/contentRedaction.ts +31 -2
  343. package/src/security/discoveryTokenStore.ts +18 -4
  344. package/src/security/loopbackHost.ts +19 -0
  345. package/src/security/pathGuard.ts +35 -16
  346. package/src/security/planGuard.ts +2 -1
  347. package/src/security/runtimeGuard.ts +9 -6
  348. package/src/security/secretComparison.ts +13 -0
  349. package/src/security/sensitiveGuard.ts +27 -8
  350. package/src/security/toolInvocationGuard.ts +2 -2
  351. package/src/security/workspaceRootGuard.ts +53 -0
  352. package/src/smoke-test.ts +276 -273
  353. package/src/tools/catalog/index.ts +4 -0
  354. package/src/tools/{toolCatalog.ts → catalog/toolCatalog.ts} +3 -12
  355. package/src/tools/{toolRegistry.ts → catalog/toolRegistry.ts} +29 -16
  356. package/src/tools/definitions/toolDefs.ts +1264 -0
  357. package/src/tools/{auditSession.ts → diagnostics/auditSession.ts} +2 -2
  358. package/src/tools/{auditTask.ts → diagnostics/auditTask.ts} +196 -89
  359. package/src/tools/{healthCheck.ts → diagnostics/healthCheck.ts} +11 -11
  360. package/src/tools/diagnostics/index.ts +6 -0
  361. package/src/tools/{safeStatus.ts → diagnostics/safeStatus.ts} +7 -7
  362. package/src/tools/{safeViews.ts → diagnostics/safeViews.ts} +29 -19
  363. package/src/tools/{schemaDriftCheck.ts → diagnostics/schemaDriftCheck.ts} +3 -3
  364. package/src/tools/{createDirectSession.ts → direct/createDirectSession.ts} +9 -9
  365. package/src/tools/{finalizeDirectSession.ts → direct/finalizeDirectSession.ts} +11 -9
  366. package/src/tools/direct/index.ts +3 -0
  367. package/src/tools/{runDirectVerificationBundle.ts → direct/runDirectVerificationBundle.ts} +2 -2
  368. package/src/tools/{discoverTools.ts → discovery/discoverTools.ts} +6 -6
  369. package/src/tools/{explainTool.ts → discovery/explainTool.ts} +3 -3
  370. package/src/tools/discovery/index.ts +3 -0
  371. package/src/tools/{invokeDiscoveredTool.ts → discovery/invokeDiscoveredTool.ts} +7 -7
  372. package/src/tools/dispatch/coreDispatch.ts +379 -0
  373. package/src/tools/dispatch/diagnosticDispatch.ts +106 -0
  374. package/src/tools/dispatch/directDispatch.ts +168 -0
  375. package/src/tools/dispatch/goalDispatch.ts +128 -0
  376. package/src/tools/dispatch/releaseDispatch.ts +66 -0
  377. package/src/tools/dispatch/types.ts +24 -0
  378. package/src/tools/dispatch/validation.ts +78 -0
  379. package/src/tools/{getPlan.ts → goals/getPlan.ts} +4 -4
  380. package/src/tools/{goalSubgoalTask.ts → goals/goalSubgoalTask.ts} +43 -28
  381. package/src/tools/goals/index.ts +3 -0
  382. package/src/tools/{savePlan.ts → goals/savePlan.ts} +38 -8
  383. package/src/tools/registry.ts +54 -1858
  384. package/src/tools/{checkReleaseGate.ts → release/checkReleaseGate.ts} +3 -3
  385. package/src/tools/release/index.ts +2 -0
  386. package/src/tools/{releaseMode.ts → release/releaseMode.ts} +42 -24
  387. package/src/tools/tasks/cancelTask.ts +109 -0
  388. package/src/tools/{createTask.ts → tasks/createTask.ts} +56 -33
  389. package/src/tools/{diagnoseTask.ts → tasks/diagnoseTask.ts} +8 -8
  390. package/src/tools/tasks/evidencePack.ts +504 -0
  391. package/src/tools/{getTaskFile.ts → tasks/getTaskFile.ts} +4 -4
  392. package/src/tools/{getTaskStatus.ts → tasks/getTaskStatus.ts} +7 -5
  393. package/src/tools/{getTaskStdoutTail.ts → tasks/getTaskStdoutTail.ts} +13 -11
  394. package/src/tools/{getTaskSummary.ts → tasks/getTaskSummary.ts} +44 -33
  395. package/src/tools/tasks/index.ts +18 -0
  396. package/src/tools/{listTasks.ts → tasks/listTasks.ts} +4 -4
  397. package/src/tools/{reconcileTasks.ts → tasks/reconcileTasks.ts} +68 -66
  398. package/src/tools/tasks/retryTask.ts +69 -0
  399. package/src/tools/{runTaskLoop.ts → tasks/runTaskLoop.ts} +70 -35
  400. package/src/tools/{runVerification.ts → tasks/runVerification.ts} +6 -3
  401. package/src/tools/{taskLineage.ts → tasks/taskLineage.ts} +8 -7
  402. package/src/tools/{taskOutputs.ts → tasks/taskOutputs.ts} +27 -20
  403. package/src/tools/{androidDoctor.ts → workspace/androidDoctor.ts} +15 -10
  404. package/src/tools/{applyPatch.ts → workspace/applyPatch.ts} +38 -16
  405. package/src/tools/{discardWorktree.ts → workspace/discardWorktree.ts} +3 -3
  406. package/src/tools/workspace/index.ts +10 -0
  407. package/src/tools/{listAgents.ts → workspace/listAgents.ts} +11 -4
  408. package/src/tools/{listWorkspace.ts → workspace/listWorkspace.ts} +3 -3
  409. package/src/tools/{mergeWorktree.ts → workspace/mergeWorktree.ts} +3 -3
  410. package/src/tools/{readWorkspaceFile.ts → workspace/readWorkspaceFile.ts} +8 -8
  411. package/src/tools/{recommendAgentForTask.ts → workspace/recommendAgentForTask.ts} +3 -3
  412. package/src/tools/{searchWorkspace.ts → workspace/searchWorkspace.ts} +5 -5
  413. package/src/tools/workspace/syncFile.ts +292 -0
  414. package/src/utils/atomicFile.ts +58 -0
  415. package/src/utils/boundedFile.ts +116 -0
  416. package/src/utils/lockedJsonFile.ts +251 -0
  417. package/src/utils/platform.ts +31 -0
  418. package/src/utils/stableJson.ts +12 -0
  419. package/src/version.ts +3 -2
  420. package/src/watcherStatus.ts +19 -1
  421. package/ui/desktop-bootstrap.js +11 -0
  422. package/ui/desktop-bridge.js +36 -0
  423. package/ui/desktop.css +160 -0
  424. package/ui/getting-started.js +93 -0
  425. package/ui/i18n.js +484 -0
  426. package/ui/log-parser.js +30 -0
  427. package/ui/pages/audit.html +204 -3
  428. package/ui/pages/dashboard.html +937 -79
  429. package/ui/pages/direct-sessions.html +609 -60
  430. package/ui/pages/getting-started.html +43 -0
  431. package/ui/pages/logs.html +105 -22
  432. package/ui/pages/settings.html +101 -0
  433. package/ui/pages/task-detail.html +468 -438
  434. package/ui/pages/tasks.html +648 -65
  435. package/ui/pages/workspace.html +38 -1
  436. package/ui/settings.js +245 -0
  437. package/PatchWarden-Control.cmd +0 -6
  438. package/Restart-PatchWarden-Control.cmd +0 -6
  439. package/dist/test/unit/acceptance-engine.test.d.ts +0 -1
  440. package/dist/test/unit/acceptance-engine.test.js +0 -228
  441. package/dist/test/unit/agent-router.test.d.ts +0 -1
  442. package/dist/test/unit/agent-router.test.js +0 -287
  443. package/dist/test/unit/android-doctor.test.d.ts +0 -1
  444. package/dist/test/unit/android-doctor.test.js +0 -118
  445. package/dist/test/unit/audit-checks.test.d.ts +0 -1
  446. package/dist/test/unit/audit-checks.test.js +0 -350
  447. package/dist/test/unit/chinese-path.test.d.ts +0 -1
  448. package/dist/test/unit/chinese-path.test.js +0 -91
  449. package/dist/test/unit/command-guard.test.d.ts +0 -1
  450. package/dist/test/unit/command-guard.test.js +0 -160
  451. package/dist/test/unit/diagnose-task.test.d.ts +0 -1
  452. package/dist/test/unit/diagnose-task.test.js +0 -457
  453. package/dist/test/unit/direct-guards.test.d.ts +0 -1
  454. package/dist/test/unit/direct-guards.test.js +0 -213
  455. package/dist/test/unit/discovery-token-store.test.d.ts +0 -1
  456. package/dist/test/unit/discovery-token-store.test.js +0 -139
  457. package/dist/test/unit/evidence-pack.test.d.ts +0 -1
  458. package/dist/test/unit/evidence-pack.test.js +0 -130
  459. package/dist/test/unit/goal-graph.test.d.ts +0 -1
  460. package/dist/test/unit/goal-graph.test.js +0 -298
  461. package/dist/test/unit/goal-progress.test.d.ts +0 -1
  462. package/dist/test/unit/goal-progress.test.js +0 -381
  463. package/dist/test/unit/goal-status.test.d.ts +0 -1
  464. package/dist/test/unit/goal-status.test.js +0 -215
  465. package/dist/test/unit/goal-store.test.d.ts +0 -1
  466. package/dist/test/unit/goal-store.test.js +0 -253
  467. package/dist/test/unit/goal-subgoal-task.test.d.ts +0 -1
  468. package/dist/test/unit/goal-subgoal-task.test.js +0 -55
  469. package/dist/test/unit/goal-tools-registry.test.d.ts +0 -1
  470. package/dist/test/unit/goal-tools-registry.test.js +0 -190
  471. package/dist/test/unit/handoff-export.test.d.ts +0 -1
  472. package/dist/test/unit/handoff-export.test.js +0 -263
  473. package/dist/test/unit/invoke-discovered-tool.test.d.ts +0 -1
  474. package/dist/test/unit/invoke-discovered-tool.test.js +0 -167
  475. package/dist/test/unit/logging.test.d.ts +0 -1
  476. package/dist/test/unit/logging.test.js +0 -397
  477. package/dist/test/unit/path-guard.test.d.ts +0 -1
  478. package/dist/test/unit/path-guard.test.js +0 -109
  479. package/dist/test/unit/post-task-cleanup.test.d.ts +0 -1
  480. package/dist/test/unit/post-task-cleanup.test.js +0 -48
  481. package/dist/test/unit/project-policy-release-mode.test.d.ts +0 -1
  482. package/dist/test/unit/project-policy-release-mode.test.js +0 -125
  483. package/dist/test/unit/reconcile-tasks.test.d.ts +0 -1
  484. package/dist/test/unit/reconcile-tasks.test.js +0 -456
  485. package/dist/test/unit/release-gate.test.d.ts +0 -1
  486. package/dist/test/unit/release-gate.test.js +0 -242
  487. package/dist/test/unit/run-task-loop.test.d.ts +0 -1
  488. package/dist/test/unit/run-task-loop.test.js +0 -380
  489. package/dist/test/unit/safe-status.test.d.ts +0 -1
  490. package/dist/test/unit/safe-status.test.js +0 -165
  491. package/dist/test/unit/safe-views.test.d.ts +0 -1
  492. package/dist/test/unit/safe-views.test.js +0 -171
  493. package/dist/test/unit/schema-drift-check.test.d.ts +0 -1
  494. package/dist/test/unit/schema-drift-check.test.js +0 -176
  495. package/dist/test/unit/sensitive-guard.test.d.ts +0 -1
  496. package/dist/test/unit/sensitive-guard.test.js +0 -104
  497. package/dist/test/unit/subgoal-sync.test.d.ts +0 -1
  498. package/dist/test/unit/subgoal-sync.test.js +0 -183
  499. package/dist/test/unit/sync-file.test.d.ts +0 -1
  500. package/dist/test/unit/sync-file.test.js +0 -154
  501. package/dist/test/unit/tool-invocation-guard.test.d.ts +0 -1
  502. package/dist/test/unit/tool-invocation-guard.test.js +0 -432
  503. package/dist/test/unit/tool-usage-stats.test.d.ts +0 -1
  504. package/dist/test/unit/tool-usage-stats.test.js +0 -300
  505. package/dist/test/unit/toolSearch.test.d.ts +0 -1
  506. package/dist/test/unit/toolSearch.test.js +0 -571
  507. package/dist/test/unit/watcher-status.test.d.ts +0 -1
  508. package/dist/test/unit/watcher-status.test.js +0 -169
  509. package/dist/test/unit/worktree-manager.test.d.ts +0 -1
  510. package/dist/test/unit/worktree-manager.test.js +0 -176
  511. package/dist/tools/applyPatch.js +0 -41
  512. package/dist/tools/cancelTask.d.ts +0 -30
  513. package/dist/tools/cancelTask.js +0 -64
  514. package/dist/tools/evidencePack.js +0 -168
  515. package/dist/tools/finalizeDirectSession.js +0 -84
  516. package/dist/tools/goalSubgoalTask.js +0 -110
  517. package/dist/tools/killTask.d.ts +0 -15
  518. package/dist/tools/retryTask.js +0 -45
  519. package/dist/tools/runVerification.js +0 -36
  520. package/dist/tools/syncFile.js +0 -65
  521. package/docs/control-center/control-center-daily-driver.md +0 -211
  522. package/docs/control-center/control-center-mvp.md +0 -205
  523. package/docs/control-center/control-center-phase2.md +0 -159
  524. package/docs/release-v0.6.0.md +0 -71
  525. package/docs/release-v0.6.1.md +0 -75
  526. package/docs/release-v0.6.4.md +0 -45
  527. package/src/test/unit/acceptance-engine.test.ts +0 -261
  528. package/src/test/unit/agent-router.test.ts +0 -342
  529. package/src/test/unit/android-doctor.test.ts +0 -158
  530. package/src/test/unit/audit-checks.test.ts +0 -567
  531. package/src/test/unit/chinese-path.test.ts +0 -106
  532. package/src/test/unit/command-guard.test.ts +0 -221
  533. package/src/test/unit/diagnose-task.test.ts +0 -544
  534. package/src/test/unit/direct-guards.test.ts +0 -297
  535. package/src/test/unit/discovery-token-store.test.ts +0 -181
  536. package/src/test/unit/evidence-pack.test.ts +0 -142
  537. package/src/test/unit/goal-graph.test.ts +0 -347
  538. package/src/test/unit/goal-progress.test.ts +0 -538
  539. package/src/test/unit/goal-status.test.ts +0 -270
  540. package/src/test/unit/goal-store.test.ts +0 -318
  541. package/src/test/unit/goal-subgoal-task.test.ts +0 -72
  542. package/src/test/unit/goal-tools-registry.test.ts +0 -243
  543. package/src/test/unit/handoff-export.test.ts +0 -295
  544. package/src/test/unit/invoke-discovered-tool.test.ts +0 -216
  545. package/src/test/unit/logging.test.ts +0 -497
  546. package/src/test/unit/path-guard.test.ts +0 -150
  547. package/src/test/unit/post-task-cleanup.test.ts +0 -53
  548. package/src/test/unit/project-policy-release-mode.test.ts +0 -156
  549. package/src/test/unit/reconcile-tasks.test.ts +0 -551
  550. package/src/test/unit/release-gate.test.ts +0 -314
  551. package/src/test/unit/run-task-loop.test.ts +0 -425
  552. package/src/test/unit/safe-status.test.ts +0 -187
  553. package/src/test/unit/safe-views.test.ts +0 -184
  554. package/src/test/unit/schema-drift-check.test.ts +0 -260
  555. package/src/test/unit/sensitive-guard.test.ts +0 -124
  556. package/src/test/unit/subgoal-sync.test.ts +0 -236
  557. package/src/test/unit/sync-file.test.ts +0 -231
  558. package/src/test/unit/tool-invocation-guard.test.ts +0 -542
  559. package/src/test/unit/tool-usage-stats.test.ts +0 -384
  560. package/src/test/unit/toolSearch.test.ts +0 -756
  561. package/src/test/unit/watcher-status.test.ts +0 -190
  562. package/src/test/unit/worktree-manager.test.ts +0 -247
  563. package/src/tools/cancelTask.ts +0 -70
  564. package/src/tools/evidencePack.ts +0 -205
  565. package/src/tools/retryTask.ts +0 -53
  566. package/src/tools/syncFile.ts +0 -122
  567. /package/dist/tools/{toolCatalog.d.ts → catalog/toolCatalog.d.ts} +0 -0
  568. /package/dist/tools/{toolSearch.d.ts → catalog/toolSearch.d.ts} +0 -0
  569. /package/dist/tools/{toolSearch.js → catalog/toolSearch.js} +0 -0
  570. /package/dist/tools/{toolUsageStats.d.ts → catalog/toolUsageStats.d.ts} +0 -0
  571. /package/dist/tools/{toolUsageStats.js → catalog/toolUsageStats.js} +0 -0
  572. /package/dist/tools/{runDirectVerificationBundle.d.ts → direct/runDirectVerificationBundle.d.ts} +0 -0
  573. /package/dist/tools/{getPlan.d.ts → goals/getPlan.d.ts} +0 -0
  574. /package/dist/tools/{savePlan.d.ts → goals/savePlan.d.ts} +0 -0
  575. /package/dist/tools/{getTaskFile.d.ts → tasks/getTaskFile.d.ts} +0 -0
  576. /package/dist/tools/{getTaskProgress.d.ts → tasks/getTaskProgress.d.ts} +0 -0
  577. /package/dist/tools/{getTaskProgress.js → tasks/getTaskProgress.js} +0 -0
  578. /package/dist/tools/{getTaskStdoutTail.d.ts → tasks/getTaskStdoutTail.d.ts} +0 -0
  579. /package/dist/tools/{getTaskSummary.d.ts → tasks/getTaskSummary.d.ts} +0 -0
  580. /package/dist/tools/{killTask.js → tasks/killTask.js} +0 -0
  581. /package/dist/tools/{runVerification.d.ts → tasks/runVerification.d.ts} +0 -0
  582. /package/dist/tools/{taskLineage.d.ts → tasks/taskLineage.d.ts} +0 -0
  583. /package/dist/tools/{taskOutputs.d.ts → tasks/taskOutputs.d.ts} +0 -0
  584. /package/dist/tools/{waitForTask.d.ts → tasks/waitForTask.d.ts} +0 -0
  585. /package/dist/tools/{waitForTask.js → tasks/waitForTask.js} +0 -0
  586. /package/dist/tools/{androidDoctor.d.ts → workspace/androidDoctor.d.ts} +0 -0
  587. /package/dist/tools/{discardWorktree.d.ts → workspace/discardWorktree.d.ts} +0 -0
  588. /package/dist/tools/{listWorkspace.d.ts → workspace/listWorkspace.d.ts} +0 -0
  589. /package/dist/tools/{mergeWorktree.d.ts → workspace/mergeWorktree.d.ts} +0 -0
  590. /package/dist/tools/{readWorkspaceFile.d.ts → workspace/readWorkspaceFile.d.ts} +0 -0
  591. /package/dist/tools/{recommendAgentForTask.d.ts → workspace/recommendAgentForTask.d.ts} +0 -0
  592. /package/dist/tools/{searchWorkspace.d.ts → workspace/searchWorkspace.d.ts} +0 -0
  593. /package/src/tools/{toolSearch.ts → catalog/toolSearch.ts} +0 -0
  594. /package/src/tools/{toolUsageStats.ts → catalog/toolUsageStats.ts} +0 -0
  595. /package/src/tools/{getTaskProgress.ts → tasks/getTaskProgress.ts} +0 -0
  596. /package/src/tools/{killTask.ts → tasks/killTask.ts} +0 -0
  597. /package/src/tools/{waitForTask.ts → tasks/waitForTask.ts} +0 -0
@@ -1,125 +0,0 @@
1
- import { describe, it, beforeEach, afterEach } from "node:test";
2
- import { strict as assert } from "node:assert";
3
- import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
4
- import { join } from "node:path";
5
- import { tmpdir } from "node:os";
6
- import { reloadConfig } from "../../config.js";
7
- import { getProjectPolicySummary } from "../../policy/projectPolicy.js";
8
- import { releaseCleanup, releasePrepare, releaseVerify } from "../../tools/releaseMode.js";
9
- let tempDir;
10
- let repoPath;
11
- let prevConfigEnv;
12
- function writeConfig(allowedTestCommands = ["npm test", "npm run build"]) {
13
- const configPath = join(tempDir, "patchwarden.config.json");
14
- writeFileSync(configPath, JSON.stringify({
15
- workspaceRoot: tempDir,
16
- plansDir: ".patchwarden/plans",
17
- tasksDir: ".patchwarden/tasks",
18
- assessmentsDir: ".patchwarden/assessments",
19
- allowedTestCommands,
20
- agents: {},
21
- defaultTaskTimeoutSeconds: 30,
22
- maxTaskTimeoutSeconds: 120,
23
- }), "utf-8");
24
- prevConfigEnv = process.env.PATCHWARDEN_CONFIG;
25
- process.env.PATCHWARDEN_CONFIG = configPath;
26
- reloadConfig(configPath);
27
- }
28
- function writePackage(version = "1.3.0") {
29
- writeFileSync(join(repoPath, "package.json"), JSON.stringify({
30
- name: "patchwarden-test",
31
- version,
32
- repository: { type: "git", url: "git+https://github.com/example/patchwarden-test.git" },
33
- }), "utf-8");
34
- }
35
- describe("project policy and release mode", () => {
36
- beforeEach(() => {
37
- tempDir = mkdtempSync(join(tmpdir(), "pw-policy-"));
38
- repoPath = join(tempDir, "repo");
39
- mkdirSync(repoPath, { recursive: true });
40
- writePackage();
41
- writeConfig();
42
- });
43
- afterEach(() => {
44
- if (prevConfigEnv === undefined) {
45
- delete process.env.PATCHWARDEN_CONFIG;
46
- }
47
- else {
48
- process.env.PATCHWARDEN_CONFIG = prevConfigEnv;
49
- }
50
- reloadConfig();
51
- rmSync(tempDir, { recursive: true, force: true });
52
- });
53
- it("returns safe defaults when project-policy.json is missing", () => {
54
- const summary = getProjectPolicySummary(repoPath);
55
- assert.equal(summary.exists, false);
56
- assert.equal(summary.valid, true);
57
- assert.equal(summary.effective_policy.release_mode.version_source, "package.json");
58
- assert.equal(summary.release_readiness.version, "1.3.0");
59
- });
60
- it("parses BOM-prefixed policy JSON and reports allowlist issues without granting permission", () => {
61
- mkdirSync(join(repoPath, ".patchwarden"), { recursive: true });
62
- writeFileSync(join(repoPath, ".patchwarden", "project-policy.json"), "\uFEFF" + JSON.stringify({
63
- allowed_commands: ["npm run build", "npm publish"],
64
- release_mode: {
65
- version_source: "package.json",
66
- required_commands: ["npm run build", "not-allowed"],
67
- },
68
- }), "utf-8");
69
- const summary = getProjectPolicySummary(repoPath);
70
- assert.equal(summary.exists, true);
71
- assert.equal(summary.valid, false);
72
- assert.ok(summary.issues.some((issue) => issue.code === "high_risk_command"));
73
- assert.ok(summary.issues.some((issue) => issue.code === "command_not_allowlisted"));
74
- });
75
- it("rejects unsafe path patterns and sensitive protected paths block cleanup", () => {
76
- mkdirSync(join(repoPath, ".patchwarden"), { recursive: true });
77
- writeFileSync(join(repoPath, ".patchwarden", "project-policy.json"), JSON.stringify({
78
- auto_cleanup: { enabled: true, patterns: ["../escape", ".git", "release_packages"], exclude: [] },
79
- protected_paths: [".env", "release_packages"],
80
- }), "utf-8");
81
- mkdirSync(join(repoPath, "release_packages"), { recursive: true });
82
- const summary = getProjectPolicySummary(repoPath);
83
- assert.equal(summary.valid, false);
84
- assert.ok(summary.issues.some((issue) => issue.code === "unsafe_path_pattern"));
85
- const cleanup = releaseCleanup({ repo_path: repoPath, dry_run: true });
86
- const skipped = cleanup.summary.skipped;
87
- assert.ok(skipped.some((entry) => entry.path === "release_packages" && entry.reason === "protected_or_sensitive"));
88
- });
89
- it("release_cleanup defaults to dry run and writes BOM-free JSON summary", () => {
90
- mkdirSync(join(repoPath, "release_packages"), { recursive: true });
91
- const result = releaseCleanup({ repo_path: repoPath });
92
- assert.equal(result.mode, "release_cleanup");
93
- assert.equal(result.summary.dry_run, true);
94
- assert.equal(existsSync(join(repoPath, "release_packages")), true);
95
- const reportPath = join(repoPath, String(result.summary.report_path));
96
- const raw = readFileSync(reportPath, "utf-8");
97
- assert.notEqual(raw.charCodeAt(0), 0xfeff);
98
- assert.doesNotThrow(() => JSON.parse(raw));
99
- });
100
- it("release_cleanup honors auto_cleanup.enabled=false before deleting", () => {
101
- mkdirSync(join(repoPath, ".patchwarden"), { recursive: true });
102
- writeFileSync(join(repoPath, ".patchwarden", "project-policy.json"), JSON.stringify({
103
- auto_cleanup: { enabled: false, patterns: ["release_packages"], exclude: [] },
104
- }), "utf-8");
105
- mkdirSync(join(repoPath, "release_packages"), { recursive: true });
106
- const result = releaseCleanup({ repo_path: repoPath, dry_run: false });
107
- assert.equal(result.summary.cleanup_disabled_by_policy, true);
108
- assert.deepEqual(result.summary.removed, []);
109
- assert.equal(existsSync(join(repoPath, "release_packages")), true);
110
- });
111
- it("release_verify fails when required metadata cannot be inferred", async () => {
112
- writeFileSync(join(repoPath, "package.json"), JSON.stringify({ name: "", version: "" }), "utf-8");
113
- const result = await releaseVerify({ repo_path: repoPath });
114
- assert.equal(result.ok, false);
115
- const stages = result.summary.stages;
116
- assert.equal(stages.published_verified, "failed");
117
- assert.equal(stages.github_release_verified, "failed");
118
- assert.equal(stages.ci_verified, "failed");
119
- });
120
- it("release_prepare blocks commands not accepted by the existing command guard", () => {
121
- const result = releasePrepare({ repo_path: repoPath, required_commands: ["npm run build", "npm run secret"] });
122
- const commands = result.summary.commands;
123
- assert.equal(commands.find((entry) => entry.command === "npm run secret")?.status, "blocked");
124
- });
125
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,456 +0,0 @@
1
- import { describe, it, beforeEach, afterEach } from "node:test";
2
- import { strict as assert } from "node:assert";
3
- import { mkdtempSync, rmSync, mkdirSync, writeFileSync, utimesSync, readFileSync, existsSync, } from "node:fs";
4
- import { join, dirname } from "node:path";
5
- import { tmpdir } from "node:os";
6
- import { reconcileTasks } from "../../tools/reconcileTasks.js";
7
- // ── Test fixtures ──────────────────────────────────────────────────
8
- function makeConfig(workspaceRoot) {
9
- return {
10
- workspaceRoot,
11
- plansDir: ".patchwarden/plans",
12
- tasksDir: ".patchwarden/tasks",
13
- assessmentsDir: ".patchwarden/assessments",
14
- assessmentTtlSeconds: 3600,
15
- agents: { codex: { command: "codex", args: ["exec", "{prompt}"] } },
16
- allowedTestCommands: ["npm test"],
17
- repoAllowedTestCommands: {},
18
- maxReadFileBytes: 200_000,
19
- defaultTaskTimeoutSeconds: 900,
20
- maxTaskTimeoutSeconds: 3600,
21
- watcherStaleSeconds: 30,
22
- directSessionsDir: ".patchwarden/direct-sessions",
23
- directSessionTtlSeconds: 3600,
24
- directMaxPatchBytes: 200_000,
25
- directMaxFileBytes: 500_000,
26
- };
27
- }
28
- const ALIVE_PID = process.pid;
29
- const DEAD_PID = 999999;
30
- function isoSecondsAgo(seconds) {
31
- return new Date(Date.now() - seconds * 1000).toISOString();
32
- }
33
- function ageFile(filePath, secondsAgo) {
34
- if (!existsSync(filePath))
35
- return;
36
- const targetSec = (Date.now() - secondsAgo * 1000) / 1000;
37
- utimesSync(filePath, targetSec, targetSec);
38
- }
39
- describe("reconcileTasks", () => {
40
- let tempDir;
41
- let config;
42
- let tasksDir;
43
- let watcherHeartbeatPath;
44
- let reconcileLogPath;
45
- beforeEach(() => {
46
- tempDir = mkdtempSync(join(tmpdir(), "pw-reconcile-"));
47
- config = makeConfig(tempDir);
48
- tasksDir = join(tempDir, ".patchwarden", "tasks");
49
- mkdirSync(tasksDir, { recursive: true });
50
- watcherHeartbeatPath = join(dirname(tasksDir), "watcher-heartbeat.json");
51
- reconcileLogPath = join(dirname(tasksDir), "reconcile.log");
52
- });
53
- afterEach(() => {
54
- rmSync(tempDir, { recursive: true, force: true });
55
- });
56
- function buildTask(opts) {
57
- const taskId = opts.taskId;
58
- const taskDir = join(tasksDir, taskId);
59
- mkdirSync(taskDir, { recursive: true });
60
- const statusSecondsAgo = opts.createdSecondsAgo ?? 600;
61
- const status = {
62
- task_id: taskId,
63
- status: opts.status ?? "running",
64
- phase: opts.phase ?? "executing_agent",
65
- created_at: isoSecondsAgo(statusSecondsAgo),
66
- updated_at: isoSecondsAgo(statusSecondsAgo),
67
- };
68
- if (opts.heartbeatSecondsAgo !== undefined) {
69
- status.last_heartbeat_at = isoSecondsAgo(opts.heartbeatSecondsAgo);
70
- }
71
- writeFileSync(join(taskDir, "status.json"), JSON.stringify(status, null, 2), "utf-8");
72
- const runtime = {
73
- phase: opts.phase ?? "executing_agent",
74
- };
75
- if (opts.heartbeatSecondsAgo !== undefined) {
76
- runtime.last_heartbeat_at = isoSecondsAgo(opts.heartbeatSecondsAgo);
77
- }
78
- if (opts.childPid !== undefined) {
79
- runtime.child_pid = opts.childPid;
80
- }
81
- if (opts.watcherInstanceId !== undefined) {
82
- runtime.watcher_instance_id = opts.watcherInstanceId;
83
- }
84
- if (opts.taskStartedSecondsAgo !== undefined) {
85
- runtime.task_started_at = isoSecondsAgo(opts.taskStartedSecondsAgo);
86
- }
87
- runtime.current_command = null;
88
- writeFileSync(join(taskDir, "runtime.json"), JSON.stringify(runtime, null, 2), "utf-8");
89
- if (opts.stdoutContent !== undefined) {
90
- const stdoutPath = join(taskDir, "stdout.log");
91
- writeFileSync(stdoutPath, opts.stdoutContent, "utf-8");
92
- if (opts.stdoutSecondsAgo !== undefined)
93
- ageFile(stdoutPath, opts.stdoutSecondsAgo);
94
- }
95
- if (opts.stderrContent !== undefined) {
96
- const stderrPath = join(taskDir, "stderr.log");
97
- writeFileSync(stderrPath, opts.stderrContent, "utf-8");
98
- if (opts.stderrSecondsAgo !== undefined)
99
- ageFile(stderrPath, opts.stderrSecondsAgo);
100
- }
101
- if (opts.resultMd) {
102
- writeFileSync(join(taskDir, "result.md"), "# Result\nTask completed.", "utf-8");
103
- }
104
- if (opts.testLog) {
105
- writeFileSync(join(taskDir, "test.log"), "TAP version 13\n1..1\nok 1 test", "utf-8");
106
- }
107
- if (opts.gitDiff) {
108
- writeFileSync(join(taskDir, "git.diff"), "diff --git a/foo b/foo\n", "utf-8");
109
- }
110
- return taskDir;
111
- }
112
- function writeWatcherHeartbeat(instanceId, secondsAgo = 5) {
113
- const heartbeat = {
114
- last_heartbeat_at: isoSecondsAgo(secondsAgo),
115
- pid: process.pid,
116
- instance_id: instanceId,
117
- launcher_pid: process.ppid ?? null,
118
- };
119
- writeFileSync(watcherHeartbeatPath, JSON.stringify(heartbeat, null, 2), "utf-8");
120
- }
121
- function readTaskStatus(taskId) {
122
- const statusFile = join(tasksDir, taskId, "status.json");
123
- return JSON.parse(readFileSync(statusFile, "utf-8"));
124
- }
125
- // ── 1. report_only: never modifies task state ──
126
- it("report_only mode never modifies status.json", () => {
127
- buildTask({
128
- taskId: "task-rpo-001",
129
- status: "running",
130
- phase: "executing_agent",
131
- heartbeatSecondsAgo: 600, // stale
132
- childPid: DEAD_PID, // dead
133
- createdSecondsAgo: 2000,
134
- stdoutContent: "old output\n",
135
- stdoutSecondsAgo: 600,
136
- stderrContent: "stderr\n",
137
- stderrSecondsAgo: 600,
138
- });
139
- const result = reconcileTasks({ mode: "report_only" }, config);
140
- assert.equal(result.mode, "report_only");
141
- assert.equal(result.scanned, 1);
142
- assert.equal(result.candidates, 1);
143
- assert.equal(result.reconciled, 0); // no changes
144
- assert.equal(result.reports.length, 1);
145
- const report = result.reports[0];
146
- assert.equal(report.task_id, "task-rpo-001");
147
- assert.equal(report.action_taken, "left_unchanged");
148
- assert.equal(report.previous_status, null);
149
- assert.equal(report.new_status, null);
150
- // status.json must be unchanged
151
- const status = readTaskStatus("task-rpo-001");
152
- assert.equal(status.status, "running");
153
- // No backup file should exist
154
- assert.ok(!existsSync(join(tasksDir, "task-rpo-001", "status.json.bak")));
155
- // No reconcile.log should be written
156
- assert.ok(!existsSync(reconcileLogPath));
157
- assert.equal(result.reconcile_log_path, null);
158
- });
159
- // ── 2. safe_fix: only high-confidence diagnoses get applied ──
160
- it("safe_fix applies mark_failed_stale for high-confidence stale_running", () => {
161
- buildTask({
162
- taskId: "task-sf-001",
163
- status: "running",
164
- phase: "executing_agent",
165
- heartbeatSecondsAgo: 600,
166
- childPid: DEAD_PID,
167
- createdSecondsAgo: 2000,
168
- stdoutContent: "old output\n",
169
- stdoutSecondsAgo: 600,
170
- stderrContent: "stderr\n",
171
- stderrSecondsAgo: 600,
172
- });
173
- // No watcher heartbeat → task has no watcher_instance_id → no_runtime_record
174
- // → stale_running with high confidence
175
- const result = reconcileTasks({ mode: "safe_fix" }, config);
176
- assert.equal(result.mode, "safe_fix");
177
- assert.equal(result.reconciled, 1);
178
- assert.equal(result.skipped_low_confidence, 0);
179
- assert.equal(result.skipped_active_watcher, 0);
180
- const report = result.reports[0];
181
- assert.equal(report.action_taken, "marked_failed_stale");
182
- assert.equal(report.previous_status, "running");
183
- assert.equal(report.new_status, "failed_stale");
184
- assert.equal(report.applied_by, "reconcile_tasks");
185
- assert.ok(report.applied_at !== null);
186
- // status.json should reflect the new status
187
- const status = readTaskStatus("task-sf-001");
188
- assert.equal(status.status, "failed_stale");
189
- assert.equal(status.previous_status, "running");
190
- assert.equal(status.legacy_status, undefined); // only set for done_by_agent
191
- // Audit fields should be present
192
- const diagnosis = status.diagnosis;
193
- assert.equal(diagnosis.type, "stale_running");
194
- assert.equal(diagnosis.confidence, "high");
195
- assert.equal(diagnosis.applied_by, "reconcile_tasks");
196
- assert.ok(diagnosis.applied_at !== null);
197
- assert.ok(Array.isArray(diagnosis.reasons));
198
- });
199
- // ── 3. safe_fix: skips medium-confidence diagnoses ──
200
- it("safe_fix skips medium-confidence possibly_stale_running tasks", () => {
201
- buildTask({
202
- taskId: "task-sf-skip-001",
203
- status: "running",
204
- phase: "executing_agent",
205
- heartbeatSecondsAgo: 200, // possibly stale
206
- childPid: ALIVE_PID, // alive
207
- watcherInstanceId: "watcher-A",
208
- createdSecondsAgo: 2000,
209
- stdoutContent: "output\n",
210
- stdoutSecondsAgo: 400, // stale
211
- stderrContent: "stderr\n",
212
- stderrSecondsAgo: 400,
213
- });
214
- writeWatcherHeartbeat("watcher-A", 5);
215
- const result = reconcileTasks({ mode: "safe_fix" }, config);
216
- assert.equal(result.reconciled, 0);
217
- assert.equal(result.skipped_low_confidence, 1);
218
- assert.equal(result.skipped_active_watcher, 0);
219
- const report = result.reports[0];
220
- assert.equal(report.action_taken, "left_unchanged");
221
- // status.json unchanged
222
- const status = readTaskStatus("task-sf-skip-001");
223
- assert.equal(status.status, "running");
224
- assert.ok(!existsSync(join(tasksDir, "task-sf-skip-001", "status.json.bak")));
225
- });
226
- // ── 4. safe_fix: skips tasks still owned by an active watcher ──
227
- it("safe_fix skips tasks owned by an active watcher", () => {
228
- buildTask({
229
- taskId: "task-sf-owned-001",
230
- status: "running",
231
- phase: "executing_agent",
232
- heartbeatSecondsAgo: 600, // stale
233
- childPid: DEAD_PID, // dead
234
- watcherInstanceId: "watcher-A", // matches current watcher
235
- createdSecondsAgo: 2000,
236
- stdoutContent: "old output\n",
237
- stdoutSecondsAgo: 600,
238
- stderrContent: "stderr\n",
239
- stderrSecondsAgo: 600,
240
- });
241
- writeWatcherHeartbeat("watcher-A", 5);
242
- const result = reconcileTasks({ mode: "safe_fix" }, config);
243
- assert.equal(result.reconciled, 0);
244
- assert.equal(result.skipped_active_watcher, 1);
245
- const report = result.reports[0];
246
- assert.equal(report.action_taken, "left_unchanged");
247
- assert.ok(report.reasons.some((r) => r.includes("active watcher")));
248
- // status.json unchanged
249
- const status = readTaskStatus("task-sf-owned-001");
250
- assert.equal(status.status, "running");
251
- assert.ok(!existsSync(join(tasksDir, "task-sf-owned-001", "status.json.bak")));
252
- });
253
- // ── 5. safe_fix: writes status.json.bak backup ──
254
- it("safe_fix writes status.json.bak with original content before changing", () => {
255
- buildTask({
256
- taskId: "task-sf-bak-001",
257
- status: "running",
258
- phase: "executing_agent",
259
- heartbeatSecondsAgo: 600,
260
- childPid: DEAD_PID,
261
- createdSecondsAgo: 2000,
262
- stdoutContent: "old output\n",
263
- stdoutSecondsAgo: 600,
264
- stderrContent: "stderr\n",
265
- stderrSecondsAgo: 600,
266
- });
267
- const originalStatusRaw = readFileSync(join(tasksDir, "task-sf-bak-001", "status.json"), "utf-8");
268
- reconcileTasks({ mode: "safe_fix" }, config);
269
- const backupPath = join(tasksDir, "task-sf-bak-001", "status.json.bak");
270
- assert.ok(existsSync(backupPath), "status.json.bak should exist after safe_fix");
271
- const backupContent = readFileSync(backupPath, "utf-8");
272
- assert.equal(backupContent, originalStatusRaw, "backup must match original status.json content");
273
- });
274
- // ── 6. safe_fix: writes reconcile.log with append semantics ──
275
- it("safe_fix writes reconcile.log at .patchwarden root", () => {
276
- buildTask({
277
- taskId: "task-sf-log-001",
278
- status: "running",
279
- phase: "executing_agent",
280
- heartbeatSecondsAgo: 600,
281
- childPid: DEAD_PID,
282
- createdSecondsAgo: 2000,
283
- stdoutContent: "old output\n",
284
- stdoutSecondsAgo: 600,
285
- stderrContent: "stderr\n",
286
- stderrSecondsAgo: 600,
287
- });
288
- const result = reconcileTasks({ mode: "safe_fix" }, config);
289
- assert.ok(result.reconcile_log_path !== null);
290
- assert.ok(existsSync(reconcileLogPath), "reconcile.log should exist");
291
- const logContent = readFileSync(reconcileLogPath, "utf-8");
292
- const logLines = logContent.trim().split("\n");
293
- assert.ok(logLines.length >= 1);
294
- const logEntry = JSON.parse(logLines[0]);
295
- assert.equal(logEntry.task_id, "task-sf-log-001");
296
- assert.equal(logEntry.previous_status, "running");
297
- assert.equal(logEntry.new_status, "failed_stale");
298
- assert.equal(logEntry.diagnosis, "stale_running");
299
- assert.equal(logEntry.confidence, "high");
300
- assert.equal(logEntry.applied_by, "reconcile_tasks");
301
- });
302
- // ── 7. safe_fix: appends to existing reconcile.log (does not overwrite) ──
303
- it("safe_fix appends to existing reconcile.log without overwriting", () => {
304
- // Pre-existing log content
305
- mkdirSync(dirname(reconcileLogPath), { recursive: true });
306
- writeFileSync(reconcileLogPath, JSON.stringify({
307
- timestamp: isoSecondsAgo(3600),
308
- task_id: "prior-task",
309
- previous_status: "running",
310
- new_status: "failed_stale",
311
- }) + "\n", "utf-8");
312
- buildTask({
313
- taskId: "task-sf-append-001",
314
- status: "running",
315
- phase: "executing_agent",
316
- heartbeatSecondsAgo: 600,
317
- childPid: DEAD_PID,
318
- createdSecondsAgo: 2000,
319
- stdoutContent: "old output\n",
320
- stdoutSecondsAgo: 600,
321
- stderrContent: "stderr\n",
322
- stderrSecondsAgo: 600,
323
- });
324
- reconcileTasks({ mode: "safe_fix" }, config);
325
- const logContent = readFileSync(reconcileLogPath, "utf-8");
326
- const logLines = logContent.trim().split("\n");
327
- assert.ok(logLines.length >= 2, "log should contain prior + new entries");
328
- const firstEntry = JSON.parse(logLines[0]);
329
- assert.equal(firstEntry.task_id, "prior-task");
330
- const newEntry = logLines
331
- .map((l) => JSON.parse(l))
332
- .find((e) => e.task_id === "task-sf-append-001");
333
- assert.ok(newEntry, "new task entry should be appended");
334
- assert.equal(newEntry.new_status, "failed_stale");
335
- });
336
- // ── 8. safe_fix: done_candidate → done_by_agent with acceptance_status=pending ──
337
- it("safe_fix marks done_by_agent and sets acceptance_status=pending + legacy_status=done", () => {
338
- buildTask({
339
- taskId: "task-sf-donecand-001",
340
- status: "running",
341
- phase: "executing_agent",
342
- heartbeatSecondsAgo: 600,
343
- childPid: DEAD_PID,
344
- createdSecondsAgo: 2000,
345
- stdoutContent: "done\n",
346
- stdoutSecondsAgo: 600,
347
- stderrContent: "stderr\n",
348
- stderrSecondsAgo: 600,
349
- resultMd: true,
350
- testLog: true,
351
- gitDiff: true,
352
- });
353
- // No watcher heartbeat → orphaned_running, but done_candidate takes priority
354
- const result = reconcileTasks({ mode: "safe_fix" }, config);
355
- assert.equal(result.reconciled, 1);
356
- const report = result.reports[0];
357
- assert.equal(report.action_taken, "marked_done_by_agent");
358
- assert.equal(report.new_status, "done_by_agent");
359
- const status = readTaskStatus("task-sf-donecand-001");
360
- assert.equal(status.status, "done_by_agent");
361
- assert.equal(status.acceptance_status, "pending");
362
- assert.equal(status.legacy_status, "done");
363
- assert.equal(status.previous_status, "running");
364
- });
365
- // ── 9. safe_fix: orphaned_running → orphaned ──
366
- it("safe_fix marks orphaned when watcher instance mismatches", () => {
367
- buildTask({
368
- taskId: "task-sf-orphan-001",
369
- status: "running",
370
- phase: "executing_agent",
371
- heartbeatSecondsAgo: 30, // fresh
372
- childPid: ALIVE_PID,
373
- watcherInstanceId: "watcher-old", // mismatch
374
- createdSecondsAgo: 2000,
375
- stdoutContent: "output\n",
376
- stdoutSecondsAgo: 10,
377
- stderrContent: "stderr\n",
378
- stderrSecondsAgo: 10,
379
- });
380
- writeWatcherHeartbeat("watcher-new", 5);
381
- const result = reconcileTasks({ mode: "safe_fix" }, config);
382
- // High confidence orphaned_running, not owned by current watcher
383
- assert.equal(result.reconciled, 1);
384
- const report = result.reports[0];
385
- assert.equal(report.action_taken, "marked_orphaned");
386
- assert.equal(report.new_status, "orphaned");
387
- const status = readTaskStatus("task-sf-orphan-001");
388
- assert.equal(status.status, "orphaned");
389
- assert.equal(status.previous_status, "running");
390
- });
391
- // ── 10. Age filter: tasks younger than max_age_minutes are skipped ──
392
- it("skips tasks younger than max_age_minutes", () => {
393
- buildTask({
394
- taskId: "task-young-001",
395
- status: "running",
396
- phase: "executing_agent",
397
- heartbeatSecondsAgo: 10, // fresh — active
398
- childPid: ALIVE_PID,
399
- watcherInstanceId: "watcher-A",
400
- createdSecondsAgo: 60, // only 1 minute old
401
- stdoutContent: "running\n",
402
- stdoutSecondsAgo: 5,
403
- stderrContent: "stderr\n",
404
- stderrSecondsAgo: 5,
405
- });
406
- writeWatcherHeartbeat("watcher-A", 3);
407
- const result = reconcileTasks({ mode: "report_only", max_age_minutes: 30 }, config);
408
- assert.equal(result.scanned, 1);
409
- assert.equal(result.candidates, 0); // too young
410
- assert.equal(result.reports.length, 0);
411
- });
412
- // ── 11. Non-running tasks are not candidates ──
413
- it("does not consider terminal tasks as candidates", () => {
414
- buildTask({
415
- taskId: "task-done-001",
416
- status: "done",
417
- phase: "completed",
418
- createdSecondsAgo: 1000,
419
- });
420
- buildTask({
421
- taskId: "task-failed-001",
422
- status: "failed",
423
- phase: "failed",
424
- createdSecondsAgo: 1000,
425
- });
426
- const result = reconcileTasks({ mode: "report_only" }, config);
427
- assert.equal(result.scanned, 2);
428
- assert.equal(result.candidates, 0);
429
- });
430
- // ── 12. Empty tasks dir returns zero-scanned result ──
431
- it("returns empty result when tasks dir is empty", () => {
432
- const result = reconcileTasks({ mode: "report_only" }, config);
433
- assert.equal(result.scanned, 0);
434
- assert.equal(result.candidates, 0);
435
- assert.equal(result.reports.length, 0);
436
- assert.equal(result.reconcile_log_path, null);
437
- });
438
- // ── 13. No temp file left behind after successful atomic write ──
439
- it("does not leave status.json.tmp behind after safe_fix", () => {
440
- buildTask({
441
- taskId: "task-sf-notmp-001",
442
- status: "running",
443
- phase: "executing_agent",
444
- heartbeatSecondsAgo: 600,
445
- childPid: DEAD_PID,
446
- createdSecondsAgo: 2000,
447
- stdoutContent: "old output\n",
448
- stdoutSecondsAgo: 600,
449
- stderrContent: "stderr\n",
450
- stderrSecondsAgo: 600,
451
- });
452
- reconcileTasks({ mode: "safe_fix" }, config);
453
- const tmpPath = join(tasksDir, "task-sf-notmp-001", "status.json.tmp");
454
- assert.ok(!existsSync(tmpPath), "status.json.tmp should not exist after rename");
455
- });
456
- });
@@ -1 +0,0 @@
1
- export {};