diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index a5d1cf2..9965a34 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "2.2.0"
+  ".": "2.3.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index dbff7fc..6448249 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,129 @@
 # Changelog
 
+## [2.3.0](https://github.com/PatrickSys/codebase-context/compare/v2.2.0...v2.3.0) (2026-04-17)
+
+
+### Features
+
+* **02-03:** implement keyword-index symbol reference lookup ([ccfc564](https://github.com/PatrickSys/codebase-context/commit/ccfc5649a3f4e321bbd3770e5945f83213e103a6))
+* **02-03:** register get_symbol_references MCP tool ([6f6bc3a](https://github.com/PatrickSys/codebase-context/commit/6f6bc3ae3bfa9af13c404028c1307d774b69291c))
+* **03-01:** add frozen controlled eval fixture and local codebase ([46736ed](https://github.com/PatrickSys/codebase-context/commit/46736ed4c4681767164682a774e1ddf08ee81768))
+* **03-03:** add multi-codebase eval runner command ([b065042](https://github.com/PatrickSys/codebase-context/commit/b065042f9a689d82485532872009af571d22db44))
+* **03-03:** centralize eval harness scoring logic ([5c5319b](https://github.com/PatrickSys/codebase-context/commit/5c5319b4a3c9caf30f7b31de3ee210bc153ee58c))
+* **04-01:** add curated grammar manifest, sync script, and publish inclusion ([908f39a](https://github.com/PatrickSys/codebase-context/commit/908f39a2c82a9630150262299ec8ae1f25c269ab))
+* **04-01:** update tree-sitter loader to resolve packaged grammars and fail closed ([458520f](https://github.com/PatrickSys/codebase-context/commit/458520ff3d24bd9ff6399b6bedfe1b6776fc6579))
+* **04-02:** add manifest-driven grammar CI test with fail-closed fallback ([2559405](https://github.com/PatrickSys/codebase-context/commit/2559405007e17bad6fffcf6ea61b97475f0da1e6))
+* **05-01:** create AST-aligned chunking engine with symbol tree builder ([f865abc](https://github.com/PatrickSys/codebase-context/commit/f865abc0a3877441b492695c02ddca12fe9b36c6))
+* **05-01:** wire AST-aligned chunker into GenericAnalyzer with 21 unit tests ([68a2d6d](https://github.com/PatrickSys/codebase-context/commit/68a2d6da844a9ffdb6104670c565f338487d2199))
+* **05-02:** add scope-aware prefix generation to AST chunks ([3dbd43e](https://github.com/PatrickSys/codebase-context/commit/3dbd43eec1d6cdf63ec4d5094c870bf2ee6b164d))
+* **06-01:** add index format metadata and headers ([a216c6d](https://github.com/PatrickSys/codebase-context/commit/a216c6dd2c7614b705525bc30ba8fddf918c7cf3))
+* **06-01:** gate index consumers on IndexMeta validation ([6a52c0d](https://github.com/PatrickSys/codebase-context/commit/6a52c0d33d408a7463e036eac8a650c461c86a43))
+* **06-02:** implement staging directory build and atomic swap for full rebuild ([d719801](https://github.com/PatrickSys/codebase-context/commit/d71980128795bdf8e7c7ab16beb350729a85e306))
+* add HTTP transport mode alongside stdio ([8e97d0f](https://github.com/PatrickSys/codebase-context/commit/8e97d0f115c8b5e0b4f2a7f0f1ddcf2d996fe7a0))
+* add HTTP transport mode and server config file support ([3c8c273](https://github.com/PatrickSys/codebase-context/commit/3c8c27357c658b72bcfa1d5dc6044152a5e64e2a))
+* add react and nextjs analyzers ([1ac4671](https://github.com/PatrickSys/codebase-context/commit/1ac4671f878c72792539957cc76f5fbc80cc61bb))
+* add react and nextjs analyzers ([3da89f9](https://github.com/PatrickSys/codebase-context/commit/3da89f98a6ba3f8f784a9a46b526bdbb14f48331))
+* add server config file support for pre-registering projects ([08539c6](https://github.com/PatrickSys/codebase-context/commit/08539c680a9f6f9b5f39f991a85686ad35f2dd7c))
+* add workspace-aware multi-project routing ([#67](https://github.com/PatrickSys/codebase-context/issues/67)) ([edb1350](https://github.com/PatrickSys/codebase-context/commit/edb13507369c8d06a579a470665fe4449408d183))
+* **AST indexing:** Implement relationship index  ([#38](https://github.com/PatrickSys/codebase-context/issues/38)) ([5b05092](https://github.com/PatrickSys/codebase-context/commit/5b05092b4d5a4a08b117fdc06a3292afdcc8764e))
+* Auto-heal for silent semantic search failure ([9fde6c0](https://github.com/PatrickSys/codebase-context/commit/9fde6c0e5df5d3ca602147e00ff5b10262ca6c75))
+* 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))
+* consolidate launch readiness improvements ([db80888](https://github.com/PatrickSys/codebase-context/commit/db80888098a636652511f2a3d30c70222995beab))
+* consolidate launch readiness improvements ([0fb8b3f](https://github.com/PatrickSys/codebase-context/commit/0fb8b3f9167e5341c0033c5a0b7487df54bbd8bc))
+* **docs, mcp:** Improve the progress logging and documentation. ([10045bd](https://github.com/PatrickSys/codebase-context/commit/10045bdc93472e615bb47f22c9d32420f06559c4))
+* **eval:** add 5-comparator benchmark harness with timing and output flag ([999faf7](https://github.com/PatrickSys/codebase-context/commit/999faf707313ce60d1af16ceead446ad29a95a6f))
+* expose all 10 MCP tools via CLI + document them ([#42](https://github.com/PatrickSys/codebase-context/issues/42)) ([7581fba](https://github.com/PatrickSys/codebase-context/commit/7581fbac5b4fd5bc52abc56d946bf55962870566))
+* freeze discovery benchmark contract ([66824f9](https://github.com/PatrickSys/codebase-context/commit/66824f9efd433c2858ea00972cd554b74ec9bf3d))
+* freeze discovery benchmark contract ([1c78171](https://github.com/PatrickSys/codebase-context/commit/1c7817161f04bfc033e682f289865eb11c5769c8))
+* HTTP transport mode (--http flag) ([c9bf17f](https://github.com/PatrickSys/codebase-context/commit/c9bf17f59cdd07b86d0a047cccb1aec2f735195e))
+* **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))
+* implement DISC-01 compact/full search modes and SAFE-01 freshness-aware edit gating ([059aa0c](https://github.com/PatrickSys/codebase-context/commit/059aa0cda1e96363444aff1558bfc84907ef23bd))
+* **indexing:** OpenAI embeddings + broader language coverage ([#57](https://github.com/PatrickSys/codebase-context/issues/57)) ([3c1c53b](https://github.com/PatrickSys/codebase-context/commit/3c1c53b15381640e96b2e62794436ca21a545ce4))
+* **map:** promote codebase map as primary first-call surface (Phase 7) ([328d03b](https://github.com/PatrickSys/codebase-context/commit/328d03b23a27e32027dbc64ab52c243dac70b96a))
+* **memory:** v1.4.0 Memory System  ([#9](https://github.com/PatrickSys/codebase-context/issues/9)) ([3da3439](https://github.com/PatrickSys/codebase-context/commit/3da34392a119b21c286b67d26b25aec72ecdfc49))
+* Pattern Momentum - detect migration direction via git history (v1.1.0) ([ced0e18](https://github.com/PatrickSys/codebase-context/commit/ced0e18038e6c692aa42a3943f5320971ab1187e))
+* **phase-6:** add codebase-context init wizard ([#90](https://github.com/PatrickSys/codebase-context/issues/90)) ([e52cf0d](https://github.com/PatrickSys/codebase-context/commit/e52cf0db48aeb9e582784d585074b7ace8950731))
+* prepare v1.5.0 trust and indexing foundation ([#21](https://github.com/PatrickSys/codebase-context/issues/21)) ([a6b65f1](https://github.com/PatrickSys/codebase-context/commit/a6b65f134c32a35de1e305839ef294be9f97a7d0))
+* references confidence, remove get_component_usage, ranked search hints ([#39](https://github.com/PatrickSys/codebase-context/issues/39)) ([33616aa](https://github.com/PatrickSys/codebase-context/commit/33616aa48b165d5cfd95c44bc416cb74c4fd5cbf))
+* **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))
+* rework decision-card to make it based on AST parsing ([#41](https://github.com/PatrickSys/codebase-context/issues/41)) ([ac4389d](https://github.com/PatrickSys/codebase-context/commit/ac4389d6cc55b7f8efc310a6e020bcd184a70adc))
+* support per-project analyzer hints ([#83](https://github.com/PatrickSys/codebase-context/issues/83)) ([4441b41](https://github.com/PatrickSys/codebase-context/commit/4441b41de8953c830e59c9373555ba94dcb4f339))
+* symbol ranking, smart snippets, and edit decision card ([#40](https://github.com/PatrickSys/codebase-context/issues/40)) ([03964b3](https://github.com/PatrickSys/codebase-context/commit/03964b3f40cc0fa0caf9768747a39fb559daaa8e))
+* tighten search contract (Phase 8 - DISC-01 + SAFE-01) ([164ff14](https://github.com/PatrickSys/codebase-context/commit/164ff1447bb3bde7815c0490ac6f8507ee478918))
+* use tree-sitter symbols in generic analyzer ([b470709](https://github.com/PatrickSys/codebase-context/commit/b470709aa77f02325ed5a4e2b0710017020565da))
+* **v1.2.0:** testing patterns detection, golden files extraction, wrapper libraries detection, file watcher for incrementalish indexing ([8f3bf68](https://github.com/PatrickSys/codebase-context/commit/8f3bf6831c6197f168a9744526f6d42f1fc78ccb))
+* v1.3.0 foundation (workspace utils, metadata fix, testing) ([#4](https://github.com/PatrickSys/codebase-context/issues/4)) ([fc8eb35](https://github.com/PatrickSys/codebase-context/commit/fc8eb3543854fc57c20f2f8d34948ade5c566c9a))
+* v1.6.0 search quality improvements ([#26](https://github.com/PatrickSys/codebase-context/issues/26)) ([8207787](https://github.com/PatrickSys/codebase-context/commit/8207787db45c9ee3940e22cb3fd8bc88a2c6a63b))
+* **v2.1:** map structural skeleton + search metadata surface ([#95](https://github.com/PatrickSys/codebase-context/issues/95)) ([8650c0a](https://github.com/PatrickSys/codebase-context/commit/8650c0aa63c6eaf2ea0cc0050caf0642d792823e))
+* **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
+
+* **02-01:** fall back when tree-sitter parse has errors ([8a7cd92](https://github.com/PatrickSys/codebase-context/commit/8a7cd92cab25b045b5108b1cba04773f644eab10))
+* **02-tree-sitter-02:** prevent symbol-aware chunk merging ([fd02625](https://github.com/PatrickSys/codebase-context/commit/fd0262516e262eff0c17646eaca021d6288c6647))
+* **03-02:** add regression guardrails for extraction and large-file safety ([a1c71de](https://github.com/PatrickSys/codebase-context/commit/a1c71de070b434f326dc80e627964c1540eea93f))
+* **03-02:** harden tree-sitter extraction against byte-offset and parser failures ([375a48f](https://github.com/PatrickSys/codebase-context/commit/375a48f231c85d72157aa74ea964db27bf9a983e))
+* address greptile P2 review comments ([41c252a](https://github.com/PatrickSys/codebase-context/commit/41c252a644baf230ee0d1efb34387fad9d85e8eb))
+* align discovery protocol metrics ([21c3e43](https://github.com/PatrickSys/codebase-context/commit/21c3e43323a29aad2894a56933255cb3417d969d))
+* **benchmarks:** make all comparator lanes cross-platform on Windows ([#97](https://github.com/PatrickSys/codebase-context/issues/97)) ([#97](https://github.com/PatrickSys/codebase-context/issues/97)) ([6c19628](https://github.com/PatrickSys/codebase-context/commit/6c19628d5d1691c999b07a4532643f0d4ce7016d))
+* **ci:** allow manual release publish recovery ([cf31aca](https://github.com/PatrickSys/codebase-context/commit/cf31aca69a575e036e2d73e0e0d4ff1922ab73b1))
+* **ci:** build before release tests ([01e8c1b](https://github.com/PatrickSys/codebase-context/commit/01e8c1bb860f908867e142121f5100cfd0d8a72c))
+* **ci:** replace retired pnpm audit endpoint ([b8c525d](https://github.com/PatrickSys/codebase-context/commit/b8c525da7b8670ec442e1b43b780ae62168d4fcf))
+* **ci:** unblock functional tests ([77ae70b](https://github.com/PatrickSys/codebase-context/commit/77ae70b1fd32858b983b6502a075b263bcedbbdf))
+* clean up benchmark MCP sessions ([ad5db8b](https://github.com/PatrickSys/codebase-context/commit/ad5db8b18911814fde8061638ecaf5b2b9ae99c6))
+* clean up benchmark MCP sessions ([408c248](https://github.com/PatrickSys/codebase-context/commit/408c248933c08d5c1868522d10d1715fa6091c9d))
+* **cli:** formatter audit — render missing metadata fields, README callers qualifier ([d273729](https://github.com/PatrickSys/codebase-context/commit/d273729d16ffff3432b663b76db4964f5dce9822))
+* **cli:** remove unused MetadataDependency import ([3f08f0e](https://github.com/PatrickSys/codebase-context/commit/3f08f0ed2ed27c10c2fae3ecf31c81771b22cb88))
+* close Phase 8 review follow-ups ([b549be4](https://github.com/PatrickSys/codebase-context/commit/b549be4b6bb470a84c434cf019a64f5efb824db9))
+* 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))
+* **config:** reject empty roots and invalid ports ([912e6f6](https://github.com/PatrickSys/codebase-context/commit/912e6f6af672048f2ac145c7574bac140e503a05))
+* **deps:** patch picomatch audit path ([c637bf5](https://github.com/PatrickSys/codebase-context/commit/c637bf58d1614bd7c2e0089e188f5869b17ce1dd))
+* finalize v2.1.0 token budget advisory ([2df5399](https://github.com/PatrickSys/codebase-context/commit/2df53997dfd43bfa306c99d562a6608afedb5411))
+* format discovery benchmark sources ([b4ab479](https://github.com/PatrickSys/codebase-context/commit/b4ab47985f09908ae35ae180834f7c850e05207b))
+* **format:** apply prettier formatting to all source files ([049269f](https://github.com/PatrickSys/codebase-context/commit/049269f1afb75df1adcd8948b724272cb74f4976))
+* **get-team-patterns:** filter out legacy testing framework categories from patterns ([ed5c858](https://github.com/PatrickSys/codebase-context/commit/ed5c858063493efe328fb2ce03f95404efd34ad4))
+* **git:** run tests only on pre-push ([785d28b](https://github.com/PatrickSys/codebase-context/commit/785d28b3adfb4e5bebe946c2af17f958ac0c7022))
+* **git:** tighten pre-push formatting enforcement ([a6d95fc](https://github.com/PatrickSys/codebase-context/commit/a6d95fc297cd5dcdaba2244b9413cd5353f6f273))
+* guard against unhandled rejections and resource leaks in HTTP transport ([e031a56](https://github.com/PatrickSys/codebase-context/commit/e031a56a1fa7a1c18424c5c6d01d2c9cbd03955d))
+* guard null chunk.content crash + docs rewrite for v1.6.1 ([6b89778](https://github.com/PatrickSys/codebase-context/commit/6b8977897665ea3207e1bbb0f5d685c61d41bbb8))
+* guard startup logs for wide MCP STDIO compatibility ([a72f35b](https://github.com/PatrickSys/codebase-context/commit/a72f35bb480ee86fb9c0498713bf874b0d9574c0))
+* harden managed MCP session cleanup ([fcce4b6](https://github.com/PatrickSys/codebase-context/commit/fcce4b6e820e55c085ff933e436c3bc76881ab6b))
+* harden search reliability and indexing hygiene ([#22](https://github.com/PatrickSys/codebase-context/issues/22)) ([42a32af](https://github.com/PatrickSys/codebase-context/commit/42a32af626f30dc9c8428419f82a6c03c7312e22))
+* **lint:** disable no-explicit-any rule for AST manipulation code ([41547da](https://github.com/PatrickSys/codebase-context/commit/41547da2aa5529dce3d539c296d5e9d79df379fe))
+* **lint:** remove useless try/catch in search.ts ([39f777e](https://github.com/PatrickSys/codebase-context/commit/39f777ef85a82fc0cb093dcf1a12f338c985c51e))
+* make exclude patterns recursive to prevent index pollution ([#76](https://github.com/PatrickSys/codebase-context/issues/76)) ([a814b24](https://github.com/PatrickSys/codebase-context/commit/a814b2445d3df97ac205073e770399d5caa95214))
+* **metadata:** prevent framework misclassification in codebase detection ([#96](https://github.com/PatrickSys/codebase-context/issues/96)) ([ae649dd](https://github.com/PatrickSys/codebase-context/commit/ae649dd803ee1b4146205c1ee4f50c0e7d04ce2a))
+* patch vulnerable hono dependencies ([fa79e90](https://github.com/PatrickSys/codebase-context/commit/fa79e90d409a861c1df8fcb759c1f1ee0a91e0b2))
+* prevent orphaned processes via stdin/ppid/onclose lifecycle guards ([#77](https://github.com/PatrickSys/codebase-context/issues/77)) ([0b49d7a](https://github.com/PatrickSys/codebase-context/commit/0b49d7a9281b3a215cd920a77613ced1cbc3932d))
+* prevent zombie MCP processes via handshake timeout + deferred init ([#89](https://github.com/PatrickSys/codebase-context/issues/89)) ([37fd4b9](https://github.com/PatrickSys/codebase-context/commit/37fd4b98c8bacf8418c97604d932f0149e1e3efc))
+* **refs:** prevent out-of-root file reads from index ([1735e3c](https://github.com/PatrickSys/codebase-context/commit/1735e3cb51f808c3bd1c9afed4f1139bad851e8f))
+* resolve PR [#98](https://github.com/PatrickSys/codebase-context/issues/98) review blockers ([396dd66](https://github.com/PatrickSys/codebase-context/commit/396dd6687ae3ad33d1d6ca18ef6205ec836b5da4))
+* restore npx installs for published package ([107bc14](https://github.com/PatrickSys/codebase-context/commit/107bc14ff3a3b918d39df28703c739b3598b0cd8))
+* route MCP requests per project root ([#65](https://github.com/PatrickSys/codebase-context/issues/65)) ([b0c2d04](https://github.com/PatrickSys/codebase-context/commit/b0c2d04bc8a1ce05469697082e1bf5b80207a426))
+* satisfy lint in index ([e218859](https://github.com/PatrickSys/codebase-context/commit/e218859875a1a6e27a7f588db4d2c3e022b956d7))
+* **search:** durabilize verified search and reranker closure ([0458be8](https://github.com/PatrickSys/codebase-context/commit/0458be8edeedb866f3bd63d6a4d2c62e06493ada))
+* **search:** finalize token budget advisory payload ([2d08c89](https://github.com/PatrickSys/codebase-context/commit/2d08c898c89286da4fd6a4c777f588fbb17fbe32))
+* **search:** query-aware bestExample, golden file threshold, ONNX thread limits ([9cec82a](https://github.com/PatrickSys/codebase-context/commit/9cec82ab38d63d759648baacba608ca4b578f075))
+* **search:** wire SearchResult imports/exports and stabilize map hub selection ([#100](https://github.com/PatrickSys/codebase-context/issues/100)) ([922f9fc](https://github.com/PatrickSys/codebase-context/commit/922f9fc1482f5f35f1e69673fe6cdf8d15f2aee3))
+* singleton embedding provider and LanceDB schema validation ([106ee1a](https://github.com/PatrickSys/codebase-context/commit/106ee1aa0f44243a6e3c41c41b171a9827b9eece))
+* **test:** update multi-project routing assertions for new map header ([adfe8d5](https://github.com/PatrickSys/codebase-context/commit/adfe8d521d3dc99468f0f83c4498a73251ca5ecd))
+* update prepublishOnly to use pnpm (Greptile audit) ([5197711](https://github.com/PatrickSys/codebase-context/commit/51977119e475f9b376e2c4727b618b765d46e517))
+* use cosine distance for vector search scoring ([b41edb7](https://github.com/PatrickSys/codebase-context/commit/b41edb7e4c1969b04d834ec52a9ae43760e796a9))
+* **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))
+
 ## [2.2.0](https://github.com/PatrickSys/codebase-context/compare/v1.10.0...v2.2.0) (2026-04-17)
 
 ### Features
diff --git a/package.json b/package.json
index 20ad3c6..e219d79 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "codebase-context",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Bounded conventions map and local-pattern discovery for AI coding agents. Local-first MCP server with AST-backed hybrid search.",
   "type": "module",
   "main": "./dist/lib.js",