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

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

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pycode-kg
-Version: 0.19.3
+Version: 0.21.0
 Summary: A tool to build a searchable knowledge graph from Python repositories
 License-Expression: Elastic-2.0
 License-File: LICENSE
-Keywords: knowledge-graph,code-analysis,ast,lancedb,sqlite,semantic-search
+Keywords: knowledge-graph,code-analysis,ast,sqlite-vec,sqlite,semantic-search
 Author: Eric G. Suchanek, PhD
-Author-email: suchanek@mac.com
+Author-email: suchanek@flux-frontiers.com
 Requires-Python: >=3.12,<3.14
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -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.15.2) ; extra == "dev"
-Requires-Dist: doc-kg (>=0.15.2) ; extra == "kgdeps"
-Requires-Dist: kgmodule-utils[semantic] (>=0.3.1)
+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: networkx (>=3.0)
 Requires-Dist: numpy (>=1.24.0)
 Requires-Dist: pandas (>=2.0.0)
 Requires-Dist: param (>=2.0.0) ; extra == "all"
@@ -41,8 +39,6 @@ Requires-Dist: plotly (>=5.14.0) ; extra == "all"
 Requires-Dist: plotly (>=5.14.0) ; extra == "viz"
 Requires-Dist: pre-commit (>=4.5.1) ; extra == "all"
 Requires-Dist: pre-commit (>=4.5.1) ; extra == "dev"
-Requires-Dist: pylint (>=4.0.5) ; extra == "all"
-Requires-Dist: pylint (>=4.0.5) ; extra == "dev"
 Requires-Dist: pytest (>=8.0.0) ; extra == "all"
 Requires-Dist: pytest (>=8.0.0) ; extra == "dev"
 Requires-Dist: pytest-cov (>=5.0.0) ; extra == "all"
@@ -58,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
@@ -77,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.19.3-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.21.0-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)
@@ -86,7 +82,7 @@ Description-Content-Type: text/markdown
 
 **PyCodeKG turns a Python codebase into a deterministic, queryable knowledge graph — and uses it to produce architectural analyses you can act on, with or without an LLM in the loop.**
 
-It walks the AST of every module, class, function, and method in your repo, extracts the typed relationships that actually hold the code together (`CONTAINS`, `CALLS`, `IMPORTS`, `INHERITS`, `RESOLVES_TO`), and stores the result in SQLite. A LanceDB vector index sits alongside the graph so that *"authentication flow"* and *"verify_jwt"* both find the right place to start exploring. From there you can rank functions by structural importance, trace fan-in across import aliases, detect circular imports and dead code, render the call graph in 3D, snapshot metrics for diffing across releases, or hand the whole thing to Claude over MCP.
+It walks the AST of every module, class, function, and method in your repo, extracts the typed relationships that actually hold the code together (`CONTAINS`, `CALLS`, `IMPORTS`, `INHERITS`, `RESOLVES_TO`), and stores the result in SQLite. A sqlite-vec vector index sits alongside the graph so that *"authentication flow"* and *"verify_jwt"* both find the right place to start exploring. From there you can rank functions by structural importance, trace fan-in across import aliases, detect circular imports and dead code, render the call graph in 3D, snapshot metrics for diffing across releases, or hand the whole thing to Claude over MCP.
 
 The original motivation was simple: **produce thorough, defensible analyses of Python codebases that don't depend on inference**. Every result is computed from the AST and the graph — no model is asked to guess. When an LLM is present, it consumes the *same* grounded output as a structured context pack, and the hallucinations that plague "embed-the-repo" tools largely disappear.
 
@@ -197,7 +193,7 @@ That's the recommended path. Variants (minimal install, MCP-only, contributor se
 
 Search is hybrid by design. A query like *"authentication flow"* runs in two phases:
 
-1. **Vector phase** — the query is embedded with a local sentence-transformer (cached after first download) and LanceDB returns the `k` closest functions, classes, and modules by cosine similarity.
+1. **Vector phase** — the query is embedded with a local sentence-transformer (cached after first download) and sqlite-vec returns the `k` closest functions, classes, and modules by exact cosine similarity.
 2. **Graph expansion phase** — each seed hit is expanded `hop` BFS steps along the typed edges (`CONTAINS`, `CALLS`, `IMPORTS`, `INHERITS`, `RESOLVES_TO`) so call chains and module relationships surface alongside the names that matched.
 
 **Structure is treated as ground truth; the embeddings are strictly an acceleration layer.** When the graph and the vector index disagree, the graph wins. This is why fan-in lookups are accurate even for same-named symbols across modules — `RESOLVES_TO` edges bridge call sites through their import aliases, and `callers()` does a two-phase reverse traversal that grep simply cannot replicate.
