tree-sitter-analyzer 0.1.2__tar.gz → 0.2.0__tar.gz

tree_sitter_analyzer-0.2.0/CHANGELOG.md

@@ -0,0 +1,97 @@
+# Changelog
+
+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.2.0] - 2025-08-02
+
+### Added
+- **New `--quiet` option** for CLI to suppress INFO-level logging
+- **Enhanced parameter validation** for partial read commands
+- **Improved MCP tool names** for better clarity and AI assistant integration
+- **Comprehensive test coverage** with 1283 passing tests
+- **UV package manager support** for easier environment management
+
+### Changed
+- **BREAKING**: Renamed MCP tool `format_table` to `analyze_code_structure` for better clarity
+- **Improved**: All Japanese comments translated to English for international development
+- **Enhanced**: Test stability with intelligent fallback mechanisms for complex Java parsing
+- **Updated**: Documentation to reflect new tool names and features
+
+### Fixed
+- **Resolved**: Previously skipped complex Java structure analysis test now passes
+- **Fixed**: Robust error handling for environment-dependent parsing scenarios
+- **Improved**: Parameter validation with better error messages
+
+### Technical Improvements
+- **Performance**: Optimized analysis engine with better caching
+- **Reliability**: Enhanced error handling and logging throughout the codebase
+- **Maintainability**: Comprehensive test suite with no skipped tests
+- **Documentation**: Complete English localization of codebase
+
+## [0.1.3] - Previous Release
+
+### Added
+- Initial MCP server implementation
+- Multi-language code analysis support
+- Table formatting capabilities
+- Partial file reading functionality
+
+### Features
+- Java, JavaScript, Python language support
+- Tree-sitter based parsing
+- CLI and MCP interfaces
+- Extensible plugin architecture
+
+---
+
+## Migration Guide
+
+### From 0.1.x to 0.2.0
+
+#### MCP Tool Name Changes
+If you're using the MCP server, update your tool calls:
+
+**Before:**
+```json
+{
+  "tool": "format_table",
+  "arguments": { ... }
+}
+```
+
+**After:**
+```json
+{
+  "tool": "analyze_code_structure", 
+  "arguments": { ... }
+}
+```
+
+#### New CLI Options
+Take advantage of the new `--quiet` option for cleaner output:
+
+```bash
+# New quiet mode
+tree-sitter-analyzer file.java --structure --quiet
+
+# Enhanced parameter validation
+tree-sitter-analyzer file.java --partial-read --start-line 1 --end-line 10
+```
+
+#### UV Support
+You can now use UV for package management:
+
+```bash
+# Install with UV
+uv add tree-sitter-analyzer
+
+# Run with UV
+uv run tree-sitter-analyzer file.java --structure
+```
+
+---
+
+For more details, see the [README](README.md) and [documentation](docs/).

tree_sitter_analyzer-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,98 @@
+# Contributing to Tree-sitter Analyzer
+
+We welcome contributions! This guide will help you get started.
+
+## 🚀 Quick Start for Contributors
+
+### Development Setup
+
+```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 setup
+uv run python -c "import tree_sitter_analyzer; print('Setup OK')"
+```
+
+### Running Tests
+
+```bash
+# Run all tests (1283+ tests)
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=tree_sitter_analyzer
+
+# Run specific test file
+pytest tests/test_mcp_tools.py -v
+
+# Run tests for specific functionality
+pytest tests/test_quiet_option.py -v
+pytest tests/test_partial_read_command_validation.py -v
+```
+
+## 🛠️ Development Workflow
+
+1. **Create a feature branch**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. **Make your changes**
+   - Follow existing code style
+   - Add tests for new functionality
+   - Update documentation if needed
+
+3. **Test your changes**
+   ```bash
+   pytest tests/ -v
+   uv run python -m tree_sitter_analyzer examples/Sample.java --advanced
+   ```
+
+4. **Submit a pull request**
+   - Describe your changes clearly
+   - Include test results
+   - Reference any related issues
+
+## 📝 Code Style
+
+- Follow PEP 8 for Python code
+- Use type hints where appropriate
+- Write clear docstrings
+- Keep functions focused and small
+
+## 🐛 Reporting Issues
+
+- Use GitHub Issues
+- Include error messages and stack traces
+- Provide sample code files when possible
+- Specify your Python version and OS
+
+## 💡 Feature Requests
+
+- Open a GitHub Issue with the "enhancement" label
+- Describe the use case clearly
+- Explain how it would benefit users
+
+## 🧪 Testing Guidelines
+
+- Write tests for new features
+- Ensure existing tests pass (1283+ tests should pass)
+- Test with multiple programming languages
+- Test both CLI and MCP functionality
+- Test error handling and edge cases
+- Include tests for new CLI options (like --quiet)
+- Test MCP tool functionality and parameter validation
+- Follow the existing test patterns in the codebase
+
+## 📚 Documentation
+
+- Update README.md for user-facing changes
+- Add docstrings to new functions/classes
+- Update MCP setup guides if needed
+
+Thank you for contributing! 🎉

