codenib 0.2.0__tar.gz → 0.2.1__tar.gz

{codenib-0.2.0 → codenib-0.2.1}/CHANGELOG.md

@@ -11,6 +11,30 @@ All notable user-facing changes are recorded here. CodeNib follows
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-08-14
+
+### Added
+
+- A one-command `codenib codegraph init` path that installs repository-aware
+  graph providers, builds BM25 and symbol-graph views, and configures installed
+  Codex and Claude Code clients through their native MCP CLIs.
+- Machine-readable CodeGraph status, idempotent client receipts, safe uninstall,
+  and a no-write dry run.
+- Installed-wheel black-box coverage for `explore_context`,
+  `dependency_subgraph`, both client contracts, repeat initialization, and
+  checkout cleanliness.
+
+### Changed
+
+- The primary agent quickstart now leads with the local, model-free CodeGraph;
+  the Wiki and semantic routes remain available as independent product paths.
+
+### Security
+
+- Client setup refuses unmanaged name collisions and drifted managed
+  registrations. Uninstall removes only receipt-owned entries and preserves
+  repository indexes.
+
 ## [0.2.0] - 2026-08-05
 
 ### Added
@@ -132,7 +156,8 @@ All notable user-facing changes are recorded here. CodeNib follows
 - Prepared secretless PyPI publishing through a dedicated GitHub Actions OIDC
   workflow.
 
-[Unreleased]: https://github.com/sysevol-ai/CodeNib/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/sysevol-ai/CodeNib/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/sysevol-ai/CodeNib/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/sysevol-ai/CodeNib/compare/v0.1.0...v0.2.0
 [0.2.0a2]: https://github.com/sysevol-ai/CodeNib/compare/620a82d...78e12ac
 [0.2.0a1]: https://github.com/sysevol-ai/CodeNib/tree/620a82d

