tscode-kg 0.2.0__tar.gz

tscode_kg-0.2.0/LICENSE

@@ -0,0 +1,24 @@
+BSD 2-Clause License
+
+Copyright (c) 2026, Flux-Frontiers
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

tscode_kg-0.2.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: tscode-kg
+Version: 0.2.0
+Summary: Knowledge graph for TypeScript/JavaScript codebases — AST extraction, hybrid semantic+structural search
+License-Expression: Elastic-2.0
+License-File: LICENSE
+Keywords: knowledge-graph,typescript,javascript,ast,sqlite-vec,sqlite,semantic-search
+Author: Eric G. Suchanek, PhD
+Author-email: suchanek@mac.com
+Requires-Python: >=3.12,<3.14
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: dev
+Provides-Extra: kgdeps
+Provides-Extra: viz
+Provides-Extra: viz3d
+Requires-Dist: PyQt5 (>=5.15.11,<5.16) ; extra == "viz3d"
+Requires-Dist: click (>=8.1.0,<9)
+Requires-Dist: detect-secrets (>=1.5.0) ; extra == "dev"
+Requires-Dist: doc-kg (>=0.18.1) ; extra == "kgdeps"
+Requires-Dist: kgmodule-utils[semantic,sqlite-vec] (>=0.8.0)
+Requires-Dist: markdown (>=3.10,<3.11) ; extra == "viz3d"
+Requires-Dist: mcp (>=1.0.0,<2)
+Requires-Dist: networkx (>=3.0)
+Requires-Dist: param (>=2.4,<2.5) ; extra == "viz3d"
+Requires-Dist: plotly (>=6.8.0,<6.9) ; extra == "viz"
+Requires-Dist: pre-commit (>=4.5.1) ; extra == "dev"
+Requires-Dist: pycode-kg (>=0.20.0,<0.21) ; extra == "dev"
+Requires-Dist: pycode-kg (>=0.20.0,<0.21) ; extra == "kgdeps"
+Requires-Dist: pylint (>=4.0.5) ; extra == "dev"
+Requires-Dist: pytest (>=8.0.0) ; extra == "dev"
+Requires-Dist: pytest-cov (>=5.0.0) ; extra == "dev"
+Requires-Dist: pyvis (>=0.3.2,<0.4) ; extra == "viz"
+Requires-Dist: pyvista (>=0.48.4,<0.49) ; extra == "viz3d"
+Requires-Dist: pyvistaqt (>=0.12,<0.13) ; extra == "viz3d"
+Requires-Dist: rich (>=14.3.3,<15)
+Requires-Dist: ruff (>=0.4.0) ; extra == "dev"
+Requires-Dist: streamlit (>=1.59.0,<1.60) ; extra == "viz"
+Requires-Dist: trame-vtk (>=2.11.8,<2.12) ; extra == "viz3d"
+Requires-Dist: tree-sitter (>=0.25.0)
+Requires-Dist: tree-sitter-typescript (>=0.23.2)
+Requires-Dist: ty (>=0.0.41) ; extra == "dev"
+Project-URL: Homepage, https://github.com/Flux-Frontiers/tscode_kg
+Project-URL: Repository, https://github.com/Flux-Frontiers/tscode_kg
+Description-Content-Type: text/markdown
+
+# TypeScriptKG
+
+Knowledge graph for TypeScript and JavaScript codebases — deterministic AST extraction, hybrid semantic + structural search.
+
+## Overview
+
+TypeScriptKG builds a queryable knowledge graph from TypeScript/JavaScript source code using:
+
+- **tree-sitter** for deterministic, parser-level AST extraction (no LLM inference during indexing)
+- **SQLite** for the structural graph (nodes, edges, provenance)
+- **sqlite-vec** for the semantic vector index (embeddings via `BAAI/bge-small-en-v1.5`)
+- **Hybrid retrieval**: semantic seed → graph hop expansion → lexical re-ranking
+
+## Node types
+
+| Kind | Description |
+|------|-------------|
+| `module` | Every indexed `.ts`/`.tsx`/`.js`/`.jsx` file |
+| `class` | Class declaration |
+| `interface` | TypeScript interface |
+| `type_alias` | TypeScript type alias |
+| `enum` | TypeScript enum |
+| `namespace` | TypeScript namespace / module declaration |
+| `function` | Module-level function (declaration or `const` arrow) |
+| `method` | Method or accessor within a class |
+| `symbol` | Unresolved external import stub |
+
+## Edge types
+
+| Relation | Description |
+|----------|-------------|
+| `CONTAINS` | module → class/function/interface… |
+| `IMPORTS` | module → module |
+| `CALLS` | function/method → function |
+| `INHERITS` | class extends class |
+| `IMPLEMENTS` | class implements interface |
+| `EXTENDS` | interface extends interface |
+
+## Quick start
+
+```bash
+pip install tscode-kg
+
+# First-time setup (downloads model, builds graph, installs hooks, snapshots)
+tscodekg init --repo /path/to/ts-repo
+
+# Build the KG for a TypeScript repo
+tscodekg build --repo /path/to/ts-repo
+
+# Query
+tscodekg query "authentication middleware"
+tscodekg pack "error handling utilities" --hop 2
+
+# Thorough architectural analysis (fan-in/out, CodeRank, SIR centrality, JSDoc coverage)
+tscodekg analyze /path/to/ts-repo --report analysis.md
+
+# Structural rankings and node explanations
+tscodekg centrality --top 20
+tscodekg bridges --top 20
+tscodekg framework-nodes --top 20
+tscodekg explain "fn:src/utils/helpers.ts:formatDate"
+
+# Temporal metric snapshots
+tscodekg snapshot save --repo /path/to/ts-repo
+tscodekg snapshot list
+
+# Interactive visualizers (install extras: tscode-kg[viz] / tscode-kg[viz3d])
+tscodekg viz --port 8500
+tscodekg viz3d --layout allium
+tscodekg viz-timeline --type 2d
+
+# Install the pre-commit snapshot hook
+tscodekg install-hooks --repo /path/to/ts-repo
+
+# MCP server (Claude Desktop, Cursor, etc.)
+tscodekg mcp --repo /path/to/ts-repo
+```
+
+Each subcommand is also available as a dedicated script alias — `tscodekg-init`,
+`tscodekg-build`, `tscodekg-query`, `tscodekg-pack`, `tscodekg-analyze`,
+`tscodekg-centrality`, `tscodekg-viz`, `tscodekg-viz3d`, `tscodekg-viz-timeline`,
+`tscodekg-install-hooks`, `tscodekg-download-model`, `tscodekg-mcp` — both forms
+are equivalent.
+
+## MCP tools
+
+The MCP server exposes the full PyCodeKG toolkit, applied to TypeScript/JavaScript
+codebases: `graph_stats`, `query_codebase`, `pack_snippets`, `callers`, `get_node`,
+`list_nodes`, `find_node`, `centrality`, `bridge_centrality`, `framework_nodes`,
+`find_definition_at`, `analyze_repo`, `explain`, `rank_nodes`, `query_ranked`,
+`explain_rank`, `snapshot_list`, `snapshot_show`, and `snapshot_diff`.
+
+See `docs/MCP.md` for setup and `docs/CHEATSHEET.md` for a query cookbook.
+Repo-local Claude Code skills live in `skills/`.
+
+## Snapshots & git hook
+
+`tscodekg snapshot save` captures graph metrics (nodes, edges, JSDoc coverage,
+issues, hotspots) keyed by git tree hash into `.tscodekg/snapshots/`, with
+deltas computed against the previous and baseline snapshots.
+`tscodekg install-hooks` installs a pre-commit hook that rebuilds the index,
+captures a snapshot, stages the snapshot directory, and then runs the
+pre-commit framework checks — so every commit records the state of the
+knowledge graph. Skip it for one commit with `TSCODEKG_SKIP_SNAPSHOT=1`.
+
+## Python API
+
+```python
+from tscode_kg import TypeScriptKG
+
+kg = TypeScriptKG(repo_root="/path/to/ts-repo")
+stats = kg.build(wipe=True)
+
+result = kg.query("authentication middleware", k=8)
+result.print_summary()
+
+pack = kg.pack("error handling", k=8, hop=1)
+pack.save("context.md")
+```
+
+## Architecture
+
+TypeScriptKG is a domain implementation of the `KGModule` base class from `kgmodule-utils`.
+Only the TypeScript/JS-specific extraction layer is implemented here — all generic
+infrastructure (SQLite, sqlite-vec, hybrid query, snippet packing) is inherited from
+`KGModule`.
+
+## Configuration
+
+In your project's `pyproject.toml`:
+
+```toml
+[tool.tscodekg]
+include = ["src"]           # top-level dirs to index (empty = all)
+exclude = ["__tests__"]     # extra dirs to skip
+```
+
+## Author
+
+Eric G. Suchanek, PhD — Flux Frontiers
+
+## License
+
+Elastic-2.0
+

