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,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
- });