patchwarden 1.5.1 → 1.6.2

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 (591) hide show
  1. package/PatchWarden.cmd +32 -2
  2. package/README.en.md +158 -26
  3. package/README.md +124 -24
  4. package/dist/assessments/agentAssessor.js +21 -12
  5. package/dist/assessments/assessmentDiagnostics.d.ts +29 -0
  6. package/dist/assessments/assessmentDiagnostics.js +132 -0
  7. package/dist/assessments/assessmentStore.d.ts +39 -0
  8. package/dist/assessments/assessmentStore.js +207 -45
  9. package/dist/assessments/securitySnapshot.d.ts +50 -0
  10. package/dist/assessments/securitySnapshot.js +158 -0
  11. package/dist/config.d.ts +15 -0
  12. package/dist/config.js +66 -13
  13. package/dist/control/fileManager.d.ts +2 -0
  14. package/dist/control/fileManager.js +39 -0
  15. package/dist/control/middleware/auth.d.ts +6 -0
  16. package/dist/control/middleware/auth.js +14 -5
  17. package/dist/control/middleware/static.js +16 -3
  18. package/dist/control/routeTable.d.ts +24 -0
  19. package/dist/control/routeTable.js +263 -0
  20. package/dist/control/routes/audit.js +17 -7
  21. package/dist/control/routes/evidence.js +1 -1
  22. package/dist/control/routes/lineage.js +1 -1
  23. package/dist/control/routes/process.d.ts +7 -0
  24. package/dist/control/routes/process.js +329 -42
  25. package/dist/control/routes/sessions.d.ts +9 -1
  26. package/dist/control/routes/sessions.js +84 -21
  27. package/dist/control/routes/status.d.ts +60 -1
  28. package/dist/control/routes/status.js +94 -15
  29. package/dist/control/routes/taskActions.js +24 -60
  30. package/dist/control/routes/tasks.d.ts +4 -0
  31. package/dist/control/routes/tasks.js +61 -62
  32. package/dist/control/routes/workspace.js +50 -23
  33. package/dist/control/runtime.d.ts +3 -2
  34. package/dist/control/runtime.js +65 -40
  35. package/dist/control/server.js +37 -365
  36. package/dist/control/shared.d.ts +25 -1
  37. package/dist/control/shared.js +64 -11
  38. package/dist/diagnostics/allowedTestCommandSafety.d.ts +1 -0
  39. package/dist/diagnostics/allowedTestCommandSafety.js +11 -0
  40. package/dist/direct/directAudit.js +234 -225
  41. package/dist/direct/directGuards.d.ts +2 -1
  42. package/dist/direct/directGuards.js +42 -29
  43. package/dist/direct/directPatch.d.ts +6 -1
  44. package/dist/direct/directPatch.js +55 -8
  45. package/dist/direct/directSessionStore.d.ts +16 -6
  46. package/dist/direct/directSessionStore.js +128 -35
  47. package/dist/direct/directVerification.js +8 -16
  48. package/dist/doctor.js +65 -57
  49. package/dist/goal/acceptanceEngine.d.ts +1 -1
  50. package/dist/goal/goalProgress.js +75 -69
  51. package/dist/goal/goalReport.js +5 -12
  52. package/dist/goal/goalStatus.d.ts +2 -0
  53. package/dist/goal/goalStatus.js +10 -3
  54. package/dist/goal/goalStore.d.ts +9 -2
  55. package/dist/goal/goalStore.js +152 -45
  56. package/dist/goal/handoffExport.js +6 -6
  57. package/dist/goal/specKitImport.js +97 -96
  58. package/dist/goal/subgoalSync.js +11 -9
  59. package/dist/goal/worktreeManager.d.ts +2 -0
  60. package/dist/goal/worktreeManager.js +209 -136
  61. package/dist/httpServer.js +111 -32
  62. package/dist/logging.js +5 -3
  63. package/dist/policy/projectPolicy.js +5 -2
  64. package/dist/release/releaseGate.d.ts +1 -1
  65. package/dist/release/releaseGate.js +78 -25
  66. package/dist/runner/agentInvocation.d.ts +14 -0
  67. package/dist/runner/agentInvocation.js +96 -4
  68. package/dist/runner/changeCapture.d.ts +13 -5
  69. package/dist/runner/changeCapture.js +243 -61
  70. package/dist/runner/postTaskCleanup.js +48 -19
  71. package/dist/runner/processSecurity.d.ts +56 -0
  72. package/dist/runner/processSecurity.js +373 -0
  73. package/dist/runner/runTask.d.ts +2 -1
  74. package/dist/runner/runTask.js +162 -93
  75. package/dist/runner/simpleProcess.d.ts +3 -0
  76. package/dist/runner/simpleProcess.js +50 -36
  77. package/dist/{taskProgress.d.ts → runner/taskProgress.d.ts} +1 -1
  78. package/dist/{taskProgress.js → runner/taskProgress.js} +2 -2
  79. package/dist/{taskRuntime.d.ts → runner/taskRuntime.d.ts} +3 -1
  80. package/dist/{taskRuntime.js → runner/taskRuntime.js} +3 -2
  81. package/dist/runner/taskStatusStore.d.ts +11 -0
  82. package/dist/runner/taskStatusStore.js +35 -0
  83. package/dist/runner/watch.d.ts +14 -1
  84. package/dist/runner/watch.js +320 -49
  85. package/dist/security/contentRedaction.js +2 -2
  86. package/dist/security/discoveryTokenStore.d.ts +3 -2
  87. package/dist/security/discoveryTokenStore.js +17 -2
  88. package/dist/security/loopbackHost.d.ts +2 -0
  89. package/dist/security/loopbackHost.js +16 -0
  90. package/dist/security/pathGuard.js +32 -17
  91. package/dist/security/planGuard.js +2 -1
  92. package/dist/security/runtimeGuard.js +9 -6
  93. package/dist/security/secretComparison.d.ts +3 -0
  94. package/dist/security/secretComparison.js +11 -0
  95. package/dist/security/sensitiveGuard.d.ts +5 -0
  96. package/dist/security/sensitiveGuard.js +27 -8
  97. package/dist/security/toolInvocationGuard.d.ts +2 -2
  98. package/dist/security/toolInvocationGuard.js +1 -1
  99. package/dist/security/workspaceRootGuard.d.ts +8 -0
  100. package/dist/security/workspaceRootGuard.js +47 -0
  101. package/dist/smoke-test.js +27 -26
  102. package/dist/tools/catalog/index.d.ts +4 -0
  103. package/dist/tools/catalog/index.js +4 -0
  104. package/dist/tools/{toolCatalog.js → catalog/toolCatalog.js} +3 -12
  105. package/dist/tools/{toolRegistry.d.ts → catalog/toolRegistry.d.ts} +3 -3
  106. package/dist/tools/{toolRegistry.js → catalog/toolRegistry.js} +6 -15
  107. package/dist/tools/definitions/toolDefs.d.ts +18 -0
  108. package/dist/tools/definitions/toolDefs.js +1177 -0
  109. package/dist/tools/{auditSession.d.ts → diagnostics/auditSession.d.ts} +1 -1
  110. package/dist/tools/{auditSession.js → diagnostics/auditSession.js} +2 -2
  111. package/dist/tools/{auditTask.d.ts → diagnostics/auditTask.d.ts} +2 -1
  112. package/dist/tools/{auditTask.js → diagnostics/auditTask.js} +134 -36
  113. package/dist/tools/{healthCheck.d.ts → diagnostics/healthCheck.d.ts} +18 -6
  114. package/dist/tools/{healthCheck.js → diagnostics/healthCheck.js} +36 -8
  115. package/dist/tools/diagnostics/index.d.ts +6 -0
  116. package/dist/tools/diagnostics/index.js +6 -0
  117. package/dist/tools/{safeStatus.d.ts → diagnostics/safeStatus.d.ts} +3 -3
  118. package/dist/tools/{safeStatus.js → diagnostics/safeStatus.js} +6 -6
  119. package/dist/tools/{safeViews.d.ts → diagnostics/safeViews.d.ts} +12 -8
  120. package/dist/tools/{safeViews.js → diagnostics/safeViews.js} +23 -13
  121. package/dist/tools/{schemaDriftCheck.d.ts → diagnostics/schemaDriftCheck.d.ts} +1 -1
  122. package/dist/tools/{schemaDriftCheck.js → diagnostics/schemaDriftCheck.js} +2 -2
  123. package/dist/tools/{createDirectSession.js → direct/createDirectSession.js} +6 -6
  124. package/dist/tools/{finalizeDirectSession.d.ts → direct/finalizeDirectSession.d.ts} +1 -1
  125. package/dist/tools/direct/finalizeDirectSession.js +86 -0
  126. package/dist/tools/direct/index.d.ts +3 -0
  127. package/dist/tools/direct/index.js +3 -0
  128. package/dist/tools/{runDirectVerificationBundle.js → direct/runDirectVerificationBundle.js} +2 -2
  129. package/dist/tools/{discoverTools.d.ts → discovery/discoverTools.d.ts} +2 -2
  130. package/dist/tools/{discoverTools.js → discovery/discoverTools.js} +5 -5
  131. package/dist/tools/{explainTool.d.ts → discovery/explainTool.d.ts} +2 -2
  132. package/dist/tools/{explainTool.js → discovery/explainTool.js} +2 -2
  133. package/dist/tools/discovery/index.d.ts +3 -0
  134. package/dist/tools/discovery/index.js +3 -0
  135. package/dist/tools/{invokeDiscoveredTool.d.ts → discovery/invokeDiscoveredTool.d.ts} +2 -2
  136. package/dist/tools/{invokeDiscoveredTool.js → discovery/invokeDiscoveredTool.js} +5 -5
  137. package/dist/tools/dispatch/coreDispatch.js +32 -31
  138. package/dist/tools/dispatch/diagnosticDispatch.d.ts +3 -5
  139. package/dist/tools/dispatch/diagnosticDispatch.js +70 -68
  140. package/dist/tools/dispatch/directDispatch.js +11 -10
  141. package/dist/tools/dispatch/goalDispatch.js +5 -4
  142. package/dist/tools/dispatch/releaseDispatch.js +3 -2
  143. package/dist/tools/dispatch/validation.d.ts +7 -0
  144. package/dist/tools/dispatch/validation.js +71 -0
  145. package/dist/tools/{getPlan.js → goals/getPlan.js} +4 -4
  146. package/dist/tools/{goalSubgoalTask.d.ts → goals/goalSubgoalTask.d.ts} +1 -1
  147. package/dist/tools/goals/goalSubgoalTask.js +118 -0
  148. package/dist/tools/goals/index.d.ts +3 -0
  149. package/dist/tools/goals/index.js +3 -0
  150. package/dist/tools/{savePlan.js → goals/savePlan.js} +28 -8
  151. package/dist/tools/registry.d.ts +7 -11
  152. package/dist/tools/registry.js +17 -1178
  153. package/dist/tools/{checkReleaseGate.d.ts → release/checkReleaseGate.d.ts} +1 -1
  154. package/dist/tools/{checkReleaseGate.js → release/checkReleaseGate.js} +3 -3
  155. package/dist/tools/release/index.d.ts +2 -0
  156. package/dist/tools/release/index.js +2 -0
  157. package/dist/tools/{releaseMode.d.ts → release/releaseMode.d.ts} +2 -2
  158. package/dist/tools/{releaseMode.js → release/releaseMode.js} +46 -26
  159. package/dist/tools/tasks/cancelTask.d.ts +11 -0
  160. package/dist/tools/tasks/cancelTask.js +86 -0
  161. package/dist/tools/{createTask.d.ts → tasks/createTask.d.ts} +12 -4
  162. package/dist/tools/{createTask.js → tasks/createTask.js} +110 -34
  163. package/dist/tools/{diagnoseTask.d.ts → tasks/diagnoseTask.d.ts} +1 -1
  164. package/dist/tools/{diagnoseTask.js → tasks/diagnoseTask.js} +12 -16
  165. package/dist/tools/{evidencePack.js → tasks/evidencePack.js} +34 -22
  166. package/dist/tools/{getTaskFile.js → tasks/getTaskFile.js} +4 -4
  167. package/dist/tools/{getTaskStatus.d.ts → tasks/getTaskStatus.d.ts} +6 -1
  168. package/dist/tools/{getTaskStatus.js → tasks/getTaskStatus.js} +11 -6
  169. package/dist/tools/{getTaskStdoutTail.js → tasks/getTaskStdoutTail.js} +13 -11
  170. package/dist/tools/{getTaskSummary.js → tasks/getTaskSummary.js} +35 -36
  171. package/dist/tools/tasks/index.d.ts +18 -0
  172. package/dist/tools/tasks/index.js +18 -0
  173. package/dist/tools/tasks/killTask.d.ts +1 -0
  174. package/dist/tools/{listTasks.d.ts → tasks/listTasks.d.ts} +1 -1
  175. package/dist/tools/{listTasks.js → tasks/listTasks.js} +5 -4
  176. package/dist/tools/{reconcileTasks.d.ts → tasks/reconcileTasks.d.ts} +3 -2
  177. package/dist/tools/tasks/reconcileTasks.js +496 -0
  178. package/dist/tools/tasks/retryTask.js +60 -0
  179. package/dist/tools/{runTaskLoop.d.ts → tasks/runTaskLoop.d.ts} +6 -6
  180. package/dist/tools/{runTaskLoop.js → tasks/runTaskLoop.js} +63 -41
  181. package/dist/tools/tasks/runVerification.js +38 -0
  182. package/dist/tools/{taskLineage.js → tasks/taskLineage.js} +8 -7
  183. package/dist/tools/{taskOutputs.d.ts → tasks/taskOutputs.d.ts} +2 -2
  184. package/dist/tools/{taskOutputs.js → tasks/taskOutputs.js} +17 -16
  185. package/dist/tools/tasks/taskStates.d.ts +6 -0
  186. package/dist/tools/tasks/taskStates.js +52 -0
  187. package/dist/tools/{waitForTask.js → tasks/waitForTask.js} +3 -11
  188. package/dist/tools/{androidDoctor.js → workspace/androidDoctor.js} +16 -10
  189. package/dist/tools/{applyPatch.d.ts → workspace/applyPatch.d.ts} +1 -1
  190. package/dist/tools/workspace/applyPatch.js +53 -0
  191. package/dist/tools/{discardWorktree.js → workspace/discardWorktree.js} +3 -3
  192. package/dist/tools/workspace/index.d.ts +10 -0
  193. package/dist/tools/workspace/index.js +10 -0
  194. package/dist/tools/workspace/listAgents.d.ts +23 -0
  195. package/dist/tools/workspace/listAgents.js +56 -0
  196. package/dist/tools/{listWorkspace.js → workspace/listWorkspace.js} +3 -3
  197. package/dist/tools/{mergeWorktree.js → workspace/mergeWorktree.js} +3 -3
  198. package/dist/tools/{readWorkspaceFile.js → workspace/readWorkspaceFile.js} +8 -8
  199. package/dist/tools/{recommendAgentForTask.js → workspace/recommendAgentForTask.js} +3 -3
  200. package/dist/tools/{searchWorkspace.js → workspace/searchWorkspace.js} +5 -5
  201. package/dist/tools/{syncFile.d.ts → workspace/syncFile.d.ts} +1 -1
  202. package/dist/tools/workspace/syncFile.js +134 -0
  203. package/dist/utils/atomicFile.d.ts +7 -0
  204. package/dist/utils/atomicFile.js +67 -0
  205. package/dist/utils/boundedFile.d.ts +8 -0
  206. package/dist/utils/boundedFile.js +93 -0
  207. package/dist/utils/lockedJsonFile.d.ts +15 -0
  208. package/dist/utils/lockedJsonFile.js +224 -0
  209. package/dist/utils/platform.d.ts +11 -0
  210. package/dist/utils/platform.js +26 -0
  211. package/dist/utils/stableJson.d.ts +2 -0
  212. package/dist/utils/stableJson.js +12 -0
  213. package/dist/version.d.ts +3 -2
  214. package/dist/version.js +3 -2
  215. package/dist/watcherStatus.d.ts +2 -2
  216. package/dist/watcherStatus.js +18 -0
  217. package/docs/CODE_WIKI.md +808 -143
  218. package/docs/architecture.md +15 -55
  219. package/docs/assets/patchwarden-desktop-onboarding.png +0 -0
  220. package/docs/control-center/README.md +4 -4
  221. package/docs/dashboard-overview.md +4 -4
  222. package/docs/desktop-app.md +175 -0
  223. package/docs/evidence-pack-schema.md +3 -3
  224. package/docs/open-source-application.md +16 -11
  225. package/docs/release-checklist.md +1 -1
  226. package/docs/release-evidence.md +35 -39
  227. package/docs/task-safe-review-workflow.md +5 -5
  228. package/docs/threat-model.md +19 -1
  229. package/examples/config.example.json +4 -2
  230. package/package.json +27 -10
  231. package/scripts/README.md +15 -6
  232. package/scripts/build.js +11 -0
  233. package/scripts/checks/brand-check.js +3 -0
  234. package/scripts/checks/build-output-check.js +37 -0
  235. package/scripts/checks/control-center-smoke.js +102 -10
  236. package/scripts/checks/control-smoke.js +19 -8
  237. package/scripts/checks/http-mcp-smoke.js +82 -4
  238. package/scripts/checks/lifecycle-smoke.js +15 -12
  239. package/scripts/checks/mcp-manifest-check.js +1 -1
  240. package/scripts/checks/mcp-smoke.js +58 -4
  241. package/scripts/checks/package-manifest-check.js +20 -7
  242. package/scripts/checks/unit-tests.js +3 -5
  243. package/scripts/checks/watcher-supervisor-smoke.js +38 -1
  244. package/scripts/control/get-patchwarden-health.ps1 +1 -1
  245. package/scripts/control/manage-patchwarden.ps1 +69 -4
  246. package/scripts/control/provision-patchwarden-tunnel.ps1 +127 -0
  247. package/scripts/control/run-background-supervisor.ps1 +41 -0
  248. package/scripts/control/start-patchwarden-tunnel.ps1 +191 -33
  249. package/scripts/e2e/demo-runtime.mjs +153 -0
  250. package/{PatchWarden-Control-Tray.cmd → scripts/launchers/PatchWarden-Control-Tray.cmd} +3 -3
  251. package/scripts/launchers/PatchWarden-Control.cmd +6 -0
  252. package/{PatchWarden-Desktop.cmd → scripts/launchers/PatchWarden-Desktop.cmd} +2 -2
  253. package/scripts/launchers/Restart-PatchWarden-Control.cmd +6 -0
  254. package/{Stop-PatchWarden.cmd → scripts/launchers/Stop-PatchWarden.cmd} +2 -2
  255. package/scripts/lib/clean-generated-output.js +11 -0
  256. package/scripts/lib/file-discovery.js +12 -0
  257. package/scripts/release/desktop-preflight.js +211 -0
  258. package/scripts/release/pack-clean.js +59 -14
  259. package/src/assessments/agentAssessor.ts +26 -12
  260. package/src/assessments/assessmentDiagnostics.ts +172 -0
  261. package/src/assessments/assessmentStore.ts +288 -51
  262. package/src/assessments/securitySnapshot.ts +231 -0
  263. package/src/config.ts +70 -13
  264. package/src/control/fileManager.ts +40 -0
  265. package/src/control/middleware/auth.ts +22 -4
  266. package/src/control/middleware/static.ts +16 -3
  267. package/src/control/routeTable.ts +301 -0
  268. package/src/control/routes/audit.ts +14 -6
  269. package/src/control/routes/evidence.ts +1 -1
  270. package/src/control/routes/lineage.ts +1 -1
  271. package/src/control/routes/process.ts +341 -40
  272. package/src/control/routes/sessions.ts +88 -25
  273. package/src/control/routes/status.ts +134 -17
  274. package/src/control/routes/taskActions.ts +24 -58
  275. package/src/control/routes/tasks.ts +66 -58
  276. package/src/control/routes/workspace.ts +56 -25
  277. package/src/control/runtime.ts +71 -43
  278. package/src/control/server.ts +37 -342
  279. package/src/control/shared.ts +77 -11
  280. package/src/diagnostics/allowedTestCommandSafety.ts +12 -0
  281. package/src/direct/directAudit.ts +17 -9
  282. package/src/direct/directGuards.ts +72 -44
  283. package/src/direct/directPatch.ts +95 -8
  284. package/src/direct/directSessionStore.ts +213 -55
  285. package/src/direct/directVerification.ts +9 -23
  286. package/src/doctor.ts +76 -64
  287. package/src/goal/acceptanceEngine.ts +1 -1
  288. package/src/goal/goalProgress.ts +17 -13
  289. package/src/goal/goalReport.ts +5 -13
  290. package/src/goal/goalStatus.ts +19 -3
  291. package/src/goal/goalStore.ts +241 -54
  292. package/src/goal/handoffExport.ts +6 -6
  293. package/src/goal/specKitImport.ts +12 -12
  294. package/src/goal/subgoalSync.ts +11 -8
  295. package/src/goal/worktreeManager.ts +139 -22
  296. package/src/httpServer.ts +113 -30
  297. package/src/logging.ts +10 -3
  298. package/src/policy/projectPolicy.ts +5 -2
  299. package/src/release/releaseGate.ts +74 -27
  300. package/src/runner/agentInvocation.ts +126 -4
  301. package/src/runner/changeCapture.ts +291 -57
  302. package/src/runner/postTaskCleanup.ts +41 -17
  303. package/src/runner/processSecurity.ts +433 -0
  304. package/src/runner/runTask.ts +197 -97
  305. package/src/runner/simpleProcess.ts +66 -31
  306. package/src/{taskProgress.ts → runner/taskProgress.ts} +3 -3
  307. package/src/{taskRuntime.ts → runner/taskRuntime.ts} +6 -3
  308. package/src/runner/taskStatusStore.ts +69 -0
  309. package/src/runner/watch.ts +348 -52
  310. package/src/security/contentRedaction.ts +2 -2
  311. package/src/security/discoveryTokenStore.ts +18 -4
  312. package/src/security/loopbackHost.ts +19 -0
  313. package/src/security/pathGuard.ts +35 -16
  314. package/src/security/planGuard.ts +2 -1
  315. package/src/security/runtimeGuard.ts +9 -6
  316. package/src/security/secretComparison.ts +13 -0
  317. package/src/security/sensitiveGuard.ts +27 -8
  318. package/src/security/toolInvocationGuard.ts +2 -2
  319. package/src/security/workspaceRootGuard.ts +53 -0
  320. package/src/smoke-test.ts +27 -26
  321. package/src/tools/catalog/index.ts +4 -0
  322. package/src/tools/{toolCatalog.ts → catalog/toolCatalog.ts} +3 -12
  323. package/src/tools/{toolRegistry.ts → catalog/toolRegistry.ts} +7 -16
  324. package/src/tools/definitions/toolDefs.ts +1264 -0
  325. package/src/tools/{auditSession.ts → diagnostics/auditSession.ts} +2 -2
  326. package/src/tools/{auditTask.ts → diagnostics/auditTask.ts} +136 -39
  327. package/src/tools/{healthCheck.ts → diagnostics/healthCheck.ts} +37 -9
  328. package/src/tools/diagnostics/index.ts +6 -0
  329. package/src/tools/{safeStatus.ts → diagnostics/safeStatus.ts} +7 -7
  330. package/src/tools/{safeViews.ts → diagnostics/safeViews.ts} +27 -17
  331. package/src/tools/{schemaDriftCheck.ts → diagnostics/schemaDriftCheck.ts} +3 -3
  332. package/src/tools/{createDirectSession.ts → direct/createDirectSession.ts} +6 -6
  333. package/src/tools/{finalizeDirectSession.ts → direct/finalizeDirectSession.ts} +7 -5
  334. package/src/tools/direct/index.ts +3 -0
  335. package/src/tools/{runDirectVerificationBundle.ts → direct/runDirectVerificationBundle.ts} +2 -2
  336. package/src/tools/{discoverTools.ts → discovery/discoverTools.ts} +6 -6
  337. package/src/tools/{explainTool.ts → discovery/explainTool.ts} +3 -3
  338. package/src/tools/discovery/index.ts +3 -0
  339. package/src/tools/{invokeDiscoveredTool.ts → discovery/invokeDiscoveredTool.ts} +7 -7
  340. package/src/tools/dispatch/coreDispatch.ts +36 -31
  341. package/src/tools/dispatch/diagnosticDispatch.ts +26 -21
  342. package/src/tools/dispatch/directDispatch.ts +11 -10
  343. package/src/tools/dispatch/goalDispatch.ts +5 -4
  344. package/src/tools/dispatch/releaseDispatch.ts +3 -2
  345. package/src/tools/dispatch/validation.ts +78 -0
  346. package/src/tools/{getPlan.ts → goals/getPlan.ts} +4 -4
  347. package/src/tools/{goalSubgoalTask.ts → goals/goalSubgoalTask.ts} +41 -26
  348. package/src/tools/goals/index.ts +3 -0
  349. package/src/tools/{savePlan.ts → goals/savePlan.ts} +38 -8
  350. package/src/tools/registry.ts +17 -1261
  351. package/src/tools/{checkReleaseGate.ts → release/checkReleaseGate.ts} +3 -3
  352. package/src/tools/release/index.ts +2 -0
  353. package/src/tools/{releaseMode.ts → release/releaseMode.ts} +42 -24
  354. package/src/tools/tasks/cancelTask.ts +110 -0
  355. package/src/tools/{createTask.ts → tasks/createTask.ts} +161 -33
  356. package/src/tools/{diagnoseTask.ts → tasks/diagnoseTask.ts} +12 -16
  357. package/src/tools/{evidencePack.ts → tasks/evidencePack.ts} +36 -22
  358. package/src/tools/{getTaskFile.ts → tasks/getTaskFile.ts} +4 -4
  359. package/src/tools/{getTaskStatus.ts → tasks/getTaskStatus.ts} +13 -6
  360. package/src/tools/{getTaskStdoutTail.ts → tasks/getTaskStdoutTail.ts} +13 -11
  361. package/src/tools/{getTaskSummary.ts → tasks/getTaskSummary.ts} +46 -44
  362. package/src/tools/tasks/index.ts +18 -0
  363. package/src/tools/{listTasks.ts → tasks/listTasks.ts} +6 -5
  364. package/src/tools/{reconcileTasks.ts → tasks/reconcileTasks.ts} +228 -77
  365. package/src/tools/tasks/retryTask.ts +69 -0
  366. package/src/tools/{runTaskLoop.ts → tasks/runTaskLoop.ts} +73 -46
  367. package/src/tools/{runVerification.ts → tasks/runVerification.ts} +6 -3
  368. package/src/tools/{taskLineage.ts → tasks/taskLineage.ts} +8 -7
  369. package/src/tools/{taskOutputs.ts → tasks/taskOutputs.ts} +27 -20
  370. package/src/tools/tasks/taskStates.ts +54 -0
  371. package/src/tools/{waitForTask.ts → tasks/waitForTask.ts} +3 -12
  372. package/src/tools/{androidDoctor.ts → workspace/androidDoctor.ts} +15 -10
  373. package/src/tools/{applyPatch.ts → workspace/applyPatch.ts} +38 -16
  374. package/src/tools/{discardWorktree.ts → workspace/discardWorktree.ts} +3 -3
  375. package/src/tools/workspace/index.ts +10 -0
  376. package/src/tools/workspace/listAgents.ts +75 -0
  377. package/src/tools/{listWorkspace.ts → workspace/listWorkspace.ts} +3 -3
  378. package/src/tools/{mergeWorktree.ts → workspace/mergeWorktree.ts} +3 -3
  379. package/src/tools/{readWorkspaceFile.ts → workspace/readWorkspaceFile.ts} +8 -8
  380. package/src/tools/{recommendAgentForTask.ts → workspace/recommendAgentForTask.ts} +3 -3
  381. package/src/tools/{searchWorkspace.ts → workspace/searchWorkspace.ts} +5 -5
  382. package/src/tools/workspace/syncFile.ts +292 -0
  383. package/src/utils/atomicFile.ts +74 -0
  384. package/src/utils/boundedFile.ts +116 -0
  385. package/src/utils/lockedJsonFile.ts +251 -0
  386. package/src/utils/platform.ts +31 -0
  387. package/src/utils/stableJson.ts +12 -0
  388. package/src/version.ts +3 -2
  389. package/src/watcherStatus.ts +19 -1
  390. package/ui/desktop-bootstrap.js +11 -0
  391. package/ui/desktop-bridge.js +36 -0
  392. package/ui/desktop.css +160 -0
  393. package/ui/getting-started.js +93 -0
  394. package/ui/i18n.js +484 -0
  395. package/ui/log-parser.js +30 -0
  396. package/ui/pages/audit.html +12 -0
  397. package/ui/pages/dashboard.html +94 -147
  398. package/ui/pages/direct-sessions.html +123 -26
  399. package/ui/pages/getting-started.html +43 -0
  400. package/ui/pages/logs.html +134 -22
  401. package/ui/pages/settings.html +101 -0
  402. package/ui/pages/task-detail.html +12 -0
  403. package/ui/pages/tasks.html +54 -8
  404. package/ui/pages/workspace.html +38 -1
  405. package/ui/settings.js +254 -0
  406. package/PatchWarden-Control.cmd +0 -6
  407. package/Restart-PatchWarden-Control.cmd +0 -6
  408. package/dist/test/unit/acceptance-engine.test.d.ts +0 -1
  409. package/dist/test/unit/acceptance-engine.test.js +0 -228
  410. package/dist/test/unit/agent-router.test.d.ts +0 -1
  411. package/dist/test/unit/agent-router.test.js +0 -287
  412. package/dist/test/unit/android-doctor.test.d.ts +0 -1
  413. package/dist/test/unit/android-doctor.test.js +0 -118
  414. package/dist/test/unit/apply-patch.test.d.ts +0 -1
  415. package/dist/test/unit/apply-patch.test.js +0 -225
  416. package/dist/test/unit/audit-checks.test.d.ts +0 -1
  417. package/dist/test/unit/audit-checks.test.js +0 -350
  418. package/dist/test/unit/chinese-path.test.d.ts +0 -1
  419. package/dist/test/unit/chinese-path.test.js +0 -91
  420. package/dist/test/unit/command-guard.test.d.ts +0 -1
  421. package/dist/test/unit/command-guard.test.js +0 -160
  422. package/dist/test/unit/create-task.test.d.ts +0 -1
  423. package/dist/test/unit/create-task.test.js +0 -197
  424. package/dist/test/unit/diagnose-task.test.d.ts +0 -1
  425. package/dist/test/unit/diagnose-task.test.js +0 -457
  426. package/dist/test/unit/direct-guards.test.d.ts +0 -1
  427. package/dist/test/unit/direct-guards.test.js +0 -328
  428. package/dist/test/unit/discovery-token-store.test.d.ts +0 -1
  429. package/dist/test/unit/discovery-token-store.test.js +0 -139
  430. package/dist/test/unit/evidence-pack.test.d.ts +0 -1
  431. package/dist/test/unit/evidence-pack.test.js +0 -224
  432. package/dist/test/unit/get-task-status.test.d.ts +0 -1
  433. package/dist/test/unit/get-task-status.test.js +0 -174
  434. package/dist/test/unit/get-task-summary.test.d.ts +0 -1
  435. package/dist/test/unit/get-task-summary.test.js +0 -146
  436. package/dist/test/unit/goal-graph.test.d.ts +0 -1
  437. package/dist/test/unit/goal-graph.test.js +0 -298
  438. package/dist/test/unit/goal-progress.test.d.ts +0 -1
  439. package/dist/test/unit/goal-progress.test.js +0 -381
  440. package/dist/test/unit/goal-report.test.d.ts +0 -1
  441. package/dist/test/unit/goal-report.test.js +0 -159
  442. package/dist/test/unit/goal-status.test.d.ts +0 -1
  443. package/dist/test/unit/goal-status.test.js +0 -215
  444. package/dist/test/unit/goal-store.test.d.ts +0 -1
  445. package/dist/test/unit/goal-store.test.js +0 -253
  446. package/dist/test/unit/goal-subgoal-task.test.d.ts +0 -1
  447. package/dist/test/unit/goal-subgoal-task.test.js +0 -55
  448. package/dist/test/unit/goal-tools-registry.test.d.ts +0 -1
  449. package/dist/test/unit/goal-tools-registry.test.js +0 -192
  450. package/dist/test/unit/handoff-export.test.d.ts +0 -1
  451. package/dist/test/unit/handoff-export.test.js +0 -263
  452. package/dist/test/unit/invoke-discovered-tool.test.d.ts +0 -1
  453. package/dist/test/unit/invoke-discovered-tool.test.js +0 -167
  454. package/dist/test/unit/logging.test.d.ts +0 -1
  455. package/dist/test/unit/logging.test.js +0 -397
  456. package/dist/test/unit/path-guard.test.d.ts +0 -1
  457. package/dist/test/unit/path-guard.test.js +0 -133
  458. package/dist/test/unit/post-task-cleanup.test.d.ts +0 -1
  459. package/dist/test/unit/post-task-cleanup.test.js +0 -48
  460. package/dist/test/unit/project-policy-release-mode.test.d.ts +0 -1
  461. package/dist/test/unit/project-policy-release-mode.test.js +0 -125
  462. package/dist/test/unit/reconcile-tasks.test.d.ts +0 -1
  463. package/dist/test/unit/reconcile-tasks.test.js +0 -456
  464. package/dist/test/unit/release-gate.test.d.ts +0 -1
  465. package/dist/test/unit/release-gate.test.js +0 -242
  466. package/dist/test/unit/run-task-loop.test.d.ts +0 -1
  467. package/dist/test/unit/run-task-loop.test.js +0 -380
  468. package/dist/test/unit/safe-status.test.d.ts +0 -1
  469. package/dist/test/unit/safe-status.test.js +0 -165
  470. package/dist/test/unit/safe-views.test.d.ts +0 -1
  471. package/dist/test/unit/safe-views.test.js +0 -171
  472. package/dist/test/unit/schema-drift-check.test.d.ts +0 -1
  473. package/dist/test/unit/schema-drift-check.test.js +0 -176
  474. package/dist/test/unit/sensitive-guard.test.d.ts +0 -1
  475. package/dist/test/unit/sensitive-guard.test.js +0 -104
  476. package/dist/test/unit/spec-kit-import.test.d.ts +0 -1
  477. package/dist/test/unit/spec-kit-import.test.js +0 -341
  478. package/dist/test/unit/subgoal-sync.test.d.ts +0 -1
  479. package/dist/test/unit/subgoal-sync.test.js +0 -183
  480. package/dist/test/unit/sync-file.test.d.ts +0 -1
  481. package/dist/test/unit/sync-file.test.js +0 -154
  482. package/dist/test/unit/tool-invocation-guard.test.d.ts +0 -1
  483. package/dist/test/unit/tool-invocation-guard.test.js +0 -432
  484. package/dist/test/unit/tool-usage-stats.test.d.ts +0 -1
  485. package/dist/test/unit/tool-usage-stats.test.js +0 -300
  486. package/dist/test/unit/toolSearch.test.d.ts +0 -1
  487. package/dist/test/unit/toolSearch.test.js +0 -571
  488. package/dist/test/unit/wait-for-task.test.d.ts +0 -1
  489. package/dist/test/unit/wait-for-task.test.js +0 -144
  490. package/dist/test/unit/watcher-status.test.d.ts +0 -1
  491. package/dist/test/unit/watcher-status.test.js +0 -169
  492. package/dist/test/unit/worktree-manager.test.d.ts +0 -1
  493. package/dist/test/unit/worktree-manager.test.js +0 -176
  494. package/dist/tools/applyPatch.js +0 -41
  495. package/dist/tools/cancelTask.d.ts +0 -30
  496. package/dist/tools/cancelTask.js +0 -64
  497. package/dist/tools/finalizeDirectSession.js +0 -84
  498. package/dist/tools/goalSubgoalTask.js +0 -110
  499. package/dist/tools/killTask.d.ts +0 -15
  500. package/dist/tools/listAgents.d.ts +0 -12
  501. package/dist/tools/listAgents.js +0 -42
  502. package/dist/tools/reconcileTasks.js +0 -352
  503. package/dist/tools/retryTask.js +0 -45
  504. package/dist/tools/runVerification.js +0 -36
  505. package/dist/tools/syncFile.js +0 -65
  506. package/docs/control-center/control-center-daily-driver.md +0 -211
  507. package/docs/control-center/control-center-mvp.md +0 -205
  508. package/docs/control-center/control-center-phase2.md +0 -159
  509. package/docs/execution-plan-2026-07-09.md +0 -315
  510. package/docs/release-v0.6.0.md +0 -71
  511. package/docs/release-v0.6.1.md +0 -75
  512. package/docs/release-v0.6.4.md +0 -45
  513. package/docs/roadmap-execution-and-acceptance.md +0 -365
  514. package/src/test/unit/acceptance-engine.test.ts +0 -261
  515. package/src/test/unit/agent-router.test.ts +0 -342
  516. package/src/test/unit/android-doctor.test.ts +0 -158
  517. package/src/test/unit/apply-patch.test.ts +0 -293
  518. package/src/test/unit/audit-checks.test.ts +0 -567
  519. package/src/test/unit/chinese-path.test.ts +0 -106
  520. package/src/test/unit/command-guard.test.ts +0 -221
  521. package/src/test/unit/create-task.test.ts +0 -255
  522. package/src/test/unit/diagnose-task.test.ts +0 -544
  523. package/src/test/unit/direct-guards.test.ts +0 -467
  524. package/src/test/unit/discovery-token-store.test.ts +0 -181
  525. package/src/test/unit/evidence-pack.test.ts +0 -251
  526. package/src/test/unit/get-task-status.test.ts +0 -203
  527. package/src/test/unit/get-task-summary.test.ts +0 -173
  528. package/src/test/unit/goal-graph.test.ts +0 -347
  529. package/src/test/unit/goal-progress.test.ts +0 -538
  530. package/src/test/unit/goal-report.test.ts +0 -189
  531. package/src/test/unit/goal-status.test.ts +0 -270
  532. package/src/test/unit/goal-store.test.ts +0 -318
  533. package/src/test/unit/goal-subgoal-task.test.ts +0 -72
  534. package/src/test/unit/goal-tools-registry.test.ts +0 -245
  535. package/src/test/unit/handoff-export.test.ts +0 -295
  536. package/src/test/unit/invoke-discovered-tool.test.ts +0 -216
  537. package/src/test/unit/logging.test.ts +0 -497
  538. package/src/test/unit/path-guard.test.ts +0 -180
  539. package/src/test/unit/post-task-cleanup.test.ts +0 -53
  540. package/src/test/unit/project-policy-release-mode.test.ts +0 -156
  541. package/src/test/unit/reconcile-tasks.test.ts +0 -551
  542. package/src/test/unit/release-gate.test.ts +0 -314
  543. package/src/test/unit/run-task-loop.test.ts +0 -425
  544. package/src/test/unit/safe-status.test.ts +0 -187
  545. package/src/test/unit/safe-views.test.ts +0 -184
  546. package/src/test/unit/schema-drift-check.test.ts +0 -260
  547. package/src/test/unit/sensitive-guard.test.ts +0 -124
  548. package/src/test/unit/spec-kit-import.test.ts +0 -429
  549. package/src/test/unit/subgoal-sync.test.ts +0 -236
  550. package/src/test/unit/sync-file.test.ts +0 -231
  551. package/src/test/unit/tool-invocation-guard.test.ts +0 -542
  552. package/src/test/unit/tool-usage-stats.test.ts +0 -384
  553. package/src/test/unit/toolSearch.test.ts +0 -756
  554. package/src/test/unit/wait-for-task.test.ts +0 -176
  555. package/src/test/unit/watcher-status.test.ts +0 -190
  556. package/src/test/unit/worktree-manager.test.ts +0 -247
  557. package/src/tools/cancelTask.ts +0 -70
  558. package/src/tools/listAgents.ts +0 -54
  559. package/src/tools/retryTask.ts +0 -53
  560. package/src/tools/syncFile.ts +0 -122
  561. /package/dist/tools/{toolCatalog.d.ts → catalog/toolCatalog.d.ts} +0 -0
  562. /package/dist/tools/{toolSearch.d.ts → catalog/toolSearch.d.ts} +0 -0
  563. /package/dist/tools/{toolSearch.js → catalog/toolSearch.js} +0 -0
  564. /package/dist/tools/{toolUsageStats.d.ts → catalog/toolUsageStats.d.ts} +0 -0
  565. /package/dist/tools/{toolUsageStats.js → catalog/toolUsageStats.js} +0 -0
  566. /package/dist/tools/{createDirectSession.d.ts → direct/createDirectSession.d.ts} +0 -0
  567. /package/dist/tools/{runDirectVerificationBundle.d.ts → direct/runDirectVerificationBundle.d.ts} +0 -0
  568. /package/dist/tools/{getPlan.d.ts → goals/getPlan.d.ts} +0 -0
  569. /package/dist/tools/{savePlan.d.ts → goals/savePlan.d.ts} +0 -0
  570. /package/dist/tools/{evidencePack.d.ts → tasks/evidencePack.d.ts} +0 -0
  571. /package/dist/tools/{getTaskFile.d.ts → tasks/getTaskFile.d.ts} +0 -0
  572. /package/dist/tools/{getTaskProgress.d.ts → tasks/getTaskProgress.d.ts} +0 -0
  573. /package/dist/tools/{getTaskProgress.js → tasks/getTaskProgress.js} +0 -0
  574. /package/dist/tools/{getTaskStdoutTail.d.ts → tasks/getTaskStdoutTail.d.ts} +0 -0
  575. /package/dist/tools/{getTaskSummary.d.ts → tasks/getTaskSummary.d.ts} +0 -0
  576. /package/dist/tools/{killTask.js → tasks/killTask.js} +0 -0
  577. /package/dist/tools/{retryTask.d.ts → tasks/retryTask.d.ts} +0 -0
  578. /package/dist/tools/{runVerification.d.ts → tasks/runVerification.d.ts} +0 -0
  579. /package/dist/tools/{taskLineage.d.ts → tasks/taskLineage.d.ts} +0 -0
  580. /package/dist/tools/{waitForTask.d.ts → tasks/waitForTask.d.ts} +0 -0
  581. /package/dist/tools/{androidDoctor.d.ts → workspace/androidDoctor.d.ts} +0 -0
  582. /package/dist/tools/{discardWorktree.d.ts → workspace/discardWorktree.d.ts} +0 -0
  583. /package/dist/tools/{listWorkspace.d.ts → workspace/listWorkspace.d.ts} +0 -0
  584. /package/dist/tools/{mergeWorktree.d.ts → workspace/mergeWorktree.d.ts} +0 -0
  585. /package/dist/tools/{readWorkspaceFile.d.ts → workspace/readWorkspaceFile.d.ts} +0 -0
  586. /package/dist/tools/{recommendAgentForTask.d.ts → workspace/recommendAgentForTask.d.ts} +0 -0
  587. /package/dist/tools/{searchWorkspace.d.ts → workspace/searchWorkspace.d.ts} +0 -0
  588. /package/src/tools/{toolSearch.ts → catalog/toolSearch.ts} +0 -0
  589. /package/src/tools/{toolUsageStats.ts → catalog/toolUsageStats.ts} +0 -0
  590. /package/src/tools/{getTaskProgress.ts → tasks/getTaskProgress.ts} +0 -0
  591. /package/src/tools/{killTask.ts → tasks/killTask.ts} +0 -0
