tree-sitter-analyzer 0.8.0__tar.gz → 0.8.2__tar.gz

{tree_sitter_analyzer-0.8.0 → tree_sitter_analyzer-0.8.2}/CHANGELOG.md

@@ -5,6 +5,81 @@ 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).
 
+## [0.8.2] - 2025-08-05
+
+### 🎯 Major Quality Improvements
+
+#### 🏆 Complete Test Suite Stabilization
+- **Fixed**: All 31 failing tests now pass - achieved **100% test success rate** (1358/1358 tests)
+- **Fixed**: Windows file permission issues in temporary file handling
+- **Fixed**: API signature mismatches in QueryExecutor test calls
+- **Fixed**: Return format inconsistencies in ReadPartialTool tests
+- **Fixed**: Exception type mismatches between error handler and test expectations
+- **Fixed**: SecurityValidator method name discrepancies in component tests
+- **Fixed**: Mock dependency path issues in engine configuration tests
+
+#### 📊 Test Coverage Enhancements
+- **Enhanced**: Formatters module coverage from **0%** to **42.30%** - complete breakthrough
+- **Enhanced**: Error handler coverage from **61.64%** to **82.76%** (+21.12%)
+- **Enhanced**: Overall project coverage from **71.97%** to **74.82%** (+2.85%)
+- **Added**: 104 new comprehensive test cases across critical modules
+- **Added**: Edge case testing for binary files, Unicode content, and large files
+- **Added**: Performance and concurrency testing for core components
+
+#### 🔧 Test Infrastructure Improvements
+- **Improved**: Cross-platform compatibility with proper Windows file handling
+- **Improved**: Systematic error classification and batch fixing methodology
+- **Improved**: Test reliability with proper exception type imports
+- **Improved**: Mock object configuration and dependency injection testing
+- **Improved**: Temporary file lifecycle management across all test scenarios
+
+#### 🧪 New Test Modules
+- **Added**: `test_formatters_comprehensive.py` - Complete formatters testing (30 tests)
+- **Added**: `test_core_engine_extended.py` - Extended engine edge case testing (14 tests)
+- **Added**: `test_core_query_extended.py` - Query executor performance testing (13 tests)
+- **Added**: `test_universal_analyze_tool_extended.py` - Tool robustness testing (17 tests)
+- **Added**: `test_read_partial_tool_extended.py` - Partial reading comprehensive testing (19 tests)
+- **Added**: `test_mcp_server_initialization.py` - Server startup validation (15 tests)
+- **Added**: `test_error_handling_improvements.py` - Error handling verification (20 tests)
+
+### 🚀 Technical Achievements
+- **Achievement**: Zero test failures - complete CI/CD readiness
+- **Achievement**: Comprehensive formatters module testing foundation established
+- **Achievement**: Cross-platform test compatibility ensured
+- **Achievement**: Robust error handling validation implemented
+- **Achievement**: Performance and stress testing coverage added
+
+### 📈 Quality Metrics
+- **Metric**: 1358 total tests (100% pass rate)
+- **Metric**: 74.82% code coverage (industry-standard quality)
+- **Metric**: 6 error categories systematically resolved
+- **Metric**: 5 test files comprehensively updated
+- **Metric**: Zero breaking changes to existing functionality
+
+---
+
+## [0.8.1] - 2025-08-05
+
+### 🔧 Fixed
+- **Fixed**: Eliminated duplicate "ERROR:" prefixes in error messages across all CLI commands
+- **Fixed**: Updated all CLI tests to match unified error message format
+- **Fixed**: Resolved missing `--project-root` parameters in comprehensive CLI tests
+- **Fixed**: Corrected module import issues in language detection tests
+- **Fixed**: Updated test expectations to match security validation behavior
+
+### 🧪 Testing Improvements
+- **Enhanced**: Fixed 6 failing tests in `test_partial_read_command_validation.py`
+- **Enhanced**: Fixed 6 failing tests in `test_cli_comprehensive.py` and Java structure analyzer tests
+- **Enhanced**: Improved test stability and reliability across all CLI functionality
+- **Enhanced**: Unified error message testing with consistent format expectations
+
+### 📦 Code Quality
+- **Improved**: Centralized error message formatting in `output_manager.py`
+- **Improved**: Consistent error handling architecture across all CLI commands
+- **Improved**: Better separation of concerns between error content and formatting
+
+---
+
 ## [0.8.0] - 2025-08-04
 
 ### 🚀 Added

