pycode-kg 0.21.2__tar.gz → 0.21.4__tar.gz

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycode-kg
-Version: 0.21.2
+Version: 0.21.4
 Summary: A tool to build a searchable knowledge graph from Python repositories
 License-Expression: Elastic-2.0
 License-File: LICENSE
@@ -24,7 +24,7 @@ Requires-Dist: PyQt5 (>=5.15.0) ; extra == "viz3d"
 Requires-Dist: click (>=8.1.0,<9)
 Requires-Dist: detect-secrets (>=1.5.0) ; extra == "all"
 Requires-Dist: detect-secrets (>=1.5.0) ; extra == "dev"
-Requires-Dist: kgmodule-utils[semantic,sqlite-vec,viz] (>=0.9.0)
+Requires-Dist: kgmodule-utils[semantic] (>=0.10.0)
 Requires-Dist: markdown (>=3.6) ; extra == "all"
 Requires-Dist: markdown (>=3.6) ; extra == "viz3d"
 Requires-Dist: mcp (>=1.0.0,<2)
@@ -45,21 +45,20 @@ Requires-Dist: pytest-cov (>=5.0.0) ; extra == "all"
 Requires-Dist: pytest-cov (>=5.0.0) ; extra == "dev"
 Requires-Dist: pyvis (>=0.3.2) ; extra == "all"
 Requires-Dist: pyvis (>=0.3.2) ; extra == "viz"
-Requires-Dist: pyvista[jupyter] (>=0.44.0) ; extra == "all"
-Requires-Dist: pyvista[jupyter] (>=0.44.0) ; extra == "viz3d"
+Requires-Dist: pyvista (>=0.44.0) ; extra == "all"
+Requires-Dist: pyvista (>=0.44.0) ; extra == "viz3d"
 Requires-Dist: pyvistaqt (>=0.11.0) ; extra == "all"
 Requires-Dist: pyvistaqt (>=0.11.0) ; extra == "viz3d"
 Requires-Dist: rich (>=14.3.3,<15)
 Requires-Dist: ruff (>=0.4.0) ; extra == "all"
 Requires-Dist: ruff (>=0.4.0) ; extra == "dev"
-Requires-Dist: safetensors (>=0.5.0)
 Requires-Dist: sentence-transformers (>=5.4.1)
+Requires-Dist: sqlite-vec (==0.1.9)
 Requires-Dist: streamlit (>=1.56.0) ; extra == "all"
 Requires-Dist: streamlit (>=1.56.0) ; extra == "viz"
 Requires-Dist: torch (>=2.5.1)
 Requires-Dist: trame-vtk (>=2.0.0) ; extra == "all"
 Requires-Dist: trame-vtk (>=2.0.0) ; extra == "viz3d"
-Requires-Dist: transformers (>=5.5.0,<6)
 Requires-Dist: ty (>=0.0.41) ; extra == "all"
 Requires-Dist: ty (>=0.0.41) ; extra == "dev"
 Project-URL: Homepage, https://github.com/Flux-Frontiers/pycode_kg
