Skip to content

docs: sweep stale semantic-only wording after hybrid search_notes#54

Merged
AlexMost merged 1 commit into
mainfrom
docs/hybrid-search-doc-sweep
Jul 6, 2026
Merged

docs: sweep stale semantic-only wording after hybrid search_notes#54
AlexMost merged 1 commit into
mainfrom
docs/hybrid-search-doc-sweep

Conversation

@AlexMost

@AlexMost AlexMost commented Jul 6, 2026

Copy link
Copy Markdown
Owner

Що це

Documentation-only sweep після мержу #53 (hybrid search_notes). Гайди (docs/guide/) і parameter dictionary були оновлені в самій зміні, але README і три architecture-доки лишилися з семантика-only формулюваннями.

Зміни

README.md

  • Буліти «Why» і таблиця «Two superpowers» тепер описують обидві ноги (semantic + lexical), а не лише embeddings; згадано осі mode/effort
  • Секцію «🔍 Hybrid search: scope semantic with structural filters» перейменовано на «Pre-filter: …» — слово hybrid тепер означає semantic+lexical ноги і конфліктувало зі старим значенням (semantic+filter)
  • Уточнено: filter ріже обидві ноги, threshold — лише семантичну
  • Multi-vault: vault без Smart Connections індексу більше не скіпається search_notes fan-out-ом — він віддає lexical_matches; SEMANTIC_INDEX_NOT_FOUND лишається тільки для embeddings-only тулів

docs/README.md — мапа гайду посилалась на сторінки, яких більше немає («semantic search, vault operations» → finding-notes / reading-and-modifying / routing)

docs/architecture/retrieval-policy.md — виправлено застарілий шлях src/retrieval-policy.ts; scope-нотатка, що док покриває лише семантичну ногу (лінк на lexical-search.md); пояснено мапінг tool-level effort → внутрішній mode

docs/architecture/module-structure.md — семантичний модуль хостить гібридний search_notes; лексичний індекс доданий у діаграму; зазначено, що --no-semantic прибирає і лексичну ногу

docs/architecture/fan-out.md — зафіксовано, що жоден тул більше не продукує skipped_vaults (search_notes перейшов на runFanOut по всіх vault-ах)

Перевірки

npm test (758 passed) · npm run lint · npm run typecheck — green

🤖 Generated with Claude Code

The hybrid-search-notes change updated docs/guide/ and the parameter
dictionary but missed README marketing copy and three architecture docs:

- README: reframe search bullets/table around both legs; retitle the
  filter section ("hybrid" now means semantic+lexical, not
  semantic+filter); filter cuts both legs; multi-vault bullet — vaults
  without a corpus are no longer skipped by search_notes fan-out
- docs/README.md: guide map named pages that no longer exist
- retrieval-policy.md: fix moved source path, scope the doc to the
  semantic leg, map tool-level effort onto internal mode
- module-structure.md: semantic module hosts hybrid search_notes;
  lexical index in diagram; --no-semantic drops the lexical leg too
- fan-out.md: no shipped tool produces skipped_vaults anymore

Co-Authored-By: Claude Fable 5 <[email protected]>
@AlexMost
AlexMost merged commit 463a240 into main Jul 6, 2026
2 checks passed
@AlexMost
AlexMost deleted the docs/hybrid-search-doc-sweep branch July 6, 2026 10:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant