plan_fixes
Plans verified dependency fixes that close a uv or Poetry project's action alerts on a temporary copy, returning a diff, lock command, version moves, and remaining alerts.
Instructions
Work out the change that closes a project's action alerts and check it with the project's own resolver (uv lock --dry-run, or Poetry) on a temporary copy. Returns the requirement edits as a unified diff, the lock command to run, every version the lock moves (downgrades included), the alerts left out and why, and whether raising requires-python would unblock more fixes. Use it after triage_alerts reports action alerts; only uv and Poetry projects get a plan (for others it explains why there is none). Read-only: never edits or relocks the project; show the user the plan and apply the diff only when they agree. Needs network access, and resolving can build source distributions and take a few minutes on large projects.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "plan_fixes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute path of the project folder: the one holding pyproject.toml, uv.lock, poetry.lock, requirements*.txt or package.json. | |
| include_filtered | No | Also plan fixes for filtered alerts (dev-only, test-only...). They need no action, but Dependabot keeps them open until the package moves. | |
| raise_python_floor | No | uv projects: when a fix needs a newer Python than requires-python allows, raise requires-python in the plan (checked with the resolver). This drops support for older Pythons: ask the user first. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | false when no plan could be made; see error. | |
| diff | No | Unified diff of the requirement edits; null when none are needed. | |
| hint | No | Set when raise_python_floor=true would let more fixes in. | |
| plan | No | The plan: status, tool (uv or poetry), command, note, included (packages the plan fixes, with target versions and edits), left_out (with why), lock_changes (from/to) and python_floor. | |
| error | No | ||
| notes | No | ||
| applied | No | Always false: the project is never changed. | |
| details | No | The end of depquiet's stderr. | |
| project | No | ||
| pull_request_description | No | The plan as Markdown, ready for a PR body. |