codespine 1.0.12__tar.gz → 1.0.13__tar.gz

{codespine-1.0.12 → codespine-1.0.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codespine
-Version: 1.0.12
+Version: 1.0.13
 Summary: Local Java code intelligence indexer backed by a graph database
 Author: CodeSpine contributors
 License: MIT License
@@ -66,7 +66,7 @@ Dynamic: license-file
 
 # CodeSpine
 
-**v1.0.12** — Local Java code intelligence for coding agents, backed by a graph database.
+**v1.0.13** — Local Java code intelligence for coding agents, backed by a graph database.
 
 CodeSpine cuts token burn for coding agents working on Java codebases.
 

{codespine-1.0.12 → codespine-1.0.13}/README.md

@@ -1,6 +1,6 @@
 # CodeSpine
 
-**v1.0.12** — Local Java code intelligence for coding agents, backed by a graph database.
+**v1.0.13** — Local Java code intelligence for coding agents, backed by a graph database.
 
 CodeSpine cuts token burn for coding agents working on Java codebases.
 

{codespine-1.0.12 → codespine-1.0.13}/codespine/__init__.py

@@ -1,4 +1,4 @@
 """CodeSpine package."""
 
 __all__ = ["__version__"]
-__version__ = "1.0.12"
+__version__ = "1.0.13"

{codespine-1.0.12 → codespine-1.0.13}/codespine/search/hybrid.py

@@ -1,6 +1,8 @@
 from __future__ import annotations
 
+import logging
 import os
+from itertools import product
 
 from codespine.overlay.merge import merged_symbol_records
 from codespine.search.bm25 import rank_bm25
@@ -8,6 +10,8 @@ from codespine.search.fuzzy import rank_fuzzy
 from codespine.search.rrf import reciprocal_rank_fusion
 from codespine.search.vector import _load_model, rank_semantic
 
+LOGGER = logging.getLogger(__name__)
+
 _LOW_CONFIDENCE_THRESHOLD = 0.05
 _SNIPPET_CONTEXT_LINES = 2  # lines above and below the symbol declaration
 
@@ -29,6 +33,46 @@ def _read_snippet(file_path: str, line: int, context: int = _SNIPPET_CONTEXT_LIN
         return None
 
 
+def _context_entry(
+    community: dict | None = None,
+    flow: dict | None = None,
+) -> dict[str, object]:
+    return {
+        "community_id": community.get("community_id") if community else None,
+        "community_label": community.get("community_label") if community else None,
+        "flow_id": flow.get("flow_id") if flow else None,
+        "flow_kind": flow.get("flow_kind") if flow else None,
+        "flow_depth": flow.get("flow_depth") if flow else None,
+    }
+
+
+def _load_symbol_context(store, symbol_id: str) -> list[dict[str, object]]:
+    community_rows = store.query_records(
+        """
+        MATCH (s:Symbol {id: $sid})-[:IN_COMMUNITY]->(c:Community)
+        RETURN c.id as community_id, c.label as community_label
+        LIMIT 3
+        """,
+        {"sid": symbol_id},
+    )
+    flow_rows = store.query_records(
+        """
+        MATCH (s:Symbol {id: $sid})-[f:IN_FLOW]->(fl:Flow)
+        RETURN fl.id as flow_id, fl.kind as flow_kind, f.depth as flow_depth
+        LIMIT 3
+        """,
+        {"sid": symbol_id},
+    )
+
+    if community_rows and flow_rows:
+        return [_context_entry(community, flow) for community, flow in product(community_rows, flow_rows)][:3]
+    if community_rows:
+        return [_context_entry(community=community) for community in community_rows][:3]
+    if flow_rows:
+        return [_context_entry(flow=flow) for flow in flow_rows][:3]
+    return []
+
+
 def hybrid_search(store, query: str, k: int = 20, project: str | None = None) -> list[dict]:
     overlay_store = getattr(store, "overlay_store", None)
     if overlay_store is not None:
@@ -105,19 +149,15 @@ def hybrid_search(store, query: str, k: int = 20, project: str | None = None) ->
     results.sort(key=lambda x: x["score"], reverse=True)
     top_k = results[:k]
 
-    # Attach architectural context in same response.
+    # Attach architectural context in the same response. This is best-effort:
+    # a context query failure must not hide ranked symbol results.
     for item in top_k:
-        ctx = store.query_records(
-            """
-            MATCH (s:Symbol {id: $sid})-[:IN_COMMUNITY]->(c:Community)
-            OPTIONAL MATCH (s)-[f:IN_FLOW]->(fl:Flow)
-            RETURN c.id as community_id, c.label as community_label,
-                   fl.id as flow_id, fl.kind as flow_kind, f.depth as flow_depth
-            LIMIT 3
-            """,
-            {"sid": item["id"]},
-        )
-        item["context"] = ctx
+        try:
+            item["context"] = _load_symbol_context(store, item["id"])
+        except Exception as exc:  # noqa: BLE001
+            LOGGER.warning("Unable to load architectural context for %s: %s", item.get("id"), exc)
+            item["context"] = []
+            item["context_warning"] = "Architectural context unavailable for this result."
 
     # Attach source code snippets (3–5 lines around the declaration) to the
     # top results so agents have immediate context without reading the file.

{codespine-1.0.12 → codespine-1.0.13}/codespine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codespine
-Version: 1.0.12
+Version: 1.0.13
 Summary: Local Java code intelligence indexer backed by a graph database
 Author: CodeSpine contributors
 License: MIT License
@@ -66,7 +66,7 @@ Dynamic: license-file
 
 # CodeSpine
 
-**v1.0.12** — Local Java code intelligence for coding agents, backed by a graph database.
+**v1.0.13** — Local Java code intelligence for coding agents, backed by a graph database.
 
 CodeSpine cuts token burn for coding agents working on Java codebases.
 

{codespine-1.0.12 → codespine-1.0.13}/codespine.egg-info/SOURCES.txt

@@ -65,6 +65,7 @@ tests/test_cypher_compat.py
 tests/test_deadcode.py
 tests/test_duckdb_store.py
 tests/test_health.py
+tests/test_hybrid_search.py
 tests/test_index_and_hybrid.py
 tests/test_java_parser.py
 tests/test_multimodule_index.py

{codespine-1.0.12 → codespine-1.0.13}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codespine"
-version = "1.0.12"
+version = "1.0.13"
 description = "Local Java code intelligence indexer backed by a graph database"
 readme = "README.md"
 requires-python = ">=3.10"

codespine-1.0.13/tests/test_hybrid_search.py

@@ -0,0 +1,89 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+from codespine.analysis.context import build_symbol_context
+from codespine.search.hybrid import hybrid_search
+
+
+class _FailingContextStore:
+    def query_records(self, query: str, params: dict | None = None) -> list[dict]:
+        if "RETURN s.id as id" in query:
+            return [
+                {
+                    "id": "s1",
+                    "kind": "class",
+                    "name": "Foo",
+                    "fqname": "com.example.Foo",
+                    "embedding": None,
+                    "line": 1,
+                    "file_id": "f1",
+                    "file_path": "/tmp/Foo.java",
+                    "project_id": "app",
+                    "is_test": False,
+                }
+            ]
+        if "IN_COMMUNITY" in query or "IN_FLOW" in query:
+            raise RuntimeError("context exploded")
+        return []
+
+
+def test_hybrid_search_degrades_gracefully_when_context_lookup_fails():
+    results = hybrid_search(_FailingContextStore(), "Foo", k=1)
+
+    assert len(results) == 1
+    assert results[0]["name"] == "Foo"
+    assert results[0]["context"] == []
+    assert results[0]["context_warning"] == "Architectural context unavailable for this result."
+
+
+def test_build_symbol_context_keeps_search_candidates_when_context_lookup_fails(monkeypatch):
+    monkeypatch.setattr("codespine.analysis.context.analyze_impact", lambda *args, **kwargs: {"resolved_to": []})
+    monkeypatch.setattr("codespine.analysis.context.symbol_community", lambda *args, **kwargs: {"matches": []})
+    monkeypatch.setattr("codespine.analysis.context.trace_execution_flows", lambda *args, **kwargs: [])
+
+    result = build_symbol_context(_FailingContextStore(), "Foo")
+
+    assert result["focus"]["name"] == "Foo"
+    assert len(result["search_candidates"]) == 1
+    assert result["search_candidates"][0]["context"] == []
+    assert "context_warning" in result["search_candidates"][0]
+
+
+def test_hybrid_search_returns_flow_depth_from_duckdb_context(tmp_path: Path):
+    pytest.importorskip("duckdb")
+
+    from codespine.db.duckdb_store import DuckDBStore
+
+    store = DuckDBStore(
+        db_path_override=str(tmp_path / "db"),
+        snapshot_path_override=str(tmp_path / "db_read"),
+    )
+    store.upsert_project("app", "/app")
+    store.upsert_file("f1", "/app/src/main/java/com/example/OrderService.java", "app", False, "abc")
+    store.upsert_symbols_batch(
+        [
+            {
+                "id": "s1",
+                "kind": "class",
+                "name": "OrderService",
+                "fqname": "com.example.OrderService",
+                "file_id": "f1",
+                "line": 1,
+                "col": 1,
+                "embedding": None,
+            }
+        ]
+    )
+    store.set_community("comm1", "Ordering", 0.9, ["s1"])
+    store.set_flow("flow1", "s1", "entry", [("s1", 0)])
+
+    results = hybrid_search(store, "OrderService", k=1, project="app")
+
+    assert len(results) == 1
+    assert results[0]["name"] == "OrderService"
+    assert results[0]["context"]
+    assert any(item.get("community_label") == "Ordering" for item in results[0]["context"])
+    assert any(item.get("flow_depth") == 0 for item in results[0]["context"])