Reconcile durable facts against live state, then rank the day (deterministic)
reconcile_and_rankReconciles keyed brain facts with live task state, then ranks the day in one deterministic pass. Returns the recomputed plan, applied overrides, and unresolved conflicts for user review.
Instructions
Use this INSTEAD of rank_day when a durable brain fact might override live task state — it reconciles then ranks in one deterministic pass, so nothing relies on you remembering to reconcile. Pass the same inputs as rank_day (tasks/events/busy/now/timezone) PLUS overrides: keyed brain claims (each entityKey like todoist:task:<id>, a field such as priority or due, its brain value, slotType = intent when the brain is authoritative (a deliberate override) or state when it's just a remembered value, plus the fact's at/sourceClass). Returns {plan, applied, flags}: plan is the recomputed daily plan (built FROM the reconciled values); applied lists overrides that won and changed the plan (mention them to the user); flags are genuine contradictions the code would not auto-resolve — ASK the user about each, don't guess. Unkeyed prose facts are not reconcilable here (by design) — leave them out of overrides.
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": {
"tasks": "<tasks>",
"events": "<events>",
"now": "<now>",
"timezone": "<timezone>"
},
"name": "reconcile_and_rank"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| now | Yes | Current instant (RFC3339), e.g. from get-current-time. | |
| busy | No | Optional busy intervals (e.g. from get-freebusy), ISO 8601. | |
| tasks | Yes | Todoist tasks to rank (same shape as rank_day). | |
| events | Yes | Fixed calendar events for the day. | |
| timezone | Yes | IANA timezone, e.g. America/New_York. | |
| overrides | No | Keyed brain claims that may override a live task field before ranking. Usually empty. |