promote to main (1/4): text/vector search window scan (fork #59)

[trentleslie]

Stacked promotion dev→main, 1 of 4 (mirroring the org promote PRs #90–93). Merge in order; each is the validated code already on org dev.

This PR (#59 port)

Kestrel text/vector search scans the ranked window for the first on-category candidate instead of committing/refusing on rank-1 alone (restores commits the old limit=1 path dropped; the category guard still refuses when nothing in the window is on-category).

Series

1. Handle accidental double colons in input curies #59 — text/vector window scan ← this PR
2. Dockerize Biomapper2 #60 — structure-guided re-resolution of conflated commits
3. Implement retry loop for API startup wait #64/PR: Return equivalent IDs from KG nodes - Feat/equivalent ids #67/PR: feat: Dynamic entity types and vocabulary presets from Kestrel #68/feat: HGNC human-preference re-ranking for gene/protein resolution #69/feat: gene/protein resolution — HGNC human-preference + curated gene-symbol fallback (dev → main) #70 — determinism stack (matches org promote: resolution-determinism stack (fork #64/#67/#68/#69/#70) #92)
4. feat: curated gene-symbol fallback resolver for drug-conflated human genes #71/feat: canonical-namespace preference + gene gold-set fix (unblocks release CI) #72 — RefMet fallback toggle + candidate_limit (matches org promote: RefMet live-api-fallback toggle + candidate_limit (fork #71 + #72) #93)

All four are already merged + validated on org dev (this is dev→main). No studies/. Org CI gate runs on each. No RefMet freeze is configured in prod — the freeze consumer code is inert unless REFMET_SNAPSHOT_PATH is set.

🤖 Generated with Claude Code