docs: surface MCP-on-CRDT + vector/hybrid search on README, comparison, docs (SPEC-303)#45
Merged
Merged
Conversation
New guide covering HNSW ANN, RRF tri-hybrid fusion, HybridSearchMethod
('exact'|'fullText'|'semantic'), embedding providers (Ollama /
OpenAI-compatible), server-side VectorConfig, useHybridSearch /
useVectorSearch / useHybridSearchSubscribe hooks, client.hybridSearch /
client.vectorSearch methods, and real-time delta subscriptions.
Links existing reference pages; cross-links search-and-live-queries and
mcp-server guides.
…eatures Adds two new Key Features bullets: - AI-native: MCP agent access via @topgunbuild/mcp-server - Hybrid search: real-time exact + BM25 + semantic vector, RRF-fused, with HNSW, embeddings, RAG, and live subscriptions mentioned for SEO Also adds a useHybridSearch React snippet after the todo example, with a server-config pointer (VectorConfig / TOPGUN_VECTOR_INDEX_PATH framed as server-side). No invented symbols; no SearchMethod.
Adds two new differentiator rows to the comparison table (8 td cells each: Feature + TopGun + 6 competitor columns). Competitor claims are factually conservative — 'Not Supported' used only where the feature is absent from the sync/realtime path; neutral language used for partial support. Adds matching Why-TopGun bullets for AI agents and hybrid search. Verified 2026-06-10 comment added per page convention.
…bar Guides
Adds SubItem entries in the Guides section for:
- /docs/guides/vector-and-hybrid-search (new page from G1)
- /docs/guides/mcp-server (existing page, previously only narrative-linked)
Both paths fall through to the existing pathname.startsWith('/docs/guides/')
branch in getInitialExpandedSection — no resourceGuidePaths conflict.
pnpm --filter apps-docs-astro build confirms both pages compile and emit.
Auto-generated by apps/docs-astro/scripts/build-llms-full.mjs during the docs build; reflects the comparison.mdx AI-agents and hybrid-search rows added in SPEC-303.
Deploying topgun with
|
| Latest commit: |
9a434b5
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://b1483df2.topgun-f45.pages.dev |
| Branch Preview URL: | https://sf-450-track-c-visibility.topgun-f45.pages.dev |
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.
Summary
SPEC-303 (from TODO-450) — surface TopGun's two differentiators on the discovery surfaces
a person reads before adopting. They shipped but were invisible on README / comparison / docs nav
(API reference already covered them).
Changes (docs/marketing only — additive)
outcome-first per CLAUDE.md positioning.
over MCP; real-time hybrid search (full-text + vector + exact, RRF-fused, live subscriptions).
providers,
VectorConfig,SearchMethod, hooks, real-time deltas); links existing referencepages, no duplication.
Runnable Track-C demo is intentionally out of scope (carved to TODO-454, depends on this pass).
Verification
Reviewed via the SpecFlow impl-review gate. Docs-only/additive; CI gates: Build · Test · Lint
(DocsSidebar.tsx is the only
.tsx) + docs-astro build + Cloudflare Pages.