update_explanation
Change an explanation's title, body, or location. Provide a new location to check against the diff, making outdated explanations current; rewrite the body if code changed.
Instructions
Change one explanation: title, body or location. A new location (path and start_line, with side for removed code) is checked against the diff and makes an outdated explanation current again; rewrite the body too when the code changed.
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": {
"analysis_id": "<analysis_id>",
"explanation_id": "<explanation_id>"
},
"name": "update_explanation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | What the code does (inputs, outputs, effects), then how it works, step by step in the order of the code. Describe, never judge. Plain text; line breaks are kept. | |
| path | No | Path of a changed file of the analysis, relative to the repository root, as listed by get_diff. | |
| side | No | Side of the diff the lines belong to (default "new"): "new" for added or kept code, with NEW-side numbers (second column of get_diff); "old" for removed code, with OLD-side numbers (first column of get_diff), all shown in the diff and at least one removed. | |
| title | No | New title. | |
| end_line | No | Last described line, inclusive (default: start_line). | |
| start_line | No | First described line, on the side given by side. | |
| analysis_id | Yes | Id of the analysis, as returned by create_analysis or list_analyses. | |
| explanation_id | Yes | Id of the explanation, as shown by get_analysis. |