pycode-kg 0.20.0__tar.gz → 0.21.1__tar.gz

{pycode_kg-0.20.0 → pycode_kg-0.21.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycode-kg
-Version: 0.20.0
+Version: 0.21.1
 Summary: A tool to build a searchable knowledge graph from Python repositories
 License-Expression: Elastic-2.0
 License-File: LICENSE
@@ -17,7 +17,6 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Provides-Extra: all
 Provides-Extra: dev
-Provides-Extra: kgdeps
 Provides-Extra: viz
 Provides-Extra: viz3d
 Requires-Dist: PyQt5 (>=5.15.0) ; extra == "all"
@@ -25,12 +24,11 @@ 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: doc-kg (>=0.18.1) ; extra == "dev"
-Requires-Dist: doc-kg (>=0.18.1) ; extra == "kgdeps"
-Requires-Dist: kgmodule-utils[semantic,sqlite-vec] (>=0.6.2)
+Requires-Dist: kgmodule-utils[semantic,sqlite-vec,viz] (>=0.9.0)
 Requires-Dist: markdown (>=3.6) ; extra == "all"
 Requires-Dist: markdown (>=3.6) ; extra == "viz3d"
-Requires-Dist: mcp (>=1.0.0)
+Requires-Dist: mcp (>=1.0.0,<2)
+Requires-Dist: networkx (>=3.0)
 Requires-Dist: numpy (>=1.24.0)
 Requires-Dist: pandas (>=2.0.0)
 Requires-Dist: param (>=2.0.0) ; extra == "all"
@@ -56,12 +54,12 @@ 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: streamlit (>=1.35.0) ; extra == "all"
-Requires-Dist: streamlit (>=1.35.0) ; extra == "viz"
+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 (>=4.40.0,<4.57)
+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
@@ -75,7 +73,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.20.0-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.21.1-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)
@@ -215,6 +213,7 @@ The graph is built around four node kinds (module, class, function, method) and
 | **Pull source-grounded context for an LLM** | `pycodekg pack "..." --format md` | [docs/CHEATSHEET.md](docs/CHEATSHEET.md) |
 | **Run a hybrid semantic + structural query** | `pycodekg query "..."` | [docs/CHEATSHEET.md](docs/CHEATSHEET.md) |
 | **Browse the graph interactively** | `pycodekg viz` (Streamlit) | [docs/INSTALLATION.md](docs/INSTALLATION.md) |
+| **Share a graph as one file** | `pycodekg viz-export -o graph.html` | opens from `file://`, no server |
 | **See call graphs in 3-D** *(active development — functional but rough)* | `pycodekg viz3d --layout funnel` | [docs/VIZ3D.md](docs/VIZ3D.md) |
 | **Wire it into Claude / Copilot / Cline** | `pycodekg mcp` | [docs/MCP.md](docs/MCP.md) |
 
@@ -271,13 +270,13 @@ 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.20.0) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.19834777
+> Suchanek, E. G. (2026). *PyCodeKG: A Knowledge Graph for Python Codebases* (Version 0.21.1) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.19834777
 
 ```bibtex
 @software{suchanek_pycode_kg,
   author    = {Suchanek, Eric G.},
   title     = {{PyCodeKG}: A Knowledge Graph for Python Codebases},
-  version   = {0.20.0},
+  version   = {0.21.1},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
@@ -301,5 +300,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 May 2026*
+*Built for Python developers and AI agents that work alongside them — egs · Last updated July 2026*
 

{pycode_kg-0.20.0 → pycode_kg-0.21.1}/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.20.0-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.21.1-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)
@@ -145,6 +145,7 @@ The graph is built around four node kinds (module, class, function, method) and
 | **Pull source-grounded context for an LLM** | `pycodekg pack "..." --format md` | [docs/CHEATSHEET.md](docs/CHEATSHEET.md) |
 | **Run a hybrid semantic + structural query** | `pycodekg query "..."` | [docs/CHEATSHEET.md](docs/CHEATSHEET.md) |
 | **Browse the graph interactively** | `pycodekg viz` (Streamlit) | [docs/INSTALLATION.md](docs/INSTALLATION.md) |
+| **Share a graph as one file** | `pycodekg viz-export -o graph.html` | opens from `file://`, no server |
 | **See call graphs in 3-D** *(active development — functional but rough)* | `pycodekg viz3d --layout funnel` | [docs/VIZ3D.md](docs/VIZ3D.md) |
 | **Wire it into Claude / Copilot / Cline** | `pycodekg mcp` | [docs/MCP.md](docs/MCP.md) |
 
