tscode-kg 0.5.1__tar.gz → 0.6.0__tar.gz

{tscode_kg-0.5.1 → tscode_kg-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tscode-kg
-Version: 0.5.1
+Version: 0.6.0
 Summary: Knowledge graph for TypeScript/JavaScript codebases — AST extraction, hybrid semantic+structural search
 License-Expression: Elastic-2.0
 License-File: LICENSE
@@ -19,9 +19,9 @@ Provides-Extra: viz
 Provides-Extra: viz3d
 Requires-Dist: PyQt5 (>=5.15.11,<5.16) ; extra == "viz3d"
 Requires-Dist: click (>=8.1.0,<9)
-Requires-Dist: kgmodule-utils[semantic,sqlite-vec] (>=0.22.0)
+Requires-Dist: kgmodule-utils[semantic,sqlite-vec] (>=0.23.0)
 Requires-Dist: markdown (>=3.10,<3.11) ; extra == "viz3d"
-Requires-Dist: mcp (>=1.0.0,<2)
+Requires-Dist: mcp (>=1.3.0,<2)
 Requires-Dist: networkx (>=3.0)
 Requires-Dist: param (>=2.4,<2.5) ; extra == "viz3d"
 Requires-Dist: plotly (>=6.8.0,<6.9) ; extra == "viz"
@@ -42,7 +42,7 @@ Description-Content-Type: text/markdown
 [![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue.svg)](https://www.python.org/)
 [![License: Elastic-2.0](https://img.shields.io/badge/License-Elastic%202.0-blue.svg)](https://www.elastic.co/licensing/elastic-license)
 [![PyPI](https://img.shields.io/pypi/v/tscode-kg.svg)](https://pypi.org/project/tscode-kg/)
-[![Version](https://img.shields.io/badge/version-0.5.1-blue.svg)](https://github.com/Flux-Frontiers/tscode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](https://github.com/Flux-Frontiers/tscode_kg/releases)
 [![CI](https://github.com/Flux-Frontiers/tscode_kg/actions/workflows/ci.yml/badge.svg)](https://github.com/Flux-Frontiers/tscode_kg/actions/workflows/ci.yml)
 [![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
 [![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.22559450-blue.svg)](https://doi.org/10.5281/zenodo.22559450)
@@ -195,13 +195,13 @@ If you use TypeScriptKG in your research or project, please cite it:
 
 [![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.22559450-blue.svg)](https://doi.org/10.5281/zenodo.22559450)
 
-> Suchanek, E. G. (2026). *TypeScriptKG: Semantic Knowledge Graph for TypeScript/JavaScript Codebases* (Version 0.5.1) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.22559450
+> Suchanek, E. G. (2026). *TypeScriptKG: Semantic Knowledge Graph for TypeScript/JavaScript Codebases* (Version 0.6.0) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.22559450
 
 ```bibtex
 @software{suchanek_tscode_kg,
   author    = {Suchanek, Eric G.},
   title     = {{TypeScriptKG}: Semantic Knowledge Graph for TypeScript/JavaScript Codebases},
-  version   = {0.5.1},
+  version   = {0.6.0},
   year      = {2026},
   publisher = {Flux-Frontiers},
   doi       = {10.5281/zenodo.22559450},

{tscode_kg-0.5.1 → tscode_kg-0.6.0}/README.md

@@ -3,7 +3,7 @@
 [![Python](https://img.shields.io/badge/python-3.12%20%7C%203.13-blue.svg)](https://www.python.org/)
 [![License: Elastic-2.0](https://img.shields.io/badge/License-Elastic%202.0-blue.svg)](https://www.elastic.co/licensing/elastic-license)
 [![PyPI](https://img.shields.io/pypi/v/tscode-kg.svg)](https://pypi.org/project/tscode-kg/)
-[![Version](https://img.shields.io/badge/version-0.5.1-blue.svg)](https://github.com/Flux-Frontiers/tscode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.6.0-blue.svg)](https://github.com/Flux-Frontiers/tscode_kg/releases)
 [![CI](https://github.com/Flux-Frontiers/tscode_kg/actions/workflows/ci.yml/badge.svg)](https://github.com/Flux-Frontiers/tscode_kg/actions/workflows/ci.yml)
 [![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
 [![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.22559450-blue.svg)](https://doi.org/10.5281/zenodo.22559450)
@@ -156,13 +156,13 @@ If you use TypeScriptKG in your research or project, please cite it:
 
 [![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.22559450-blue.svg)](https://doi.org/10.5281/zenodo.22559450)
 
-> Suchanek, E. G. (2026). *TypeScriptKG: Semantic Knowledge Graph for TypeScript/JavaScript Codebases* (Version 0.5.1) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.22559450
+> Suchanek, E. G. (2026). *TypeScriptKG: Semantic Knowledge Graph for TypeScript/JavaScript Codebases* (Version 0.6.0) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.22559450
 
 ```bibtex
 @software{suchanek_tscode_kg,
   author    = {Suchanek, Eric G.},
   title     = {{TypeScriptKG}: Semantic Knowledge Graph for TypeScript/JavaScript Codebases},
-  version   = {0.5.1},
+  version   = {0.6.0},
   year      = {2026},
   publisher = {Flux-Frontiers},
   doi       = {10.5281/zenodo.22559450},

{tscode_kg-0.5.1 → tscode_kg-0.6.0}/pyproject.toml

@@ -38,7 +38,7 @@ packages = [{ include = "tscode_kg", from = "src" }]
 
 [project]
 name = "tscode-kg"
-version = "0.5.1"
+version = "0.6.0"
 description = "Knowledge graph for TypeScript/JavaScript codebases — AST extraction, hybrid semantic+structural search"
 readme = "README.md"
 license = "Elastic-2.0"
@@ -68,7 +68,7 @@ dependencies = [
     # manager is now the package_name class attribute, where it used to be an
     # __init__ that only forwarded to super(). Against 0.19.x the manager
     # reports itself as "kg-utils" in every snapshot's tool field.
-    "kgmodule-utils[semantic,sqlite-vec]>=0.22.0",
+    "kgmodule-utils[semantic,sqlite-vec]>=0.23.0",
     "click>=8.1.0,<9",
     # Upper-bounded: mcp 2.0 removed the bundled `mcp.server.fastmcp` module
     # (FastMCP was split out into the standalone `fastmcp` package) and rebuilt
@@ -76,7 +76,7 @@ dependencies = [
     # FastMCP from mcp, so an unbounded floor lets a clean install pull 2.x and
     # break `tscodekg-mcp` at import time. Lift this only alongside a port to
     # the standalone fastmcp package.
-    "mcp>=1.0.0,<2",
+    "mcp>=1.3.0,<2",
     "networkx>=3.0",
 ]
 
@@ -123,43 +123,7 @@ pytest-cov = ">=5.0.0"
 # Capped below 0.16 to match the fleet: 0.16 formats Python inside Markdown
 # code blocks as stable behaviour. The floor was unbounded, so the lock could
 # drift away from the version .pre-commit-config.yaml pins.
-ruff = ">=0.4.0,<0.16"
-
-# ---------------------------------------------------------------------------
-# Maintainer tooling (Poetry group, not a PEP 621 extra)
-# ---------------------------------------------------------------------------
-# pycode-kg is a tool this repo *runs*, not a library it imports: PyCodeKG
-# indexes this repo's Python source from the outside, via the `pycodekg` CLI in
-# .git/hooks/pre-commit. It belongs in a Poetry group -- locked and installable,
-# but never written into the wheel, so no published extra acquires a sibling.
-#
-# doc-kg rides along for fleet uniformity: every repo's `kg` group carries the
-# same two CLIs, so `poetry install --with kg` means one thing everywhere. This
-# repo has no DocKG index today (no .mcp.json, no `dockg` invocation), so the
-# CLI is simply available rather than required -- and it is here, not in an
-# extra, precisely because nothing depends on it at runtime.
-#
-#   poetry install --with kg      # get the pycodekg CLI into .venv/bin
-#   poetry install                # default: group is optional, skipped
-#
-# This supersedes the standing "install it by hand" workaround. That note
-# described a real deadlock -- older pycode-kg capped transformers below 4.57
-# while kgmodule-utils >=0.9.0 needs >=5.5.0, which silently held this repo on
-# the pre-CVE transformers line. pycode-kg 0.21.4 no longer pins transformers at
-# all; it inherits the same kgmodule-utils[semantic] constraint this project
-# already uses, so the two no longer conflict. Verified: locking with this group
-# keeps transformers at 5.14.1.
-[tool.poetry.group.kg]
-optional = true
-
-[tool.poetry.group.kg.dependencies]
-# Both floors are the releases that retired these packages' own snapshot
-# overrides and moved them onto kgmodule-utils>=0.20.0, the same SDK this repo
-# now requires. Pinned lower, `poetry install --with kg` could resolve a dockg
-# or pycodekg predating the shared extension points into the same environment
-# as a tscode_kg that depends on them.
-doc-kg = ">=0.26.0"
-pycode-kg = ">=0.27.1"
+ruff = ">=0.15,<0.16"
 
 [project.urls]
 Homepage = "https://github.com/Flux-Frontiers/tscode_kg"

{tscode_kg-0.5.1 → tscode_kg-0.6.0}/src/tscode_kg/__init__.py

@@ -18,7 +18,7 @@ KGExtractor SDK::
     from tscode_kg import TSCodeExtractor
 """
 
-__version__ = "0.5.1"
+__version__ = "0.6.0"
 __author__ = "Eric G. Suchanek, PhD"
 
 from tscode_kg.extractor import TSCodeExtractor

{tscode_kg-0.5.1 → tscode_kg-0.6.0}/src/tscode_kg/mcp_server.py

@@ -74,6 +74,8 @@ from __future__ import annotations
 import argparse
 import json
 import sys
+from collections.abc import AsyncIterator
+from contextlib import asynccontextmanager
 from pathlib import Path
 
 from kg_utils.semantic import DEFAULT_MODEL
@@ -142,6 +144,22 @@ def _snapshot_freshness(snapshot_total_nodes: int) -> dict:
 # MCP server
 # ---------------------------------------------------------------------------
 
+
+@asynccontextmanager
+async def _lifespan(_server: FastMCP) -> AsyncIterator[None]:
+    """Close the graph's SQLite connection(s) when the server shuts down.
+
+    ``main()`` sets the module-level ``_kg`` before ``mcp.run()`` calls into
+    this, and both the stdio and SSE transports route through the same
+    underlying ``Server.run()``, so this fires on either one.
+    """
+    try:
+        yield
+    finally:
+        if _kg is not None:
+            _kg.close()
+
+
 mcp = FastMCP(
     "tscodekg",
     instructions=(
@@ -202,6 +220,7 @@ mcp = FastMCP(
         "- **Track codebase evolution**: snapshot_list → snapshot_diff(key_a, key_b)\n"
         "- **Answer 'how does X work?'**: pack_snippets with a descriptive query\n"
     ),
+    lifespan=_lifespan,
 )