tree_sitter_analyzer-0.2.0/MCP_SETUP_DEVELOPERS.md

@@ -0,0 +1,181 @@
+# 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
+
+Add this configuration to your Claude Desktop config file:
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer-dev": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--directory",
+        "/absolute/path/to/tree-sitter-analyzer",
+        "python",
+        "-m",
+        "tree_sitter_analyzer.mcp.server"
+      ]
+    }
+  }
+}
+```
+
+**Important:** Replace `/absolute/path/to/tree-sitter-analyzer` with your actual project path.
+
+### 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
+```
+
+### 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.2.0/MCP_SETUP_USERS.md

@@ -0,0 +1,163 @@
+# MCP Setup Guide for Users
+
+**Simple setup for using Tree-sitter Analyzer with Claude Desktop**
+
+## Prerequisites
+
+- Claude Desktop installed
+- Basic command line knowledge
+
+## Step 1: Install uv (Package Manager)
+
+uv is a fast Python package manager that handles everything automatically.
+
+### Windows
+```powershell
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+### macOS/Linux
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+### Verify Installation
+```bash
+uv --version
+```
+
+## Step 2: Configure Claude Desktop
+
+### Find Your Config File
+
+**Windows:**
+```
+%APPDATA%\Claude\claude_desktop_config.json
+```
+
+**macOS:**
+```
+~/Library/Application Support/Claude/claude_desktop_config.json
+```
+
+**Linux:**
+```
+~/.config/claude/claude_desktop_config.json
+```
+
+### Add Configuration
+
+Open the config file and add this configuration:
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer": {
+      "command": "uv",
+      "args": [
+        "run", 
+        "--with", 
+        "tree-sitter-analyzer[mcp]",
+        "python", 
+        "-m", 
+        "tree_sitter_analyzer.mcp.server"
+      ]
+    }
+  }
+}
+```
+
+## Step 3: Restart Claude Desktop
+
+Close and restart Claude Desktop completely.
+
+## Step 4: Test the Setup
+
+In Claude Desktop, try asking:
+
+### Basic Usage Examples
+
+**Check code scale:**
+> "What's the overall complexity and size of examples/Sample.java?"
+
+**Analyze code structure:**
+> "Please analyze the structure of examples/Sample.java and show me a detailed table"
+
+**Extract specific code:**
+> "Show me lines 84-86 from examples/Sample.java"
+
+**Universal analysis:**
+> "Analyze this code file with automatic language detection"
+
+You should see the tree-sitter-analyzer tools being used automatically.
+
+## Available Tools
+
+Once configured, you'll have access to these tools:
+
+1. **analyze_code_scale** - Get code metrics and complexity
+   ```json
+   {
+     "tool": "analyze_code_scale",
+     "arguments": {
+       "file_path": "examples/Sample.java",
+       "include_complexity": true,
+       "include_details": true
+     }
+   }
+   ```
+
+2. **analyze_code_structure** - Generate detailed structure tables
+   ```json
+   {
+     "tool": "analyze_code_structure",
+     "arguments": {
+       "file_path": "examples/Sample.java",
+       "format_type": "full"
+     }
+   }
+   ```
+
+3. **read_code_partial** - Extract specific line ranges
+   ```json
+   {
+     "tool": "read_code_partial",
+     "arguments": {
+       "file_path": "examples/Sample.java",
+       "start_line": 84,
+       "end_line": 86
+     }
+   }
+   ```
+
+4. **analyze_code_universal** - Universal analysis with auto-detection
+   ```json
+   {
+     "tool": "analyze_code_universal",
+     "arguments": {
+       "file_path": "examples/Sample.py",
+       "analysis_type": "comprehensive"
+     }
+   }
+   ```
+
+## Troubleshooting
+
+### Tool Not Available
+- Restart Claude Desktop completely
+- Check config file syntax with a JSON validator
+- Verify uv is installed: `uv --version`
+
+### Permission Issues
+- On Windows: Run as administrator
+- On macOS/Linux: Check file permissions
+
+### Still Having Issues?
+- Check Claude Desktop logs
+- Test manual installation: `uv run --with "tree-sitter-analyzer[mcp]" python -c "import tree_sitter_analyzer; print('OK')"`
+
+## Need Help?
+
+- [GitHub Issues](https://github.com/aimasteracc/tree-sitter-analyzer/issues)
+- [Developer Setup Guide](MCP_SETUP_DEVELOPERS.md) - For local development
+