patchwarden 1.5.0 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (597) hide show
  1. package/PatchWarden.cmd +32 -2
  2. package/README.en.md +194 -26
  3. package/README.md +160 -22
  4. package/dist/assessments/agentAssessor.d.ts +1 -1
  5. package/dist/assessments/agentAssessor.js +24 -15
  6. package/dist/assessments/assessmentStore.d.ts +1 -1
  7. package/dist/assessments/assessmentStore.js +44 -36
  8. package/dist/assessments/confirmCli.js +5 -4
  9. package/dist/config.d.ts +22 -0
  10. package/dist/config.js +98 -11
  11. package/dist/control/fileManager.d.ts +2 -0
  12. package/dist/control/fileManager.js +39 -0
  13. package/dist/control/middleware/auth.d.ts +16 -0
  14. package/dist/control/middleware/auth.js +17 -0
  15. package/dist/control/middleware/static.d.ts +3 -0
  16. package/dist/control/middleware/static.js +78 -0
  17. package/dist/control/routeTable.d.ts +24 -0
  18. package/dist/control/routeTable.js +263 -0
  19. package/dist/control/routes/audit.d.ts +15 -0
  20. package/dist/control/routes/audit.js +287 -0
  21. package/dist/control/routes/evidence.d.ts +4 -0
  22. package/dist/control/routes/evidence.js +96 -0
  23. package/dist/control/routes/lineage.d.ts +3 -0
  24. package/dist/control/routes/lineage.js +71 -0
  25. package/dist/control/routes/policy.d.ts +3 -0
  26. package/dist/control/routes/policy.js +81 -0
  27. package/dist/control/routes/process.d.ts +12 -0
  28. package/dist/control/routes/process.js +487 -0
  29. package/dist/control/routes/sessions.d.ts +30 -0
  30. package/dist/control/routes/sessions.js +287 -0
  31. package/dist/control/routes/status.d.ts +51 -0
  32. package/dist/control/routes/status.js +307 -0
  33. package/dist/control/routes/taskActions.d.ts +21 -0
  34. package/dist/control/routes/taskActions.js +197 -0
  35. package/dist/control/routes/tasks.d.ts +24 -0
  36. package/dist/control/routes/tasks.js +309 -0
  37. package/dist/control/routes/workspace.d.ts +15 -0
  38. package/dist/control/routes/workspace.js +220 -0
  39. package/dist/control/runtime.d.ts +92 -0
  40. package/dist/control/runtime.js +425 -0
  41. package/dist/control/server.d.ts +13 -0
  42. package/dist/control/server.js +150 -0
  43. package/dist/control/shared.d.ts +59 -0
  44. package/dist/control/shared.js +341 -0
  45. package/dist/controlCenter.d.ts +6 -0
  46. package/dist/controlCenter.js +7 -2197
  47. package/dist/direct/directAudit.js +234 -225
  48. package/dist/direct/directGuards.d.ts +2 -1
  49. package/dist/direct/directGuards.js +72 -37
  50. package/dist/direct/directPatch.d.ts +6 -1
  51. package/dist/direct/directPatch.js +55 -8
  52. package/dist/direct/directSessionStore.d.ts +16 -6
  53. package/dist/direct/directSessionStore.js +127 -35
  54. package/dist/direct/directVerification.js +8 -16
  55. package/dist/doctor.d.ts +18 -1
  56. package/dist/doctor.js +614 -373
  57. package/dist/goal/acceptanceEngine.d.ts +1 -1
  58. package/dist/goal/goalProgress.js +75 -69
  59. package/dist/goal/goalReport.d.ts +54 -0
  60. package/dist/goal/goalReport.js +197 -0
  61. package/dist/goal/goalStatus.d.ts +8 -0
  62. package/dist/goal/goalStatus.js +10 -3
  63. package/dist/goal/goalStore.d.ts +9 -2
  64. package/dist/goal/goalStore.js +152 -45
  65. package/dist/goal/handoffExport.js +6 -6
  66. package/dist/goal/specKitImport.d.ts +63 -0
  67. package/dist/goal/specKitImport.js +221 -0
  68. package/dist/goal/subgoalSync.js +13 -10
  69. package/dist/goal/worktreeManager.d.ts +2 -0
  70. package/dist/goal/worktreeManager.js +209 -136
  71. package/dist/httpServer.js +126 -44
  72. package/dist/index.js +7 -4
  73. package/dist/logging.d.ts +7 -1
  74. package/dist/logging.js +13 -3
  75. package/dist/policy/projectPolicy.js +5 -2
  76. package/dist/release/releaseGate.d.ts +1 -1
  77. package/dist/release/releaseGate.js +78 -25
  78. package/dist/runner/agentInvocation.d.ts +14 -0
  79. package/dist/runner/agentInvocation.js +96 -4
  80. package/dist/runner/changeCapture.d.ts +14 -6
  81. package/dist/runner/changeCapture.js +287 -81
  82. package/dist/runner/cli.js +7 -6
  83. package/dist/runner/postTaskCleanup.js +60 -7
  84. package/dist/runner/processSecurity.d.ts +56 -0
  85. package/dist/runner/processSecurity.js +373 -0
  86. package/dist/runner/runTask.d.ts +1 -1
  87. package/dist/runner/runTask.js +339 -287
  88. package/dist/runner/simpleProcess.d.ts +3 -0
  89. package/dist/runner/simpleProcess.js +52 -38
  90. package/dist/{taskProgress.d.ts → runner/taskProgress.d.ts} +1 -1
  91. package/dist/{taskProgress.js → runner/taskProgress.js} +2 -2
  92. package/dist/{taskRuntime.d.ts → runner/taskRuntime.d.ts} +1 -1
  93. package/dist/{taskRuntime.js → runner/taskRuntime.js} +3 -2
  94. package/dist/runner/taskStatusStore.d.ts +11 -0
  95. package/dist/runner/taskStatusStore.js +24 -0
  96. package/dist/runner/watch.d.ts +14 -1
  97. package/dist/runner/watch.js +265 -54
  98. package/dist/security/contentRedaction.d.ts +6 -0
  99. package/dist/security/contentRedaction.js +24 -2
  100. package/dist/security/discoveryTokenStore.d.ts +3 -2
  101. package/dist/security/discoveryTokenStore.js +17 -2
  102. package/dist/security/loopbackHost.d.ts +2 -0
  103. package/dist/security/loopbackHost.js +16 -0
  104. package/dist/security/pathGuard.js +32 -17
  105. package/dist/security/planGuard.js +2 -1
  106. package/dist/security/runtimeGuard.js +9 -6
  107. package/dist/security/secretComparison.d.ts +3 -0
  108. package/dist/security/secretComparison.js +11 -0
  109. package/dist/security/sensitiveGuard.d.ts +5 -0
  110. package/dist/security/sensitiveGuard.js +27 -8
  111. package/dist/security/toolInvocationGuard.d.ts +2 -2
  112. package/dist/security/toolInvocationGuard.js +1 -1
  113. package/dist/security/workspaceRootGuard.d.ts +8 -0
  114. package/dist/security/workspaceRootGuard.js +47 -0
  115. package/dist/smoke-test.js +280 -273
  116. package/dist/tools/catalog/index.d.ts +4 -0
  117. package/dist/tools/catalog/index.js +4 -0
  118. package/dist/tools/{toolCatalog.js → catalog/toolCatalog.js} +3 -12
  119. package/dist/tools/{toolRegistry.d.ts → catalog/toolRegistry.d.ts} +3 -3
  120. package/dist/tools/{toolRegistry.js → catalog/toolRegistry.js} +28 -15
  121. package/dist/tools/definitions/toolDefs.d.ts +18 -0
  122. package/dist/tools/definitions/toolDefs.js +1177 -0
  123. package/dist/tools/{auditSession.d.ts → diagnostics/auditSession.d.ts} +1 -1
  124. package/dist/tools/{auditSession.js → diagnostics/auditSession.js} +2 -2
  125. package/dist/tools/{auditTask.d.ts → diagnostics/auditTask.d.ts} +8 -63
  126. package/dist/tools/{auditTask.js → diagnostics/auditTask.js} +111 -37
  127. package/dist/tools/{healthCheck.d.ts → diagnostics/healthCheck.d.ts} +6 -6
  128. package/dist/tools/{healthCheck.js → diagnostics/healthCheck.js} +10 -10
  129. package/dist/tools/diagnostics/index.d.ts +6 -0
  130. package/dist/tools/diagnostics/index.js +6 -0
  131. package/dist/tools/{safeStatus.d.ts → diagnostics/safeStatus.d.ts} +3 -3
  132. package/dist/tools/{safeStatus.js → diagnostics/safeStatus.js} +6 -6
  133. package/dist/tools/{safeViews.d.ts → diagnostics/safeViews.d.ts} +14 -10
  134. package/dist/tools/{safeViews.js → diagnostics/safeViews.js} +25 -15
  135. package/dist/tools/{schemaDriftCheck.d.ts → diagnostics/schemaDriftCheck.d.ts} +1 -1
  136. package/dist/tools/{schemaDriftCheck.js → diagnostics/schemaDriftCheck.js} +2 -2
  137. package/dist/tools/{createDirectSession.d.ts → direct/createDirectSession.d.ts} +1 -1
  138. package/dist/tools/{createDirectSession.js → direct/createDirectSession.js} +8 -8
  139. package/dist/tools/{finalizeDirectSession.d.ts → direct/finalizeDirectSession.d.ts} +2 -2
  140. package/dist/tools/direct/finalizeDirectSession.js +86 -0
  141. package/dist/tools/direct/index.d.ts +3 -0
  142. package/dist/tools/direct/index.js +3 -0
  143. package/dist/tools/{runDirectVerificationBundle.js → direct/runDirectVerificationBundle.js} +2 -2
  144. package/dist/tools/{discoverTools.d.ts → discovery/discoverTools.d.ts} +2 -2
  145. package/dist/tools/{discoverTools.js → discovery/discoverTools.js} +5 -5
  146. package/dist/tools/{explainTool.d.ts → discovery/explainTool.d.ts} +2 -2
  147. package/dist/tools/{explainTool.js → discovery/explainTool.js} +2 -2
  148. package/dist/tools/discovery/index.d.ts +3 -0
  149. package/dist/tools/discovery/index.js +3 -0
  150. package/dist/tools/{invokeDiscoveredTool.d.ts → discovery/invokeDiscoveredTool.d.ts} +2 -2
  151. package/dist/tools/{invokeDiscoveredTool.js → discovery/invokeDiscoveredTool.js} +5 -5
  152. package/dist/tools/dispatch/coreDispatch.d.ts +9 -0
  153. package/dist/tools/dispatch/coreDispatch.js +283 -0
  154. package/dist/tools/dispatch/diagnosticDispatch.d.ts +12 -0
  155. package/dist/tools/dispatch/diagnosticDispatch.js +80 -0
  156. package/dist/tools/dispatch/directDispatch.d.ts +8 -0
  157. package/dist/tools/dispatch/directDispatch.js +116 -0
  158. package/dist/tools/dispatch/goalDispatch.d.ts +8 -0
  159. package/dist/tools/dispatch/goalDispatch.js +92 -0
  160. package/dist/tools/dispatch/releaseDispatch.d.ts +8 -0
  161. package/dist/tools/dispatch/releaseDispatch.js +46 -0
  162. package/dist/tools/dispatch/types.d.ts +23 -0
  163. package/dist/tools/dispatch/types.js +15 -0
  164. package/dist/tools/dispatch/validation.d.ts +7 -0
  165. package/dist/tools/dispatch/validation.js +71 -0
  166. package/dist/tools/{getPlan.js → goals/getPlan.js} +4 -4
  167. package/dist/tools/{goalSubgoalTask.d.ts → goals/goalSubgoalTask.d.ts} +2 -2
  168. package/dist/tools/goals/goalSubgoalTask.js +118 -0
  169. package/dist/tools/goals/index.d.ts +3 -0
  170. package/dist/tools/goals/index.js +3 -0
  171. package/dist/tools/{savePlan.js → goals/savePlan.js} +28 -8
  172. package/dist/tools/registry.d.ts +10 -14
  173. package/dist/tools/registry.js +47 -1651
  174. package/dist/tools/{checkReleaseGate.d.ts → release/checkReleaseGate.d.ts} +1 -1
  175. package/dist/tools/{checkReleaseGate.js → release/checkReleaseGate.js} +3 -3
  176. package/dist/tools/release/index.d.ts +2 -0
  177. package/dist/tools/release/index.js +2 -0
  178. package/dist/tools/{releaseMode.d.ts → release/releaseMode.d.ts} +2 -2
  179. package/dist/tools/{releaseMode.js → release/releaseMode.js} +46 -26
  180. package/dist/tools/tasks/cancelTask.d.ts +11 -0
  181. package/dist/tools/tasks/cancelTask.js +85 -0
  182. package/dist/tools/{createTask.d.ts → tasks/createTask.d.ts} +12 -4
  183. package/dist/tools/{createTask.js → tasks/createTask.js} +46 -31
  184. package/dist/tools/{diagnoseTask.d.ts → tasks/diagnoseTask.d.ts} +1 -1
  185. package/dist/tools/{diagnoseTask.js → tasks/diagnoseTask.js} +8 -8
  186. package/dist/tools/{evidencePack.d.ts → tasks/evidencePack.d.ts} +6 -0
  187. package/dist/tools/tasks/evidencePack.js +387 -0
  188. package/dist/tools/{getTaskFile.js → tasks/getTaskFile.js} +4 -4
  189. package/dist/tools/{getTaskStatus.d.ts → tasks/getTaskStatus.d.ts} +6 -1
  190. package/dist/tools/{getTaskStatus.js → tasks/getTaskStatus.js} +5 -5
  191. package/dist/tools/{getTaskStdoutTail.js → tasks/getTaskStdoutTail.js} +13 -11
  192. package/dist/tools/{getTaskSummary.js → tasks/getTaskSummary.js} +33 -26
  193. package/dist/tools/tasks/index.d.ts +18 -0
  194. package/dist/tools/tasks/index.js +18 -0
  195. package/dist/tools/tasks/killTask.d.ts +1 -0
  196. package/dist/tools/{listTasks.d.ts → tasks/listTasks.d.ts} +1 -1
  197. package/dist/tools/{listTasks.js → tasks/listTasks.js} +3 -3
  198. package/dist/tools/{reconcileTasks.d.ts → tasks/reconcileTasks.d.ts} +1 -1
  199. package/dist/tools/{reconcileTasks.js → tasks/reconcileTasks.js} +64 -66
  200. package/dist/tools/{retryTask.d.ts → tasks/retryTask.d.ts} +2 -2
  201. package/dist/tools/tasks/retryTask.js +60 -0
  202. package/dist/tools/{runTaskLoop.d.ts → tasks/runTaskLoop.d.ts} +6 -6
  203. package/dist/tools/{runTaskLoop.js → tasks/runTaskLoop.js} +59 -31
  204. package/dist/tools/tasks/runVerification.js +38 -0
  205. package/dist/tools/{taskLineage.js → tasks/taskLineage.js} +8 -7
  206. package/dist/tools/{taskOutputs.js → tasks/taskOutputs.js} +17 -16
  207. package/dist/tools/{androidDoctor.js → workspace/androidDoctor.js} +16 -10
  208. package/dist/tools/{applyPatch.d.ts → workspace/applyPatch.d.ts} +1 -1
  209. package/dist/tools/workspace/applyPatch.js +53 -0
  210. package/dist/tools/{discardWorktree.js → workspace/discardWorktree.js} +3 -3
  211. package/dist/tools/workspace/index.d.ts +10 -0
  212. package/dist/tools/workspace/index.js +10 -0
  213. package/dist/tools/{listAgents.d.ts → workspace/listAgents.d.ts} +5 -0
  214. package/dist/tools/{listAgents.js → workspace/listAgents.js} +8 -4
  215. package/dist/tools/{listWorkspace.js → workspace/listWorkspace.js} +3 -3
  216. package/dist/tools/{mergeWorktree.js → workspace/mergeWorktree.js} +3 -3
  217. package/dist/tools/{readWorkspaceFile.js → workspace/readWorkspaceFile.js} +8 -8
  218. package/dist/tools/{recommendAgentForTask.js → workspace/recommendAgentForTask.js} +3 -3
  219. package/dist/tools/{searchWorkspace.js → workspace/searchWorkspace.js} +5 -5
  220. package/dist/tools/{syncFile.d.ts → workspace/syncFile.d.ts} +1 -1
  221. package/dist/tools/workspace/syncFile.js +134 -0
  222. package/dist/utils/atomicFile.d.ts +7 -0
  223. package/dist/utils/atomicFile.js +48 -0
  224. package/dist/utils/boundedFile.d.ts +8 -0
  225. package/dist/utils/boundedFile.js +93 -0
  226. package/dist/utils/lockedJsonFile.d.ts +15 -0
  227. package/dist/utils/lockedJsonFile.js +224 -0
  228. package/dist/utils/platform.d.ts +11 -0
  229. package/dist/utils/platform.js +26 -0
  230. package/dist/utils/stableJson.d.ts +2 -0
  231. package/dist/utils/stableJson.js +12 -0
  232. package/dist/version.d.ts +3 -2
  233. package/dist/version.js +3 -2
  234. package/dist/watcherStatus.d.ts +2 -2
  235. package/dist/watcherStatus.js +18 -0
  236. package/docs/CODE_WIKI.md +1648 -0
  237. package/docs/agentseal-integration.md +150 -0
  238. package/docs/architecture.md +23 -0
  239. package/docs/assets/patchwarden-desktop-onboarding.png +0 -0
  240. package/docs/assets/patchwarden-oss-demo.gif +0 -0
  241. package/docs/control-center/README.md +4 -4
  242. package/docs/dashboard-overview.md +86 -0
  243. package/docs/demo.md +8 -0
  244. package/docs/desktop-app.md +175 -0
  245. package/docs/direct-session-workflow.md +98 -0
  246. package/docs/evidence-pack-schema.md +215 -0
  247. package/docs/lineage-evidence-pack-workflow.md +127 -0
  248. package/docs/mcp-inspector-testing.md +200 -0
  249. package/docs/open-source-application.md +168 -0
  250. package/docs/opencode-worker.md +151 -0
  251. package/docs/openhands-worker.md +181 -0
  252. package/docs/release-checklist.md +1 -1
  253. package/docs/release-evidence.md +82 -0
  254. package/docs/spec-kit-integration.md +131 -0
  255. package/docs/task-safe-review-workflow.md +98 -0
  256. package/docs/threat-model.md +97 -0
  257. package/docs/user-feedback.md +40 -0
  258. package/docs/why-patchwarden.md +110 -0
  259. package/examples/config.example.json +4 -2
  260. package/package.json +28 -11
  261. package/scripts/README.md +15 -6
  262. package/scripts/build.js +11 -0
  263. package/scripts/checks/brand-check.js +3 -0
  264. package/scripts/checks/build-output-check.js +37 -0
  265. package/scripts/checks/control-center-smoke.js +447 -6
  266. package/scripts/checks/control-smoke.js +19 -8
  267. package/scripts/checks/http-mcp-smoke.js +82 -4
  268. package/scripts/checks/lifecycle-smoke.js +39 -33
  269. package/scripts/checks/mcp-manifest-check.js +1 -1
  270. package/scripts/checks/mcp-smoke.js +30 -4
  271. package/scripts/checks/package-manifest-check.js +20 -7
  272. package/scripts/checks/unit-tests.js +3 -5
  273. package/scripts/checks/watcher-supervisor-smoke.js +9 -0
  274. package/scripts/control/get-patchwarden-health.ps1 +1 -1
  275. package/scripts/control/manage-patchwarden.ps1 +69 -4
  276. package/scripts/control/provision-patchwarden-tunnel.ps1 +127 -0
  277. package/scripts/control/run-background-supervisor.ps1 +41 -0
  278. package/scripts/control/start-patchwarden-tunnel.ps1 +126 -32
  279. package/scripts/generate-demo-gif.py +320 -0
  280. package/{PatchWarden-Control-Tray.cmd → scripts/launchers/PatchWarden-Control-Tray.cmd} +3 -3
  281. package/scripts/launchers/PatchWarden-Control.cmd +6 -0
  282. package/{PatchWarden-Desktop.cmd → scripts/launchers/PatchWarden-Desktop.cmd} +2 -2
  283. package/scripts/launchers/Restart-PatchWarden-Control.cmd +6 -0
  284. package/{Stop-PatchWarden.cmd → scripts/launchers/Stop-PatchWarden.cmd} +2 -2
  285. package/scripts/lib/clean-generated-output.js +11 -0
  286. package/scripts/lib/file-discovery.js +12 -0
  287. package/scripts/release/desktop-preflight.js +211 -0
  288. package/scripts/release/pack-clean.js +59 -14
  289. package/src/assessments/agentAssessor.ts +29 -15
  290. package/src/assessments/assessmentStore.ts +55 -43
  291. package/src/assessments/confirmCli.ts +5 -4
  292. package/src/config.ts +105 -11
  293. package/src/control/fileManager.ts +40 -0
  294. package/src/control/middleware/auth.ts +35 -0
  295. package/src/control/middleware/static.ts +84 -0
  296. package/src/control/routeTable.ts +301 -0
  297. package/src/control/routes/audit.ts +329 -0
  298. package/src/control/routes/evidence.ts +107 -0
  299. package/src/control/routes/lineage.ts +92 -0
  300. package/src/control/routes/policy.ts +81 -0
  301. package/src/control/routes/process.ts +505 -0
  302. package/src/control/routes/sessions.ts +314 -0
  303. package/src/control/routes/status.ts +405 -0
  304. package/src/control/routes/taskActions.ts +214 -0
  305. package/src/control/routes/tasks.ts +331 -0
  306. package/src/control/routes/workspace.ts +234 -0
  307. package/src/control/runtime.ts +508 -0
  308. package/src/control/server.ts +165 -0
  309. package/src/control/shared.ts +360 -0
  310. package/src/controlCenter.ts +7 -2347
  311. package/src/direct/directAudit.ts +17 -9
  312. package/src/direct/directGuards.ts +100 -51
  313. package/src/direct/directPatch.ts +95 -8
  314. package/src/direct/directSessionStore.ts +211 -55
  315. package/src/direct/directVerification.ts +9 -23
  316. package/src/doctor.ts +766 -492
  317. package/src/goal/acceptanceEngine.ts +1 -1
  318. package/src/goal/goalProgress.ts +17 -13
  319. package/src/goal/goalReport.ts +263 -0
  320. package/src/goal/goalStatus.ts +25 -3
  321. package/src/goal/goalStore.ts +241 -54
  322. package/src/goal/handoffExport.ts +6 -6
  323. package/src/goal/specKitImport.ts +355 -0
  324. package/src/goal/subgoalSync.ts +15 -10
  325. package/src/goal/worktreeManager.ts +139 -22
  326. package/src/httpServer.ts +130 -44
  327. package/src/index.ts +7 -4
  328. package/src/logging.ts +20 -4
  329. package/src/policy/projectPolicy.ts +5 -2
  330. package/src/release/releaseGate.ts +74 -27
  331. package/src/runner/agentInvocation.ts +126 -4
  332. package/src/runner/changeCapture.ts +342 -80
  333. package/src/runner/cli.ts +7 -6
  334. package/src/runner/postTaskCleanup.ts +55 -7
  335. package/src/runner/processSecurity.ts +433 -0
  336. package/src/runner/runTask.ts +441 -292
  337. package/src/runner/simpleProcess.ts +68 -33
  338. package/src/{taskProgress.ts → runner/taskProgress.ts} +3 -3
  339. package/src/{taskRuntime.ts → runner/taskRuntime.ts} +4 -3
  340. package/src/runner/taskStatusStore.ts +54 -0
  341. package/src/runner/watch.ts +290 -57
  342. package/src/security/contentRedaction.ts +31 -2
  343. package/src/security/discoveryTokenStore.ts +18 -4
  344. package/src/security/loopbackHost.ts +19 -0
  345. package/src/security/pathGuard.ts +35 -16
  346. package/src/security/planGuard.ts +2 -1
  347. package/src/security/runtimeGuard.ts +9 -6
  348. package/src/security/secretComparison.ts +13 -0
  349. package/src/security/sensitiveGuard.ts +27 -8
  350. package/src/security/toolInvocationGuard.ts +2 -2
  351. package/src/security/workspaceRootGuard.ts +53 -0
  352. package/src/smoke-test.ts +276 -273
  353. package/src/tools/catalog/index.ts +4 -0
  354. package/src/tools/{toolCatalog.ts → catalog/toolCatalog.ts} +3 -12
  355. package/src/tools/{toolRegistry.ts → catalog/toolRegistry.ts} +29 -16
  356. package/src/tools/definitions/toolDefs.ts +1264 -0
  357. package/src/tools/{auditSession.ts → diagnostics/auditSession.ts} +2 -2
  358. package/src/tools/{auditTask.ts → diagnostics/auditTask.ts} +196 -89
  359. package/src/tools/{healthCheck.ts → diagnostics/healthCheck.ts} +11 -11
  360. package/src/tools/diagnostics/index.ts +6 -0
  361. package/src/tools/{safeStatus.ts → diagnostics/safeStatus.ts} +7 -7
  362. package/src/tools/{safeViews.ts → diagnostics/safeViews.ts} +29 -19
  363. package/src/tools/{schemaDriftCheck.ts → diagnostics/schemaDriftCheck.ts} +3 -3
  364. package/src/tools/{createDirectSession.ts → direct/createDirectSession.ts} +9 -9
  365. package/src/tools/{finalizeDirectSession.ts → direct/finalizeDirectSession.ts} +11 -9
  366. package/src/tools/direct/index.ts +3 -0
  367. package/src/tools/{runDirectVerificationBundle.ts → direct/runDirectVerificationBundle.ts} +2 -2
  368. package/src/tools/{discoverTools.ts → discovery/discoverTools.ts} +6 -6
  369. package/src/tools/{explainTool.ts → discovery/explainTool.ts} +3 -3
  370. package/src/tools/discovery/index.ts +3 -0
  371. package/src/tools/{invokeDiscoveredTool.ts → discovery/invokeDiscoveredTool.ts} +7 -7
  372. package/src/tools/dispatch/coreDispatch.ts +379 -0
  373. package/src/tools/dispatch/diagnosticDispatch.ts +106 -0
  374. package/src/tools/dispatch/directDispatch.ts +168 -0
  375. package/src/tools/dispatch/goalDispatch.ts +128 -0
  376. package/src/tools/dispatch/releaseDispatch.ts +66 -0
  377. package/src/tools/dispatch/types.ts +24 -0
  378. package/src/tools/dispatch/validation.ts +78 -0
  379. package/src/tools/{getPlan.ts → goals/getPlan.ts} +4 -4
  380. package/src/tools/{goalSubgoalTask.ts → goals/goalSubgoalTask.ts} +43 -28
  381. package/src/tools/goals/index.ts +3 -0
  382. package/src/tools/{savePlan.ts → goals/savePlan.ts} +38 -8
  383. package/src/tools/registry.ts +54 -1858
  384. package/src/tools/{checkReleaseGate.ts → release/checkReleaseGate.ts} +3 -3
  385. package/src/tools/release/index.ts +2 -0
  386. package/src/tools/{releaseMode.ts → release/releaseMode.ts} +42 -24
  387. package/src/tools/tasks/cancelTask.ts +109 -0
  388. package/src/tools/{createTask.ts → tasks/createTask.ts} +56 -33
  389. package/src/tools/{diagnoseTask.ts → tasks/diagnoseTask.ts} +8 -8
  390. package/src/tools/tasks/evidencePack.ts +504 -0
  391. package/src/tools/{getTaskFile.ts → tasks/getTaskFile.ts} +4 -4
  392. package/src/tools/{getTaskStatus.ts → tasks/getTaskStatus.ts} +7 -5
  393. package/src/tools/{getTaskStdoutTail.ts → tasks/getTaskStdoutTail.ts} +13 -11
  394. package/src/tools/{getTaskSummary.ts → tasks/getTaskSummary.ts} +44 -33
  395. package/src/tools/tasks/index.ts +18 -0
  396. package/src/tools/{listTasks.ts → tasks/listTasks.ts} +4 -4
  397. package/src/tools/{reconcileTasks.ts → tasks/reconcileTasks.ts} +68 -66
  398. package/src/tools/tasks/retryTask.ts +69 -0
  399. package/src/tools/{runTaskLoop.ts → tasks/runTaskLoop.ts} +70 -35
  400. package/src/tools/{runVerification.ts → tasks/runVerification.ts} +6 -3
  401. package/src/tools/{taskLineage.ts → tasks/taskLineage.ts} +8 -7
  402. package/src/tools/{taskOutputs.ts → tasks/taskOutputs.ts} +27 -20
  403. package/src/tools/{androidDoctor.ts → workspace/androidDoctor.ts} +15 -10
  404. package/src/tools/{applyPatch.ts → workspace/applyPatch.ts} +38 -16
  405. package/src/tools/{discardWorktree.ts → workspace/discardWorktree.ts} +3 -3
  406. package/src/tools/workspace/index.ts +10 -0
  407. package/src/tools/{listAgents.ts → workspace/listAgents.ts} +11 -4
  408. package/src/tools/{listWorkspace.ts → workspace/listWorkspace.ts} +3 -3
  409. package/src/tools/{mergeWorktree.ts → workspace/mergeWorktree.ts} +3 -3
  410. package/src/tools/{readWorkspaceFile.ts → workspace/readWorkspaceFile.ts} +8 -8
  411. package/src/tools/{recommendAgentForTask.ts → workspace/recommendAgentForTask.ts} +3 -3
  412. package/src/tools/{searchWorkspace.ts → workspace/searchWorkspace.ts} +5 -5
  413. package/src/tools/workspace/syncFile.ts +292 -0
  414. package/src/utils/atomicFile.ts +58 -0
  415. package/src/utils/boundedFile.ts +116 -0
  416. package/src/utils/lockedJsonFile.ts +251 -0
  417. package/src/utils/platform.ts +31 -0
  418. package/src/utils/stableJson.ts +12 -0
  419. package/src/version.ts +3 -2
  420. package/src/watcherStatus.ts +19 -1
  421. package/ui/desktop-bootstrap.js +11 -0
  422. package/ui/desktop-bridge.js +36 -0
  423. package/ui/desktop.css +160 -0
  424. package/ui/getting-started.js +93 -0
  425. package/ui/i18n.js +484 -0
  426. package/ui/log-parser.js +30 -0
  427. package/ui/pages/audit.html +204 -3
  428. package/ui/pages/dashboard.html +937 -79
  429. package/ui/pages/direct-sessions.html +609 -60
  430. package/ui/pages/getting-started.html +43 -0
  431. package/ui/pages/logs.html +105 -22
  432. package/ui/pages/settings.html +101 -0
  433. package/ui/pages/task-detail.html +468 -438
  434. package/ui/pages/tasks.html +648 -65
  435. package/ui/pages/workspace.html +38 -1
  436. package/ui/settings.js +245 -0
  437. package/PatchWarden-Control.cmd +0 -6
  438. package/Restart-PatchWarden-Control.cmd +0 -6
  439. package/dist/test/unit/acceptance-engine.test.d.ts +0 -1
  440. package/dist/test/unit/acceptance-engine.test.js +0 -228
  441. package/dist/test/unit/agent-router.test.d.ts +0 -1
  442. package/dist/test/unit/agent-router.test.js +0 -287
  443. package/dist/test/unit/android-doctor.test.d.ts +0 -1
  444. package/dist/test/unit/android-doctor.test.js +0 -118
  445. package/dist/test/unit/audit-checks.test.d.ts +0 -1
  446. package/dist/test/unit/audit-checks.test.js +0 -350
  447. package/dist/test/unit/chinese-path.test.d.ts +0 -1
  448. package/dist/test/unit/chinese-path.test.js +0 -91
  449. package/dist/test/unit/command-guard.test.d.ts +0 -1
  450. package/dist/test/unit/command-guard.test.js +0 -160
  451. package/dist/test/unit/diagnose-task.test.d.ts +0 -1
  452. package/dist/test/unit/diagnose-task.test.js +0 -457
  453. package/dist/test/unit/direct-guards.test.d.ts +0 -1
  454. package/dist/test/unit/direct-guards.test.js +0 -213
  455. package/dist/test/unit/discovery-token-store.test.d.ts +0 -1
  456. package/dist/test/unit/discovery-token-store.test.js +0 -139
  457. package/dist/test/unit/evidence-pack.test.d.ts +0 -1
  458. package/dist/test/unit/evidence-pack.test.js +0 -130
  459. package/dist/test/unit/goal-graph.test.d.ts +0 -1
  460. package/dist/test/unit/goal-graph.test.js +0 -298
  461. package/dist/test/unit/goal-progress.test.d.ts +0 -1
  462. package/dist/test/unit/goal-progress.test.js +0 -381
  463. package/dist/test/unit/goal-status.test.d.ts +0 -1
  464. package/dist/test/unit/goal-status.test.js +0 -215
  465. package/dist/test/unit/goal-store.test.d.ts +0 -1
  466. package/dist/test/unit/goal-store.test.js +0 -253
  467. package/dist/test/unit/goal-subgoal-task.test.d.ts +0 -1
  468. package/dist/test/unit/goal-subgoal-task.test.js +0 -55
  469. package/dist/test/unit/goal-tools-registry.test.d.ts +0 -1
  470. package/dist/test/unit/goal-tools-registry.test.js +0 -190
  471. package/dist/test/unit/handoff-export.test.d.ts +0 -1
  472. package/dist/test/unit/handoff-export.test.js +0 -263
  473. package/dist/test/unit/invoke-discovered-tool.test.d.ts +0 -1
  474. package/dist/test/unit/invoke-discovered-tool.test.js +0 -167
  475. package/dist/test/unit/logging.test.d.ts +0 -1
  476. package/dist/test/unit/logging.test.js +0 -397
  477. package/dist/test/unit/path-guard.test.d.ts +0 -1
  478. package/dist/test/unit/path-guard.test.js +0 -109
  479. package/dist/test/unit/post-task-cleanup.test.d.ts +0 -1
  480. package/dist/test/unit/post-task-cleanup.test.js +0 -48
  481. package/dist/test/unit/project-policy-release-mode.test.d.ts +0 -1
  482. package/dist/test/unit/project-policy-release-mode.test.js +0 -125
  483. package/dist/test/unit/reconcile-tasks.test.d.ts +0 -1
  484. package/dist/test/unit/reconcile-tasks.test.js +0 -456
  485. package/dist/test/unit/release-gate.test.d.ts +0 -1
  486. package/dist/test/unit/release-gate.test.js +0 -242
  487. package/dist/test/unit/run-task-loop.test.d.ts +0 -1
  488. package/dist/test/unit/run-task-loop.test.js +0 -380
  489. package/dist/test/unit/safe-status.test.d.ts +0 -1
  490. package/dist/test/unit/safe-status.test.js +0 -165
  491. package/dist/test/unit/safe-views.test.d.ts +0 -1
  492. package/dist/test/unit/safe-views.test.js +0 -171
  493. package/dist/test/unit/schema-drift-check.test.d.ts +0 -1
  494. package/dist/test/unit/schema-drift-check.test.js +0 -176
  495. package/dist/test/unit/sensitive-guard.test.d.ts +0 -1
  496. package/dist/test/unit/sensitive-guard.test.js +0 -104
  497. package/dist/test/unit/subgoal-sync.test.d.ts +0 -1
  498. package/dist/test/unit/subgoal-sync.test.js +0 -183
  499. package/dist/test/unit/sync-file.test.d.ts +0 -1
  500. package/dist/test/unit/sync-file.test.js +0 -154
  501. package/dist/test/unit/tool-invocation-guard.test.d.ts +0 -1
  502. package/dist/test/unit/tool-invocation-guard.test.js +0 -432
  503. package/dist/test/unit/tool-usage-stats.test.d.ts +0 -1
  504. package/dist/test/unit/tool-usage-stats.test.js +0 -300
  505. package/dist/test/unit/toolSearch.test.d.ts +0 -1
  506. package/dist/test/unit/toolSearch.test.js +0 -571
  507. package/dist/test/unit/watcher-status.test.d.ts +0 -1
  508. package/dist/test/unit/watcher-status.test.js +0 -169
  509. package/dist/test/unit/worktree-manager.test.d.ts +0 -1
  510. package/dist/test/unit/worktree-manager.test.js +0 -176
  511. package/dist/tools/applyPatch.js +0 -41
  512. package/dist/tools/cancelTask.d.ts +0 -30
  513. package/dist/tools/cancelTask.js +0 -64
  514. package/dist/tools/evidencePack.js +0 -168
  515. package/dist/tools/finalizeDirectSession.js +0 -84
  516. package/dist/tools/goalSubgoalTask.js +0 -110
  517. package/dist/tools/killTask.d.ts +0 -15
  518. package/dist/tools/retryTask.js +0 -45
  519. package/dist/tools/runVerification.js +0 -36
  520. package/dist/tools/syncFile.js +0 -65
  521. package/docs/control-center/control-center-daily-driver.md +0 -211
  522. package/docs/control-center/control-center-mvp.md +0 -205
  523. package/docs/control-center/control-center-phase2.md +0 -159
  524. package/docs/release-v0.6.0.md +0 -71
  525. package/docs/release-v0.6.1.md +0 -75
  526. package/docs/release-v0.6.4.md +0 -45
  527. package/src/test/unit/acceptance-engine.test.ts +0 -261
  528. package/src/test/unit/agent-router.test.ts +0 -342
  529. package/src/test/unit/android-doctor.test.ts +0 -158
  530. package/src/test/unit/audit-checks.test.ts +0 -567
  531. package/src/test/unit/chinese-path.test.ts +0 -106
  532. package/src/test/unit/command-guard.test.ts +0 -221
  533. package/src/test/unit/diagnose-task.test.ts +0 -544
  534. package/src/test/unit/direct-guards.test.ts +0 -297
  535. package/src/test/unit/discovery-token-store.test.ts +0 -181
  536. package/src/test/unit/evidence-pack.test.ts +0 -142
  537. package/src/test/unit/goal-graph.test.ts +0 -347
  538. package/src/test/unit/goal-progress.test.ts +0 -538
  539. package/src/test/unit/goal-status.test.ts +0 -270
  540. package/src/test/unit/goal-store.test.ts +0 -318
  541. package/src/test/unit/goal-subgoal-task.test.ts +0 -72
  542. package/src/test/unit/goal-tools-registry.test.ts +0 -243
  543. package/src/test/unit/handoff-export.test.ts +0 -295
  544. package/src/test/unit/invoke-discovered-tool.test.ts +0 -216
  545. package/src/test/unit/logging.test.ts +0 -497
  546. package/src/test/unit/path-guard.test.ts +0 -150
  547. package/src/test/unit/post-task-cleanup.test.ts +0 -53
  548. package/src/test/unit/project-policy-release-mode.test.ts +0 -156
  549. package/src/test/unit/reconcile-tasks.test.ts +0 -551
  550. package/src/test/unit/release-gate.test.ts +0 -314
  551. package/src/test/unit/run-task-loop.test.ts +0 -425
  552. package/src/test/unit/safe-status.test.ts +0 -187
  553. package/src/test/unit/safe-views.test.ts +0 -184
  554. package/src/test/unit/schema-drift-check.test.ts +0 -260
  555. package/src/test/unit/sensitive-guard.test.ts +0 -124
  556. package/src/test/unit/subgoal-sync.test.ts +0 -236
  557. package/src/test/unit/sync-file.test.ts +0 -231
  558. package/src/test/unit/tool-invocation-guard.test.ts +0 -542
  559. package/src/test/unit/tool-usage-stats.test.ts +0 -384
  560. package/src/test/unit/toolSearch.test.ts +0 -756
  561. package/src/test/unit/watcher-status.test.ts +0 -190
  562. package/src/test/unit/worktree-manager.test.ts +0 -247
  563. package/src/tools/cancelTask.ts +0 -70
  564. package/src/tools/evidencePack.ts +0 -205
  565. package/src/tools/retryTask.ts +0 -53
  566. package/src/tools/syncFile.ts +0 -122
  567. /package/dist/tools/{toolCatalog.d.ts → catalog/toolCatalog.d.ts} +0 -0
  568. /package/dist/tools/{toolSearch.d.ts → catalog/toolSearch.d.ts} +0 -0
  569. /package/dist/tools/{toolSearch.js → catalog/toolSearch.js} +0 -0
  570. /package/dist/tools/{toolUsageStats.d.ts → catalog/toolUsageStats.d.ts} +0 -0
  571. /package/dist/tools/{toolUsageStats.js → catalog/toolUsageStats.js} +0 -0
  572. /package/dist/tools/{runDirectVerificationBundle.d.ts → direct/runDirectVerificationBundle.d.ts} +0 -0
  573. /package/dist/tools/{getPlan.d.ts → goals/getPlan.d.ts} +0 -0
  574. /package/dist/tools/{savePlan.d.ts → goals/savePlan.d.ts} +0 -0
  575. /package/dist/tools/{getTaskFile.d.ts → tasks/getTaskFile.d.ts} +0 -0
  576. /package/dist/tools/{getTaskProgress.d.ts → tasks/getTaskProgress.d.ts} +0 -0
  577. /package/dist/tools/{getTaskProgress.js → tasks/getTaskProgress.js} +0 -0
  578. /package/dist/tools/{getTaskStdoutTail.d.ts → tasks/getTaskStdoutTail.d.ts} +0 -0
  579. /package/dist/tools/{getTaskSummary.d.ts → tasks/getTaskSummary.d.ts} +0 -0
  580. /package/dist/tools/{killTask.js → tasks/killTask.js} +0 -0
  581. /package/dist/tools/{runVerification.d.ts → tasks/runVerification.d.ts} +0 -0
  582. /package/dist/tools/{taskLineage.d.ts → tasks/taskLineage.d.ts} +0 -0
  583. /package/dist/tools/{taskOutputs.d.ts → tasks/taskOutputs.d.ts} +0 -0
  584. /package/dist/tools/{waitForTask.d.ts → tasks/waitForTask.d.ts} +0 -0
  585. /package/dist/tools/{waitForTask.js → tasks/waitForTask.js} +0 -0
  586. /package/dist/tools/{androidDoctor.d.ts → workspace/androidDoctor.d.ts} +0 -0
  587. /package/dist/tools/{discardWorktree.d.ts → workspace/discardWorktree.d.ts} +0 -0
  588. /package/dist/tools/{listWorkspace.d.ts → workspace/listWorkspace.d.ts} +0 -0
  589. /package/dist/tools/{mergeWorktree.d.ts → workspace/mergeWorktree.d.ts} +0 -0
  590. /package/dist/tools/{readWorkspaceFile.d.ts → workspace/readWorkspaceFile.d.ts} +0 -0
  591. /package/dist/tools/{recommendAgentForTask.d.ts → workspace/recommendAgentForTask.d.ts} +0 -0
  592. /package/dist/tools/{searchWorkspace.d.ts → workspace/searchWorkspace.d.ts} +0 -0
  593. /package/src/tools/{toolSearch.ts → catalog/toolSearch.ts} +0 -0
  594. /package/src/tools/{toolUsageStats.ts → catalog/toolUsageStats.ts} +0 -0
  595. /package/src/tools/{getTaskProgress.ts → tasks/getTaskProgress.ts} +0 -0
  596. /package/src/tools/{killTask.ts → tasks/killTask.ts} +0 -0
  597. /package/src/tools/{waitForTask.ts → tasks/waitForTask.ts} +0 -0