{codenib-0.2.0 → codenib-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codenib
-Version: 0.2.0
+Version: 0.2.1
 Summary: A multi-view data system for serving repository context to coding agents
 Author-email: Zhongming Yu <zhy025@ucsd.edu>
 License-Expression: Apache-2.0
@@ -25,9 +25,11 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: fastapi>=0.100.0
+Requires-Dist: filelock>=3.0.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rank_bm25>=0.2.2
+Requires-Dist: regex>=2024.11.6
 Requires-Dist: rich>=14.0.0
 Requires-Dist: tree-sitter>=0.25.2
 Requires-Dist: tree-sitter-language-pack<1.9.0,>=1.8.1
@@ -47,11 +49,16 @@ Requires-Dist: einops>=0.8.0; extra == "semantic"
 Requires-Dist: faiss-cpu>=1.7.0; extra == "semantic"
 Requires-Dist: numpy>=1.24.0; extra == "semantic"
 Requires-Dist: openai>=1.0.0; extra == "semantic"
-Requires-Dist: sentence-transformers>=2.2.0; extra == "semantic"
+Requires-Dist: sentence-transformers>=2.3.0; extra == "semantic"
 Provides-Extra: semantic-remote
 Requires-Dist: faiss-cpu>=1.7.0; extra == "semantic-remote"
 Requires-Dist: numpy>=1.24.0; extra == "semantic-remote"
 Requires-Dist: openai>=1.0.0; extra == "semantic-remote"
+Provides-Extra: serving
+Requires-Dist: numpy>=1.24.0; extra == "serving"
+Requires-Dist: sse-starlette>=2.0.0; extra == "serving"
+Requires-Dist: torch>=2.2.0; extra == "serving"
+Requires-Dist: transformers>=5.15.0; extra == "serving"
 Provides-Extra: vertex
 Requires-Dist: litellm[google]>=1.93.0; extra == "vertex"
 Provides-Extra: zoekt
@@ -67,7 +74,7 @@ Requires-Dist: numpy>=1.24.0; extra == "full"
 Requires-Dist: openai>=1.0.0; extra == "full"
 Requires-Dist: protobuf>=3.20.0; extra == "full"
 Requires-Dist: requests>=2.25.0; extra == "full"
-Requires-Dist: sentence-transformers>=2.2.0; extra == "full"
+Requires-Dist: sentence-transformers>=2.3.0; extra == "full"
 Provides-Extra: dev
 Requires-Dist: black>=22.3.0; extra == "dev"
 Requires-Dist: build>=1.2.0; extra == "dev"
@@ -83,7 +90,6 @@ Provides-Extra: test
 Requires-Dist: datasets>=4.0.0; extra == "test"
 Requires-Dist: einops>=0.8.0; extra == "test"
 Requires-Dist: faiss-cpu>=1.7.0; extra == "test"
-Requires-Dist: filelock>=3.0.0; extra == "test"
 Requires-Dist: igraph>=0.11.6; extra == "test"
 Requires-Dist: litellm>=1.93.0; extra == "test"
 Requires-Dist: matplotlib>=3.4.0; extra == "test"
@@ -96,7 +102,8 @@ Requires-Dist: pytest-cov>=3.0.0; extra == "test"
 Requires-Dist: pytest-timeout>=2.1.0; extra == "test"
 Requires-Dist: pytest-xdist>=3.0.0; extra == "test"
 Requires-Dist: requests>=2.25.0; extra == "test"
-Requires-Dist: sentence-transformers>=2.2.0; extra == "test"
+Requires-Dist: sentence-transformers>=2.3.0; extra == "test"
+Requires-Dist: sse-starlette>=2.0.0; extra == "test"
 Requires-Dist: tomli>=1.1.0; python_version < "3.11" and extra == "test"
 Dynamic: license-file
 
@@ -126,6 +133,8 @@ SPDX-License-Identifier: Apache-2.0
     &nbsp;&middot;&nbsp;
     <a href="https://docs.codenib.ai/">Documentation</a>
     &nbsp;&middot;&nbsp;
+    <a href="https://docs.codenib.ai/codegraph/">CodeGraph</a>
+    &nbsp;&middot;&nbsp;
     <a href="https://docs.codenib.ai/mcp/">MCP</a>
     &nbsp;&middot;&nbsp;
     <a href="https://docs.codenib.ai/agent_integrations/">Agent Integrations</a>
@@ -133,26 +142,36 @@ SPDX-License-Identifier: Apache-2.0
     <a href="https://docs.codenib.ai/language_capabilities/">Languages</a>
   </p>
   <p>
-    <a href="https://github.com/sysevol-ai/CodeNib/actions/workflows/ci.yml"><img src="https://github.com/sysevol-ai/CodeNib/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+    <a href="https://github.com/sysevol-ai/CodeNib/actions/workflows/ci-full.yml"><img src="https://github.com/sysevol-ai/CodeNib/actions/workflows/ci-full.yml/badge.svg" alt="CI"></a>
     <a href="https://pypi.org/project/codenib/"><img src="https://img.shields.io/pypi/v/codenib.svg" alt="PyPI version"></a>
     <a href="https://github.com/sysevol-ai/CodeNib/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>
     <a href="https://github.com/sysevol-ai/CodeNib/blob/main/pyproject.toml"><img src="https://img.shields.io/badge/Python-3.10%2B-3776AB.svg" alt="Python 3.10+"></a>
-    <img src="https://img.shields.io/badge/Release-0.2.0-2563EB.svg" alt="CodeNib 0.2.0">
+    <img src="https://img.shields.io/badge/Release-0.2.1-2563EB.svg" alt="CodeNib 0.2.1">
   </p>
 </div>
 
 ```bash
-python -m pip install "codenib[mcp,semantic]==0.2.0"
-codenib wiki /path/to/your/repo
+python -m pip install "codenib[graph,mcp]==0.2.1"
+codenib codegraph init /path/to/your/repo
 ```
 
-Local, open source, and no cloud required. CodeNib combines BM25 and dense code
-search, adds optional SCIP symbol graphs, and incrementally rebuilds repository
-indexes as commits change. The same index powers the Wiki, Dependency Map, Ask,
-and MCP tools instead of making every agent rediscover the codebase.
+That one command detects the repository languages, installs the pinned
+package-level graph providers it can manage, builds BM25 plus a source-linked
+symbol graph, and registers the resulting MCP server with installed Codex and
+Claude Code clients. It is local, open source, requires no model or cloud, and
+does not write configuration or indexes into the target repository.
 
 ## News
 
+- **2026-08-13 — CodeNib 0.2.1 CodeGraph onboarding.** One command prepares a
+  repository graph and connects it to Codex and Claude Code, with idempotent
+  status, safe uninstall, and installed-wheel MCP graph verification.
+  [CodeGraph guide](https://docs.codenib.ai/codegraph/)
+- **2026-08-08 — RepoNavigator Jump adapter.** The published single-tool
+  [RepoNavigator](https://arxiv.org/abs/2512.20957v6) contract now resolves
+  symbol definitions through a persisted SCIP occurrence or injected LSP
+  signal, with graph-only resolution disclosed as a degraded fallback.
+  [Support boundary](https://docs.codenib.ai/agent_integrations/#reponavigator)
 - **2026-08-05 — CodeNib 0.2.0.** Build a static Wiki and reusable context
   artifact once, then serve it through Pages or the official MCP package.
   Hybrid retrieval and managed SCIP/LSP providers ship in the same CLI.
@@ -197,33 +216,38 @@ publishing a partially updated view.
 
 ## Quickstart
 
-Requires Python 3.10+ and Git. The recommended local path includes the pinned
-CodeRankEmbed model and serves hybrid BM25+dense retrieval:
+Requires Python 3.10+ and Git. For an agent-ready CodeGraph with no model or API
+key, install the graph and MCP extras and run one command:
 
 ```bash
-python -m pip install "codenib[semantic]==0.2.0"
-codenib doctor --require core --require wiki
-codenib wiki /path/to/repository
+python -m pip install "codenib[graph,mcp]==0.2.1"
+codenib codegraph init /path/to/repository
 ```
 
-`codenib wiki` selects the semantic route because the installed environment
-contains its dependencies. A smaller `python -m pip install codenib==0.2.0`
-installation selects the deterministic BM25 fallback and downloads no model.
-The [0.2 release notes](https://docs.codenib.ai/releases/0.2.0/) record the
-upgrade boundary and verification evidence.
+`codegraph init` detects Codex and Claude Code, installs only the detected
+languages' package-managed providers, builds reusable `bm25` and
+`symbol_graph` views, and asks each native client CLI to own its configuration.
+Run `codenib codegraph status /path/to/repository` to diagnose the complete
+path or `codenib codegraph uninstall /path/to/repository` to remove only the
+managed client registrations. The index remains reusable.
+
+For a browser Wiki with hybrid BM25+dense retrieval, install the semantic extra:
+
+```bash
+python -m pip install "codenib[semantic]==0.2.1"
+codenib wiki /path/to/repository
+```
 
-CodeNib detects the repository languages, builds a reusable index under
-`~/.codenib/repositories`, launches the local Wiki, and opens
-[http://localhost:3000](http://localhost:3000). The wheel includes the
-production Wiki frontend, so normal use does not require Node.js or npm and
-the target repository stays untouched. This command exercises the same compiler
-and serving runtime used by agents. Set `CODENIB_HOME` to relocate state.
+Both paths keep reusable state under `~/.codenib/repositories` and leave the
+target checkout unchanged. Set `CODENIB_HOME` to relocate state. The
+[0.2.1 release notes](https://docs.codenib.ai/releases/0.2.1/) record the
+upgrade boundary and installed-product evidence.
 
-Check the environment or index without opening the Wiki:
+Preview the CodeGraph operations without installing, indexing, or configuring
+an agent:
 
 ```bash
-codenib doctor --require core --require wiki
-codenib index /path/to/repository
+codenib codegraph init /path/to/repository --dry-run
 ```
 
 For a structural view, CodeNib detects the repository languages and manages
@@ -231,7 +255,7 @@ only their package-level providers; operating-system and project prerequisites
 remain explicit:
 
 ```bash
-python -m pip install "codenib[graph]==0.2.0"
+python -m pip install "codenib[graph]==0.2.1"
 codenib toolchain install /path/to/repository --scope graph
 codenib doctor /path/to/repository --require graph
 ```
@@ -269,25 +293,21 @@ for ports, advanced indexing, and troubleshooting.
 
 ## Serve An Agent
 
-Install the MCP extra, build once, and serve the same repository manifest over
-stdio:
+The recommended path configures installed Codex and Claude Code clients through
+their native CLIs:
 
 ```bash
-python -m pip install "codenib[mcp,semantic]==0.2.0"
-codenib index /path/to/repository
-codenib mcp /path/to/repository
+python -m pip install "codenib[graph,mcp]==0.2.1"
+codenib codegraph init /path/to/repository
 ```
 
-The MCP server advertises `search_context` as its default ranked entry point,
-then exposes the underlying BM25, vector, graph, and navigation operations for
-explicit control. It uses the compiled manifest to decide which calls have a
-fresh backing view. An agent can therefore reuse
-available repository work instead of rebuilding context through unbounded
-`grep` and `read` loops, while unavailable searches fail explicitly. BM25,
-semantic, regex, Zoekt, dependency, and static-navigation results retain source
-locations for follow-up reads and citations. See
-[MCP Server](https://docs.codenib.ai/mcp/)
-for client configuration and tool contracts.
+Ask the agent to start with `explore_context` for bounded, source-verified
+repository context and use `dependency_subgraph` for caller impact or callee
+dependencies. The MCP server also exposes ranked BM25, regex, definition,
+reference, route, and bounded source-read tools. See the
+[CodeGraph guide](https://docs.codenib.ai/codegraph/) for client scopes,
+diagnostics, uninstall behavior, and language prerequisites, and the
+[MCP Server](https://docs.codenib.ai/mcp/) for the complete tool contract.
 
 The same planner is available directly to Python agents:
 
@@ -312,7 +332,7 @@ capabilities, loaded views, fusion, graph, and reranking trace.
 | Retrieval | BM25, dense-vector, regex/trigram, Zoekt, fusion, and reranking paths; see the [validated model matrix](https://docs.codenib.ai/rag_ops/#validated-models) |
 | Structural context | SCIP/LSP-backed symbol graphs with source locations and typed edges |
 | MCP and LSP-shaped tools | Serve one manifest to coding agents without tying the runtime to one agent framework |
-| Agent compatibility | Reuse one manifest across revision-pinned [LocAgent](https://github.com/gersteinlab/LocAgent), [Agentless](https://github.com/OpenAutoCoder/Agentless), [CoSIL](https://github.com/ZhonghaoJiang/CoSIL), and [OrcaLoca](https://github.com/fishmingyu/OrcaLoca) contracts; see the [support matrix](https://docs.codenib.ai/agent_integrations/) |
+| Agent compatibility | Reuse one manifest across revision-pinned [LocAgent](https://github.com/gersteinlab/LocAgent), [Agentless](https://github.com/OpenAutoCoder/Agentless), [CoSIL](https://github.com/ZhonghaoJiang/CoSIL), and [OrcaLoca](https://github.com/fishmingyu/OrcaLoca) contracts, plus the published [RepoNavigator](https://arxiv.org/abs/2512.20957v6) `jump` contract over SCIP/LSP definition signals; see the [support matrix](https://docs.codenib.ai/agent_integrations/) |
 | Benchmark compatibility | Evaluate native exploration against pinned external datasets and scorers, including [SWE-Explore](https://github.com/Qiushao-E/SWE-Explore-Bench); see the [dataset and benchmark matrix](https://docs.codenib.ai/evaluation/) |
 | Local inspection | Audit the same context through Wiki pages, Ask answers, citations, and the Dependency Map |
 | Evaluation harness | Measure retrieval, navigation, incremental maintenance, and context policies on the same artifacts |

{codenib-0.2.0 → codenib-0.2.1}/README.md

@@ -24,6 +24,8 @@ SPDX-License-Identifier: Apache-2.0
      · 
     <a href="https://docs.codenib.ai/">Documentation</a>
     &nbsp;&middot;&nbsp;
+    <a href="https://docs.codenib.ai/codegraph/">CodeGraph</a>
+    &nbsp;&middot;&nbsp;
     <a href="https://docs.codenib.ai/mcp/">MCP</a>
     &nbsp;&middot;&nbsp;
     <a href="https://docs.codenib.ai/agent_integrations/">Agent Integrations</a>
@@ -31,26 +33,36 @@ SPDX-License-Identifier: Apache-2.0
     <a href="https://docs.codenib.ai/language_capabilities/">Languages</a>
   </p>
   <p>
-    <a href="https://github.com/sysevol-ai/CodeNib/actions/workflows/ci.yml"><img src="https://github.com/sysevol-ai/CodeNib/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+    <a href="https://github.com/sysevol-ai/CodeNib/actions/workflows/ci-full.yml"><img src="https://github.com/sysevol-ai/CodeNib/actions/workflows/ci-full.yml/badge.svg" alt="CI"></a>
     <a href="https://pypi.org/project/codenib/"><img src="https://img.shields.io/pypi/v/codenib.svg" alt="PyPI version"></a>
     <a href="https://github.com/sysevol-ai/CodeNib/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>
     <a href="https://github.com/sysevol-ai/CodeNib/blob/main/pyproject.toml"><img src="https://img.shields.io/badge/Python-3.10%2B-3776AB.svg" alt="Python 3.10+"></a>
-    <img src="https://img.shields.io/badge/Release-0.2.0-2563EB.svg" alt="CodeNib 0.2.0">
+    <img src="https://img.shields.io/badge/Release-0.2.1-2563EB.svg" alt="CodeNib 0.2.1">
   </p>
 </div>
 
 ```bash
-python -m pip install "codenib[mcp,semantic]==0.2.0"
-codenib wiki /path/to/your/repo
+python -m pip install "codenib[graph,mcp]==0.2.1"
+codenib codegraph init /path/to/your/repo
 ```
 
-Local, open source, and no cloud required. CodeNib combines BM25 and dense code
-search, adds optional SCIP symbol graphs, and incrementally rebuilds repository
-indexes as commits change. The same index powers the Wiki, Dependency Map, Ask,
-and MCP tools instead of making every agent rediscover the codebase.
+That one command detects the repository languages, installs the pinned
+package-level graph providers it can manage, builds BM25 plus a source-linked
+symbol graph, and registers the resulting MCP server with installed Codex and
+Claude Code clients. It is local, open source, requires no model or cloud, and
+does not write configuration or indexes into the target repository.
 
 ## News
 
+- **2026-08-13 — CodeNib 0.2.1 CodeGraph onboarding.** One command prepares a
+  repository graph and connects it to Codex and Claude Code, with idempotent
+  status, safe uninstall, and installed-wheel MCP graph verification.
+  [CodeGraph guide](https://docs.codenib.ai/codegraph/)
+- **2026-08-08 — RepoNavigator Jump adapter.** The published single-tool
+  [RepoNavigator](https://arxiv.org/abs/2512.20957v6) contract now resolves
+  symbol definitions through a persisted SCIP occurrence or injected LSP
+  signal, with graph-only resolution disclosed as a degraded fallback.
+  [Support boundary](https://docs.codenib.ai/agent_integrations/#reponavigator)
 - **2026-08-05 — CodeNib 0.2.0.** Build a static Wiki and reusable context
   artifact once, then serve it through Pages or the official MCP package.
   Hybrid retrieval and managed SCIP/LSP providers ship in the same CLI.
@@ -95,33 +107,38 @@ publishing a partially updated view.
 
 ## Quickstart
 
-Requires Python 3.10+ and Git. The recommended local path includes the pinned
-CodeRankEmbed model and serves hybrid BM25+dense retrieval:
+Requires Python 3.10+ and Git. For an agent-ready CodeGraph with no model or API
+key, install the graph and MCP extras and run one command:
 
 ```bash
-python -m pip install "codenib[semantic]==0.2.0"
-codenib doctor --require core --require wiki
-codenib wiki /path/to/repository
+python -m pip install "codenib[graph,mcp]==0.2.1"
+codenib codegraph init /path/to/repository
 ```
 
-`codenib wiki` selects the semantic route because the installed environment
-contains its dependencies. A smaller `python -m pip install codenib==0.2.0`
-installation selects the deterministic BM25 fallback and downloads no model.
-The [0.2 release notes](https://docs.codenib.ai/releases/0.2.0/) record the
-upgrade boundary and verification evidence.
+`codegraph init` detects Codex and Claude Code, installs only the detected
+languages' package-managed providers, builds reusable `bm25` and
+`symbol_graph` views, and asks each native client CLI to own its configuration.
+Run `codenib codegraph status /path/to/repository` to diagnose the complete
+path or `codenib codegraph uninstall /path/to/repository` to remove only the
+managed client registrations. The index remains reusable.
+
+For a browser Wiki with hybrid BM25+dense retrieval, install the semantic extra:
+
+```bash
+python -m pip install "codenib[semantic]==0.2.1"
+codenib wiki /path/to/repository
+```
 
-CodeNib detects the repository languages, builds a reusable index under
-`~/.codenib/repositories`, launches the local Wiki, and opens
-[http://localhost:3000](http://localhost:3000). The wheel includes the
-production Wiki frontend, so normal use does not require Node.js or npm and
-the target repository stays untouched. This command exercises the same compiler
-and serving runtime used by agents. Set `CODENIB_HOME` to relocate state.
+Both paths keep reusable state under `~/.codenib/repositories` and leave the
+target checkout unchanged. Set `CODENIB_HOME` to relocate state. The
+[0.2.1 release notes](https://docs.codenib.ai/releases/0.2.1/) record the
+upgrade boundary and installed-product evidence.
 
-Check the environment or index without opening the Wiki:
+Preview the CodeGraph operations without installing, indexing, or configuring
+an agent:
 
 ```bash
-codenib doctor --require core --require wiki
-codenib index /path/to/repository
+codenib codegraph init /path/to/repository --dry-run
 ```
 
 For a structural view, CodeNib detects the repository languages and manages
@@ -129,7 +146,7 @@ only their package-level providers; operating-system and project prerequisites
 remain explicit:
 
 ```bash
-python -m pip install "codenib[graph]==0.2.0"
+python -m pip install "codenib[graph]==0.2.1"
 codenib toolchain install /path/to/repository --scope graph
 codenib doctor /path/to/repository --require graph
 ```
@@ -167,25 +184,21 @@ for ports, advanced indexing, and troubleshooting.
 
 ## Serve An Agent
 
-Install the MCP extra, build once, and serve the same repository manifest over
-stdio:
+The recommended path configures installed Codex and Claude Code clients through
+their native CLIs:
 
 ```bash
-python -m pip install "codenib[mcp,semantic]==0.2.0"
-codenib index /path/to/repository
-codenib mcp /path/to/repository
+python -m pip install "codenib[graph,mcp]==0.2.1"
+codenib codegraph init /path/to/repository
 ```
 
-The MCP server advertises `search_context` as its default ranked entry point,
-then exposes the underlying BM25, vector, graph, and navigation operations for
-explicit control. It uses the compiled manifest to decide which calls have a
-fresh backing view. An agent can therefore reuse
-available repository work instead of rebuilding context through unbounded
-`grep` and `read` loops, while unavailable searches fail explicitly. BM25,
-semantic, regex, Zoekt, dependency, and static-navigation results retain source
-locations for follow-up reads and citations. See
-[MCP Server](https://docs.codenib.ai/mcp/)
-for client configuration and tool contracts.
+Ask the agent to start with `explore_context` for bounded, source-verified
+repository context and use `dependency_subgraph` for caller impact or callee
+dependencies. The MCP server also exposes ranked BM25, regex, definition,
+reference, route, and bounded source-read tools. See the
+[CodeGraph guide](https://docs.codenib.ai/codegraph/) for client scopes,
+diagnostics, uninstall behavior, and language prerequisites, and the
+[MCP Server](https://docs.codenib.ai/mcp/) for the complete tool contract.
 
 The same planner is available directly to Python agents:
 
@@ -210,7 +223,7 @@ capabilities, loaded views, fusion, graph, and reranking trace.
 | Retrieval | BM25, dense-vector, regex/trigram, Zoekt, fusion, and reranking paths; see the [validated model matrix](https://docs.codenib.ai/rag_ops/#validated-models) |
 | Structural context | SCIP/LSP-backed symbol graphs with source locations and typed edges |
 | MCP and LSP-shaped tools | Serve one manifest to coding agents without tying the runtime to one agent framework |
-| Agent compatibility | Reuse one manifest across revision-pinned [LocAgent](https://github.com/gersteinlab/LocAgent), [Agentless](https://github.com/OpenAutoCoder/Agentless), [CoSIL](https://github.com/ZhonghaoJiang/CoSIL), and [OrcaLoca](https://github.com/fishmingyu/OrcaLoca) contracts; see the [support matrix](https://docs.codenib.ai/agent_integrations/) |
+| Agent compatibility | Reuse one manifest across revision-pinned [LocAgent](https://github.com/gersteinlab/LocAgent), [Agentless](https://github.com/OpenAutoCoder/Agentless), [CoSIL](https://github.com/ZhonghaoJiang/CoSIL), and [OrcaLoca](https://github.com/fishmingyu/OrcaLoca) contracts, plus the published [RepoNavigator](https://arxiv.org/abs/2512.20957v6) `jump` contract over SCIP/LSP definition signals; see the [support matrix](https://docs.codenib.ai/agent_integrations/) |
 | Benchmark compatibility | Evaluate native exploration against pinned external datasets and scorers, including [SWE-Explore](https://github.com/Qiushao-E/SWE-Explore-Bench); see the [dataset and benchmark matrix](https://docs.codenib.ai/evaluation/) |
 | Local inspection | Audit the same context through Wiki pages, Ask answers, citations, and the Dependency Map |
 | Evaluation harness | Measure retrieval, navigation, incremental maintenance, and context policies on the same artifacts |