Phase1: tree sitter dependency extraction for diffgraph

.github/workflows/test.yml

@@ -0,0 +1,39 @@
+name: Tests
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  pytest:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+          cache: pip
+
+      - name: Install test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+          python -m pip install -e . pytest jsonschema
+
+      - name: Require phase-one dependencies
+        run: |
+          python -c "import jsonschema; from diffgraph.processing_modes.tree_sitter_dependency import TreeSitterProcessor"
+
+      - name: Run phase-one acceptance tests
+        run: python -m pytest tests/test_tree_sitter_phase1.py
+
+      - name: Run full test suite
+        run: python -m pytest

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+- **Tree-sitter Dependency Extraction (Phase 1)**: Static AST-based analysis mode
+  - New `tree-sitter-dependency-graph` processing mode
+  - Multi-language support framework for Python, TypeScript, JavaScript, Go, Rust, Java, Swift
+  - Python extraction fully implemented: classes, functions, methods, imports
+  - Component relationship extraction from static analysis
+  - Uses tree-sitter-language-pack for fast, accurate parsing
+  - No AI/API calls required - pure static analysis
+
+### Changed
+- Added `tree-sitter-language-pack>=0.10.0` dependency to setup.py
+- Made tree-sitter processor optional (graceful fallback if not installed)
+
 ## [1.3.0] - 2025-10-28
 
 ### Added
@@ -20,6 +35,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Added `--mode` / `-m` option to select processing mode
   - Added `--list-modes` flag to display available processing modes
   - Default mode: `openai-agents-dependency-graph` (backward compatible)
+- **Graph Export Integration**: Merged graph export features from v1.2.0
+  - `--format` option to export graph data (JSON, pickle, GraphML)
+  - Structured JSON output format optimized for integrations
 - **Documentation**:
   - Added comprehensive developer guide: `docs/ADDING_PROCESSING_MODES.md`
   - Updated README.md with processing modes information

README.md

@@ -104,11 +104,32 @@ Uses OpenAI Agents SDK to analyze code and generate component-level dependency g
 - Analyzes dependencies between components
 - Generates a visual dependency graph showing how components relate to each other
 - Best for understanding architectural changes and component interactions
+- **Requires**: OpenAI API key
+
+#### `tree-sitter-dependency-graph` (NEW in Phase 1)
+Static AST-based dependency extraction using tree-sitter. This mode:
+- Parses source files using tree-sitter for accurate syntax analysis
+- Extracts components (classes, functions, methods) from AST
+- Identifies import statements and function calls
+- Supports multiple programming languages:
+  - **Python** (fully supported)
+  - TypeScript, JavaScript, Go, Rust, Java, Swift (in progress)
+- No API calls required - pure static analysis
+- Fast and deterministic results
+- Best for quick analysis without AI costs
+
+Example usage:
+```bash
+# Use tree-sitter mode for Python analysis
+wild diff --mode tree-sitter-dependency-graph
+
+# Export tree-sitter analysis as JSON
+wild diff --mode tree-sitter-dependency-graph --format graph
+```
 
 ### Future Modes
 
 The architecture is designed to support additional processing modes:
-- **tree-sitter-dependency-graph**: AST-based analysis using Tree-sitter
 - **data-flow-analysis**: Focus on data flow and transformations
 - **user-context-analysis**: Analyze changes from a user interaction perspective
 - **architecture-analysis**: System-level architectural insights

diffgraph/cli.py

@@ -173,6 +173,11 @@ def main(args, api_key: str, output: str, format: str, graph_format: str, no_ope
             debug_environment(api_key)
             return
 
+        if mode not in list_available_modes():
+            click.echo(f"❌ Error: Unknown processing mode: '{mode}'", err=True)
+            click.echo("\nUse --list-modes to see available processing modes.", err=True)
+            sys.exit(1)
+
         if not is_git_repo():
             click.echo("❌ Error: Not a git repository", err=True)
             sys.exit(1)
@@ -193,12 +198,7 @@ def main(args, api_key: str, output: str, format: str, graph_format: str, no_ope
         try:
             # Initialize the processor based on selected mode
             click.echo(f"🤖 Initializing {mode} processor...")
-            try:
-                processor = get_processor(mode, api_key=api_key)
-            except ValueError as e:
-                click.echo(f"❌ Error: {e}", err=True)
-                click.echo("\nUse --list-modes to see available processing modes.", err=True)
-                sys.exit(1)
+            processor = get_processor(mode, api_key=api_key)
 
             # Define progress callback
             def progress_callback(current_file, total_files, status):
@@ -230,10 +230,10 @@ def progress_callback(current_file, total_files, status):
                 click.echo(f"💾 Exporting graph data in {graph_format} format...")
                 if graph_format == 'json':
                     # Use structured format for JSON
-                    graph_path = export_structured_json(agent.graph_manager, output, diff_args)
+                    graph_path = export_structured_json(processor.graph_manager, output, diff_args)
                 else:
                     # Use NetworkX format for pickle/graphml
-                    graph_path = export_graph(agent.graph_manager, output, graph_format)
+                    graph_path = export_graph(processor.graph_manager, output, graph_format)
                 click.echo(f"✅ Graph data exported: {graph_path}")
             else:
                 # Create analysis result

diffgraph/processing_modes/__init__.py

@@ -87,7 +87,18 @@ def list_available_modes() -> Dict[str, str]:
 
 # Import processors to trigger registration
 # This will be populated as we add more processors
-from . import openai_agents_dependency  # noqa: F401, E402
+try:
+    from . import openai_agents_dependency  # noqa: F401, E402
+except ImportError:
+    # openai-agents not installed, skip this processor
+    pass
+
+# Import optional processors
+try:
+    from . import tree_sitter_dependency  # noqa: F401, E402
+except ImportError:
+    # tree-sitter-languages not installed, skip this processor
+    pass
 
 
 __all__ = [