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

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

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pycode-kg
-Version: 0.19.2
+Version: 0.20.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
@@ -25,14 +25,12 @@ 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: 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: markdown (>=3.6) ; extra == "all"
 Requires-Dist: markdown (>=3.6) ; extra == "viz3d"
 Requires-Dist: mcp (>=1.0.0)
-Requires-Dist: mypy (>=1.10.0) ; extra == "all"
-Requires-Dist: mypy (>=1.10.0) ; extra == "dev"
 Requires-Dist: numpy (>=1.24.0)
 Requires-Dist: pandas (>=2.0.0)
 Requires-Dist: param (>=2.0.0) ; extra == "all"
@@ -43,8 +41,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"
@@ -66,6 +62,8 @@ 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: ty (>=0.0.41) ; extra == "all"
+Requires-Dist: ty (>=0.0.41) ; extra == "dev"
 Project-URL: Homepage, https://github.com/Flux-Frontiers/pycode_kg
 Project-URL: Repository, https://github.com/Flux-Frontiers/pycode_kg
 Description-Content-Type: text/markdown
@@ -77,7 +75,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.1-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.20.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 +84,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 +195,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.
@@ -231,7 +229,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 +271,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.20.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.20.0},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
@@ -299,7 +297,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.2 → pycode_kg-0.20.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.1-blue.svg)](https://github.com/Flux-Frontiers/pycode_kg/releases)
+[![Version](https://img.shields.io/badge/version-0.20.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.
@@ -159,7 +159,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 +201,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.20.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.20.0},
   year      = {2026},
   publisher = {Flux-Frontiers},
   url       = {https://github.com/Flux-Frontiers/pycode_kg},
@@ -227,7 +227,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.2 → pycode_kg-0.20.0}/pyproject.toml

@@ -1,13 +1,13 @@
 # pyproject.toml — PyCodeKG package configuration (PEP 621)
 #
 # Author: Eric G. Suchanek, PhD
-# Last Revision: 2026-04-24
+# Last Revision: 2026-07-15
 #
 # Build system : Poetry 2.x with PEP 621 [project] table
 #
 # Quick install (pip)
 # -------------------
-#   pip install -e ".[dev]"             core + dev tools (pytest, ruff, mypy, etc.)
+#   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)
@@ -46,29 +46,19 @@ build-backend = "poetry.core.masonry.api"
 [tool.poetry]
 packages = [{ include = "pycode_kg", from = "src" }]
 
-[tool.poetry.group.dev.dependencies]
-detect-secrets = ">=1.5.0"
-mypy = ">=1.10.0"
-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"
-
 # ---------------------------------------------------------------------------
 # PEP 621 project metadata
 # ---------------------------------------------------------------------------
 [project]
 name = "pycode-kg"
-version = "0.19.2"
+version = "0.20.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",
@@ -89,20 +79,19 @@ dependencies = [
     "sentence-transformers>=5.4.1",
     "torch>=2.5.1",
     "transformers>=4.40.0,<4.57",
-    "kgmodule-utils[semantic]>=0.3.1",
+    "kgmodule-utils[semantic,sqlite-vec]>=0.6.2",
 ]
 
 [project.optional-dependencies]
 dev = [
     "detect-secrets>=1.5.0",
-    "mypy>=1.10.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",
-    "doc-kg>=0.15.2",
+    "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 = [
@@ -121,17 +110,15 @@ viz3d = [
 
 # note that dockg is on pypi; agent-kg is not yet — install manually from git
 kgdeps = [
-    "doc-kg>=0.15.2",
+    "doc-kg>=0.18.1",
 ]
 all = [
     "detect-secrets>=1.5.0",
     "markdown>=3.6",
-    "mypy>=1.10.0",
     "param>=2.0.0",
     "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",
@@ -141,6 +128,7 @@ all = [
     "ruff>=0.4.0",
     "streamlit>=1.35.0",
     "trame-vtk>=2.0.0",
+    "ty>=0.0.41",
 ]
 
 [project.urls]
@@ -152,7 +140,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,41 +160,47 @@ 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"]
 
 [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.mypy]
-python_version        = "3.12"
-strict                = false
-ignore_missing_imports = true
-mypy_path             = "src"
-explicit_package_bases = true
+[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"]
+
+[tool.ty.rules]
+# Be lenient about third-party stubs (mirrors mypy's ignore_missing_imports).
+unresolved-import = "ignore"
+# viz3d.py carries `# ty: ignore` suppressions for param/PyQt5/pyvista false
+# positives. Those libraries live in the optional viz/viz3d extras, so in the
+# lean CI install the imports are Unknown, the errors don't fire, and the
+# ignores look "unused". Don't fail the build on that — the suppressions are
+# still honored locally where the extras (and the errors) are present.
+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)",
-]
-
-[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
+    "integration: marks tests that exercise real external dependencies (model, sqlite-vec)",
 ]
 
-[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.2 → pycode_kg-0.20.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.2"
+__version__ = "0.20.0"
 __author__ = "Eric G. Suchanek, PhD"
 
 # Low-level primitives (locked v0 contract)

{pycode_kg-0.19.2 → pycode_kg-0.20.0}/src/pycode_kg/analysis/framework_detector.py

@@ -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,
     )

{pycode_kg-0.19.2 → pycode_kg-0.20.0}/src/pycode_kg/app.py

@@ -57,7 +57,7 @@ _REL_COLOR: dict[str, str] = {
 import os as _os  # noqa: E402
 
 _DEFAULT_DB = _os.environ.get("PYCODEKG_DB", ".pycodekg/graph.sqlite")
-_DEFAULT_LANCEDB = _os.environ.get("PYCODEKG_LANCEDB", ".pycodekg/lancedb")
+_DEFAULT_VECTORS = _os.environ.get("PYCODEKG_VECTORS", ".pycodekg/vectors.sqlite")
 
 # ---------------------------------------------------------------------------
 # Page config (must be first Streamlit call)
@@ -147,7 +147,7 @@ def _get_store() -> GraphStore | None:
 
 
 @st.cache_resource(show_spinner="Loading PyCodeKG (embedder may take a moment)…")
-def _load_kg(repo_root: str, db_path: str, lancedb_dir: str, model: str):
+def _load_kg(repo_root: str, db_path: str, vectors_path: str, model: str):
     """
     Load and cache a ``PyCodeKG`` instance for the given configuration.
 
@@ -157,16 +157,16 @@ def _load_kg(repo_root: str, db_path: str, lancedb_dir: str, model: str):
 
     :param repo_root: Root directory of the Python repository to analyse.
     :param db_path: Path to the SQLite graph database.
-    :param lancedb_dir: Directory for the LanceDB vector index.
+    :param vectors_path: Path to the sqlite-vec vector store.
     :param model: Name of the sentence-transformer embedding model to use.
     :return: An initialised ``PyCodeKG`` instance.
     """
-    from pycode_kg import PyCodeKG  # pylint: disable=import-outside-toplevel
+    from pycode_kg import PyCodeKG  # noqa: PLC0415
 
     return PyCodeKG(
         repo_root=repo_root,
         db_path=db_path,
-        lancedb_dir=lancedb_dir,
+        vectors_path=vectors_path,
         model=model,
     )
 
@@ -592,7 +592,7 @@ def _render_node_detail(node: dict, store: GraphStore | None = None) -> None:
                 (node_id, node_id),
             ).fetchall()
             if rows:
-                import pandas as pd  # pylint: disable=import-outside-toplevel  # pylint: disable=import-outside-toplevel
+                import pandas as pd  # noqa: PLC0415
 
                 edf = pd.DataFrame([{"src": r[0], "rel": r[1], "dst": r[2]} for r in rows])
                 st.dataframe(edf, use_container_width=True, hide_index=True)
@@ -694,12 +694,12 @@ def _render_sidebar() -> dict:
     """
     Render the sidebar controls and return a configuration dictionary.
 
-    Exposes controls for the SQLite path, repo root, LanceDB directory,
+    Exposes controls for the SQLite path, repo root, sqlite-vec store path,
     embedding model, query parameters (k, hops, relations, include_symbols),
     graph display options (max nodes, physics, height), and build buttons
     for the graph and semantic index.
 
-    :return: A dict with keys ``db_path``, ``repo_root``, ``lancedb_dir``,
+    :return: A dict with keys ``db_path``, ``repo_root``, ``vectors_path``,
         ``model``, ``k``, ``hop``, ``rels``, ``include_symbols``,
         ``max_graph_nodes``, ``physics_on``, ``graph_height``, and ``store``.
     """
@@ -738,10 +738,10 @@ def _render_sidebar() -> dict:
         value=str(Path.cwd()),
         help="Root directory of the Python repository to analyse",
     )
-    lancedb_dir = st.sidebar.text_input(
-        "LanceDB dir",
-        value=_DEFAULT_LANCEDB,
-        help="Directory for the LanceDB vector index",
+    vectors_path = st.sidebar.text_input(
+        "Vector store path",
+        value=_DEFAULT_VECTORS,
+        help="Path to the sqlite-vec vector store",
     )
     model = st.sidebar.selectbox(
         "Embedding model",
@@ -789,12 +789,12 @@ def _render_sidebar() -> dict:
     )
     build_index_btn = build_col2.button(
         "🧠 Build Index",
-        help="Embed nodes → LanceDB (requires graph to exist)",
+        help="Embed nodes → sqlite-vec (requires graph to exist)",
         use_container_width=True,
     )
     build_all_btn = st.sidebar.button(
         "⚡ Build All (graph + index)",
-        help="Full pipeline: AST → SQLite → LanceDB",
+        help="Full pipeline: AST → SQLite → sqlite-vec",
         use_container_width=True,
         type="primary",
     )
@@ -803,14 +803,14 @@ def _render_sidebar() -> dict:
         with st.sidebar:
             with st.spinner("Building graph (AST → SQLite)…"):
                 try:
-                    from pycode_kg import (  # pylint: disable=import-outside-toplevel
+                    from pycode_kg import (  # noqa: PLC0415
                         PyCodeKG,
                     )
 
                     kg = PyCodeKG(
                         repo_root=repo_root,
                         db_path=db_path,
-                        lancedb_dir=lancedb_dir,
+                        vectors_path=vectors_path,
                         model=model,
                     )
                     if build_all_btn:
@@ -835,16 +835,16 @@ def _render_sidebar() -> dict:
 
     if build_index_btn and not build_all_btn:
         with st.sidebar:
-            with st.spinner("Building semantic index (SQLite → LanceDB)…"):
+            with st.spinner("Building semantic index (SQLite → sqlite-vec)…"):
                 try:
-                    from pycode_kg import (  # pylint: disable=import-outside-toplevel
+                    from pycode_kg import (  # noqa: PLC0415
                         PyCodeKG,
                     )
 
                     kg = PyCodeKG(
                         repo_root=repo_root,
                         db_path=db_path,
-                        lancedb_dir=lancedb_dir,
+                        vectors_path=vectors_path,
                         model=model,
                     )
                     stats = kg.build_index(wipe=True)
@@ -856,7 +856,7 @@ def _render_sidebar() -> dict:
     return {
         "db_path": db_path,
         "repo_root": repo_root,
-        "lancedb_dir": lancedb_dir,
+        "vectors_path": vectors_path,
         "model": model,
         "k": k,
         "hop": hop,
@@ -945,7 +945,7 @@ def _tab_graph(cfg: dict) -> None:
     st.iframe(html, height=int(cfg["graph_height"].replace("px", "")))
 
     with st.expander("📋 Node table"):
-        import pandas as pd  # pylint: disable=import-outside-toplevel
+        import pandas as pd  # noqa: PLC0415
 
         df = pd.DataFrame(
             [
@@ -984,7 +984,7 @@ def _tab_query(cfg: dict) -> None:
 
     :param cfg: Configuration dictionary returned by ``_render_sidebar``,
         providing keys such as ``store``, ``repo_root``, ``db_path``,
-        ``lancedb_dir``, ``model``, ``k``, ``hop``, ``rels``,
+        ``vectors_path``, ``model``, ``k``, ``hop``, ``rels``,
         ``include_symbols``, ``graph_height``, and ``physics_on``.
     """
     st.header("🔍 Hybrid Query")
@@ -1007,7 +1007,7 @@ def _tab_query(cfg: dict) -> None:
                 kg = _load_kg(
                     cfg["repo_root"],
                     cfg["db_path"],
-                    cfg["lancedb_dir"],
+                    cfg["vectors_path"],
                     cfg["model"],
                 )
                 result = kg.query(
@@ -1052,7 +1052,7 @@ def _tab_query(cfg: dict) -> None:
             st.info("No nodes to display.")
 
     with tab_table:
-        import pandas as pd  # pylint: disable=import-outside-toplevel
+        import pandas as pd  # noqa: PLC0415
 
         df = pd.DataFrame(
             [
@@ -1075,7 +1075,7 @@ def _tab_query(cfg: dict) -> None:
 
     with tab_edges:
         if result.edges:
-            import pandas as pd  # pylint: disable=import-outside-toplevel
+            import pandas as pd  # noqa: PLC0415
 
             edf = pd.DataFrame(
                 [
@@ -1119,7 +1119,7 @@ def _tab_snippets(cfg: dict) -> None:
 
     :param cfg: Configuration dictionary returned by ``_render_sidebar``,
         providing keys such as ``store``, ``repo_root``, ``db_path``,
-        ``lancedb_dir``, ``model``, ``k``, ``hop``, ``rels``,
+        ``vectors_path``, ``model``, ``k``, ``hop``, ``rels``,
         ``include_symbols``, and ``physics_on``.
     """
     st.header("📦 Snippet Pack")
@@ -1152,7 +1152,7 @@ def _tab_snippets(cfg: dict) -> None:
                 kg = _load_kg(
                     cfg["repo_root"],
                     cfg["db_path"],
-                    cfg["lancedb_dir"],
+                    cfg["vectors_path"],
                     cfg["model"],
                 )
                 pack = kg.pack(
@@ -1249,7 +1249,7 @@ def _tab_snippets(cfg: dict) -> None:
     # Edges table
     if pack.edges:
         with st.expander(f"🔗 Edges ({len(pack.edges)})"):
-            import pandas as pd  # pylint: disable=import-outside-toplevel
+            import pandas as pd  # noqa: PLC0415
 
             edf = pd.DataFrame(
                 [

{pycode_kg-0.19.2 → pycode_kg-0.20.0}/src/pycode_kg/architecture.py

@@ -460,7 +460,7 @@ class ArchitectureAnalyzer:
                 "name": "Graph Query Pipeline",
                 "description": "Semantic search → graph expansion → snippet packing",
                 "steps": [
-                    "Semantic search finds seed nodes via LanceDB",
+                    "Semantic search finds seed nodes via sqlite-vec",
                     "Graph expansion traverses CALLS, CONTAINS, IMPORTS edges",
                     "Snippet pack materializes source code with context",
                 ],

{pycode_kg-0.19.2 → pycode_kg-0.20.0}/src/pycode_kg/cli/__init__.py

@@ -12,7 +12,7 @@ The root Click group is importable from either location::
 from pycode_kg.cli import (  # noqa: F401  — registers snapshot (save, list, show, diff)
     cmd_analyze,  # noqa: F401  — registers analyze
     cmd_architecture,  # noqa: F401  — registers architecture
-    cmd_build,  # noqa: F401  — registers build-sqlite, build-lancedb
+    cmd_build,  # noqa: F401  — registers build-sqlite, build-index
     cmd_build_full,  # noqa: F401  — registers build (full pipeline), update (incremental upsert)
     cmd_centrality,  # noqa: F401  — registers centrality
     cmd_explain,  # noqa: F401  — registers explain

{pycode_kg-0.19.2 → pycode_kg-0.20.0}/src/pycode_kg/cli/cmd_analyze.py

@@ -27,10 +27,10 @@ from pycode_kg.pycodekg_thorough_analysis import main as run_analysis
     help="SQLite knowledge graph path (default: <repo>/.pycodekg/graph.sqlite).",
 )
 @click.option(
-    "--lancedb",
+    "--vectors",
     default=None,
     type=click.Path(),
-    help="LanceDB vector index directory (default: <repo>/.pycodekg/lancedb).",
+    help="sqlite-vec vector store path (default: <repo>/.pycodekg/vectors.sqlite).",
 )
 @click.option(
     "--output",
@@ -63,7 +63,7 @@ from pycode_kg.pycodekg_thorough_analysis import main as run_analysis
 def analyze(
     repo_root: str,
     db: str | None,
-    lancedb: str | None,
+    vectors: str | None,
     output: str | None,
     json_path: str | None,
     quiet: bool,
@@ -86,7 +86,7 @@ def analyze(
     run_analysis(
         repo_root=repo_root,
         db_path=db,
-        lancedb_path=lancedb,
+        vectors_path=vectors,
         report_path=output,
         json_path=json_path,
         quiet=quiet,