intentgraph 0.1.0__tar.gz

intentgraph-0.1.0/.gitignore

@@ -0,0 +1,210 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Directories
+Agentic_*/
+.claude/
+.github/
+.ruff_cache
+
+# 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
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.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
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.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 specific template is maintained in a separate JetBrains.gitignore that can
+#  be added to the global gitignore or merged into this project gitignore.  For a PyCharm
+#  project, it is not recommended to check the version control system any of the
+#  following directories/files:
+#  .idea/
+#  .idea/workspace.xml
+#  .idea/tasks.xml
+#  .idea/dictionaries
+#  .idea/vcs.xml
+#  .idea/jsLibraryMappings.xml
+
+# VS Code
+.vscode/
+
+# MacOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Linux
+*~
+
+# IDE
+.idea/
+*.swp
+*.swo
+
+# IntentGraph specific
+.intentgraph_cache/
+*.intentgraph
+
+# Performance profiling
+*.prof
+profile.html
+profile.json
+
+# Security
+.secrets
+*.key
+*.pem
+
+# Test artifacts
+test_output.json
+perf_test.json
+large_repo/
+sample_repo/

intentgraph-0.1.0/LICENSE

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

intentgraph-0.1.0/NOTICE

@@ -0,0 +1,10 @@
+NOTICE
+
+This project includes the following third-party components:
+
+pathspec (>=0.12.0)
+Copyright (c) 2013-2024 pathspec contributors
+Licensed under Mozilla Public License 2.0
+Source: https://github.com/cpburnz/python-pathspec
+
+For full license text, see: https://mozilla.org/MPL/2.0/

intentgraph-0.1.0/PKG-INFO

