heimdall-code 0.3.0__tar.gz → 0.3.1__tar.gz

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "heimdall",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "A code knowledge graph that sees everything. Indexes any repo into a SQLite property graph and answers what calls this, what breaks if I change it, and how does A reach B.",
   "author": {
     "name": "Bogdan Sapovskyi",

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/CHANGELOG.md

@@ -3,6 +3,17 @@
 Notable changes, newest first. Versions follow [semver](https://semver.org); until 1.0
 the graph schema and the JSON payloads may still move.
 
+## 0.3.1 — 2026-08-12
+
+### Fixed
+
+- A failed project lookup no longer takes the MCP server down with it. `search` with no
+  project, from a directory with no index, raised `SystemExit` — a `BaseException` the
+  tool handler never turned into an error reply, so it unwound the server's task group
+  and every later call found a dead pipe. `registry.resolve` raises `LookupError` now and
+  `cli.py` turns it back into `SystemExit` where a terminal is watching; the message and
+  exit code are unchanged there.
+
 ## 0.3.0 — 2026-08-01
 
 ### Added

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: heimdall-code
-Version: 0.3.0
+Version: 0.3.1
 Summary: A code knowledge graph that sees everything -- indexes any repository into a SQLite property graph and serves it to AI agents over MCP.
 Project-URL: Homepage, https://github.com/stPhoenix/heimdall
 Project-URL: Source, https://github.com/stPhoenix/heimdall

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/heimdall/__init__.py

@@ -9,5 +9,5 @@ inheritance) and serves it to agents over MCP.
 from .graph import Graph
 from .index import build
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"
 __all__ = ["Graph", "__version__", "build"]

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/heimdall/cli.py

@@ -181,7 +181,11 @@ def main(argv: list[str] | None = None) -> int:
         serve(a.project)
         return 0
 
-    g = Graph.open(registry.resolve(a.project), readonly=True)
+    try:
+        db = registry.resolve(a.project)
+    except LookupError as exc:
+        raise SystemExit(str(exc)) from None
+    g = Graph.open(db, readonly=True)
     try:
         match a.cmd:
             case "search":

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/heimdall/registry.py

@@ -31,7 +31,12 @@ def register(name: str, db: Path) -> None:
 
 
 def resolve(project: str | None, cwd: Path | None = None) -> Path:
-    """A project name, an explicit db path, or the repo in the current directory."""
+    """A project name, an explicit db path, or the repo in the current directory.
+
+    Failure is a LookupError, never SystemExit: this also runs inside the MCP server,
+    where a BaseException escapes the tool handler and kills the process mid-request --
+    the client then hangs on a reply that will never come.
+    """
     if project:
         p = Path(project)
         if p.suffix == ".db" and p.exists():
@@ -42,10 +47,10 @@ def resolve(project: str | None, cwd: Path | None = None) -> Path:
         matches = [v for k, v in entries.items() if project in k]
         if len(matches) == 1:
             return Path(matches[0])
-        raise SystemExit(f"unknown project {project!r}; known: {', '.join(sorted(load())) or '(none)'}")
+        raise LookupError(f"unknown project {project!r}; known: {', '.join(sorted(load())) or '(none)'}")
     here = (cwd or Path.cwd()).resolve()
     for d in (here, *here.parents):
         db = d / ".heimdall" / "graph.db"
         if db.exists():
             return db
-    raise SystemExit("no index found here -- run `heimdall index` first, or pass --project")
+    raise LookupError("no index found here -- run `heimdall index` first, or pass --project")

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 # `heimdall` on PyPI is an unrelated screenshot library; the command is still `heimdall`
 name = "heimdall-code"
-version = "0.3.0"
+version = "0.3.1"
 description = "A code knowledge graph that sees everything -- indexes any repository into a SQLite property graph and serves it to AI agents over MCP."
 readme = "README.md"
 requires-python = ">=3.12"

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/tests/test_heimdall.py

@@ -451,6 +451,20 @@ def test_install_writes_agent_config() -> None:
     assert r.returncode == 0, r.stdout + r.stderr  # the assertion that failed, not just "exit 1"
 
 
+def test_resolve_failures_are_ordinary_exceptions() -> None:
+    """SystemExit here killed the MCP server mid-request; the client hung, then reconnected."""
+    from heimdall import registry
+
+    with tempfile.TemporaryDirectory() as d:
+        for bad in (lambda: registry.resolve(None, Path(d)), lambda: registry.resolve("nope::missing", Path(d))):
+            try:
+                bad()
+            except Exception as exc:  # LookupError is an Exception; SystemExit is not
+                assert isinstance(exc, LookupError), exc
+            else:
+                raise AssertionError("expected a LookupError")
+
+
 def test_every_declared_language_extracts() -> None:
     from heimdall.parse import EXT_LANG, parse_source
 
@@ -466,5 +480,6 @@ if __name__ == "__main__":
     test_end_to_end()
     test_submodules_are_indexed()
     test_install_writes_agent_config()
+    test_resolve_failures_are_ordinary_exceptions()
     test_every_declared_language_extracts()
     print("ok")

{heimdall_code-0.3.0 → heimdall_code-0.3.1}/uv.lock

@@ -204,7 +204,7 @@ wheels = [
 
 [[package]]
 name = "heimdall-code"
-version = "0.3.0"
+version = "0.3.1"
 source = { editable = "." }
 dependencies = [
     { name = "mcp" },