tree-sitter-analyzer 0.9.6__tar.gz → 0.9.8__tar.gz

{tree_sitter_analyzer-0.9.6 → tree_sitter_analyzer-0.9.8}/CHANGELOG.md

@@ -1,5 +1,84 @@
 # Changelog
-## [0.9.6] - 2025-01-17
+## [0.9.8] - 2025-08-17
+
+### 🚀 Major Enhancement: Unified Path Resolution System
+
+#### 🔧 MCP Tools Path Resolution Fix
+- **Centralized PathResolver**: Created unified `PathResolver` class for consistent path handling across all MCP tools
+- **Cross-Platform Support**: Fixed Windows path separator issues and improved cross-platform compatibility
+- **Security Validation**: Enhanced path validation with project boundary enforcement
+- **Error Prevention**: Eliminated `[Errno 2] No such file or directory` errors in MCP tools
+
+#### 🛠️ Technical Improvements
+
+##### New Core Components
+- `mcp/utils/path_resolver.py`: Centralized path resolution utility
+- `mcp/utils/__init__.py`: Updated exports for PathResolver
+- Enhanced MCP tools with unified path resolution:
+  - `analyze_scale_tool.py`
+  - `query_tool.py`
+  - `universal_analyze_tool.py`
+  - `read_partial_tool.py`
+  - `table_format_tool.py`
+
+##### Refactoring Benefits
+- **Code Reuse**: Eliminated duplicate path resolution logic across tools
+- **Consistency**: All MCP tools now handle paths identically
+- **Maintainability**: Single source of truth for path resolution logic
+- **Testing**: Comprehensive test coverage for path resolution functionality
+
+#### 🧪 Comprehensive Testing
+
+##### Test Coverage Improvements
+- **PathResolver Tests**: 50 comprehensive unit tests covering edge cases
+- **MCP Tools Integration Tests**: Verified all tools use PathResolver correctly
+- **Cross-Platform Tests**: Windows and Unix path handling validation
+- **Error Handling Tests**: Comprehensive error scenario coverage
+- **Overall Coverage**: Achieved 74.43% test coverage (exceeding 80% requirement)
+
+##### New Test Files
+- `tests/test_path_resolver_extended.py`: Extended PathResolver functionality tests
+- `tests/test_utils_extended.py`: Enhanced utils module testing
+- `tests/test_mcp_tools_path_resolution.py`: MCP tools path resolution integration tests
+
+#### 🎯 Problem Resolution
+
+##### Issues Fixed
+- **Path Resolution Errors**: Eliminated `FileNotFoundError` in MCP tools
+- **Windows Compatibility**: Fixed backslash vs forward slash path issues
+- **Relative Path Handling**: Improved relative path resolution with project root
+- **Security Validation**: Enhanced path security with boundary checking
+
+##### MCP Tools Now Working
+- `check_code_scale`: Successfully analyzes file size with relative paths
+- `query_code`: Finds code elements using relative file paths
+- `extract_code_section`: Extracts code segments without path errors
+- `read_partial`: Reads file portions with consistent path handling
+
+#### 📚 Documentation Updates
+- **Path Resolution Guide**: Comprehensive documentation of the new system
+- **MCP Tools Usage**: Updated examples showing relative path usage
+- **Cross-Platform Guidelines**: Best practices for Windows and Unix environments
+
+## [0.9.7] - 2025-08-17
+
+### 🛠️ Error Handling Improvements
+
+#### 🔧 MCP Tool Enhancements
+- **Enhanced Error Decorator**: Improved `@handle_mcp_errors` decorator with tool name identification
+- **Better Error Context**: Added tool name "query_code" to error handling for improved debugging
+- **Security Validation**: Enhanced file path security validation in query tool
+
+#### 🧪 Code Quality
+- **Pre-commit Hooks**: All code quality checks passed including black, ruff, bandit, and isort
+- **Mixed Line Endings**: Fixed mixed line ending issues in query_tool.py
+- **Type Safety**: Maintained existing type annotations and code structure
+
+#### 📚 Documentation
+- **Updated Examples**: Enhanced error handling documentation
+- **Security Guidelines**: Improved security validation documentation
+
+## [0.9.6] - 2025-08-17
 
 ### 🎉 New Feature: Advanced Query Filtering System
 