@@ -73,7 +72,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)
-[![Version](https://img.shields.io/badge/version-0.21.2-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.21.4-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
 [![CI](https://github.com/Flux-Frontiers/pycode_kg/actions/workflows/ci.yml/badge.svg)](https://github.com/Flux-Frontiers/pycode_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://zenodo.org/badge/1202379010.svg)](https://zenodo.org/badge/latestdoi/1202379010)
@@ -270,17 +269,17 @@ If you use PyCodeKG in your research or project, please cite it:
 
 [![DOI](https://zenodo.org/badge/1202379010.svg)](https://zenodo.org/badge/latestdoi/1202379010)
 
-> Suchanek, E. G. (2026). *PyCodeKG: A Knowledge Graph for Python Codebases* (Version 0.21.2) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.19834777
+> Suchanek, E. G. (2026). *PyCodeKG: A Knowledge Graph for Python Codebases* (Version 0.21.4) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.19737993
 
 ```bibtex
 @software{suchanek_pycode_kg,
   author    = {Suchanek, Eric G.},
   title     = {{PyCodeKG}: A Knowledge Graph for Python Codebases},
-  version   = {0.21.2},
+  version   = {0.21.4},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
-  doi       = {10.5281/zenodo.19834777},
+  doi       = {10.5281/zenodo.19737993},
 }
 ```
 
@@ -300,5 +299,5 @@ If you use PyCodeKG in your research or project, please cite it:
 
 ---
 
-*Built for Python developers and AI agents that work alongside them — egs · Last updated July 2026*
+*Built for Python developers and AI agents that work alongside them — egs · Last updated August 2026*
 

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/README.md

@@ -5,7 +5,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)
-[![Version](https://img.shields.io/badge/version-0.21.2-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.21.4-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
 [![CI](https://github.com/Flux-Frontiers/pycode_kg/actions/workflows/ci.yml/badge.svg)](https://github.com/Flux-Frontiers/pycode_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://zenodo.org/badge/1202379010.svg)](https://zenodo.org/badge/latestdoi/1202379010)
@@ -202,17 +202,17 @@ If you use PyCodeKG in your research or project, please cite it:
 
 [![DOI](https://zenodo.org/badge/1202379010.svg)](https://zenodo.org/badge/latestdoi/1202379010)
 
-> Suchanek, E. G. (2026). *PyCodeKG: A Knowledge Graph for Python Codebases* (Version 0.21.2) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.19834777
+> Suchanek, E. G. (2026). *PyCodeKG: A Knowledge Graph for Python Codebases* (Version 0.21.4) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.19737993
 
 ```bibtex
 @software{suchanek_pycode_kg,
   author    = {Suchanek, Eric G.},
   title     = {{PyCodeKG}: A Knowledge Graph for Python Codebases},
-  version   = {0.21.2},
+  version   = {0.21.4},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
-  doi       = {10.5281/zenodo.19834777},
+  doi       = {10.5281/zenodo.19737993},
 }
 ```
 
@@ -232,4 +232,4 @@ If you use PyCodeKG in your research or project, please cite it:
 
 ---
 
-*Built for Python developers and AI agents that work alongside them — egs · Last updated July 2026*
+*Built for Python developers and AI agents that work alongside them — egs · Last updated August 2026*

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/pyproject.toml

@@ -1,7 +1,7 @@
 # pyproject.toml — PyCodeKG package configuration (PEP 621)
 #
 # Author: Eric G. Suchanek, PhD
-# Last Revision: 2026-07-29
+# Last Revision: 2026-08-03
 #
 # Build system : Poetry 2.x with PEP 621 [project] table
 #
@@ -70,7 +70,7 @@ torch = [
 # ---------------------------------------------------------------------------
 [project]
 name = "pycode-kg"
-version = "0.21.2"
+version = "0.21.4"
 description = "A tool to build a searchable knowledge graph from Python repositories"
 readme = "README.md"
 license = "Elastic-2.0"
@@ -101,11 +101,28 @@ dependencies = [
     "numpy>=1.24.0",
     "pandas>=2.0.0",
     "rich>=14.3.3,<15",
-    "safetensors>=0.5.0",
     "sentence-transformers>=5.4.1",
+    # Core, not optional: kg.py hard-codes vector_backend="sqlite-vec", so every
+    # build/query path goes through kg_utils.vector_backend.SqliteVecBackend,
+    # which imports sqlite_vec at connect time. Exact pin — sqlite-vec is pre-1.0
+    # and breaking minors ship under 0.x; kgmodule-utils pins the same ==0.1.9.
+    # Declared here rather than pulled via kgmodule-utils[sqlite-vec] so the
+    # requirement is visible in this project's own metadata (doc-kg 0.20.0 does
+    # the same).
+    "sqlite-vec==0.1.9",
+    # Kept direct even though `[semantic]` carries the same `>=2.5.1`: the
+    # `[tool.poetry.dependencies]` block above routes linux torch to the CPU-only
+    # index, and that enrichment only applies to a dependency this project
+    # declares itself. Dropping it here would pull the ~3.4G CUDA wheel back in.
     "torch>=2.5.1",
-    "transformers>=5.5.0,<6",
-    "kgmodule-utils[semantic,sqlite-vec,viz]>=0.9.0",
+    # `[semantic]` is safe again as of kgmodule-utils 0.10.0, which moved
+    # `lancedb` out into its own `[lancedb]` extra. It now carries numpy, rich,
+    # sentence-transformers, sqlite-vec, torch and transformers under the same
+    # constraints used here, so `transformers` needs no direct entry.
+    # `[viz]` stays off: kg_utils.viz imports pyvis lazily, so it would force
+    # pyvis into every bare install when it belongs in this project's own `viz`
+    # extra.
+    "kgmodule-utils[semantic]>=0.10.0",
 ]
 
 [project.optional-dependencies]
@@ -127,7 +144,7 @@ viz3d = [
     "markdown>=3.6",
     "param>=2.0.0",
     "PyQt5>=5.15.0",
-    "pyvista[jupyter]>=0.44.0",
+    "pyvista>=0.44.0",
     "pyvistaqt>=0.11.0",
     "trame-vtk>=2.0.0",
 ]
@@ -149,7 +166,7 @@ all = [
     "PyQt5>=5.15.0",
     "pytest>=8.0.0",
     "pytest-cov>=5.0.0",
-    "pyvista[jupyter]>=0.44.0",
+    "pyvista>=0.44.0",
     "pyvistaqt>=0.11.0",
     "pyvis>=0.3.2",
     "ruff>=0.4.0",
@@ -190,7 +207,13 @@ target-version = "py312"
 # Vendored agent scratch dirs (Claude Code skills, Codex) — not project code.
 # The pre-commit hook's exclude can't cover these (it runs with
 # pass_filenames: false), so the exclusion must live here.
-extend-exclude = [".claude", ".agents", ".codex"]
+extend-exclude = [".claude", ".agents", ".codex", "*.md"]
+# ruff 0.16 formats Python code blocks inside Markdown as stable behaviour
+# (0.15 gates it behind preview), so `ruff format --check .` starts rewriting
+# prose docs the moment the lock resolves 0.16 — a failure that looks unrelated
+# to whatever change triggered the relock. Doc snippets are illustrative and
+# often deliberately aligned, so keep them out of the formatter's reach.
+# doc_kg and ftree_kg carry the same exclusion.
 
 [tool.ruff.lint]
 # B023, BLE001, PLC0415 replace the retired pylint hook's cell-var-from-loop,

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/src/pycode_kg/__init__.py

@@ -32,7 +32,7 @@ KGModule SDK (build new domain KGs)::
     from pycode_kg import KGModule, KGExtractor, PyCodeKGExtractor, NodeSpec, EdgeSpec
 """
 
-__version__ = "0.21.2"
+__version__ = "0.21.4"
 __author__ = "Eric G. Suchanek, PhD"
 
 # Low-level primitives (locked v0 contract)

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/src/pycode_kg/analysis/bridge.py

@@ -4,7 +4,7 @@ Measures module interaction complexity: how many unique modules each module call
 For well-modularized codebases, identifies orchestrator and hub modules.
 
 Author: Eric G. Suchanek, PhD
-Last Revision: 2026-07-28 22:44:43
+Last Revision: 2026-08-02 16:34:57
 License: Elastic 2.0
 """
 

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/src/pycode_kg/analysis/centrality.py

@@ -12,7 +12,7 @@ Public API:
     - :func:`aggregate_module_scores` — roll node scores up to module level.
 
 Author: Eric G. Suchanek, PhD
-Last Revision: 2026-07-28 22:44:43
+Last Revision: 2026-08-02 16:34:57
 """
 
 from __future__ import annotations

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/src/pycode_kg/analysis/framework_detector.py

@@ -3,7 +3,7 @@ Framework Detector for PyCodeKG.
 Identifies repo-defining abstractions using centrality and cross-module signals.
 
 Author: Eric G. Suchanek, PhD
-Last Revision: 2026-07-28 22:44:43
+Last Revision: 2026-08-02 16:34:57
 License: Elastic 2.0
 """
 

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/src/pycode_kg/cli/cmd_hooks.py

@@ -6,7 +6,7 @@ CLI command for installing PyCodeKG git hooks:
   install-hooks — install the pre-commit snapshot hook into .git/hooks/
 
   Author: Eric G. Suchanek, PhD
-  Last Revision: 2026-07-29 15:21:32
+  Last Revision: 2026-08-02 16:34:57
 """
 
 from __future__ import annotations

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/src/pycode_kg/pycodekg.py

@@ -23,7 +23,7 @@ No persistence, no embeddings, no LLMs—just pure AST extraction. Integration w
 vector databases and semantic search happens downstream.
 
 Author: Eric G. Suchanek, PhD
-Last Revision: 2026-07-28 22:44:43
+Last Revision: 2026-08-02 16:34:57
 """
 
 from __future__ import annotations

{pycode_kg-0.21.2 → pycode_kg-0.21.4}/src/pycode_kg/snapshots.py

@@ -35,7 +35,7 @@ Usage
 >>> prev = mgr.get_previous(tree_hash)
 
 Author: Eric G. Suchanek, PhD
-Last Revision: 2026-07-28
+Last Revision: 2026-08-02
 
 License: Elastic 2.0
 """