patchwarden 1.5.1 → 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 (573) hide show
  1. package/PatchWarden.cmd +32 -2
  2. package/README.en.md +152 -25
  3. package/README.md +120 -23
  4. package/dist/assessments/agentAssessor.js +21 -12
  5. package/dist/assessments/assessmentStore.js +42 -34
  6. package/dist/config.d.ts +15 -0
  7. package/dist/config.js +66 -13
  8. package/dist/control/fileManager.d.ts +2 -0
  9. package/dist/control/fileManager.js +39 -0
  10. package/dist/control/middleware/auth.d.ts +6 -0
  11. package/dist/control/middleware/auth.js +14 -5
  12. package/dist/control/middleware/static.js +16 -3
  13. package/dist/control/routeTable.d.ts +24 -0
  14. package/dist/control/routeTable.js +263 -0
  15. package/dist/control/routes/audit.js +17 -7
  16. package/dist/control/routes/evidence.js +1 -1
  17. package/dist/control/routes/lineage.js +1 -1
  18. package/dist/control/routes/process.d.ts +7 -0
  19. package/dist/control/routes/process.js +329 -42
  20. package/dist/control/routes/sessions.d.ts +9 -1
  21. package/dist/control/routes/sessions.js +84 -21
  22. package/dist/control/routes/status.d.ts +46 -1
  23. package/dist/control/routes/status.js +72 -15
  24. package/dist/control/routes/taskActions.js +24 -60
  25. package/dist/control/routes/tasks.d.ts +4 -0
  26. package/dist/control/routes/tasks.js +61 -62
  27. package/dist/control/routes/workspace.js +50 -23
  28. package/dist/control/runtime.d.ts +3 -2
  29. package/dist/control/runtime.js +63 -30
  30. package/dist/control/server.js +36 -365
  31. package/dist/control/shared.d.ts +25 -1
  32. package/dist/control/shared.js +64 -11
  33. package/dist/direct/directAudit.js +234 -225
  34. package/dist/direct/directGuards.d.ts +2 -1
  35. package/dist/direct/directGuards.js +42 -29
  36. package/dist/direct/directPatch.d.ts +6 -1
  37. package/dist/direct/directPatch.js +55 -8
  38. package/dist/direct/directSessionStore.d.ts +16 -6
  39. package/dist/direct/directSessionStore.js +127 -35
  40. package/dist/direct/directVerification.js +8 -16
  41. package/dist/doctor.js +62 -52
  42. package/dist/goal/acceptanceEngine.d.ts +1 -1
  43. package/dist/goal/goalProgress.js +75 -69
  44. package/dist/goal/goalReport.js +5 -12
  45. package/dist/goal/goalStatus.d.ts +2 -0
  46. package/dist/goal/goalStatus.js +10 -3
  47. package/dist/goal/goalStore.d.ts +9 -2
  48. package/dist/goal/goalStore.js +152 -45
  49. package/dist/goal/handoffExport.js +6 -6
  50. package/dist/goal/specKitImport.js +97 -96
  51. package/dist/goal/subgoalSync.js +11 -9
  52. package/dist/goal/worktreeManager.d.ts +2 -0
  53. package/dist/goal/worktreeManager.js +209 -136
  54. package/dist/httpServer.js +111 -32
  55. package/dist/logging.js +5 -3
  56. package/dist/policy/projectPolicy.js +5 -2
  57. package/dist/release/releaseGate.d.ts +1 -1
  58. package/dist/release/releaseGate.js +78 -25
  59. package/dist/runner/agentInvocation.d.ts +14 -0
  60. package/dist/runner/agentInvocation.js +96 -4
  61. package/dist/runner/changeCapture.d.ts +13 -5
  62. package/dist/runner/changeCapture.js +243 -61
  63. package/dist/runner/postTaskCleanup.js +48 -19
  64. package/dist/runner/processSecurity.d.ts +56 -0
  65. package/dist/runner/processSecurity.js +373 -0
  66. package/dist/runner/runTask.d.ts +1 -1
  67. package/dist/runner/runTask.js +115 -87
  68. package/dist/runner/simpleProcess.d.ts +3 -0
  69. package/dist/runner/simpleProcess.js +50 -36
  70. package/dist/{taskProgress.d.ts → runner/taskProgress.d.ts} +1 -1
  71. package/dist/{taskProgress.js → runner/taskProgress.js} +2 -2
  72. package/dist/{taskRuntime.d.ts → runner/taskRuntime.d.ts} +1 -1
  73. package/dist/{taskRuntime.js → runner/taskRuntime.js} +3 -2
  74. package/dist/runner/taskStatusStore.d.ts +11 -0
  75. package/dist/runner/taskStatusStore.js +24 -0
  76. package/dist/runner/watch.d.ts +14 -1
  77. package/dist/runner/watch.js +256 -48
  78. package/dist/security/contentRedaction.js +2 -2
  79. package/dist/security/discoveryTokenStore.d.ts +3 -2
  80. package/dist/security/discoveryTokenStore.js +17 -2
  81. package/dist/security/loopbackHost.d.ts +2 -0
  82. package/dist/security/loopbackHost.js +16 -0
  83. package/dist/security/pathGuard.js +32 -17
  84. package/dist/security/planGuard.js +2 -1
  85. package/dist/security/runtimeGuard.js +9 -6
  86. package/dist/security/secretComparison.d.ts +3 -0
  87. package/dist/security/secretComparison.js +11 -0
  88. package/dist/security/sensitiveGuard.d.ts +5 -0
  89. package/dist/security/sensitiveGuard.js +27 -8
  90. package/dist/security/toolInvocationGuard.d.ts +2 -2
  91. package/dist/security/toolInvocationGuard.js +1 -1
  92. package/dist/security/workspaceRootGuard.d.ts +8 -0
  93. package/dist/security/workspaceRootGuard.js +47 -0
  94. package/dist/smoke-test.js +24 -23
  95. package/dist/tools/catalog/index.d.ts +4 -0
  96. package/dist/tools/catalog/index.js +4 -0
  97. package/dist/tools/{toolCatalog.js → catalog/toolCatalog.js} +3 -12
  98. package/dist/tools/{toolRegistry.d.ts → catalog/toolRegistry.d.ts} +3 -3
  99. package/dist/tools/{toolRegistry.js → catalog/toolRegistry.js} +6 -15
  100. package/dist/tools/definitions/toolDefs.d.ts +18 -0
  101. package/dist/tools/definitions/toolDefs.js +1177 -0
  102. package/dist/tools/{auditSession.d.ts → diagnostics/auditSession.d.ts} +1 -1
  103. package/dist/tools/{auditSession.js → diagnostics/auditSession.js} +2 -2
  104. package/dist/tools/{auditTask.d.ts → diagnostics/auditTask.d.ts} +1 -1
  105. package/dist/tools/{auditTask.js → diagnostics/auditTask.js} +99 -29
  106. package/dist/tools/{healthCheck.d.ts → diagnostics/healthCheck.d.ts} +6 -6
  107. package/dist/tools/{healthCheck.js → diagnostics/healthCheck.js} +7 -7
  108. package/dist/tools/diagnostics/index.d.ts +6 -0
  109. package/dist/tools/diagnostics/index.js +6 -0
  110. package/dist/tools/{safeStatus.d.ts → diagnostics/safeStatus.d.ts} +3 -3
  111. package/dist/tools/{safeStatus.js → diagnostics/safeStatus.js} +6 -6
  112. package/dist/tools/{safeViews.d.ts → diagnostics/safeViews.d.ts} +12 -8
  113. package/dist/tools/{safeViews.js → diagnostics/safeViews.js} +23 -13
  114. package/dist/tools/{schemaDriftCheck.d.ts → diagnostics/schemaDriftCheck.d.ts} +1 -1
  115. package/dist/tools/{schemaDriftCheck.js → diagnostics/schemaDriftCheck.js} +2 -2
  116. package/dist/tools/{createDirectSession.js → direct/createDirectSession.js} +6 -6
  117. package/dist/tools/{finalizeDirectSession.d.ts → direct/finalizeDirectSession.d.ts} +1 -1
  118. package/dist/tools/direct/finalizeDirectSession.js +86 -0
  119. package/dist/tools/direct/index.d.ts +3 -0
  120. package/dist/tools/direct/index.js +3 -0
  121. package/dist/tools/{runDirectVerificationBundle.js → direct/runDirectVerificationBundle.js} +2 -2
  122. package/dist/tools/{discoverTools.d.ts → discovery/discoverTools.d.ts} +2 -2
  123. package/dist/tools/{discoverTools.js → discovery/discoverTools.js} +5 -5
  124. package/dist/tools/{explainTool.d.ts → discovery/explainTool.d.ts} +2 -2
  125. package/dist/tools/{explainTool.js → discovery/explainTool.js} +2 -2
  126. package/dist/tools/discovery/index.d.ts +3 -0
  127. package/dist/tools/discovery/index.js +3 -0
  128. package/dist/tools/{invokeDiscoveredTool.d.ts → discovery/invokeDiscoveredTool.d.ts} +2 -2
  129. package/dist/tools/{invokeDiscoveredTool.js → discovery/invokeDiscoveredTool.js} +5 -5
  130. package/dist/tools/dispatch/coreDispatch.js +32 -31
  131. package/dist/tools/dispatch/diagnosticDispatch.d.ts +3 -5
  132. package/dist/tools/dispatch/diagnosticDispatch.js +70 -68
  133. package/dist/tools/dispatch/directDispatch.js +11 -10
  134. package/dist/tools/dispatch/goalDispatch.js +5 -4
  135. package/dist/tools/dispatch/releaseDispatch.js +3 -2
  136. package/dist/tools/dispatch/validation.d.ts +7 -0
  137. package/dist/tools/dispatch/validation.js +71 -0
  138. package/dist/tools/{getPlan.js → goals/getPlan.js} +4 -4
  139. package/dist/tools/{goalSubgoalTask.d.ts → goals/goalSubgoalTask.d.ts} +1 -1
  140. package/dist/tools/goals/goalSubgoalTask.js +118 -0
  141. package/dist/tools/goals/index.d.ts +3 -0
  142. package/dist/tools/goals/index.js +3 -0
  143. package/dist/tools/{savePlan.js → goals/savePlan.js} +28 -8
  144. package/dist/tools/registry.d.ts +7 -11
  145. package/dist/tools/registry.js +17 -1178
  146. package/dist/tools/{checkReleaseGate.d.ts → release/checkReleaseGate.d.ts} +1 -1
  147. package/dist/tools/{checkReleaseGate.js → release/checkReleaseGate.js} +3 -3
  148. package/dist/tools/release/index.d.ts +2 -0
  149. package/dist/tools/release/index.js +2 -0
  150. package/dist/tools/{releaseMode.d.ts → release/releaseMode.d.ts} +2 -2
  151. package/dist/tools/{releaseMode.js → release/releaseMode.js} +46 -26
  152. package/dist/tools/tasks/cancelTask.d.ts +11 -0
  153. package/dist/tools/tasks/cancelTask.js +85 -0
  154. package/dist/tools/{createTask.d.ts → tasks/createTask.d.ts} +10 -2
  155. package/dist/tools/{createTask.js → tasks/createTask.js} +42 -27
  156. package/dist/tools/{diagnoseTask.d.ts → tasks/diagnoseTask.d.ts} +1 -1
  157. package/dist/tools/{diagnoseTask.js → tasks/diagnoseTask.js} +8 -8
  158. package/dist/tools/{evidencePack.js → tasks/evidencePack.js} +34 -22
  159. package/dist/tools/{getTaskFile.js → tasks/getTaskFile.js} +4 -4
  160. package/dist/tools/{getTaskStatus.d.ts → tasks/getTaskStatus.d.ts} +6 -1
  161. package/dist/tools/{getTaskStatus.js → tasks/getTaskStatus.js} +5 -5
  162. package/dist/tools/{getTaskStdoutTail.js → tasks/getTaskStdoutTail.js} +13 -11
  163. package/dist/tools/{getTaskSummary.js → tasks/getTaskSummary.js} +33 -26
  164. package/dist/tools/tasks/index.d.ts +18 -0
  165. package/dist/tools/tasks/index.js +18 -0
  166. package/dist/tools/tasks/killTask.d.ts +1 -0
  167. package/dist/tools/{listTasks.d.ts → tasks/listTasks.d.ts} +1 -1
  168. package/dist/tools/{listTasks.js → tasks/listTasks.js} +3 -3
  169. package/dist/tools/{reconcileTasks.d.ts → tasks/reconcileTasks.d.ts} +1 -1
  170. package/dist/tools/{reconcileTasks.js → tasks/reconcileTasks.js} +64 -66
  171. package/dist/tools/tasks/retryTask.js +60 -0
  172. package/dist/tools/{runTaskLoop.d.ts → tasks/runTaskLoop.d.ts} +6 -6
  173. package/dist/tools/{runTaskLoop.js → tasks/runTaskLoop.js} +58 -30
  174. package/dist/tools/tasks/runVerification.js +38 -0
  175. package/dist/tools/{taskLineage.js → tasks/taskLineage.js} +8 -7
  176. package/dist/tools/{taskOutputs.js → tasks/taskOutputs.js} +17 -16
  177. package/dist/tools/{androidDoctor.js → workspace/androidDoctor.js} +16 -10
  178. package/dist/tools/{applyPatch.d.ts → workspace/applyPatch.d.ts} +1 -1
  179. package/dist/tools/workspace/applyPatch.js +53 -0
  180. package/dist/tools/{discardWorktree.js → workspace/discardWorktree.js} +3 -3
  181. package/dist/tools/workspace/index.d.ts +10 -0
  182. package/dist/tools/workspace/index.js +10 -0
  183. package/dist/tools/{listAgents.d.ts → workspace/listAgents.d.ts} +5 -0
  184. package/dist/tools/{listAgents.js → workspace/listAgents.js} +8 -4
  185. package/dist/tools/{listWorkspace.js → workspace/listWorkspace.js} +3 -3
  186. package/dist/tools/{mergeWorktree.js → workspace/mergeWorktree.js} +3 -3
  187. package/dist/tools/{readWorkspaceFile.js → workspace/readWorkspaceFile.js} +8 -8
  188. package/dist/tools/{recommendAgentForTask.js → workspace/recommendAgentForTask.js} +3 -3
  189. package/dist/tools/{searchWorkspace.js → workspace/searchWorkspace.js} +5 -5
  190. package/dist/tools/{syncFile.d.ts → workspace/syncFile.d.ts} +1 -1
  191. package/dist/tools/workspace/syncFile.js +134 -0
  192. package/dist/utils/atomicFile.d.ts +7 -0
  193. package/dist/utils/atomicFile.js +48 -0
  194. package/dist/utils/boundedFile.d.ts +8 -0
  195. package/dist/utils/boundedFile.js +93 -0
  196. package/dist/utils/lockedJsonFile.d.ts +15 -0
  197. package/dist/utils/lockedJsonFile.js +224 -0
  198. package/dist/utils/platform.d.ts +11 -0
  199. package/dist/utils/platform.js +26 -0
  200. package/dist/utils/stableJson.d.ts +2 -0
  201. package/dist/utils/stableJson.js +12 -0
  202. package/dist/version.d.ts +3 -2
  203. package/dist/version.js +3 -2
  204. package/dist/watcherStatus.d.ts +2 -2
  205. package/dist/watcherStatus.js +18 -0
  206. package/docs/CODE_WIKI.md +808 -143
  207. package/docs/architecture.md +15 -55
  208. package/docs/assets/patchwarden-desktop-onboarding.png +0 -0
  209. package/docs/control-center/README.md +4 -4
  210. package/docs/dashboard-overview.md +4 -4
  211. package/docs/desktop-app.md +175 -0
  212. package/docs/evidence-pack-schema.md +3 -3
  213. package/docs/open-source-application.md +17 -11
  214. package/docs/release-checklist.md +1 -1
  215. package/docs/release-evidence.md +39 -29
  216. package/docs/task-safe-review-workflow.md +5 -5
  217. package/docs/threat-model.md +19 -1
  218. package/examples/config.example.json +4 -2
  219. package/package.json +27 -10
  220. package/scripts/README.md +15 -6
  221. package/scripts/build.js +11 -0
  222. package/scripts/checks/brand-check.js +3 -0
  223. package/scripts/checks/build-output-check.js +37 -0
  224. package/scripts/checks/control-center-smoke.js +91 -6
  225. package/scripts/checks/control-smoke.js +19 -8
  226. package/scripts/checks/http-mcp-smoke.js +82 -4
  227. package/scripts/checks/lifecycle-smoke.js +10 -10
  228. package/scripts/checks/mcp-manifest-check.js +1 -1
  229. package/scripts/checks/mcp-smoke.js +27 -3
  230. package/scripts/checks/package-manifest-check.js +20 -7
  231. package/scripts/checks/unit-tests.js +3 -5
  232. package/scripts/checks/watcher-supervisor-smoke.js +9 -0
  233. package/scripts/control/get-patchwarden-health.ps1 +1 -1
  234. package/scripts/control/manage-patchwarden.ps1 +69 -4
  235. package/scripts/control/provision-patchwarden-tunnel.ps1 +127 -0
  236. package/scripts/control/run-background-supervisor.ps1 +41 -0
  237. package/scripts/control/start-patchwarden-tunnel.ps1 +126 -32
  238. package/{PatchWarden-Control-Tray.cmd → scripts/launchers/PatchWarden-Control-Tray.cmd} +3 -3
  239. package/scripts/launchers/PatchWarden-Control.cmd +6 -0
  240. package/{PatchWarden-Desktop.cmd → scripts/launchers/PatchWarden-Desktop.cmd} +2 -2
  241. package/scripts/launchers/Restart-PatchWarden-Control.cmd +6 -0
  242. package/{Stop-PatchWarden.cmd → scripts/launchers/Stop-PatchWarden.cmd} +2 -2
  243. package/scripts/lib/clean-generated-output.js +11 -0
  244. package/scripts/lib/file-discovery.js +12 -0
  245. package/scripts/release/desktop-preflight.js +211 -0
  246. package/scripts/release/pack-clean.js +59 -14
  247. package/src/assessments/agentAssessor.ts +26 -12
  248. package/src/assessments/assessmentStore.ts +52 -40
  249. package/src/config.ts +70 -13
  250. package/src/control/fileManager.ts +40 -0
  251. package/src/control/middleware/auth.ts +22 -4
  252. package/src/control/middleware/static.ts +16 -3
  253. package/src/control/routeTable.ts +301 -0
  254. package/src/control/routes/audit.ts +14 -6
  255. package/src/control/routes/evidence.ts +1 -1
  256. package/src/control/routes/lineage.ts +1 -1
  257. package/src/control/routes/process.ts +341 -40
  258. package/src/control/routes/sessions.ts +88 -25
  259. package/src/control/routes/status.ts +97 -17
  260. package/src/control/routes/taskActions.ts +24 -58
  261. package/src/control/routes/tasks.ts +66 -58
  262. package/src/control/routes/workspace.ts +56 -25
  263. package/src/control/runtime.ts +69 -33
  264. package/src/control/server.ts +36 -342
  265. package/src/control/shared.ts +77 -11
  266. package/src/direct/directAudit.ts +17 -9
  267. package/src/direct/directGuards.ts +72 -44
  268. package/src/direct/directPatch.ts +95 -8
  269. package/src/direct/directSessionStore.ts +211 -55
  270. package/src/direct/directVerification.ts +9 -23
  271. package/src/doctor.ts +73 -59
  272. package/src/goal/acceptanceEngine.ts +1 -1
  273. package/src/goal/goalProgress.ts +17 -13
  274. package/src/goal/goalReport.ts +5 -13
  275. package/src/goal/goalStatus.ts +19 -3
  276. package/src/goal/goalStore.ts +241 -54
  277. package/src/goal/handoffExport.ts +6 -6
  278. package/src/goal/specKitImport.ts +12 -12
  279. package/src/goal/subgoalSync.ts +11 -8
  280. package/src/goal/worktreeManager.ts +139 -22
  281. package/src/httpServer.ts +113 -30
  282. package/src/logging.ts +10 -3
  283. package/src/policy/projectPolicy.ts +5 -2
  284. package/src/release/releaseGate.ts +74 -27
  285. package/src/runner/agentInvocation.ts +126 -4
  286. package/src/runner/changeCapture.ts +291 -57
  287. package/src/runner/postTaskCleanup.ts +41 -17
  288. package/src/runner/processSecurity.ts +433 -0
  289. package/src/runner/runTask.ts +138 -91
  290. package/src/runner/simpleProcess.ts +66 -31
  291. package/src/{taskProgress.ts → runner/taskProgress.ts} +3 -3
  292. package/src/{taskRuntime.ts → runner/taskRuntime.ts} +4 -3
  293. package/src/runner/taskStatusStore.ts +54 -0
  294. package/src/runner/watch.ts +281 -51
  295. package/src/security/contentRedaction.ts +2 -2
  296. package/src/security/discoveryTokenStore.ts +18 -4
  297. package/src/security/loopbackHost.ts +19 -0
  298. package/src/security/pathGuard.ts +35 -16
  299. package/src/security/planGuard.ts +2 -1
  300. package/src/security/runtimeGuard.ts +9 -6
  301. package/src/security/secretComparison.ts +13 -0
  302. package/src/security/sensitiveGuard.ts +27 -8
  303. package/src/security/toolInvocationGuard.ts +2 -2
  304. package/src/security/workspaceRootGuard.ts +53 -0
  305. package/src/smoke-test.ts +25 -24
  306. package/src/tools/catalog/index.ts +4 -0
  307. package/src/tools/{toolCatalog.ts → catalog/toolCatalog.ts} +3 -12
  308. package/src/tools/{toolRegistry.ts → catalog/toolRegistry.ts} +7 -16
  309. package/src/tools/definitions/toolDefs.ts +1264 -0
  310. package/src/tools/{auditSession.ts → diagnostics/auditSession.ts} +2 -2
  311. package/src/tools/{auditTask.ts → diagnostics/auditTask.ts} +99 -32
  312. package/src/tools/{healthCheck.ts → diagnostics/healthCheck.ts} +8 -8
  313. package/src/tools/diagnostics/index.ts +6 -0
  314. package/src/tools/{safeStatus.ts → diagnostics/safeStatus.ts} +7 -7
  315. package/src/tools/{safeViews.ts → diagnostics/safeViews.ts} +27 -17
  316. package/src/tools/{schemaDriftCheck.ts → diagnostics/schemaDriftCheck.ts} +3 -3
  317. package/src/tools/{createDirectSession.ts → direct/createDirectSession.ts} +6 -6
  318. package/src/tools/{finalizeDirectSession.ts → direct/finalizeDirectSession.ts} +7 -5
  319. package/src/tools/direct/index.ts +3 -0
  320. package/src/tools/{runDirectVerificationBundle.ts → direct/runDirectVerificationBundle.ts} +2 -2
  321. package/src/tools/{discoverTools.ts → discovery/discoverTools.ts} +6 -6
  322. package/src/tools/{explainTool.ts → discovery/explainTool.ts} +3 -3
  323. package/src/tools/discovery/index.ts +3 -0
  324. package/src/tools/{invokeDiscoveredTool.ts → discovery/invokeDiscoveredTool.ts} +7 -7
  325. package/src/tools/dispatch/coreDispatch.ts +36 -31
  326. package/src/tools/dispatch/diagnosticDispatch.ts +26 -21
  327. package/src/tools/dispatch/directDispatch.ts +11 -10
  328. package/src/tools/dispatch/goalDispatch.ts +5 -4
  329. package/src/tools/dispatch/releaseDispatch.ts +3 -2
  330. package/src/tools/dispatch/validation.ts +78 -0
  331. package/src/tools/{getPlan.ts → goals/getPlan.ts} +4 -4
  332. package/src/tools/{goalSubgoalTask.ts → goals/goalSubgoalTask.ts} +41 -26
  333. package/src/tools/goals/index.ts +3 -0
  334. package/src/tools/{savePlan.ts → goals/savePlan.ts} +38 -8
  335. package/src/tools/registry.ts +17 -1261
  336. package/src/tools/{checkReleaseGate.ts → release/checkReleaseGate.ts} +3 -3
  337. package/src/tools/release/index.ts +2 -0
  338. package/src/tools/{releaseMode.ts → release/releaseMode.ts} +42 -24
  339. package/src/tools/tasks/cancelTask.ts +109 -0
  340. package/src/tools/{createTask.ts → tasks/createTask.ts} +49 -26
  341. package/src/tools/{diagnoseTask.ts → tasks/diagnoseTask.ts} +8 -8
  342. package/src/tools/{evidencePack.ts → tasks/evidencePack.ts} +36 -22
  343. package/src/tools/{getTaskFile.ts → tasks/getTaskFile.ts} +4 -4
  344. package/src/tools/{getTaskStatus.ts → tasks/getTaskStatus.ts} +7 -5
  345. package/src/tools/{getTaskStdoutTail.ts → tasks/getTaskStdoutTail.ts} +13 -11
  346. package/src/tools/{getTaskSummary.ts → tasks/getTaskSummary.ts} +44 -33
  347. package/src/tools/tasks/index.ts +18 -0
  348. package/src/tools/{listTasks.ts → tasks/listTasks.ts} +4 -4
  349. package/src/tools/{reconcileTasks.ts → tasks/reconcileTasks.ts} +68 -66
  350. package/src/tools/tasks/retryTask.ts +69 -0
  351. package/src/tools/{runTaskLoop.ts → tasks/runTaskLoop.ts} +69 -34
  352. package/src/tools/{runVerification.ts → tasks/runVerification.ts} +6 -3
  353. package/src/tools/{taskLineage.ts → tasks/taskLineage.ts} +8 -7
  354. package/src/tools/{taskOutputs.ts → tasks/taskOutputs.ts} +27 -20
  355. package/src/tools/{androidDoctor.ts → workspace/androidDoctor.ts} +15 -10
  356. package/src/tools/{applyPatch.ts → workspace/applyPatch.ts} +38 -16
  357. package/src/tools/{discardWorktree.ts → workspace/discardWorktree.ts} +3 -3
  358. package/src/tools/workspace/index.ts +10 -0
  359. package/src/tools/{listAgents.ts → workspace/listAgents.ts} +11 -4
  360. package/src/tools/{listWorkspace.ts → workspace/listWorkspace.ts} +3 -3
  361. package/src/tools/{mergeWorktree.ts → workspace/mergeWorktree.ts} +3 -3
  362. package/src/tools/{readWorkspaceFile.ts → workspace/readWorkspaceFile.ts} +8 -8
  363. package/src/tools/{recommendAgentForTask.ts → workspace/recommendAgentForTask.ts} +3 -3
  364. package/src/tools/{searchWorkspace.ts → workspace/searchWorkspace.ts} +5 -5
  365. package/src/tools/workspace/syncFile.ts +292 -0
  366. package/src/utils/atomicFile.ts +58 -0
  367. package/src/utils/boundedFile.ts +116 -0
  368. package/src/utils/lockedJsonFile.ts +251 -0
  369. package/src/utils/platform.ts +31 -0
  370. package/src/utils/stableJson.ts +12 -0
  371. package/src/version.ts +3 -2
  372. package/src/watcherStatus.ts +19 -1
  373. package/ui/desktop-bootstrap.js +11 -0
  374. package/ui/desktop-bridge.js +36 -0
  375. package/ui/desktop.css +160 -0
  376. package/ui/getting-started.js +93 -0
  377. package/ui/i18n.js +484 -0
  378. package/ui/log-parser.js +30 -0
  379. package/ui/pages/audit.html +12 -0
  380. package/ui/pages/dashboard.html +90 -147
  381. package/ui/pages/direct-sessions.html +123 -26
  382. package/ui/pages/getting-started.html +43 -0
  383. package/ui/pages/logs.html +105 -22
  384. package/ui/pages/settings.html +101 -0
  385. package/ui/pages/task-detail.html +12 -0
  386. package/ui/pages/tasks.html +54 -8
  387. package/ui/pages/workspace.html +38 -1
  388. package/ui/settings.js +245 -0
  389. package/PatchWarden-Control.cmd +0 -6
  390. package/Restart-PatchWarden-Control.cmd +0 -6
  391. package/dist/test/unit/acceptance-engine.test.d.ts +0 -1
  392. package/dist/test/unit/acceptance-engine.test.js +0 -228
  393. package/dist/test/unit/agent-router.test.d.ts +0 -1
  394. package/dist/test/unit/agent-router.test.js +0 -287
  395. package/dist/test/unit/android-doctor.test.d.ts +0 -1
  396. package/dist/test/unit/android-doctor.test.js +0 -118
  397. package/dist/test/unit/apply-patch.test.d.ts +0 -1
  398. package/dist/test/unit/apply-patch.test.js +0 -225
  399. package/dist/test/unit/audit-checks.test.d.ts +0 -1
  400. package/dist/test/unit/audit-checks.test.js +0 -350
  401. package/dist/test/unit/chinese-path.test.d.ts +0 -1
  402. package/dist/test/unit/chinese-path.test.js +0 -91
  403. package/dist/test/unit/command-guard.test.d.ts +0 -1
  404. package/dist/test/unit/command-guard.test.js +0 -160
  405. package/dist/test/unit/create-task.test.d.ts +0 -1
  406. package/dist/test/unit/create-task.test.js +0 -197
  407. package/dist/test/unit/diagnose-task.test.d.ts +0 -1
  408. package/dist/test/unit/diagnose-task.test.js +0 -457
  409. package/dist/test/unit/direct-guards.test.d.ts +0 -1
  410. package/dist/test/unit/direct-guards.test.js +0 -328
  411. package/dist/test/unit/discovery-token-store.test.d.ts +0 -1
  412. package/dist/test/unit/discovery-token-store.test.js +0 -139
  413. package/dist/test/unit/evidence-pack.test.d.ts +0 -1
  414. package/dist/test/unit/evidence-pack.test.js +0 -224
  415. package/dist/test/unit/get-task-status.test.d.ts +0 -1
  416. package/dist/test/unit/get-task-status.test.js +0 -174
  417. package/dist/test/unit/get-task-summary.test.d.ts +0 -1
  418. package/dist/test/unit/get-task-summary.test.js +0 -146
  419. package/dist/test/unit/goal-graph.test.d.ts +0 -1
  420. package/dist/test/unit/goal-graph.test.js +0 -298
  421. package/dist/test/unit/goal-progress.test.d.ts +0 -1
  422. package/dist/test/unit/goal-progress.test.js +0 -381
  423. package/dist/test/unit/goal-report.test.d.ts +0 -1
  424. package/dist/test/unit/goal-report.test.js +0 -159
  425. package/dist/test/unit/goal-status.test.d.ts +0 -1
  426. package/dist/test/unit/goal-status.test.js +0 -215
  427. package/dist/test/unit/goal-store.test.d.ts +0 -1
  428. package/dist/test/unit/goal-store.test.js +0 -253
  429. package/dist/test/unit/goal-subgoal-task.test.d.ts +0 -1
  430. package/dist/test/unit/goal-subgoal-task.test.js +0 -55
  431. package/dist/test/unit/goal-tools-registry.test.d.ts +0 -1
  432. package/dist/test/unit/goal-tools-registry.test.js +0 -192
  433. package/dist/test/unit/handoff-export.test.d.ts +0 -1
  434. package/dist/test/unit/handoff-export.test.js +0 -263
  435. package/dist/test/unit/invoke-discovered-tool.test.d.ts +0 -1
  436. package/dist/test/unit/invoke-discovered-tool.test.js +0 -167
  437. package/dist/test/unit/logging.test.d.ts +0 -1
  438. package/dist/test/unit/logging.test.js +0 -397
  439. package/dist/test/unit/path-guard.test.d.ts +0 -1
  440. package/dist/test/unit/path-guard.test.js +0 -133
  441. package/dist/test/unit/post-task-cleanup.test.d.ts +0 -1
  442. package/dist/test/unit/post-task-cleanup.test.js +0 -48
  443. package/dist/test/unit/project-policy-release-mode.test.d.ts +0 -1
  444. package/dist/test/unit/project-policy-release-mode.test.js +0 -125
  445. package/dist/test/unit/reconcile-tasks.test.d.ts +0 -1
  446. package/dist/test/unit/reconcile-tasks.test.js +0 -456
  447. package/dist/test/unit/release-gate.test.d.ts +0 -1
  448. package/dist/test/unit/release-gate.test.js +0 -242
  449. package/dist/test/unit/run-task-loop.test.d.ts +0 -1
  450. package/dist/test/unit/run-task-loop.test.js +0 -380
  451. package/dist/test/unit/safe-status.test.d.ts +0 -1
  452. package/dist/test/unit/safe-status.test.js +0 -165
  453. package/dist/test/unit/safe-views.test.d.ts +0 -1
  454. package/dist/test/unit/safe-views.test.js +0 -171
  455. package/dist/test/unit/schema-drift-check.test.d.ts +0 -1
  456. package/dist/test/unit/schema-drift-check.test.js +0 -176
  457. package/dist/test/unit/sensitive-guard.test.d.ts +0 -1
  458. package/dist/test/unit/sensitive-guard.test.js +0 -104
  459. package/dist/test/unit/spec-kit-import.test.d.ts +0 -1
  460. package/dist/test/unit/spec-kit-import.test.js +0 -341
  461. package/dist/test/unit/subgoal-sync.test.d.ts +0 -1
  462. package/dist/test/unit/subgoal-sync.test.js +0 -183
  463. package/dist/test/unit/sync-file.test.d.ts +0 -1
  464. package/dist/test/unit/sync-file.test.js +0 -154
  465. package/dist/test/unit/tool-invocation-guard.test.d.ts +0 -1
  466. package/dist/test/unit/tool-invocation-guard.test.js +0 -432
  467. package/dist/test/unit/tool-usage-stats.test.d.ts +0 -1
  468. package/dist/test/unit/tool-usage-stats.test.js +0 -300
  469. package/dist/test/unit/toolSearch.test.d.ts +0 -1
  470. package/dist/test/unit/toolSearch.test.js +0 -571
  471. package/dist/test/unit/wait-for-task.test.d.ts +0 -1
  472. package/dist/test/unit/wait-for-task.test.js +0 -144
  473. package/dist/test/unit/watcher-status.test.d.ts +0 -1
  474. package/dist/test/unit/watcher-status.test.js +0 -169
  475. package/dist/test/unit/worktree-manager.test.d.ts +0 -1
  476. package/dist/test/unit/worktree-manager.test.js +0 -176
  477. package/dist/tools/applyPatch.js +0 -41
  478. package/dist/tools/cancelTask.d.ts +0 -30
  479. package/dist/tools/cancelTask.js +0 -64
  480. package/dist/tools/finalizeDirectSession.js +0 -84
  481. package/dist/tools/goalSubgoalTask.js +0 -110
  482. package/dist/tools/killTask.d.ts +0 -15
  483. package/dist/tools/retryTask.js +0 -45
  484. package/dist/tools/runVerification.js +0 -36
  485. package/dist/tools/syncFile.js +0 -65
  486. package/docs/control-center/control-center-daily-driver.md +0 -211
  487. package/docs/control-center/control-center-mvp.md +0 -205
  488. package/docs/control-center/control-center-phase2.md +0 -159
  489. package/docs/execution-plan-2026-07-09.md +0 -315
  490. package/docs/release-v0.6.0.md +0 -71
  491. package/docs/release-v0.6.1.md +0 -75
  492. package/docs/release-v0.6.4.md +0 -45
  493. package/docs/roadmap-execution-and-acceptance.md +0 -365
  494. package/src/test/unit/acceptance-engine.test.ts +0 -261
  495. package/src/test/unit/agent-router.test.ts +0 -342
  496. package/src/test/unit/android-doctor.test.ts +0 -158
  497. package/src/test/unit/apply-patch.test.ts +0 -293
  498. package/src/test/unit/audit-checks.test.ts +0 -567
  499. package/src/test/unit/chinese-path.test.ts +0 -106
  500. package/src/test/unit/command-guard.test.ts +0 -221
  501. package/src/test/unit/create-task.test.ts +0 -255
  502. package/src/test/unit/diagnose-task.test.ts +0 -544
  503. package/src/test/unit/direct-guards.test.ts +0 -467
  504. package/src/test/unit/discovery-token-store.test.ts +0 -181
  505. package/src/test/unit/evidence-pack.test.ts +0 -251
  506. package/src/test/unit/get-task-status.test.ts +0 -203
  507. package/src/test/unit/get-task-summary.test.ts +0 -173
  508. package/src/test/unit/goal-graph.test.ts +0 -347
  509. package/src/test/unit/goal-progress.test.ts +0 -538
  510. package/src/test/unit/goal-report.test.ts +0 -189
  511. package/src/test/unit/goal-status.test.ts +0 -270
  512. package/src/test/unit/goal-store.test.ts +0 -318
  513. package/src/test/unit/goal-subgoal-task.test.ts +0 -72
  514. package/src/test/unit/goal-tools-registry.test.ts +0 -245
  515. package/src/test/unit/handoff-export.test.ts +0 -295
  516. package/src/test/unit/invoke-discovered-tool.test.ts +0 -216
  517. package/src/test/unit/logging.test.ts +0 -497
  518. package/src/test/unit/path-guard.test.ts +0 -180
  519. package/src/test/unit/post-task-cleanup.test.ts +0 -53
  520. package/src/test/unit/project-policy-release-mode.test.ts +0 -156
  521. package/src/test/unit/reconcile-tasks.test.ts +0 -551
  522. package/src/test/unit/release-gate.test.ts +0 -314
  523. package/src/test/unit/run-task-loop.test.ts +0 -425
  524. package/src/test/unit/safe-status.test.ts +0 -187
  525. package/src/test/unit/safe-views.test.ts +0 -184
  526. package/src/test/unit/schema-drift-check.test.ts +0 -260
  527. package/src/test/unit/sensitive-guard.test.ts +0 -124
  528. package/src/test/unit/spec-kit-import.test.ts +0 -429
  529. package/src/test/unit/subgoal-sync.test.ts +0 -236
  530. package/src/test/unit/sync-file.test.ts +0 -231
  531. package/src/test/unit/tool-invocation-guard.test.ts +0 -542
  532. package/src/test/unit/tool-usage-stats.test.ts +0 -384
  533. package/src/test/unit/toolSearch.test.ts +0 -756
  534. package/src/test/unit/wait-for-task.test.ts +0 -176
  535. package/src/test/unit/watcher-status.test.ts +0 -190
  536. package/src/test/unit/worktree-manager.test.ts +0 -247
  537. package/src/tools/cancelTask.ts +0 -70
  538. package/src/tools/retryTask.ts +0 -53
  539. package/src/tools/syncFile.ts +0 -122
  540. /package/dist/tools/{toolCatalog.d.ts → catalog/toolCatalog.d.ts} +0 -0
  541. /package/dist/tools/{toolSearch.d.ts → catalog/toolSearch.d.ts} +0 -0
  542. /package/dist/tools/{toolSearch.js → catalog/toolSearch.js} +0 -0
  543. /package/dist/tools/{toolUsageStats.d.ts → catalog/toolUsageStats.d.ts} +0 -0
  544. /package/dist/tools/{toolUsageStats.js → catalog/toolUsageStats.js} +0 -0
  545. /package/dist/tools/{createDirectSession.d.ts → direct/createDirectSession.d.ts} +0 -0
  546. /package/dist/tools/{runDirectVerificationBundle.d.ts → direct/runDirectVerificationBundle.d.ts} +0 -0
  547. /package/dist/tools/{getPlan.d.ts → goals/getPlan.d.ts} +0 -0
  548. /package/dist/tools/{savePlan.d.ts → goals/savePlan.d.ts} +0 -0
  549. /package/dist/tools/{evidencePack.d.ts → tasks/evidencePack.d.ts} +0 -0
  550. /package/dist/tools/{getTaskFile.d.ts → tasks/getTaskFile.d.ts} +0 -0
  551. /package/dist/tools/{getTaskProgress.d.ts → tasks/getTaskProgress.d.ts} +0 -0
  552. /package/dist/tools/{getTaskProgress.js → tasks/getTaskProgress.js} +0 -0
  553. /package/dist/tools/{getTaskStdoutTail.d.ts → tasks/getTaskStdoutTail.d.ts} +0 -0
  554. /package/dist/tools/{getTaskSummary.d.ts → tasks/getTaskSummary.d.ts} +0 -0
  555. /package/dist/tools/{killTask.js → tasks/killTask.js} +0 -0
  556. /package/dist/tools/{retryTask.d.ts → tasks/retryTask.d.ts} +0 -0
  557. /package/dist/tools/{runVerification.d.ts → tasks/runVerification.d.ts} +0 -0
  558. /package/dist/tools/{taskLineage.d.ts → tasks/taskLineage.d.ts} +0 -0
  559. /package/dist/tools/{taskOutputs.d.ts → tasks/taskOutputs.d.ts} +0 -0
  560. /package/dist/tools/{waitForTask.d.ts → tasks/waitForTask.d.ts} +0 -0
  561. /package/dist/tools/{waitForTask.js → tasks/waitForTask.js} +0 -0
  562. /package/dist/tools/{androidDoctor.d.ts → workspace/androidDoctor.d.ts} +0 -0
  563. /package/dist/tools/{discardWorktree.d.ts → workspace/discardWorktree.d.ts} +0 -0
  564. /package/dist/tools/{listWorkspace.d.ts → workspace/listWorkspace.d.ts} +0 -0
  565. /package/dist/tools/{mergeWorktree.d.ts → workspace/mergeWorktree.d.ts} +0 -0
  566. /package/dist/tools/{readWorkspaceFile.d.ts → workspace/readWorkspaceFile.d.ts} +0 -0
  567. /package/dist/tools/{recommendAgentForTask.d.ts → workspace/recommendAgentForTask.d.ts} +0 -0
  568. /package/dist/tools/{searchWorkspace.d.ts → workspace/searchWorkspace.d.ts} +0 -0
  569. /package/src/tools/{toolSearch.ts → catalog/toolSearch.ts} +0 -0
  570. /package/src/tools/{toolUsageStats.ts → catalog/toolUsageStats.ts} +0 -0
  571. /package/src/tools/{getTaskProgress.ts → tasks/getTaskProgress.ts} +0 -0
  572. /package/src/tools/{killTask.ts → tasks/killTask.ts} +0 -0
  573. /package/src/tools/{waitForTask.ts → tasks/waitForTask.ts} +0 -0