@@ -217,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) |
 
@@ -231,7 +228,7 @@ src/pycode_kg/
 ├── visitor.py                       # AST extraction (three-pass: structure, calls, dataflow)
 ├── graph.py                         # GraphBuilder: file discovery + dispatch
 ├── store.py                         # SQLite persistence + canonical edges
-├── index.py                         # LanceDB semantic index
+├── index.py                         # sqlite-vec semantic index
 ├── pycodekg.py                      # Public façade
 ├── pycodekg_query.py                # Hybrid query
 ├── pycodekg_snippet_packer.py       # Source-grounded packs
@@ -273,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.19.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.0) [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.19.0},
+  version   = {0.21.0},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
@@ -299,7 +296,7 @@ If you use PyCodeKG in your research or project, please cite it:
 
 - **Issues** — [GitHub Issues](https://github.com/Flux-Frontiers/pycode_kg/issues)
 - Sister projects [DocKG](https://github.com/Flux-Frontiers/doc_kg) and [MetaboKG](https://github.com/Flux-Frontiers/metabo_kg)
-- LanceDB, sentence-transformers, PyVista, Streamlit, and FastMCP for the foundations
+- sqlite-vec, sentence-transformers, PyVista, Streamlit, and FastMCP for the foundations
 
 ---
 

{pycode_kg-0.19.3 → pycode_kg-0.21.0}/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.19.3-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.21.0-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)
@@ -14,7 +14,7 @@
 
 **PyCodeKG turns a Python codebase into a deterministic, queryable knowledge graph — and uses it to produce architectural analyses you can act on, with or without an LLM in the loop.**
 
-It walks the AST of every module, class, function, and method in your repo, extracts the typed relationships that actually hold the code together (`CONTAINS`, `CALLS`, `IMPORTS`, `INHERITS`, `RESOLVES_TO`), and stores the result in SQLite. A LanceDB vector index sits alongside the graph so that *"authentication flow"* and *"verify_jwt"* both find the right place to start exploring. From there you can rank functions by structural importance, trace fan-in across import aliases, detect circular imports and dead code, render the call graph in 3D, snapshot metrics for diffing across releases, or hand the whole thing to Claude over MCP.
+It walks the AST of every module, class, function, and method in your repo, extracts the typed relationships that actually hold the code together (`CONTAINS`, `CALLS`, `IMPORTS`, `INHERITS`, `RESOLVES_TO`), and stores the result in SQLite. A sqlite-vec vector index sits alongside the graph so that *"authentication flow"* and *"verify_jwt"* both find the right place to start exploring. From there you can rank functions by structural importance, trace fan-in across import aliases, detect circular imports and dead code, render the call graph in 3D, snapshot metrics for diffing across releases, or hand the whole thing to Claude over MCP.
 
 The original motivation was simple: **produce thorough, defensible analyses of Python codebases that don't depend on inference**. Every result is computed from the AST and the graph — no model is asked to guess. When an LLM is present, it consumes the *same* grounded output as a structured context pack, and the hallucinations that plague "embed-the-repo" tools largely disappear.
 
@@ -125,7 +125,7 @@ That's the recommended path. Variants (minimal install, MCP-only, contributor se
 
 Search is hybrid by design. A query like *"authentication flow"* runs in two phases:
 
-1. **Vector phase** — the query is embedded with a local sentence-transformer (cached after first download) and LanceDB returns the `k` closest functions, classes, and modules by cosine similarity.
+1. **Vector phase** — the query is embedded with a local sentence-transformer (cached after first download) and sqlite-vec returns the `k` closest functions, classes, and modules by exact cosine similarity.
 2. **Graph expansion phase** — each seed hit is expanded `hop` BFS steps along the typed edges (`CONTAINS`, `CALLS`, `IMPORTS`, `INHERITS`, `RESOLVES_TO`) so call chains and module relationships surface alongside the names that matched.
 
 **Structure is treated as ground truth; the embeddings are strictly an acceleration layer.** When the graph and the vector index disagree, the graph wins. This is why fan-in lookups are accurate even for same-named symbols across modules — `RESOLVES_TO` edges bridge call sites through their import aliases, and `callers()` does a two-phase reverse traversal that grep simply cannot replicate.
@@ -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) |
 
@@ -159,7 +160,7 @@ src/pycode_kg/
 ├── visitor.py                       # AST extraction (three-pass: structure, calls, dataflow)
 ├── graph.py                         # GraphBuilder: file discovery + dispatch
 ├── store.py                         # SQLite persistence + canonical edges
