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

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

@@ -1,5 +1,50 @@
 # Changelog
 
+## [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.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.8.3
+Version: 1.8.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
@@ -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.8.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-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.8.4}/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.8.4}/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.4/docs/debugging_guide.md

@@ -0,0 +1,247 @@
+# Tree-sitter Analyzer デバッグガイド
+
+## 概要
+
+Tree-sitter Analyzerのログ設定改善機能により、開発者とユーザーは詳細なデバッグ情報を取得できるようになりました。このガイドでは、効果的なデバッグ手順と環境変数の使用方法について説明します。
+
+## 🔧 環境変数による制御
+
+### 基本的なログ制御
+
+| 環境変数 | 説明 | デフォルト値 | 使用例 |
+|---------|------|------------|--------|
+| `LOG_LEVEL` | メインロガーのログレベル | `WARNING` | `DEBUG`, `INFO`, `WARNING`, `ERROR` |
+| `TREE_SITTER_ANALYZER_ENABLE_FILE_LOG` | ファイルログの有効化 | `false` | `true` |
+| `TREE_SITTER_ANALYZER_LOG_DIR` | ログファイルの出力ディレクトリ | システム一時ディレクトリ | `/var/log/tree-sitter` |
+| `TREE_SITTER_ANALYZER_FILE_LOG_LEVEL` | ファイルログのレベル | メインロガーと同じ | `DEBUG`, `INFO`, `WARNING`, `ERROR` |
+
+### 設定例
+
+#### 1. 基本的なデバッグ設定
+
+```bash
+export LOG_LEVEL=DEBUG
+export TREE_SITTER_ANALYZER_ENABLE_FILE_LOG=true
+```
+
+#### 2. カスタムログディレクトリ設定
+
+```bash
+export TREE_SITTER_ANALYZER_ENABLE_FILE_LOG=true
+export TREE_SITTER_ANALYZER_LOG_DIR=/home/user/logs/tree-sitter
+export TREE_SITTER_ANALYZER_FILE_LOG_LEVEL=DEBUG
+```
+
+#### 3. 本番環境での最小ログ設定
+
+```bash
+export LOG_LEVEL=ERROR
+export TREE_SITTER_ANALYZER_ENABLE_FILE_LOG=true
+export TREE_SITTER_ANALYZER_FILE_LOG_LEVEL=WARNING
+```
+
+## 🐛 デバッグ手順
+
+### 1. MCPサーバーのデバッグ
+
+#### Claude Desktopでのデバッグ設定
+
+`claude_desktop_config.json`に以下を追加：
+
+```json
+{
+  "mcpServers": {
+    "tree-sitter-analyzer": {
+      "command": "uv",
+      "args": [
+        "run", "--with", "tree-sitter-analyzer[mcp]",
+        "python", "-m", "tree_sitter_analyzer.mcp.server"
+      ],
+      "env": {
+        "TREE_SITTER_PROJECT_ROOT": "/path/to/your/project",
+        "TREE_SITTER_ANALYZER_ENABLE_FILE_LOG": "true",
+        "TREE_SITTER_ANALYZER_FILE_LOG_LEVEL": "DEBUG",
+        "LOG_LEVEL": "INFO"
+      }
+    }
+  }
+}
+```
+
+#### ログファイルの確認
+
+1. **ログファイルの場所を確認**：
+   ```bash
+   # デフォルトの場所（システム一時ディレクトリ）
+   ls /tmp/tree_sitter_analyzer.log  # Linux/macOS
+   dir %TEMP%\tree_sitter_analyzer.log  # Windows
+   ```
+
+2. **リアルタイムでログを監視**：
+   ```bash
+   tail -f /tmp/tree_sitter_analyzer.log
+   ```
+
+### 2. CLIツールのデバッグ
+
+#### デバッグモードでの実行
+
+```bash
+# 環境変数を設定してCLIを実行
+export LOG_LEVEL=DEBUG
+export TREE_SITTER_ANALYZER_ENABLE_FILE_LOG=true
+
+uv run python -m tree_sitter_analyzer examples/BigService.java --advanced
+```
+
+#### 詳細なパフォーマンス分析
+
+```bash
+# パフォーマンスログも有効化
+export LOG_LEVEL=DEBUG
+export TREE_SITTER_ANALYZER_ENABLE_FILE_LOG=true
+export TREE_SITTER_ANALYZER_FILE_LOG_LEVEL=DEBUG
+
+uv run python -m tree_sitter_analyzer examples/BigService.java --table=full
+```
+
+### 3. 一般的な問題のトラブルシューティング
+
+#### 問題1: MCPサーバーが起動しない
+
+**症状**: Claude DesktopでMCPサーバーが認識されない
+
+**デバッグ手順**:
+1. ログファイルを有効化
+2. Claude Desktopを再起動
+3. ログファイルでエラーメッセージを確認
+
+```bash
+export TREE_SITTER_ANALYZER_ENABLE_FILE_LOG=true
+export TREE_SITTER_ANALYZER_FILE_LOG_LEVEL=DEBUG
+```
+
+#### 問題2: ファイル解析が失敗する
+
+**症状**: 特定のファイルの解析でエラーが発生
+
+**デバッグ手順**:
+1. DEBUGレベルでログを有効化
+2. 問題のファイルを単独で解析
+3. エラーの詳細を確認
+
+```bash
+export LOG_LEVEL=DEBUG
+export TREE_SITTER_ANALYZER_ENABLE_FILE_LOG=true
+
+uv run python -m tree_sitter_analyzer problematic_file.java --advanced
+```
+
+#### 問題3: パフォーマンスが遅い
+
+**症状**: 大きなファイルの解析に時間がかかる
+
+**デバッグ手順**:
+1. パフォーマンスログを有効化
+2. 処理時間を測定
+3. ボトルネックを特定
+
+```bash
+export TREE_SITTER_ANALYZER_ENABLE_FILE_LOG=true
+export TREE_SITTER_ANALYZER_FILE_LOG_LEVEL=DEBUG
+
+time uv run python -m tree_sitter_analyzer large_file.java --advanced
+```
+
+## 📊 ログ出力の理解
+
+### ログレベルの説明
+
+- **DEBUG**: 詳細な実行情報、変数の値、内部状態
+- **INFO**: 一般的な実行情報、処理の開始/終了
+- **WARNING**: 警告メッセージ、非致命的な問題
+- **ERROR**: エラーメッセージ、処理の失敗
+
+### ログメッセージの例
+
+```
+2025-10-16 12:00:00,123 - tree_sitter_analyzer - INFO - MCP server starting with project root: /path/to/project
+2025-10-16 12:00:00,124 - tree_sitter_analyzer - DEBUG - File logging enabled: /tmp/tree_sitter_analyzer.log
+2025-10-16 12:00:01,456 - tree_sitter_analyzer.performance - DEBUG - File analysis: 0.1234s - lines: 1419, elements: 85
+```
+
+## 🔍 高度なデバッグテクニック
+
+### 1. 条件付きログ出力
+
+特定の条件でのみ詳細ログを出力：
+
+```bash
+# 大きなファイルのみDEBUGログを出力
+if [ $(wc -l < "$FILE") -gt 1000 ]; then
+    export LOG_LEVEL=DEBUG
+else
+    export LOG_LEVEL=INFO
+fi
+```
+
+### 2. ログローテーション
+
+長時間実行時のログファイル管理：
+
+```bash
+# ログファイルのサイズ制限
+export TREE_SITTER_ANALYZER_LOG_DIR=/var/log/tree-sitter
+# logrotateを使用してローテーション設定
+```
+
+### 3. 構造化ログ分析
+
+ログファイルからの情報抽出：
+
+```bash
+# エラーメッセージのみ抽出
+grep "ERROR" /tmp/tree_sitter_analyzer.log
+
+# パフォーマンス情報の抽出
+grep "performance" /tmp/tree_sitter_analyzer.log | grep -o "[0-9]\+\.[0-9]\+s"
+
+# 特定のファイルの処理時間
+grep "File analysis" /tmp/tree_sitter_analyzer.log | grep "BigService.java"
+```
+
+## 🚨 注意事項
+
+### セキュリティ
+
+- ログファイルには機密情報が含まれる可能性があります
+- 本番環境では適切なログレベルを設定してください
+- ログファイルのアクセス権限を適切に設定してください
+
+### パフォーマンス
+
+- DEBUGレベルのログは大量の出力を生成します
+- ファイルログは若干のパフォーマンス影響があります
+- 必要に応じてログレベルを調整してください
+
+### ストレージ
+
+- ログファイルは時間とともに大きくなります
+- 定期的なクリーンアップを検討してください
+- ディスク容量を監視してください
+
+## 📞 サポート
+
+問題が解決しない場合は、以下の情報を含めてIssueを作成してください：
+
+1. 使用した環境変数の設定
+2. 実行したコマンド
+3. エラーメッセージ
+4. ログファイルの関連部分
+5. 環境情報（OS、Pythonバージョンなど）
+
+## 🔗 関連ドキュメント
+
+- [README.md](../README.md) - 基本的な使用方法
+- [CONTRIBUTING.md](CONTRIBUTING.md) - 開発者向けガイド
+- [トラブルシューティングガイド](troubleshooting_guide.md) - 一般的な問題の解決方法