hypergumbo-core 2.0.0__tar.gz

hypergumbo_core-2.0.0/.gitignore

@@ -0,0 +1,43 @@
+# python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+
+# tooling
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# hypergumbo
+.hypergumbo/
+hypergumbo_capsule/
+hypergumbo.results.json
+hypergumbo.results.*.json
+slice.json
+
+# Agent configuration
+**/*.local.json
+**/*.local.md
+**/.claude/cache/
+**/.gemini/cache/
+**/.cursor/state/
+**/*-session/
+AUTONOMOUS_MODE.txt
+
+# Coverage
+.coverage
+.coverage.*
+htmlcov/
+coverage-report.txt
+
+# Node (bats testing)
+node_modules/
+package.json
+package-lock.json
+
+# Hypergumbo cache
+.hypergumbo_cache/

hypergumbo_core-2.0.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: hypergumbo-core
+Version: 2.0.0
+Summary: Core infrastructure for hypergumbo repo behavior map generator
+Author: Hypergumbo contributors
+License: AGPL-3.0-or-later
+Keywords: cli,code-graph,local-first,static-analysis
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tree-sitter>=0.21
+Provides-Extra: dev
+Requires-Dist: bandit>=1.8; extra == 'dev'
+Requires-Dist: check-jsonschema>=0.29; extra == 'dev'
+Requires-Dist: jsonschema>=4.18; extra == 'dev'
+Requires-Dist: pip-audit>=2.7; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest-xdist>=3; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Requires-Dist: yamllint>=1.35; extra == 'dev'
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=2.2; extra == 'embeddings'
+Description-Content-Type: text/markdown
+
+# hypergumbo-core
+
+Core infrastructure for hypergumbo repo behavior map generator.
+
+## What's Included
+
+- **CLI**: Command-line interface (`hypergumbo run`, `hypergumbo sketch`, etc.)
+- **IR**: Data structures (Symbol, Edge, Span, AnalysisRun)
+- **Analysis Framework**: Base classes and registry for language analyzers
+- **Linkers**: Cross-language relationship detection (gRPC, HTTP, IPC, etc.)
+- **Framework Patterns**: Route and handler detection for 150+ frameworks
+- **Slice**: Forward and reverse dependency analysis
+- **Sketch**: Token-budgeted codebase overview generation
+
+## Installation
+
+```bash
+# Core only (no language analyzers)
+pip install hypergumbo-core
+
+# Full installation (recommended)
+pip install hypergumbo
+```
+
+## Usage
+
+```python
+from hypergumbo_core.ir import Symbol, Edge, Span
+from hypergumbo_core.sketch import generate_sketch
+from hypergumbo_core.slice import forward_slice, reverse_slice
+```
+
+## Documentation
+
+See https://codeberg.org/iterabloom/hypergumbo for full documentation.

hypergumbo_core-2.0.0/README.md

@@ -0,0 +1,35 @@
+# hypergumbo-core
+
+Core infrastructure for hypergumbo repo behavior map generator.
+
+## What's Included
+
+- **CLI**: Command-line interface (`hypergumbo run`, `hypergumbo sketch`, etc.)
+- **IR**: Data structures (Symbol, Edge, Span, AnalysisRun)
+- **Analysis Framework**: Base classes and registry for language analyzers
+- **Linkers**: Cross-language relationship detection (gRPC, HTTP, IPC, etc.)
+- **Framework Patterns**: Route and handler detection for 150+ frameworks
+- **Slice**: Forward and reverse dependency analysis
+- **Sketch**: Token-budgeted codebase overview generation
+
+## Installation
+
+```bash
+# Core only (no language analyzers)
+pip install hypergumbo-core
+
+# Full installation (recommended)
+pip install hypergumbo
+```
+
+## Usage
+
+```python
+from hypergumbo_core.ir import Symbol, Edge, Span
+from hypergumbo_core.sketch import generate_sketch
+from hypergumbo_core.slice import forward_slice, reverse_slice
+```
+
+## Documentation
+
+See https://codeberg.org/iterabloom/hypergumbo for full documentation.

hypergumbo_core-2.0.0/pyproject.toml

@@ -0,0 +1,101 @@
+[build-system]
+requires = ["hatchling>=1.24"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hypergumbo-core"
+version = "2.0.0"
+description = "Core infrastructure for hypergumbo repo behavior map generator"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "AGPL-3.0-or-later" }
+authors = [{ name = "Hypergumbo contributors" }]
+keywords = ["static-analysis", "code-graph", "cli", "local-first"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+]
+dependencies = [
+  # Core tree-sitter for parsing
+  "tree-sitter>=0.21",
+  # CLI formatting
+  "rich>=13.0",
+  # YAML parsing for framework patterns
+  "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8",
+  "pytest-cov>=5",
+  "pytest-xdist>=3",
+  "ruff>=0.8",
+  "bandit>=1.8",
+  "pip-audit>=2.7",
+  "jsonschema>=4.18",
+  "yamllint>=1.35",
+  "check-jsonschema>=0.29",
+]
+embeddings = [
+  "sentence-transformers>=2.2",
+]
+
+[project.scripts]
+hypergumbo = "hypergumbo_core.cli:main"
+
+[project.entry-points."hypergumbo.analyzers"]
+# Core analyzers are registered here (none for core package)
+# Language packages will add their own entry points
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/hypergumbo_core"]
+
+[tool.pytest.ini_options]
+filterwarnings = [
+    "ignore:tree-sitter-.*not available:UserWarning",
+    "ignore:.*analysis skipped.*requires tree-sitter:UserWarning",
+    "ignore:int argument support is deprecated:DeprecationWarning",
+]
+
+[tool.coverage.run]
+omit = [
+    "*/sketch_embeddings.py",
+    "*/_embedding_data.py",
+    "*/__main__.py",
+]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+  "E",
+  "W",
+  "F",
+  "B",
+  "C4",
+  "S",
+  "RUF",
+]
+ignore = [
+  "E501",
+  "S101",
+  "S105",
+  "S106",
+  "S110",
+  "RUF059",
+  "RUF005",
+  "B028",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = ["S101", "S105", "S106", "S603", "S108", "E741", "F401", "F841", "RUF005"]
+"src/hypergumbo_core/analyze/*.py" = ["E402"]
+
+[tool.bandit]
+exclude_dirs = ["tests", ".venv"]
+skips = ["B101", "B105", "B110"]

hypergumbo_core-2.0.0/src/hypergumbo_core/__init__.py

@@ -0,0 +1,23 @@
+"""Hypergumbo Core: Core infrastructure for repo behavior map generation.
+
+This package provides the core infrastructure for static analysis, including:
+- IR (Symbol, Edge, Span) data structures
+- Analysis framework (base classes, registry)
+- Linkers for cross-language/cross-component relationships
+- Framework pattern detection
+- CLI entry point
+
+Version Note
+------------
+- **__version__**: The tool/package version. This version tracks CLI features,
+  analyzer additions, and bug fixes. Updated with each release.
+
+- **SCHEMA_VERSION** (in schema.py): The output format version. This version
+  tracks breaking changes to the JSON output schema. Consumers should check
+  schema_version in output to ensure compatibility.
+
+These versions are independent. The schema version only changes when the output
+format has breaking changes, while the tool version changes with any release.
+"""
+__all__ = ["__version__"]
+__version__ = "2.0.0"

hypergumbo_core-2.0.0/src/hypergumbo_core/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())