tscode_kg-0.2.0/README.md

@@ -0,0 +1,144 @@
+# TypeScriptKG
+
+Knowledge graph for TypeScript and JavaScript codebases — deterministic AST extraction, hybrid semantic + structural search.
+
+## Overview
+
+TypeScriptKG builds a queryable knowledge graph from TypeScript/JavaScript source code using:
+
+- **tree-sitter** for deterministic, parser-level AST extraction (no LLM inference during indexing)
+- **SQLite** for the structural graph (nodes, edges, provenance)
+- **sqlite-vec** for the semantic vector index (embeddings via `BAAI/bge-small-en-v1.5`)
+- **Hybrid retrieval**: semantic seed → graph hop expansion → lexical re-ranking
+
+## Node types
+
+| Kind | Description |
+|------|-------------|
+| `module` | Every indexed `.ts`/`.tsx`/`.js`/`.jsx` file |
+| `class` | Class declaration |
+| `interface` | TypeScript interface |
+| `type_alias` | TypeScript type alias |
+| `enum` | TypeScript enum |
+| `namespace` | TypeScript namespace / module declaration |
+| `function` | Module-level function (declaration or `const` arrow) |
+| `method` | Method or accessor within a class |
+| `symbol` | Unresolved external import stub |
+
+## Edge types
+
+| Relation | Description |
+|----------|-------------|
+| `CONTAINS` | module → class/function/interface… |
+| `IMPORTS` | module → module |
+| `CALLS` | function/method → function |
+| `INHERITS` | class extends class |
+| `IMPLEMENTS` | class implements interface |
+| `EXTENDS` | interface extends interface |
+
+## Quick start
+
+```bash
+pip install tscode-kg
+
+# First-time setup (downloads model, builds graph, installs hooks, snapshots)
+tscodekg init --repo /path/to/ts-repo
+
+# Build the KG for a TypeScript repo
+tscodekg build --repo /path/to/ts-repo
+
+# Query
+tscodekg query "authentication middleware"
+tscodekg pack "error handling utilities" --hop 2
+
+# Thorough architectural analysis (fan-in/out, CodeRank, SIR centrality, JSDoc coverage)
+tscodekg analyze /path/to/ts-repo --report analysis.md
+
+# Structural rankings and node explanations
+tscodekg centrality --top 20
+tscodekg bridges --top 20
+tscodekg framework-nodes --top 20
+tscodekg explain "fn:src/utils/helpers.ts:formatDate"
+
+# Temporal metric snapshots
+tscodekg snapshot save --repo /path/to/ts-repo
+tscodekg snapshot list
+
+# Interactive visualizers (install extras: tscode-kg[viz] / tscode-kg[viz3d])
+tscodekg viz --port 8500
+tscodekg viz3d --layout allium
+tscodekg viz-timeline --type 2d
+
+# Install the pre-commit snapshot hook
+tscodekg install-hooks --repo /path/to/ts-repo
+
+# MCP server (Claude Desktop, Cursor, etc.)
+tscodekg mcp --repo /path/to/ts-repo
+```
+
+Each subcommand is also available as a dedicated script alias — `tscodekg-init`,
+`tscodekg-build`, `tscodekg-query`, `tscodekg-pack`, `tscodekg-analyze`,
+`tscodekg-centrality`, `tscodekg-viz`, `tscodekg-viz3d`, `tscodekg-viz-timeline`,
+`tscodekg-install-hooks`, `tscodekg-download-model`, `tscodekg-mcp` — both forms
+are equivalent.
+
+## MCP tools
+
+The MCP server exposes the full PyCodeKG toolkit, applied to TypeScript/JavaScript
+codebases: `graph_stats`, `query_codebase`, `pack_snippets`, `callers`, `get_node`,
+`list_nodes`, `find_node`, `centrality`, `bridge_centrality`, `framework_nodes`,
+`find_definition_at`, `analyze_repo`, `explain`, `rank_nodes`, `query_ranked`,
+`explain_rank`, `snapshot_list`, `snapshot_show`, and `snapshot_diff`.
+
+See `docs/MCP.md` for setup and `docs/CHEATSHEET.md` for a query cookbook.
+Repo-local Claude Code skills live in `skills/`.
+
+## Snapshots & git hook
+
+`tscodekg snapshot save` captures graph metrics (nodes, edges, JSDoc coverage,
+issues, hotspots) keyed by git tree hash into `.tscodekg/snapshots/`, with
+deltas computed against the previous and baseline snapshots.
+`tscodekg install-hooks` installs a pre-commit hook that rebuilds the index,
+captures a snapshot, stages the snapshot directory, and then runs the
+pre-commit framework checks — so every commit records the state of the
+knowledge graph. Skip it for one commit with `TSCODEKG_SKIP_SNAPSHOT=1`.
+
+## Python API
+
+```python
+from tscode_kg import TypeScriptKG
+
+kg = TypeScriptKG(repo_root="/path/to/ts-repo")
+stats = kg.build(wipe=True)
+
+result = kg.query("authentication middleware", k=8)
+result.print_summary()
+
+pack = kg.pack("error handling", k=8, hop=1)
+pack.save("context.md")
+```
+
+## Architecture
+
+TypeScriptKG is a domain implementation of the `KGModule` base class from `kgmodule-utils`.
+Only the TypeScript/JS-specific extraction layer is implemented here — all generic
+infrastructure (SQLite, sqlite-vec, hybrid query, snippet packing) is inherited from
+`KGModule`.
+
+## Configuration
+
+In your project's `pyproject.toml`:
+
+```toml
+[tool.tscodekg]
+include = ["src"]           # top-level dirs to index (empty = all)
+exclude = ["__tests__"]     # extra dirs to skip
+```
+
+## Author
+
+Eric G. Suchanek, PhD — Flux Frontiers
+
+## License
+
+Elastic-2.0