@@ -1,567 +0,0 @@
1
- import { describe, it, beforeEach, afterEach } from "node:test";
2
- import { strict as assert } from "node:assert";
3
- import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
4
- import { join } from "node:path";
5
- import { tmpdir } from "node:os";
6
- import type { ChangedFile } from "../../runner/changeCapture.js";
7
- import {
8
- checkForbiddenScope,
9
- checkDoneEvidenceMissing,
10
- checkReadmeChangelogSync,
11
- checkPackageManifestConsistency,
12
- checkSensitivePathAccess,
13
- checkUnrecordedCommandExecution,
14
- } from "../../tools/auditTask.js";
15
-
16
- // ── Helpers ───────────────────────────────────────────────────────
17
-
18
- function makeChangedFile(path: string, change: ChangedFile["change"] = "modified", oldPath?: string): ChangedFile {
19
- return {
20
- path,
21
- change,
22
- old_path: oldPath,
23
- before_sha256: null,
24
- after_sha256: null,
25
- tracked: true,
26
- ignored: false,
27
- kind: "source",
28
- };
29
- }
30
-
31
- describe("auditTask new checks", () => {
32
- let tempDir: string;
33
-
34
- beforeEach(() => {
35
- tempDir = mkdtempSync(join(tmpdir(), "pw-audit-checks-"));
36
- });
37
-
38
- afterEach(() => {
39
- rmSync(tempDir, { recursive: true, force: true });
40
- });
41
-
42
- // ── 1. checkForbiddenScope ──────────────────────────────────────
43
-
44
- describe("checkForbiddenScope", () => {
45
- it("returns null when forbidden is null (skip)", () => {
46
- const result = checkForbiddenScope([makeChangedFile("src/index.ts")], null);
47
- assert.equal(result, null);
48
- });
49
-
50
- it("returns null when forbidden is empty array (skip)", () => {
51
- const result = checkForbiddenScope([makeChangedFile("src/index.ts")], []);
52
- assert.equal(result, null);
53
- });
54
-
55
- it("returns pass when changedFiles is empty", () => {
56
- const result = checkForbiddenScope([], ["src/security/**"]);
57
- assert.notEqual(result, null);
58
- assert.equal(result!.result, "pass");
59
- assert.equal(result!.name, "forbidden_scope_violation");
60
- });
61
-
62
- it("returns pass when no changed file matches forbidden patterns", () => {
63
- const result = checkForbiddenScope(
64
- [makeChangedFile("src/tools/auditTask.ts")],
65
- ["src/security/**"],
66
- );
67
- assert.equal(result!.result, "pass");
68
- });
69
-
70
- it("returns fail when a changed file matches a ** glob (src/security/** matches src/security/pathGuard.ts)", () => {
71
- const result = checkForbiddenScope(
72
- [makeChangedFile("src/security/pathGuard.ts")],
73
- ["src/security/**"],
74
- );
75
- assert.equal(result!.result, "fail");
76
- assert.ok(result!.detail.includes("src/security/pathGuard.ts"));
77
- assert.ok(result!.detail.includes("forbidden paths"));
78
- });
79
-
80
- it("returns fail for src/tools/* matching src/tools/auditTask.ts (single segment)", () => {
81
- const result = checkForbiddenScope(
82
- [makeChangedFile("src/tools/auditTask.ts")],
83
- ["src/tools/*"],
84
- );
85
- assert.equal(result!.result, "fail");
86
- });
87
-
88
- it("returns fail for src/tools/** matching src/tools/auditTask.ts", () => {
89
- const result = checkForbiddenScope(
90
- [makeChangedFile("src/tools/auditTask.ts")],
91
- ["src/tools/**"],
92
- );
93
- assert.equal(result!.result, "fail");
94
- });
95
-
96
- it("single * does NOT match nested path (src/tools/* does not match src/tools/sub/file.ts)", () => {
97
- const result = checkForbiddenScope(
98
- [makeChangedFile("src/tools/sub/file.ts")],
99
- ["src/tools/*"],
100
- );
101
- assert.equal(result!.result, "pass");
102
- });
103
-
104
- it("checks old_path for renamed files", () => {
105
- const result = checkForbiddenScope(
106
- [makeChangedFile("src/new-path.ts", "renamed", "src/secret/old.ts")],
107
- ["src/secret/**"],
108
- );
109
- assert.equal(result!.result, "fail");
110
- assert.ok(result!.detail.includes("src/secret/old.ts"));
111
- });
112
-
113
- it("handles backslash path separators", () => {
114
- const result = checkForbiddenScope(
115
- [makeChangedFile("src\\security\\pathGuard.ts")],
116
- ["src/security/**"],
117
- );
118
- assert.equal(result!.result, "fail");
119
- });
120
-
121
- it("deduplicates hit paths in detail", () => {
122
- const result = checkForbiddenScope(
123
- [makeChangedFile("src/secret/a.ts"), makeChangedFile("src/secret/a.ts")],
124
- ["src/secret/**"],
125
- );
126
- const occurrences = result!.detail.split("src/secret/a.ts").length - 1;
127
- assert.equal(occurrences, 1, "path should appear only once");
128
- });
129
- });
130
-
131
- // ── 2. checkDoneEvidenceMissing ─────────────────────────────────
132
-
133
- describe("checkDoneEvidenceMissing", () => {
134
- it("returns null when doneEvidence is null (skip)", () => {
135
- const result = checkDoneEvidenceMissing(tempDir, null);
136
- assert.equal(result, null);
137
- });
138
-
139
- it("returns null when doneEvidence is empty (skip)", () => {
140
- const result = checkDoneEvidenceMissing(tempDir, []);
141
- assert.equal(result, null);
142
- });
143
-
144
- it("returns pass when all evidence files exist", () => {
145
- writeFileSync(join(tempDir, "result.md"), "# Result", "utf-8");
146
- writeFileSync(join(tempDir, "test.log"), "ok", "utf-8");
147
- const result = checkDoneEvidenceMissing(tempDir, ["result.md", "test.log"]);
148
- assert.equal(result!.result, "pass");
149
- assert.equal(result!.name, "done_evidence_missing");
150
- assert.ok(result!.detail.includes("present"));
151
- });
152
-
153
- it("returns warn when some evidence files are missing", () => {
154
- writeFileSync(join(tempDir, "result.md"), "# Result", "utf-8");
155
- const result = checkDoneEvidenceMissing(tempDir, ["result.md", "test.log", "git.diff"]);
156
- assert.equal(result!.result, "warn");
157
- assert.ok(result!.detail.includes("test.log"));
158
- assert.ok(result!.detail.includes("git.diff"));
159
- assert.ok(!result!.detail.includes("result.md"));
160
- });
161
-
162
- it("returns warn when all evidence files are missing", () => {
163
- const result = checkDoneEvidenceMissing(tempDir, ["result.md", "test.log"]);
164
- assert.equal(result!.result, "warn");
165
- assert.ok(result!.detail.includes("result.md"));
166
- assert.ok(result!.detail.includes("test.log"));
167
- });
168
- });
169
-
170
- // ── 3. checkReadmeChangelogSync ─────────────────────────────────
171
-
172
- describe("checkReadmeChangelogSync", () => {
173
- it("returns null when no code files changed (skip)", () => {
174
- const result = checkReadmeChangelogSync([
175
- makeChangedFile("README.md"),
176
- makeChangedFile("docs/guide.md"),
177
- ]);
178
- assert.equal(result, null);
179
- });
180
-
181
- it("returns null when changedFiles is empty (skip)", () => {
182
- const result = checkReadmeChangelogSync([]);
183
- assert.equal(result, null);
184
- });
185
-
186
- it("returns warn when code changed but no README/CHANGELOG updated", () => {
187
- const result = checkReadmeChangelogSync([
188
- makeChangedFile("src/index.ts"),
189
- makeChangedFile("src/tools/auditTask.ts"),
190
- ]);
191
- assert.equal(result!.result, "warn");
192
- assert.equal(result!.name, "readme_changelog_sync");
193
- assert.ok(result!.detail.includes("not updated"));
194
- });
195
-
196
- it("returns pass when README.md is also changed", () => {
197
- const result = checkReadmeChangelogSync([
198
- makeChangedFile("src/index.ts"),
199
- makeChangedFile("README.md"),
200
- ]);
201
- assert.equal(result!.result, "pass");
202
- });
203
-
204
- it("returns pass when CHANGELOG.md is also changed", () => {
205
- const result = checkReadmeChangelogSync([
206
- makeChangedFile("src/index.ts"),
207
- makeChangedFile("CHANGELOG.md"),
208
- ]);
209
- assert.equal(result!.result, "pass");
210
- });
211
-
212
- it("is case-insensitive for README.md basename", () => {
213
- const result = checkReadmeChangelogSync([
214
- makeChangedFile("src/index.ts"),
215
- makeChangedFile("docs/Readme.md"),
216
- ]);
217
- assert.equal(result!.result, "pass");
218
- });
219
-
220
- it("detects code files by various extensions", () => {
221
- const extensions = [".ts", ".js", ".py", ".go", ".rs", ".java"];
222
- for (const ext of extensions) {
223
- const result = checkReadmeChangelogSync([makeChangedFile(`src/file${ext}`)]);
224
- assert.equal(result!.result, "warn", `extension ${ext} should be detected as code`);
225
- }
226
- });
227
-
228
- it("does not treat .md as code", () => {
229
- const result = checkReadmeChangelogSync([makeChangedFile("docs/guide.md")]);
230
- assert.equal(result, null);
231
- });
232
- });
233
-
234
- // ── 4. checkPackageManifestConsistency ──────────────────────────
235
-
236
- describe("checkPackageManifestConsistency", () => {
237
- it("returns null when package.json is not in changed files (skip)", () => {
238
- const result = checkPackageManifestConsistency(
239
- [makeChangedFile("src/index.ts")],
240
- tempDir,
241
- );
242
- assert.equal(result, null);
243
- });
244
-
245
- it("returns pass when package.json has valid name and version", () => {
246
- writeFileSync(
247
- join(tempDir, "package.json"),
248
- JSON.stringify({ name: "patchwarden", version: "0.7.2" }),
249
- "utf-8",
250
- );
251
- const result = checkPackageManifestConsistency(
252
- [makeChangedFile("package.json")],
253
- tempDir,
254
- );
255
- assert.equal(result!.result, "pass");
256
- assert.equal(result!.name, "package_manifest_consistency");
257
- });
258
-
259
- it("returns warn when package.json is missing version field", () => {
260
- writeFileSync(
261
- join(tempDir, "package.json"),
262
- JSON.stringify({ name: "patchwarden" }),
263
- "utf-8",
264
- );
265
- const result = checkPackageManifestConsistency(
266
- [makeChangedFile("package.json")],
267
- tempDir,
268
- );
269
- assert.equal(result!.result, "warn");
270
- });
271
-
272
- it("returns warn when package.json is missing name field", () => {
273
- writeFileSync(
274
- join(tempDir, "package.json"),
275
- JSON.stringify({ version: "0.7.2" }),
276
- "utf-8",
277
- );
278
- const result = checkPackageManifestConsistency(
279
- [makeChangedFile("package.json")],
280
- tempDir,
281
- );
282
- assert.equal(result!.result, "warn");
283
- });
284
-
285
- it("returns warn when package.json is invalid JSON", () => {
286
- writeFileSync(join(tempDir, "package.json"), "{ not valid json", "utf-8");
287
- const result = checkPackageManifestConsistency(
288
- [makeChangedFile("package.json")],
289
- tempDir,
290
- );
291
- assert.equal(result!.result, "warn");
292
- });
293
-
294
- it("returns warn when package.json does not exist on disk", () => {
295
- const result = checkPackageManifestConsistency(
296
- [makeChangedFile("package.json")],
297
- tempDir,
298
- );
299
- assert.equal(result!.result, "warn");
300
- });
301
-
302
- it("detects package.json case-insensitively by basename", () => {
303
- writeFileSync(
304
- join(tempDir, "package.json"),
305
- JSON.stringify({ name: "x", version: "1.0.0" }),
306
- "utf-8",
307
- );
308
- const result = checkPackageManifestConsistency(
309
- [makeChangedFile("subdir/Package.json")],
310
- tempDir,
311
- );
312
- assert.equal(result!.result, "pass");
313
- });
314
-
315
- it("returns warn when name/version are empty strings", () => {
316
- writeFileSync(
317
- join(tempDir, "package.json"),
318
- JSON.stringify({ name: "", version: "" }),
319
- "utf-8",
320
- );
321
- const result = checkPackageManifestConsistency(
322
- [makeChangedFile("package.json")],
323
- tempDir,
324
- );
325
- assert.equal(result!.result, "warn");
326
- });
327
- });
328
-
329
- // ── 5. checkSensitivePathAccess ─────────────────────────────────
330
-
331
- describe("checkSensitivePathAccess", () => {
332
- it("returns null when changedFiles is empty (skip)", () => {
333
- const result = checkSensitivePathAccess([]);
334
- assert.equal(result, null);
335
- });
336
-
337
- it("returns pass when no sensitive paths are accessed", () => {
338
- const result = checkSensitivePathAccess([
339
- makeChangedFile("src/index.ts"),
340
- makeChangedFile("README.md"),
341
- ]);
342
- assert.equal(result!.result, "pass");
343
- assert.equal(result!.name, "sensitive_path_access");
344
- assert.ok(result!.detail.includes("No sensitive"));
345
- });
346
-
347
- it("returns fail when .env is accessed", () => {
348
- const result = checkSensitivePathAccess([makeChangedFile(".env")]);
349
- assert.equal(result!.result, "fail");
350
- assert.ok(result!.detail.includes(".env"));
351
- });
352
-
353
- it("returns fail when id_rsa is accessed", () => {
354
- const result = checkSensitivePathAccess([makeChangedFile("id_rsa")]);
355
- assert.equal(result!.result, "fail");
356
- });
357
-
358
- it("returns fail when credentials.json is accessed", () => {
359
- const result = checkSensitivePathAccess([makeChangedFile("credentials.json")]);
360
- assert.equal(result!.result, "fail");
361
- });
362
-
363
- it("returns fail when a sensitive path is in a subdirectory", () => {
364
- const result = checkSensitivePathAccess([
365
- makeChangedFile("src/index.ts"),
366
- makeChangedFile("config/secrets.pem"),
367
- ]);
368
- assert.equal(result!.result, "fail");
369
- assert.ok(result!.detail.includes("config/secrets.pem"));
370
- });
371
-
372
- it("returns fail when old_path of a renamed file is sensitive", () => {
373
- const result = checkSensitivePathAccess([
374
- makeChangedFile("src/new-location.ts", "renamed", ".env"),
375
- ]);
376
- assert.equal(result!.result, "fail");
377
- assert.ok(result!.detail.includes(".env"));
378
- });
379
-
380
- it("returns pass for src/index.ts (non-sensitive)", () => {
381
- const result = checkSensitivePathAccess([makeChangedFile("src/index.ts")]);
382
- assert.equal(result!.result, "pass");
383
- });
384
-
385
- it("deduplicates hit paths in detail", () => {
386
- const result = checkSensitivePathAccess([
387
- makeChangedFile(".env"),
388
- makeChangedFile(".env"),
389
- ]);
390
- const occurrences = result!.detail.split(".env").length - 1;
391
- assert.equal(occurrences, 1, "path should appear only once");
392
- });
393
- });
394
-
395
- // ── 6. checkUnrecordedCommandExecution ──────────────────────────
396
-
397
- describe("checkUnrecordedCommandExecution", () => {
398
- it("returns null when both contents are null (skip)", () => {
399
- const result = checkUnrecordedCommandExecution(null, null, [], null);
400
- assert.equal(result, null);
401
- });
402
-
403
- it("returns null when both contents are empty strings (skip)", () => {
404
- const result = checkUnrecordedCommandExecution("", "", [], null);
405
- assert.equal(result, null);
406
- });
407
-
408
- it("returns pass when test log command is in whitelist (npm test)", () => {
409
- const result = checkUnrecordedCommandExecution(
410
- "Running npm test\nExit code: 0",
411
- null,
412
- [],
413
- "npm test",
414
- );
415
- assert.equal(result!.result, "pass");
416
- assert.equal(result!.name, "unrecorded_command_execution");
417
- assert.ok(result!.detail.includes("whitelist"));
418
- });
419
-
420
- it("returns warn when npm run build is not in whitelist", () => {
421
- const result = checkUnrecordedCommandExecution(
422
- "Running npm run build\nDone",
423
- null,
424
- [],
425
- null,
426
- );
427
- assert.equal(result!.result, "warn");
428
- assert.ok(result!.detail.includes("build"));
429
- });
430
-
431
- it("returns pass when npm run build IS in whitelist (via verify_commands)", () => {
432
- const result = checkUnrecordedCommandExecution(
433
- "Running npm run build\nDone",
434
- null,
435
- ["npm run build"],
436
- null,
437
- );
438
- assert.equal(result!.result, "pass");
439
- });
440
-
441
- it("returns pass when npm run build IS in whitelist (via test_command)", () => {
442
- const result = checkUnrecordedCommandExecution(
443
- "Running npm run build\nDone",
444
- null,
445
- [],
446
- "npm run build",
447
- );
448
- assert.equal(result!.result, "pass");
449
- });
450
-
451
- it("scans result.md content as well as test.log", () => {
452
- const result = checkUnrecordedCommandExecution(
453
- null,
454
- "I ran npm run deploy to publish",
455
- ["npm test"],
456
- "npm test",
457
- );
458
- assert.equal(result!.result, "warn");
459
- assert.ok(result!.detail.includes("deploy"));
460
- });
461
-
462
- it("handles npm.cmd variant", () => {
463
- const result = checkUnrecordedCommandExecution(
464
- "npm.cmd run build\nDone",
465
- null,
466
- [],
467
- null,
468
- );
469
- assert.equal(result!.result, "warn");
470
- assert.ok(result!.detail.includes("build"));
471
- });
472
-
473
- it("handles npx commands", () => {
474
- const result = checkUnrecordedCommandExecution(
475
- "npx eslint src/\nDone",
476
- null,
477
- [],
478
- null,
479
- );
480
- assert.equal(result!.result, "warn");
481
- assert.ok(result!.detail.includes("eslint"));
482
- });
483
-
484
- it("handles node commands", () => {
485
- const result = checkUnrecordedCommandExecution(
486
- "node ./scripts/check.js\nDone",
487
- null,
488
- [],
489
- null,
490
- );
491
- assert.equal(result!.result, "warn");
492
- assert.ok(result!.detail.includes("scripts/check.js"));
493
- });
494
-
495
- it("returns pass when whitelist contains all discovered commands", () => {
496
- const log = "npm run build && npm test && npx tsc";
497
- const result = checkUnrecordedCommandExecution(
498
- log,
499
- null,
500
- ["npm run build", "npx tsc"],
501
- "npm test",
502
- );
503
- assert.equal(result!.result, "pass");
504
- });
505
- it("recognizes commands reached transitively through npm scripts and local verifier files", () => {
506
- mkdirSync(join(tempDir, "scripts"), { recursive: true });
507
- writeFileSync(
508
- join(tempDir, "package.json"),
509
- JSON.stringify({
510
- scripts: {
511
- test: "node scripts/verify-all.js",
512
- build: "node scripts/build.js",
513
- check: "node scripts/check.js",
514
- },
515
- }),
516
- "utf-8",
517
- );
518
- writeFileSync(
519
- join(tempDir, "scripts", "verify-all.js"),
520
- "npm run build\nnpm run check\n",
521
- "utf-8",
522
- );
523
- const result = checkUnrecordedCommandExecution(
524
- "npm test\nnode scripts/verify-all.js\nnpm run build\nnpm run check\n",
525
- null,
526
- [],
527
- "npm test",
528
- tempDir,
529
- );
530
- assert.equal(result!.result, "pass");
531
- assert.ok(result!.detail.includes("transitive_verified_command"));
532
- });
533
-
534
- it("fails high-risk publication commands even when they look intentional", () => {
535
- const result = checkUnrecordedCommandExecution(
536
- "npm publish --access public\n",
537
- null,
538
- ["npm publish --access public"],
539
- null,
540
- tempDir,
541
- );
542
- assert.equal(result!.result, "fail");
543
- assert.ok(result!.detail.includes("High-risk"));
544
- });
545
-
546
- it("returns pass when there are no commands in the log", () => {
547
- const result = checkUnrecordedCommandExecution(
548
- "No commands here, just text.\nExit code: 0",
549
- null,
550
- [],
551
- null,
552
- );
553
- assert.equal(result!.result, "pass");
554
- });
555
-
556
- it("deduplicates unrecorded commands in detail", () => {
557
- const result = checkUnrecordedCommandExecution(
558
- "npm run build && npm run build && npm run build",
559
- null,
560
- [],
561
- null,
562
- );
563
- const occurrences = result!.detail.split("build").length - 1;
564
- assert.equal(occurrences, 1, "command should appear only once");
565
- });
566
- });
567
- });
@@ -1,106 +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, resolve } from "node:path";
5
- import { tmpdir } from "node:os";
6
-
7
- describe("Chinese path handling", () => {
8
- let tempDir: string;
9
-
10
- beforeEach(() => {
11
- tempDir = mkdtempSync(join(tmpdir(), "pw-chinese-"));
12
- });
13
-
14
- afterEach(() => {
15
- rmSync(tempDir, { recursive: true, force: true });
16
- });
17
-
18
- it("writes and reads status.json with Chinese repo_path", () => {
19
- const chinesePath = "念念小伴_release";
20
- const status = {
21
- task_id: "test-001",
22
- status: "pending",
23
- repo_path: chinesePath,
24
- resolved_repo_path: resolve(tempDir, chinesePath),
25
- };
26
- const statusFile = join(tempDir, "status.json");
27
- writeFileSync(statusFile, JSON.stringify(status, null, 2), "utf-8");
28
-
29
- const raw = readFileSync(statusFile, "utf-8");
30
- const parsed = JSON.parse(raw);
31
- assert.equal(parsed.repo_path, chinesePath);
32
- assert.equal(parsed.resolved_repo_path, resolve(tempDir, chinesePath));
33
- });
34
-
35
- it("preserves Chinese characters through JSON stringify/parse", () => {
36
- const testPaths = [
37
- "念念小伴_release",
38
- "测试项目",
39
- "项目目录/子目录",
40
- "日本語プロジェクト",
41
- "한국어_프로젝트",
42
- ];
43
- for (const path of testPaths) {
44
- const json = JSON.stringify({ repo_path: path });
45
- const parsed = JSON.parse(json);
46
- assert.equal(parsed.repo_path, path, `Path "${path}" was corrupted`);
47
- }
48
- });
49
-
50
- it("creates and reads directories with Chinese names", () => {
51
- const chineseDir = join(tempDir, "念念小伴_release");
52
- mkdirSync(chineseDir, { recursive: true });
53
- assert.ok(existsSync(chineseDir));
54
-
55
- const filePath = join(chineseDir, "status.json");
56
- const data = { repo_path: "念念小伴_release", status: "running" };
57
- writeFileSync(filePath, JSON.stringify(data, null, 2), "utf-8");
58
-
59
- const raw = readFileSync(filePath, "utf-8");
60
- const parsed = JSON.parse(raw);
61
- assert.equal(parsed.repo_path, "念念小伴_release");
62
- });
63
-
64
- it("handles Chinese characters in result.md", () => {
65
- const resultMd = [
66
- "# PatchWarden Task Result",
67
- "",
68
- "## Status",
69
- "done",
70
- "",
71
- "## Files changed",
72
- "- modified: 念念小伴_release/src/main.ts",
73
- "- added: 测试项目/config.json",
74
- "",
75
- ].join("\n");
76
- const resultFile = join(tempDir, "result.md");
77
- writeFileSync(resultFile, resultMd, "utf-8");
78
-
79
- const content = readFileSync(resultFile, "utf-8");
80
- assert.ok(content.includes("念念小伴_release"));
81
- assert.ok(content.includes("测试项目"));
82
- });
83
-
84
- it("handles mixed Chinese and ASCII paths", () => {
85
- const mixedPath = "src/组件/Button.tsx";
86
- const data = { path: mixedPath };
87
- const json = JSON.stringify(data);
88
- const parsed = JSON.parse(json);
89
- assert.equal(parsed.path, mixedPath);
90
- });
91
-
92
- it("handles Chinese characters in error messages", () => {
93
- const errorMsg = 'repo_path "念念小伴_release" is outside workspace';
94
- const errorFile = join(tempDir, "error.log");
95
- writeFileSync(errorFile, errorMsg, "utf-8");
96
-
97
- const content = readFileSync(errorFile, "utf-8");
98
- assert.ok(content.includes("念念小伴_release"));
99
- });
100
-
101
- it("handles Windows backslash paths with Chinese characters", () => {
102
- const winPath = "念念小伴_release\\src\\main.ts";
103
- const normalized = winPath.replace(/\\/g, "/");
104
- assert.equal(normalized, "念念小伴_release/src/main.ts");
105
- });
106
- });