@@ -201,13 +202,13 @@ 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.20.0) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.19834777
+> Suchanek, E. G. (2026). *PyCodeKG: A Knowledge Graph for Python Codebases* (Version 0.21.1) [Software]. Flux-Frontiers. https://doi.org/10.5281/zenodo.19834777
 
 ```bibtex
 @software{suchanek_pycode_kg,
   author    = {Suchanek, Eric G.},
   title     = {{PyCodeKG}: A Knowledge Graph for Python Codebases},
-  version   = {0.20.0},
+  version   = {0.21.1},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
@@ -231,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 May 2026*
+*Built for Python developers and AI agents that work alongside them — egs · Last updated July 2026*

{pycode_kg-0.20.0 → pycode_kg-0.21.1}/pyproject.toml

@@ -1,7 +1,7 @@
 # pyproject.toml — PyCodeKG package configuration (PEP 621)
 #
 # Author: Eric G. Suchanek, PhD
-# Last Revision: 2026-07-15
+# Last Revision: 2026-07-29
 #
 # Build system : Poetry 2.x with PEP 621 [project] table
 #
@@ -10,7 +10,6 @@
 #   pip install -e ".[dev]"             core + dev tools (pytest, ruff, ty, etc.)
 #   pip install -e ".[viz]"             core + Streamlit/Plotly/PyVis visualizer
 #   pip install -e ".[viz3d]"           core + PyVista 3D visualizer
-#   pip install -e ".[kgdeps]"          core + KG integrations (doc-kg, agent-kg)
 #   pip install -e ".[all]"             everything above
 #   pip install -e "."                  core runtime only
 #
@@ -20,7 +19,6 @@
 #   poetry install --extras "dev"       core + dev tools only
 #   poetry install --extras "viz"       core + Streamlit/Plotly visualizer only
 #   poetry install --extras "viz3d"     core + 3D visualizer only
-#   poetry install --extras "kgdeps"    core + KG integrations only
 #   poetry install                      core runtime only
 #
 # First-time setup
@@ -46,12 +44,33 @@ build-backend = "poetry.core.masonry.api"
 [tool.poetry]
 packages = [{ include = "pycode_kg", from = "src" }]
 
+# CPU-only torch on Linux: dev/CI here has no GPU, but the default PyPI linux
+# wheel bundles the full CUDA runtime (~2.7G of nvidia-* packages, ~700M of
+# triton) regardless. "explicit" priority means only packages naming this
+# source use it — nothing else is redirected off PyPI. This affects local/CI
+# installs only; it is not part of published wheel metadata, so `pip install
+# pycode-kg` for a GPU user still resolves torch normally.
+#
+# Linux only: macOS/Windows torch builds are already CPU/MPS, and this index
+# publishes the macOS ones without the "+cpu" local version label, so locking
+# it globally leaves those platforms with no installable candidate.
+[[tool.poetry.source]]
+name = "pytorch-cpu"
+url = "https://download.pytorch.org/whl/cpu"
+priority = "explicit"
+
+[tool.poetry.dependencies]
+torch = [
+    { markers = "sys_platform == 'linux'", source = "pytorch-cpu" },
+    { markers = "sys_platform != 'linux'" },
+]
+
 # ---------------------------------------------------------------------------
 # PEP 621 project metadata
 # ---------------------------------------------------------------------------
 [project]
 name = "pycode-kg"
-version = "0.20.0"
+version = "0.21.1"
 description = "A tool to build a searchable knowledge graph from Python repositories"
 readme = "README.md"
 license = "Elastic-2.0"