@@ -1,467 +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 } from "node:fs";
4
- import { join, resolve } from "node:path";
5
- import { tmpdir } from "node:os";
6
- import { guardDirectPath, guardDirectWritePath, guardDirectReadPath, guardDirectPatchSize, guardDirectFileSize, isBinaryFile } from "../../direct/directGuards.js";
7
- import { PatchWardenError } from "../../errors.js";
8
- import { reloadConfig } from "../../config.js";
9
- import type { PatchWardenConfig } from "../../config.js";
10
-
11
- function makeConfig(workspaceRoot: string): PatchWardenConfig {
12
- return {
13
- workspaceRoot,
14
- plansDir: ".patchwarden/plans",
15
- tasksDir: ".patchwarden/tasks",
16
- assessmentsDir: ".patchwarden/assessments",
17
- assessmentTtlSeconds: 3600,
18
- agents: { codex: { command: "codex", args: ["exec", "{prompt}"] } },
19
- allowedTestCommands: ["npm test"],
20
- repoAllowedTestCommands: {},
21
- maxReadFileBytes: 200_000,
22
- defaultTaskTimeoutSeconds: 900,
23
- maxTaskTimeoutSeconds: 3600,
24
- watcherStaleSeconds: 30,
25
- directSessionsDir: ".patchwarden/direct-sessions",
26
- directSessionTtlSeconds: 3600,
27
- directMaxPatchBytes: 200_000,
28
- directMaxFileBytes: 500_000,
29
- directAllowedCommands: ["npm test"],
30
- repoDirectAllowedCommands: {},
31
- };
32
- }
33
-
34
- describe("guardDirectPath", () => {
35
- let tempDir: string;
36
- let repoPath: string;
37
-
38
- beforeEach(() => {
39
- tempDir = mkdtempSync(join(tmpdir(), "pw-directpath-"));
40
- repoPath = join(tempDir, "my-repo");
41
- mkdirSync(repoPath, { recursive: true });
42
- // Set up config so getConfig() works in guardDirectPath
43
- process.env.PATCHWARDEN_CONFIG = "";
44
- });
45
-
46
- afterEach(() => {
47
- rmSync(tempDir, { recursive: true, force: true });
48
- delete process.env.PATCHWARDEN_CONFIG;
49
- });
50
-
51
- it("allows paths inside repo", () => {
52
- const result = guardDirectPath("src/main.ts", repoPath, tempDir);
53
- assert.equal(result, resolve(repoPath, "src/main.ts"));
54
- });
55
-
56
- it("allows nested paths inside repo", () => {
57
- const result = guardDirectPath("src/components/Button.tsx", repoPath, tempDir);
58
- assert.equal(result, resolve(repoPath, "src/components/Button.tsx"));
59
- });
60
-
61
- it("rejects paths outside repo but inside workspace", () => {
62
- assert.throws(
63
- () => guardDirectPath("../other-repo/file.ts", repoPath, tempDir),
64
- PatchWardenError
65
- );
66
- });
67
-
68
- it("rejects paths outside workspace", () => {
69
- assert.throws(
70
- () => guardDirectPath("../../../etc/passwd", repoPath, tempDir),
71
- PatchWardenError
72
- );
73
- });
74
-
75
- it("handles Windows backslash paths", () => {
76
- const result = guardDirectPath("src\\subdir\\file.ts", repoPath, tempDir);
77
- assert.ok(result.startsWith(repoPath));
78
- });
79
-
80
- it("rejects path traversal with ..", () => {
81
- assert.throws(
82
- () => guardDirectPath("src/../../etc/passwd", repoPath, tempDir),
83
- PatchWardenError
84
- );
85
- });
86
- });
87
-
88
- describe("guardDirectWritePath", () => {
89
- let tempDir: string;
90
- let repoPath: string;
91
-
92
- beforeEach(() => {
93
- tempDir = mkdtempSync(join(tmpdir(), "pw-directwrite-"));
94
- repoPath = join(tempDir, "my-repo");
95
- mkdirSync(repoPath, { recursive: true });
96
- mkdirSync(join(repoPath, "src"), { recursive: true });
97
- });
98
-
99
- afterEach(() => {
100
- rmSync(tempDir, { recursive: true, force: true });
101
- });
102
-
103
- it("allows writing to source files in repo", () => {
104
- const result = guardDirectWritePath("src/main.ts", repoPath, tempDir);
105
- assert.ok(result.startsWith(repoPath));
106
- });
107
-
108
- it("blocks node_modules paths", () => {
109
- assert.throws(
110
- () => guardDirectWritePath("node_modules/evil/index.js", repoPath, tempDir),
111
- (err: unknown) => err instanceof PatchWardenError && err.reason === "blocked_artifact_path"
112
- );
113
- });
114
-
115
- it("blocks nested node_modules paths", () => {
116
- assert.throws(
117
- () => guardDirectWritePath("src/node_modules/evil/index.js", repoPath, tempDir),
118
- (err: unknown) => err instanceof PatchWardenError && err.reason === "blocked_artifact_path"
119
- );
120
- });
121
-
122
- it("blocks dist paths", () => {
123
- assert.throws(
124
- () => guardDirectWritePath("dist/main.js", repoPath, tempDir),
125
- (err: unknown) => err instanceof PatchWardenError && err.reason === "blocked_artifact_path"
126
- );
127
- });
128
-
129
- it("blocks release paths", () => {
130
- assert.throws(
131
- () => guardDirectWritePath("release/app.exe", repoPath, tempDir),
132
- (err: unknown) => err instanceof PatchWardenError && err.reason === "blocked_artifact_path"
133
- );
134
- });
135
-
136
- it("blocks .patchwarden internal paths", () => {
137
- assert.throws(
138
- () => guardDirectWritePath(".patchwarden/tasks/evil.json", repoPath, tempDir),
139
- (err: unknown) => err instanceof PatchWardenError && err.reason === "internal_patchwarden_path_blocked"
140
- );
141
- });
142
-
143
- it("blocks sensitive files", () => {
144
- assert.throws(
145
- () => guardDirectWritePath(".env", repoPath, tempDir),
146
- (err: unknown) => err instanceof PatchWardenError && err.reason === "sensitive_path_blocked"
147
- );
148
- assert.throws(
149
- () => guardDirectWritePath("config.json", repoPath, tempDir),
150
- (err: unknown) => err instanceof PatchWardenError && err.reason === "sensitive_path_blocked"
151
- );
152
- });
153
-
154
- it("blocks paths outside repo", () => {
155
- assert.throws(
156
- () => guardDirectWritePath("../other-repo/file.ts", repoPath, tempDir),
157
- PatchWardenError
158
- );
159
- });
160
- });
161
-
162
- describe("guardDirectReadPath", () => {
163
- let tempDir: string;
164
- let repoPath: string;
165
-
166
- beforeEach(() => {
167
- tempDir = mkdtempSync(join(tmpdir(), "pw-directread-"));
168
- repoPath = join(tempDir, "my-repo");
169
- mkdirSync(repoPath, { recursive: true });
170
- mkdirSync(join(repoPath, "src"), { recursive: true });
171
- writeFileSync(join(repoPath, "src", "main.ts"), "console.log('hello');", "utf-8");
172
- });
173
-
174
- afterEach(() => {
175
- rmSync(tempDir, { recursive: true, force: true });
176
- });
177
-
178
- it("allows reading source files in repo", () => {
179
- const result = guardDirectReadPath("src/main.ts", repoPath, tempDir);
180
- assert.ok(result.startsWith(repoPath));
181
- });
182
-
183
- it("blocks .patchwarden internal paths", () => {
184
- assert.throws(
185
- () => guardDirectReadPath(".patchwarden/tasks/status.json", repoPath, tempDir),
186
- (err: unknown) => err instanceof PatchWardenError && err.reason === "internal_patchwarden_path_blocked"
187
- );
188
- });
189
-
190
- it("blocks sensitive files", () => {
191
- assert.throws(
192
- () => guardDirectReadPath(".env", repoPath, tempDir),
193
- (err: unknown) => err instanceof PatchWardenError && err.reason === "sensitive_path_blocked"
194
- );
195
- });
196
- });
197
-
198
- describe("guardDirectPatchSize", () => {
199
- let tempDir: string;
200
-
201
- beforeEach(() => {
202
- tempDir = mkdtempSync(join(tmpdir(), "pw-patchsize-"));
203
- // Write a real config file so getConfig() picks it up
204
- const configPath = join(tempDir, "patchwarden.config.json");
205
- writeFileSync(configPath, JSON.stringify({
206
- workspaceRoot: tempDir,
207
- agents: { codex: { command: "codex", args: ["exec", "{prompt}"] } },
208
- allowedTestCommands: ["npm test"],
209
- directMaxPatchBytes: 1000,
210
- directMaxFileBytes: 5000,
211
- }), "utf-8");
212
- process.env.PATCHWARDEN_CONFIG = configPath;
213
- reloadConfig();
214
- });
215
-
216
- afterEach(() => {
217
- rmSync(tempDir, { recursive: true, force: true });
218
- delete process.env.PATCHWARDEN_CONFIG;
219
- reloadConfig();
220
- });
221
-
222
- it("allows patches within size limit", () => {
223
- assert.doesNotThrow(() => guardDirectPatchSize(500));
224
- assert.doesNotThrow(() => guardDirectPatchSize(1000));
225
- });
226
-
227
- it("rejects patches exceeding size limit", () => {
228
- assert.throws(
229
- () => guardDirectPatchSize(1001),
230
- (err: unknown) => err instanceof PatchWardenError && err.reason === "patch_too_large"
231
- );
232
- assert.throws(
233
- () => guardDirectPatchSize(999999),
234
- (err: unknown) => err instanceof PatchWardenError && err.reason === "patch_too_large"
235
- );
236
- });
237
-
238
- it("allows zero-size patch", () => {
239
- assert.doesNotThrow(() => guardDirectPatchSize(0));
240
- });
241
- });
242
-
243
- describe("guardDirectFileSize", () => {
244
- let tempDir: string;
245
-
246
- beforeEach(() => {
247
- tempDir = mkdtempSync(join(tmpdir(), "pw-filesize-"));
248
- const configPath = join(tempDir, "patchwarden.config.json");
249
- writeFileSync(configPath, JSON.stringify({
250
- workspaceRoot: tempDir,
251
- agents: { codex: { command: "codex", args: ["exec", "{prompt}"] } },
252
- allowedTestCommands: ["npm test"],
253
- directMaxPatchBytes: 1000,
254
- directMaxFileBytes: 5000,
255
- }), "utf-8");
256
- process.env.PATCHWARDEN_CONFIG = configPath;
257
- reloadConfig();
258
- });
259
-
260
- afterEach(() => {
261
- rmSync(tempDir, { recursive: true, force: true });
262
- delete process.env.PATCHWARDEN_CONFIG;
263
- reloadConfig();
264
- });
265
-
266
- it("allows files within size limit", () => {
267
- assert.doesNotThrow(() => guardDirectFileSize(100));
268
- assert.doesNotThrow(() => guardDirectFileSize(5000));
269
- });
270
-
271
- it("rejects files exceeding size limit", () => {
272
- assert.throws(
273
- () => guardDirectFileSize(5001),
274
- (err: unknown) => err instanceof PatchWardenError && err.reason === "file_too_large"
275
- );
276
- assert.throws(
277
- () => guardDirectFileSize(9999999),
278
- (err: unknown) => err instanceof PatchWardenError && err.reason === "file_too_large"
279
- );
280
- });
281
-
282
- it("allows zero-size file", () => {
283
- assert.doesNotThrow(() => guardDirectFileSize(0));
284
- });
285
- });
286
-
287
- describe("isBinaryFile", () => {
288
- let tempDir: string;
289
-
290
- beforeEach(() => {
291
- tempDir = mkdtempSync(join(tmpdir(), "pw-binary-"));
292
- });
293
-
294
- afterEach(() => {
295
- rmSync(tempDir, { recursive: true, force: true });
296
- });
297
-
298
- it("detects binary files by extension", () => {
299
- assert.equal(isBinaryFile("test.exe"), true);
300
- assert.equal(isBinaryFile("test.dll"), true);
301
- assert.equal(isBinaryFile("test.zip"), true);
302
- assert.equal(isBinaryFile("test.png"), true);
303
- assert.equal(isBinaryFile("test.pdf"), true);
304
- assert.equal(isBinaryFile("test.jar"), true);
305
- assert.equal(isBinaryFile("test.pak"), true);
306
- });
307
-
308
- it("detects binary files with Windows backslash paths", () => {
309
- assert.equal(isBinaryFile("path\\to\\test.exe"), true);
310
- assert.equal(isBinaryFile("path\\to\\test.dll"), true);
311
- });
312
-
313
- it("does not flag text files as binary by extension", () => {
314
- assert.equal(isBinaryFile("test.ts"), false);
315
- assert.equal(isBinaryFile("test.js"), false);
316
- assert.equal(isBinaryFile("test.md"), false);
317
- assert.equal(isBinaryFile("test.json"), false);
318
- assert.equal(isBinaryFile("test.txt"), false);
319
- });
320
-
321
- it("detects binary content by null bytes", () => {
322
- const binaryFile = join(tempDir, "test.dat");
323
- // Write a file with null bytes in the first 8KB
324
- const buffer = Buffer.alloc(100, 0x41); // 'A' characters
325
- buffer[50] = 0; // null byte
326
- writeFileSync(binaryFile, buffer);
327
- assert.equal(isBinaryFile(binaryFile), true);
328
- });
329
-
330
- it("does not flag text content as binary", () => {
331
- const textFile = join(tempDir, "test.txt");
332
- writeFileSync(textFile, "This is a text file with no null bytes.", "utf-8");
333
- assert.equal(isBinaryFile(textFile), false);
334
- });
335
-
336
- it("handles 8KB boundary — text file just under 8KB", () => {
337
- const textFile = join(tempDir, "boundary.txt");
338
- // Write exactly 8192 bytes of text (no null bytes)
339
- const content = "A".repeat(8192);
340
- writeFileSync(textFile, content, "utf-8");
341
- assert.equal(isBinaryFile(textFile), false);
342
- });
343
-
344
- it("handles 8KB boundary — null byte at position 8191", () => {
345
- const binaryFile = join(tempDir, "boundary.dat");
346
- const buffer = Buffer.alloc(8192, 0x41);
347
- buffer[8191] = 0;
348
- writeFileSync(binaryFile, buffer);
349
- assert.equal(isBinaryFile(binaryFile), true);
350
- });
351
-
352
- it("returns false for non-existent files without binary extension", () => {
353
- assert.equal(isBinaryFile(join(tempDir, "nonexistent.txt")), false);
354
- });
355
-
356
- // ── Adversarial: null byte beyond 8KB read window ──
357
- it("detects null byte at position 8200 (beyond old 8KB window)", () => {
358
- // Previously isBinaryFile only read the first 8192 bytes, so a null byte
359
- // at position 8200 would bypass detection. Now we scan up to 1 MB.
360
- const stealthBinary = join(tempDir, "stealth.txt");
361
- const buffer = Buffer.alloc(8200, 0x41); // 8200 bytes of 'A'
362
- buffer[8199] = 0; // null byte just beyond the old 8KB read window
363
- writeFileSync(stealthBinary, buffer);
364
- assert.equal(isBinaryFile(stealthBinary), true);
365
- });
366
-
367
- it("detects null byte at exactly position 8192 (first byte beyond old window)", () => {
368
- const stealthBinary = join(tempDir, "boundary-plus.txt");
369
- const buffer = Buffer.alloc(8193, 0x41);
370
- buffer[8192] = 0; // first byte beyond the old 8KB read window
371
- writeFileSync(stealthBinary, buffer);
372
- assert.equal(isBinaryFile(stealthBinary), true);
373
- });
374
-
375
- it("detects null byte at 100KB offset", () => {
376
- const deepBinary = join(tempDir, "deep.txt");
377
- const buffer = Buffer.alloc(102400, 0x41);
378
- buffer[102399] = 0;
379
- writeFileSync(deepBinary, buffer);
380
- assert.equal(isBinaryFile(deepBinary), true);
381
- });
382
-
383
- it("detects null byte at 1MB offset (scan limit boundary)", () => {
384
- const limitBinary = join(tempDir, "limit.txt");
385
- const buffer = Buffer.alloc(1_048_576, 0x41);
386
- buffer[1_048_575] = 0;
387
- writeFileSync(limitBinary, buffer);
388
- assert.equal(isBinaryFile(limitBinary), true);
389
- });
390
-
391
- it("does not scan beyond 1MB limit", () => {
392
- // A null byte just past the 1MB scan limit should NOT be detected.
393
- // This documents the remaining scan boundary.
394
- const overLimit = join(tempDir, "over-limit.txt");
395
- const buffer = Buffer.alloc(1_048_577, 0x41);
396
- buffer[1_048_576] = 0; // first byte beyond scan limit
397
- writeFileSync(overLimit, buffer);
398
- assert.equal(isBinaryFile(overLimit), false);
399
- });
400
- });
401
-
402
- // ── Adversarial: Windows backslash prefix bypass attempts ──
403
-
404
- describe("guardDirectWritePath adversarial separator tests", () => {
405
- let tempDir: string;
406
- let repoPath: string;
407
-
408
- beforeEach(() => {
409
- tempDir = mkdtempSync(join(tmpdir(), "pw-directsep-"));
410
- repoPath = join(tempDir, "my-repo");
411
- mkdirSync(repoPath, { recursive: true });
412
- mkdirSync(join(repoPath, "src"), { recursive: true });
413
- });
414
-
415
- afterEach(() => {
416
- rmSync(tempDir, { recursive: true, force: true });
417
- });
418
-
419
- it("blocks node_modules with backslash prefix", () => {
420
- assert.throws(
421
- () => guardDirectWritePath("node_modules\\evil\\index.js", repoPath, tempDir),
422
- (err: unknown) => err instanceof PatchWardenError && err.reason === "blocked_artifact_path"
423
- );
424
- });
425
-
426
- it("blocks dist with backslash prefix", () => {
427
- assert.throws(
428
- () => guardDirectWritePath("dist\\main.js", repoPath, tempDir),
429
- (err: unknown) => err instanceof PatchWardenError && err.reason === "blocked_artifact_path"
430
- );
431
- });
432
-
433
- it("blocks release with backslash prefix", () => {
434
- assert.throws(
435
- () => guardDirectWritePath("release\\app.exe", repoPath, tempDir),
436
- (err: unknown) => err instanceof PatchWardenError && err.reason === "blocked_artifact_path"
437
- );
438
- });
439
-
440
- it("blocks nested node_modules with mixed separators", () => {
441
- assert.throws(
442
- () => guardDirectWritePath("src\\node_modules/evil\\index.js", repoPath, tempDir),
443
- (err: unknown) => err instanceof PatchWardenError && err.reason === "blocked_artifact_path"
444
- );
445
- });
446
-
447
- it("blocks .patchwarden with backslash prefix", () => {
448
- assert.throws(
449
- () => guardDirectWritePath(".patchwarden\\tasks\\evil.json", repoPath, tempDir),
450
- (err: unknown) => err instanceof PatchWardenError && err.reason === "internal_patchwarden_path_blocked"
451
- );
452
- });
453
-
454
- it("blocks .env with backslash prefix", () => {
455
- assert.throws(
456
- () => guardDirectWritePath("path\\to\\.env", repoPath, tempDir),
457
- (err: unknown) => err instanceof PatchWardenError && err.reason === "sensitive_path_blocked"
458
- );
459
- });
460
-
461
- it("blocks config.json with backslash path", () => {
462
- assert.throws(
463
- () => guardDirectWritePath("subdir\\config.json", repoPath, tempDir),
464
- (err: unknown) => err instanceof PatchWardenError && err.reason === "sensitive_path_blocked"
465
- );
466
- });
467
- });
@@ -1,181 +0,0 @@
1
- import { describe, it, beforeEach } from "node:test";
2
- import { strict as assert } from "node:assert";
3
- import {
4
- issueToken,
5
- consumeToken,
6
- peekToken,
7
- revokeToken,
8
- clearAllTokens,
9
- getActiveTokenCount,
10
- type IssueTokenInput,
11
- } from "../../security/discoveryTokenStore.js";
12
- import { PatchWardenError } from "../../errors.js";
13
-
14
- // ── Helpers ───────────────────────────────────────────────────────
15
-
16
- function todayDatePart(): string {
17
- const now = new Date();
18
- const y = now.getFullYear();
19
- const m = String(now.getMonth() + 1).padStart(2, "0");
20
- const d = String(now.getDate()).padStart(2, "0");
21
- return `${y}${m}${d}`;
22
- }
23
-
24
- function sampleInput(overrides: Partial<IssueTokenInput> = {}): IssueTokenInput {
25
- return {
26
- toolName: "read_workspace_file",
27
- risk: "workspace_read_sensitive",
28
- query: "read file",
29
- schemaDigest: "sha256:abc123",
30
- profile: "full",
31
- ...overrides,
32
- };
33
- }
34
-
35
- // ── Tests ─────────────────────────────────────────────────────────
36
-
37
- describe("discoveryTokenStore", () => {
38
- beforeEach(() => {
39
- clearAllTokens();
40
- });
41
-
42
- describe("issueToken", () => {
43
- it("返回 dst_ 前缀 + 日期 + 12 位 hex 格式", () => {
44
- const token = issueToken(sampleInput());
45
- const regex = new RegExp(`^dst_${todayDatePart()}_[a-f0-9]{12}$`);
46
- assert.ok(regex.test(token), `token "${token}" should match dst_YYYYMMDD_hex12`);
47
- });
48
-
49
- it("默认 expiresAt 为 issuedAt + 10 分钟", () => {
50
- const token = issueToken(sampleInput());
51
- const record = peekToken(token);
52
- assert.ok(record, "record should exist");
53
- const diff = Date.parse(record!.expiresAt) - Date.parse(record!.issuedAt);
54
- // 允许 50ms 容差(两次 Date.now 调用间微小差异)
55
- assert.ok(
56
- Math.abs(diff - 600000) <= 50,
57
- `expected diff ~600000ms, got ${diff}ms`
58
- );
59
- });
60
-
61
- it("自定义 ttlMs 反映到 expiresAt", () => {
62
- const token = issueToken(sampleInput({ ttlMs: 30000 }));
63
- const record = peekToken(token);
64
- assert.ok(record);
65
- const diff = Date.parse(record!.expiresAt) - Date.parse(record!.issuedAt);
66
- assert.ok(
67
- Math.abs(diff - 30000) <= 50,
68
- `expected diff ~30000ms, got ${diff}ms`
69
- );
70
- });
71
-
72
- it("保存 record 字段完整", () => {
73
- const token = issueToken(sampleInput({ allowedScope: ["src/"] }));
74
- const record = peekToken(token);
75
- assert.ok(record);
76
- assert.equal(record!.token, token);
77
- assert.equal(record!.toolName, "read_workspace_file");
78
- assert.equal(record!.risk, "workspace_read_sensitive");
79
- assert.deepEqual(record!.allowedScope, ["src/"]);
80
- assert.equal(record!.query, "read file");
81
- assert.equal(record!.schemaDigest, "sha256:abc123");
82
- assert.equal(record!.profile, "full");
83
- });
84
- });
85
-
86
- describe("consumeToken", () => {
87
- it("成功返回 record 并删除(单次使用)", () => {
88
- const token = issueToken(sampleInput());
89
- const record = consumeToken(token);
90
- assert.equal(record.token, token);
91
- // 再次 consume 应抛 token_not_found
92
- assert.throws(
93
- () => consumeToken(token),
94
- (err: unknown) => {
95
- assert.ok(err instanceof PatchWardenError);
96
- assert.equal(err.reason, "token_not_found");
97
- return true;
98
- }
99
- );
100
- });
101
-
102
- it("不存在抛 token_not_found", () => {
103
- assert.throws(
104
- () => consumeToken("dst_nonexistent_000000000000"),
105
- (err: unknown) => {
106
- assert.ok(err instanceof PatchWardenError);
107
- assert.equal(err.reason, "token_not_found");
108
- return true;
109
- }
110
- );
111
- });
112
-
113
- it("过期抛 token_expired", () => {
114
- // 用负 ttlMs 构造已过期 token
115
- const token = issueToken(sampleInput({ ttlMs: -1000 }));
116
- assert.throws(
117
- () => consumeToken(token),
118
- (err: unknown) => {
119
- assert.ok(err instanceof PatchWardenError);
120
- assert.equal(err.reason, "token_expired");
121
- return true;
122
- }
123
- );
124
- });
125
-
126
- it("过期 token 被消费后从 store 删除", () => {
127
- const token = issueToken(sampleInput({ ttlMs: -1000 }));
128
- assert.throws(() => consumeToken(token));
129
- // peek 应返回 null(已删除)
130
- assert.equal(peekToken(token), null);
131
- });
132
- });
133
-
134
- describe("peekToken", () => {
135
- it("不消费 token(peek 后 consume 仍成功)", () => {
136
- const token = issueToken(sampleInput());
137
- const peeked = peekToken(token);
138
- assert.ok(peeked);
139
- assert.equal(peeked!.token, token);
140
- // peek 后 consume 仍能成功
141
- const consumed = consumeToken(token);
142
- assert.equal(consumed.token, token);
143
- });
144
-
145
- it("不存在返回 null", () => {
146
- assert.equal(peekToken("dst_nonexistent_000000000000"), null);
147
- });
148
- });
149
-
150
- describe("revokeToken", () => {
151
- it("删除 token,返回 true", () => {
152
- const token = issueToken(sampleInput());
153
- assert.equal(revokeToken(token), true);
154
- assert.equal(peekToken(token), null);
155
- });
156
-
157
- it("不存在返回 false", () => {
158
- assert.equal(revokeToken("dst_nonexistent_000000000000"), false);
159
- });
160
- });
161
-
162
- describe("clearAllTokens", () => {
163
- it("清空所有 token", () => {
164
- issueToken(sampleInput());
165
- issueToken(sampleInput());
166
- assert.equal(getActiveTokenCount(), 2);
167
- clearAllTokens();
168
- assert.equal(getActiveTokenCount(), 0);
169
- });
170
- });
171
-
172
- describe("getActiveTokenCount", () => {
173
- it("正确返回当前 token 数量", () => {
174
- assert.equal(getActiveTokenCount(), 0);
175
- issueToken(sampleInput());
176
- assert.equal(getActiveTokenCount(), 1);
177
- issueToken(sampleInput());
178
- assert.equal(getActiveTokenCount(), 2);
179
- });
180
- });
181
- });