find_decisions
Retrieve structured decision records from a channel, including rationale and rejected alternatives. Understand what the team decided and why.
Instructions
List the DECISIONS recorded in one channel, each with its rationale and
rejected alternatives. Call it to answer "what did the team decide and
why" when you want the structured decision record, not free-text facts.
Returns a bare LIST and collapses missing-auth, access-denied, and
internal errors into an EMPTY LIST — so [] means either no decisions
OR no access; it never returns a structured error object and never raises.
Disambiguation among the decision tools: use find_decisions for the current decision RECORDS in one channel (with rationale + alternatives_rejected). Use trace_decision_history to follow how one decision SUPERSEDED earlier ones over time (a graph timeline). Prefer find_decisions over find_facts(fact_type='decision') because only this tool enriches each result with rationale and alternatives.
Prerequisites: a channel_id from list_channels.
Returns (instant, read-only): a LIST (not a dict) of decisions sorted by
decided_at descending, each {fact_id, decision (first sentence), decided_by, decided_at (YYYY-MM-DD), rationale (null if not yet extracted), alternatives_rejected, page_slug (empty if no host page yet)}.
No side effects.
Error handling: on missing auth, access denial, or internal error this
tool returns an EMPTY LIST [] rather than an error object (it never
raises). An empty list therefore means either no decisions or no access —
confirm access with list_channels if unexpected.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel_id | Yes | Channel id. Get it from list_channels (e.g. 'ch-eng'). Required. | |
| since | No | Optional ISO-8601 date prefix (e.g. '2026-04-01'); keeps only decisions on or after this date. Omit for all dates. Default null. | |
| author | No | Optional exact-match author name (e.g. 'Alice Chen'). Omit for any author. Default null. | |
| limit | No | Max decisions to return, 1-100 (out-of-range values are clamped). Default 50. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |