docs(search): rewrite the search architecture page as "How search works" - #51
Merged
Merged
Conversation
SR-8 splits search docs into four parts; this page is the fourth, the technical one, and lives once on the site. It described cli-messaging 0.140.0 and was stale against 0.148.2: file, type, size and tag fields exist; the stem index is stored but strict matching does not use it yet; conversation search answers by words when no model is downloaded; the coverage fields carry real values. Added: messages stats and query history, related, status and freshness (stale results, deleted text purged from vectors, bounded catch-up), worker and thread allocation, and the 100k-message measurements with their hardware. Source links now point at v0.148.2. Same slug and diagrams, in English, Russian and Spanish. STRUCTURE.md lists the three search pages each tool now has. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Task
SR-8 (search stream): search docs in four parts, owner's request of 2026-10-05. Part 4, the technical page, lives once on the site.
Why
search-architecturedescribed cli-messaging 0.140.0 and was wrong against 0.148.2: it said file name/type/size and tag fields were not implemented, stems were only planned, conversation search could not run without a model, and coverage fields were alwaysfalse/null.What
search-architecture{,.ru,.es}.mdx→ "How search works" / «Как устроен поиск» / «Cómo funciona la búsqueda». Same slug and diagrams.messages statsand query history,related,statusand freshness (stale results, deleted text purged from vectors, bounded catch-up), worker/thread allocation, and the 100k-message measurements with hardware. Source links pinned tov0.148.2.docsReftags (search.md,archive.md);tools.jsonuntouched. The CLIs' newtopic-search.mdandquery-language.mdreach the site when the release coordinator bumpsdocsRef.search-playgroundpages: link text follows the new title.docs/STRUCTURE.md: listssearch.md,topic-search.md,query-language.md.content:,attachments extract) — merged in cli-messaging after 0.148.2, not in either CLI yet.Testing
pnpm lint && pnpm typecheck && pnpm test && pnpm build && pnpm check:links && pnpm check:seo— all pass.🤖 Generated with Claude Code