patchwarden 1.5.1 → 1.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/PatchWarden.cmd +32 -2
- package/README.en.md +158 -26
- package/README.md +124 -24
- package/dist/assessments/agentAssessor.js +21 -12
- package/dist/assessments/assessmentDiagnostics.d.ts +29 -0
- package/dist/assessments/assessmentDiagnostics.js +132 -0
- package/dist/assessments/assessmentStore.d.ts +39 -0
- package/dist/assessments/assessmentStore.js +207 -45
- package/dist/assessments/securitySnapshot.d.ts +50 -0
- package/dist/assessments/securitySnapshot.js +158 -0
- package/dist/config.d.ts +15 -0
- package/dist/config.js +66 -13
- package/dist/control/fileManager.d.ts +2 -0
- package/dist/control/fileManager.js +39 -0
- package/dist/control/middleware/auth.d.ts +6 -0
- package/dist/control/middleware/auth.js +14 -5
- package/dist/control/middleware/static.js +16 -3
- package/dist/control/routeTable.d.ts +24 -0
- package/dist/control/routeTable.js +263 -0
- package/dist/control/routes/audit.js +17 -7
- package/dist/control/routes/evidence.js +1 -1
- package/dist/control/routes/lineage.js +1 -1
- package/dist/control/routes/process.d.ts +7 -0
- package/dist/control/routes/process.js +329 -42
- package/dist/control/routes/sessions.d.ts +9 -1
- package/dist/control/routes/sessions.js +84 -21
- package/dist/control/routes/status.d.ts +60 -1
- package/dist/control/routes/status.js +94 -15
- package/dist/control/routes/taskActions.js +24 -60
- package/dist/control/routes/tasks.d.ts +4 -0
- package/dist/control/routes/tasks.js +61 -62
- package/dist/control/routes/workspace.js +50 -23
- package/dist/control/runtime.d.ts +3 -2
- package/dist/control/runtime.js +65 -40
- package/dist/control/server.js +37 -365
- package/dist/control/shared.d.ts +25 -1
- package/dist/control/shared.js +64 -11
- package/dist/diagnostics/allowedTestCommandSafety.d.ts +1 -0
- package/dist/diagnostics/allowedTestCommandSafety.js +11 -0
- package/dist/direct/directAudit.js +234 -225
- package/dist/direct/directGuards.d.ts +2 -1
- package/dist/direct/directGuards.js +42 -29
- package/dist/direct/directPatch.d.ts +6 -1
- package/dist/direct/directPatch.js +55 -8
- package/dist/direct/directSessionStore.d.ts +16 -6
- package/dist/direct/directSessionStore.js +128 -35
- package/dist/direct/directVerification.js +8 -16
- package/dist/doctor.js +65 -57
- package/dist/goal/acceptanceEngine.d.ts +1 -1
- package/dist/goal/goalProgress.js +75 -69
- package/dist/goal/goalReport.js +5 -12
- package/dist/goal/goalStatus.d.ts +2 -0
- package/dist/goal/goalStatus.js +10 -3
- package/dist/goal/goalStore.d.ts +9 -2
- package/dist/goal/goalStore.js +152 -45
- package/dist/goal/handoffExport.js +6 -6
- package/dist/goal/specKitImport.js +97 -96
- package/dist/goal/subgoalSync.js +11 -9
- package/dist/goal/worktreeManager.d.ts +2 -0
- package/dist/goal/worktreeManager.js +209 -136
- package/dist/httpServer.js +111 -32
- package/dist/logging.js +5 -3
- package/dist/policy/projectPolicy.js +5 -2
- package/dist/release/releaseGate.d.ts +1 -1
- package/dist/release/releaseGate.js +78 -25
- package/dist/runner/agentInvocation.d.ts +14 -0
- package/dist/runner/agentInvocation.js +96 -4
- package/dist/runner/changeCapture.d.ts +13 -5
- package/dist/runner/changeCapture.js +243 -61
- package/dist/runner/postTaskCleanup.js +48 -19
- package/dist/runner/processSecurity.d.ts +56 -0
- package/dist/runner/processSecurity.js +373 -0
- package/dist/runner/runTask.d.ts +2 -1
- package/dist/runner/runTask.js +162 -93
- package/dist/runner/simpleProcess.d.ts +3 -0
- package/dist/runner/simpleProcess.js +50 -36
- package/dist/{taskProgress.d.ts → runner/taskProgress.d.ts} +1 -1
- package/dist/{taskProgress.js → runner/taskProgress.js} +2 -2
- package/dist/{taskRuntime.d.ts → runner/taskRuntime.d.ts} +3 -1
- package/dist/{taskRuntime.js → runner/taskRuntime.js} +3 -2
- package/dist/runner/taskStatusStore.d.ts +11 -0
- package/dist/runner/taskStatusStore.js +35 -0
- package/dist/runner/watch.d.ts +14 -1
- package/dist/runner/watch.js +320 -49
- package/dist/security/contentRedaction.js +2 -2
- package/dist/security/discoveryTokenStore.d.ts +3 -2
- package/dist/security/discoveryTokenStore.js +17 -2
- package/dist/security/loopbackHost.d.ts +2 -0
- package/dist/security/loopbackHost.js +16 -0
- package/dist/security/pathGuard.js +32 -17
- package/dist/security/planGuard.js +2 -1
- package/dist/security/runtimeGuard.js +9 -6
- package/dist/security/secretComparison.d.ts +3 -0
- package/dist/security/secretComparison.js +11 -0
- package/dist/security/sensitiveGuard.d.ts +5 -0
- package/dist/security/sensitiveGuard.js +27 -8
- package/dist/security/toolInvocationGuard.d.ts +2 -2
- package/dist/security/toolInvocationGuard.js +1 -1
- package/dist/security/workspaceRootGuard.d.ts +8 -0
- package/dist/security/workspaceRootGuard.js +47 -0
- package/dist/smoke-test.js +27 -26
- package/dist/tools/catalog/index.d.ts +4 -0
- package/dist/tools/catalog/index.js +4 -0
- package/dist/tools/{toolCatalog.js → catalog/toolCatalog.js} +3 -12
- package/dist/tools/{toolRegistry.d.ts → catalog/toolRegistry.d.ts} +3 -3
- package/dist/tools/{toolRegistry.js → catalog/toolRegistry.js} +6 -15
- package/dist/tools/definitions/toolDefs.d.ts +18 -0
- package/dist/tools/definitions/toolDefs.js +1177 -0
- package/dist/tools/{auditSession.d.ts → diagnostics/auditSession.d.ts} +1 -1
- package/dist/tools/{auditSession.js → diagnostics/auditSession.js} +2 -2
- package/dist/tools/{auditTask.d.ts → diagnostics/auditTask.d.ts} +2 -1
- package/dist/tools/{auditTask.js → diagnostics/auditTask.js} +134 -36
- package/dist/tools/{healthCheck.d.ts → diagnostics/healthCheck.d.ts} +18 -6
- package/dist/tools/{healthCheck.js → diagnostics/healthCheck.js} +36 -8
- package/dist/tools/diagnostics/index.d.ts +6 -0
- package/dist/tools/diagnostics/index.js +6 -0
- package/dist/tools/{safeStatus.d.ts → diagnostics/safeStatus.d.ts} +3 -3
- package/dist/tools/{safeStatus.js → diagnostics/safeStatus.js} +6 -6
- package/dist/tools/{safeViews.d.ts → diagnostics/safeViews.d.ts} +12 -8
- package/dist/tools/{safeViews.js → diagnostics/safeViews.js} +23 -13
- package/dist/tools/{schemaDriftCheck.d.ts → diagnostics/schemaDriftCheck.d.ts} +1 -1
- package/dist/tools/{schemaDriftCheck.js → diagnostics/schemaDriftCheck.js} +2 -2
- package/dist/tools/{createDirectSession.js → direct/createDirectSession.js} +6 -6
- package/dist/tools/{finalizeDirectSession.d.ts → direct/finalizeDirectSession.d.ts} +1 -1
- package/dist/tools/direct/finalizeDirectSession.js +86 -0
- package/dist/tools/direct/index.d.ts +3 -0
- package/dist/tools/direct/index.js +3 -0
- package/dist/tools/{runDirectVerificationBundle.js → direct/runDirectVerificationBundle.js} +2 -2
- package/dist/tools/{discoverTools.d.ts → discovery/discoverTools.d.ts} +2 -2
- package/dist/tools/{discoverTools.js → discovery/discoverTools.js} +5 -5
- package/dist/tools/{explainTool.d.ts → discovery/explainTool.d.ts} +2 -2
- package/dist/tools/{explainTool.js → discovery/explainTool.js} +2 -2
- package/dist/tools/discovery/index.d.ts +3 -0
- package/dist/tools/discovery/index.js +3 -0
- package/dist/tools/{invokeDiscoveredTool.d.ts → discovery/invokeDiscoveredTool.d.ts} +2 -2
- package/dist/tools/{invokeDiscoveredTool.js → discovery/invokeDiscoveredTool.js} +5 -5
- package/dist/tools/dispatch/coreDispatch.js +32 -31
- package/dist/tools/dispatch/diagnosticDispatch.d.ts +3 -5
- package/dist/tools/dispatch/diagnosticDispatch.js +70 -68
- package/dist/tools/dispatch/directDispatch.js +11 -10
- package/dist/tools/dispatch/goalDispatch.js +5 -4
- package/dist/tools/dispatch/releaseDispatch.js +3 -2
- package/dist/tools/dispatch/validation.d.ts +7 -0
- package/dist/tools/dispatch/validation.js +71 -0
- package/dist/tools/{getPlan.js → goals/getPlan.js} +4 -4
- package/dist/tools/{goalSubgoalTask.d.ts → goals/goalSubgoalTask.d.ts} +1 -1
- package/dist/tools/goals/goalSubgoalTask.js +118 -0
- package/dist/tools/goals/index.d.ts +3 -0
- package/dist/tools/goals/index.js +3 -0
- package/dist/tools/{savePlan.js → goals/savePlan.js} +28 -8
- package/dist/tools/registry.d.ts +7 -11
- package/dist/tools/registry.js +17 -1178
- package/dist/tools/{checkReleaseGate.d.ts → release/checkReleaseGate.d.ts} +1 -1
- package/dist/tools/{checkReleaseGate.js → release/checkReleaseGate.js} +3 -3
- package/dist/tools/release/index.d.ts +2 -0
- package/dist/tools/release/index.js +2 -0
- package/dist/tools/{releaseMode.d.ts → release/releaseMode.d.ts} +2 -2
- package/dist/tools/{releaseMode.js → release/releaseMode.js} +46 -26
- package/dist/tools/tasks/cancelTask.d.ts +11 -0
- package/dist/tools/tasks/cancelTask.js +86 -0
- package/dist/tools/{createTask.d.ts → tasks/createTask.d.ts} +12 -4
- package/dist/tools/{createTask.js → tasks/createTask.js} +110 -34
- package/dist/tools/{diagnoseTask.d.ts → tasks/diagnoseTask.d.ts} +1 -1
- package/dist/tools/{diagnoseTask.js → tasks/diagnoseTask.js} +12 -16
- package/dist/tools/{evidencePack.js → tasks/evidencePack.js} +34 -22
- package/dist/tools/{getTaskFile.js → tasks/getTaskFile.js} +4 -4
- package/dist/tools/{getTaskStatus.d.ts → tasks/getTaskStatus.d.ts} +6 -1
- package/dist/tools/{getTaskStatus.js → tasks/getTaskStatus.js} +11 -6
- package/dist/tools/{getTaskStdoutTail.js → tasks/getTaskStdoutTail.js} +13 -11
- package/dist/tools/{getTaskSummary.js → tasks/getTaskSummary.js} +35 -36
- package/dist/tools/tasks/index.d.ts +18 -0
- package/dist/tools/tasks/index.js +18 -0
- package/dist/tools/tasks/killTask.d.ts +1 -0
- package/dist/tools/{listTasks.d.ts → tasks/listTasks.d.ts} +1 -1
- package/dist/tools/{listTasks.js → tasks/listTasks.js} +5 -4
- package/dist/tools/{reconcileTasks.d.ts → tasks/reconcileTasks.d.ts} +3 -2
- package/dist/tools/tasks/reconcileTasks.js +496 -0
- package/dist/tools/tasks/retryTask.js +60 -0
- package/dist/tools/{runTaskLoop.d.ts → tasks/runTaskLoop.d.ts} +6 -6
- package/dist/tools/{runTaskLoop.js → tasks/runTaskLoop.js} +63 -41
- package/dist/tools/tasks/runVerification.js +38 -0
- package/dist/tools/{taskLineage.js → tasks/taskLineage.js} +8 -7
- package/dist/tools/{taskOutputs.d.ts → tasks/taskOutputs.d.ts} +2 -2
- package/dist/tools/{taskOutputs.js → tasks/taskOutputs.js} +17 -16
- package/dist/tools/tasks/taskStates.d.ts +6 -0
- package/dist/tools/tasks/taskStates.js +52 -0
- package/dist/tools/{waitForTask.js → tasks/waitForTask.js} +3 -11
- package/dist/tools/{androidDoctor.js → workspace/androidDoctor.js} +16 -10
- package/dist/tools/{applyPatch.d.ts → workspace/applyPatch.d.ts} +1 -1
- package/dist/tools/workspace/applyPatch.js +53 -0
- package/dist/tools/{discardWorktree.js → workspace/discardWorktree.js} +3 -3
- package/dist/tools/workspace/index.d.ts +10 -0
- package/dist/tools/workspace/index.js +10 -0
- package/dist/tools/workspace/listAgents.d.ts +23 -0
- package/dist/tools/workspace/listAgents.js +56 -0
- package/dist/tools/{listWorkspace.js → workspace/listWorkspace.js} +3 -3
- package/dist/tools/{mergeWorktree.js → workspace/mergeWorktree.js} +3 -3
- package/dist/tools/{readWorkspaceFile.js → workspace/readWorkspaceFile.js} +8 -8
- package/dist/tools/{recommendAgentForTask.js → workspace/recommendAgentForTask.js} +3 -3
- package/dist/tools/{searchWorkspace.js → workspace/searchWorkspace.js} +5 -5
- package/dist/tools/{syncFile.d.ts → workspace/syncFile.d.ts} +1 -1
- package/dist/tools/workspace/syncFile.js +134 -0
- package/dist/utils/atomicFile.d.ts +7 -0
- package/dist/utils/atomicFile.js +67 -0
- package/dist/utils/boundedFile.d.ts +8 -0
- package/dist/utils/boundedFile.js +93 -0
- package/dist/utils/lockedJsonFile.d.ts +15 -0
- package/dist/utils/lockedJsonFile.js +224 -0
- package/dist/utils/platform.d.ts +11 -0
- package/dist/utils/platform.js +26 -0
- package/dist/utils/stableJson.d.ts +2 -0
- package/dist/utils/stableJson.js +12 -0
- package/dist/version.d.ts +3 -2
- package/dist/version.js +3 -2
- package/dist/watcherStatus.d.ts +2 -2
- package/dist/watcherStatus.js +18 -0
- package/docs/CODE_WIKI.md +808 -143
- package/docs/architecture.md +15 -55
- package/docs/assets/patchwarden-desktop-onboarding.png +0 -0
- package/docs/control-center/README.md +4 -4
- package/docs/dashboard-overview.md +4 -4
- package/docs/desktop-app.md +175 -0
- package/docs/evidence-pack-schema.md +3 -3
- package/docs/open-source-application.md +16 -11
- package/docs/release-checklist.md +1 -1
- package/docs/release-evidence.md +35 -39
- package/docs/task-safe-review-workflow.md +5 -5
- package/docs/threat-model.md +19 -1
- package/examples/config.example.json +4 -2
- package/package.json +27 -10
- package/scripts/README.md +15 -6
- package/scripts/build.js +11 -0
- package/scripts/checks/brand-check.js +3 -0
- package/scripts/checks/build-output-check.js +37 -0
- package/scripts/checks/control-center-smoke.js +102 -10
- package/scripts/checks/control-smoke.js +19 -8
- package/scripts/checks/http-mcp-smoke.js +82 -4
- package/scripts/checks/lifecycle-smoke.js +15 -12
- package/scripts/checks/mcp-manifest-check.js +1 -1
- package/scripts/checks/mcp-smoke.js +58 -4
- package/scripts/checks/package-manifest-check.js +20 -7
- package/scripts/checks/unit-tests.js +3 -5
- package/scripts/checks/watcher-supervisor-smoke.js +38 -1
- package/scripts/control/get-patchwarden-health.ps1 +1 -1
- package/scripts/control/manage-patchwarden.ps1 +69 -4
- package/scripts/control/provision-patchwarden-tunnel.ps1 +127 -0
- package/scripts/control/run-background-supervisor.ps1 +41 -0
- package/scripts/control/start-patchwarden-tunnel.ps1 +191 -33
- package/scripts/e2e/demo-runtime.mjs +153 -0
- package/{PatchWarden-Control-Tray.cmd → scripts/launchers/PatchWarden-Control-Tray.cmd} +3 -3
- package/scripts/launchers/PatchWarden-Control.cmd +6 -0
- package/{PatchWarden-Desktop.cmd → scripts/launchers/PatchWarden-Desktop.cmd} +2 -2
- package/scripts/launchers/Restart-PatchWarden-Control.cmd +6 -0
- package/{Stop-PatchWarden.cmd → scripts/launchers/Stop-PatchWarden.cmd} +2 -2
- package/scripts/lib/clean-generated-output.js +11 -0
- package/scripts/lib/file-discovery.js +12 -0
- package/scripts/release/desktop-preflight.js +211 -0
- package/scripts/release/pack-clean.js +59 -14
- package/src/assessments/agentAssessor.ts +26 -12
- package/src/assessments/assessmentDiagnostics.ts +172 -0
- package/src/assessments/assessmentStore.ts +288 -51
- package/src/assessments/securitySnapshot.ts +231 -0
- package/src/config.ts +70 -13
- package/src/control/fileManager.ts +40 -0
- package/src/control/middleware/auth.ts +22 -4
- package/src/control/middleware/static.ts +16 -3
- package/src/control/routeTable.ts +301 -0
- package/src/control/routes/audit.ts +14 -6
- package/src/control/routes/evidence.ts +1 -1
- package/src/control/routes/lineage.ts +1 -1
- package/src/control/routes/process.ts +341 -40
- package/src/control/routes/sessions.ts +88 -25
- package/src/control/routes/status.ts +134 -17
- package/src/control/routes/taskActions.ts +24 -58
- package/src/control/routes/tasks.ts +66 -58
- package/src/control/routes/workspace.ts +56 -25
- package/src/control/runtime.ts +71 -43
- package/src/control/server.ts +37 -342
- package/src/control/shared.ts +77 -11
- package/src/diagnostics/allowedTestCommandSafety.ts +12 -0
- package/src/direct/directAudit.ts +17 -9
- package/src/direct/directGuards.ts +72 -44
- package/src/direct/directPatch.ts +95 -8
- package/src/direct/directSessionStore.ts +213 -55
- package/src/direct/directVerification.ts +9 -23
- package/src/doctor.ts +76 -64
- package/src/goal/acceptanceEngine.ts +1 -1
- package/src/goal/goalProgress.ts +17 -13
- package/src/goal/goalReport.ts +5 -13
- package/src/goal/goalStatus.ts +19 -3
- package/src/goal/goalStore.ts +241 -54
- package/src/goal/handoffExport.ts +6 -6
- package/src/goal/specKitImport.ts +12 -12
- package/src/goal/subgoalSync.ts +11 -8
- package/src/goal/worktreeManager.ts +139 -22
- package/src/httpServer.ts +113 -30
- package/src/logging.ts +10 -3
- package/src/policy/projectPolicy.ts +5 -2
- package/src/release/releaseGate.ts +74 -27
- package/src/runner/agentInvocation.ts +126 -4
- package/src/runner/changeCapture.ts +291 -57
- package/src/runner/postTaskCleanup.ts +41 -17
- package/src/runner/processSecurity.ts +433 -0
- package/src/runner/runTask.ts +197 -97
- package/src/runner/simpleProcess.ts +66 -31
- package/src/{taskProgress.ts → runner/taskProgress.ts} +3 -3
- package/src/{taskRuntime.ts → runner/taskRuntime.ts} +6 -3
- package/src/runner/taskStatusStore.ts +69 -0
- package/src/runner/watch.ts +348 -52
- package/src/security/contentRedaction.ts +2 -2
- package/src/security/discoveryTokenStore.ts +18 -4
- package/src/security/loopbackHost.ts +19 -0
- package/src/security/pathGuard.ts +35 -16
- package/src/security/planGuard.ts +2 -1
- package/src/security/runtimeGuard.ts +9 -6
- package/src/security/secretComparison.ts +13 -0
- package/src/security/sensitiveGuard.ts +27 -8
- package/src/security/toolInvocationGuard.ts +2 -2
- package/src/security/workspaceRootGuard.ts +53 -0
- package/src/smoke-test.ts +27 -26
- package/src/tools/catalog/index.ts +4 -0
- package/src/tools/{toolCatalog.ts → catalog/toolCatalog.ts} +3 -12
- package/src/tools/{toolRegistry.ts → catalog/toolRegistry.ts} +7 -16
- package/src/tools/definitions/toolDefs.ts +1264 -0
- package/src/tools/{auditSession.ts → diagnostics/auditSession.ts} +2 -2
- package/src/tools/{auditTask.ts → diagnostics/auditTask.ts} +136 -39
- package/src/tools/{healthCheck.ts → diagnostics/healthCheck.ts} +37 -9
- package/src/tools/diagnostics/index.ts +6 -0
- package/src/tools/{safeStatus.ts → diagnostics/safeStatus.ts} +7 -7
- package/src/tools/{safeViews.ts → diagnostics/safeViews.ts} +27 -17
- package/src/tools/{schemaDriftCheck.ts → diagnostics/schemaDriftCheck.ts} +3 -3
- package/src/tools/{createDirectSession.ts → direct/createDirectSession.ts} +6 -6
- package/src/tools/{finalizeDirectSession.ts → direct/finalizeDirectSession.ts} +7 -5
- package/src/tools/direct/index.ts +3 -0
- package/src/tools/{runDirectVerificationBundle.ts → direct/runDirectVerificationBundle.ts} +2 -2
- package/src/tools/{discoverTools.ts → discovery/discoverTools.ts} +6 -6
- package/src/tools/{explainTool.ts → discovery/explainTool.ts} +3 -3
- package/src/tools/discovery/index.ts +3 -0
- package/src/tools/{invokeDiscoveredTool.ts → discovery/invokeDiscoveredTool.ts} +7 -7
- package/src/tools/dispatch/coreDispatch.ts +36 -31
- package/src/tools/dispatch/diagnosticDispatch.ts +26 -21
- package/src/tools/dispatch/directDispatch.ts +11 -10
- package/src/tools/dispatch/goalDispatch.ts +5 -4
- package/src/tools/dispatch/releaseDispatch.ts +3 -2
- package/src/tools/dispatch/validation.ts +78 -0
- package/src/tools/{getPlan.ts → goals/getPlan.ts} +4 -4
- package/src/tools/{goalSubgoalTask.ts → goals/goalSubgoalTask.ts} +41 -26
- package/src/tools/goals/index.ts +3 -0
- package/src/tools/{savePlan.ts → goals/savePlan.ts} +38 -8
- package/src/tools/registry.ts +17 -1261
- package/src/tools/{checkReleaseGate.ts → release/checkReleaseGate.ts} +3 -3
- package/src/tools/release/index.ts +2 -0
- package/src/tools/{releaseMode.ts → release/releaseMode.ts} +42 -24
- package/src/tools/tasks/cancelTask.ts +110 -0
- package/src/tools/{createTask.ts → tasks/createTask.ts} +161 -33
- package/src/tools/{diagnoseTask.ts → tasks/diagnoseTask.ts} +12 -16
- package/src/tools/{evidencePack.ts → tasks/evidencePack.ts} +36 -22
- package/src/tools/{getTaskFile.ts → tasks/getTaskFile.ts} +4 -4
- package/src/tools/{getTaskStatus.ts → tasks/getTaskStatus.ts} +13 -6
- package/src/tools/{getTaskStdoutTail.ts → tasks/getTaskStdoutTail.ts} +13 -11
- package/src/tools/{getTaskSummary.ts → tasks/getTaskSummary.ts} +46 -44
- package/src/tools/tasks/index.ts +18 -0
- package/src/tools/{listTasks.ts → tasks/listTasks.ts} +6 -5
- package/src/tools/{reconcileTasks.ts → tasks/reconcileTasks.ts} +228 -77
- package/src/tools/tasks/retryTask.ts +69 -0
- package/src/tools/{runTaskLoop.ts → tasks/runTaskLoop.ts} +73 -46
- package/src/tools/{runVerification.ts → tasks/runVerification.ts} +6 -3
- package/src/tools/{taskLineage.ts → tasks/taskLineage.ts} +8 -7
- package/src/tools/{taskOutputs.ts → tasks/taskOutputs.ts} +27 -20
- package/src/tools/tasks/taskStates.ts +54 -0
- package/src/tools/{waitForTask.ts → tasks/waitForTask.ts} +3 -12
- package/src/tools/{androidDoctor.ts → workspace/androidDoctor.ts} +15 -10
- package/src/tools/{applyPatch.ts → workspace/applyPatch.ts} +38 -16
- package/src/tools/{discardWorktree.ts → workspace/discardWorktree.ts} +3 -3
- package/src/tools/workspace/index.ts +10 -0
- package/src/tools/workspace/listAgents.ts +75 -0
- package/src/tools/{listWorkspace.ts → workspace/listWorkspace.ts} +3 -3
- package/src/tools/{mergeWorktree.ts → workspace/mergeWorktree.ts} +3 -3
- package/src/tools/{readWorkspaceFile.ts → workspace/readWorkspaceFile.ts} +8 -8
- package/src/tools/{recommendAgentForTask.ts → workspace/recommendAgentForTask.ts} +3 -3
- package/src/tools/{searchWorkspace.ts → workspace/searchWorkspace.ts} +5 -5
- package/src/tools/workspace/syncFile.ts +292 -0
- package/src/utils/atomicFile.ts +74 -0
- package/src/utils/boundedFile.ts +116 -0
- package/src/utils/lockedJsonFile.ts +251 -0
- package/src/utils/platform.ts +31 -0
- package/src/utils/stableJson.ts +12 -0
- package/src/version.ts +3 -2
- package/src/watcherStatus.ts +19 -1
- package/ui/desktop-bootstrap.js +11 -0
- package/ui/desktop-bridge.js +36 -0
- package/ui/desktop.css +160 -0
- package/ui/getting-started.js +93 -0
- package/ui/i18n.js +484 -0
- package/ui/log-parser.js +30 -0
- package/ui/pages/audit.html +12 -0
- package/ui/pages/dashboard.html +94 -147
- package/ui/pages/direct-sessions.html +123 -26
- package/ui/pages/getting-started.html +43 -0
- package/ui/pages/logs.html +134 -22
- package/ui/pages/settings.html +101 -0
- package/ui/pages/task-detail.html +12 -0
- package/ui/pages/tasks.html +54 -8
- package/ui/pages/workspace.html +38 -1
- package/ui/settings.js +254 -0
- package/PatchWarden-Control.cmd +0 -6
- package/Restart-PatchWarden-Control.cmd +0 -6
- package/dist/test/unit/acceptance-engine.test.d.ts +0 -1
- package/dist/test/unit/acceptance-engine.test.js +0 -228
- package/dist/test/unit/agent-router.test.d.ts +0 -1
- package/dist/test/unit/agent-router.test.js +0 -287
- package/dist/test/unit/android-doctor.test.d.ts +0 -1
- package/dist/test/unit/android-doctor.test.js +0 -118
- package/dist/test/unit/apply-patch.test.d.ts +0 -1
- package/dist/test/unit/apply-patch.test.js +0 -225
- package/dist/test/unit/audit-checks.test.d.ts +0 -1
- package/dist/test/unit/audit-checks.test.js +0 -350
- package/dist/test/unit/chinese-path.test.d.ts +0 -1
- package/dist/test/unit/chinese-path.test.js +0 -91
- package/dist/test/unit/command-guard.test.d.ts +0 -1
- package/dist/test/unit/command-guard.test.js +0 -160
- package/dist/test/unit/create-task.test.d.ts +0 -1
- package/dist/test/unit/create-task.test.js +0 -197
- package/dist/test/unit/diagnose-task.test.d.ts +0 -1
- package/dist/test/unit/diagnose-task.test.js +0 -457
- package/dist/test/unit/direct-guards.test.d.ts +0 -1
- package/dist/test/unit/direct-guards.test.js +0 -328
- package/dist/test/unit/discovery-token-store.test.d.ts +0 -1
- package/dist/test/unit/discovery-token-store.test.js +0 -139
- package/dist/test/unit/evidence-pack.test.d.ts +0 -1
- package/dist/test/unit/evidence-pack.test.js +0 -224
- package/dist/test/unit/get-task-status.test.d.ts +0 -1
- package/dist/test/unit/get-task-status.test.js +0 -174
- package/dist/test/unit/get-task-summary.test.d.ts +0 -1
- package/dist/test/unit/get-task-summary.test.js +0 -146
- package/dist/test/unit/goal-graph.test.d.ts +0 -1
- package/dist/test/unit/goal-graph.test.js +0 -298
- package/dist/test/unit/goal-progress.test.d.ts +0 -1
- package/dist/test/unit/goal-progress.test.js +0 -381
- package/dist/test/unit/goal-report.test.d.ts +0 -1
- package/dist/test/unit/goal-report.test.js +0 -159
- package/dist/test/unit/goal-status.test.d.ts +0 -1
- package/dist/test/unit/goal-status.test.js +0 -215
- package/dist/test/unit/goal-store.test.d.ts +0 -1
- package/dist/test/unit/goal-store.test.js +0 -253
- package/dist/test/unit/goal-subgoal-task.test.d.ts +0 -1
- package/dist/test/unit/goal-subgoal-task.test.js +0 -55
- package/dist/test/unit/goal-tools-registry.test.d.ts +0 -1
- package/dist/test/unit/goal-tools-registry.test.js +0 -192
- package/dist/test/unit/handoff-export.test.d.ts +0 -1
- package/dist/test/unit/handoff-export.test.js +0 -263
- package/dist/test/unit/invoke-discovered-tool.test.d.ts +0 -1
- package/dist/test/unit/invoke-discovered-tool.test.js +0 -167
- package/dist/test/unit/logging.test.d.ts +0 -1
- package/dist/test/unit/logging.test.js +0 -397
- package/dist/test/unit/path-guard.test.d.ts +0 -1
- package/dist/test/unit/path-guard.test.js +0 -133
- package/dist/test/unit/post-task-cleanup.test.d.ts +0 -1
- package/dist/test/unit/post-task-cleanup.test.js +0 -48
- package/dist/test/unit/project-policy-release-mode.test.d.ts +0 -1
- package/dist/test/unit/project-policy-release-mode.test.js +0 -125
- package/dist/test/unit/reconcile-tasks.test.d.ts +0 -1
- package/dist/test/unit/reconcile-tasks.test.js +0 -456
- package/dist/test/unit/release-gate.test.d.ts +0 -1
- package/dist/test/unit/release-gate.test.js +0 -242
- package/dist/test/unit/run-task-loop.test.d.ts +0 -1
- package/dist/test/unit/run-task-loop.test.js +0 -380
- package/dist/test/unit/safe-status.test.d.ts +0 -1
- package/dist/test/unit/safe-status.test.js +0 -165
- package/dist/test/unit/safe-views.test.d.ts +0 -1
- package/dist/test/unit/safe-views.test.js +0 -171
- package/dist/test/unit/schema-drift-check.test.d.ts +0 -1
- package/dist/test/unit/schema-drift-check.test.js +0 -176
- package/dist/test/unit/sensitive-guard.test.d.ts +0 -1
- package/dist/test/unit/sensitive-guard.test.js +0 -104
- package/dist/test/unit/spec-kit-import.test.d.ts +0 -1
- package/dist/test/unit/spec-kit-import.test.js +0 -341
- package/dist/test/unit/subgoal-sync.test.d.ts +0 -1
- package/dist/test/unit/subgoal-sync.test.js +0 -183
- package/dist/test/unit/sync-file.test.d.ts +0 -1
- package/dist/test/unit/sync-file.test.js +0 -154
- package/dist/test/unit/tool-invocation-guard.test.d.ts +0 -1
- package/dist/test/unit/tool-invocation-guard.test.js +0 -432
- package/dist/test/unit/tool-usage-stats.test.d.ts +0 -1
- package/dist/test/unit/tool-usage-stats.test.js +0 -300
- package/dist/test/unit/toolSearch.test.d.ts +0 -1
- package/dist/test/unit/toolSearch.test.js +0 -571
- package/dist/test/unit/wait-for-task.test.d.ts +0 -1
- package/dist/test/unit/wait-for-task.test.js +0 -144
- package/dist/test/unit/watcher-status.test.d.ts +0 -1
- package/dist/test/unit/watcher-status.test.js +0 -169
- package/dist/test/unit/worktree-manager.test.d.ts +0 -1
- package/dist/test/unit/worktree-manager.test.js +0 -176
- package/dist/tools/applyPatch.js +0 -41
- package/dist/tools/cancelTask.d.ts +0 -30
- package/dist/tools/cancelTask.js +0 -64
- package/dist/tools/finalizeDirectSession.js +0 -84
- package/dist/tools/goalSubgoalTask.js +0 -110
- package/dist/tools/killTask.d.ts +0 -15
- package/dist/tools/listAgents.d.ts +0 -12
- package/dist/tools/listAgents.js +0 -42
- package/dist/tools/reconcileTasks.js +0 -352
- package/dist/tools/retryTask.js +0 -45
- package/dist/tools/runVerification.js +0 -36
- package/dist/tools/syncFile.js +0 -65
- package/docs/control-center/control-center-daily-driver.md +0 -211
- package/docs/control-center/control-center-mvp.md +0 -205
- package/docs/control-center/control-center-phase2.md +0 -159
- package/docs/execution-plan-2026-07-09.md +0 -315
- package/docs/release-v0.6.0.md +0 -71
- package/docs/release-v0.6.1.md +0 -75
- package/docs/release-v0.6.4.md +0 -45
- package/docs/roadmap-execution-and-acceptance.md +0 -365
- package/src/test/unit/acceptance-engine.test.ts +0 -261
- package/src/test/unit/agent-router.test.ts +0 -342
- package/src/test/unit/android-doctor.test.ts +0 -158
- package/src/test/unit/apply-patch.test.ts +0 -293
- package/src/test/unit/audit-checks.test.ts +0 -567
- package/src/test/unit/chinese-path.test.ts +0 -106
- package/src/test/unit/command-guard.test.ts +0 -221
- package/src/test/unit/create-task.test.ts +0 -255
- package/src/test/unit/diagnose-task.test.ts +0 -544
- package/src/test/unit/direct-guards.test.ts +0 -467
- package/src/test/unit/discovery-token-store.test.ts +0 -181
- package/src/test/unit/evidence-pack.test.ts +0 -251
- package/src/test/unit/get-task-status.test.ts +0 -203
- package/src/test/unit/get-task-summary.test.ts +0 -173
- package/src/test/unit/goal-graph.test.ts +0 -347
- package/src/test/unit/goal-progress.test.ts +0 -538
- package/src/test/unit/goal-report.test.ts +0 -189
- package/src/test/unit/goal-status.test.ts +0 -270
- package/src/test/unit/goal-store.test.ts +0 -318
- package/src/test/unit/goal-subgoal-task.test.ts +0 -72
- package/src/test/unit/goal-tools-registry.test.ts +0 -245
- package/src/test/unit/handoff-export.test.ts +0 -295
- package/src/test/unit/invoke-discovered-tool.test.ts +0 -216
- package/src/test/unit/logging.test.ts +0 -497
- package/src/test/unit/path-guard.test.ts +0 -180
- package/src/test/unit/post-task-cleanup.test.ts +0 -53
- package/src/test/unit/project-policy-release-mode.test.ts +0 -156
- package/src/test/unit/reconcile-tasks.test.ts +0 -551
- package/src/test/unit/release-gate.test.ts +0 -314
- package/src/test/unit/run-task-loop.test.ts +0 -425
- package/src/test/unit/safe-status.test.ts +0 -187
- package/src/test/unit/safe-views.test.ts +0 -184
- package/src/test/unit/schema-drift-check.test.ts +0 -260
- package/src/test/unit/sensitive-guard.test.ts +0 -124
- package/src/test/unit/spec-kit-import.test.ts +0 -429
- package/src/test/unit/subgoal-sync.test.ts +0 -236
- package/src/test/unit/sync-file.test.ts +0 -231
- package/src/test/unit/tool-invocation-guard.test.ts +0 -542
- package/src/test/unit/tool-usage-stats.test.ts +0 -384
- package/src/test/unit/toolSearch.test.ts +0 -756
- package/src/test/unit/wait-for-task.test.ts +0 -176
- package/src/test/unit/watcher-status.test.ts +0 -190
- package/src/test/unit/worktree-manager.test.ts +0 -247
- package/src/tools/cancelTask.ts +0 -70
- package/src/tools/listAgents.ts +0 -54
- package/src/tools/retryTask.ts +0 -53
- package/src/tools/syncFile.ts +0 -122
- /package/dist/tools/{toolCatalog.d.ts → catalog/toolCatalog.d.ts} +0 -0
- /package/dist/tools/{toolSearch.d.ts → catalog/toolSearch.d.ts} +0 -0
- /package/dist/tools/{toolSearch.js → catalog/toolSearch.js} +0 -0
- /package/dist/tools/{toolUsageStats.d.ts → catalog/toolUsageStats.d.ts} +0 -0
- /package/dist/tools/{toolUsageStats.js → catalog/toolUsageStats.js} +0 -0
- /package/dist/tools/{createDirectSession.d.ts → direct/createDirectSession.d.ts} +0 -0
- /package/dist/tools/{runDirectVerificationBundle.d.ts → direct/runDirectVerificationBundle.d.ts} +0 -0
- /package/dist/tools/{getPlan.d.ts → goals/getPlan.d.ts} +0 -0
- /package/dist/tools/{savePlan.d.ts → goals/savePlan.d.ts} +0 -0
- /package/dist/tools/{evidencePack.d.ts → tasks/evidencePack.d.ts} +0 -0
- /package/dist/tools/{getTaskFile.d.ts → tasks/getTaskFile.d.ts} +0 -0
- /package/dist/tools/{getTaskProgress.d.ts → tasks/getTaskProgress.d.ts} +0 -0
- /package/dist/tools/{getTaskProgress.js → tasks/getTaskProgress.js} +0 -0
- /package/dist/tools/{getTaskStdoutTail.d.ts → tasks/getTaskStdoutTail.d.ts} +0 -0
- /package/dist/tools/{getTaskSummary.d.ts → tasks/getTaskSummary.d.ts} +0 -0
- /package/dist/tools/{killTask.js → tasks/killTask.js} +0 -0
- /package/dist/tools/{retryTask.d.ts → tasks/retryTask.d.ts} +0 -0
- /package/dist/tools/{runVerification.d.ts → tasks/runVerification.d.ts} +0 -0
- /package/dist/tools/{taskLineage.d.ts → tasks/taskLineage.d.ts} +0 -0
- /package/dist/tools/{waitForTask.d.ts → tasks/waitForTask.d.ts} +0 -0
- /package/dist/tools/{androidDoctor.d.ts → workspace/androidDoctor.d.ts} +0 -0
- /package/dist/tools/{discardWorktree.d.ts → workspace/discardWorktree.d.ts} +0 -0
- /package/dist/tools/{listWorkspace.d.ts → workspace/listWorkspace.d.ts} +0 -0
- /package/dist/tools/{mergeWorktree.d.ts → workspace/mergeWorktree.d.ts} +0 -0
- /package/dist/tools/{readWorkspaceFile.d.ts → workspace/readWorkspaceFile.d.ts} +0 -0
- /package/dist/tools/{recommendAgentForTask.d.ts → workspace/recommendAgentForTask.d.ts} +0 -0
- /package/dist/tools/{searchWorkspace.d.ts → workspace/searchWorkspace.d.ts} +0 -0
- /package/src/tools/{toolSearch.ts → catalog/toolSearch.ts} +0 -0
- /package/src/tools/{toolUsageStats.ts → catalog/toolUsageStats.ts} +0 -0
- /package/src/tools/{getTaskProgress.ts → tasks/getTaskProgress.ts} +0 -0
- /package/src/tools/{killTask.ts → tasks/killTask.ts} +0 -0
|
@@ -1,342 +0,0 @@
|
|
|
1
|
-
import { describe, it } from "node:test";
|
|
2
|
-
import { strict as assert } from "node:assert";
|
|
3
|
-
import {
|
|
4
|
-
routeAgent,
|
|
5
|
-
AGENT_ROUTING_RULES,
|
|
6
|
-
type AgentRouteInput,
|
|
7
|
-
} from "../../agents/agentRouter.js";
|
|
8
|
-
import { PatchWardenError } from "../../errors.js";
|
|
9
|
-
|
|
10
|
-
// ── Helpers ───────────────────────────────────────────────────────
|
|
11
|
-
|
|
12
|
-
const ALL_AGENTS = ["codex", "opencode", "claude", "patchwarden-direct", "patchwarden-audit"];
|
|
13
|
-
|
|
14
|
-
function scopeFiles(count: number): string[] {
|
|
15
|
-
return Array.from({ length: count }, (_, i) => `file_${i}.ts`);
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
// ── Tests ─────────────────────────────────────────────────────────
|
|
19
|
-
|
|
20
|
-
describe("routeAgent", () => {
|
|
21
|
-
// ── 1. 大规模代码修改 → opencode ────────────────────────────────
|
|
22
|
-
|
|
23
|
-
it("scope 15 个文件 → opencode, fallback=false, reason 含 'large scope'", () => {
|
|
24
|
-
const result = routeAgent({
|
|
25
|
-
goal: "大规模修改",
|
|
26
|
-
scope: scopeFiles(15),
|
|
27
|
-
configuredAgents: ALL_AGENTS,
|
|
28
|
-
});
|
|
29
|
-
assert.equal(result.recommended_agent, "opencode");
|
|
30
|
-
assert.equal(result.fallback, false);
|
|
31
|
-
assert.ok(result.reason.includes("large scope"), `reason should contain 'large scope', got: ${result.reason}`);
|
|
32
|
-
assert.ok(result.reason.includes("15"), `reason should contain file count '15', got: ${result.reason}`);
|
|
33
|
-
assert.ok(ALL_AGENTS.includes(result.recommended_agent));
|
|
34
|
-
});
|
|
35
|
-
|
|
36
|
-
// ── 2. 单文件修改 → patchwarden-direct ──────────────────────────
|
|
37
|
-
|
|
38
|
-
it("scope 1 个文件 → patchwarden-direct, fallback=false", () => {
|
|
39
|
-
const result = routeAgent({
|
|
40
|
-
goal: "修复一个 bug",
|
|
41
|
-
scope: ["src/index.ts"],
|
|
42
|
-
configuredAgents: ALL_AGENTS,
|
|
43
|
-
});
|
|
44
|
-
assert.equal(result.recommended_agent, "patchwarden-direct");
|
|
45
|
-
assert.equal(result.fallback, false);
|
|
46
|
-
assert.ok(ALL_AGENTS.includes(result.recommended_agent));
|
|
47
|
-
});
|
|
48
|
-
|
|
49
|
-
// ── 3. 文档整理 → claude ────────────────────────────────────────
|
|
50
|
-
|
|
51
|
-
it("goal 含 '更新 README 文档' → claude(若 configured)", () => {
|
|
52
|
-
const result = routeAgent({
|
|
53
|
-
goal: "更新 README 文档",
|
|
54
|
-
configuredAgents: ALL_AGENTS,
|
|
55
|
-
});
|
|
56
|
-
assert.equal(result.recommended_agent, "claude");
|
|
57
|
-
assert.equal(result.fallback, false);
|
|
58
|
-
assert.ok(result.reason.includes("documentation"), `reason should contain 'documentation', got: ${result.reason}`);
|
|
59
|
-
assert.ok(ALL_AGENTS.includes(result.recommended_agent));
|
|
60
|
-
});
|
|
61
|
-
|
|
62
|
-
it("goal 含文档关键词但 claude 未配置 → fallback 到 opencode", () => {
|
|
63
|
-
const configured = ["codex", "opencode"];
|
|
64
|
-
const result = routeAgent({
|
|
65
|
-
goal: "更新 README 文档",
|
|
66
|
-
configuredAgents: configured,
|
|
67
|
-
});
|
|
68
|
-
assert.equal(result.recommended_agent, "opencode");
|
|
69
|
-
assert.equal(result.fallback, true);
|
|
70
|
-
assert.ok(configured.includes(result.recommended_agent));
|
|
71
|
-
});
|
|
72
|
-
|
|
73
|
-
it("goal 含文档关键词但 claude 和 opencode 都未配置 → fallback 到第一个", () => {
|
|
74
|
-
const configured = ["codex"];
|
|
75
|
-
const result = routeAgent({
|
|
76
|
-
goal: "更新 README 文档",
|
|
77
|
-
configuredAgents: configured,
|
|
78
|
-
});
|
|
79
|
-
assert.equal(result.recommended_agent, "codex");
|
|
80
|
-
assert.equal(result.fallback, true);
|
|
81
|
-
assert.ok(configured.includes(result.recommended_agent));
|
|
82
|
-
});
|
|
83
|
-
|
|
84
|
-
// ── 4. 复杂推理和重构 → codex ───────────────────────────────────
|
|
85
|
-
|
|
86
|
-
it("goal 含 '跨模块重构' → codex", () => {
|
|
87
|
-
const result = routeAgent({
|
|
88
|
-
goal: "跨模块重构认证模块",
|
|
89
|
-
configuredAgents: ALL_AGENTS,
|
|
90
|
-
});
|
|
91
|
-
assert.equal(result.recommended_agent, "codex");
|
|
92
|
-
assert.equal(result.fallback, false);
|
|
93
|
-
assert.ok(result.reason.includes("refactor"), `reason should contain 'refactor', got: ${result.reason}`);
|
|
94
|
-
assert.ok(ALL_AGENTS.includes(result.recommended_agent));
|
|
95
|
-
});
|
|
96
|
-
|
|
97
|
-
it("goal 含 'redesign' → codex", () => {
|
|
98
|
-
const result = routeAgent({
|
|
99
|
-
goal: "Redesign the data layer",
|
|
100
|
-
configuredAgents: ALL_AGENTS,
|
|
101
|
-
});
|
|
102
|
-
assert.equal(result.recommended_agent, "codex");
|
|
103
|
-
assert.equal(result.fallback, false);
|
|
104
|
-
assert.ok(ALL_AGENTS.includes(result.recommended_agent));
|
|
105
|
-
});
|
|
106
|
-
|
|
107
|
-
// ── 5. 验收审计 → patchwarden-audit ─────────────────────────────
|
|
108
|
-
|
|
109
|
-
it("goal 含 '审计任务' → patchwarden-audit", () => {
|
|
110
|
-
const result = routeAgent({
|
|
111
|
-
goal: "执行验收审计任务",
|
|
112
|
-
configuredAgents: ALL_AGENTS,
|
|
113
|
-
});
|
|
114
|
-
assert.equal(result.recommended_agent, "patchwarden-audit");
|
|
115
|
-
assert.equal(result.fallback, false);
|
|
116
|
-
assert.ok(result.reason.includes("audit"), `reason should contain 'audit', got: ${result.reason}`);
|
|
117
|
-
assert.ok(ALL_AGENTS.includes(result.recommended_agent));
|
|
118
|
-
});
|
|
119
|
-
|
|
120
|
-
it("goal 含 'verify' → patchwarden-audit", () => {
|
|
121
|
-
const result = routeAgent({
|
|
122
|
-
goal: "verify the release artifacts",
|
|
123
|
-
configuredAgents: ALL_AGENTS,
|
|
124
|
-
});
|
|
125
|
-
assert.equal(result.recommended_agent, "patchwarden-audit");
|
|
126
|
-
assert.equal(result.fallback, false);
|
|
127
|
-
assert.ok(ALL_AGENTS.includes(result.recommended_agent));
|
|
128
|
-
});
|
|
129
|
-
|
|
130
|
-
// ── 6. 无匹配 → fallback 到 configuredAgents[0] ────────────────
|
|
131
|
-
|
|
132
|
-
it("无匹配(goal='普通任务', scope=['a.ts','b.ts'])→ fallback=true, recommended_agent=configuredAgents[0]", () => {
|
|
133
|
-
const configured = ["codex", "opencode"];
|
|
134
|
-
const result = routeAgent({
|
|
135
|
-
goal: "普通任务",
|
|
136
|
-
scope: ["a.ts", "b.ts"],
|
|
137
|
-
configuredAgents: configured,
|
|
138
|
-
});
|
|
139
|
-
assert.equal(result.recommended_agent, configured[0]);
|
|
140
|
-
assert.equal(result.fallback, true);
|
|
141
|
-
assert.ok(configured.includes(result.recommended_agent));
|
|
142
|
-
});
|
|
143
|
-
|
|
144
|
-
// ── 7. 白名单约束:推荐结果必须在 configuredAgents 中 ──────────
|
|
145
|
-
|
|
146
|
-
it("所有场景断言 result.recommended_agent 在 configuredAgents 中", () => {
|
|
147
|
-
const configured = ["codex", "opencode"];
|
|
148
|
-
const inputs: AgentRouteInput[] = [
|
|
149
|
-
{ goal: "大规模修改", scope: scopeFiles(15), configuredAgents: configured },
|
|
150
|
-
{ goal: "单文件", scope: ["a.ts"], configuredAgents: configured },
|
|
151
|
-
{ goal: "审计任务", configuredAgents: configured },
|
|
152
|
-
{ goal: "重构模块", configuredAgents: configured },
|
|
153
|
-
{ goal: "更新文档", configuredAgents: configured },
|
|
154
|
-
{ goal: "普通任务", scope: ["a.ts", "b.ts"], configuredAgents: configured },
|
|
155
|
-
];
|
|
156
|
-
for (const input of inputs) {
|
|
157
|
-
const result = routeAgent(input);
|
|
158
|
-
assert.ok(
|
|
159
|
-
configured.includes(result.recommended_agent),
|
|
160
|
-
`recommended_agent "${result.recommended_agent}" not in configuredAgents [${configured.join(", ")}] for goal "${input.goal}"`
|
|
161
|
-
);
|
|
162
|
-
}
|
|
163
|
-
});
|
|
164
|
-
|
|
165
|
-
it("白名单约束:opencode 未配置时大规模 scope 回退到第一个 agent", () => {
|
|
166
|
-
const configured = ["codex"];
|
|
167
|
-
const result = routeAgent({
|
|
168
|
-
goal: "大规模修改",
|
|
169
|
-
scope: scopeFiles(15),
|
|
170
|
-
configuredAgents: configured,
|
|
171
|
-
});
|
|
172
|
-
assert.equal(result.recommended_agent, "codex");
|
|
173
|
-
assert.equal(result.fallback, true);
|
|
174
|
-
assert.ok(result.reason.includes("fallback"), `reason should contain 'fallback', got: ${result.reason}`);
|
|
175
|
-
assert.ok(configured.includes(result.recommended_agent));
|
|
176
|
-
});
|
|
177
|
-
|
|
178
|
-
it("白名单约束:patchwarden-direct 未配置时单文件 scope 回退", () => {
|
|
179
|
-
const configured = ["codex", "opencode"];
|
|
180
|
-
const result = routeAgent({
|
|
181
|
-
goal: "修复 bug",
|
|
182
|
-
scope: ["a.ts"],
|
|
183
|
-
configuredAgents: configured,
|
|
184
|
-
});
|
|
185
|
-
assert.equal(result.recommended_agent, "codex");
|
|
186
|
-
assert.equal(result.fallback, true);
|
|
187
|
-
assert.ok(configured.includes(result.recommended_agent));
|
|
188
|
-
});
|
|
189
|
-
|
|
190
|
-
it("白名单约束:patchwarden-audit 未配置时审计任务回退", () => {
|
|
191
|
-
const configured = ["codex", "opencode"];
|
|
192
|
-
const result = routeAgent({
|
|
193
|
-
goal: "审计任务",
|
|
194
|
-
configuredAgents: configured,
|
|
195
|
-
});
|
|
196
|
-
assert.equal(result.recommended_agent, "codex");
|
|
197
|
-
assert.equal(result.fallback, true);
|
|
198
|
-
assert.ok(configured.includes(result.recommended_agent));
|
|
199
|
-
});
|
|
200
|
-
|
|
201
|
-
it("白名单约束:codex 未配置时重构任务回退", () => {
|
|
202
|
-
const configured = ["opencode"];
|
|
203
|
-
const result = routeAgent({
|
|
204
|
-
goal: "跨模块重构",
|
|
205
|
-
configuredAgents: configured,
|
|
206
|
-
});
|
|
207
|
-
assert.equal(result.recommended_agent, "opencode");
|
|
208
|
-
assert.equal(result.fallback, true);
|
|
209
|
-
assert.ok(configured.includes(result.recommended_agent));
|
|
210
|
-
});
|
|
211
|
-
|
|
212
|
-
// ── 8. configuredAgents 为空 → 抛错 ────────────────────────────
|
|
213
|
-
|
|
214
|
-
it("configuredAgents 为空 → 抛 PatchWardenError(no_agent_configured)", () => {
|
|
215
|
-
assert.throws(
|
|
216
|
-
() => routeAgent({ goal: "任意任务", configuredAgents: [] }),
|
|
217
|
-
(err: unknown) => {
|
|
218
|
-
assert.ok(err instanceof PatchWardenError, "err should be PatchWardenError");
|
|
219
|
-
assert.equal((err as PatchWardenError).reason, "no_agent_configured");
|
|
220
|
-
return true;
|
|
221
|
-
}
|
|
222
|
-
);
|
|
223
|
-
});
|
|
224
|
-
|
|
225
|
-
// ── 9. 路由规则优先级验证 ───────────────────────────────────────
|
|
226
|
-
|
|
227
|
-
it("优先级:scope > 10 优先于文档关键词", () => {
|
|
228
|
-
// scope 15 个文件 + goal 含文档关键词 → opencode(规则1 优先于规则5)
|
|
229
|
-
const result = routeAgent({
|
|
230
|
-
goal: "更新文档",
|
|
231
|
-
scope: scopeFiles(15),
|
|
232
|
-
configuredAgents: ALL_AGENTS,
|
|
233
|
-
});
|
|
234
|
-
assert.equal(result.recommended_agent, "opencode");
|
|
235
|
-
assert.equal(result.fallback, false);
|
|
236
|
-
});
|
|
237
|
-
|
|
238
|
-
it("优先级:scope === 1 优先于审计关键词", () => {
|
|
239
|
-
// scope 1 个文件 + goal 含审计关键词 → patchwarden-direct(规则2 优先于规则3)
|
|
240
|
-
const result = routeAgent({
|
|
241
|
-
goal: "审计任务",
|
|
242
|
-
scope: ["a.ts"],
|
|
243
|
-
configuredAgents: ALL_AGENTS,
|
|
244
|
-
});
|
|
245
|
-
assert.equal(result.recommended_agent, "patchwarden-direct");
|
|
246
|
-
assert.equal(result.fallback, false);
|
|
247
|
-
});
|
|
248
|
-
|
|
249
|
-
it("优先级:审计关键词优先于重构关键词", () => {
|
|
250
|
-
// goal 同时含审计和重构关键词 → patchwarden-audit(规则3 优先于规则4)
|
|
251
|
-
const result = routeAgent({
|
|
252
|
-
goal: "审计重构模块",
|
|
253
|
-
configuredAgents: ALL_AGENTS,
|
|
254
|
-
});
|
|
255
|
-
assert.equal(result.recommended_agent, "patchwarden-audit");
|
|
256
|
-
assert.equal(result.fallback, false);
|
|
257
|
-
});
|
|
258
|
-
|
|
259
|
-
it("优先级:重构关键词优先于文档关键词", () => {
|
|
260
|
-
// goal 同时含重构和文档关键词 → codex(规则4 优先于规则5)
|
|
261
|
-
const result = routeAgent({
|
|
262
|
-
goal: "重构文档模块",
|
|
263
|
-
configuredAgents: ALL_AGENTS,
|
|
264
|
-
});
|
|
265
|
-
assert.equal(result.recommended_agent, "codex");
|
|
266
|
-
assert.equal(result.fallback, false);
|
|
267
|
-
});
|
|
268
|
-
|
|
269
|
-
// ── 10. inline_plan 文本特征匹配 ────────────────────────────────
|
|
270
|
-
|
|
271
|
-
it("inline_plan 含重构关键词 → codex", () => {
|
|
272
|
-
const result = routeAgent({
|
|
273
|
-
goal: "改进代码",
|
|
274
|
-
inline_plan: "需要 refactor 数据访问层",
|
|
275
|
-
configuredAgents: ALL_AGENTS,
|
|
276
|
-
});
|
|
277
|
-
assert.equal(result.recommended_agent, "codex");
|
|
278
|
-
assert.equal(result.fallback, false);
|
|
279
|
-
});
|
|
280
|
-
|
|
281
|
-
it("inline_plan 含审计关键词 → patchwarden-audit", () => {
|
|
282
|
-
const result = routeAgent({
|
|
283
|
-
goal: "检查工作",
|
|
284
|
-
inline_plan: "执行 audit 验收流程",
|
|
285
|
-
configuredAgents: ALL_AGENTS,
|
|
286
|
-
});
|
|
287
|
-
assert.equal(result.recommended_agent, "patchwarden-audit");
|
|
288
|
-
assert.equal(result.fallback, false);
|
|
289
|
-
});
|
|
290
|
-
|
|
291
|
-
// ── 11. AGENT_ROUTING_RULES 常量结构断言 ────────────────────────
|
|
292
|
-
|
|
293
|
-
it("AGENT_ROUTING_RULES 导出完整路由规则结构", () => {
|
|
294
|
-
assert.equal(AGENT_ROUTING_RULES.largeScope.agent, "opencode");
|
|
295
|
-
assert.equal(AGENT_ROUTING_RULES.largeScope.threshold, 10);
|
|
296
|
-
|
|
297
|
-
assert.equal(AGENT_ROUTING_RULES.singleFile.agent, "patchwarden-direct");
|
|
298
|
-
|
|
299
|
-
assert.equal(AGENT_ROUTING_RULES.audit.agent, "patchwarden-audit");
|
|
300
|
-
assert.ok(AGENT_ROUTING_RULES.audit.keywords.includes("审计"));
|
|
301
|
-
assert.ok(AGENT_ROUTING_RULES.audit.keywords.includes("audit"));
|
|
302
|
-
assert.ok(AGENT_ROUTING_RULES.audit.keywords.includes("验收"));
|
|
303
|
-
assert.ok(AGENT_ROUTING_RULES.audit.keywords.includes("verify"));
|
|
304
|
-
|
|
305
|
-
assert.equal(AGENT_ROUTING_RULES.refactor.agent, "codex");
|
|
306
|
-
assert.ok(AGENT_ROUTING_RULES.refactor.keywords.includes("重构"));
|
|
307
|
-
assert.ok(AGENT_ROUTING_RULES.refactor.keywords.includes("refactor"));
|
|
308
|
-
assert.ok(AGENT_ROUTING_RULES.refactor.keywords.includes("跨模块"));
|
|
309
|
-
assert.ok(AGENT_ROUTING_RULES.refactor.keywords.includes("redesign"));
|
|
310
|
-
|
|
311
|
-
assert.equal(AGENT_ROUTING_RULES.documentation.agent, "claude");
|
|
312
|
-
assert.equal(AGENT_ROUTING_RULES.documentation.fallbackAgent, "opencode");
|
|
313
|
-
assert.ok(AGENT_ROUTING_RULES.documentation.keywords.includes("文档"));
|
|
314
|
-
assert.ok(AGENT_ROUTING_RULES.documentation.keywords.includes("readme"));
|
|
315
|
-
assert.ok(AGENT_ROUTING_RULES.documentation.keywords.includes("changelog"));
|
|
316
|
-
assert.ok(AGENT_ROUTING_RULES.documentation.keywords.includes("doc"));
|
|
317
|
-
});
|
|
318
|
-
|
|
319
|
-
// ── 12. scope 边界值测试 ────────────────────────────────────────
|
|
320
|
-
|
|
321
|
-
it("scope 正好 10 个文件(threshold 边界)→ 不触发 large scope 规则", () => {
|
|
322
|
-
// threshold 是 10,> 10 才触发,所以 10 个文件不触发规则1
|
|
323
|
-
const result = routeAgent({
|
|
324
|
-
goal: "普通任务",
|
|
325
|
-
scope: scopeFiles(10),
|
|
326
|
-
configuredAgents: ALL_AGENTS,
|
|
327
|
-
});
|
|
328
|
-
// 10 个文件不触发规则1,也不触发规则2(不是1个),无关键词 → fallback
|
|
329
|
-
assert.equal(result.fallback, true);
|
|
330
|
-
assert.equal(result.recommended_agent, ALL_AGENTS[0]);
|
|
331
|
-
});
|
|
332
|
-
|
|
333
|
-
it("scope 正好 11 个文件 → 触发 large scope 规则", () => {
|
|
334
|
-
const result = routeAgent({
|
|
335
|
-
goal: "普通任务",
|
|
336
|
-
scope: scopeFiles(11),
|
|
337
|
-
configuredAgents: ALL_AGENTS,
|
|
338
|
-
});
|
|
339
|
-
assert.equal(result.recommended_agent, "opencode");
|
|
340
|
-
assert.equal(result.fallback, false);
|
|
341
|
-
});
|
|
342
|
-
});
|
|
@@ -1,158 +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 {
|
|
7
|
-
diagnoseAndroidBuild,
|
|
8
|
-
type AndroidBuildDiagnosticReport,
|
|
9
|
-
} from "../../tools/androidDoctor.js";
|
|
10
|
-
|
|
11
|
-
const VALID_STATUSES = ["ok", "warn", "fail", "skip"] as const;
|
|
12
|
-
|
|
13
|
-
/** Restore an env var to its original value (deleted when undefined). */
|
|
14
|
-
function restoreEnv(key: string, value: string | undefined) {
|
|
15
|
-
if (value === undefined) delete process.env[key];
|
|
16
|
-
else process.env[key] = value;
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
describe("diagnoseAndroidBuild", () => {
|
|
20
|
-
let tempDir: string;
|
|
21
|
-
let savedJavaHome: string | undefined;
|
|
22
|
-
let savedAndroidHome: string | undefined;
|
|
23
|
-
let savedAndroidSdkRoot: string | undefined;
|
|
24
|
-
|
|
25
|
-
beforeEach(() => {
|
|
26
|
-
tempDir = mkdtempSync(join(tmpdir(), "pw-android-doctor-"));
|
|
27
|
-
savedJavaHome = process.env.JAVA_HOME;
|
|
28
|
-
savedAndroidHome = process.env.ANDROID_HOME;
|
|
29
|
-
savedAndroidSdkRoot = process.env.ANDROID_SDK_ROOT;
|
|
30
|
-
});
|
|
31
|
-
|
|
32
|
-
afterEach(() => {
|
|
33
|
-
rmSync(tempDir, { recursive: true, force: true });
|
|
34
|
-
restoreEnv("JAVA_HOME", savedJavaHome);
|
|
35
|
-
restoreEnv("ANDROID_HOME", savedAndroidHome);
|
|
36
|
-
restoreEnv("ANDROID_SDK_ROOT", savedAndroidSdkRoot);
|
|
37
|
-
});
|
|
38
|
-
|
|
39
|
-
it("returns a skip result when no android_app directory exists", () => {
|
|
40
|
-
const result = diagnoseAndroidBuild(tempDir);
|
|
41
|
-
assert.equal(result.status, "skip");
|
|
42
|
-
assert.equal((result as { reason: string }).reason, "No android_app directory found");
|
|
43
|
-
});
|
|
44
|
-
|
|
45
|
-
it("returns a structured diagnostic report when android_app exists", () => {
|
|
46
|
-
const androidApp = join(tempDir, "android_app");
|
|
47
|
-
mkdirSync(join(androidApp, "app"), { recursive: true });
|
|
48
|
-
mkdirSync(join(androidApp, "gradle", "wrapper"), { recursive: true });
|
|
49
|
-
writeFileSync(join(androidApp, "gradlew"), "#!/bin/sh\necho gradle\n");
|
|
50
|
-
writeFileSync(join(androidApp, "settings.gradle.kts"), 'pluginManagement { repositories { google() } }\n');
|
|
51
|
-
writeFileSync(join(androidApp, "app", "build.gradle.kts"), 'plugins { id("com.android.application") }\n');
|
|
52
|
-
writeFileSync(
|
|
53
|
-
join(androidApp, "gradle", "wrapper", "gradle-wrapper.properties"),
|
|
54
|
-
"distributionUrl=https://services.gradle.org/distributions/gradle-8.5-bin.zip\n",
|
|
55
|
-
);
|
|
56
|
-
|
|
57
|
-
// Make SDK-related checks deterministic regardless of the host environment.
|
|
58
|
-
delete process.env.ANDROID_HOME;
|
|
59
|
-
delete process.env.ANDROID_SDK_ROOT;
|
|
60
|
-
|
|
61
|
-
const result = diagnoseAndroidBuild(tempDir);
|
|
62
|
-
assert.notEqual(result.status, "skip");
|
|
63
|
-
const report = result as AndroidBuildDiagnosticReport;
|
|
64
|
-
|
|
65
|
-
assert.equal(report.repo_path, tempDir);
|
|
66
|
-
assert.equal(report.android_app_path, join(tempDir, "android_app"));
|
|
67
|
-
assert.ok(Array.isArray(report.checks));
|
|
68
|
-
assert.equal(report.checks.length, 10);
|
|
69
|
-
|
|
70
|
-
for (const item of report.checks) {
|
|
71
|
-
assert.equal(typeof item.check, "string");
|
|
72
|
-
assert.ok(item.check.length > 0);
|
|
73
|
-
assert.ok((VALID_STATUSES as readonly string[]).includes(item.status));
|
|
74
|
-
assert.equal(typeof item.reason, "string");
|
|
75
|
-
assert.equal(typeof item.suggested_fix, "string");
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
// Overall status follows the fail > warn > ok precedence.
|
|
79
|
-
const hasFail = report.checks.some((c) => c.status === "fail");
|
|
80
|
-
const hasWarn = report.checks.some((c) => c.status === "warn");
|
|
81
|
-
const expected = hasFail ? "fail" : hasWarn ? "warn" : "ok";
|
|
82
|
-
assert.equal(report.status, expected);
|
|
83
|
-
|
|
84
|
-
// The expected check names are all present.
|
|
85
|
-
const checkNames = report.checks.map((c) => c.check);
|
|
86
|
-
assert.ok(checkNames.includes("java -version"));
|
|
87
|
-
assert.ok(checkNames.includes("JAVA_HOME"));
|
|
88
|
-
assert.ok(checkNames.includes("ANDROID_HOME"));
|
|
89
|
-
assert.ok(checkNames.includes("ANDROID_SDK_ROOT"));
|
|
90
|
-
assert.ok(checkNames.includes("Android SDK platform"));
|
|
91
|
-
assert.ok(checkNames.includes("Android build-tools"));
|
|
92
|
-
assert.ok(checkNames.includes("Gradle wrapper"));
|
|
93
|
-
assert.ok(checkNames.includes("android_app/settings.gradle.kts"));
|
|
94
|
-
assert.ok(checkNames.includes("android_app/app/build.gradle.kts"));
|
|
95
|
-
assert.ok(checkNames.includes("APK output path"));
|
|
96
|
-
|
|
97
|
-
// Files we created should be detected as ok.
|
|
98
|
-
const gradleCheck = report.checks.find((c) => c.check === "Gradle wrapper");
|
|
99
|
-
assert.equal(gradleCheck?.status, "ok");
|
|
100
|
-
|
|
101
|
-
const settingsCheck = report.checks.find((c) => c.check === "android_app/settings.gradle.kts");
|
|
102
|
-
assert.equal(settingsCheck?.status, "ok");
|
|
103
|
-
|
|
104
|
-
const appBuildCheck = report.checks.find((c) => c.check === "android_app/app/build.gradle.kts");
|
|
105
|
-
assert.equal(appBuildCheck?.status, "ok");
|
|
106
|
-
});
|
|
107
|
-
|
|
108
|
-
it("reports a missing JAVA_HOME as warn or fail", () => {
|
|
109
|
-
const androidApp = join(tempDir, "android_app");
|
|
110
|
-
mkdirSync(androidApp, { recursive: true });
|
|
111
|
-
|
|
112
|
-
delete process.env.JAVA_HOME;
|
|
113
|
-
delete process.env.ANDROID_HOME;
|
|
114
|
-
delete process.env.ANDROID_SDK_ROOT;
|
|
115
|
-
|
|
116
|
-
const result = diagnoseAndroidBuild(tempDir);
|
|
117
|
-
const report = result as AndroidBuildDiagnosticReport;
|
|
118
|
-
const javaHomeCheck = report.checks.find((c) => c.check === "JAVA_HOME");
|
|
119
|
-
assert.ok(javaHomeCheck, "JAVA_HOME check should exist");
|
|
120
|
-
assert.ok(
|
|
121
|
-
javaHomeCheck!.status === "warn" || javaHomeCheck!.status === "fail",
|
|
122
|
-
`expected warn or fail, got ${javaHomeCheck!.status}`,
|
|
123
|
-
);
|
|
124
|
-
});
|
|
125
|
-
|
|
126
|
-
it("reports a missing ANDROID_HOME as fail with the SDK-missing message", () => {
|
|
127
|
-
const androidApp = join(tempDir, "android_app");
|
|
128
|
-
mkdirSync(androidApp, { recursive: true });
|
|
129
|
-
|
|
130
|
-
delete process.env.ANDROID_HOME;
|
|
131
|
-
delete process.env.ANDROID_SDK_ROOT;
|
|
132
|
-
|
|
133
|
-
const result = diagnoseAndroidBuild(tempDir);
|
|
134
|
-
const report = result as AndroidBuildDiagnosticReport;
|
|
135
|
-
const androidHomeCheck = report.checks.find((c) => c.check === "ANDROID_HOME");
|
|
136
|
-
assert.ok(androidHomeCheck, "ANDROID_HOME check should exist");
|
|
137
|
-
assert.equal(androidHomeCheck!.status, "fail");
|
|
138
|
-
assert.ok(
|
|
139
|
-
androidHomeCheck!.reason.includes(
|
|
140
|
-
"Android project exists, APK not built because Android SDK is missing.",
|
|
141
|
-
),
|
|
142
|
-
`reason should mention the SDK-missing sentence, got: ${androidHomeCheck!.reason}`,
|
|
143
|
-
);
|
|
144
|
-
|
|
145
|
-
// With the SDK missing, the overall status must be fail.
|
|
146
|
-
assert.equal(report.status, "fail");
|
|
147
|
-
|
|
148
|
-
// The APK output check should also carry the SDK-missing reason and be skipped.
|
|
149
|
-
const apkCheck = report.checks.find((c) => c.check === "APK output path");
|
|
150
|
-
assert.ok(apkCheck, "APK output path check should exist");
|
|
151
|
-
assert.equal(apkCheck!.status, "skip");
|
|
152
|
-
assert.ok(
|
|
153
|
-
apkCheck!.reason.includes(
|
|
154
|
-
"Android project exists, APK not built because Android SDK is missing.",
|
|
155
|
-
),
|
|
156
|
-
);
|
|
157
|
-
});
|
|
158
|
-
});
|