codesteward-graph 0.1.0__tar.gz

codesteward_graph-0.1.0/.gitignore

@@ -0,0 +1,134 @@
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets
+.history/
+*.vsix
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+.idea/**/aws.xml
+.idea/**/contentModel.xml
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+.idea/**/gradle.xml
+.idea/**/libraries
+cmake-build-*/
+.idea/**/mongoSettings.xml
+*.iws
+out/
+.idea_modules/
+atlassian-ide-plugin.xml
+.idea/replstate.xml
+.idea/sonarlint/
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+.idea/httpRequests
+.idea/caches/build_file_checksums.ser
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+._*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+*.manifest
+*.spec
+pip-log.txt
+pip-delete-this-directory.txt
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+*.mo
+*.pot
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+instance/
+.webassets-cache
+.scrapy
+docs/_build/
+.pybuilder/
+target/
+.ipynb_checkpoints
+profile_default/
+ipython_config.py
+.pdm.toml
+.pdm-python
+.pdm-build/
+__pypackages__/
+celerybeat-schedule
+celerybeat.pid
+*.sage.py
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.spyderproject
+.spyproject
+.ropeproject
+/site
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+cython_debug/
+.idea/

codesteward_graph-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: codesteward-graph
+Version: 0.1.0
+Summary: Multi-language structural code graph builder — 13 tree-sitter parsers + Neo4j writer
+Project-URL: Homepage, https://github.com/bitkaio/codesteward-mcp
+Project-URL: Repository, https://github.com/bitkaio/codesteward-mcp
+Project-URL: Issues, https://github.com/bitkaio/codesteward-mcp/issues
+Project-URL: Changelog, https://github.com/bitkaio/codesteward-mcp/blob/main/CHANGELOG.md
+Author: bitkaio LLC
+License: BSD-3-Clause
+Keywords: ast,code-graph,code-intelligence,neo4j,static-analysis,tree-sitter
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: neo4j>=5.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: structlog>=24.0
+Provides-Extra: graph
+Requires-Dist: tree-sitter-java>=0.23; extra == 'graph'
+Requires-Dist: tree-sitter-javascript>=0.23; extra == 'graph'
+Requires-Dist: tree-sitter-python>=0.23; extra == 'graph'
+Requires-Dist: tree-sitter-typescript>=0.23; extra == 'graph'
+Requires-Dist: tree-sitter>=0.24; extra == 'graph'
+Provides-Extra: graph-all
+Requires-Dist: tree-sitter-c-sharp>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter-c>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter-cpp>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter-go>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter-java>=0.23; extra == 'graph-all'
+Requires-Dist: tree-sitter-javascript>=0.23; extra == 'graph-all'
+Requires-Dist: tree-sitter-kotlin>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter-php>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter-python>=0.23; extra == 'graph-all'
+Requires-Dist: tree-sitter-rust>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter-scala>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter-typescript>=0.23; extra == 'graph-all'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-all'
+Requires-Dist: tree-sitter>=0.24; extra == 'graph-all'
+Provides-Extra: graph-c
+Requires-Dist: tree-sitter-c>=0.21; extra == 'graph-c'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-c'
+Provides-Extra: graph-cpp
+Requires-Dist: tree-sitter-cpp>=0.21; extra == 'graph-cpp'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-cpp'
+Provides-Extra: graph-csharp
+Requires-Dist: tree-sitter-c-sharp>=0.21; extra == 'graph-csharp'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-csharp'
+Provides-Extra: graph-go
+Requires-Dist: tree-sitter-go>=0.21; extra == 'graph-go'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-go'
+Provides-Extra: graph-kotlin
+Requires-Dist: tree-sitter-kotlin>=0.21; extra == 'graph-kotlin'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-kotlin'
+Provides-Extra: graph-php
+Requires-Dist: tree-sitter-php>=0.21; extra == 'graph-php'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-php'
+Provides-Extra: graph-rust
+Requires-Dist: tree-sitter-rust>=0.21; extra == 'graph-rust'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-rust'
+Provides-Extra: graph-scala
+Requires-Dist: tree-sitter-scala>=0.21; extra == 'graph-scala'
+Requires-Dist: tree-sitter>=0.21; extra == 'graph-scala'
+Description-Content-Type: text/markdown
+
+# codesteward-graph
+
+Multi-language structural code graph builder — parses source repositories into
+`LexicalNode` + edge data and writes to Neo4j.
+
+Part of the [Codesteward MCP](https://github.com/bitkaio/codesteward-mcp) project.
+For full documentation, setup guides, and the MCP server, see the main repository.
+
+## What it does
+
+- Parses 13 languages via tree-sitter AST (TypeScript, JavaScript, Python, Java, Go,
+  Rust, PHP, C#, Kotlin, Scala, C, C++); COBOL via regex
+- Extracts functions, classes, imports, call graphs, inheritance chains, and auth guard
+  annotations (`GUARDED_BY` / `PROTECTED_BY` edges)
+- Resolves cross-file call relationships in a single post-parse pass
+- Writes to Neo4j with tenant + repo namespacing; operates in stub mode without Neo4j
+
+## Install
+
+```bash
+# Core languages (TypeScript, JavaScript, Python, Java)
+uv add "codesteward-graph[graph]"
+
+# All 14 languages
+uv add "codesteward-graph[graph-all]"
+
+# Without tree-sitter (COBOL only; all other parsers will raise ImportError)
+uv add codesteward-graph
+```
+
+## Quick usage
+
+```python
+import asyncio
+from codesteward.engine.graph_builder import GraphBuilder
+
+async def main():
+    builder = GraphBuilder()          # stub mode — no Neo4j
+    summary = await builder.build_graph(
+        repo_path="/path/to/repo",
+        tenant_id="local",
+        repo_id="my-repo",
+    )
+    print(summary)
+
+asyncio.run(main())
+```
+
+## License
+
+BSD 3-Clause — Copyright (c) 2026, bitkaio LLC

codesteward_graph-0.1.0/README.md

@@ -0,0 +1,51 @@
+# codesteward-graph
+
+Multi-language structural code graph builder — parses source repositories into
+`LexicalNode` + edge data and writes to Neo4j.
+
+Part of the [Codesteward MCP](https://github.com/bitkaio/codesteward-mcp) project.
+For full documentation, setup guides, and the MCP server, see the main repository.
+
+## What it does
+
+- Parses 13 languages via tree-sitter AST (TypeScript, JavaScript, Python, Java, Go,
+  Rust, PHP, C#, Kotlin, Scala, C, C++); COBOL via regex
+- Extracts functions, classes, imports, call graphs, inheritance chains, and auth guard
+  annotations (`GUARDED_BY` / `PROTECTED_BY` edges)
+- Resolves cross-file call relationships in a single post-parse pass
+- Writes to Neo4j with tenant + repo namespacing; operates in stub mode without Neo4j
+
+## Install
+
+```bash
+# Core languages (TypeScript, JavaScript, Python, Java)
+uv add "codesteward-graph[graph]"
+
+# All 14 languages
+uv add "codesteward-graph[graph-all]"
+
+# Without tree-sitter (COBOL only; all other parsers will raise ImportError)
+uv add codesteward-graph
+```
+
+## Quick usage
+
+```python
+import asyncio
+from codesteward.engine.graph_builder import GraphBuilder
+
+async def main():
+    builder = GraphBuilder()          # stub mode — no Neo4j
+    summary = await builder.build_graph(
+        repo_path="/path/to/repo",
+        tenant_id="local",
+        repo_id="my-repo",
+    )
+    print(summary)
+
+asyncio.run(main())
+```
+
+## License
+
+BSD 3-Clause — Copyright (c) 2026, bitkaio LLC

codesteward_graph-0.1.0/pyproject.toml

@@ -0,0 +1,71 @@
+[project]
+name = "codesteward-graph"
+version = "0.1.0"
+description = "Multi-language structural code graph builder — 13 tree-sitter parsers + Neo4j writer"
+readme = "README.md"
+requires-python = ">=3.12"
+license = {text = "BSD-3-Clause"}
+authors = [
+    {name = "bitkaio LLC"},
+]
+keywords = ["code-graph", "tree-sitter", "ast", "static-analysis", "neo4j", "code-intelligence"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Quality Assurance",
+    "Typing :: Typed",
+]
+dependencies = [
+    "structlog>=24.0",
+    "pyyaml>=6.0",
+    "neo4j>=5.0",
+]
+
+[project.urls]
+Homepage   = "https://github.com/bitkaio/codesteward-mcp"
+Repository = "https://github.com/bitkaio/codesteward-mcp"
+Issues     = "https://github.com/bitkaio/codesteward-mcp/issues"
+Changelog  = "https://github.com/bitkaio/codesteward-mcp/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+# Core tree-sitter grammars (TypeScript / JS / Python / Java)
+graph = [
+    "tree-sitter>=0.24",
+    "tree-sitter-typescript>=0.23",
+    "tree-sitter-javascript>=0.23",
+    "tree-sitter-python>=0.23",
+    "tree-sitter-java>=0.23",
+]
+graph-csharp = ["tree-sitter>=0.21", "tree-sitter-c-sharp>=0.21"]
+graph-kotlin = ["tree-sitter>=0.21", "tree-sitter-kotlin>=0.21"]
+graph-scala  = ["tree-sitter>=0.21", "tree-sitter-scala>=0.21"]
+graph-go     = ["tree-sitter>=0.21", "tree-sitter-go>=0.21"]
+graph-c      = ["tree-sitter>=0.21", "tree-sitter-c>=0.21"]
+graph-cpp    = ["tree-sitter>=0.21", "tree-sitter-cpp>=0.21"]
+graph-rust   = ["tree-sitter>=0.21", "tree-sitter-rust>=0.21"]
+graph-php    = ["tree-sitter>=0.21", "tree-sitter-php>=0.21"]
+# All 14 languages at once
+graph-all = [
+    "codesteward-graph[graph]",
+    "codesteward-graph[graph-csharp]",
+    "codesteward-graph[graph-kotlin]",
+    "codesteward-graph[graph-scala]",
+    "codesteward-graph[graph-go]",
+    "codesteward-graph[graph-c]",
+    "codesteward-graph[graph-cpp]",
+    "codesteward-graph[graph-rust]",
+    "codesteward-graph[graph-php]",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+# codesteward.engine — namespace package, no __init__.py at codesteward/ level
+packages = ["src/codesteward"]