docs: audit + launch prep — fix embedding model, expand CLI previews

- capabilities.md: fix CRITICAL bug — default embedding is bge-small-en-v1.5,
  not Granite (Granite is opt-in via EMBEDDING_MODEL env var)
- README: add metadata, refs, cycles CLI preview boxes (real output)
- README: add EMBEDDING_MODEL config row
- README: fix markup typo in VS Code snippet
- .gitignore: add docs/visuals.md (local-only launch notes)

Author: PatrickSys

.gitignore

@@ -20,7 +20,9 @@ nul
 .codebase-intelligence.json
 .cursor/
 .planning/*
-
+.planning-archive/*
+.codex/
 grammars/*.wasm
 
 .tmp-research-repos/
+docs/visuals.md

README.md

@@ -57,7 +57,7 @@ Add `.vscode/mcp.json` to your project root:
   "servers": {
     "codebase-context": {
       "command": "npx",
-      "args": ["-y", "codebase-context", "/path/to/your/project"] // Or "${workspaceFolder}"if your workspace is one project only
+      "args": ["-y", "codebase-context", "/path/to/your/project"] // Or "${workspaceFolder}" if your workspace is one project only
     }
   }
 }
@@ -143,6 +143,41 @@ $ npx -y codebase-context search --query "file watcher" --intent edit --limit 1
 └──────────────────────────────────────────────────────────────────────┘
 ```
 
+```text
+$ npx -y codebase-context metadata
+┌─ codebase-context [monorepo] ────────────────────────────────────────┐
+│                                                                      │
+│ Framework: Angular unknown   Architecture: mixed                     │
+│ 130 files · 24,211 lines · 1077 components                           │
+│                                                                      │
+│ Dependencies: @huggingface/transformers · @lancedb/lancedb ·         │
+│ @modelcontextprotocol/sdk · @typescript-eslint/typescript-estree ·   │
+│ chokidar · fuse.js (+14 more)                                        │
+│                                                                      │
+└──────────────────────────────────────────────────────────────────────┘
+```
+
+```text
+$ npx -y codebase-context refs --symbol "startFileWatcher"
+┌─ startFileWatcher ─── 11 references ─── static analysis ─────────────┐
+│                                                                      │
+│ startFileWatcher                                                     │
+│ │                                                                    │
+│ ├─ file-watcher.test.ts:5                                            │
+│ │   import { startFileWatcher } from '../src/core/file-watcher....   │
+│                                                                      │
+└──────────────────────────────────────────────────────────────────────┘
+```
+
+```text
+$ npx -y codebase-context cycles
+┌─ Circular Dependencies ──────────────────────────────────────────────┐
+│                                                                      │
+│ No cycles found  ·  98 files  ·  260 edges  ·  2.7 avg deps          │
+│                                                                      │
+└──────────────────────────────────────────────────────────────────────┘
+```
+
 See `docs/cli.md` for the full CLI gallery.
 
 ## What It Actually Does
@@ -273,6 +308,7 @@ Structured filters available: `framework`, `language`, `componentType`, `layer`
 | `OPENAI_API_KEY`         | -              | Required only if using `openai` provider                  |
 | `CODEBASE_ROOT`          | -              | Project root (CLI arg takes precedence)                   |
 | `CODEBASE_CONTEXT_DEBUG` | -              | Set to `1` for verbose logging                            |
+| `EMBEDDING_MODEL`        | `Xenova/bge-small-en-v1.5` | Local embedding model override (e.g. `ibm-granite/granite-embedding-30m-english` for Granite) |
 
 ## Performance
 

docs/capabilities.md

@@ -76,7 +76,7 @@ Ordered by execution:
 
 - **Chunk size**: 50 lines, 0 overlap
 - **Reranker trigger**: activates when top-3 results are within 0.08 score of each other
-- **Embedding model**: Granite (`ibm-granite/granite-embedding-30m-english`, 8192 token context) via `@huggingface/transformers` v3
+- **Embedding model**: `Xenova/bge-small-en-v1.5` (512 token context, fast, local-first) via `@xenova/transformers`. Override: `EMBEDDING_MODEL=ibm-granite/granite-embedding-30m-english` for Granite (8192 ctx, slower).
 - **Vector DB**: LanceDB with cosine distance
 
 ## Decision Card (Edit Intent)