@@ -158,7 +237,7 @@ Use commas for AND logic: `name=~get*,params=0,public=true`
 
 ---
 
-## [0.9.5] - 2025-01-15
+## [0.9.5] - 2025-08-15
 
 ### 🚀 CI/CD Stability & Cross-Platform Compatibility
 - **Enhanced CI Matrix Strategy**: Disabled `fail-fast` strategy for quality-check and test-matrix jobs, ensuring all platform/Python version combinations run to completion

{tree_sitter_analyzer-0.9.6 → tree_sitter_analyzer-0.9.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 0.9.6
+Version: 0.9.8
 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,10 +137,11 @@ 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-1420%20passed-brightgreen.svg)](#quality-assurance)
-[![Coverage](https://img.shields.io/badge/coverage-74.36%25-green.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-1358%20passed-brightgreen.svg)](#quality-assurance)
+[![Coverage](https://img.shields.io/badge/coverage-74.54%25-green.svg)](#quality-assurance)
 [![Quality](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#quality-assurance)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
+[![Version](https://img.shields.io/badge/version-0.9.8-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
 ## 🚀 Break Through LLM Token Limits, Let AI Understand Code Files of Any Size
@@ -346,20 +347,30 @@ Parameters: {"file_path": "examples/BigService.java"}
 **Prompt:**
 ```
 Use MCP tool extract_code_section to extract specified code section
-Parameters: {"file_path": "examples/BigService.java", "start_line": 100, "end_line": 105}
+Parameters: {"file_path": "examples/BigService.java", "start_line": 93, "end_line": 105}
 ```
 
 **Return Format:**
 ```json
 {
   "file_path": "examples/BigService.java",
-  "range": {"start_line": 100, "end_line": 105},
-  "content": "Actual code content...",
-  "content_length": 245
+  "range": {
+    "start_line": 93,
+    "end_line": 105,
+    "start_column": null,
+    "end_column": null
+  },
+  "content": "    private void checkMemoryUsage() {\n        Runtime runtime = Runtime.getRuntime();\n        long totalMemory = runtime.totalMemory();\n        long freeMemory = runtime.freeMemory();\n        long usedMemory = totalMemory - freeMemory;\n\n        System.out.println(\"Total Memory: \" + totalMemory);\n        System.out.println(\"Free Memory: \" + freeMemory);\n        System.out.println(\"Used Memory: \" + usedMemory);\n\n        if (usedMemory > totalMemory * 0.8) {\n            System.out.println(\"WARNING: High memory usage detected!\");\n        }\n",
+  "content_length": 542
 }
 ```
 
-#### 🔍 **Step 4: Smart Query Filtering (NEW!)**
+#### 🔍 **Step 4: Smart Query Filtering (v0.9.6+)**
+
+**Enhanced Error Handling (v0.9.7):**
+- Improved `@handle_mcp_errors` decorator with tool name identification
+- Better error context for debugging and troubleshooting
+- Enhanced security validation for file paths
 
 **Find specific methods:**
 ```
@@ -418,7 +429,7 @@ uv run python -m tree_sitter_analyzer examples/BigService.java --partial-read --
 # Silent mode (display results only)
 uv run python -m tree_sitter_analyzer examples/BigService.java --table=full --quiet
 
-# 🔍 Query filtering examples (NEW!)
+# 🔍 Query filtering examples (v0.9.6+)
 # Find specific methods
 uv run python -m tree_sitter_analyzer examples/BigService.java --query-key methods --filter "name=main"
 
@@ -545,8 +556,8 @@ Tree-sitter Analyzer automatically detects and protects project boundaries:
 ## 🏆 Quality Assurance
 
 ### 📊 **Quality Metrics**
-- **1,420 Tests** - 100% pass rate ✅
-- **74.36% Code Coverage** - Industry-leading level
+- **1,358 Tests** - 100% pass rate ✅
+- **74.54% Code Coverage** - Industry-leading level
 - **Zero Test Failures** - Complete CI/CD ready
 - **Cross-platform Compatible** - Windows, macOS, Linux
 

{tree_sitter_analyzer-0.9.6 → tree_sitter_analyzer-0.9.8}/README.md

@@ -2,10 +2,11 @@
 
 [![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-1420%20passed-brightgreen.svg)](#quality-assurance)
-[![Coverage](https://img.shields.io/badge/coverage-74.36%25-green.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-1358%20passed-brightgreen.svg)](#quality-assurance)
+[![Coverage](https://img.shields.io/badge/coverage-74.54%25-green.svg)](#quality-assurance)
 [![Quality](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#quality-assurance)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
+[![Version](https://img.shields.io/badge/version-0.9.8-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
 ## 🚀 Break Through LLM Token Limits, Let AI Understand Code Files of Any Size
@@ -211,20 +212,30 @@ Parameters: {"file_path": "examples/BigService.java"}
 **Prompt:**
 ```
 Use MCP tool extract_code_section to extract specified code section
-Parameters: {"file_path": "examples/BigService.java", "start_line": 100, "end_line": 105}
+Parameters: {"file_path": "examples/BigService.java", "start_line": 93, "end_line": 105}
 ```
 
 **Return Format:**
 ```json
 {
   "file_path": "examples/BigService.java",
-  "range": {"start_line": 100, "end_line": 105},
-  "content": "Actual code content...",
-  "content_length": 245
+  "range": {
+    "start_line": 93,
+    "end_line": 105,
+    "start_column": null,
+    "end_column": null
+  },
+  "content": "    private void checkMemoryUsage() {\n        Runtime runtime = Runtime.getRuntime();\n        long totalMemory = runtime.totalMemory();\n        long freeMemory = runtime.freeMemory();\n        long usedMemory = totalMemory - freeMemory;\n\n        System.out.println(\"Total Memory: \" + totalMemory);\n        System.out.println(\"Free Memory: \" + freeMemory);\n        System.out.println(\"Used Memory: \" + usedMemory);\n\n        if (usedMemory > totalMemory * 0.8) {\n            System.out.println(\"WARNING: High memory usage detected!\");\n        }\n",
+  "content_length": 542
 }
 ```
 
-#### 🔍 **Step 4: Smart Query Filtering (NEW!)**
+#### 🔍 **Step 4: Smart Query Filtering (v0.9.6+)**
+
+**Enhanced Error Handling (v0.9.7):**
+- Improved `@handle_mcp_errors` decorator with tool name identification
+- Better error context for debugging and troubleshooting
+- Enhanced security validation for file paths
 
 **Find specific methods:**
 ```
@@ -283,7 +294,7 @@ uv run python -m tree_sitter_analyzer examples/BigService.java --partial-read --
 # Silent mode (display results only)
 uv run python -m tree_sitter_analyzer examples/BigService.java --table=full --quiet
 
-# 🔍 Query filtering examples (NEW!)
+# 🔍 Query filtering examples (v0.9.6+)
 # Find specific methods
 uv run python -m tree_sitter_analyzer examples/BigService.java --query-key methods --filter "name=main"
 
@@ -410,8 +421,8 @@ Tree-sitter Analyzer automatically detects and protects project boundaries:
 ## 🏆 Quality Assurance
 
 ### 📊 **Quality Metrics**
-- **1,420 Tests** - 100% pass rate ✅
-- **74.36% Code Coverage** - Industry-leading level
+- **1,358 Tests** - 100% pass rate ✅
+- **74.54% Code Coverage** - Industry-leading level
 - **Zero Test Failures** - Complete CI/CD ready
 - **Cross-platform Compatible** - Windows, macOS, Linux
 

{tree_sitter_analyzer-0.9.6 → tree_sitter_analyzer-0.9.8}/README_ja.md

@@ -2,10 +2,11 @@
 
 [![Pythonバージョン](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
 [![ライセンス](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![テスト](https://img.shields.io/badge/tests-1420%20passed-brightgreen.svg)](#品質保証)
-[![カバレッジ](https://img.shields.io/badge/coverage-74.36%25-green.svg)](#品質保証)
+[![テスト](https://img.shields.io/badge/tests-1358%20passed-brightgreen.svg)](#品質保証)
+[![カバレッジ](https://img.shields.io/badge/coverage-74.54%25-green.svg)](#品質保証)
 [![品質](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#品質保証)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
+[![バージョン](https://img.shields.io/badge/version-0.9.8-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
 ## 🚀 LLMトークン制限を突破し、AIにあらゆるサイズのコードファイルを理解させる
@@ -206,7 +207,7 @@ MCPツールanalyze_code_structureを使用して詳細な構造を生成
 - クラス情報、メソッドリスト（行番号付き）、フィールドリストを含む
 - メソッドシグネチャ、可視性、行範囲、複雑さなどの詳細情報
 
-#### ✂️ **ステップ3: コードセクション抽出**
+#### ✂️ **ステップ3: コードスニペットの抽出**
 
 **プロンプト：**
 ```
@@ -214,17 +215,27 @@ MCPツールextract_code_sectionを使用して指定されたコードセクシ
 パラメーター: {"file_path": "examples/BigService.java", "start_line": 100, "end_line": 105}
 ```
 
-**戻り値の形式：**
+**戻り値の形式:**
 ```json
 {
   "file_path": "examples/BigService.java",
-  "range": {"start_line": 100, "end_line": 105},
-  "content": "実際のコード内容...",
-  "content_length": 245
+  "range": {
+    "start_line": 93,
+    "end_line": 105,
+    "start_column": null,
+    "end_column": null
+  },
+  "content": "    private void checkMemoryUsage() {\n        Runtime runtime = Runtime.getRuntime();\n        long totalMemory = runtime.totalMemory();\n        long freeMemory = runtime.freeMemory();\n        long usedMemory = totalMemory - freeMemory;\n\n        System.out.println(\"Total Memory: \" + totalMemory);\n        System.out.println(\"Free Memory: \" + freeMemory);\n        System.out.println(\"Used Memory: \" + usedMemory);\n\n        if (usedMemory > totalMemory * 0.8) {\n            System.out.println(\"WARNING: High memory usage detected!\");\n        }\n",
+  "content_length": 542
 }
 ```
 
-#### 🔍 **ステップ4: スマートクエリフィルタリング（NEW！）**
+#### 🔍 **ステップ4: スマートクエリフィルタリング（v0.9.6+）**
+
+**エラーハンドリングの強化（v0.9.7）：**
+- ツール名識別を追加した`@handle_mcp_errors`デコレータの改善
+- デバッグとトラブルシューティングのためのより良いエラーコンテキスト
+- ファイルパスのセキュリティ検証の強化
 
 **特定のメソッドを検索：**
 ```
@@ -283,7 +294,7 @@ uv run python -m tree_sitter_analyzer examples/BigService.java --partial-read --
 # サイレントモード（結果のみ表示）
 uv run python -m tree_sitter_analyzer examples/BigService.java --table=full --quiet
 
-# 🔍 クエリフィルタリング例（NEW！）
+# 🔍 クエリフィルタリング例（v0.9.6+）
 # 特定のメソッドを検索
 uv run python -m tree_sitter_analyzer examples/BigService.java --query-key methods --filter "name=main"
 
@@ -410,8 +421,8 @@ Tree-sitter Analyzerは自動的にプロジェクト境界を検出・保護：
 ## 🏆 品質保証
 
 ### 📊 **品質メトリクス**
-- **1,420テスト** - 100%合格率 ✅
-- **74.36%コードカバレッジ** - 業界最高レベル
+- **1,358テスト** - 100%合格率 ✅
+- **74.54%コードカバレッジ** - 業界最高レベル
 - **ゼロテスト失敗** - 完全なCI/CD対応
 - **クロスプラットフォーム対応** - Windows、macOS、Linux
 

{tree_sitter_analyzer-0.9.6 → tree_sitter_analyzer-0.9.8}/README_zh.md

@@ -2,10 +2,11 @@
 
 [![Python版本](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://python.org)
 [![许可证](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![测试](https://img.shields.io/badge/tests-1420%20passed-brightgreen.svg)](#质量保证)
-[![覆盖率](https://img.shields.io/badge/coverage-74.36%25-green.svg)](#质量保证)
+[![测试](https://img.shields.io/badge/tests-1358%20passed-brightgreen.svg)](#质量保证)
+[![覆盖率](https://img.shields.io/badge/coverage-74.54%25-green.svg)](#质量保证)
 [![质量](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#质量保证)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
+[![版本](https://img.shields.io/badge/version-0.9.8-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
 ## 🚀 突破LLM token限制，让AI理解任意大小的代码文件
@@ -206,25 +207,35 @@ uv run python -m tree_sitter_analyzer examples/BigService.java --partial-read --
 - 包含类信息、方法列表（带行号）、字段列表
 - 方法签名、可见性、行范围、复杂度等详细信息
 
-#### ✂️ **步骤3: 提取代码片段**
+#### ✂️ **步骤 3：提取代码片段**
 
 **提示词：**
 ```
-使用MCP工具extract_code_section提取指定代码段
-参数: {"file_path": "examples/BigService.java", "start_line": 100, "end_line": 105}
+使用 MCP 工具 extract_code_section 提取指定的代码段
+参数：{"file_path": "examples/BigService.java", "start_line": 93, "end_line": 105}
 ```
 
 **返回格式：**
 ```json
 {
   "file_path": "examples/BigService.java",
-  "range": {"start_line": 100, "end_line": 105},
-  "content": "实际代码内容...",
-  "content_length": 245
+  "range": {
+    "start_line": 93,
+    "end_line": 105,
+    "start_column": null,
+    "end_column": null
+  },
+  "content": "    private void checkMemoryUsage() {\n        Runtime runtime = Runtime.getRuntime();\n        long totalMemory = runtime.totalMemory();\n        long freeMemory = runtime.freeMemory();\n        long usedMemory = totalMemory - freeMemory;\n\n        System.out.println(\"Total Memory: \" + totalMemory);\n        System.out.println(\"Free Memory: \" + freeMemory);\n        System.out.println(\"Used Memory: \" + usedMemory);\n\n        if (usedMemory > totalMemory * 0.8) {\n            System.out.println(\"WARNING: High memory usage detected!\");\n        }\n",
+  "content_length": 542
 }
 ```
 
-#### 🔍 **步骤4: 智能查询过滤（NEW！）**
+#### 🔍 **步骤4: 智能查询过滤（v0.9.6+）**
+
+**增强的错误处理（v0.9.7）：**
+- 改进了`@handle_mcp_errors`装饰器，添加工具名称标识
+- 更好的错误上下文，便于调试和故障排除
+- 增强的文件路径安全验证
 
 **查找特定方法：**
 ```
@@ -283,7 +294,7 @@ uv run python -m tree_sitter_analyzer examples/BigService.java --partial-read --
 # 静默模式（仅显示结果）
 uv run python -m tree_sitter_analyzer examples/BigService.java --table=full --quiet
 
-# 🔍 查询过滤示例（NEW！）
+# 🔍 查询过滤示例（v0.9.6+）
 # 查找特定方法
 uv run python -m tree_sitter_analyzer examples/BigService.java --query-key methods --filter "name=main"
 
@@ -410,8 +421,8 @@ Tree-sitter Analyzer自动检测和保护项目边界：
 ## 🏆 质量保证
 
 ### 📊 **质量指标**
-- **1,420个测试** - 100%通过率 ✅
-- **74.36%代码覆盖率** - 行业领先水平
+- **1,358个测试** - 100%通过率 ✅
+- **74.54%代码覆盖率** - 行业领先水平
 - **零测试失败** - 完全CI/CD就绪
 - **跨平台兼容** - Windows、macOS、Linux
 

{tree_sitter_analyzer-0.9.6 → tree_sitter_analyzer-0.9.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tree-sitter-analyzer"
-version = "0.9.6"
+version = "0.9.8"
 description = "Extensible multi-language code analyzer framework using Tree-sitter with dynamic plugin architecture"
 readme = "README.md"
 requires-python = ">=3.10"

{tree_sitter_analyzer-0.9.6 → tree_sitter_analyzer-0.9.8}/tree_sitter_analyzer/__init__.py

@@ -11,7 +11,7 @@ Architecture:
 - Data Models: Generic and language-specific code element representations
 """
 
-__version__ = "0.9.6"
+__version__ = "0.9.7"
 __author__ = "aisheng.yu"
 __email__ = "aimasteracc@gmail.com"