java-codebase-rag 0.9.1__py3-none-any.whl → 0.9.2__py3-none-any.whl

java_codebase_rag/jrag.py

@@ -812,11 +812,27 @@ def build_parser() -> argparse.ArgumentParser:
             "CALLS hops from the route handler. Intra-service is an INDEX-TIME data "
             "property: CALLS edges are intra-codebase by construction, and the query "
             "carries no microservice predicate, so the result reflects whatever the "
-            "fixture indexed (no query-time constraint). --max-hops clamped to 1..8."
+            "fixture indexed (no query-time constraint). --depth clamped to 1..8."
         ),
     )
-    flow.add_argument("query", help="Route path (e.g. '/chat/assign'). Resolved with hint_kind=route.")
-    flow.add_argument("--max-hops", type=int, default=5, dest="max_hops", help="Max CALLS hops (clamped 1..8, default 5).")
+    flow.add_argument(
+        "query",
+        help=(
+            "Route path (e.g. '/chat/assign') or Kafka topic name (e.g. "
+            "'banking.chat.compliance.review'). Resolved with hint_kind=route; "
+            "kafka_topic Routes match on topic."
+        ),
+    )
+    # Primary flag is --depth (consistent with callers/callees/impact/decompose).
+    # --max-hops is kept as a hidden back-compat alias (same dest).
+    flow.add_argument(
+        "--depth", type=int, default=5, dest="depth",
+        help="Max CALLS hops (clamped 1..8, default 5).",
+    )
+    flow.add_argument(
+        "--max-hops", type=int, dest="depth",
+        default=argparse.SUPPRESS, help=argparse.SUPPRESS,
+    )
     flow.set_defaults(handler=_cmd_flow)
 
     # ---- Compose traversals + file inspection (PR-JRAG-3b) ----
@@ -3001,7 +3017,7 @@ def _cmd_flow(args: argparse.Namespace) -> int:
         args, reason="trace_request_flow carries no microservice predicate; intra-codebase is an index-time data property"
     )
 
-    max_hops = max(1, min(8, getattr(args, "max_hops", 5)))
+    max_hops = max(1, min(8, getattr(args, "depth", 5)))
     flow_data = graph.trace_request_flow(entry_route_id=node.id, max_hops=max_hops)
 
     root_id = node.id