tree_sitter_analyzer-0.8.2/MCP_SETUP_DEVELOPERS.md

@@ -0,0 +1,325 @@
+# MCP Setup Guide for Developers
+
+**Local development setup for Tree-sitter Analyzer MCP server**
+
+## Prerequisites
+
+- Python 3.10+
+- uv package manager
+- Git
+- Claude Desktop (for testing)
+
+## Development Setup
+
+### 1. Clone and Setup Project
+
+```bash
+# Clone the repository
+git clone https://github.com/aimasteracc/tree-sitter-analyzer.git
+cd tree-sitter-analyzer
+
+# Install development dependencies
+uv sync --extra all --extra mcp
+
+# Verify installation
+uv run python -c "import tree_sitter_analyzer; print('Development setup OK')"
+```
+
+### 2. Configure Claude Desktop for Local Development
+
+#### Recommended Development Configuration
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer-dev": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--directory",
+        "/absolute/path/to/tree-sitter-analyzer",
+        "python",
+        "-m",
+        "tree_sitter_analyzer.mcp.server"
+      ],
+      "env": {
+        "TREE_SITTER_PROJECT_ROOT": "${workspaceFolder}"
+      }
+    }
+  }
+}
+```
+
+**Important:** Replace `/absolute/path/to/tree-sitter-analyzer` with your actual project path.
+
+## Project Root Configuration Options
+
+The MCP server supports multiple ways to configure the project root directory for security and functionality:
+
+### Configuration Priority (Highest to Lowest)
+
+1. **Command Line Argument** (Highest Priority)
+2. **Environment Variable** (Medium Priority)
+3. **Auto-Detection** (Lowest Priority)
+
+### Option 1: Environment Variable (Recommended)
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer-dev": {
+      "command": "uv",
+      "args": ["run", "--directory", "/path/to/tree-sitter-analyzer", "python", "-m", "tree_sitter_analyzer.mcp.server"],
+      "env": {
+        "TREE_SITTER_PROJECT_ROOT": "${workspaceFolder}"
+      }
+    }
+  }
+}
+```
+
+**Benefits:**
+- ✅ Automatically adapts to current workspace
+- ✅ Works with any IDE supporting workspace variables
+- ✅ Flexible and dynamic configuration
+
+### Option 2: Command Line Argument
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer-dev": {
+      "command": "uv",
+      "args": [
+        "run", "--directory", "/path/to/tree-sitter-analyzer",
+        "python", "-m", "tree_sitter_analyzer.mcp.server",
+        "--project-root", "/specific/project/path"
+      ]
+    }
+  }
+}
+```
+
+**Use cases:**
+- 🎯 Fixed project path requirements
+- 🎯 Override environment variable settings
+- 🎯 Multi-project environments
+
+### Option 3: Auto-Detection (Zero Configuration)
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer-dev": {
+      "command": "uv",
+      "args": ["run", "--directory", "/path/to/tree-sitter-analyzer", "python", "-m", "tree_sitter_analyzer.mcp.server"]
+    }
+  }
+}
+```
+
+**How it works:**
+- 🔍 Searches for project markers (.git, pyproject.toml, package.json, etc.)
+- 🔍 Traverses up directory tree from server working directory
+- 🔍 Falls back to current working directory if no markers found
+
+**Supported project markers:**
+- Version control: `.git`, `.hg`, `.svn`
+- Python: `pyproject.toml`, `setup.py`, `requirements.txt`
+- JavaScript: `package.json`, `yarn.lock`, `node_modules`
+- Java: `pom.xml`, `build.gradle`, `gradlew`
+- And many more...
+
+## Testing Project Root Configuration
+
+### Test Auto-Detection
+
+```bash
+# Test from project directory
+cd /your/project/directory
+uv run python -m tree_sitter_analyzer.mcp.server --help
+
+# Should show detected project root in logs
+```
+
+### Test Command Line Override
+
+```bash
+# Test explicit project root
+uv run python -m tree_sitter_analyzer.mcp.server --project-root /specific/path --help
+```
+
+### Test Environment Variable
+
+```bash
+# Test environment variable
+export TREE_SITTER_PROJECT_ROOT=/your/project
+uv run python -m tree_sitter_analyzer.mcp.server --help
+```
+
+### Test Priority Handling
+
+```bash
+# Test priority (command line should win)
+export TREE_SITTER_PROJECT_ROOT=/env/path
+uv run python -m tree_sitter_analyzer.mcp.server --project-root /cmd/path --help
+# Should use /cmd/path
+```
+
+## Debugging Project Root Issues
+
+### Check Current Configuration
+
+```bash
+# Run with verbose logging
+uv run python -c "
+from tree_sitter_analyzer.project_detector import detect_project_root
+import logging
+logging.basicConfig(level=logging.INFO)
+result = detect_project_root()
+print(f'Detected project root: {result}')
+"
+```
+
+### Verify Security Boundaries
+
+```bash
+# Test file access validation
+uv run python -c "
+from tree_sitter_analyzer.security import SecurityValidator
+validator = SecurityValidator('/your/project/root')
+is_valid, msg = validator.validate_file_path('/your/project/root/src/file.py')
+print(f'Valid: {is_valid}, Message: {msg}')
+"
+```
+
+### 3. Dual Configuration (Development + Stable)
+
+For testing both versions, use this configuration:
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer-dev": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--directory",
+        "/path/to/your/tree-sitter-analyzer",
+        "python",
+        "-m",
+        "tree_sitter_analyzer.mcp.server"
+      ],
+      "disabled": false
+    },
+    "tree-sitter-analyzer-stable": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--with",
+        "tree-sitter-analyzer[mcp]",
+        "python",
+        "-m",
+        "tree_sitter_analyzer.mcp.server"
+      ],
+      "disabled": true
+    }
+  }
+}
+```
+
+Switch between versions by changing the `disabled` flag.
+
+## Development Workflow
+
+### 1. Make Changes
+```bash
+# Edit code
+vim tree_sitter_analyzer/mcp/tools/analyze_scale_tool.py
+
+# Run tests
+pytest tests/ -v
+
+# Test CLI
+uv run python -m tree_sitter_analyzer examples/Sample.java --advanced --output-format=text
+```
+
+### 2. Test MCP Server
+```bash
+# Test server manually
+uv run python -m tree_sitter_analyzer.mcp.server
+
+# Should show server initialization logs
+```
+
+### 3. Test with Claude Desktop
+- Restart Claude Desktop
+- Test your changes through the AI assistant
+- Check logs for any issues
+
+## Debugging
+
+### Enable Debug Logging
+```bash
+export TREE_SITTER_ANALYZER_LOG_LEVEL=DEBUG
+uv run python -m tree_sitter_analyzer.mcp.server
+```
+
+### Common Issues
+
+**Import Errors:**
+```bash
+# Check dependencies
+uv run python -c "import tree_sitter_analyzer.mcp.server"
+```
+
+**Path Issues:**
+- Use absolute paths in MCP configuration
+- Verify project directory structure
+
+**MCP Protocol Issues:**
+- Check Claude Desktop logs
+- Verify MCP package version: `uv run python -c "import mcp; print(mcp.__version__)"`
+
+## Testing Changes
+
+### Unit Tests
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run specific test
+pytest tests/test_mcp_tools.py -v
+
+# Run with coverage
+pytest tests/ --cov=tree_sitter_analyzer
+```
+
+### Integration Tests
+```bash
+# Test MCP tools
+uv run python -m pytest tests/test_mcp_integration.py -v
+```
+
+### Manual Testing
+```bash
+# Test CLI commands
+uv run python -m tree_sitter_analyzer examples/Sample.java --table=full
+
+# Test partial read
+uv run python -m tree_sitter_analyzer examples/Sample.java --partial-read --start-line 84 --end-line 86
+```
+
+## Contributing
+
+1. Create feature branch
+2. Make changes
+3. Run tests: `pytest tests/ -v`
+4. Test MCP integration
+5. Submit pull request
+
+## Need Help?
+
+- [GitHub Issues](https://github.com/aimasteracc/tree-sitter-analyzer/issues)
+- [User Setup Guide](MCP_SETUP_USERS.md) - For end users
+- [API Documentation](docs/api.md)

{tree_sitter_analyzer-0.8.0 → tree_sitter_analyzer-0.8.2}/MCP_SETUP_USERS.md

@@ -47,7 +47,7 @@ uv --version
 
 ### Add Configuration
 
-Open the config file and add this configuration:
+Open the config file and add this **recommended configuration**:
 
 ```json
 {
@@ -55,18 +55,61 @@ Open the config file and add this configuration:
     "tree-sitter-analyzer": {
       "command": "uv",
       "args": [
-        "run", 
-        "--with", 
+        "run",
+        "--with",
         "tree-sitter-analyzer[mcp]",
-        "python", 
-        "-m", 
+        "python",
+        "-m",
         "tree_sitter_analyzer.mcp.server"
+      ],
+      "env": {
+        "TREE_SITTER_PROJECT_ROOT": "${workspaceFolder}"
+      }
+    }
+  }
+}
+```
+
+> **💡 Why this configuration?**
+> - `${workspaceFolder}` automatically uses your current project directory
+> - Provides secure file access boundaries
+> - Works with any project without manual path changes
+> - Enables intelligent project root detection
+
+## Project Root Configuration
+
+The tree-sitter-analyzer automatically detects your project boundaries for security and functionality. Here's how it works:
+
+### ✅ Recommended: Use the configuration above
+The `${workspaceFolder}` setting automatically adapts to your current project directory. This works for:
+- VS Code workspaces
+- Any IDE that supports workspace variables
+- Most development environments
+
+### 🔧 Alternative: Fixed project path (for specific use cases)
+If you need to analyze files from a specific directory only:
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer": {
+      "command": "uv",
+      "args": [
+        "run", "--with", "tree-sitter-analyzer[mcp]",
+        "python", "-m", "tree_sitter_analyzer.mcp.server",
+        "--project-root", "/absolute/path/to/your/project"
       ]
     }
   }
 }
 ```
 
+### 🎯 What happens with project root?
+- **Security**: Only files within the project directory can be analyzed
+- **Smart detection**: Automatically finds project markers (.git, package.json, pyproject.toml, etc.)
+- **Path resolution**: Resolves relative paths correctly
+- **Performance**: Optimizes analysis for your project structure
+
 ## Step 3: Restart Claude Desktop
 
 Close and restart Claude Desktop completely.

{tree_sitter_analyzer-0.8.0 → tree_sitter_analyzer-0.8.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 0.8.0
+Version: 0.8.2
 Summary: Extensible multi-language code analyzer framework using Tree-sitter with dynamic plugin architecture
 Project-URL: Homepage, https://github.com/aimasteracc/tree-sitter-analyzer
 Project-URL: Documentation, https://github.com/aimasteracc/tree-sitter-analyzer#readme
@@ -137,7 +137,9 @@ Description-Content-Type: text/markdown
 
 [![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-1126%20passed-brightgreen.svg)](#testing)
+[![Tests](https://img.shields.io/badge/tests-1358%20passed-brightgreen.svg)](#testing)
+[![Coverage](https://img.shields.io/badge/coverage-74.82%25-green.svg)](#testing)
+[![Quality](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#quality)
 
 **Solve the LLM token limit problem for large code files.**
 
@@ -306,21 +308,69 @@ uv sync --extra all --extra mcp
 
 - **[MCP Setup Guide for Users](https://github.com/aimasteracc/tree-sitter-analyzer/blob/main/MCP_SETUP_USERS.md)** - Simple setup for AI assistant users
 - **[MCP Setup Guide for Developers](https://github.com/aimasteracc/tree-sitter-analyzer/blob/main/MCP_SETUP_DEVELOPERS.md)** - Local development configuration
+- **[Project Root Configuration](https://github.com/aimasteracc/tree-sitter-analyzer/blob/main/PROJECT_ROOT_CONFIG.md)** - Complete configuration reference
 - **[API Documentation](https://github.com/aimasteracc/tree-sitter-analyzer/blob/main/docs/api.md)** - Detailed API reference
 - **[Contributing Guide](https://github.com/aimasteracc/tree-sitter-analyzer/blob/main/CONTRIBUTING.md)** - How to contribute
 
-## 🧪 Testing
+### 🔒 Project Root Configuration
 
-This project maintains high code quality with **1126 passing tests**.
+Tree-sitter-analyzer automatically detects and secures your project boundaries:
 
+- **Auto-detection**: Finds project root from `.git`, `pyproject.toml`, `package.json`, etc.
+- **CLI**: Use `--project-root /path/to/project` for explicit control
+- **MCP**: Set `TREE_SITTER_PROJECT_ROOT=${workspaceFolder}` for workspace integration
+- **Security**: Only analyzes files within project boundaries
+
+**Recommended MCP configuration:**
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer": {
+      "command": "uv",
+      "args": ["run", "--with", "tree-sitter-analyzer[mcp]", "python", "-m", "tree_sitter_analyzer.mcp.server"],
+      "env": {"TREE_SITTER_PROJECT_ROOT": "${workspaceFolder}"}
+    }
+  }
+}
+```
+
+## 🧪 Testing & Quality
+
+This project maintains **enterprise-grade quality** with comprehensive testing:
+
+### 📊 Quality Metrics
+- **1358 tests** - 100% pass rate ✅
+- **74.82% code coverage** - Industry standard quality
+- **Zero test failures** - Complete CI/CD readiness
+- **Cross-platform compatibility** - Windows, macOS, Linux
+
+### 🏆 Recent Quality Achievements (v0.8.2)
+- ✅ **Complete test suite stabilization** - Fixed all 31 failing tests
+- ✅ **Formatters module breakthrough** - 0% → 42.30% coverage
+- ✅ **Error handling improvements** - 61.64% → 82.76% coverage
+- ✅ **104 new comprehensive tests** across critical modules
+
+### 🔧 Running Tests
 ```bash
-# Run tests
+# Run all tests
 pytest tests/ -v
 
-# Run with coverage
-pytest tests/ --cov=tree_sitter_analyzer
+# Run with coverage report
+pytest tests/ --cov=tree_sitter_analyzer --cov-report=html
+
+# Run specific test categories
+pytest tests/test_formatters_comprehensive.py -v
+pytest tests/test_core_engine_extended.py -v
+pytest tests/test_mcp_server_initialization.py -v
 ```
 
+### 📈 Coverage Highlights
+- **Formatters**: 42.30% (newly established)
+- **Error Handler**: 82.76% (major improvement)
+- **Language Detector**: 98.41% (excellent)
+- **CLI Main**: 97.78% (excellent)
+- **Security Framework**: 78%+ across all modules
+
 ## 📄 License
 
 MIT License - see [LICENSE](LICENSE) file for details.