From 3a3d18733cc12f1350555b7f03c2fc7ab5a8abce Mon Sep 17 00:00:00 2001 From: PatrickSys Date: Sun, 1 Mar 2026 19:23:12 +0100 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20audit=20+=20launch=20prep=20?= =?UTF-8?q?=E2=80=94=20fix=20embedding=20model,=20expand=20CLI=20previews?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- README.md | 38 +++++++++++++++++++++++++++++++++++++- docs/capabilities.md | 2 +- 2 files changed, 38 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1d3dc37..8508591 100644 --- a/README.md +++ b/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 diff --git a/docs/capabilities.md b/docs/capabilities.md index 1250cea..58016a6 100644 --- a/docs/capabilities.md +++ b/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) From 4071f9fdb4a91760b8c5f2fea4ebd33edca6b1e9 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Mon, 2 Mar 2026 11:12:30 +0000 Subject: [PATCH 2/2] chore(master): release 1.8.0 --- .release-please-manifest.json | 2 +- CHANGELOG.md | 29 +++++++++++++++++++++++++++++ package.json | 2 +- 3 files changed, 31 insertions(+), 2 deletions(-) diff --git a/.release-please-manifest.json b/.release-please-manifest.json index 64e0684..099626f 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "1.7.0" + ".": "1.8.0" } diff --git a/CHANGELOG.md b/CHANGELOG.md index 0eba259..574bba6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,34 @@ # Changelog +## [1.8.0](https://github.com/PatrickSys/codebase-context/compare/v1.7.0...v1.8.0) (2026-03-02) + + +### Features + +* CLI formatters + response types + debug gating ([#48](https://github.com/PatrickSys/codebase-context/issues/48)) ([7a6cd7b](https://github.com/PatrickSys/codebase-context/commit/7a6cd7b61e27adb62861d6a264c2ac1feba4d96d)) +* **cli:** status formatter + CLI gallery docs ([#56](https://github.com/PatrickSys/codebase-context/issues/56)) ([b7bc5cc](https://github.com/PatrickSys/codebase-context/commit/b7bc5cc078635a5f0a4f33e47d431d21cdb83ccc)) +* **impact:** persist import edge details + 2-hop impact candidates ([f296e30](https://github.com/PatrickSys/codebase-context/commit/f296e30834777770c70f9c20998576e123ea7592)) +* **impact:** persist import edge details and 2-hop candidates ([5bd84a1](https://github.com/PatrickSys/codebase-context/commit/5bd84a1c6174c2ae6a413579c471e68ccc30f377)) +* **refs:** tree-sitter identifier-aware symbol references ([2aa0831](https://github.com/PatrickSys/codebase-context/commit/2aa08315103fa1b87b20d4f212ab271caeee670c)) +* **refs:** Tree-sitter identifier-aware symbol references ([c23ffec](https://github.com/PatrickSys/codebase-context/commit/c23ffecf4174a6d683d4b985a754ca2ad840cfe1)) +* **watcher:** chokidar auto-refresh with debounced incremental reindex ([59e3686](https://github.com/PatrickSys/codebase-context/commit/59e36867cd4048c858b08d2c551ca94adb6738ac)) +* **watcher:** chokidar auto-refresh with debounced incremental reindex ([f300961](https://github.com/PatrickSys/codebase-context/commit/f300961b73b1ee867bfc43f0b2925d3f7c055447)) + + +### Bug Fixes + +* close v1.8 post-merge integration gaps ([#44](https://github.com/PatrickSys/codebase-context/issues/44)) ([d28460c](https://github.com/PatrickSys/codebase-context/commit/d28460c38bf91e8cb40a76501a03378c2edc11b5)) +* **refs:** prevent out-of-root file reads from index ([1735e3c](https://github.com/PatrickSys/codebase-context/commit/1735e3cb51f808c3bd1c9afed4f1139bad851e8f)) +* **watcher-tests:** await ready + harden Windows cleanup ([#55](https://github.com/PatrickSys/codebase-context/issues/55)) ([9929bb0](https://github.com/PatrickSys/codebase-context/commit/9929bb0cea7d9ad5a41f2719a8b1a48be1dc9909)) +* **watcher:** allow debounce 0 and harden test ([070433c](https://github.com/PatrickSys/codebase-context/commit/070433cf79dace7420c26284ceeca7fea41dc8a1)) +* **watcher:** queue refresh during indexing ([2d78110](https://github.com/PatrickSys/codebase-context/commit/2d781105f9d56e3b5644abe90ae88978e4d7b0d0)) + + +### Performance Improvements + +* **impact:** avoid per-candidate array alloc ([faf6e73](https://github.com/PatrickSys/codebase-context/commit/faf6e73101d1c76f17e755df35d8e34a1783a6fa)) +* **impact:** avoid per-candidate array allocation ([04e68eb](https://github.com/PatrickSys/codebase-context/commit/04e68eb3c7d5a2a5aaa45a82ef6823e6f13ce6a9)) + ## [1.7.0](https://github.com/PatrickSys/codebase-context/compare/v1.6.1...v1.7.0) (2026-02-21) diff --git a/package.json b/package.json index f4f22be..07a821b 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "codebase-context", - "version": "1.7.0", + "version": "1.8.0", "description": "Second brain for AI agents working on your codebase - team coding patterns detection, persistent memory, edit readiness checks, and hybrid search with evidence scoring. Local-first MCP server", "type": "module", "main": "./dist/lib.js",