tree-sitter-analyzer 1.8.3__tar.gz → 1.9.0__tar.gz

{tree_sitter_analyzer-1.8.3 → tree_sitter_analyzer-1.9.0}/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## [1.9.0] - 2025-10-16
+
+### 🚀 新機能
+- **並行処理エンジン**: search_content MCPツールで複数ディレクトリの並行検索対応
+- **パフォーマンス向上**: 最大4倍の検索速度向上
+- **型安全性改善**: mypyエラー7%削減（341個→318個）
+
+### 🔧 改善
+- コードスタイル統一（ruff違反大幅削減）
+- 技術的負債の包括的解消
+- テスト実行時間83%短縮の維持
+
+### 🧪 テスト
+- 並行処理機能の包括的テストスイート追加
+- エラーハンドリングとタイムアウト制御の強化
+
+### 📚 ドキュメント
+- 技術的負債分析レポート追加
+- 次期開発計画の策定
+
+## [1.8.4] - 2025-10-16
+
+### 🚀 Added
+
+#### 設定可能なファイルログ機能
+- **🆕 環境変数によるファイルログ制御**: 新しい環境変数による柔軟なログ設定
+  - `TREE_SITTER_ANALYZER_ENABLE_FILE_LOG`: ファイルログの有効/無効制御
+  - `TREE_SITTER_ANALYZER_LOG_DIR`: カスタムログディレクトリの指定
+  - `TREE_SITTER_ANALYZER_FILE_LOG_LEVEL`: ファイルログレベルの制御
+- **🛡️ デフォルト動作の改善**: ユーザープロジェクトの汚染防止のため、デフォルトではファイルログを無効化
+- **📁 システム一時ディレクトリ使用**: ファイルログ有効時はシステム一時ディレクトリを使用
+- **🔄 後方互換性の維持**: 既存の機能に影響を与えない設計
+
+#### 包括的なドキュメントとテスト
+- **📚 新しいドキュメント**:
+  - `docs/debugging_guide.md`: 包括的なデバッグガイド（247行）
+  - `docs/troubleshooting_guide.md`: トラブルシューティングガイド（354行）
+- **🧪 包括的なテストスイート**: `tests/test_logging_configuration.py`（381行のテストケース）
+- **📖 README更新**: ログ設定に関する詳細な説明を追加（53行追加）
+
+### 🔧 Enhanced
+
+#### ログシステムの改善
+- **⚙️ 柔軟な設定オプション**: 環境変数による細かいログ制御
+- **🎯 ユーザーエクスペリエンス**: プロジェクト汚染の防止とクリーンな動作
+- **🔧 開発者サポート**: デバッグとトラブルシューティングの強化
+
+### 🧪 Quality Assurance
+
+#### 継続的な品質保証
+- **3,380個のテスト**: 100%通過率を維持
+- **新規テスト追加**: ログ設定機能の包括的なテストカバレッジ
+- **クロスプラットフォーム**: Windows、macOS、Linuxでの完全な互換性
+
+### 📚 Documentation
+
+#### ドキュメントの大幅拡充
+- **デバッグガイド**: 開発者向けの詳細なデバッグ手順
+- **トラブルシューティング**: 一般的な問題と解決方法
+- **設定ガイド**: 環境変数による詳細な設定方法
+
+### 🎯 Impact
+
+この版本では、設定可能なファイルログ機能により、開発者のデバッグ体験が大幅に向上しました。デフォルトでファイルログを無効にすることで、ユーザープロジェクトの汚染を防ぎ、必要に応じて詳細なログを有効にできる柔軟性を提供します。
+
 ## [1.8.3] - 2025-10-16
 
 ### 🚀 Added