{java_codebase_rag-0.9.1.dist-info → java_codebase_rag-0.9.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: java-codebase-rag
-Version: 0.9.1
+Version: 0.9.2
 Summary: MCP server for semantic + structural search over Java codebases
 Author: HumanBean17
 License-Expression: MIT

{java_codebase_rag-0.9.1.dist-info → java_codebase_rag-0.9.2.dist-info}/RECORD

@@ -7,13 +7,13 @@ graph_types.py,sha256=P6RVdEiqZlaSgTyXepnGbtMoZq0m_MaP2q6M6i7Uxlc,4539
 index_common.py,sha256=HT6FKHFJ084eFvd3fR1j8z8gf4eWoPHVW8GXLpw464I,285
 java_index_flow_lancedb.py,sha256=kDkhnRxl-Kz0YNMY27DTk3gwa8H2nWyGDCQC8hxx-jI,28970
 java_index_v1_common.py,sha256=nF1KrSqboF_RRvWerG9knRRFmWwsrG_CvhgnsoZ8KqA,1154
-java_ontology.py,sha256=ooqr8GucOINpzhdEQ3QzVe5A9GfiR0nUTlySDehn9GA,17129
+java_ontology.py,sha256=eUGFa96GV_09s2f2sWSMdqYmoxU3-1pyU2iipvcDjG0,17219
 ladybug_queries.py,sha256=rVnVEHwWwE4USeX7tICYEl1SSiSxJGnBNe1VX66R3Xk,100531
 mcp_hints.py,sha256=zp-4cnOmbYD0YovmZiLS2oGcvWcWE7n8jKVz4_xifno,42512
 mcp_v2.py,sha256=ABNHiZEEwQ76uPF9E5fQWncJ4JmmgtG3vmt5TDxBGVo,68901
 path_filtering.py,sha256=R--XzI51LXBu5IBKMCnJWbkNr6I5d-SDmltyQQnWco0,17674
 pr_analysis.py,sha256=zrmZZD5yotJtM02Kif6_jgI_oeformOao793akp0N6Y,18394
-resolve_service.py,sha256=tC5FQsGmqhqn0EOexVDlRq5egnzKDTrI7CMzk0nPpG8,25135
+resolve_service.py,sha256=lTHPSn5zgIFjNICiOZc6m_bBJShTn72kShhkofwZdoE,26364
 search_lancedb.py,sha256=1sGSZ6H8J9hGcKAwHpzB7F0_in3A_sEtOI5LvlZYIRI,43864
 server.py,sha256=nOK3DOr-i3PJnVmE7neye_tptJumgXfIXPlTIn01MPQ,37065
 java_codebase_rag/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
@@ -24,7 +24,7 @@ java_codebase_rag/cli_format.py,sha256=CT7-xdwZ0bMCdP68_UOwkvm-mnLluU3LutlM-mDNk
 java_codebase_rag/cli_progress.py,sha256=q6Wh97yzLGs1B8UFk_WAKivfQu7Y5RnUUE-T2YHWkIs,3237
 java_codebase_rag/config.py,sha256=1EAlKtQx7LUo-gPoE6BOVLz0YEl1OpWFRABkF06zjgk,26464
 java_codebase_rag/installer.py,sha256=c-_tR1Ct_O3yhmruFRnDoM1Wilz-igD9qdkDPsNqLMI,79934
-java_codebase_rag/jrag.py,sha256=cVUWrKOtkwe2r4u1nknzmrMQMy16bdt1n-dZQpiSFWs,191811
+java_codebase_rag/jrag.py,sha256=KYv1pD_FTdYh0NqEwO_yzqgHiv5PDFcMiL26aA40QwI,192278
 java_codebase_rag/jrag_envelope.py,sha256=5jD3p2O-p9acAKHqoif5FFoqgP7Q2ziCuKSiPCHoywc,47505
 java_codebase_rag/jrag_hints.py,sha256=k2PFE4s3lZgBYHMdZcTjx1-w28nfQcBtQEVsSxI_DvE,9262
 java_codebase_rag/jrag_render.py,sha256=1nUyamL-MOOXDlKvssp-LsBgEtznUnGj_cPteSwuS90,31953
@@ -35,9 +35,9 @@ java_codebase_rag/install_data/agents/explorer-rag-cli.md,sha256=mMij_BIQM4agaYh
 java_codebase_rag/install_data/agents/explorer-rag-enhanced.md,sha256=gZsNFbuK0lSnOIlplbbS_muz2ozokJqvFUv65QM0NDM,10406
 java_codebase_rag/install_data/skills/explore-codebase/SKILL.md,sha256=A-v2dueVnxwBzBlxoRjZ2zOJk8DranLQ1TElwn94h0s,11529
 java_codebase_rag/install_data/skills/explore-codebase-cli/SKILL.md,sha256=V5gIKKGkgk2KlAFf9JqPareQDMt1iQOI7cwhfOqJL1c,11348
-java_codebase_rag-0.9.1.dist-info/licenses/LICENSE,sha256=gxvtiHtuviR_q8ZAjWw-QTcF3DyPzg6ZY-lQrr8OPpw,1068
-java_codebase_rag-0.9.1.dist-info/METADATA,sha256=v3Zl2nJ80PhrygxQD-aojw6z1CSZ_uRrOdkIWuA65No,20088
-java_codebase_rag-0.9.1.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-java_codebase_rag-0.9.1.dist-info/entry_points.txt,sha256=cj3QTc11UYVQnj9T3orc4daiIGaCYrXP149vKbH2R4U,168
-java_codebase_rag-0.9.1.dist-info/top_level.txt,sha256=8vC-VN3cMwz5vhkSTaeJ1a1bDeqLWEfrTks1CvEvIg0,273
-java_codebase_rag-0.9.1.dist-info/RECORD,,
+java_codebase_rag-0.9.2.dist-info/licenses/LICENSE,sha256=gxvtiHtuviR_q8ZAjWw-QTcF3DyPzg6ZY-lQrr8OPpw,1068
+java_codebase_rag-0.9.2.dist-info/METADATA,sha256=3lfDnbvPb-vpc_81VLNobOgdUKncX6ejy3TDUUSj4Vo,20088
+java_codebase_rag-0.9.2.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+java_codebase_rag-0.9.2.dist-info/entry_points.txt,sha256=cj3QTc11UYVQnj9T3orc4daiIGaCYrXP149vKbH2R4U,168
+java_codebase_rag-0.9.2.dist-info/top_level.txt,sha256=8vC-VN3cMwz5vhkSTaeJ1a1bDeqLWEfrTks1CvEvIg0,273
+java_codebase_rag-0.9.2.dist-info/RECORD,,

java_ontology.py

@@ -90,6 +90,8 @@ VALID_RESOLVE_REASONS: frozenset[str] = frozenset((
     "short_name",
     "route_template",
     "route_method_path",
+    "route_topic",
+    "route_topic_prefix",
     "client_target",
     "client_target_path",
     "client_name",
@@ -428,6 +430,8 @@ ResolveReason = Literal[
     "short_name",
     "route_template",
     "route_method_path",
+    "route_topic",
+    "route_topic_prefix",
     "client_target",
     "client_target_path",
     "client_name",

resolve_service.py

@@ -43,11 +43,13 @@ _RESOLVE_REASON_PRIORITY: dict[ResolveReason, int] = {
     "producer_topic_prefix": 1,
     "fqn_suffix": 2,
     "route_template": 2,
+    "route_topic": 2,
     "client_fqn": 2,
     "short_name": 3,
     "client_target": 3,
     "client_name": 3,
     "producer_topic": 3,
+    "route_topic_prefix": 3,
 }
 
 _SYMBOL_RESOLVE_RETURN = (
@@ -295,6 +297,28 @@ def _resolve_route_candidates(
             path_val = str(row.get("path_template") or row.get("path") or "")
             out.append((_node_ref_from_row("route", row), "route_template", len(path_val)))
 
+    # Kafka/topic routes carry their name in ``topic`` (``path``/``path_template``
+    # are empty), so path-based matching above cannot reach them. Match on
+    # ``r.topic`` the same way ``_resolve_producer_candidates`` matches
+    # ``p.topic`` — this lets ``flow``/``callers``/``overview`` resolve a
+    # ``kafka_topic`` Route by topic name. ``_drop_route_mirrors`` below then
+    # discards the no-EXPOSES producer phantom in favour of the server route.
+    rows = g._rows(  # noqa: SLF001
+        f"MATCH (r:Route) WHERE r.topic = $topic{scope} RETURN {_ROUTE_RESOLVE_RETURN} LIMIT $lim",
+        {"topic": identifier, "lim": lim, **scope_params},
+    )
+    for row in rows:
+        out.append((_node_ref_from_row("route", row), "route_topic", len(identifier)))
+
+    if not identifier.startswith("/"):
+        rows = g._rows(  # noqa: SLF001
+            f"MATCH (r:Route) WHERE r.topic STARTS WITH $topic{scope} "
+            f"RETURN {_ROUTE_RESOLVE_RETURN} LIMIT $lim",
+            {"topic": identifier, "lim": lim, **scope_params},
+        )
+        for row in rows:
+            out.append((_node_ref_from_row("route", row), "route_topic_prefix", len(identifier)))
+
     return _drop_route_mirrors(g, out)