Expand description
asd references <name> — exact-symbol reference search with rg parity.
ASD’s index stores one row per symbol definition; it does not index
per-occurrence call sites or text references. For literal “find every line
that mentions this identifier” queries (the rg use case) we shell out to
rg --json --fixed-strings --word-regexp <name>. We then merge the
definition record(s) from the index so the caller gets both:
definitions: canonical Symbol records (with effects/ledger context)occurrences: every literal text occurrence in the worktree
This is intentionally precision-over-recall: no tokenization, no CamelCase
splitting, no BM25 reranking. If rg is not on PATH, returns an error
pointing the user at installation — we do not silently degrade to a slower
Rust walker (Plan B may add a native fallback).
See Plan A, t-004.