@@ -0,0 +1,406 @@
+Metadata-Version: 2.4
+Name: intentgraph
+Version: 0.1.0
+Summary: A best-in-class repository dependency analyzer
+Project-URL: Documentation, https://github.com/yourusername/intentgraph
+Project-URL: Issues, https://github.com/yourusername/intentgraph/issues
+Project-URL: Source, https://github.com/yourusername/intentgraph
+Author-email: IntentGraph Team <intentgraph-security@example.com>
+License: MIT
+License-File: LICENSE
+License-File: NOTICE
+Keywords: analysis,code,dependency,graph,repository
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.12
+Requires-Dist: anyio>=4.2.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: gitpython>=3.1.40
+Requires-Dist: grimp>=3.3.0
+Requires-Dist: networkx>=3.2.0
+Requires-Dist: orjson>=3.9.0
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tree-sitter-language-pack>=0.8.0
+Requires-Dist: tree-sitter>=0.23.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7.5; extra == 'dev'
+Requires-Dist: diagrams>=0.23.0; extra == 'dev'
+Requires-Dist: hypothesis>=6.92.0; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pyinstrument>=4.6.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# IntentGraph 🧠
+
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code Style: Ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+**AI-Ready Codebase Intelligence** - Transform any codebase into rich, queryable intelligence for AI coding agents and developer tools.
+
+## 🎯 **Why IntentGraph?**
+
+AI coding agents are everywhere, but they're **flying blind** through codebases:
+- ❌ Constantly scanning files to understand structure
+- ❌ Missing function-level relationships
+- ❌ No semantic understanding of code purpose
+- ❌ Reinventing analysis on every interaction
+
+**IntentGraph solves this** by providing comprehensive codebase intelligence upfront.
+
+## ✨ **What Makes It Special**
+
+### **🔍 Deep Code Analysis**
+```json
+{
+  "symbols": [
+    {
+      "name": "LanguageParser", 
+      "symbol_type": "class",
+      "signature": "class LanguageParser(ABC)",
+      "docstring": "Abstract base class for language-specific parsers.",
+      "is_exported": true,
+      "line_start": 10,
+      "line_end": 45
+    }
+  ],
+  "function_dependencies": [
+    {
+      "from_symbol": "analyze",
+      "to_symbol": "build_graph", 
+      "dependency_type": "calls",
+      "line_number": 127
+    }
+  ],
+  "file_purpose": "parsing",
+  "design_patterns": ["adapter", "parser"],
+  "complexity_score": 4,
+  "maintainability_index": 82.5
+}
+```
+
+### **🧠 AI Agent Intelligence**
+- **Function-level dependency tracking** - Know exactly what calls what
+- **API surface mapping** - Clear public interfaces vs internal implementation  
+- **Semantic analysis** - File purposes, design patterns, key abstractions
+- **Code quality metrics** - Complexity scores, maintainability indices
+- **Rich metadata** - Signatures, docstrings, decorators, line numbers
+
+### **⚡ Developer Productivity**
+- **Smart refactoring** - Understand impact before changing code
+- **Architecture compliance** - Detect and enforce design patterns
+- **Code review automation** - Flag complex/unmaintainable code
+- **Onboarding acceleration** - Quickly understand large codebases
+
+## 🚀 **Quick Start**
+
+### **Installation**
+```bash
+pip install intentgraph
+```
+
+### **Basic Usage**
+```bash
+# Analyze current directory
+intentgraph .
+
+# Generate detailed report
+intentgraph . --output analysis.json
+
+# Focus on specific languages
+intentgraph . --lang py,js,ts
+```
+
+### **Sample Output**
+```bash
+[2025-01-15 10:30:14] INFO     Found 42 source files                              
+[2025-01-15 10:30:18] INFO     Analysis complete!                                  
+
+     Analysis Summary     
+┏━━━━━━━━━━━━━━━━┳━━━━━━━┓
+┃ Metric         ┃ Value ┃
+┡━━━━━━━━━━━━━━━━╇━━━━━━━┩
+│ Files analyzed │ 42    │
+│ Functions      │ 156   │
+│ Classes        │ 28    │
+│ Dependencies   │ 89    │
+│ Avg Complexity │ 3.2   │
+└────────────────┴───────┘
+```
+
+## 🎯 **Perfect For**
+
+### **🤖 AI Coding Agents**
+```python
+# Instead of scanning files repeatedly
+agent.scan_codebase()  # Slow, incomplete
+
+# Use IntentGraph intelligence
+analysis = load_intentgraph_report("analysis.json")
+agent.understand_codebase(analysis)  # Fast, comprehensive
+```
+
+### **🔧 Developer Tools**
+- **IDE Extensions** - Smart navigation and completion
+- **Code Review Tools** - Automated quality assessment  
+- **Documentation Generators** - Extract API surfaces
+- **Refactoring Tools** - Safe transformation guidance
+
+### **📊 Engineering Management**
+- **Technical Debt Assessment** - Quantify code quality
+- **Architecture Compliance** - Monitor design patterns
+- **Developer Onboarding** - Codebase understanding maps
+- **Legacy Modernization** - Identify improvement opportunities
+
+## 📖 **Comprehensive Example**
+
+### **Input: Your Codebase**
+```
+my-project/
+├── src/
+│   ├── models.py      # Data structures
+│   ├── parser.py      # Text processing  
+│   └── api.py         # Web interface
+└── tests/
+    └── test_models.py
+```
+
+### **Output: Rich Intelligence**
+```json
+{
+  "files": [
+    {
+      "path": "src/models.py",
+      "symbols": [
+        {
+          "name": "User",
+          "symbol_type": "class", 
+          "signature": "class User(BaseModel)",
+          "exports": ["User"],
+          "complexity_score": 2
+        }
+      ],
+      "file_purpose": "data_models",
+      "key_abstractions": ["User", "Profile"],
+      "design_patterns": ["model"]
+    },
+    {
+      "path": "src/api.py",
+      "function_dependencies": [
+        {
+          "from_symbol": "create_user",
+          "to_symbol": "User.__init__",
+          "dependency_type": "instantiates",
+          "line_number": 45
+        }
+      ],
+      "file_purpose": "web_interface", 
+      "complexity_score": 8
+    }
+  ]
+}
+```
+
+### **What AI Agents Get**
+- **"To modify User model, check impact on api.py:45 create_user function"**
+- **"This file follows the Model pattern with 2 complexity score"**
+- **"Public API exports: User, Profile classes"**
+- **"Dependencies: User model is instantiated in API layer"**
+
+## 🏗️ **Architecture**
+
+IntentGraph follows **Clean Architecture** principles:
+
+```
+┌─────────────────┐
+│   CLI Layer     │  ← Command-line interface
+├─────────────────┤
+│ Application     │  ← Analysis orchestration  
+├─────────────────┤
+│   Domain        │  ← Core models & logic
+├─────────────────┤
+│ Infrastructure  │  ← Parsers & adapters
+└─────────────────┘
+```
+
+### **Key Components**
+- **Enhanced Parsers** - Deep AST analysis for each language
+- **Semantic Analyzer** - Pattern detection and purpose inference
+- **Dependency Tracker** - Function-level relationship mapping
+- **Quality Calculator** - Complexity and maintainability metrics
+
+## 🌐 **Language Support**
+
+| Language   | Status | Features |
+|------------|--------|----------|
+| **Python** | ✅ Full | Functions, classes, decorators, complexity |
+| JavaScript | 🚧 Basic | File dependencies only |
+| TypeScript | 🚧 Basic | File dependencies only |
+| Go | 🚧 Basic | File dependencies only |
+
+**Coming Soon:** Enhanced analysis for JavaScript, TypeScript, Go, Rust, Java
+
+## ⚙️ **Configuration**
+
+### **Command Line Options**
+```bash
+intentgraph [OPTIONS] REPOSITORY_PATH
+
+Options:
+  -o, --output FILE           Output file (- for stdout) [default: stdout]
+  --lang TEXT                 Languages to analyze [default: auto-detect]
+  --include-tests            Include test files in analysis
+  --format [pretty|compact]  JSON output format [default: pretty]
+  --show-cycles              Print dependency cycles and exit with code 2
+  --workers INTEGER          Parallel workers [default: CPU count]
+  --debug                    Enable debug logging
+```
+
+### **Programmatic Usage**
+```python
+from intentgraph import RepositoryAnalyzer
+
+analyzer = RepositoryAnalyzer(
+    language_filter=['python'],
+    include_tests=False,
+    workers=4
+)
+
+result = analyzer.analyze('/path/to/repo')
+print(f"Found {len(result.files)} files")
+print(f"Total complexity: {sum(f.complexity_score for f in result.files)}")
+```
+
+## 🔧 **Development**
+
+### **Setup**
+```bash
+git clone https://github.com/Raytracer76/intentgraph.git
+cd intentgraph
+python -m venv .venv
+source .venv/bin/activate  # or .venv\\Scripts\\activate on Windows
+pip install -e ".[dev]"
+```
+
+### **Testing**
+```bash
+pytest --cov=intentgraph --cov-report=term-missing
+```
+
+### **Code Quality**
+```bash
+ruff format .           # Format code
+ruff check --fix .      # Lint and auto-fix
+mypy .                  # Type checking
+```
+
+## 🤝 **Contributing**
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+### **Adding Language Support**
+1. Create parser in `src/intentgraph/adapters/parsers/`
+2. Implement `extract_code_structure()` method
+3. Add tests and examples
+4. Submit PR with documentation
+
+### **Ideas for Contributions**
+- **Enhanced JavaScript/TypeScript parser** 
+- **Go/Rust language support**
+- **Visual dependency graph generator**
+- **VS Code extension**
+- **Performance optimizations**
+- **ML-based pattern detection**
+
+## 📊 **Benchmarks**
+
+| Repository Size | Files | Analysis Time | Output Size |
+|----------------|-------|---------------|-------------|
+| Small (< 50 files) | 42 | 2.3s | 180KB |
+| Medium (< 500 files) | 287 | 12.1s | 2.1MB |
+| Large (< 2000 files) | 1,654 | 45.7s | 18.3MB |
+
+*Benchmarks on MacBook Pro M2, Python 3.12*
+
+## 🎯 **Use Cases**
+
+### **For AI Agents**
+```python
+# Cursor, Claude Code, GitHub Copilot, etc.
+analysis = intentgraph.analyze(repo_path)
+
+# Now AI knows:
+# - Which functions call which (no file scanning)
+# - Public APIs vs internal implementation  
+# - Code complexity and quality metrics
+# - Architectural patterns and purposes
+```
+
+### **For Developer Tools**
+```python
+# Code review automation
+high_complexity = [f for f in analysis.files if f.complexity_score > 10]
+
+# Architecture compliance  
+missing_patterns = find_files_without_patterns(analysis, required=['adapter'])
+
+# Refactoring safety
+impact = find_function_dependencies(analysis, target_function="process_data")
+```
+
+### **For Documentation**
+```python
+# Auto-generate API docs
+public_apis = [e for f in analysis.files for e in f.exports if not e.name.startswith('_')]
+
+# Architecture diagrams
+dependency_graph = build_graph(analysis.function_dependencies)
+```
+
+## 🏆 **Why Choose IntentGraph**
+
+| Feature | IntentGraph | GitHub Dependency Graph | SonarQube | Tree-sitter |
+|---------|-------------|-------------------------|-----------|-------------|
+| **Function-level deps** | ✅ | ❌ | ❌ | ❌ |
+| **Semantic analysis** | ✅ | ❌ | ❌ | ❌ |
+| **AI-optimized output** | ✅ | ❌ | ❌ | ❌ |
+| **Multi-language unified** | ✅ | ✅ | ✅ | ❌ |
+| **Quality metrics** | ✅ | ❌ | ✅ | ❌ |
+| **Design patterns** | ✅ | ❌ | ❌ | ❌ |
+
+## 📄 **License**
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🙏 **Acknowledgments**
+
+- Built with [Typer](https://typer.tiangolo.com/) for CLI
+- Uses [grimp](https://github.com/seddonym/grimp) for Python dependency analysis  
+- Powered by Python's [ast](https://docs.python.org/3/library/ast.html) module for code parsing
+- Graph operations via [NetworkX](https://networkx.org/)
+
+## 📞 **Support**
+
+- **GitHub Issues** - Bug reports and feature requests
+- **Discussions** - Questions and community chat
+- **Documentation** - Comprehensive guides and examples
+
+---
+
+**Made with ❤️ for the AI coding agent era**
+
+*Transform your codebase into intelligence. Your future AI assistant will thank you.* 🤖✨