-├── index.py                         # LanceDB semantic index
+├── index.py                         # sqlite-vec semantic index
 ├── pycodekg.py                      # Public façade
 ├── pycodekg_query.py                # Hybrid query
 ├── pycodekg_snippet_packer.py       # Source-grounded packs
@@ -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.19.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.0) [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.19.0},
+  version   = {0.21.0},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
@@ -227,7 +228,7 @@ If you use PyCodeKG in your research or project, please cite it:
 
 - **Issues** — [GitHub Issues](https://github.com/Flux-Frontiers/pycode_kg/issues)
 - Sister projects [DocKG](https://github.com/Flux-Frontiers/doc_kg) and [MetaboKG](https://github.com/Flux-Frontiers/metabo_kg)
-- LanceDB, sentence-transformers, PyVista, Streamlit, and FastMCP for the foundations
+- sqlite-vec, sentence-transformers, PyVista, Streamlit, and FastMCP for the foundations
 
 ---
 

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

@@ -1,7 +1,7 @@
 # pyproject.toml — PyCodeKG package configuration (PEP 621)
 #
 # Author: Eric G. Suchanek, PhD
-# Last Revision: 2026-04-24
+# Last Revision: 2026-07-28
 #
 # 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,29 +44,40 @@ build-backend = "poetry.core.masonry.api"
 [tool.poetry]
 packages = [{ include = "pycode_kg", from = "src" }]
 
-[tool.poetry.group.dev.dependencies]
-detect-secrets = ">=1.5.0"
-ty = "^0.0.41"
-pdoc = ">=14.0.0"
-pre-commit = ">=4.5.1"
-pylint = ">=4.0.5"
-pytest = ">=8.0.0"
-pytest-cov = ">=5.0.0"
-ruff = ">=0.4.0"
+# 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.19.3"
+version = "0.21.0"
 description = "A tool to build a searchable knowledge graph from Python repositories"
 readme = "README.md"
 license = "Elastic-2.0"
 authors = [
-    { name = "Eric G. Suchanek, PhD", email = "suchanek@mac.com" }
+    { name = "Eric G. Suchanek, PhD", email = "suchanek@flux-frontiers.com" }
 ]
-keywords = ["knowledge-graph", "code-analysis", "ast", "lancedb", "sqlite", "semantic-search"]
+keywords = ["knowledge-graph", "code-analysis", "ast", "sqlite-vec", "sqlite", "semantic-search"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
@@ -82,14 +91,15 @@ requires-python = ">=3.12,<3.14"
 dependencies = [
     "click>=8.1.0,<9",
     "mcp>=1.0.0",
+    "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]>=0.3.1",
+    "transformers>=5.5.0,<6",
+    "kgmodule-utils[semantic,sqlite-vec,viz]>=0.9.0",
 ]
 
 [project.optional-dependencies]
@@ -98,17 +108,14 @@ dev = [
     "ty>=0.0.41",
     "pdoc>=14.0.0",
     "pre-commit>=4.5.1",
-    "pylint>=4.0.5",
     "pytest>=8.0.0",
     "pytest-cov>=5.0.0",
     "ruff>=0.4.0",
-    "doc-kg>=0.15.2",
-    # 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",
@@ -119,10 +126,14 @@ 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.15.2",
-]
+# 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 'kg-rag @ git+https://github.com/Flux-Frontiers/KGRAG.git'
+#   pip install 'agent-kg @ git+https://github.com/Flux-Frontiers/agent_kg.git'
 all = [
     "detect-secrets>=1.5.0",
     "markdown>=3.6",
@@ -130,7 +141,6 @@ all = [
     "pdoc>=14.0.0",
     "plotly>=5.14.0",
     "pre-commit>=4.5.1",
-    "pylint>=4.0.5",
     "PyQt5>=5.15.0",
     "pytest>=8.0.0",
     "pytest-cov>=5.0.0",
@@ -138,7 +148,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",
 ]
@@ -152,7 +162,7 @@ pycodekg                = "pycode_kg.cli.main:cli"
 pycodekg-analyze        = "pycode_kg.cli.cmd_analyze:analyze"
 pycodekg-architecture   = "pycode_kg.cli.cmd_architecture:architecture"
 pycodekg-build          = "pycode_kg.cli.cmd_build_full:build"
-pycodekg-build-lancedb  = "pycode_kg.cli.cmd_build:build_lancedb"
+pycodekg-build-index    = "pycode_kg.cli.cmd_build:build_index"
 pycodekg-build-sqlite   = "pycode_kg.cli.cmd_build:build_sqlite"
 pycodekg-centrality     = "pycode_kg.cli.cmd_centrality:cmd_centrality"
 pycodekg-download-model = "pycode_kg.cli.cmd_model:download_model"
@@ -172,11 +182,24 @@ pycodekg-viz3d          = "pycode_kg.cli.cmd_viz:viz3d"
 [tool.ruff]
 line-length    = 100
 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"]
 
 [tool.ruff.lint]
-select = ["E", "F", "W", "I", "UP"]
+# B023, BLE001, PLC0415 replace the retired pylint hook's cell-var-from-loop,
+# broad-exception-caught, and import-outside-toplevel checks.
+select = ["E", "F", "W", "I", "UP", "B023", "BLE001", "PLC0415"]
 ignore = ["E501"]
 
+[tool.ruff.lint.per-file-ignores]
+# viz3d is GUI code full of deliberate lazy imports (optional Qt/pyvista deps).
+"src/pycode_kg/viz3d.py" = ["PLC0415"]
+# Test imports are often deliberately lazy — they must run after sys.modules
+# mocks are installed.
+"tests/**" = ["PLC0415"]
+
 [tool.ty.environment]
 python-version = "3.12"
 root = ["src"]
@@ -192,28 +215,14 @@ unresolved-import = "ignore"
 unused-ignore-comment = "ignore"
 
 [tool.pytest.ini_options]
-testpaths = ["tests"]
-addopts   = "-v --tb=short"
+testpaths  = ["tests"]
+addopts    = "-v --tb=short"
+pythonpath = ["src"]
 markers = [
     "slow: marks tests as slow (deselect with '-m not slow')",
-    "integration: marks tests that exercise real external dependencies (model, LanceDB)",
+    "integration: marks tests that exercise real external dependencies (model, sqlite-vec)",
 ]
 
-[tool.pylint.messages_control]
-disable = ["all"]
-enable = [
-    "broad-exception-caught",   # W0718
-    "cell-var-from-loop",       # W0640
-    "cyclic-import",            # R0401
-    "import-outside-toplevel",  # C0415
-    "undefined-variable",       # E0602
-]
-
-[tool.pylint.imports]
-# The kg → pycodekg_thorough_analysis cycle is broken at runtime by a lazy
-# import inside PyCodeKG.analyze().  Pylint's static analysis can't see that.
-ignored-modules = ["pycode_kg.pycodekg_thorough_analysis"]
-
 # ---------------------------------------------------------------------------
 # PyCodeKG / DocKG index configuration
 # ---------------------------------------------------------------------------

{pycode_kg-0.19.3 → pycode_kg-0.21.0}/src/pycode_kg/__init__.py

@@ -1,7 +1,7 @@
 """
 pycode_kg: A tool to build a searchable knowledge graph from Python repositories.
 
-Pure AST extraction → SQLite (authoritative) → LanceDB (semantic index).
+Pure AST extraction → SQLite (authoritative) → sqlite-vec (semantic index).
 
 Public API
 ----------
@@ -9,7 +9,7 @@ Primary entry point::
 
     from pycode_kg import PyCodeKG
 
-    kg = PyCodeKG(repo_root, db_path, lancedb_dir)
+    kg = PyCodeKG(repo_root, db_path)
     stats = kg.build(wipe=True)
     result = kg.query("database connection setup")
     pack = kg.pack("configuration loading")
@@ -32,7 +32,7 @@ KGModule SDK (build new domain KGs)::
     from pycode_kg import KGModule, KGExtractor, PyCodeKGExtractor, NodeSpec, EdgeSpec
 """
 
-__version__ = "0.19.3"
+__version__ = "0.21.0"
 __author__ = "Eric G. Suchanek, PhD"
 
 # Low-level primitives (locked v0 contract)

{pycode_kg-0.19.3 → pycode_kg-0.21.0}/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.19.3 → pycode_kg-0.21.0}/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.19.3 → pycode_kg-0.21.0}/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.19.3 → pycode_kg-0.21.0}/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
 """
 
@@ -62,7 +62,7 @@ def detect_framework_nodes(
     # against the module_connectivity metric.  Both signals end up keyed by
     # bare module path (e.g. "src/pycode_kg/store.py"), which we map to "mod:..."
     # IDs for output.
-    from pycode_kg.analysis.centrality import (  # pylint: disable=import-outside-toplevel
+    from pycode_kg.analysis.centrality import (  # noqa: PLC0415
         StructuralImportanceRanker,
         aggregate_module_scores,
     )