tree-sitter-analyzer 1.9.3__tar.gz → 1.9.4__tar.gz

tree_sitter_analyzer-1.9.4/.roo/rules/search-best-practices.md

@@ -0,0 +1,250 @@
+# Tree-Sitter Analyzer: Search Content Best Practices
+
+## Token-Efficient Search Strategies
+
+### 📋 Overview
+The `search_content` tool offers multiple output formats optimized for different token usage scenarios. Understanding the efficiency hierarchy is crucial for effective LLM usage.
+
+### 🎯 Recommended Workflow (Most Efficient Approach)
+
+#### Stage 1: Count Validation (~10 tokens)
+```json
+{
+  "query": "function",
+  "roots": ["src/"],
+  "total_only": true
+}
+```
+**Use when:** You need to quickly check if matches exist or validate query effectiveness.
+**Result:** Single integer (e.g., `42`)
+
+#### Stage 2: File Distribution Analysis (~50-200 tokens)
+```json
+{
+  "query": "function", 
+  "roots": ["src/"],
+  "count_only_matches": true
+}
+```
+**Use when:** You need to understand match distribution across files.
+**Result:** Object with file-level counts
+
+#### Stage 3: Initial Investigation (~500-2000 tokens)
+```json
+{
+  "query": "function",
+  "roots": ["src/"],
+  "summary_only": true
+}
+```
+**Use when:** You need sample matches and overview for pattern validation.
+**Result:** Condensed summary with top files and sample matches
+
+#### Stage 4: Context-Aware Review (~2000-10000 tokens)
+```json
+{
+  "query": "function",
+  "roots": ["src/"], 
+  "group_by_file": true
+}
+```
+**Use when:** You need organized results for detailed analysis.
+**Result:** Matches grouped by file, eliminating path duplication
+
+#### Stage 5: Full Detail Analysis (~2000-50000+ tokens)
+```json
+{
+  "query": "function",
+  "roots": ["src/"]
+}
+```
+**Use when:** You need complete match details for specific content review.
+**Result:** Full match results with all context
+
+### 💡 Token Efficiency Comparison
+
+| Format | Token Range | Best Use Case | Priority |
+|--------|------------|---------------|----------|
+| `total_only` | ~10 tokens | Count validation, existence checks | 🥇 Highest |
+| `count_only_matches` | ~50-200 tokens | File distribution analysis | 🥈 High |
+| `summary_only` | ~500-2000 tokens | Initial investigation, scope confirmation | 🥉 Medium |
+| `group_by_file` | ~2000-10000 tokens | Context-aware detailed review | 🔸 Low |
+| `optimize_paths` | 10-30% reduction | Path compression for deep structures | 🔹 Enhancement |
+| Full results | ~2000-50000+ tokens | Complete content analysis | 🔻 Last resort |
+
+### ⚠️ Output Format Selection Guidelines
+
+#### Mutually Exclusive Parameters
+Only ONE of these can be `true` at a time:
+- `total_only`
+- `count_only_matches`
+- `summary_only`
+- `group_by_file`
+- `optimize_paths`
+
+#### Common Combinations That Cause Errors
+```json
+// ❌ WRONG: Multiple output formats
+{
+  "query": "test",
+  "roots": ["src/"],
+  "total_only": true,
+  "summary_only": true
+}
+
+// ✅ CORRECT: Single output format
+{
+  "query": "test", 
+  "roots": ["src/"],
+  "total_only": true
+}
+```
+
+### 🚨 Common Mistakes and Solutions
+
+#### Mistake 1: Starting with Full Results
+**Problem:** Requesting full results without understanding scope
+```json
+// ❌ Inefficient - could return 50000+ tokens
+{
+  "query": "function",
+  "roots": ["."]
+}
+```
+
+**Solution:** Start with count validation
+```json
+// ✅ Efficient - 10 tokens to check scope
+{
+  "query": "function",
+  "roots": ["."],
+  "total_only": true
+}
+```
+
+#### Mistake 2: Combining Incompatible Parameters
+**Problem:** Using multiple output format parameters
+```json
+// ❌ Will cause validation error
+{
+  "query": "test",
+  "roots": ["src/"],
+  "count_only_matches": true,
+  "group_by_file": true
+}
+```
+
+**Solution:** Choose the most appropriate single format
+```json
+// ✅ For file distribution analysis
+{
+  "query": "test",
+  "roots": ["src/"],
+  "count_only_matches": true
+}
+
+// ✅ For detailed grouped results  
+{
+  "query": "test",
+  "roots": ["src/"],
+  "group_by_file": true
+}
+```
+
+#### Mistake 3: Ignoring Token Limits
+**Problem:** Requesting detailed results in large codebases without bounds
+**Solution:** Use progressive disclosure:
+1. `total_only` to check if results are manageable
+2. `summary_only` if count is reasonable (< 1000 matches)
+3. `group_by_file` if summary looks useful
+4. Full results only for specific, targeted analysis
+
+### 📊 Advanced Optimization Strategies
+
+#### Path Optimization for Deep Directories
+```json
+{
+  "query": "component",
+  "roots": ["frontend/src/components/"],
+  "optimize_paths": true
+}
+```
+**Use when:** Working with deeply nested directory structures to reduce path token overhead.
+
+#### Context-Aware Searching
+```json
+{
+  "query": "TODO",
+  "roots": ["src/"],
+  "context_before": 2,
+  "context_after": 1,
+  "summary_only": true
+}
+```
+**Use when:** You need surrounding context but want to limit token usage.
+
+#### Targeted File Type Searches
+```json
+{
+  "query": "class.*Component",
+  "roots": ["src/"],
+  "include_globs": ["*.tsx", "*.jsx"],
+  "count_only_matches": true
+}
+```
+**Use when:** Searching specific file types to reduce noise and improve efficiency.
+
+### 🔄 Progressive Disclosure Pattern
+
+For unknown codebases or queries, follow this pattern:
+
+1. **Discovery:** `total_only=true` (10 tokens)
+2. **Distribution:** `count_only_matches=true` (50-200 tokens)  
+3. **Sampling:** `summary_only=true` (500-2000 tokens)
+4. **Detailed Review:** `group_by_file=true` (2000-10000 tokens)
+5. **Full Analysis:** Default format (2000-50000+ tokens)
+
+This approach ensures you never accidentally consume excessive tokens while still getting the information you need.
+
+### 🎲 Example Scenarios
+
+#### Scenario 1: Bug Investigation
+```bash
+# Step 1: Check if error pattern exists
+total_only=true → 15 matches found
+
+# Step 2: See which files are affected  
+count_only_matches=true → errors in 3 files
+
+# Step 3: Get sample of error patterns
+summary_only=true → shows typical error patterns
+
+# Step 4: Detailed review of specific files
+group_by_file=true → organized view of all errors
+```
+
+#### Scenario 2: Code Review
+```bash
+# Step 1: Count TODO comments
+total_only=true → 47 TODOs found
+
+# Step 2: Distribution across files
+count_only_matches=true → TODOs spread across 12 files
+
+# Step 3: Sample of TODO types
+summary_only=true → shows priority levels and types
+```
+
+#### Scenario 3: Refactoring Planning
+```bash
+# Step 1: Find usage of deprecated function
+total_only=true → 156 usages found
+
+# Step 2: Check file distribution
+count_only_matches=true → used in 23 files
+
+# Step 3: See usage patterns
+summary_only=true → shows common usage patterns
+
+# Step 4: Full analysis for refactoring
+group_by_file=true → detailed view for systematic refactoring

{tree_sitter_analyzer-1.9.3 → tree_sitter_analyzer-1.9.4}/CHANGELOG.md

@@ -1,20 +1,70 @@
 # Changelog
 
+## [1.9.4] - 2025-11-05
+
+### 🚀 機能改善
+- **GitFlowリリースプロセス自動化**: v1.9.3からv1.9.4への自動バージョンアップデート
+- **カスタムクエリAPI対応**: `analyze_file()`および`execute_query()`でカスタムクエリ実行をサポート
+  - `AnalysisEngine.analyze_file()`に`queries`パラメータを追加
+  - `QueryExecutor`に`execute_query_with_language_name()`メソッドを追加し、明示的な言語名指定をサポート
+  - クエリ結果のグループ化機能（`_group_captures_by_main_node()`）を追加
+  - メソッド・クラス・関数など主要ノードごとにキャプチャを自動グループ化
+  - 影響: ユーザー定義クエリがAPIを通じて実行可能に、より柔軟なコード解析が実現
+
+### 🔧 修正
+- **Javaアノテーションクエリ修正**: `method_with_annotations`クエリがアノテーション付きメソッドを正しくマッチするように修正
+  - 問題: クエリパターン `(modifiers (annotation) @annotation)*` が複数の`modifiers`ノードを探していた
+  - 修正: `(modifiers [(annotation) (marker_annotation)]+ @annotation)` に変更し、単一の`modifiers`ノード内の複数アノテーションをマッチ
+  - 影響: `@Override`、`@Test`、`@SuppressWarnings`などのアノテーション付きメソッドが正しく抽出可能に
+  - テスト: 5つのユニットテストが全て合格、手動検証でも動作確認済み
+
+### 📚 ドキュメント
+- **バージョン同期**: README.md、README_zh.md、README_ja.mdのバージョン情報を統一
+- **多言語サポート**: 全言語版ドキュメントでv1.9.4バージョン情報を更新
+
+### 🧪 品質保証
+- **アノテーションクエリテストスイート**: Javaアノテーションクエリの包括的テストを実装
+  - 単一マーカーアノテーション（`@Override`）のテスト
+  - パラメータ付きアノテーション（`@SuppressWarnings("unchecked")`）のテスト
+  - 複数アノテーションのテスト
+  - アノテーション付き/なしメソッドの混在テスト
+  - キャプチャタイプ構造の検証テスト
+  - 全5テストが合格、既存APIテスト（9テスト）も全て合格
+- **テストスイート**: 3,396個のテストが全て合格
+- **継続的品質**: 既存機能への影響なしを確認済み
+- **クロスプラットフォーム**: Windows、macOS、Linuxでの完全な互換性
+
 ## [1.9.3] - 2025-11-03
 
 ### 🚀 機能改善
 - **GitFlowリリースプロセス自動化**: v1.9.2からv1.9.3への自動バージョンアップデート
-- **文書同期**: 全READMEファイルのバージョンバッジを1.9.3に更新
-- **品質保証**: 3370個のテストによる包括的な品質検証
+- **プロジェクト管理フレームワーク**: 包括的なプロジェクト管理システムの確立
+- **コード品質基準**: Rooルールシステムとコーディングチェックリストの実装
+- **多言語ドキュメントシステム**: 日本語プロジェクト文書の大幅拡充
+
+### 🔧 修正
+- **HTMLエレメント重複問題**: HTML要素の重複検出とJava正規表現パターンの修正
+- **JavaScriptクエリ互換性**: class_expression互換性問題の解決
+- **テスト環境対応**: Javaプラグインのテスト環境適応性向上
+- **エンコーディング処理**: 自動エンコーディング検出機能の実装
 
 ### 📚 ドキュメント
+- **日本語文書システム**: プロジェクト管理とテスト管理文書の実装との整合
+- **多言語サポート**: 日本語ドキュメントシステムの大幅拡張
+- **品質基準文書**: 包括的なコード品質基準とベストプラクティスの策定
 - **バージョン同期**: README.md、README_zh.md、README_ja.mdのバージョン情報を統一
-- **リリースプロセス**: GitFlow自動化による安全なリリース管理
 
 ### 🧪 品質保証
 - **テストスイート**: 3370個のテストが全て合格
+- **型安全性**: mypyエラー317個から0個への100%削減達成
 - **継続的品質**: 既存機能への影響なしを確認済み
-- **PyPI準備**: 自動発布プロセスの準備完了
+- **クロスプラットフォーム**: Windows、macOS、Linuxでの完全な互換性
+
+### 🛠️ 技術改善
+- **ファイル読み取り最適化**: パフォーマンスとメモリ効率の向上
+- **エンコーディングサポート**: UTF-8エンコーディング処理の包括的強化
+- **セキュリティ強化**: ファイルパス検証とセキュリティバリデーションの改善
+- **開発環境最適化**: pre-commitフック最適化とRuffエラー修正
 
 ## [1.9.2] - 2025-10-16
 
@@ -667,6 +717,156 @@ This minor release introduces the game-changing suppress_output feature that sol
 
 This minor release introduces complete TypeScript support, providing developers with powerful TypeScript code analysis capabilities while maintaining full backward compatibility.
 
+## [1.6.1.4] - 2025-10-29
+
+### Added
+- **🚀 Streaming File Reading Performance Enhancement**: Revolutionary file reading optimization for large files
+  - **Streaming Approach**: Implemented streaming approach in `read_file_partial` to handle large files without loading entire content into memory
+  - **Performance Improvement**: Dramatically reduced read times from 30 seconds to under 200ms for large files
+  - **Memory Efficiency**: Significantly reduced memory usage through line-by-line reading approach
+  - **Context Manager**: Introduced `read_file_safe_streaming` context manager for efficient file operations
+  - **Automatic Encoding Detection**: Enhanced encoding detection with streaming support
+
+### Enhanced
+- **📊 MCP Tools Performance**: Enhanced `extract_code_section` tool performance through optimized file reading
+- **🔧 File Handler Optimization**: Refactored file handling with improved streaming capabilities
+- **🧪 Comprehensive Testing**: Added extensive test coverage for performance improvements and memory usage validation
+  - **Performance Tests**: `test_streaming_read_performance.py` with 163 comprehensive tests
+  - **Extended Tests**: `test_streaming_read_performance_extended.py` with 232 additional tests
+- **📚 Documentation**: Added comprehensive design documentation and specifications for streaming performance
+
+### Technical Details
+- **Files Enhanced**:
+  - `tree_sitter_analyzer/file_handler.py` - Refactored with streaming capabilities
+  - `tree_sitter_analyzer/encoding_utils.py` - Enhanced with streaming support
+- **New Test Files**:
+  - `tests/test_streaming_read_performance.py` - Core performance validation
+  - `tests/test_streaming_read_performance_extended.py` - Extended performance testing
+- **Documentation Added**:
+  - Design specifications and proposals for streaming performance optimization
+  - MCP tools specifications with performance considerations
+- **Quality Metrics**: All 1980 tests passing with comprehensive validation
+- **Backward Compatibility**: 100% backward compatibility maintained with existing function signatures and behavior
+
+### Impact
+This release delivers significant performance improvements for large file handling while maintaining full backward compatibility. The streaming approach makes the tool more suitable for enterprise-scale codebases and improves user experience when working with large files.
+
+**Key Benefits:**
+- 🚀 **150x Performance Improvement**: Large file reading optimized from 30s to <200ms
+- 💾 **Memory Efficiency**: Reduced memory footprint through streaming approach
+- ✅ **Zero Breaking Changes**: Full backward compatibility maintained
+- 🏢 **Enterprise Ready**: Enhanced scalability for large codebases
+- 🧪 **Quality Assurance**: Comprehensive test coverage with 395 new performance tests
+
+---
+
+## [1.6.1.3] - 2025-10-27
+
+### Added
+- **🎯 LLM Guidance Enhancement**: Revolutionary token-efficient search guidance for search_content MCP tool
+  - **Token Efficiency Guide**: Comprehensive guidance in tool description with visual markers (📊・📉・⚡・🎯)
+  - **Progressive Workflow**: Step-by-step efficiency guidance (total_only → summary_only → detailed)
+  - **Token Cost Comparison**: Clear token estimates and efficiency rankings for each output format
+  - **Parameter Optimization**: Enhanced parameter descriptions with efficiency markers and recommendations
+  - **Mutually Exclusive Warning**: Clear guidance on parameter combinations to prevent conflicts
+
+- **🌐 Multilingual Error Messages**: Enhanced error handling with automatic language detection
+  - **Language Detection**: Automatic English/Japanese error message selection
+  - **Efficiency Guidance**: Error messages include token efficiency recommendations
+  - **Usage Examples**: Comprehensive usage examples in error messages
+  - **Visual Formatting**: Emoji-based formatting for enhanced readability
+
+- **🧪 Comprehensive Testing**: Enhanced test coverage for LLM guidance features
+  - **LLM Guidance Tests**: 10 new tests validating tool definition structure and guidance completeness
+  - **Description Quality Tests**: 11 new tests ensuring description quality and actionability
+  - **Multilingual Tests**: 9 new tests for multilingual error message functionality
+  - **Integration Tests**: Enhanced existing tests with multilingual error validation
+
+- **📚 Documentation & Best Practices**: Comprehensive guidance documentation
+  - **Token-Efficient Strategies**: New README section with progressive disclosure patterns
+  - **Best Practices Guide**: Created `.roo/rules/search-best-practices.md` with comprehensive usage patterns
+  - **MCP Design Updates**: Enhanced MCP tools design documentation with LLM guidance considerations
+  - **User Setup Guides**: Updated MCP setup documentation with efficiency recommendations
+
+### Enhanced
+- **🔧 Tool Definition Quality**:
+  - Description size optimized to ~252 tokens (efficient yet comprehensive)
+  - Visual formatting with Unicode markers for enhanced LLM comprehension
+  - Structured sections with clear hierarchy and actionable guidance
+  - Comprehensive parameter descriptions with usage scenarios
+
+- **🧪 Quality Assurance**:
+  - OpenSpec validation successful with strict compliance
+  - All 44 tests passing with comprehensive coverage
+  - Backward compatibility maintained for all existing functionality
+  - Performance impact negligible (<5ms overhead)
+
+### Technical Details
+- **Files Enhanced**: `search_content_tool.py`, `output_format_validator.py`
+- **New Test Files**: `test_llm_guidance_compliance.py`, `test_search_content_description.py`
+- **Documentation Updates**: README.md, MCP design docs, user setup guides
+- **Quality Metrics**: Zero breaking changes, full backward compatibility
+- **OpenSpec Compliance**: Strict validation passed for change specification
+
+### Impact
+This release transforms the search_content tool into a **self-teaching, token-efficient interface** that automatically guides LLMs toward optimal usage patterns. Users no longer need extensive Roo rules to achieve efficient search workflows - the tool itself provides comprehensive guidance for token optimization and proper usage patterns.
+
+**Key Benefits:**
+- 🎯 **Automatic LLM Guidance**: Tools teach proper usage without external documentation
+- 🎯 **Token Efficiency**: Progressive disclosure reduces token consumption by up to 99%
+- 🌐 **International Support**: Multilingual error messages enhance global accessibility
+- 🏢 **Quality Assurance**: Enterprise-grade testing and validation
+- ✅ **Zero Breaking Changes**: Full backward compatibility maintained
+
+This implementation serves as a model for future MCP tool enhancements, demonstrating how tools can be self-documenting and LLM-optimized while maintaining professional quality standards.
+
+---
+
+## [1.6.1.2] - 2025-10-19
+
+### Fixed
+- **🔧 Minor Release Update**: Incremental release based on v1.6.1.1 with updated version information
+  - **Version Synchronization**: Updated all version references from 1.6.1.1 to 1.6.1.2
+  - **Documentation Update**: Refreshed README badges and version information
+  - **Quality Metrics**: Maintained 1893 comprehensive tests with enterprise-grade quality assurance
+  - **Backward Compatibility**: Full compatibility maintained with all existing functionality
+
+### Technical Details
+- **Files Modified**: Updated `pyproject.toml`, `tree_sitter_analyzer/__init__.py`, and documentation
+- **Test Coverage**: All 1893 tests passing with comprehensive validation
+- **Quality Metrics**: Maintained high code quality standards
+- **Breaking Changes**: None - all improvements are backward compatible
+
+This release provides an incremental update to v1.6.1.1 with refreshed version information while maintaining full backward compatibility and enterprise-grade quality standards.
+
+---
+
+## [1.6.1.1] - 2025-10-18
+
+### Fixed
+- **🔧 Logging Control Enhancement**: Enhanced logging control functionality for better debugging and monitoring
+  - **Comprehensive Test Framework**: Added extensive test cases for logging control across all levels (DEBUG, INFO, WARNING, ERROR)
+  - **Backward Compatibility**: Maintained full compatibility with CLI and MCP interfaces
+  - **Integration Testing**: Added comprehensive integration tests for logging variables and performance impact
+  - **Test Automation**: Implemented robust test automation scripts and result templates
+
+### Added
+- **🧪 Test Infrastructure**: Complete test framework for v1.6.1.1 validation
+  - **68 Test Files**: Comprehensive test coverage across all functionality
+  - **Logging Control Tests**: Full coverage of logging level controls and file output
+  - **Performance Testing**: Added performance impact validation for logging operations
+  - **Automation Scripts**: Test execution and result analysis automation
+
+### Technical Details
+- **Files Modified**: Enhanced `utils.py` with improved logging functionality
+- **Test Coverage**: 68 test files ensuring comprehensive validation
+- **Quality Metrics**: Maintained high code quality standards
+- **Breaking Changes**: None - all improvements are backward compatible
+
+This hotfix release addresses logging control requirements identified in v1.6.1 and establishes a robust testing framework for future development while maintaining full backward compatibility.
+
+---
+
 ## [1.6.0] - 2025-10-06
 
 ### Added

{tree_sitter_analyzer-1.9.3 → tree_sitter_analyzer-1.9.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.9.3
+Version: 1.9.4
 Summary: AI-era enterprise-grade code analysis tool with comprehensive HTML/CSS support, dynamic plugin architecture, and MCP integration
 Project-URL: Homepage, https://github.com/aimasteracc/tree-sitter-analyzer
 Project-URL: Documentation, https://github.com/aimasteracc/tree-sitter-analyzer#readme
@@ -199,11 +199,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-3370%20passed-brightgreen.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-3396%20passed-brightgreen.svg)](#quality-assurance)
 [![Coverage](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer/branch/main/graph/badge.svg)](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer)
 [![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-1.9.3-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.9.4-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/aimasteracc/tree-sitter-analyzer)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
@@ -255,7 +255,7 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 **Note:** Currently, only the above 7 languages have complete plugin implementations. Languages such as C/C++, Rust, Go, JSON are defined in `LanguageDetector` but do not have functional plugin implementations at this time.
 
 ### 🏆 Production Ready
-- **3,370 Tests** - 100% pass rate, enterprise-grade quality assurance
+- **3,396 Tests** - 100% pass rate, enterprise-grade quality assurance
 - **High Coverage** - Comprehensive test coverage
 - **Cross-platform Support** - Compatible with Windows, macOS, Linux
 - **Continuous Maintenance** - Active development and community support
@@ -336,7 +336,10 @@ rg --version
       "args": [
         "run", "--with", "tree-sitter-analyzer[mcp]",
         "python", "-m", "tree_sitter_analyzer.mcp.server"
-      ]
+      ],
+      "env": {
+        "TREE_SITTER_OUTPUT_PATH": "/absolute/path/to/output/directory"
+      }
     }
   }
 }
@@ -890,20 +893,19 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **3,370 tests** - 100% pass rate ✅
+- **3,396 tests** - 100% pass rate ✅
 - **High code coverage** - Comprehensive test suite
 - **Zero test failures** - Production ready
 - **Cross-platform support** - Windows, macOS, Linux
 
-### ⚡ Latest Quality Achievements (v1.8.3)
-- ✅ **🔒 CLI Security Enhancement** - Fixed CLI mode security boundary errors, ensuring file access security
-- ✅ **✅ Argument Validation Improvement** - Implemented complete CLI argument validation system, preventing invalid parameter combinations
-- ✅ **🚫 Exclusive Parameter Control** - `--table` and `--query-key` parameters properly implement exclusive control
-- ✅ **🔍 Enhanced Filter Functionality** - `--query-key` with `--filter` combination usage fully supported
-- ✅ **⚠️ Error Message Optimization** - Provides clear and detailed error information, improving user experience
-- ✅ **🛡️ Project Boundary Protection** - Automatically detects and respects project boundaries, preventing access to sensitive files
-- ✅ **🧪 Test Environment Support** - Temporary directory access permission in test environments
-- ✅ **📋 User Experience Improvement** - More intuitive command-line interface and error handling mechanisms
+### ⚡ Latest Quality Achievements (v1.9.3)
+- ✅ **🎯 Complete Type Safety Achievement** - Reduced mypy errors from 317 to 0, achieving 100% type safety
+- ✅ **🔧 HTML Element Duplication Fix** - Resolved HTML element duplicate detection and Java regex pattern issues
+- ✅ **🧪 Complete Test Suite Success** - All 3,370 tests passing with zero failure rate
+- ✅ **📚 Multilingual Documentation System** - Significant expansion and refinement of Japanese project documentation
+- ✅ **🔄 Parallel Processing Engine Maintained** - search_content supports multi-directory parallel search with up to 4x performance boost
+- ✅ **�️ Enhanced Encoding Processing** - Implementation of automatic encoding detection and UTF-8 processing optimization
+- ✅ **🏗️ Project Management Framework** - Comprehensive project management system including Roo rules and coding checklist
 
 
 ### ⚙️ Running Tests
@@ -941,9 +943,9 @@ The project maintains high-quality test coverage. For detailed module coverage i
 **Verification environment:**
 - Operating systems: Windows 10, macOS, Linux
 - Python version: 3.10+
-- Project version: tree-sitter-analyzer v1.8.2
+- Project version: tree-sitter-analyzer v1.9.3
 - Test files: BigService.java (1419 lines), sample.py (256 lines), MultiClass.java (54 lines)
-- New verification: CLI argument validation, security boundary protection, exclusive parameter control
+- Latest verification: Parallel processing engine, type safety improvements, code style unification
 
 ---
 

{tree_sitter_analyzer-1.9.3 → tree_sitter_analyzer-1.9.4}/README.md

@@ -4,11 +4,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-3370%20passed-brightgreen.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-3396%20passed-brightgreen.svg)](#quality-assurance)
 [![Coverage](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer/branch/main/graph/badge.svg)](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer)
 [![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-1.9.3-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.9.4-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/aimasteracc/tree-sitter-analyzer)
 [![GitHub Stars](https://img.shields.io/github/stars/aimasteracc/tree-sitter-analyzer.svg?style=social)](https://github.com/aimasteracc/tree-sitter-analyzer)
 
@@ -60,7 +60,7 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 **Note:** Currently, only the above 7 languages have complete plugin implementations. Languages such as C/C++, Rust, Go, JSON are defined in `LanguageDetector` but do not have functional plugin implementations at this time.
 
 ### 🏆 Production Ready
-- **3,370 Tests** - 100% pass rate, enterprise-grade quality assurance
+- **3,396 Tests** - 100% pass rate, enterprise-grade quality assurance
 - **High Coverage** - Comprehensive test coverage
 - **Cross-platform Support** - Compatible with Windows, macOS, Linux
 - **Continuous Maintenance** - Active development and community support
@@ -141,7 +141,10 @@ rg --version
       "args": [
         "run", "--with", "tree-sitter-analyzer[mcp]",
         "python", "-m", "tree_sitter_analyzer.mcp.server"
-      ]
+      ],
+      "env": {
+        "TREE_SITTER_OUTPUT_PATH": "/absolute/path/to/output/directory"
+      }
     }
   }
 }
@@ -695,20 +698,19 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **3,370 tests** - 100% pass rate ✅
+- **3,396 tests** - 100% pass rate ✅
 - **High code coverage** - Comprehensive test suite
 - **Zero test failures** - Production ready
 - **Cross-platform support** - Windows, macOS, Linux
 
-### ⚡ Latest Quality Achievements (v1.8.3)
-- ✅ **🔒 CLI Security Enhancement** - Fixed CLI mode security boundary errors, ensuring file access security
-- ✅ **✅ Argument Validation Improvement** - Implemented complete CLI argument validation system, preventing invalid parameter combinations
-- ✅ **🚫 Exclusive Parameter Control** - `--table` and `--query-key` parameters properly implement exclusive control
-- ✅ **🔍 Enhanced Filter Functionality** - `--query-key` with `--filter` combination usage fully supported
-- ✅ **⚠️ Error Message Optimization** - Provides clear and detailed error information, improving user experience
-- ✅ **🛡️ Project Boundary Protection** - Automatically detects and respects project boundaries, preventing access to sensitive files
-- ✅ **🧪 Test Environment Support** - Temporary directory access permission in test environments
-- ✅ **📋 User Experience Improvement** - More intuitive command-line interface and error handling mechanisms
+### ⚡ Latest Quality Achievements (v1.9.3)
+- ✅ **🎯 Complete Type Safety Achievement** - Reduced mypy errors from 317 to 0, achieving 100% type safety
+- ✅ **🔧 HTML Element Duplication Fix** - Resolved HTML element duplicate detection and Java regex pattern issues
+- ✅ **🧪 Complete Test Suite Success** - All 3,370 tests passing with zero failure rate
+- ✅ **📚 Multilingual Documentation System** - Significant expansion and refinement of Japanese project documentation
+- ✅ **🔄 Parallel Processing Engine Maintained** - search_content supports multi-directory parallel search with up to 4x performance boost
+- ✅ **�️ Enhanced Encoding Processing** - Implementation of automatic encoding detection and UTF-8 processing optimization
+- ✅ **🏗️ Project Management Framework** - Comprehensive project management system including Roo rules and coding checklist
 
 
 ### ⚙️ Running Tests
@@ -746,9 +748,9 @@ The project maintains high-quality test coverage. For detailed module coverage i
 **Verification environment:**
 - Operating systems: Windows 10, macOS, Linux
 - Python version: 3.10+
-- Project version: tree-sitter-analyzer v1.8.2
+- Project version: tree-sitter-analyzer v1.9.3
 - Test files: BigService.java (1419 lines), sample.py (256 lines), MultiClass.java (54 lines)
-- New verification: CLI argument validation, security boundary protection, exclusive parameter control
+- Latest verification: Parallel processing engine, type safety improvements, code style unification
 
 ---