findlisted

# /find — smart search for a name or company by SPELLING > 🧒 **When reporting to a non-technical operator:** end with a child-simple "In plain words" recap in their language. Deterministic, 0 tokens — **NOT RAG**. Embeddings do not understand mangled spellings, typos or a wrong keyboard layout; that is caught by separate code using phonetic fingerprints + fuzzy comparison. For search by MEANING use `/ask`, not this. ## When to come here "find Viktor" · "all the Viktors" · "find the company Merlion" · "who is <name>" · wrong-layout gibberish / typos / transliteration — any PERSON, lead, contact or COMPANY name in any spelling. ## Run (ALWAYS with `PYTHONUTF8=1` — otherwise a cp1252 crash on the Windows console) `PYTHONUTF8=1 python "$IMPORTS_ROOT/namesearch/find_name.py" <name> [--html] [--all]` - by default: leads + people + companies + Apple contacts (vault note titles hidden) - `--all` — also include the note titles of the whole vault - `--html` — a visual dashboard in `_Dashboards\Name-Search-*.html` (the operator works visually — offer it for long lists) A name written in its native script produces a clean query; a wrong-layout or typo'd query is expanded automatically. ## Neighbours - `expand_query.py <word> [--grep] [--line]` — expand a word into every spelling, for grepping the vault or feeding into `/ask` (the RAG hook). - The `names.db` index is rebuilt by a weekly task (and manually via `name_index.py --vault`). If something is missing right after a big impor