codetrellis 1.0.0__tar.gz

codetrellis-1.0.0/CHANGELOG.md

@@ -0,0 +1,91 @@
+# Changelog
+
+All notable changes to CodeTrellis will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-03-14
+
+### 🎉 First Public Release
+
+First public PyPI release. Consolidates 83 internal development sessions.
+
+### Highlights
+
+- 120+ language and framework parsers
+- MCP server for AI context injection
+- JIT context engine for file-level queries
+- Best Practices Library with 4,500+ practices
+- Build contracts and quality gates
+- Support for Python, TypeScript, Go, Rust, Java, C#, and 100+ more
+- Works with GitHub Copilot, Claude, Cursor, and Windsurf
+
+### Internal History
+
+Developed through sessions 1–83 (versions 4.9.0–5.7.0 internally).
+See STATUS.md for detailed session history.
+
+## [4.16.0] - 2026-01-31
+
+### Added
+
+- MCP server for AI context injection (`codetrellis mcp`)
+- JIT context engine for file-level queries (`codetrellis context --file`)
+- AI skills generation from matrix (`codetrellis skills`)
+- Matrix embeddings support for semantic search
+- JSON-LD matrix export for structured data
+- Matrix diff for incremental change detection
+- Matrix navigator for interactive exploration
+- MatrixBench scorer for quality benchmarking
+- Plugin system with discovery and management (`codetrellis plugins`)
+- Distributed matrix generation across component folders
+- Interactive onboarding guide (`codetrellis onboard`)
+- Progress tracking with TODOs and blockers (`codetrellis progress`)
+- Cross-language type resolution
+- Cache optimizer for build performance
+- Parallel extraction with async support
+- 80+ language/framework parsers including:
+  - Web: React, Vue, Svelte, Angular, Astro, Lit, Alpine.js, HTMX
+  - Backend: FastAPI, Flask, Django, Express, Fastify, Hono, Koa, Hapi, Litestar
+  - Systems: Go, Rust, C, C++, Zig
+  - JVM: Java, Kotlin, Scala (with Spring Boot, Hibernate, Jakarta EE)
+  - .NET: C#, ASP.NET Core, Entity Framework, Dapper, MassTransit, Hangfire
+  - Mobile: Swift, Dart/Flutter, React Native
+  - Data: SQL, Prisma, tRPC, GraphQL
+  - Styling: CSS, SCSS, Less, Tailwind, Emotion, Styled Components, Chakra UI
+  - Config: YAML, TOML, Dockerfile, Terraform, Nginx
+  - Other: Lua, Bash, R, Perl, Zig, Solidity
+
+### Changed
+
+- Build contract system with advanced validation (D1)
+- Compression levels from L0 (raw) to L5 (ultra)
+- Semantic extraction for routes, APIs, and business domain
+- File classification with confidence scoring
+- Init integrations for Copilot, Cursor, Windsurf, and Claude
+
+### Fixed
+
+- Phase 1: Test reliability — eliminated flaky tests, fixed 6,775 test baseline
+- Phase 2: Technical debt — centralized error handling, structured error codes
+- Phase 3: Parser quality — robust fallback paths, graceful degradation
+- Phase 4: DX improvements — help text, error messages, documentation
+
+## [4.15.0]
+
+### Added
+
+- Initial public release
+- Project scanning with `codetrellis scan`
+- Matrix compression pipeline
+- CLI interface with scan, show, prompt, watch commands
+- Python, JavaScript, TypeScript parser support
+
+---
+
+[1.0.0]: https://github.com/chaudhary-keshav/codetrellis-matrix/releases/tag/v1.0.0
+[4.16.0]: https://github.com/chaudhary-keshav/codetrellis-matrix/compare/v4.15.0...v4.16.0
+[4.15.0]: https://github.com/chaudhary-keshav/codetrellis-matrix/releases/tag/v4.15.0

codetrellis-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Keshav Chaudhary
+
+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.

codetrellis-1.0.0/MANIFEST.in

@@ -0,0 +1,17 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include codetrellis/py.typed
+recursive-include codetrellis *.py *.yaml *.yml *.json
+recursive-exclude tests *
+recursive-exclude docs *
+recursive-exclude build *
+recursive-exclude scripts *
+exclude generate_letterhead.py
+exclude requirements*.txt
+exclude .gitignore
+prune .codetrellis
+prune .github
+prune best_practices
+prune lsp
+prune codetrellis.egg-info