tscode_kg-0.2.0/pyproject.toml

@@ -0,0 +1,162 @@
+# pyproject.toml — TypeScriptKG package configuration (PEP 621)
+#
+# Author: Eric G. Suchanek, PhD
+#
+# Build system : Poetry 2.x with PEP 621 [project] table
+#
+# Quick install (pip)
+# -------------------
+#   pip install -e ".[dev]"    core + dev tools
+#   pip install -e "."         core runtime only
+#
+# First-time setup
+# ----------------
+#   python -m venv .venv
+#   source .venv/bin/activate
+#   pip install -e ".[dev]"
+#
+# Build KG indices
+# ----------------
+#   tscodekg build --repo .
+
+[build-system]
+requires = ["poetry-core>=2.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry]
+packages = [{ include = "tscode_kg", from = "src" }]
+
+[project]
+name = "tscode-kg"
+version = "0.2.0"
+description = "Knowledge graph for TypeScript/JavaScript codebases — AST extraction, hybrid semantic+structural search"
+readme = "README.md"
+license = "Elastic-2.0"
+authors = [
+    { name = "Eric G. Suchanek, PhD", email = "suchanek@mac.com" }
+]
+keywords = ["knowledge-graph", "typescript", "javascript", "ast", "sqlite-vec", "sqlite", "semantic-search"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+requires-python = ">=3.12,<3.14"
+dependencies = [
+    # Core: tree-sitter AST extraction + CLI skeleton. kgmodule-utils supplies
+    # the NodeSpec/EdgeSpec/KGExtractor types the extractor is built on;
+    # click drives the tscodekg command group (subcommands lazily import the
+    # heavier build/query/mcp pieces below).
+    "tree-sitter>=0.25.0",
+    "tree-sitter-typescript>=0.23.2",
+    "rich>=14.3.3,<15",
+    "kgmodule-utils[semantic,sqlite-vec]>=0.8.0",
+    "click>=8.1.0,<9",
+    # 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/tscode_kg/mcp_server.py imports
+    # FastMCP from mcp, so an unbounded floor lets a clean install pull 2.x and
+    # break `tscodekg-mcp` at import time. Lift this only alongside a port to
+    # the standalone fastmcp package.
+    "mcp>=1.0.0,<2",
+    "networkx>=3.0",
+]
+
+[project.optional-dependencies]
+# Cross-KG: PyCodeKG (Python codebases) and DocKG (docs) available from within tscode_kg
+kgdeps = [
+    "pycode-kg>=0.20.0,<0.21",
+    "doc-kg>=0.18.1",
+]
+# Streamlit graph explorer + plotly timeline.
+# Version brackets follow pycode_kg's proven lockfile versions.
+viz = [
+    "plotly>=6.8.0,<6.9",
+    "pyvis>=0.3.2,<0.4",
+    "streamlit>=1.59.0,<1.60",
+]
+# PyVista/PyQt5 3-D visualizer.
+# NOTE: deliberately plain `pyvista`, not `pyvista[jupyter]` — the jupyter
+# extra's trame/jupyter subtree sends Poetry's resolver into runaway
+# marker-split re-solving (hours, not minutes). The Qt interactor does not
+# need it; for in-notebook rendering or HTML export install
+# `pip install "pyvista[jupyter]"` manually.
+viz3d = [
+    "markdown>=3.10,<3.11",
+    "param>=2.4,<2.5",
+    "PyQt5>=5.15.11,<5.16",
+    "pyvista>=0.48.4,<0.49",
+    "pyvistaqt>=0.12,<0.13",
+    "trame-vtk>=2.11.8,<2.12",
+]
+dev = [
+    "detect-secrets>=1.5.0",
+    # This repo is Python — pycodekg indexes it and runs in the pre-commit hook.
+    "pycode-kg>=0.20.0,<0.21",
+    "ty>=0.0.41",
+    "pre-commit>=4.5.1",
+    "pylint>=4.0.5",
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+    "ruff>=0.4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Flux-Frontiers/tscode_kg"
+Repository = "https://github.com/Flux-Frontiers/tscode_kg"
+
+[project.scripts]
+tscodekg                = "tscode_kg.cli.main:cli"
+tscodekg-analyze        = "tscode_kg.cli.cmd_analyze:analyze"
+tscodekg-build          = "tscode_kg.cli.cmd_build:build"
+tscodekg-centrality     = "tscode_kg.cli.cmd_centrality:centrality"
+tscodekg-download-model = "tscode_kg.cli.cmd_model:download_model"
+tscodekg-init           = "tscode_kg.cli.cmd_init:init"
+tscodekg-install-hooks  = "tscode_kg.cli.cmd_hooks:install_hooks"
+tscodekg-query          = "tscode_kg.cli.cmd_query:query"
+tscodekg-pack           = "tscode_kg.cli.cmd_query:pack"
+tscodekg-viz            = "tscode_kg.cli.cmd_viz:viz"
+tscodekg-viz3d          = "tscode_kg.cli.cmd_viz:viz3d"
+tscodekg-viz-timeline   = "tscode_kg.cli.cmd_viz:viz_timeline"
+tscodekg-mcp            = "tscode_kg.mcp_server:main"
+
+[tool.ruff]
+line-length    = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP"]
+ignore = ["E501"]
+
+[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"
+markers = [
+    "slow: marks tests as slow",
+    "integration: marks tests that require real model/sqlite-vec",
+]
+
+[tool.tscodekg]
+include = ["src"]
+
+# This repo is Python — PyCodeKG (not TypeScriptKG) indexes it on commit.
+[tool.pycodekg]
+include = ["src"]

tscode_kg-0.2.0/src/tscode_kg/__init__.py

@@ -0,0 +1,42 @@
+"""
+tscode_kg: Knowledge graph for TypeScript/JavaScript codebases.
+
+Pure tree-sitter AST extraction → SQLite (authoritative) → sqlite-vec (semantic index).
+
+Primary entry point::
+
+    from tscode_kg import TypeScriptKG
+
+    kg = TypeScriptKG(repo_root="/path/to/ts-repo")
+    stats = kg.build(wipe=True)
+    result = kg.query("authentication middleware")
+    pack = kg.pack("error handling utilities")
+    pack.save("context.md")
+
+KGExtractor SDK::
+
+    from tscode_kg import TSCodeExtractor
+"""
+
+__version__ = "0.2.0"
+__author__ = "Eric G. Suchanek, PhD"
+
+from tscode_kg.extractor import TSCodeExtractor
+
+__all__ = [
+    "TSCodeExtractor",
+]
+
+try:
+    from tscode_kg.analysis import TSCodeKGAnalyzer
+    from tscode_kg.kg import BuildStats, QueryResult, SnippetPack, TypeScriptKG
+
+    __all__ += [
+        "TypeScriptKG",
+        "TSCodeKGAnalyzer",
+        "BuildStats",
+        "QueryResult",
+        "SnippetPack",
+    ]
+except ImportError:
+    pass  # kgmodule-utils[semantic] not installed; extractor still works standalone

tscode_kg-0.2.0/src/tscode_kg/__main__.py

@@ -0,0 +1,6 @@
+"""Allow ``python -m tscode_kg`` to invoke the CLI."""
+
+from tscode_kg.cli.main import cli
+
+if __name__ == "__main__":
+    cli()