diff_docs
Compare two documents opened with load_doc to get change counts and the first 25 changes; use keySpec to align arrays by identity so reordered items aren't reported as wholesale changes.
Instructions
Compare two documents opened with load_doc and return change counts plus the first 25 changes. There is no filePath shortcut: load both first. docIdA is the older side: additions and removals read A → B. Give keySpec to align arrays by identity (e.g. "id,orderId") so reordered elements are not reported as wholesale changes.
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": {
"docIdA": "<docIdA>",
"docIdB": "<docIdB>"
},
"name": "diff_docs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| docIdA | Yes | The baseline (older) document. | |
| docIdB | Yes | The current (newer) document. | |
| keySpec | No | Comma-separated candidate identity keys for array alignment, e.g. "id,taskId". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| hint | No | ||
| tool | Yes | ||
| error | No | ||
| evicted | No | ||
| structuredTruncated | No |