codetrellis-1.0.0/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: codetrellis
+Version: 1.0.0
+Summary: CodeTrellis - Project Self-Awareness System - AI context injection tool
+Author-email: Keshav Chaudhary <keshav@nsbrain.ai>
+License: MIT
+Project-URL: Homepage, https://github.com/chaudhary-keshav/codetrellis-matrix
+Project-URL: Repository, https://github.com/chaudhary-keshav/codetrellis-matrix
+Project-URL: Changelog, https://github.com/chaudhary-keshav/codetrellis-matrix/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/chaudhary-keshav/codetrellis-matrix/blob/main/README.md
+Project-URL: Bug Tracker, https://github.com/chaudhary-keshav/codetrellis-matrix/issues
+Keywords: ai,context,code-analysis,project-scanner,prompt-engineering,copilot,developer-tools,mcp,model-context-protocol,code-context,github-copilot,claude,cursor,windsurf,ai-context,code-scanner,code-intelligence,ast-parser,framework-parser
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: watchdog>=3.0.0
+Provides-Extra: ast
+Requires-Dist: tree-sitter>=0.22.0; extra == "ast"
+Requires-Dist: tree-sitter-java>=0.23.0; extra == "ast"
+Requires-Dist: tree-sitter-python>=0.23.0; extra == "ast"
+Requires-Dist: tree-sitter-typescript>=0.23.0; extra == "ast"
+Provides-Extra: yaml
+Requires-Dist: pyyaml>=6.0; extra == "yaml"
+Provides-Extra: color
+Requires-Dist: colorama>=0.4.6; extra == "color"
+Provides-Extra: tokens
+Requires-Dist: tiktoken>=0.5.0; extra == "tokens"
+Provides-Extra: all
+Requires-Dist: codetrellis[ast,color,tokens,yaml]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-timeout>=2.3.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.11.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: numpy>=2.0.0; extra == "dev"
+Requires-Dist: faker>=19.0.0; extra == "dev"
+Requires-Dist: hypothesis>=6.82.0; extra == "dev"
+Requires-Dist: jsonpatch>=1.33; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: pyyaml>=6.0; extra == "dev"
+Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# CodeTrellis — Give AI Full Project Awareness
+
+> Scan your codebase, compress to ~1K tokens, inject into every AI prompt.
+
+[![PyPI](https://img.shields.io/pypi/v/codetrellis)](https://pypi.org/project/codetrellis/)
+[![Python](https://img.shields.io/pypi/pyversions/codetrellis)](https://pypi.org/project/codetrellis/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-7264%20passing-brightgreen)]()
+
+**Works with:** GitHub Copilot | Claude | Cursor | Windsurf | any MCP-compatible AI
+
+---
+
+## The Problem
+
+- AI assistants read files one at a time — they never see your full project
+- They don't know about existing components, schemas, or patterns
+- You explain your project structure repeatedly in every conversation
+- AI lacks business domain understanding — doesn't know _why_ code exists
+
+## Quick Start
+
+```bash
+pip install codetrellis
+codetrellis scan /path/to/project --optimal
+codetrellis init . --ai   # sets up Copilot/Claude/Cursor integration
+```
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                         CodeTrellis WORKFLOW                           │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   1. SCAN              2. COMPRESS           3. INJECT          │
+│   ─────────            ───────────           ────────           │
+│                                                                 │
+│   Read every     →    Convert to      →    Add to every        │
+│   file in             minimal              AI prompt            │
+│   project             tokens                                    │
+│                                                                 │
+│   187 lines      →    30 tokens       →    Full awareness      │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Top Features
+
+- **120+ language/framework parsers** — Python, TypeScript, Go, Rust, Java, C#, and more
+- **MCP server** for real-time AI context injection (JSON-RPC 2.0)
+- **JIT context engine** — delivers only relevant sections for the file you're editing
+- **Incremental builds** — only re-extract changed files
+- **Best Practices Library** — 4,500+ practices auto-selected for your stack
+- **Output tiers** — from ~800 tokens (compact) to full code context (logic)
+- **CI/CD mode** — deterministic, parallel builds for pipelines
+- **AI integration** — auto-generates Copilot, Claude, Cursor, Windsurf configs
+
+📋 [Full feature list](docs/FEATURES.md)
+
+## Installation
+
+```bash
+pip install codetrellis
+
+# Optional extras
+pip install codetrellis[all]     # AST parsing, YAML, color, token counting
+pip install codetrellis[ast]     # Tree-sitter AST parsing only
+```
+
+## Output Tiers
+
+| Tier      | Truncation | Tokens      | Use Case                                    |
+| --------- | ---------- | ----------- | ------------------------------------------- |
+| `compact` | Yes        | ~800-2000   | Quick overview                              |
+| `prompt`  | **NO**     | ~8000-15000 | Default AI injection (includes code logic!) |
+| `full`    | **NO**     | ~15000+     | Detailed analysis                           |
+| `logic`   | **NO**     | ~30000+     | Full code context                           |
+| `json`    | **NO**     | Variable    | Machine processing                          |
+
+```bash
+# Use tiers
+codetrellis scan ./project --tier compact   # Minimal
+codetrellis scan ./project --tier prompt    # Default (recommended)
+codetrellis scan ./project --tier full      # Everything
+codetrellis scan ./project --tier logic     # With function bodies
+```
+
+## CLI Commands
+
+```bash
+# Scanning
+codetrellis scan [path]              # Scan project
+codetrellis scan [path] --optimal    # Maximum quality (recommended)
+codetrellis scan [path] --incremental  # Only changed files
+codetrellis scan [path] --ci         # CI/CD mode (deterministic + parallel)
+codetrellis scan --remote <url>      # Scan a remote git repo
+
+# AI Integration
+codetrellis init . --ai              # Generate Copilot/Claude/Cursor configs
+codetrellis init . --update-ai       # Regenerate AI files (no re-scan)
+codetrellis mcp --stdio              # Start MCP server
+codetrellis context path/to/file.py  # JIT context for a file
+codetrellis skills                   # Generate AI-executable skills
+
+# View & Export
+codetrellis show                     # Show full matrix
+codetrellis prompt                   # Print prompt-ready matrix
+codetrellis export --json            # Export as JSON
+
+# Quality & Maintenance
+codetrellis verify [path]            # Build quality gate
+codetrellis validate [path]          # Validate extraction completeness
+codetrellis coverage [path]          # Show extraction coverage
+codetrellis watch                    # Auto-sync on file changes
+codetrellis clean [path]             # Clean caches
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT License — Keshav Chaudhary 2026

codetrellis-1.0.0/README.md

@@ -0,0 +1,125 @@
+# CodeTrellis — Give AI Full Project Awareness
+
+> Scan your codebase, compress to ~1K tokens, inject into every AI prompt.
+
+[![PyPI](https://img.shields.io/pypi/v/codetrellis)](https://pypi.org/project/codetrellis/)
+[![Python](https://img.shields.io/pypi/pyversions/codetrellis)](https://pypi.org/project/codetrellis/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-7264%20passing-brightgreen)]()
+
+**Works with:** GitHub Copilot | Claude | Cursor | Windsurf | any MCP-compatible AI
+
+---
+
+## The Problem
+
+- AI assistants read files one at a time — they never see your full project
+- They don't know about existing components, schemas, or patterns
+- You explain your project structure repeatedly in every conversation
+- AI lacks business domain understanding — doesn't know _why_ code exists
+
+## Quick Start
+
+```bash
+pip install codetrellis
+codetrellis scan /path/to/project --optimal
+codetrellis init . --ai   # sets up Copilot/Claude/Cursor integration
+```
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                         CodeTrellis WORKFLOW                           │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│   1. SCAN              2. COMPRESS           3. INJECT          │
+│   ─────────            ───────────           ────────           │
+│                                                                 │
+│   Read every     →    Convert to      →    Add to every        │
+│   file in             minimal              AI prompt            │
+│   project             tokens                                    │
+│                                                                 │
+│   187 lines      →    30 tokens       →    Full awareness      │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Top Features
+
+- **120+ language/framework parsers** — Python, TypeScript, Go, Rust, Java, C#, and more
+- **MCP server** for real-time AI context injection (JSON-RPC 2.0)
+- **JIT context engine** — delivers only relevant sections for the file you're editing
+- **Incremental builds** — only re-extract changed files
+- **Best Practices Library** — 4,500+ practices auto-selected for your stack
+- **Output tiers** — from ~800 tokens (compact) to full code context (logic)
+- **CI/CD mode** — deterministic, parallel builds for pipelines
+- **AI integration** — auto-generates Copilot, Claude, Cursor, Windsurf configs
+
+📋 [Full feature list](docs/FEATURES.md)
+
+## Installation
+
+```bash
+pip install codetrellis
+
+# Optional extras
+pip install codetrellis[all]     # AST parsing, YAML, color, token counting
+pip install codetrellis[ast]     # Tree-sitter AST parsing only
+```
+
+## Output Tiers
+
+| Tier      | Truncation | Tokens      | Use Case                                    |
+| --------- | ---------- | ----------- | ------------------------------------------- |
+| `compact` | Yes        | ~800-2000   | Quick overview                              |
+| `prompt`  | **NO**     | ~8000-15000 | Default AI injection (includes code logic!) |
+| `full`    | **NO**     | ~15000+     | Detailed analysis                           |
+| `logic`   | **NO**     | ~30000+     | Full code context                           |
+| `json`    | **NO**     | Variable    | Machine processing                          |
+
+```bash
+# Use tiers
+codetrellis scan ./project --tier compact   # Minimal
+codetrellis scan ./project --tier prompt    # Default (recommended)
+codetrellis scan ./project --tier full      # Everything
+codetrellis scan ./project --tier logic     # With function bodies
+```
+
+## CLI Commands
+
+```bash
+# Scanning
+codetrellis scan [path]              # Scan project
+codetrellis scan [path] --optimal    # Maximum quality (recommended)
+codetrellis scan [path] --incremental  # Only changed files
+codetrellis scan [path] --ci         # CI/CD mode (deterministic + parallel)
+codetrellis scan --remote <url>      # Scan a remote git repo
+
+# AI Integration
+codetrellis init . --ai              # Generate Copilot/Claude/Cursor configs
+codetrellis init . --update-ai       # Regenerate AI files (no re-scan)
+codetrellis mcp --stdio              # Start MCP server
+codetrellis context path/to/file.py  # JIT context for a file
+codetrellis skills                   # Generate AI-executable skills
+
+# View & Export
+codetrellis show                     # Show full matrix
+codetrellis prompt                   # Print prompt-ready matrix
+codetrellis export --json            # Export as JSON
+
+# Quality & Maintenance
+codetrellis verify [path]            # Build quality gate
+codetrellis validate [path]          # Validate extraction completeness
+codetrellis coverage [path]          # Show extraction coverage
+codetrellis watch                    # Auto-sync on file changes
+codetrellis clean [path]             # Clean caches
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+MIT License — Keshav Chaudhary 2026

codetrellis-1.0.0/codetrellis/__init__.py

@@ -0,0 +1,85 @@
+"""
+CodeTrellis - Project Self-Awareness System
+=====================================
+
+A tool that scans your codebase, compresses it to minimal tokens,
+and injects complete project awareness into every AI prompt.
+
+Created: 31 January 2026
+Author: Keshav Chaudhary
+Version: 1.0.0
+"""
+
+__version__ = "1.0.0"
+__author__ = "Keshav Chaudhary"
+
+# Lazy imports to avoid dependency issues
+def __getattr__(name):
+    if name == "ProjectScanner":
+        from .scanner import ProjectScanner
+        return ProjectScanner
+    elif name == "MatrixCompressor":
+        from .compressor import MatrixCompressor
+        return MatrixCompressor
+    elif name == "FileWatcher":
+        from .watcher import FileWatcher
+        return FileWatcher
+    elif name == "CodeTrellisError":
+        from .errors import CodeTrellisError
+        return CodeTrellisError
+    elif name == "CodeTrellisErrorCode":
+        from .errors import CodeTrellisErrorCode
+        return CodeTrellisErrorCode
+    elif name == "ExtractorResult":
+        from .errors import ExtractorResult
+        return ExtractorResult
+    elif name == "ErrorCollector":
+        from .errors import ErrorCollector
+        return ErrorCollector
+    elif name == "ParallelExtractor":
+        from .parallel import ParallelExtractor
+        return ParallelExtractor
+    elif name == "AsyncParallelExtractor":
+        from .parallel import AsyncParallelExtractor
+        return AsyncParallelExtractor
+    elif name == "ParallelConfig":
+        from .parallel import ParallelConfig
+        return ParallelConfig
+    elif name == "ParallelResult":
+        from .parallel import ParallelResult
+        return ParallelResult
+    elif name == "MatrixBuilder":
+        from .builder import MatrixBuilder
+        return MatrixBuilder
+    elif name == "BuildConfig":
+        from .builder import BuildConfig
+        return BuildConfig
+    elif name == "CacheManager":
+        from .cache import CacheManager
+        return CacheManager
+    elif name == "LockfileManager":
+        from .cache import LockfileManager
+        return LockfileManager
+    elif name == "InputHashCalculator":
+        from .cache import InputHashCalculator
+        return InputHashCalculator
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+__all__ = [
+    "ProjectScanner",
+    "MatrixCompressor",
+    "FileWatcher",
+    "CodeTrellisError",
+    "CodeTrellisErrorCode",
+    "ExtractorResult",
+    "ErrorCollector",
+    "ParallelExtractor",
+    "AsyncParallelExtractor",
+    "ParallelConfig",
+    "ParallelResult",
+    "MatrixBuilder",
+    "BuildConfig",
+    "CacheManager",
+    "LockfileManager",
+    "InputHashCalculator",
+]

codetrellis-1.0.0/codetrellis/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running CodeTrellis as a module: python -m codetrellis."""
+
+from codetrellis.cli import main
+
+if __name__ == "__main__":
+    main()