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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycode-kg
-Version: 0.21.0
+Version: 0.21.2
 Summary: A tool to build a searchable knowledge graph from Python repositories
 License-Expression: Elastic-2.0
 License-File: LICENSE
@@ -27,7 +27,7 @@ Requires-Dist: detect-secrets (>=1.5.0) ; extra == "dev"
 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)
@@ -73,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.21.0-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.21.2-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,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.21.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.2) [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.21.0},
+  version   = {0.21.2},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
@@ -300,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.21.0 → pycode_kg-0.21.2}/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.0-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.21.2-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,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.21.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.2) [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.21.0},
+  version   = {0.21.2},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
@@ -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 May 2026*
+*Built for Python developers and AI agents that work alongside them — egs · Last updated July 2026*

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

@@ -1,7 +1,7 @@
 # pyproject.toml — PyCodeKG package configuration (PEP 621)
 #
 # Author: Eric G. Suchanek, PhD
-# Last Revision: 2026-07-28
+# Last Revision: 2026-07-29
 #
 # Build system : Poetry 2.x with PEP 621 [project] table
 #
@@ -70,7 +70,7 @@ torch = [
 # ---------------------------------------------------------------------------
 [project]
 name = "pycode-kg"
-version = "0.21.0"
+version = "0.21.2"
 description = "A tool to build a searchable knowledge graph from Python repositories"
 readme = "README.md"
 license = "Elastic-2.0"
@@ -90,7 +90,13 @@ 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",
@@ -131,9 +137,8 @@ viz3d = [
 # 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 'kg-rag @ git+https://github.com/Flux-Frontiers/KGRAG.git'
-#   pip install 'agent-kg @ git+https://github.com/Flux-Frontiers/agent_kg.git'
+#   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",

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

{pycode_kg-0.21.0 → pycode_kg-0.21.2}/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-04-27 23:29:23
+Last Revision: 2026-07-28 22:44:43
 License: Elastic 2.0
 """
 

{pycode_kg-0.21.0 → pycode_kg-0.21.2}/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-05-01 21:46:11
+Last Revision: 2026-07-28 22:44:43
 """
 
 from __future__ import annotations

{pycode_kg-0.21.0 → pycode_kg-0.21.2}/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-15 22:51:18
+Last Revision: 2026-07-28 22:44:43
 License: Elastic 2.0
 """
 

{pycode_kg-0.21.0 → pycode_kg-0.21.2}/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-04-06 09:21:00
+  Last Revision: 2026-07-29 15:21:32
 """
 
 from __future__ import annotations
@@ -25,10 +25,21 @@ from pycode_kg.cli.main import cli
 
 _PRE_COMMIT_HOOK = """\
 #!/usr/bin/env bash
-# PyCodeKG pre-commit hook — keeps the local index in sync and captures a
-# metrics snapshot BEFORE quality checks run.
+# PyCodeKG pre-commit hook — runs quality checks first, then rebuilds the local
+# index and captures a metrics snapshot.
 # Installed by: pycodekg install-hooks
 # Skip with: PYCODEKG_SKIP_SNAPSHOT=1 git commit ...
+#
+# Order matters, and it is deliberately checks-then-index:
+#
+#   * `pre-commit run` stashes unstaged changes and restores them afterwards.
+#     Rebuilding the index before that ran meant the build's freshly-rewritten
+#     snapshots/manifest.json landed inside the stash window, where the restore
+#     could fail with "patch does not apply" and abort the commit outright — or,
+#     worse, let a staged deletion of a tracked snapshot slip into the commit.
+#     Building afterwards keeps KG artifacts entirely outside that window.
+#   * A full index rebuild costs 60-90s. There is no reason to pay it for a
+#     commit that ruff/ty/pytest is about to reject.
 set -euo pipefail
 
 [ "${PYCODEKG_SKIP_SNAPSHOT:-0}" = "1" ] && exit 0
@@ -37,7 +48,20 @@ REPO_ROOT="$(git rev-parse --show-toplevel)"
 
 cd "$REPO_ROOT"
 
-# Capture the tree hash of the staged index NOW — before any tool modifies files.
+# Quality checks first (ruff, ty, pytest, detect-secrets, ...). Delegates to
+# .pre-commit-config.yaml so quality checks stay in one place. A hook that
+# rewrites files also exits non-zero here, so we never index a tree that is
+# about to be reformatted.
+PRECOMMIT="$REPO_ROOT/.venv/bin/pre-commit"
+if [ -x "$PRECOMMIT" ]; then
+    "$PRECOMMIT" run || exit 1
+elif command -v pre-commit &>/dev/null; then
+    pre-commit run || exit 1
+fi
+
+# Capture the tree hash now that the checks have passed and nothing further
+# will modify the working tree — this keys the snapshot to the content that is
+# actually about to be committed.
 TREE_HASH=$(git write-tree)
 BRANCH=$(git rev-parse --abbrev-ref HEAD)
 
@@ -51,19 +75,11 @@ BRANCH=$(git rev-parse --abbrev-ref HEAD)
     --branch "$BRANCH" \\
   || { echo "[pycodekg] snapshot skipped (run 'pycodekg build' to initialize)" >&2; }
 
-# Stage the snapshot directory so it is included in the commit.
+# Stage the snapshot directory so it is included in the commit. These files are
+# added after `pre-commit run`, so they are not scanned by it — detect-secrets
+# already excludes snapshots/ by config, which is why that is safe.
 git add .pycodekg/snapshots/ 2>/dev/null || true
 
-# Run pre-commit framework checks (ruff, mypy, detect-secrets, etc.) AFTER
-# snapshots are captured and staged. Delegates to .pre-commit-config.yaml so
-# quality checks stay in one place.
-PRECOMMIT="$REPO_ROOT/.venv/bin/pre-commit"
-if [ -x "$PRECOMMIT" ]; then
-    "$PRECOMMIT" run || exit 1
-elif command -v pre-commit &>/dev/null; then
-    pre-commit run || exit 1
-fi
-
 exit 0
 """
 

{pycode_kg-0.21.0 → pycode_kg-0.21.2}/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-05-23 14:45:37
+Last Revision: 2026-07-28 22:44:43
 """
 
 from __future__ import annotations

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

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