{tree_sitter_analyzer-1.8.3 → tree_sitter_analyzer-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.8.3
+Version: 1.9.0
 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
@@ -198,11 +198,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-3361%20passed-brightgreen.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-3380%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.8.3-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.8.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
 | **Go** | Basic Support | Basic syntax parsing |
 
 ### 🏆 Production Ready
-- **3,361 Tests** - 100% pass rate, enterprise-grade quality assurance
+- **3,380 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
@@ -373,6 +373,7 @@ rg --version
 - **Roo Code**: Supports MCP protocol, use the same configuration format
 - **Other MCP-compatible clients**: Use the same server configuration
 
+
 ---
 
 ### 3.2 💻 CLI Users (Command Line Tools)
@@ -640,6 +641,19 @@ Tree-sitter Analyzer provides a rich set of MCP tools designed for AI assistants
 | **📁 Resource Access** | Code file resources | URI code file access | File content access via URI identification |
 | | Project statistics resources | Project statistics data access | Project analysis data and statistical information |
 
+### 🆕 v1.8.4 New Feature: Configurable File Logging
+
+Revolutionary environment variable-controlled file logging system:
+
+- **🔧 Environment Variable Control**: Flexible file logging behavior control through environment variables
+  - `TREE_SITTER_ANALYZER_ENABLE_FILE_LOG`: Enable/disable file logging
+  - `TREE_SITTER_ANALYZER_LOG_DIR`: Custom log directory path
+  - `TREE_SITTER_ANALYZER_FILE_LOG_LEVEL`: Control file log level
+- **🛡️ Improved Default Behavior**: File logging disabled by default to prevent user project pollution
+- **📁 Smart Directory Selection**: Uses system temp directory when enabled, keeping projects clean
+- **🔄 Backward Compatibility**: Maintains all existing functionality unchanged
+- **📚 Complete Documentation Support**: Includes debugging guides and troubleshooting documentation
+
 ### 🆕 v1.8.3 New Feature: MCP Tools Design Consistency Enhancement
 
 Comprehensive MCP tools unification and design consistency improvements:
@@ -859,7 +873,7 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **3,361 tests** - 100% pass rate ✅
+- **3,380 tests** - 100% pass rate ✅
 - **High code coverage** - Comprehensive test suite
 - **Zero test failures** - Production ready
 - **Cross-platform support** - Windows, macOS, Linux

{tree_sitter_analyzer-1.8.3 → tree_sitter_analyzer-1.9.0}/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-3361%20passed-brightgreen.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-3380%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.8.3-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.8.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)
 
@@ -61,7 +61,7 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 | **Go** | Basic Support | Basic syntax parsing |
 
 ### 🏆 Production Ready
-- **3,361 Tests** - 100% pass rate, enterprise-grade quality assurance
+- **3,380 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
@@ -179,6 +179,7 @@ rg --version
 - **Roo Code**: Supports MCP protocol, use the same configuration format
 - **Other MCP-compatible clients**: Use the same server configuration
 
+
 ---
 
 ### 3.2 💻 CLI Users (Command Line Tools)
@@ -446,6 +447,19 @@ Tree-sitter Analyzer provides a rich set of MCP tools designed for AI assistants
 | **📁 Resource Access** | Code file resources | URI code file access | File content access via URI identification |
 | | Project statistics resources | Project statistics data access | Project analysis data and statistical information |
 
+### 🆕 v1.8.4 New Feature: Configurable File Logging
+
+Revolutionary environment variable-controlled file logging system:
+
+- **🔧 Environment Variable Control**: Flexible file logging behavior control through environment variables
+  - `TREE_SITTER_ANALYZER_ENABLE_FILE_LOG`: Enable/disable file logging
+  - `TREE_SITTER_ANALYZER_LOG_DIR`: Custom log directory path
+  - `TREE_SITTER_ANALYZER_FILE_LOG_LEVEL`: Control file log level
+- **🛡️ Improved Default Behavior**: File logging disabled by default to prevent user project pollution
+- **📁 Smart Directory Selection**: Uses system temp directory when enabled, keeping projects clean
+- **🔄 Backward Compatibility**: Maintains all existing functionality unchanged
+- **📚 Complete Documentation Support**: Includes debugging guides and troubleshooting documentation
+
 ### 🆕 v1.8.3 New Feature: MCP Tools Design Consistency Enhancement
 
 Comprehensive MCP tools unification and design consistency improvements:
