search_decisions
Read-onlyIdempotent
Search past decisions using keyword matching to recall prior resolutions across sessions, roadmaps, and projects.
Instructions
Search past decisions across sessions and roadmap phases. Keyword search over an FTS5/BM25 index (Porter-stemmed) — NO semantic/vector matching, so recall depends on sharing keywords with the stored decision; for a concept with no shared words, browse list_decisions or list_tags instead. Default (E1): summary-first rows — {id, decision (one-line ≤140), file_path, do_not_revert, tags, score}, dropping per-row snippet/origin. Pass full=true for untruncated rows, expand(ids=[...]) to fetch specific decisions in full, or summary_only=true for a ~70%-smaller {id, summary, score} payload. Answers 'has anyone decided this before?'
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | Return untruncated decision text (default false) | |
| limit | No | Max results (default 5, max 20) | |
| query | Yes | Keywords to search (e.g. 'threshold', 'uuid', 'retry') | |
| session_id | No | Optional — filter to a specific session | |
| all_projects | No | v3.6.0: search EVERY registered project's decisions, not just the current one. Each result gains `project` + `project_path`. Use to recall how you solved something in another repo. Default false. | |
| summary_only | No | v2.1.2 Item 28: return id+summary+score only (smallest payload) |