codemesh 0.1.1__tar.gz

codemesh-0.1.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,29 @@
+---
+name: Bug report
+about: Report a bug in CodeMesh
+title: "[BUG] "
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce:
+1. Run `codemesh index` on ...
+2. Run `codemesh query "..."` ...
+3. See error
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- OS: [e.g. macOS 14, Ubuntu 24.04]
+- Python: [e.g. 3.12.5]
+- CodeMesh: [e.g. 0.1.0]
+- Repo size: [e.g. ~500 files, 50K LOC]
+
+**Additional context**
+Any other context, screenshots, or logs.

codemesh-0.1.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest a feature for CodeMesh
+title: "[FEATURE] "
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem?**
+A clear description of the problem. E.g. "I can't index PHP projects..."
+
+**Describe the solution you'd like**
+What you want to happen.
+
+**Describe alternatives you've considered**
+Any alternative solutions or workarounds.
+
+**Additional context**
+Add any other context, examples, or screenshots.

codemesh-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv run --with ".[dev]" ruff check .
+      - run: uv run --with ".[dev]" ruff format --check
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - run: uv run --with ".[dev]" mypy codemesh/ --ignore-missing-imports || true
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv run --with ".[dev]" pytest tests/ -v --cov=codemesh --cov-report=xml --ignore=tests/test_embedding_e2e.py --ignore=tests/test_viz.py
+      - uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.12'
+        with:
+          file: coverage.xml

codemesh-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # Required for trusted publishing
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v4
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

codemesh-0.1.1/.gitignore

@@ -0,0 +1,233 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+# .python-version
+
+# pipenv
+# Pipfile.lock
+
+# UV
+# uv.lock
+
+# poetry
+# poetry.lock
+# poetry.toml
+
+# pdm
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+# pixi.lock
+.pixi
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm / JetBrains
+.idea/
+
+# Visual Studio Code
+.vscode/
+*.swp
+*.swo
+
+# Ruff
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+
+# =============================================================================
+# AI Agent / LLM Internal Working Files
+# These files are for developer tooling (Claude Code, Hermes Agent, etc.)
+# and are NOT part of the CodeMesh project functionality.
+# =============================================================================
+
+# Claude Code
+.claude/
+CLAUDE.md
+AGENTS.md
+
+# Hermes Agent
+.hermes/
+hermes.yaml
+hermes.yml
+.hermesagent/
+.hacfg
+
+# OpenCode
+.opencode/
+
+# Cursor
+.cursor/
+.cursorrules
+
+# Continue.dev
+.continue/
+
+# GitHub Copilot
+.copilot/
+
+# =============================================================================
+# =============================================================================
+
+# OS
+.DS_Store
+Thumbs.db
+Thumbs.db:encryptable
+*.stackdump
+[Cc]rash[Rr]eports/
+retirejs.json
+
+# Project specific
+*.db
+*.sqlite
+*.sqlite3
+.codemesh/
+codemesh.egg-info/
+
+# Model cache (downloaded embedding/reranker models)
+.models/
+*.onnx
+*.bin
+*.safetensors
+
+# Temporary files
+*.tmp
+*.bak
+*~
+\\#*\\#
+
+# Benchmark comparison files (internal use, not for publication)
+codemesh/benchmark/
+docs/docs/
+docs/

codemesh-0.1.1/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## [0.1.0] - 2026-05-24
+
+### Added
+- Initial project skeleton
+- Hybrid structural+semantic code RAG architecture

