java-codebase-rag 0.11.2__tar.gz → 0.12.0__tar.gz

{java_codebase_rag-0.11.2/src/java_codebase_rag.egg-info → java_codebase_rag-0.12.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: java-codebase-rag
-Version: 0.11.2
-Summary: MCP server for semantic + structural search over Java codebases
+Version: 0.12.0
+Summary: jrag (formerly java-codebase-rag) — MCP server + jrag CLI for semantic + structural search over Java/Kotlin codebases
 Author: HumanBean17
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/HumanBean17/java-codebase-rag
-Project-URL: Repository, https://github.com/HumanBean17/java-codebase-rag
-Project-URL: Issues, https://github.com/HumanBean17/java-codebase-rag/issues
-Keywords: mcp,java,rag,code-search,graph,lancedb,ladybug
+Project-URL: Homepage, https://github.com/HumanBean17/jrag
+Project-URL: Repository, https://github.com/HumanBean17/jrag
+Project-URL: Issues, https://github.com/HumanBean17/jrag/issues
+Keywords: jrag,java,mcp,rag,code-search,graph,lancedb,ladybug
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -35,6 +35,7 @@ Requires-Dist: rich<16,>=14
 Requires-Dist: sentence-transformers<6,>=5.4.0; sys_platform != "darwin" or platform_machine != "x86_64"
 Requires-Dist: tree-sitter<0.26,>=0.25.2
 Requires-Dist: tree-sitter-java<0.24,>=0.23.5
+Requires-Dist: tree-sitter-kotlin<2,>=1.1.0
 Requires-Dist: unidiff<1,>=0.7.3
 Requires-Dist: watchdog<7,>=6
 Provides-Extra: dev
@@ -44,7 +45,7 @@ Requires-Dist: pytest-xdist>=3; extra == "dev"
 Requires-Dist: ruff>=0.4; extra == "dev"
 Dynamic: license-file
 
-# java-codebase-rag
+# jrag
 
 A graph-native code intelligence layer for Java microservice estates, surfaced through the **`jrag` CLI** — one command per engineering intent. A **legacy MCP server** (`search` / `find` / `describe` / `neighbors` / `resolve`) is also available for existing setups. Both are thin surfaces over the same **AST Graph**: a deterministic property graph extracted from Java source with tree-sitter, stored **locally** in **LadybugDB** (graph) alongside a **LanceDB** vector index (chunks). There is no server to host and no cloud round-trip — the index lives on your disk and your source never leaves the machine. Both surfaces collapse onto three primitive operations: **locate**, **inspect**, **walk**.
 
@@ -82,15 +83,17 @@ The rest of this README is the install, the tool/command orientation, and the re
 ## Install
 
 ```bash
-pip install java-codebase-rag
+pip install jrag-cli
 ```
 
-Python **3.11+** required, on **Linux, macOS, and Windows**. On Linux, Windows, and **Apple Silicon** Macs every native dependency (LanceDB, LadybugDB, CocoIndex) ships a wheel and you get the full semantic + graph search. **Intel Macs (x86_64) install graph-only**: PyTorch ≥2.3 and LanceDB ≥0.26 dropped macOS Intel wheels, so the vector stack is auto-excluded via PEP 508 markers — `pip install java-codebase-rag` works out of the box, the graph layer (`find` / `describe` / `neighbors` / `resolve`) is fully usable, and the `search` tool falls back to **lexical search** over the symbol graph — BM25-ranked over a LadybugDB full-text index (same tool contract, keyword-ranked instead of semantic; an advisory notes the mode). Semantic/vector search needs Apple Silicon, Linux, or Windows. After install, `java-codebase-rag --help` should print the CLI groups.
+Python **3.11+** required, on **Linux, macOS, and Windows**. On Linux, Windows, and **Apple Silicon** Macs every native dependency (LanceDB, LadybugDB, CocoIndex) ships a wheel and you get the full semantic + graph search. **Intel Macs (x86_64) install graph-only**: PyTorch ≥2.3 and LanceDB ≥0.26 dropped macOS Intel wheels, so the vector stack is auto-excluded via PEP 508 markers — `pip install jrag-cli` works out of the box, the graph layer (`find` / `describe` / `neighbors` / `resolve`) is fully usable, and the `search` tool falls back to **lexical search** over the symbol graph — BM25-ranked over a LadybugDB full-text index (same tool contract, keyword-ranked instead of semantic; an advisory notes the mode). Semantic/vector search needs Apple Silicon, Linux, or Windows. After install, `jrag --help` should print the CLI groups.
 The package includes the CocoIndex lifecycle dependency used by `init`, `increment`, `reprocess`, and `erase` on platforms that have it (it is absent on Intel Mac).
 
+**Kotlin (`.kt`) is indexed alongside Java (`.java`)** — both feed one merged AST graph (a Kotlin class can implement a Java interface and vice versa). Kotlin parsing requires the `tree-sitter-kotlin` grammar; if it fails to import, `.kt` files are skipped and Java-only indexing proceeds. **Intel Mac note:** `tree-sitter-kotlin` currently ships a macOS x86_64 wheel, so Kotlin indexing works there today; if a future release drops that wheel, Kotlin indexing degrades off on Intel Mac while the Java graph keeps working. See `docs/CODEBASE_REQUIREMENTS.md` A.1 for the v1 Kotlin limitations (extension-function calls unresolved; non-Spring frameworks out of scope; generated-code classification Java-only).
+
 ### Interactive setup (recommended)
 
-Run `java-codebase-rag install` from your Java project root to launch an interactive setup wizard that:
+Run `jrag install` from your Java project root to launch an interactive setup wizard that:
 
 1. Detects Java source directories (Maven/Gradle modules)
 2. Configures the embedding model (auto-downloads ~90MB or uses a local path)
@@ -101,19 +104,19 @@ Run `java-codebase-rag install` from your Java project root to launch an interac
 
 ```bash
 # Interactive mode
-java-codebase-rag install
+jrag install
 
 # Non-interactive mode (for CI/automation)
-java-codebase-rag install --non-interactive --agent claude-code
+jrag install --non-interactive --agent claude-code
 ```
 
-After `pip install --upgrade java-codebase-rag`, run `java-codebase-rag update` to refresh shipped artifacts and catch up the index (Lance + graph).
+After `pip install --upgrade jrag-cli`, run `jrag update` to refresh shipped artifacts and catch up the index (Lance + graph).
 
 All indexing lifecycle commands (`init`, `increment`, `reprocess`, `install`, `update`) show a unified `Vectors → Optimize → Graph` progress bar on stderr during the index build (powered by `rich`); pass `--quiet` to suppress it.
 
 ### Manual registration
 
-If you prefer manual configuration, see [`docs/JAVA-CODEBASE-RAG-CLI.md`](./docs/JAVA-CODEBASE-RAG-CLI.md) for the full CLI reference.
+If you prefer manual configuration, see [`docs/JRAG-CLI.md`](./docs/JRAG-CLI.md) for the full CLI reference.
 
 > **Stability disclaimer.** This package does **not** promise backward compatibility. MCP tool contracts, env vars, Lance/LadybugDB schemas, config files, and Python APIs may change without a deprecation period. Track `main` and rebuild indexes when ontology or embedding settings change.
 
@@ -121,7 +124,7 @@ If you prefer manual configuration, see [`docs/JAVA-CODEBASE-RAG-CLI.md`](./docs
 
 ## Tools & commands at a glance
 
-`jrag` is the default and recommended surface (`java-codebase-rag install --surface cli`). The **MCP server** (`--surface mcp`) is kept as a **legacy** option for existing setups. Both surfaces walk the same LanceDB vectors + LadybugDB **AST Graph**. Switch an existing install later with `java-codebase-rag update --surface mcp|cli`.
+`jrag` is the default and recommended surface (`jrag install --surface cli`). The **MCP server** (`--surface mcp`) is kept as a **legacy** option for existing setups. Both surfaces walk the same LanceDB vectors + LadybugDB **AST Graph**. Switch an existing install later with `jrag update --surface mcp|cli`.
 
 **CLI surface — `jrag`, one command per engineering intent**
 
@@ -213,7 +216,7 @@ The operator-facing surface is small: pick an index dir, pick an embedding model
 
 ## CLI cheat sheet
 
-Run `java-codebase-rag --help` to list grouped subcommands. Operator playbook with workflows, exit codes, and env alignment lives in [`docs/JAVA-CODEBASE-RAG-CLI.md`](./docs/JAVA-CODEBASE-RAG-CLI.md).
+Run `jrag --help` to list grouped subcommands. Operator playbook with workflows, exit codes, and env alignment lives in [`docs/JRAG-CLI.md`](./docs/JRAG-CLI.md).
 
 | Group | Subcommand | What it does |
 |---|---|---|
@@ -230,8 +233,8 @@ Run `java-codebase-rag --help` to list grouped subcommands. Operator playbook wi
 
 ## jrag — agent CLI
 
-`jrag` is a separate console script (alongside `java-codebase-rag`) built for AI
-coding agents. It gives the agent **one command per engineering intent** and
+`jrag` is the unified console script (operator + agent verbs) built for AI
+coding agents and operators alike. It gives the agent **one command per engineering intent** and
 takes human-readable identifiers (FQN / simple name / route path / topic) —
 never raw node IDs. Every `<query>` command resolves the identifier via
 `resolve_v2` as the first step; on `many` it returns candidates and stops, on
@@ -285,7 +288,7 @@ A missing or stale index produces an actionable `status: error` envelope (exit
 2) rather than a traceback:
 
 ```
-error: No index at /path/to/code_graph.lbug. Run: java-codebase-rag init --source-root <root>
+error: No index at /path/to/code_graph.lbug. Run: jrag init --source-root <root>
 ```
 
 See [`plans/active/PLAN-JRAG-CLI.md`](./plans/active/PLAN-JRAG-CLI.md) for the
@@ -300,7 +303,7 @@ full design and per-PR breakdown.
 | [`docs/paper/paper.pdf`](./docs/paper/paper.pdf) | Architecture report — design rationale, GPS metaphor, three-layer architecture, design principles, future work. |
 | [`docs/AGENT-GUIDE.md`](./docs/AGENT-GUIDE.md) | Agent-facing guide. Copy-paste into `QWEN.md` / `CLAUDE.md` / `AGENTS.md`. |
 | [`docs/CONFIGURATION.md`](./docs/CONFIGURATION.md) | Environment variables, project YAML, graph ontology, brownfield overrides, ignore patterns. |
-| [`docs/JAVA-CODEBASE-RAG-CLI.md`](./docs/JAVA-CODEBASE-RAG-CLI.md) | CLI operator playbook: workflows, exit codes, env alignment. |
+| [`docs/JRAG-CLI.md`](./docs/JRAG-CLI.md) | CLI operator playbook: workflows, exit codes, env alignment. |
 | [`docs/EDGE-NAVIGATION.md`](./docs/EDGE-NAVIGATION.md) | MCP-traversable edges, directions, dot-key composition. |
 | [`skills/`](./skills/) | `/explore-codebase-cli` (CLI surface) + `/explore-codebase` (legacy MCP surface) skills — operating manuals for hosts with skill discovery (alternative to copy-pasting AGENT-GUIDE). See [`skills/README.md`](./skills/README.md). |
 | [`docs/MANUAL-VERIFICATION-CHECKLIST.md`](./docs/MANUAL-VERIFICATION-CHECKLIST.md) | 7-phase agent-driven verification after indexing your project. |
@@ -312,8 +315,8 @@ full design and per-PR breakdown.
 ## Install from source (contributors)
 
 ```bash
-git clone https://github.com/HumanBean17/java-codebase-rag
-cd java-codebase-rag
+git clone https://github.com/HumanBean17/jrag
+cd jrag
 python3 -m venv .venv
 .venv/bin/pip install -e ".[dev]"
 ```
@@ -329,3 +332,9 @@ The default embedding model is `sentence-transformers/all-MiniLM-L6-v2` (downloa
 - `get_service_topology` — microservice-level summary aggregating `HTTP_CALLS` / `ASYNC_CALLS`.
 - Agentic routing layer (query classifier → vector / graph / both).
 - Optional `codegraph_nodes` LanceDB table embedding symbol summaries so the graph itself is vector-searchable.
+
+---
+
+## Built on
+
+The indexing pipeline runs on [**CocoIndex**](https://github.com/cocoindex-io/cocoindex) — an open-source data indexing framework that powers the vector store lifecycle (`init`, `increment`, `reprocess`, `erase`) behind every `jrag` index.

{java_codebase_rag-0.11.2 → java_codebase_rag-0.12.0}/README.md

@@ -1,4 +1,4 @@
-# java-codebase-rag
+# jrag
 
 A graph-native code intelligence layer for Java microservice estates, surfaced through the **`jrag` CLI** — one command per engineering intent. A **legacy MCP server** (`search` / `find` / `describe` / `neighbors` / `resolve`) is also available for existing setups. Both are thin surfaces over the same **AST Graph**: a deterministic property graph extracted from Java source with tree-sitter, stored **locally** in **LadybugDB** (graph) alongside a **LanceDB** vector index (chunks). There is no server to host and no cloud round-trip — the index lives on your disk and your source never leaves the machine. Both surfaces collapse onto three primitive operations: **locate**, **inspect**, **walk**.
 
@@ -36,15 +36,17 @@ The rest of this README is the install, the tool/command orientation, and the re
 ## Install
 
 ```bash
-pip install java-codebase-rag
+pip install jrag-cli
 ```
 
-Python **3.11+** required, on **Linux, macOS, and Windows**. On Linux, Windows, and **Apple Silicon** Macs every native dependency (LanceDB, LadybugDB, CocoIndex) ships a wheel and you get the full semantic + graph search. **Intel Macs (x86_64) install graph-only**: PyTorch ≥2.3 and LanceDB ≥0.26 dropped macOS Intel wheels, so the vector stack is auto-excluded via PEP 508 markers — `pip install java-codebase-rag` works out of the box, the graph layer (`find` / `describe` / `neighbors` / `resolve`) is fully usable, and the `search` tool falls back to **lexical search** over the symbol graph — BM25-ranked over a LadybugDB full-text index (same tool contract, keyword-ranked instead of semantic; an advisory notes the mode). Semantic/vector search needs Apple Silicon, Linux, or Windows. After install, `java-codebase-rag --help` should print the CLI groups.
+Python **3.11+** required, on **Linux, macOS, and Windows**. On Linux, Windows, and **Apple Silicon** Macs every native dependency (LanceDB, LadybugDB, CocoIndex) ships a wheel and you get the full semantic + graph search. **Intel Macs (x86_64) install graph-only**: PyTorch ≥2.3 and LanceDB ≥0.26 dropped macOS Intel wheels, so the vector stack is auto-excluded via PEP 508 markers — `pip install jrag-cli` works out of the box, the graph layer (`find` / `describe` / `neighbors` / `resolve`) is fully usable, and the `search` tool falls back to **lexical search** over the symbol graph — BM25-ranked over a LadybugDB full-text index (same tool contract, keyword-ranked instead of semantic; an advisory notes the mode). Semantic/vector search needs Apple Silicon, Linux, or Windows. After install, `jrag --help` should print the CLI groups.
 The package includes the CocoIndex lifecycle dependency used by `init`, `increment`, `reprocess`, and `erase` on platforms that have it (it is absent on Intel Mac).
 
+**Kotlin (`.kt`) is indexed alongside Java (`.java`)** — both feed one merged AST graph (a Kotlin class can implement a Java interface and vice versa). Kotlin parsing requires the `tree-sitter-kotlin` grammar; if it fails to import, `.kt` files are skipped and Java-only indexing proceeds. **Intel Mac note:** `tree-sitter-kotlin` currently ships a macOS x86_64 wheel, so Kotlin indexing works there today; if a future release drops that wheel, Kotlin indexing degrades off on Intel Mac while the Java graph keeps working. See `docs/CODEBASE_REQUIREMENTS.md` A.1 for the v1 Kotlin limitations (extension-function calls unresolved; non-Spring frameworks out of scope; generated-code classification Java-only).
+
 ### Interactive setup (recommended)
 
-Run `java-codebase-rag install` from your Java project root to launch an interactive setup wizard that:
+Run `jrag install` from your Java project root to launch an interactive setup wizard that:
 
 1. Detects Java source directories (Maven/Gradle modules)
 2. Configures the embedding model (auto-downloads ~90MB or uses a local path)
@@ -55,19 +57,19 @@ Run `java-codebase-rag install` from your Java project root to launch an interac
 
 ```bash
 # Interactive mode
-java-codebase-rag install
+jrag install
 
 # Non-interactive mode (for CI/automation)
-java-codebase-rag install --non-interactive --agent claude-code
+jrag install --non-interactive --agent claude-code
 ```
 
-After `pip install --upgrade java-codebase-rag`, run `java-codebase-rag update` to refresh shipped artifacts and catch up the index (Lance + graph).
+After `pip install --upgrade jrag-cli`, run `jrag update` to refresh shipped artifacts and catch up the index (Lance + graph).
 
 All indexing lifecycle commands (`init`, `increment`, `reprocess`, `install`, `update`) show a unified `Vectors → Optimize → Graph` progress bar on stderr during the index build (powered by `rich`); pass `--quiet` to suppress it.
 
 ### Manual registration
 
-If you prefer manual configuration, see [`docs/JAVA-CODEBASE-RAG-CLI.md`](./docs/JAVA-CODEBASE-RAG-CLI.md) for the full CLI reference.
+If you prefer manual configuration, see [`docs/JRAG-CLI.md`](./docs/JRAG-CLI.md) for the full CLI reference.
 
 > **Stability disclaimer.** This package does **not** promise backward compatibility. MCP tool contracts, env vars, Lance/LadybugDB schemas, config files, and Python APIs may change without a deprecation period. Track `main` and rebuild indexes when ontology or embedding settings change.
 
@@ -75,7 +77,7 @@ If you prefer manual configuration, see [`docs/JAVA-CODEBASE-RAG-CLI.md`](./docs
 
 ## Tools & commands at a glance
 
-`jrag` is the default and recommended surface (`java-codebase-rag install --surface cli`). The **MCP server** (`--surface mcp`) is kept as a **legacy** option for existing setups. Both surfaces walk the same LanceDB vectors + LadybugDB **AST Graph**. Switch an existing install later with `java-codebase-rag update --surface mcp|cli`.
+`jrag` is the default and recommended surface (`jrag install --surface cli`). The **MCP server** (`--surface mcp`) is kept as a **legacy** option for existing setups. Both surfaces walk the same LanceDB vectors + LadybugDB **AST Graph**. Switch an existing install later with `jrag update --surface mcp|cli`.
 
 **CLI surface — `jrag`, one command per engineering intent**
 
@@ -167,7 +169,7 @@ The operator-facing surface is small: pick an index dir, pick an embedding model
 
 ## CLI cheat sheet
 
-Run `java-codebase-rag --help` to list grouped subcommands. Operator playbook with workflows, exit codes, and env alignment lives in [`docs/JAVA-CODEBASE-RAG-CLI.md`](./docs/JAVA-CODEBASE-RAG-CLI.md).
+Run `jrag --help` to list grouped subcommands. Operator playbook with workflows, exit codes, and env alignment lives in [`docs/JRAG-CLI.md`](./docs/JRAG-CLI.md).
 
 | Group | Subcommand | What it does |
 |---|---|---|
@@ -184,8 +186,8 @@ Run `java-codebase-rag --help` to list grouped subcommands. Operator playbook wi
 
 ## jrag — agent CLI
 
-`jrag` is a separate console script (alongside `java-codebase-rag`) built for AI
-coding agents. It gives the agent **one command per engineering intent** and
+`jrag` is the unified console script (operator + agent verbs) built for AI
+coding agents and operators alike. It gives the agent **one command per engineering intent** and
 takes human-readable identifiers (FQN / simple name / route path / topic) —
 never raw node IDs. Every `<query>` command resolves the identifier via
 `resolve_v2` as the first step; on `many` it returns candidates and stops, on
@@ -239,7 +241,7 @@ A missing or stale index produces an actionable `status: error` envelope (exit
 2) rather than a traceback:
 
 ```
-error: No index at /path/to/code_graph.lbug. Run: java-codebase-rag init --source-root <root>
+error: No index at /path/to/code_graph.lbug. Run: jrag init --source-root <root>
 ```
 
 See [`plans/active/PLAN-JRAG-CLI.md`](./plans/active/PLAN-JRAG-CLI.md) for the
@@ -254,7 +256,7 @@ full design and per-PR breakdown.
 | [`docs/paper/paper.pdf`](./docs/paper/paper.pdf) | Architecture report — design rationale, GPS metaphor, three-layer architecture, design principles, future work. |
 | [`docs/AGENT-GUIDE.md`](./docs/AGENT-GUIDE.md) | Agent-facing guide. Copy-paste into `QWEN.md` / `CLAUDE.md` / `AGENTS.md`. |
 | [`docs/CONFIGURATION.md`](./docs/CONFIGURATION.md) | Environment variables, project YAML, graph ontology, brownfield overrides, ignore patterns. |
-| [`docs/JAVA-CODEBASE-RAG-CLI.md`](./docs/JAVA-CODEBASE-RAG-CLI.md) | CLI operator playbook: workflows, exit codes, env alignment. |
+| [`docs/JRAG-CLI.md`](./docs/JRAG-CLI.md) | CLI operator playbook: workflows, exit codes, env alignment. |
 | [`docs/EDGE-NAVIGATION.md`](./docs/EDGE-NAVIGATION.md) | MCP-traversable edges, directions, dot-key composition. |
 | [`skills/`](./skills/) | `/explore-codebase-cli` (CLI surface) + `/explore-codebase` (legacy MCP surface) skills — operating manuals for hosts with skill discovery (alternative to copy-pasting AGENT-GUIDE). See [`skills/README.md`](./skills/README.md). |
 | [`docs/MANUAL-VERIFICATION-CHECKLIST.md`](./docs/MANUAL-VERIFICATION-CHECKLIST.md) | 7-phase agent-driven verification after indexing your project. |
@@ -266,8 +268,8 @@ full design and per-PR breakdown.
 ## Install from source (contributors)
 
 ```bash
-git clone https://github.com/HumanBean17/java-codebase-rag
-cd java-codebase-rag
+git clone https://github.com/HumanBean17/jrag
+cd jrag
 python3 -m venv .venv
 .venv/bin/pip install -e ".[dev]"
 ```
@@ -283,3 +285,9 @@ The default embedding model is `sentence-transformers/all-MiniLM-L6-v2` (downloa
 - `get_service_topology` — microservice-level summary aggregating `HTTP_CALLS` / `ASYNC_CALLS`.
 - Agentic routing layer (query classifier → vector / graph / both).
 - Optional `codegraph_nodes` LanceDB table embedding symbol summaries so the graph itself is vector-searchable.
+
+---
+
+## Built on
+
+The indexing pipeline runs on [**CocoIndex**](https://github.com/cocoindex-io/cocoindex) — an open-source data indexing framework that powers the vector store lifecycle (`init`, `increment`, `reprocess`, `erase`) behind every `jrag` index.

{java_codebase_rag-0.11.2 → java_codebase_rag-0.12.0}/pyproject.toml

@@ -4,15 +4,15 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "java-codebase-rag"
-version = "0.11.2"
-description = "MCP server for semantic + structural search over Java codebases"
+version = "0.12.0"
+description = "jrag (formerly java-codebase-rag) — MCP server + jrag CLI for semantic + structural search over Java/Kotlin codebases"
 readme = "README.md"
 requires-python = ">=3.11"
 license = "MIT"
 authors = [
     { name = "HumanBean17" },
 ]
-keywords = ["mcp", "java", "rag", "code-search", "graph", "lancedb", "ladybug"]
+keywords = ["jrag", "java", "mcp", "rag", "code-search", "graph", "lancedb", "ladybug"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
@@ -46,6 +46,7 @@ dependencies = [
     "sentence-transformers>=5.4.0,<6; sys_platform != 'darwin' or platform_machine != 'x86_64'",
     "tree-sitter>=0.25.2,<0.26",
     "tree-sitter-java>=0.23.5,<0.24",
+    "tree-sitter-kotlin>=1.1.0,<2",
     "unidiff>=0.7.3,<1",
     "watchdog>=6,<7",
 ]
@@ -59,14 +60,15 @@ dev = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/HumanBean17/java-codebase-rag"
-Repository = "https://github.com/HumanBean17/java-codebase-rag"
-Issues = "https://github.com/HumanBean17/java-codebase-rag/issues"
+Homepage = "https://github.com/HumanBean17/jrag"
+Repository = "https://github.com/HumanBean17/jrag"
+Issues = "https://github.com/HumanBean17/jrag/issues"
 
 [project.scripts]
-java-codebase-rag = "java_codebase_rag.cli:_console_script_main"
+jrag = "java_codebase_rag.cli_dispatch:_console_script_main"
+jrag-mcp = "java_codebase_rag.mcp.server:main"
+java-codebase-rag = "java_codebase_rag.cli_dispatch:_console_script_main"
 java-codebase-rag-mcp = "java_codebase_rag.mcp.server:main"
-jrag = "java_codebase_rag.jrag:_console_script_main"
 
 [tool.setuptools.packages.find]
 where = ["src"]

java_codebase_rag-0.12.0/src/java_codebase_rag/_deprecation.py

@@ -0,0 +1,103 @@
+"""Legacy-alias deprecation notice for the ``jrag`` rename.
+
+The tool is being renamed from ``java-codebase-rag`` to ``jrag``. The legacy
+command aliases (``java-codebase-rag`` and ``java-codebase-rag-mcp``) continue
+to work; when invoked through one of them in an interactive context, this
+helper emits a single-line notice pointing the operator at the new name.
+
+Suppression rule
+----------------
+The notice is suppressed when **either** of the following holds:
+
+* ``$JRAG_NO_DEPRECATION`` is present and non-empty — any non-empty value
+  suppresses (so ``"1"``, ``"0"``, ``"false"``, ``"yes"`` all suppress; the
+  empty string and an unset variable do not). The simpler "present and
+  non-empty" rule is preferred over parsing truthy values so that operators
+  can shut the notice up with whatever value is easiest to reach for.
+* ``sys.stderr.isatty()`` is false (or ``sys.stderr`` lacks ``isatty``) — i.e.
+  non-interactive contexts: piped, redirected, or captured stderr. Under real
+  MCP use stderr is not a TTY, so the call is silent in production; it exists
+  for the rare human-debug case.
+
+This module is stdlib-only and import-light: it runs at MCP-server startup and
+before ``--help``, so it must not pull in any backend (cli, search, mcp) code.
+"""
+from __future__ import annotations
+
+import os
+import sys
+
+_LEGACY_ALIASES = frozenset({"java-codebase-rag", "java-codebase-rag-mcp"})
+
+_DEPRECATION_LINE = (
+    "jrag: 'java-codebase-rag' is now 'jrag'; this alias continues to work. "
+    "Set JRAG_NO_DEPRECATION=1 to silence.\n"
+)
+
+#: Executable suffixes appended by Windows (and packaging tools like pip) to
+#: console-script wrappers. All three are exactly 4 characters long (``.exe``,
+#: ``.bat``, ``.cmd``) so a single ``b[:-4]`` slice strips any of them. Stripping
+#: keeps routing decisions stable across POSIX and Windows installs:
+#: ``C:\\Users\\foo\\Scripts\\jrag.exe`` → ``"jrag"``;
+#: ``...\\java-codebase-rag.exe`` → ``"java-codebase-rag"``.
+_WINDOWS_EXE_SUFFIXES: tuple[str, ...] = (".exe", ".bat", ".cmd")
+
+
+def _invoked_program_name() -> str:
+    """Basename of ``sys.argv[0]`` with a Windows executable suffix stripped.
+
+    Returns the empty string when ``sys.argv`` is empty. Otherwise takes
+    ``os.path.basename(sys.argv[0])`` and, if it ends (case-insensitively) with
+    one of ``.exe`` / ``.bat`` / ``.cmd``, drops the 4-character suffix.
+
+    Shared with :mod:`java_codebase_rag.cli_dispatch` for identity-default
+    routing: both legacy-alias deprecation here and ``jrag``-vs-alias routing
+    there rely on the same canonicalized basename. Without this, Windows builds
+    would route ``jrag.exe --version`` through the wrong parser and never emit
+    the deprecation notice for ``java-codebase-rag.exe``.
+    """
+    argv = sys.argv
+    if not argv:
+        return ""
+    base = os.path.basename(argv[0])
+    if base.lower().endswith(_WINDOWS_EXE_SUFFIXES):
+        return base[:-4]
+    return base
+
+
+def _stderr_is_tty() -> bool:
+    """True iff ``sys.stderr`` reports itself as a TTY.
+
+    Defensive against stderr replacements that omit ``isatty``.
+    """
+    stderr = sys.stderr
+    return hasattr(stderr, "isatty") and stderr.isatty()
+
+
+def _suppressed() -> bool:
+    """True iff the notice should be suppressed."""
+    if os.environ.get("JRAG_NO_DEPRECATION"):
+        return True
+    return not _stderr_is_tty()
+
+
+def maybe_warn_legacy_alias(stream=None) -> None:
+    """Emit a one-line legacy-alias deprecation notice when appropriate.
+
+    Detects a legacy invocation (``sys.argv[0]`` basename is exactly
+    ``java-codebase-rag`` or ``java-codebase-rag-mcp``) and, if not suppressed,
+    writes a single line to ``stream`` (defaulting to ``sys.stderr``). Never
+    raises: any error inside the write is swallowed so the rename helper can
+    never break tool startup.
+
+    See module docstring for the suppression rule.
+    """
+    if _invoked_program_name() not in _LEGACY_ALIASES:
+        return
+    if _suppressed():
+        return
+    target = stream if stream is not None else sys.stderr
+    try:
+        target.write(_DEPRECATION_LINE)
+    except Exception:  # pragma: no cover - defensive: never break startup
+        return

{java_codebase_rag-0.11.2 → java_codebase_rag-0.12.0}/src/java_codebase_rag/_version.py

@@ -1,7 +1,7 @@
 """Version string for the CLI ``--version`` flag.
 
 The single source of truth is the installed distribution metadata
-(``java-codebase-rag`` in pyproject.toml), read via :mod:`importlib.metadata`
+(``jrag-cli`` in pyproject.toml), read via :mod:`importlib.metadata`
 so a pyproject bump propagates with no second hardcoded copy.
 :func:`version_string` appends the CPython version for the
 ``<prog> <version> (python <x.y.z>)`` format chosen for the ``--version`` flag.
@@ -15,7 +15,7 @@ import platform
 from importlib.metadata import PackageNotFoundError
 from importlib.metadata import version as _dist_version
 
-_PACKAGE = "java-codebase-rag"
+_PACKAGE = "jrag-cli"
 
 
 def package_version() -> str:

{java_codebase_rag-0.11.2 → java_codebase_rag-0.12.0}/src/java_codebase_rag/ast/ast_java.py

@@ -249,6 +249,11 @@ class AnnotationRef:
     container_capability_values: tuple[str, ...] = field(default_factory=tuple)
     # Entry-aligned with `container_capability_values`; each value is "enum" | "string".
     container_capability_kinds: tuple[str, ...] = field(default_factory=tuple)
+    # Kotlin use-site target (one of "field"|"get"|"set"|"param"|"property"|"file") or
+    # None. Java ``parse_java`` always leaves this None — Java has no use-site targets.
+    # This is an AST-level field (not a persisted graph column); it drives Kotlin-only
+    # routing of an annotation to the FieldDecl / accessor MethodDecl / ParamDecl slot.
+    use_site_target: str | None = None
 
 
 @dataclass
@@ -394,11 +399,26 @@ class JavaFileAst:
     explicit_imports: dict[str, str]  # "List" -> "java.util.List"
     top_level_types: list[TypeDecl]
     all_types: list[TypeDecl]  # flat, includes nested
+    # Language-dispatch seam (Task 1). Required — no default — so every
+    # construction site names the language explicitly. Validated against the
+    # registry in ``language.KNOWN_LANGUAGE_IDS``. Lazily imported inside
+    # ``__post_init__`` to avoid a module-load cycle (``language`` imports
+    # ``JavaFileAst``/``parse_java`` from this module).
+    language: str
     parse_error: bool = False
     source_bytes: int = 0
     file_imports: FileImports = field(default_factory=FileImports)
     routes_skipped_unresolved: int = 0
 
+    def __post_init__(self) -> None:
+        from .language import KNOWN_LANGUAGE_IDS
+
+        if self.language not in KNOWN_LANGUAGE_IDS:
+            raise ValueError(
+                f"Unknown language id {self.language!r}; "
+                f"expected one of {sorted(KNOWN_LANGUAGE_IDS)}"
+            )
+
 
 @dataclass
 class _ParseCtx:
@@ -2625,6 +2645,7 @@ def parse_java(source: bytes | str, *, filename: str = "", verbose: bool = False
         explicit_imports={},
         top_level_types=[],
         all_types=[],
+        language="java",
         parse_error=False,
         source_bytes=len(src),
         file_imports=FileImports(),
@@ -2710,6 +2731,7 @@ def parse_java(source: bytes | str, *, filename: str = "", verbose: bool = False
         explicit_imports=explicit_imports,
         top_level_types=top_types,
         all_types=all_types,
+        language="java",
         parse_error=root.has_error,
         source_bytes=len(src),
         file_imports=file_imports,