Diff two eCFR issue dates
diff_issuesCompares Title 38 citations between two eCFR issue dates to identify which provisions changed, were added, or removed.
Instructions
Provision-level diff of Title 38 between two eCFR issue dates: which citations changed, which were added, and which were removed between from_date and to_date (both YYYY-MM-DD, both required — this tool has no default-to; for "what changed since my index was built" run cfr-free diff <from> locally, which resolves to from the index issue date). Fetched from eCFR on demand: both dates' full-title XML is hashed per citation on the fly — there is no local index for a point-in-time diff; a short-lived in-memory memo may serve a document this process fetched moments ago, and concurrent readers of the same date share one fetch. Each citation list is capped at 100 entries; truncated: true means at least one list was cut. Identical dates or an impossible calendar date (e.g. month 13) are rejected as errors before any fetch.
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": {
"from_date": "<from_date>",
"to_date": "<to_date>"
},
"name": "diff_issues"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to_date | Yes | eCFR issue date, YYYY-MM-DD | |
| from_date | Yes | eCFR issue date, YYYY-MM-DD |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| added | Yes | citations added at the to-date — capped at 100 | |
| notice | Yes | the limit on what the two dates mean: eCFR serves the revision in force on the requested date and does not report which issue date that is, so the dates are selectors and not a stamp of the revision served | |
| changed | Yes | citations whose content changed — text or heading — capped at 100 | |
| removed | Yes | citations removed by the to-date — capped at 100 | |
| truncated | Yes | true when any citation list was cut at the 100-citation cap | |
| toIssueDate | Yes | ||
| fromIssueDate | Yes |