@@ -71,15 +90,22 @@ classifiers = [
 requires-python = ">=3.12,<3.14"
 dependencies = [
     "click>=8.1.0,<9",
-    "mcp>=1.0.0",
+    # Upper-bounded: mcp 2.0 removed the bundled `mcp.server.fastmcp` module
+    # (FastMCP was split out into the standalone `fastmcp` package) and rebuilt
+    # mcp.server around new submodules. src/pycode_kg/mcp_server.py imports
+    # FastMCP from mcp, so an unbounded floor lets a clean install pull 2.x and
+    # break `pycodekg-mcp` at import time. Lift this only alongside a port to
+    # the standalone fastmcp package.
+    "mcp>=1.0.0,<2",
+    "networkx>=3.0",
     "numpy>=1.24.0",
     "pandas>=2.0.0",
     "rich>=14.3.3,<15",
     "safetensors>=0.5.0",
     "sentence-transformers>=5.4.1",
     "torch>=2.5.1",
-    "transformers>=4.40.0,<4.57",
-    "kgmodule-utils[semantic,sqlite-vec]>=0.6.2",
+    "transformers>=5.5.0,<6",
+    "kgmodule-utils[semantic,sqlite-vec,viz]>=0.9.0",
 ]
 
 [project.optional-dependencies]
@@ -91,13 +117,11 @@ dev = [
     "pytest>=8.0.0",
     "pytest-cov>=5.0.0",
     "ruff>=0.4.0",
-    "doc-kg>=0.18.1",
-    # agent-kg not yet on PyPI — install manually: pip install git+https://github.com/Flux-Frontiers/agent_kg.git
 ]
 viz = [
     "plotly>=5.14.0",
     "pyvis>=0.3.2",
-    "streamlit>=1.35.0",
+    "streamlit>=1.56.0",
 ]
 viz3d = [
     "markdown>=3.6",
@@ -108,10 +132,13 @@ viz3d = [
     "trame-vtk>=2.0.0",
 ]
 
-# note that dockg is on pypi; agent-kg is not yet — install manually from git
-kgdeps = [
-    "doc-kg>=0.18.1",
-]
+# Cross-KG sibling packages (doc-kg, pycode-kg, agent-kg, kg-rag) are NOT
+# declared here. They are never imported by this package, and listing them
+# forces poetry's universal resolution to reconcile the transformers pin of
+# every *published* sibling against this project's own -- a deadlock, since
+# doc-kg and pycode-kg each depend on the other. Install them by hand:
+#   pip install doc-kg pycode-kg         # both on PyPI
+#   pip install agent-kg kg-rag          # both on PyPI as of 2026-07-29
 all = [
     "detect-secrets>=1.5.0",
     "markdown>=3.6",
@@ -126,7 +153,7 @@ all = [
     "pyvistaqt>=0.11.0",
     "pyvis>=0.3.2",
     "ruff>=0.4.0",
-    "streamlit>=1.35.0",
+    "streamlit>=1.56.0",
     "trame-vtk>=2.0.0",
     "ty>=0.0.41",
 ]
@@ -160,10 +187,10 @@ pycodekg-viz3d          = "pycode_kg.cli.cmd_viz:viz3d"
 [tool.ruff]
 line-length    = 100
 target-version = "py312"
-# Vendored Claude Code skills — 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"]
+# 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"]
 
 [tool.ruff.lint]
 # B023, BLE001, PLC0415 replace the retired pylint hook's cell-var-from-loop,

{pycode_kg-0.20.0 → pycode_kg-0.21.1}/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.20.0"
+__version__ = "0.21.1"
 __author__ = "Eric G. Suchanek, PhD"
 
 # Low-level primitives (locked v0 contract)

{pycode_kg-0.20.0 → pycode_kg-0.21.1}/src/pycode_kg/analysis/__init__.py

@@ -1,5 +1,7 @@
 """Analysis primitives for PyCodeKG."""
 
+from kg_utils.analysis.scores import MetricRef, ScoreSet, available_metrics, load_scores
+
 from .centrality import (
     CentralityConfig,
     CentralityRecord,
@@ -10,6 +12,10 @@ from .centrality import (
 __all__ = [
     "CentralityConfig",
     "CentralityRecord",
+    "MetricRef",
+    "ScoreSet",
     "StructuralImportanceRanker",
     "aggregate_module_scores",
+    "available_metrics",
+    "load_scores",
 ]

{pycode_kg-0.20.0 → pycode_kg-0.21.1}/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-03-12 17:30:35
+Last Revision: 2026-04-27 23:29:23
 License: Elastic 2.0
 """
 

{pycode_kg-0.20.0 → pycode_kg-0.21.1}/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-03-11 12:45:30
+Last Revision: 2026-05-01 21:46:11
 """
 
 from __future__ import annotations

{pycode_kg-0.20.0 → pycode_kg-0.21.1}/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-03-12 17:30:35
+Last Revision: 2026-07-15 22:51:18
 License: Elastic 2.0
 """