@@ -1,154 +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, readFileSync, existsSync } from "node:fs";
4
- import { join } from "node:path";
5
- import { tmpdir } from "node:os";
6
- import { syncFile } from "../../tools/syncFile.js";
7
- import { computeFileSha256 } from "../../direct/directPatch.js";
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
- describe("syncFile", () => {
29
- let tempDir;
30
- let config;
31
- let repoPath;
32
- let sessionsDir;
33
- let sessionId;
34
- beforeEach(() => {
35
- tempDir = mkdtempSync(join(tmpdir(), "pw-syncfile-"));
36
- config = makeConfig(tempDir);
37
- repoPath = join(tempDir, "my-repo");
38
- sessionsDir = join(tempDir, ".patchwarden", "direct-sessions");
39
- sessionId = "test-session-001";
40
- mkdirSync(repoPath, { recursive: true });
41
- mkdirSync(join(sessionsDir, sessionId), { recursive: true });
42
- writeFileSync(join(sessionsDir, sessionId, "session.json"), JSON.stringify({
43
- session_id: sessionId,
44
- repo_path: repoPath,
45
- status: "active",
46
- created_at: new Date().toISOString(),
47
- }), "utf-8");
48
- });
49
- afterEach(() => {
50
- rmSync(tempDir, { recursive: true, force: true });
51
- });
52
- it("copies a file from source to target", () => {
53
- const sourceContent = "console.log('hello world');";
54
- mkdirSync(join(repoPath, "mobile_app"), { recursive: true });
55
- writeFileSync(join(repoPath, "mobile_app", "app.js"), sourceContent, "utf-8");
56
- const result = syncFile(sessionId, "mobile_app/app.js", "windows_app/app/app.js", undefined, config);
57
- assert.equal(result.changed, true);
58
- assert.equal(result.copied_bytes, sourceContent.length);
59
- assert.equal(result.before_target_sha256, null);
60
- assert.ok(result.after_target_sha256);
61
- const targetContent = readFileSync(join(repoPath, "windows_app", "app", "app.js"), "utf-8");
62
- assert.equal(targetContent, sourceContent);
63
- });
64
- it("returns changed=false when target already has same content", () => {
65
- const sourceContent = "same content";
66
- mkdirSync(join(repoPath, "src"), { recursive: true });
67
- mkdirSync(join(repoPath, "dst"), { recursive: true });
68
- writeFileSync(join(repoPath, "src", "file.ts"), sourceContent, "utf-8");
69
- writeFileSync(join(repoPath, "dst", "file.ts"), sourceContent, "utf-8");
70
- const result = syncFile(sessionId, "src/file.ts", "dst/file.ts", undefined, config);
71
- assert.equal(result.changed, false);
72
- assert.ok(result.before_target_sha256);
73
- assert.equal(result.before_target_sha256, result.after_target_sha256);
74
- });
75
- it("returns changed=true when target has different content", () => {
76
- mkdirSync(join(repoPath, "src"), { recursive: true });
77
- mkdirSync(join(repoPath, "dst"), { recursive: true });
78
- writeFileSync(join(repoPath, "src", "file.ts"), "new content", "utf-8");
79
- writeFileSync(join(repoPath, "dst", "file.ts"), "old content", "utf-8");
80
- const result = syncFile(sessionId, "src/file.ts", "dst/file.ts", undefined, config);
81
- assert.equal(result.changed, true);
82
- assert.notEqual(result.before_target_sha256, result.after_target_sha256);
83
- });
84
- it("rejects source path outside repo", () => {
85
- mkdirSync(join(repoPath, "src"), { recursive: true });
86
- writeFileSync(join(repoPath, "src", "file.ts"), "content", "utf-8");
87
- assert.throws(() => syncFile(sessionId, "../../../etc/passwd", "dst/file.ts", undefined, config), Error);
88
- });
89
- it("rejects target path outside repo", () => {
90
- mkdirSync(join(repoPath, "src"), { recursive: true });
91
- writeFileSync(join(repoPath, "src", "file.ts"), "content", "utf-8");
92
- assert.throws(() => syncFile(sessionId, "src/file.ts", "../../../etc/evil", undefined, config), Error);
93
- });
94
- it("rejects sensitive source files", () => {
95
- writeFileSync(join(repoPath, ".env"), "SECRET=abc123", "utf-8");
96
- assert.throws(() => syncFile(sessionId, ".env", "dst/.env", undefined, config), Error);
97
- });
98
- it("rejects sensitive target files", () => {
99
- mkdirSync(join(repoPath, "src"), { recursive: true });
100
- writeFileSync(join(repoPath, "src", "file.ts"), "content", "utf-8");
101
- assert.throws(() => syncFile(sessionId, "src/file.ts", "config.json", undefined, config), Error);
102
- });
103
- it("rejects writing to node_modules", () => {
104
- mkdirSync(join(repoPath, "src"), { recursive: true });
105
- writeFileSync(join(repoPath, "src", "file.ts"), "content", "utf-8");
106
- assert.throws(() => syncFile(sessionId, "src/file.ts", "node_modules/evil/index.js", undefined, config), Error);
107
- });
108
- it("rejects writing to dist", () => {
109
- mkdirSync(join(repoPath, "src"), { recursive: true });
110
- writeFileSync(join(repoPath, "src", "file.ts"), "content", "utf-8");
111
- assert.throws(() => syncFile(sessionId, "src/file.ts", "dist/main.js", undefined, config), Error);
112
- });
113
- it("rejects non-existent session", () => {
114
- mkdirSync(join(repoPath, "src"), { recursive: true });
115
- writeFileSync(join(repoPath, "src", "file.ts"), "content", "utf-8");
116
- assert.throws(() => syncFile("non-existent-session", "src/file.ts", "dst/file.ts", undefined, config), Error);
117
- });
118
- it("rejects non-existent source file", () => {
119
- assert.throws(() => syncFile(sessionId, "non-existent/file.ts", "dst/file.ts", undefined, config), Error);
120
- });
121
- it("validates expected_source_sha256", () => {
122
- mkdirSync(join(repoPath, "src"), { recursive: true });
123
- writeFileSync(join(repoPath, "src", "file.ts"), "content", "utf-8");
124
- const correctHash = computeFileSha256(join(repoPath, "src", "file.ts"));
125
- const result = syncFile(sessionId, "src/file.ts", "dst/file.ts", {
126
- expected_source_sha256: correctHash,
127
- }, config);
128
- assert.equal(result.source_sha256, correctHash);
129
- assert.throws(() => syncFile(sessionId, "src/file.ts", "dst2/file.ts", {
130
- expected_source_sha256: "wronghash",
131
- }, config), Error);
132
- });
133
- it("validates expected_target_sha256", () => {
134
- mkdirSync(join(repoPath, "src"), { recursive: true });
135
- mkdirSync(join(repoPath, "dst"), { recursive: true });
136
- writeFileSync(join(repoPath, "src", "file.ts"), "new content", "utf-8");
137
- writeFileSync(join(repoPath, "dst", "file.ts"), "old content", "utf-8");
138
- const correctTargetHash = computeFileSha256(join(repoPath, "dst", "file.ts"));
139
- const result = syncFile(sessionId, "src/file.ts", "dst/file.ts", {
140
- expected_target_sha256: correctTargetHash,
141
- }, config);
142
- assert.equal(result.before_target_sha256, correctTargetHash);
143
- assert.throws(() => syncFile(sessionId, "src/file.ts", "dst/file.ts", {
144
- expected_target_sha256: "wronghash",
145
- }, config), Error);
146
- });
147
- it("creates target directory if it doesn't exist", () => {
148
- mkdirSync(join(repoPath, "src"), { recursive: true });
149
- writeFileSync(join(repoPath, "src", "file.ts"), "content", "utf-8");
150
- const result = syncFile(sessionId, "src/file.ts", "deep/nested/path/file.ts", undefined, config);
151
- assert.equal(result.changed, true);
152
- assert.ok(existsSync(join(repoPath, "deep", "nested", "path", "file.ts")));
153
- });
154
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,432 +0,0 @@
1
- import { describe, it } from "node:test";
2
- import { strict as assert } from "node:assert";
3
- import { checkInvocation } from "../../security/toolInvocationGuard.js";
4
- import { PatchWardenError } from "../../errors.js";
5
- // ── Helpers ───────────────────────────────────────────────────────
6
- function makeToolMeta(overrides = {}) {
7
- return {
8
- name: "read_workspace_file",
9
- title: "Read Workspace File",
10
- summary: "读取工作区文件内容(自动脱敏敏感路径)",
11
- description: "Read workspace file content with sensitive path redaction.",
12
- profiles: ["full", "chatgpt_core", "chatgpt_direct"],
13
- modes: ["delegate", "direct", "audit"],
14
- tags: ["read", "file", "workspace"],
15
- aliases: ["read_file"],
16
- risk: "workspace_read_sensitive",
17
- requiresConfirmation: false,
18
- inputSchemaDigest: "sha256:abc123",
19
- ...overrides,
20
- };
21
- }
22
- function makeTokenRecord(overrides = {}) {
23
- return {
24
- token: "tok",
25
- toolName: "read_workspace_file",
26
- risk: "workspace_read_sensitive",
27
- issuedAt: "2026-01-01T00:00:00.000Z",
28
- expiresAt: "2026-01-01T00:10:00.000Z",
29
- query: "read file",
30
- schemaDigest: "sha256:abc123",
31
- profile: "full",
32
- ...overrides,
33
- };
34
- }
35
- function makeInput(overrides = {}) {
36
- return {
37
- toolName: "read_workspace_file",
38
- toolMeta: makeToolMeta(),
39
- args: {},
40
- discoveryTokenRecord: makeTokenRecord(),
41
- profile: "full",
42
- assessmentId: undefined,
43
- ...overrides,
44
- };
45
- }
46
- // 辅助:断言会抛出指定 reason 的 PatchWardenError
47
- function assertPatchWardenError(fn, reason, messageContains) {
48
- assert.throws(fn, (err) => {
49
- assert.ok(err instanceof PatchWardenError, `expected PatchWardenError, got ${err?.constructor?.name}`);
50
- assert.equal(err.reason, reason, `expected reason "${reason}", got "${err.reason}"`);
51
- if (messageContains) {
52
- assert.ok(err.message.includes(messageContains), `expected message to contain "${messageContains}", got "${err.message}"`);
53
- }
54
- assert.equal(err.blocked, true, "blocked should default to true");
55
- return true;
56
- });
57
- }
58
- // ── Tests ─────────────────────────────────────────────────────────
59
- describe("toolInvocationGuard", () => {
60
- describe("① token_tool_mismatch", () => {
61
- it("toolName 与 record.toolName 不一致时抛 token_tool_mismatch", () => {
62
- const input = makeInput({
63
- toolName: "save_plan",
64
- discoveryTokenRecord: makeTokenRecord({ toolName: "read_workspace_file" }),
65
- });
66
- assertPatchWardenError(() => checkInvocation(input), "token_tool_mismatch", "save_plan");
67
- });
68
- it("toolName 一致时不抛该错误(成功路径在后面统一验证)", () => {
69
- const input = makeInput({
70
- toolName: "read_workspace_file",
71
- discoveryTokenRecord: makeTokenRecord({ toolName: "read_workspace_file" }),
72
- });
73
- // 不应抛 token_tool_mismatch;后续校验会通过
74
- const result = checkInvocation(input);
75
- assert.deepEqual(result, { allowed: true });
76
- });
77
- });
78
- describe("② profile_not_allowed", () => {
79
- it("toolMeta.profiles 不含当前 profile 时抛 profile_not_allowed", () => {
80
- const input = makeInput({
81
- toolMeta: makeToolMeta({
82
- profiles: ["full", "chatgpt_core"],
83
- }),
84
- profile: "chatgpt_direct",
85
- });
86
- assertPatchWardenError(() => checkInvocation(input), "profile_not_allowed", "chatgpt_direct");
87
- });
88
- it("profile 在允许列表内时通过(后续校验继续)", () => {
89
- const input = makeInput({
90
- toolMeta: makeToolMeta({ profiles: ["full", "chatgpt_direct"] }),
91
- profile: "chatgpt_direct",
92
- });
93
- const result = checkInvocation(input);
94
- assert.deepEqual(result, { allowed: true });
95
- });
96
- });
97
- describe("③ risk_exceeded", () => {
98
- it("toolMeta.risk 高于 record.risk 时抛 risk_exceeded(schema 漂移)", () => {
99
- const input = makeInput({
100
- toolMeta: makeToolMeta({
101
- name: "create_task",
102
- risk: "workspace_write", // rank 2
103
- }),
104
- toolName: "create_task",
105
- discoveryTokenRecord: makeTokenRecord({
106
- toolName: "create_task",
107
- risk: "workspace_read_sensitive", // rank 1
108
- }),
109
- // workspace_write 需要 assessmentId
110
- assessmentId: "asm_risk_exceeded_test",
111
- });
112
- assertPatchWardenError(() => checkInvocation(input), "risk_exceeded", "workspace_write");
113
- });
114
- it("toolMeta.risk 等于 record.risk 时通过(相等不算超过)", () => {
115
- const input = makeInput({
116
- toolMeta: makeToolMeta({ risk: "workspace_read_sensitive" }),
117
- discoveryTokenRecord: makeTokenRecord({ risk: "workspace_read_sensitive" }),
118
- });
119
- const result = checkInvocation(input);
120
- assert.deepEqual(result, { allowed: true });
121
- });
122
- it("toolMeta.risk 低于 record.risk 时通过(更宽松 token 调更安全工具)", () => {
123
- const input = makeInput({
124
- toolMeta: makeToolMeta({
125
- name: "health_check",
126
- risk: "readonly", // rank 0
127
- profiles: ["full"],
128
- }),
129
- toolName: "health_check",
130
- discoveryTokenRecord: makeTokenRecord({
131
- toolName: "health_check",
132
- risk: "workspace_read_sensitive", // rank 1,更高
133
- }),
134
- });
135
- const result = checkInvocation(input);
136
- assert.deepEqual(result, { allowed: true });
137
- });
138
- });
139
- describe("④ sensitive_path_blocked", () => {
140
- it("workspace_read_sensitive 工具读 .env 路径时抛 sensitive_path_blocked", () => {
141
- const input = makeInput({
142
- args: { path: ".env" },
143
- });
144
- assertPatchWardenError(() => checkInvocation(input), "sensitive_path_blocked", ".env");
145
- });
146
- it("workspace_read_sensitive 工具读非敏感路径时通过", () => {
147
- const input = makeInput({
148
- args: { path: "src/main.ts" },
149
- });
150
- const result = checkInvocation(input);
151
- assert.deepEqual(result, { allowed: true });
152
- });
153
- it("无路径参数时跳过敏感校验", () => {
154
- const input = makeInput({
155
- args: { query: "some text" },
156
- });
157
- const result = checkInvocation(input);
158
- assert.deepEqual(result, { allowed: true });
159
- });
160
- it("支持 file / repo_path / target_path 等多种路径字段", () => {
161
- // file 字段命中敏感
162
- assertPatchWardenError(() => checkInvocation(makeInput({ args: { file: "id_rsa" } })), "sensitive_path_blocked");
163
- // repo_path 字段命中敏感
164
- assertPatchWardenError(() => checkInvocation(makeInput({ args: { repo_path: ".npmrc" } })), "sensitive_path_blocked");
165
- // target_path 字段命中敏感
166
- assertPatchWardenError(() => checkInvocation(makeInput({ args: { target_path: "config.json" } })), "sensitive_path_blocked");
167
- });
168
- });
169
- describe("⑤ assessment_required", () => {
170
- it("workspace_write 工具无 assessmentId 时抛 assessment_required", () => {
171
- const input = makeInput({
172
- toolMeta: makeToolMeta({
173
- name: "save_plan",
174
- risk: "workspace_write",
175
- profiles: ["full"],
176
- }),
177
- toolName: "save_plan",
178
- discoveryTokenRecord: makeTokenRecord({
179
- toolName: "save_plan",
180
- risk: "workspace_write",
181
- }),
182
- assessmentId: undefined,
183
- });
184
- assertPatchWardenError(() => checkInvocation(input), "assessment_required", "save_plan");
185
- });
186
- it("workspace_write 工具 assessmentId 为空字符串时抛 assessment_required", () => {
187
- const input = makeInput({
188
- toolMeta: makeToolMeta({
189
- name: "save_plan",
190
- risk: "workspace_write",
191
- profiles: ["full"],
192
- }),
193
- toolName: "save_plan",
194
- discoveryTokenRecord: makeTokenRecord({
195
- toolName: "save_plan",
196
- risk: "workspace_write",
197
- }),
198
- assessmentId: " ",
199
- });
200
- assertPatchWardenError(() => checkInvocation(input), "assessment_required");
201
- });
202
- it("workspace_write 工具有 assessmentId 时通过", () => {
203
- const input = makeInput({
204
- toolMeta: makeToolMeta({
205
- name: "save_plan",
206
- risk: "workspace_write",
207
- profiles: ["full"],
208
- }),
209
- toolName: "save_plan",
210
- discoveryTokenRecord: makeTokenRecord({
211
- toolName: "save_plan",
212
- risk: "workspace_write",
213
- }),
214
- assessmentId: "asm_workspace_write_ok",
215
- });
216
- const result = checkInvocation(input);
217
- assert.deepEqual(result, { allowed: true });
218
- });
219
- });
220
- describe("⑥ command_not_allowed", () => {
221
- function commandInput(command) {
222
- return makeInput({
223
- toolMeta: makeToolMeta({
224
- name: "run_verification",
225
- risk: "command",
226
- profiles: ["full", "chatgpt_direct"],
227
- }),
228
- toolName: "run_verification",
229
- discoveryTokenRecord: makeTokenRecord({
230
- toolName: "run_verification",
231
- risk: "command",
232
- }),
233
- args: { command },
234
- });
235
- }
236
- it("args.command 含管道 | 时抛 command_not_allowed", () => {
237
- assertPatchWardenError(() => checkInvocation(commandInput("ls | grep secret")), "command_not_allowed");
238
- });
239
- it("args.command 含 & 时抛 command_not_allowed", () => {
240
- assertPatchWardenError(() => checkInvocation(commandInput("rm -rf & background")), "command_not_allowed");
241
- });
242
- it("args.command 含 $() 时抛 command_not_allowed", () => {
243
- assertPatchWardenError(() => checkInvocation(commandInput("echo $(cat .env)")), "command_not_allowed");
244
- });
245
- it("args.command 含反引号时抛 command_not_allowed", () => {
246
- assertPatchWardenError(() => checkInvocation(commandInput("echo `whoami`")), "command_not_allowed");
247
- });
248
- it("args.command 含分号时抛 command_not_allowed", () => {
249
- assertPatchWardenError(() => checkInvocation(commandInput("ls; rm -rf /")), "command_not_allowed");
250
- });
251
- it("args.command 不含元字符时通过(白名单由 handler 校验)", () => {
252
- const result = checkInvocation(commandInput("npm test"));
253
- assert.deepEqual(result, { allowed: true });
254
- });
255
- it("args.command 不存在时跳过(handler 内部再校验)", () => {
256
- const result = checkInvocation(commandInput(undefined));
257
- assert.deepEqual(result, { allowed: true });
258
- });
259
- it("args.command 为空字符串时跳过", () => {
260
- const result = checkInvocation(commandInput(" "));
261
- assert.deepEqual(result, { allowed: true });
262
- });
263
- });
264
- describe("⑦ release_confirmation_required", () => {
265
- it("release 工具无 assessmentId 时抛 release_confirmation_required", () => {
266
- const input = makeInput({
267
- toolMeta: makeToolMeta({
268
- name: "publish_release",
269
- risk: "release",
270
- profiles: ["full"],
271
- }),
272
- toolName: "publish_release",
273
- discoveryTokenRecord: makeTokenRecord({
274
- toolName: "publish_release",
275
- risk: "release",
276
- }),
277
- assessmentId: undefined,
278
- });
279
- assertPatchWardenError(() => checkInvocation(input), "release_confirmation_required", "publish_release");
280
- });
281
- it("release 工具有 assessmentId 时通过", () => {
282
- const input = makeInput({
283
- toolMeta: makeToolMeta({
284
- name: "publish_release",
285
- risk: "release",
286
- profiles: ["full"],
287
- }),
288
- toolName: "publish_release",
289
- discoveryTokenRecord: makeTokenRecord({
290
- toolName: "publish_release",
291
- risk: "release",
292
- }),
293
- assessmentId: "asm_release_confirm",
294
- });
295
- const result = checkInvocation(input);
296
- assert.deepEqual(result, { allowed: true });
297
- });
298
- });
299
- describe("⑧ credential_sensitive_blocked", () => {
300
- it("credential_sensitive 工具总是被拒绝", () => {
301
- const input = makeInput({
302
- toolMeta: makeToolMeta({
303
- name: "rotate_secret",
304
- risk: "credential_sensitive",
305
- profiles: ["full"],
306
- }),
307
- toolName: "rotate_secret",
308
- discoveryTokenRecord: makeTokenRecord({
309
- toolName: "rotate_secret",
310
- risk: "credential_sensitive",
311
- }),
312
- assessmentId: "asm_does_not_matter",
313
- });
314
- assertPatchWardenError(() => checkInvocation(input), "credential_sensitive_blocked", "rotate_secret");
315
- });
316
- it("credential_sensitive 工具即使有 assessmentId 也被拒绝", () => {
317
- const input = makeInput({
318
- toolMeta: makeToolMeta({
319
- name: "rotate_secret",
320
- risk: "credential_sensitive",
321
- profiles: ["full"],
322
- }),
323
- toolName: "rotate_secret",
324
- discoveryTokenRecord: makeTokenRecord({
325
- toolName: "rotate_secret",
326
- risk: "credential_sensitive",
327
- }),
328
- assessmentId: "asm_credential",
329
- });
330
- assertPatchWardenError(() => checkInvocation(input), "credential_sensitive_blocked");
331
- });
332
- });
333
- describe("成功场景", () => {
334
- it("成功场景 1: readonly 工具 + 有效 token + profile 允许 → { allowed: true }", () => {
335
- const input = makeInput({
336
- toolMeta: makeToolMeta({
337
- name: "health_check",
338
- risk: "readonly",
339
- profiles: ["full", "chatgpt_core", "chatgpt_direct"],
340
- }),
341
- toolName: "health_check",
342
- discoveryTokenRecord: makeTokenRecord({
343
- toolName: "health_check",
344
- risk: "readonly",
345
- }),
346
- profile: "chatgpt_core",
347
- args: {},
348
- });
349
- const result = checkInvocation(input);
350
- assert.deepEqual(result, { allowed: true });
351
- });
352
- it("成功场景 2: workspace_write 工具 + 有效 token + 有 assessmentId → { allowed: true }", () => {
353
- const input = makeInput({
354
- toolMeta: makeToolMeta({
355
- name: "create_task",
356
- risk: "workspace_write",
357
- profiles: ["full", "chatgpt_core"],
358
- }),
359
- toolName: "create_task",
360
- discoveryTokenRecord: makeTokenRecord({
361
- toolName: "create_task",
362
- risk: "workspace_write",
363
- }),
364
- profile: "chatgpt_core",
365
- assessmentId: "asm_success_write",
366
- args: { prompt: "do something" },
367
- });
368
- const result = checkInvocation(input);
369
- assert.deepEqual(result, { allowed: true });
370
- });
371
- it("成功场景 3: workspace_read_sensitive 工具 + 有效 token + 非敏感路径 → { allowed: true }", () => {
372
- const input = makeInput({
373
- toolMeta: makeToolMeta({
374
- name: "read_workspace_file",
375
- risk: "workspace_read_sensitive",
376
- profiles: ["full", "chatgpt_core", "chatgpt_direct"],
377
- }),
378
- toolName: "read_workspace_file",
379
- discoveryTokenRecord: makeTokenRecord({
380
- toolName: "read_workspace_file",
381
- risk: "workspace_read_sensitive",
382
- }),
383
- profile: "chatgpt_direct",
384
- args: { path: "src/index.ts", file: "README.md" },
385
- });
386
- const result = checkInvocation(input);
387
- assert.deepEqual(result, { allowed: true });
388
- });
389
- it("成功场景 4: command 工具 + 有效 token + 安全命令 → { allowed: true }", () => {
390
- const input = makeInput({
391
- toolMeta: makeToolMeta({
392
- name: "run_verification",
393
- risk: "command",
394
- profiles: ["full", "chatgpt_direct"],
395
- }),
396
- toolName: "run_verification",
397
- discoveryTokenRecord: makeTokenRecord({
398
- toolName: "run_verification",
399
- risk: "command",
400
- }),
401
- profile: "chatgpt_direct",
402
- args: { command: "npm.cmd test" },
403
- });
404
- const result = checkInvocation(input);
405
- assert.deepEqual(result, { allowed: true });
406
- });
407
- });
408
- describe("GuardInput 类型守卫与边界", () => {
409
- it("args.command 为非字符串类型时跳过(handler 内再校验)", () => {
410
- const input = makeInput({
411
- toolMeta: makeToolMeta({
412
- name: "run_verification",
413
- risk: "command",
414
- profiles: ["full"],
415
- }),
416
- toolName: "run_verification",
417
- discoveryTokenRecord: makeTokenRecord({
418
- toolName: "run_verification",
419
- risk: "command",
420
- }),
421
- args: { command: 123 },
422
- });
423
- const result = checkInvocation(input);
424
- assert.deepEqual(result, { allowed: true });
425
- });
426
- it("GuardResult.allowed 始终为 true(失败时已抛错)", () => {
427
- const result = checkInvocation(makeInput());
428
- assert.equal(result.allowed, true);
429
- assert.equal(Object.keys(result).length, 1, "GuardResult 只应有 allowed 字段");
430
- });
431
- });
432
- });
@@ -1 +0,0 @@
1
- export {};