docs(website): add v0.9.0 release notes, update homepage and troubleshooting

- Add Antfly troubleshooting section (server not running, port conflicts, old data)
- Update homepage diagram (Vector DB → Antfly hybrid search)
- Update latest-version.ts to v0.9.0
- Add full v0.9.0 release notes to updates page
- Update "clear everything" quick fix to use dev setup

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: prosdev

website/content/docs/troubleshooting.mdx

@@ -126,14 +126,51 @@ gh auth login
 dev github index  # Re-index
 ```
 
+## Antfly Issues
+
+### Antfly server not running
+
+If you see `Failed to initialize Antfly store` or `fetch failed`:
+
+```bash
+# Run setup (starts the server via Docker or native)
+dev setup
+
+# Or start manually
+antfly swarm
+```
+
+### Port conflict on startup
+
+Antfly uses port 18080 (Docker) or 8080 (native). If another service is using that port:
+
+```bash
+# Check what's using the port
+lsof -i :18080
+
+# Use a custom port via environment variable
+ANTFLY_URL=http://localhost:19090/api/v1 dev index .
+```
+
+### Old LanceDB data
+
+If you're upgrading from a previous version that used LanceDB:
+
+```bash
+# Old indexes are not compatible — re-index with Antfly
+dev index . --force
+
+# Optionally clean up old LanceDB data
+rm -rf ~/.dev-agent/indexes/*/vectors*
+```
+
 ## Quick Fixes
 
 ### Clear everything and start fresh
 
 ```bash
-rm -rf ~/.dev-agent/indexes/*
-dev index .
-dev github index
+dev setup              # Ensure Antfly is running
+dev index . --force    # Re-index from scratch
 dev mcp install --cursor
 ```
 

website/content/index.mdx

@@ -134,24 +134,24 @@ flowchart LR
     subgraph IDE["Your AI Tool"]
         A["Cursor / Claude Code"]
     end
-    
+
     subgraph Agent["dev-agent"]
         B["MCP Server"]
         C["9 Tools"]
     end
-    
-    subgraph Local["Local Storage"]
-        D["Vector DB"]
-        E["Embeddings"]
+
+    subgraph Local["Antfly (local)"]
+        D["Hybrid Search"]
+        E["BM25 + Vector + RRF"]
     end
-    
+
     A <-->|"MCP Protocol"| B
     B --> C
     C <--> D
     D <--> E
 ```
 
-**Key insight:** dev-agent returns **code snippets with context** — Claude doesn't read entire files. This is why input tokens drop by 99%.
+**Key insight:** dev-agent returns **code snippets with context** using hybrid search (keyword matching + semantic understanding) — Claude doesn't read entire files. This is why input tokens drop by 99%.
 
 ## Quick Start
 

website/content/latest-version.ts

@@ -4,10 +4,10 @@
  */
 
 export const latestVersion = {
-  version: '0.8.5',
-  title: 'Enhanced Pattern Analysis & Performance',
-  date: 'December 14, 2025',
+  version: '0.9.0',
+  title: 'Antfly Hybrid Search',
+  date: 'March 29, 2026',
   summary:
-    'Refactored dev_inspect with 5-10x faster pattern analysis, comprehensive code comparison across 5 pattern categories, and improved semantic search accuracy.',
-  link: '/updates#v085--enhanced-pattern-analysis--performance',
+    'Replaced LanceDB with Antfly — dev_search now uses hybrid search (BM25 + vector + RRF). New `dev setup` command handles backend installation.',
+  link: '/updates#v090--antfly-hybrid-search',
 } as const;

website/content/updates/index.mdx

@@ -9,6 +9,64 @@ What's new in dev-agent. We ship improvements regularly to help AI assistants un
 
 ---
 
+## v0.9.0 — Antfly Hybrid Search
+
+*March 29, 2026*
+
+**Replaced LanceDB + @xenova/transformers with [Antfly](https://antfly.io) — a major upgrade to search quality and architecture.**
+
+### What's Changed
+
+**🔍 Hybrid Search (BM25 + Vector + RRF)**
+
+`dev_search` now combines keyword matching and semantic understanding in every query. Searching for "validateUser" finds the exact function (BM25) AND semantically related authentication code (vector), fused into one ranked result set via Reciprocal Rank Fusion.
+
+**⚡ New: `dev setup` Command**
+
+One command handles the entire search backend:
+
+```bash
+dev setup
+```
+
+- Docker-first: pulls the Antfly image, starts a container
+- Native fallback: detects or installs the Antfly binary, pulls the embedding model
+- Auto-start: all commands (`dev index`, `dev mcp start`) auto-start Antfly if needed
+
+**🧠 Auto-Embedding via Termite**
+
+No more managing an embedding pipeline. Antfly generates embeddings locally via Termite (ONNX-optimized models). Insert documents, search immediately — Antfly handles the rest.
+
+**🔑 Direct Key Lookup**
+
+Document retrieval by ID is now instant via `tables.lookup()`, replacing the previous O(n) zero-vector scan workaround.
+
+### Architecture
+
+```
+Before: Scanner → @xenova/transformers (embed) → LanceDB (store) → vector search
+After:  Scanner → Antfly (embed + store + hybrid search)
+```
+
+- Removed ~1,400 lines of vector plumbing code
+- `@lancedb/lancedb` and `@xenova/transformers` fully removed
+- `@antfly/sdk` added as the sole search dependency
+- VectorStorage facade preserved — all consumers unchanged
+
+### Breaking Changes
+
+- **Requires Antfly server.** Run `dev setup` (one-time) to install and start.
+- **Existing LanceDB indexes are not migrated.** Run `dev index . --force` to rebuild with Antfly.
+- **Default port changed to 18080** to avoid conflicts with common dev servers on 8080.
+
+### Testing
+
+- 1,935 tests passing, 0 failures
+- 20 new AntflyVectorStore integration tests (insert, upsert, hybrid search, delete, count, model mismatch detection)
+- VectorStorage mock for tests that don't need a live server
+
+---
+
 ## v0.8.5 — Enhanced Pattern Analysis & Performance
 
 *December 14, 2025*