@@ -665,7 +679,7 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **3,361 tests** - 100% pass rate ✅
+- **3,380 tests** - 100% pass rate ✅
 - **High code coverage** - Comprehensive test suite
 - **Zero test failures** - Production ready
 - **Cross-platform support** - Windows, macOS, Linux

{tree_sitter_analyzer-1.8.3 → tree_sitter_analyzer-1.9.0}/README_ja.md

@@ -4,11 +4,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-3361%20passed-brightgreen.svg)](#8--品質保証)
+[![テスト](https://img.shields.io/badge/tests-3380%20passed-brightgreen.svg)](#8--品質保証)
 [![カバレッジ](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer/branch/main/graph/badge.svg)](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer)
 [![品質](https://img.shields.io/badge/quality-enterprise%20grade-blue.svg)](#8--品質保証)
 [![PyPI](https://img.shields.io/pypi/v/tree-sitter-analyzer.svg)](https://pypi.org/project/tree-sitter-analyzer/)
-[![バージョン](https://img.shields.io/badge/version-1.8.3-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![バージョン](https://img.shields.io/badge/version-1.8.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)
 
@@ -61,7 +61,7 @@ Tree-sitter Analyzerは、AI時代のために設計されたエンタープラ
 | **Go** | 基本サポート | 基本構文解析 |
 
 ### 🏆 本番環境対応
-- **3,361のテスト** - 100%合格率、エンタープライズグレードの品質保証
+- **3,380のテスト** - 100%合格率、エンタープライズグレードの品質保証
 - **高カバレッジ** - 包括的なテストスイート
 - **クロスプラットフォームサポート** - Windows、macOS、Linuxとの完全な互換性
 - **継続的なメンテナンス** - アクティブな開発とコミュニティサポート
@@ -446,6 +446,16 @@ Tree-sitter AnalyzerはAIアシスタント向けに設計された豊富なMCP
 | **📁 リソースアクセス** | コードファイルリソース | URIコードファイルアクセス | URI識別によるファイルコンテンツアクセス |
 | | プロジェクト統計リソース | プロジェクト統計データアクセス | プロジェクト解析データと統計情報 |
 
+### 🆕 v1.8.4新機能：設定可能ファイルログ
+
+環境変数による柔軟なファイルログ制御システム：
+
+- **🔧 環境変数制御**：`TREE_SITTER_ANALYZER_ENABLE_FILE_LOG`でファイルログの有効/無効を制御
+- **📁 カスタムログディレクトリ**：`TREE_SITTER_ANALYZER_LOG_DIR`でログファイルの保存場所を指定
+- **📊 ログレベル設定**：`TREE_SITTER_ANALYZER_FILE_LOG_LEVEL`でログの詳細度を制御（DEBUG、INFO、WARNING、ERROR）
+- **🚫 プロジェクト汚染防止**：デフォルトでファイルログを無効化し、プロジェクトディレクトリの清潔性を保持
+- **🔄 動的制御**：実行時に環境変数を変更してログ動作を調整可能
+
 ### 🆕 v1.8.3新機能：MCPツール設計一貫性の強化
 
 包括的なMCPツール統一と設計一貫性の改善：
@@ -665,7 +675,7 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 品質保証
 
 ### 📊 品質メトリクス
-- **3,361のテスト** - 100%合格率 ✅
+- **3,380のテスト** - 100%合格率 ✅
 - **高コードカバレッジ** - 包括的なテストスイート
 - **ゼロテスト失敗** - 本番環境対応
 - **クロスプラットフォームサポート** - Windows、macOS、Linux

{tree_sitter_analyzer-1.8.3 → tree_sitter_analyzer-1.9.0}/README_zh.md

@@ -4,11 +4,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-3361%20passed-brightgreen.svg)](#质量保证)
+[![测试](https://img.shields.io/badge/tests-3380%20passed-brightgreen.svg)](#质量保证)
 [![覆盖率](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer/branch/main/graph/badge.svg)](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer)
 [![质量](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-1.8.3-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![版本](https://img.shields.io/badge/version-1.8.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)
 
@@ -62,7 +62,7 @@ Tree-sitter Analyzer 是一个为AI时代设计的企业级代码分析工具，
 | **Go** | 基础支持 | 基本语法解析 |
 
 ### 🏆 生产就绪
-- **3,361个测试** - 100%通过率，企业级质量保证
+- **3,380个测试** - 100%通过率，企业级质量保证
 - **高覆盖率** - 全面的测试覆盖
 - **跨平台支持** - Windows、macOS、Linux全平台兼容
 - **持续维护** - 活跃的开发和社区支持
@@ -447,6 +447,19 @@ Tree-sitter Analyzer提供了丰富的MCP工具集，专为AI助手设计：
 | **📁 资源访问** | 代码文件资源 | URI访问代码文件 | 通过URI标识访问文件内容 |
 | | 项目统计资源 | 访问项目统计数据 | 项目分析数据和统计信息 |
 
+### 🆕 v1.8.4新特性：可配置文件日志功能
+
+革命性的环境变量控制文件日志系统：
+
+- **🔧 环境变量控制**：通过环境变量灵活控制文件日志行为
+  - `TREE_SITTER_ANALYZER_ENABLE_FILE_LOG`: 启用/禁用文件日志
+  - `TREE_SITTER_ANALYZER_LOG_DIR`: 自定义日志目录路径
+  - `TREE_SITTER_ANALYZER_FILE_LOG_LEVEL`: 控制文件日志级别
+- **🛡️ 默认行为改进**：默认禁用文件日志，防止用户项目污染
+- **📁 智能目录选择**：启用时使用系统临时目录，保持项目清洁
+- **🔄 向后兼容性**：完全保持现有功能不变
+- **📚 完整文档支持**：包含调试指南和故障排除文档
+
 ### 🆕 v1.8.3新特性：MCP工具设计一致性增强
 
 全面的MCP工具统一和设计一致性改进：
@@ -667,7 +680,7 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 质量保证
 
 ### 📊 质量指标
-- **3,361个测试** - 100%通过率 ✅
+- **3,380个测试** - 100%通过率 ✅
 - **高代码覆盖率** - 全面测试套件
 - **零测试失败** - 生产就绪
 - **跨平台支持** - Windows、macOS、Linux

{tree_sitter_analyzer-1.8.3 → tree_sitter_analyzer-1.9.0}/collect_project_metrics.py

@@ -2,89 +2,101 @@
 """
 tree-sitter-analyzerプロジェクト固有のメトリクス収集スクリプト
 """
-import os
-import glob
-from pathlib import Path
-import subprocess
-import sys
+
 from collections import defaultdict
+from pathlib import Path
+
 
 def is_project_file(filepath):
     """プロジェクト固有のファイルかどうかを判定"""
     path_str = str(filepath)
     # 除外するディレクトリ
-    exclude_dirs = ['.venv', '__pycache__', '.git', '.pytest_cache', 'node_modules', '.ruff_cache']
-    
+    exclude_dirs = [
+        ".venv",
+        "__pycache__",
+        ".git",
+        ".pytest_cache",
+        "node_modules",
+        ".ruff_cache",
+    ]
+
     for exclude_dir in exclude_dirs:
         if exclude_dir in path_str:
             return False
     return True
 
+
 def count_lines_in_file(filepath):
     """ファイルの行数を数える"""
     try:
-        with open(filepath, 'r', encoding='utf-8', errors='ignore') as f:
+        with open(filepath, encoding="utf-8", errors="ignore") as f:
             lines = f.readlines()
             total_lines = len(lines)
-            empty_lines = sum(1 for line in lines if line.strip() == '')
-            comment_lines = sum(1 for line in lines if line.strip().startswith('#'))
+            empty_lines = sum(1 for line in lines if line.strip() == "")
+            comment_lines = sum(1 for line in lines if line.strip().startswith("#"))
             code_lines = total_lines - empty_lines - comment_lines
             return {
-                'total': total_lines,
-                'empty': empty_lines,
-                'comment': comment_lines,
-                'code': code_lines
+                "total": total_lines,
+                "empty": empty_lines,
+                "comment": comment_lines,
+                "code": code_lines,
             }
     except Exception as e:
         print(f"Error reading {filepath}: {e}")
-        return {'total': 0, 'empty': 0, 'comment': 0, 'code': 0}
+        return {"total": 0, "empty": 0, "comment": 0, "code": 0}
+
 
 def collect_file_metrics():
     """ファイルメトリクスを収集"""
     print("=== プロジェクトファイル統計 ===")
-    
+
     # プロジェクト固有のPythonファイルの統計
-    all_py_files = list(Path('.').rglob('*.py'))
+    all_py_files = list(Path(".").rglob("*.py"))
     py_files = [f for f in all_py_files if is_project_file(f)]
-    test_files = [f for f in py_files if 'test_' in f.name or f.name.startswith('test_') or 'tests/' in str(f)]
-    
+    test_files = [
+        f
+        for f in py_files
+        if "test_" in f.name or f.name.startswith("test_") or "tests/" in str(f)
+    ]
+
     print(f"プロジェクト内Pythonファイル数: {len(py_files)}")
     print(f"テストファイル数: {len(test_files)}")
     print(f"プロダクションファイル数: {len(py_files) - len(test_files)}")
-    
+
     # 言語別ファイル数（プロジェクト固有のみ）
     extensions = defaultdict(int)
-    for file_path in Path('.').rglob('*'):
+    for file_path in Path(".").rglob("*"):
         if file_path.is_file() and is_project_file(file_path):
             ext = file_path.suffix.lower()
             if ext:
                 extensions[ext] += 1
-    
+
     print("\n=== 言語別ファイル数（プロジェクト固有）===")
     for ext, count in sorted(extensions.items(), key=lambda x: x[1], reverse=True):
         if count > 1:  # 2個以上のファイルがある拡張子のみ表示
             print(f"{ext}: {count}")
-    
+
     return py_files, test_files
 
+
 def collect_line_metrics(py_files, test_files):
     """行数メトリクスを収集"""
     print("\n=== 行数統計（プロジェクト固有）===")
-    
-    total_metrics = {'total': 0, 'empty': 0, 'comment': 0, 'code': 0}
-    test_metrics = {'total': 0, 'empty': 0, 'comment': 0, 'code': 0}
-    prod_metrics = {'total': 0, 'empty': 0, 'comment': 0, 'code': 0}
-    
+
+    total_metrics = {"total": 0, "empty": 0, "comment": 0, "code": 0}
+    test_metrics = {"total": 0, "empty": 0, "comment": 0, "code": 0}
+    prod_metrics = {"total": 0, "empty": 0, "comment": 0, "code": 0}
+
     file_sizes = []
-    
+
     for py_file in py_files:
         metrics = count_lines_in_file(py_file)
-        file_sizes.append((py_file, metrics['total']))
-        
+        file_sizes.append((py_file, metrics["total"]))
+
         # 総計に追加
         for key in total_metrics:
             total_metrics[key] += metrics[key]
-        
+
         # テストファイルかプロダクションファイルかで分類
         if py_file in test_files:
             for key in test_metrics:
@@ -92,98 +104,106 @@ def collect_line_metrics(py_files, test_files):
         else:
             for key in prod_metrics:
                 prod_metrics[key] += metrics[key]
-    
+
     print("全体:")
     print(f"  総行数: {total_metrics['total']:,}")
     print(f"  実効コード行数: {total_metrics['code']:,}")
     print(f"  コメント行数: {total_metrics['comment']:,}")
     print(f"  空行数: {total_metrics['empty']:,}")
-    
+
     print("\nプロダクションコード:")
     print(f"  総行数: {prod_metrics['total']:,}")
     print(f"  実効コード行数: {prod_metrics['code']:,}")
-    
+
     print("\nテストコード:")
     print(f"  総行数: {test_metrics['total']:,}")
     print(f"  実効コード行数: {test_metrics['code']:,}")
-    
+
     # 最大ファイルサイズ（プロジェクト固有のみ）
     file_sizes.sort(key=lambda x: x[1], reverse=True)
     print("\n=== 最大ファイル（上位10件）===")
     for i, (file_path, lines) in enumerate(file_sizes[:10]):
-        print(f"{i+1:2d}. {file_path} ({lines:,} 行)")
-    
+        print(f"{i + 1:2d}. {file_path} ({lines:,} 行)")
+
     return total_metrics, prod_metrics, test_metrics
 
+
 def analyze_project_structure():
     """プロジェクト構造を分析"""
     print("\n=== プロジェクト構造分析 ===")
-    
+
     # メインパッケージのディレクトリ構造
-    main_package = Path('tree_sitter_analyzer')
+    main_package = Path("tree_sitter_analyzer")
     if main_package.exists():
         print(f"メインパッケージ: {main_package}")
-        subdirs = [d for d in main_package.rglob('*') if d.is_dir()]
+        subdirs = [d for d in main_package.rglob("*") if d.is_dir()]
         print(f"サブディレクトリ数: {len(subdirs)}")
-        
+
         # 主要なサブモジュール
         main_subdirs = [d for d in main_package.iterdir() if d.is_dir()]
         print("主要サブモジュール:")
         for subdir in sorted(main_subdirs):
-            py_files_in_subdir = list(subdir.rglob('*.py'))
+            py_files_in_subdir = list(subdir.rglob("*.py"))
             print(f"  {subdir.name}: {len(py_files_in_subdir)} ファイル")
 
+
 def check_dependencies():
     """依存関係を確認"""
     print("\n=== 依存関係確認 ===")
-    
+
     # pyproject.tomlから依存関係を読み取り
-    pyproject_path = Path('pyproject.toml')
+    pyproject_path = Path("pyproject.toml")
     if pyproject_path.exists():
         print("pyproject.tomlから依存関係を確認:")
         try:
-            with open(pyproject_path, 'r', encoding='utf-8') as f:
+            with open(pyproject_path, encoding="utf-8") as f:
                 content = f.read()
-                if '[tool.poetry.dependencies]' in content:
-                    lines = content.split('\n')
+                if "[tool.poetry.dependencies]" in content:
+                    lines = content.split("\n")
                     in_deps = False
                     for line in lines:
-                        if '[tool.poetry.dependencies]' in line:
+                        if "[tool.poetry.dependencies]" in line:
                             in_deps = True
                             continue
-                        elif line.startswith('[') and in_deps:
+                        elif line.startswith("[") and in_deps:
                             break
-                        elif in_deps and '=' in line:
+                        elif in_deps and "=" in line:
                             print(f"  {line.strip()}")
         except Exception as e:
             print(f"pyproject.toml読み取りエラー: {e}")
 
+
 def main():
     """メイン関数"""
     print("tree-sitter-analyzer プロジェクト固有メトリクス収集")
     print("=" * 60)
-    
+
     # ファイルメトリクス収集
     py_files, test_files = collect_file_metrics()
-    
+
     # 行数メトリクス収集
-    total_metrics, prod_metrics, test_metrics = collect_line_metrics(py_files, test_files)
-    
+    total_metrics, prod_metrics, test_metrics = collect_line_metrics(
+        py_files, test_files
+    )
+
     # プロジェクト構造分析
     analyze_project_structure()
-    
+
     # 依存関係確認
     check_dependencies()
-    
+
     print("\n" + "=" * 60)
     print("プロジェクト固有メトリクス収集完了")
-    
+
     # サマリー
     print("\n=== サマリー ===")
     print(f"プロジェクト規模: {len(py_files)} Pythonファイル")
     print(f"総コード行数: {total_metrics['code']:,} 行")
     print(f"テストカバレッジ対象: {len(test_files)} テストファイル")
-    print(f"平均ファイルサイズ: {total_metrics['total'] // len(py_files) if py_files else 0} 行/ファイル")
+    print(
+        f"平均ファイルサイズ: {total_metrics['total'] // len(py_files) if py_files else 0} 行/ファイル"
+    )
+
 
 if __name__ == "__main__":
-    main()
+    main()