codemesh-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,102 @@
+# Contributing to CodeMesh
+
+## Getting Started
+
+```bash
+git clone https://github.com/gkatte/codemesh.git
+cd codemesh
+uv pip install -e ".[dev]"
+```
+
+## Running Tests
+
+```bash
+# Run all tests (fast)
+pytest tests/ -x -q
+
+# Run with coverage
+pytest tests/ -v --cov=codemesh --cov-report=html
+
+# Skip slow/integration tests
+pytest tests/ -x -q -m "not slow"
+```
+
+Tests must pass before every commit.
+
+```bash
+ruff check . --fix && ruff format .
+```
+
+## Project Structure
+
+```
+codemesh/
+├── cli/            # Typer CLI commands (init, index, query, etc.)
+├── db/             # SQLite schema, connections, queries
+├── extraction/     # tree-sitter AST extraction + language-specific extractors
+├── resolution/     # Reference resolution + type inference
+├── search/         # BM25 keyword search (3-tier: FTS5, LIKE, fuzzy)
+├── graph/          # Graph walk (BFS), traversal, impact analysis
+├── context/        # Context builder (token-budget-aware XML output)
+├── mcp/            # MCP server (stdio/SSE transport)
+└── types.py        # Shared types: Node, Edge, EdgeKind, NodeKind
+```
+
+## Supported Languages
+
+| Language    | tree-sitter package          | File Extensions          |
+|-------------|-----------------------------|--------------------------|
+| Python      | `tree-sitter-python`         | `.py`                    |
+| TypeScript  | `tree-sitter-typescript`     | `.ts`, `.tsx`           |
+| JavaScript  | `tree-sitter-typescript`     | `.js`, `.jsx`           |
+| Rust        | `tree-sitter-rust`           | `.rs`                    |
+| Go          | `tree-sitter-go`             | `.go`                    |
+| Java        | `tree-sitter-java`           | `.java`                  |
+| Kotlin      | `tree-sitter-kotlin`         | `.kt`, `.kts`           |
+| Swift       | `tree-sitter-swift`          | `.swift`                 |
+| C           | `tree-sitter-c`              | `.c`, `.h`              |
+| C++         | `tree-sitter-cpp`            | `.cpp`, `.hpp`, `.cc`   |
+
+## Adding a New Language
+
+1. **Add the tree-sitter dependency** to `pyproject.toml`:
+   ```toml
+   "tree-sitter-mylang>=0.5",
+   ```
+
+2. **Create a new extractor** in `codemesh/extraction/extractors/mylang.py`:
+   - Use `tree-sitter` to parse source files
+   - Define AST query patterns for the language (functions, classes, methods, imports)
+   - Extract nodes (`Node` objects) and edges (`Edge` objects)
+   - Register in the `extractor_for_ext()` dispatcher
+
+3. **Add file extensions** to the `EXTRACTOR_MAP` or equivalent dispatcher in the extraction module.
+
+4. **Add a test** in `tests/test_extraction.py` covering:
+   - Node extraction accuracy
+   - Edge extraction (calls, imports, contains)
+   - Integration test with the full pipeline
+
+5. **Update this file** — add the language to the table above.
+
+6. **Update `codemesh/cli/init.py`** — add the language's agent instruction template.
+
+## Adding a New Edge Kind
+
+1. Add the variant to the `EdgeKind` enum in `codemesh/types.py`
+2. Update all extractors that should produce this edge kind
+3. Add a partial index in `codemesh/db/schema.py` for query performance
+
+## Code Style
+
+- Modern Python: `from __future__ import annotations`, dataclasses, `pathlib`, match statements
+- Every module and public function gets a docstring
+- No dead code — delete orphaned helpers
+- Schema changes: add columns with defaults (never breaking)
+
+## Commit Rules
+
+- One logical change per commit
+- Write meaningful commit messages describing WHAT and WHY
+- Run `ruff check . --fix && ruff format .` before committing
+- Tests must pass before committing

codemesh-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CodeMesh Developer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codemesh-0.1.1/Makefile

@@ -0,0 +1,28 @@
+.PHONY: help install dev lint typecheck test test-cov clean
+
+help: ## Show this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | \
+		awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+install: ## Install production dependencies
+	uv pip install -e .
+
+dev: ## Install with dev dependencies
+	uv pip install -e ".[dev]"
+
+lint: ## Run ruff linter + formatter
+	ruff check . --fix
+	ruff format .
+
+typecheck: ## Run mypy type checker
+	mypy codemesh/
+
+test: ## Run tests
+	pytest tests/ -v
+
+test-cov: ## Run tests with coverage
+	pytest tests/ -v --cov=codemesh --cov-report=term-missing
+
+clean: ## Clean build artifacts
+	rm -rf build/ dist/ *.egg-info .pytest_cache .mypy_cache .ruff_cache
+	find . -type d -name __pycache__ -exec rm -rf {} +