tree-sitter-analyzer 1.8.2__py3-none-any.whl → 1.8.4__py3-none-any.whl

tree_sitter_analyzer/__init__.py

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

tree_sitter_analyzer/mcp/tools/find_and_grep_tool.py

@@ -27,7 +27,18 @@ class FindAndGrepTool(BaseMCPTool):
     def __init__(self, project_root: str | None = None) -> None:
         """Initialize the find and grep tool."""
         super().__init__(project_root)
-        self.file_output_manager = FileOutputManager(project_root)
+        self.file_output_manager = FileOutputManager.get_managed_instance(project_root)
+
+    def set_project_path(self, project_path: str) -> None:
+        """
+        Update the project path for all components.
+
+        Args:
+            project_path: New project root directory
+        """
+        super().set_project_path(project_path)
+        self.file_output_manager = FileOutputManager.get_managed_instance(project_path)
+        logger.info(f"FindAndGrepTool project path updated to: {project_path}")
 
     def get_tool_definition(self) -> dict[str, Any]:
         return {

tree_sitter_analyzer/mcp/tools/query_tool.py

@@ -26,7 +26,7 @@ class QueryTool(BaseMCPTool):
         """Initialize query tool"""
         super().__init__(project_root)
         self.query_service = QueryService(project_root)
-        self.file_output_manager = FileOutputManager(project_root)
+        self.file_output_manager = FileOutputManager.get_managed_instance(project_root)
 
     def set_project_path(self, project_path: str) -> None:
         """
@@ -37,7 +37,7 @@ class QueryTool(BaseMCPTool):
         """
         super().set_project_path(project_path)
         self.query_service = QueryService(project_path)
-        self.file_output_manager.set_project_root(project_path)
+        self.file_output_manager = FileOutputManager.get_managed_instance(project_path)
         logger.info(f"QueryTool project path updated to: {project_path}")
 
     def get_tool_definition(self) -> dict[str, Any]:

tree_sitter_analyzer/mcp/tools/search_content_tool.py

@@ -37,7 +37,18 @@ class SearchContentTool(BaseMCPTool):
         """
         super().__init__(project_root)
         self.cache = get_default_cache() if enable_cache else None
-        self.file_output_manager = FileOutputManager(project_root)
+        self.file_output_manager = FileOutputManager.get_managed_instance(project_root)
+
+    def set_project_path(self, project_path: str) -> None:
+        """
+        Update the project path for all components.
+
+        Args:
+            project_path: New project root directory
+        """
+        super().set_project_path(project_path)
+        self.file_output_manager = FileOutputManager.get_managed_instance(project_path)
+        logger.info(f"SearchContentTool project path updated to: {project_path}")
 
     def get_tool_definition(self) -> dict[str, Any]:
         return {

tree_sitter_analyzer/mcp/tools/table_format_tool.py

@@ -42,7 +42,7 @@ class TableFormatTool(BaseMCPTool):
         """Initialize the table format tool."""
         super().__init__(project_root)
         self.analysis_engine = get_analysis_engine(project_root)
-        self.file_output_manager = FileOutputManager(project_root)
+        self.file_output_manager = FileOutputManager.get_managed_instance(project_root)
         self.logger = logger
 
     def set_project_path(self, project_path: str) -> None:
@@ -54,7 +54,7 @@ class TableFormatTool(BaseMCPTool):
         """
         super().set_project_path(project_path)
         self.analysis_engine = get_analysis_engine(project_path)
-        self.file_output_manager.set_project_root(project_path)
+        self.file_output_manager = FileOutputManager.get_managed_instance(project_path)
         logger.info(f"TableFormatTool project path updated to: {project_path}")
 
     def get_tool_schema(self) -> dict[str, Any]:

tree_sitter_analyzer/mcp/utils/file_output_factory.py

@@ -0,0 +1,204 @@
+#!/usr/bin/env python3
+"""
+File Output Manager Factory
+
+This module provides a Managed Singleton Factory Pattern for FileOutputManager
+to prevent duplicate initialization and ensure consistent instance management
+across MCP tools.
+"""
+
+import threading
+from pathlib import Path
+from typing import Dict, Optional
+
+from ...utils import setup_logger
+from .file_output_manager import FileOutputManager
+
+# Set up logging
+logger = setup_logger(__name__)
+
+
+class FileOutputManagerFactory:
+    """
+    Factory class that manages FileOutputManager instances using a Managed Singleton
+    pattern. Each project root gets its own singleton instance, ensuring consistency
+    across MCP tools while preventing duplicate initialization.
+    """
+    
+    # Class-level lock for thread safety
+    _lock = threading.RLock()
+    
+    # Dictionary to store instances by project root
+    _instances: Dict[str, FileOutputManager] = {}
+    
+    @classmethod
+    def get_instance(cls, project_root: Optional[str] = None) -> FileOutputManager:
+        """
+        Get or create a FileOutputManager instance for the specified project root.
+        
+        This method implements the Managed Singleton pattern - one instance per
+        project root, ensuring consistency across all MCP tools.
+        
+        Args:
+            project_root: Project root directory. If None, uses current working directory.
+            
+        Returns:
+            FileOutputManager instance for the specified project root
+        """
+        # Normalize project root path
+        normalized_root = cls._normalize_project_root(project_root)
+        
+        # Double-checked locking pattern for thread safety
+        if normalized_root not in cls._instances:
+            with cls._lock:
+                if normalized_root not in cls._instances:
+                    logger.info(f"Creating new FileOutputManager instance for project root: {normalized_root}")
+                    cls._instances[normalized_root] = FileOutputManager(normalized_root)
+                else:
+                    logger.debug(f"Using existing FileOutputManager instance for project root: {normalized_root}")
+        else:
+            logger.debug(f"Using existing FileOutputManager instance for project root: {normalized_root}")
+            
+        return cls._instances[normalized_root]
+    
+    @classmethod
+    def _normalize_project_root(cls, project_root: Optional[str]) -> str:
+        """
+        Normalize project root path for consistent key generation.
+        
+        Args:
+            project_root: Raw project root path
+            
+        Returns:
+            Normalized absolute path string
+        """
+        if project_root is None:
+            return str(Path.cwd().resolve())
+        
+        try:
+            return str(Path(project_root).resolve())
+        except Exception as e:
+            logger.warning(f"Failed to resolve project root path '{project_root}': {e}")
+            return str(Path.cwd().resolve())
+    
+    @classmethod
+    def clear_instance(cls, project_root: Optional[str] = None) -> bool:
+        """
+        Clear a specific FileOutputManager instance from the factory.
+        
+        This method is primarily for testing purposes or when you need to
+        force recreation of an instance.
+        
+        Args:
+            project_root: Project root directory. If None, uses current working directory.
+            
+        Returns:
+            True if instance was cleared, False if it didn't exist
+        """
+        normalized_root = cls._normalize_project_root(project_root)
+        
+        with cls._lock:
+            if normalized_root in cls._instances:
+                logger.info(f"Clearing FileOutputManager instance for project root: {normalized_root}")
+                del cls._instances[normalized_root]
+                return True
+            else:
+                logger.debug(f"No FileOutputManager instance found for project root: {normalized_root}")
+                return False
+    
+    @classmethod
+    def clear_all_instances(cls) -> int:
+        """
+        Clear all FileOutputManager instances from the factory.
+        
+        This method is primarily for testing purposes or cleanup.
+        
+        Returns:
+            Number of instances that were cleared
+        """
+        with cls._lock:
+            count = len(cls._instances)
+            if count > 0:
+                logger.info(f"Clearing all {count} FileOutputManager instances")
+                cls._instances.clear()
+            else:
+                logger.debug("No FileOutputManager instances to clear")
+            return count
+    
+    @classmethod
+    def get_instance_count(cls) -> int:
+        """
+        Get the current number of managed instances.
+        
+        Returns:
+            Number of currently managed FileOutputManager instances
+        """
+        with cls._lock:
+            return len(cls._instances)
+    
+    @classmethod
+    def get_managed_project_roots(cls) -> list[str]:
+        """
+        Get list of all currently managed project roots.
+        
+        Returns:
+            List of project root paths that have managed instances
+        """
+        with cls._lock:
+            return list(cls._instances.keys())
+    
+    @classmethod
+    def update_project_root(cls, old_root: Optional[str], new_root: str) -> bool:
+        """
+        Update the project root for an existing instance.
+        
+        This method moves an existing instance from one project root key to another,
+        and updates the instance's internal project root.
+        
+        Args:
+            old_root: Current project root (None for current working directory)
+            new_root: New project root
+            
+        Returns:
+            True if update was successful, False if old instance didn't exist
+        """
+        old_normalized = cls._normalize_project_root(old_root)
+        new_normalized = cls._normalize_project_root(new_root)
+        
+        if old_normalized == new_normalized:
+            logger.debug(f"Project root update not needed: {old_normalized}")
+            return True
+        
+        with cls._lock:
+            if old_normalized in cls._instances:
+                instance = cls._instances[old_normalized]
+                
+                # Update the instance's internal project root
+                instance.set_project_root(new_root)
+                
+                # Move to new key
+                cls._instances[new_normalized] = instance
+                del cls._instances[old_normalized]
+                
+                logger.info(f"Updated FileOutputManager project root: {old_normalized} -> {new_normalized}")
+                return True
+            else:
+                logger.warning(f"No FileOutputManager instance found for old project root: {old_normalized}")
+                return False
+
+
+# Convenience function for backward compatibility and ease of use
+def get_file_output_manager(project_root: Optional[str] = None) -> FileOutputManager:
+    """
+    Convenience function to get a FileOutputManager instance.
+    
+    This function provides a simple interface to the factory while maintaining
+    the singleton behavior per project root.
+    
+    Args:
+        project_root: Project root directory. If None, uses current working directory.
+        
+    Returns:
+        FileOutputManager instance for the specified project root
+    """
+    return FileOutputManagerFactory.get_instance(project_root)

tree_sitter_analyzer/mcp/utils/file_output_manager.py

@@ -4,12 +4,15 @@ File Output Manager for MCP Tools
 
 This module provides functionality to save analysis results to files with
 appropriate extensions based on content type, with security validation.
+
+Enhanced with Managed Singleton Factory Pattern support for consistent
+instance management across MCP tools.
 """
 
 import json
 import os
 from pathlib import Path
-from typing import Any
+from typing import Any, Optional
 
 from ...utils import setup_logger
 
@@ -21,9 +24,12 @@ class FileOutputManager:
     """
     Manages file output for analysis results with automatic extension detection
     and security validation.
+    
+    Enhanced with factory method support for consistent instance management
+    across MCP tools while maintaining full backward compatibility.
     """
 
-    def __init__(self, project_root: str | None = None):
+    def __init__(self, project_root: Optional[str] = None):
         """
         Initialize the file output manager.
 
@@ -33,6 +39,50 @@ class FileOutputManager:
         self.project_root = project_root
         self._output_path = None
         self._initialize_output_path()
+    
+    @classmethod
+    def get_managed_instance(cls, project_root: Optional[str] = None) -> 'FileOutputManager':
+        """
+        Get a managed FileOutputManager instance using the factory pattern.
+        
+        This method provides access to the Managed Singleton Factory Pattern,
+        ensuring one instance per project root for optimal resource usage
+        and consistency across MCP tools.
+        
+        Args:
+            project_root: Project root directory. If None, uses current working directory.
+            
+        Returns:
+            FileOutputManager instance managed by the factory
+            
+        Note:
+            This method requires the factory module to be available. If the factory
+            is not available, it falls back to creating a new instance directly.
+        """
+        try:
+            # Import here to avoid circular imports
+            from .file_output_factory import FileOutputManagerFactory
+            return FileOutputManagerFactory.get_instance(project_root)
+        except ImportError as e:
+            logger.warning(f"Factory not available, creating new instance directly: {e}")
+            return cls(project_root)
+    
+    @classmethod
+    def create_instance(cls, project_root: Optional[str] = None) -> 'FileOutputManager':
+        """
+        Create a new FileOutputManager instance directly (bypass factory).
+        
+        This method creates a new instance without using the factory pattern.
+        Use this when you specifically need a separate instance that won't
+        be managed by the factory.
+        
+        Args:
+            project_root: Project root directory. If None, uses current working directory.
+            
+        Returns:
+            New FileOutputManager instance
+        """
+        return cls(project_root)
 
     def _initialize_output_path(self) -> None:
         """Initialize the output path from environment variables or project root."""

tree_sitter_analyzer/utils.py

@@ -9,7 +9,9 @@ import atexit
 import logging
 import os
 import sys
+import tempfile
 from functools import wraps
+from pathlib import Path
 from typing import Any
 
 
@@ -51,6 +53,10 @@ def setup_logger(
     if name.startswith("test_"):
         logger.handlers.clear()
 
+    # Initialize file logging variables at function scope
+    enable_file_log = os.environ.get("TREE_SITTER_ANALYZER_ENABLE_FILE_LOG", "").lower() == "true"
+    file_log_level = level  # Default to main logger level
+
     if not logger.handlers:  # Avoid duplicate handlers
         # Create a safe handler that writes to stderr to avoid breaking MCP stdio
         handler = SafeStreamHandler()
@@ -60,27 +66,68 @@ def setup_logger(
         handler.setFormatter(formatter)
         logger.addHandler(handler)
 
-        # Also log to a local file for debugging when launched by clients (e.g., Cursor)
+        # Optional file logging for debugging when launched by clients (e.g., Cursor)
         # This helps diagnose cases where stdio is captured by the client and logs are hidden.
-        try:
-            file_handler = logging.FileHandler(
-                "cursor_mcp_server.log", encoding="utf-8"
-            )
-            file_handler.setFormatter(formatter)
-            logger.addHandler(file_handler)
-        except Exception as e:
-            # Never let logging configuration break runtime behavior; log to stderr if possible
-            if hasattr(sys, "stderr") and hasattr(sys.stderr, "write"):
-                try:
-                    sys.stderr.write(
-                        f"[logging_setup] file handler init skipped: {e}\n"
-                    )
-                except Exception:
-                    ...
+        # Only enabled when TREE_SITTER_ANALYZER_ENABLE_FILE_LOG is set to 'true'
+        if enable_file_log:
+            try:
+                # Determine log directory
+                log_dir = os.environ.get("TREE_SITTER_ANALYZER_LOG_DIR")
+                if log_dir:
+                    # Use specified directory
+                    log_path = Path(log_dir) / "tree_sitter_analyzer.log"
+                    # Ensure directory exists
+                    Path(log_dir).mkdir(parents=True, exist_ok=True)
+                else:
+                    # Use system temporary directory
+                    temp_dir = tempfile.gettempdir()
+                    log_path = Path(temp_dir) / "tree_sitter_analyzer.log"
+                
+                # Determine file log level
+                file_log_level_str = os.environ.get("TREE_SITTER_ANALYZER_FILE_LOG_LEVEL", "").upper()
+                if file_log_level_str and file_log_level_str in ["DEBUG", "INFO", "WARNING", "ERROR"]:
+                    if file_log_level_str == "DEBUG":
+                        file_log_level = logging.DEBUG
+                    elif file_log_level_str == "INFO":
+                        file_log_level = logging.INFO
+                    elif file_log_level_str == "WARNING":
+                        file_log_level = logging.WARNING
+                    elif file_log_level_str == "ERROR":
+                        file_log_level = logging.ERROR
+                else:
+                    # Use same level as main logger
+                    file_log_level = level
+                
+                file_handler = logging.FileHandler(str(log_path), encoding="utf-8")
+                file_handler.setFormatter(formatter)
+                file_handler.setLevel(file_log_level)
+                logger.addHandler(file_handler)
+                
+                # Log the file location for debugging purposes
+                if hasattr(sys, "stderr") and hasattr(sys.stderr, "write"):
+                    try:
+                        sys.stderr.write(f"[logging_setup] File logging enabled: {log_path}\n")
+                    except Exception:
+                        ...
+                        
+            except Exception as e:
+                # Never let logging configuration break runtime behavior; log to stderr if possible
+                if hasattr(sys, "stderr") and hasattr(sys.stderr, "write"):
+                    try:
+                        sys.stderr.write(
+                            f"[logging_setup] file handler init skipped: {e}\n"
+                        )
+                    except Exception:
+                        ...
 
-    # Always set the level, even if handlers already exist
-    # Ensure the level is properly set, not inherited
-    logger.setLevel(level)
+    # Set the logger level to the minimum of main level and file log level
+    # This ensures that all messages that should go to any handler are processed
+    final_level = level
+    if enable_file_log:
+        # Use the minimum level to ensure all messages reach their intended handlers
+        final_level = min(level, file_log_level)
+    
+    logger.setLevel(final_level)
     
     # For test loggers, ensure they don't inherit from parent and force level
     if logger.name.startswith("test_"):

{tree_sitter_analyzer-1.8.2.dist-info → tree_sitter_analyzer-1.8.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.8.2
+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-3342%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.2-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,342 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)
@@ -633,13 +634,37 @@ Tree-sitter Analyzer provides a rich set of MCP tools designed for AI assistants
 | | `analyze_code_structure` | Code structure analysis and table generation | 🆕 suppress_output parameter, multiple formats (full/compact/csv/json/html), automatic language detection |
 | | `extract_code_section` | Precise code section extraction | Specified line range extraction, large file efficient processing, original format preservation |
 | **🔍 Intelligent Search** | `list_files` | High-performance file discovery | fd-based, glob patterns, file type filters, time range control |
-| | `search_content` | Regex content search | ripgrep-based, multiple output formats, context control, encoding handling |
-| | `find_and_grep` | Two-stage search | File discovery → content search, fd+ripgrep combination, intelligent cache optimization |
+| | `search_content` | Regex content search | ripgrep-based, multiple output formats, context control, encoding handling, 🆕 unified `set_project_path` support |
+| | `find_and_grep` | Two-stage search | File discovery → content search, fd+ripgrep combination, intelligent cache optimization, 🆕 unified `set_project_path` support |
 | **🔧 Advanced Queries** | `query_code` | tree-sitter queries | Predefined query keys, custom query strings, filter expression support |
-| **⚙️ System Management** | `set_project_path` | Project root path setting | Security boundary control, automatic path validation |
+| **⚙️ System Management** | `set_project_path` | Project root path setting | Security boundary control, automatic path validation, 🆕 unified across all MCP tools |
 | **📁 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:
+
+- **🔧 Unified `set_project_path` Implementation**: SearchContentTool and FindAndGrepTool now have consistent `set_project_path` method implementation
+- **🏗️ Design Consistency Across All MCP Tools**: All 4 MCP tools (QueryTool, TableFormatTool, SearchContentTool, FindAndGrepTool) now have unified interface design
+- **📁 FileOutputManager Integration**: Unified FileOutputManager factory pattern for consistent file output management
+- **🔄 Dynamic Project Path Changes**: All MCP tools now support dynamic project path changes through unified interface
+- **🛡️ Enhanced Security Boundaries**: Consistent security boundary protection across all MCP tools
+- **📋 Improved Developer Experience**: Unified interface makes MCP tool development and usage more consistent
+
 ### 🆕 v1.8.2 New Feature: CLI Security and Argument Validation Enhancement
 
 Comprehensive CLI security improvements and argument validation optimization:
@@ -848,12 +873,12 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **3,342 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
 
-### ⚡ Latest Quality Achievements (v1.8.2)
+### ⚡ 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
@@ -863,22 +888,6 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 - ✅ **🧪 Test Environment Support** - Temporary directory access permission in test environments
 - ✅ **📋 User Experience Improvement** - More intuitive command-line interface and error handling mechanisms
 
-### ⚡ v1.7.5 Quality Achievements
-- ✅ **📊 Enhanced Quality Metrics** - Test count increased to 3,342 coverage maintained at high levels
-- ✅ **🔧 System Stability** - All tests passing with enhanced system stability and reliability
-- ✅ **🆕 Complete Markdown Support** - Added new complete Markdown language plugin supporting all major Markdown elements
-- ✅ **📝 Enhanced Document Analysis** - Support for intelligent extraction of headers, code blocks, links, images, tables, task lists
-- ✅ **🔍 Markdown Query System** - 17 predefined query types with alias and custom query support
-- ✅ **🧪 Comprehensive Test Validation** - Added extensive Markdown test cases ensuring feature stability
-- ✅ **📊 Structured Output** - Convert Markdown documents to structured data for easy AI processing
-- ✅ **File output optimization** - MCP search tools now include `suppress_output` and `output_file` parameters for massive token savings
-- ✅ **Intelligent format detection** - Automatic selection of optimal file formats (JSON/Markdown) for storage and reading optimization
-- ✅ **ROO rules documentation** - Added comprehensive tree-sitter-analyzer MCP optimization usage guide
-- ✅ **Enhanced token management** - Response size reduced by up to 99% when outputting search results to files
-- ✅ **Enterprise-grade test coverage** - Comprehensive test suite including complete validation of file output optimization features
-- ✅ **Complete MCP tools** - Complete MCP server tool set supporting advanced file search and content analysis
-- ✅ **Cross-platform path compatibility** - Fixed differences between Windows short path names and macOS symbolic links
-- ✅ **GitFlow implementation** - Professional development/release branch strategy
 
 ### ⚙️ Running Tests
 ```bash
@@ -930,6 +939,9 @@ This project provides complete documentation support, including:
 - **MCP Configuration Guide** - See the [AI Users Configuration](#31--ai-users-claude-desktop-cursor-etc) section
 - **CLI Usage Guide** - See the [Complete CLI Commands](#6--complete-cli-commands) section
 - **Core Features Documentation** - See the [Core Features](#7-️-core-features) section
+- **Contributing Guide** - See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for development guidelines and document management
+- **Analysis Results** - See [docs/analysis/](docs/analysis/) for project analysis reports and metrics
+- **Feature Specifications** - See [specs/](specs/) for detailed feature specifications and implementation plans
 
 ### 🤖 AI Collaboration Support
 This project supports AI-assisted development with professional quality control:

{tree_sitter_analyzer-1.8.2.dist-info → tree_sitter_analyzer-1.8.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-tree_sitter_analyzer/__init__.py,sha256=h6zUP8Chm-_bNNKaCIY25G3h_JKBLIed582ErUTq0Zc,3067
+tree_sitter_analyzer/__init__.py,sha256=Bg7okJtLa1BS4OaksNMVLvvdDXWbdWF0AKsoRp5aTig,3067
 tree_sitter_analyzer/__main__.py,sha256=Zl79tpe4UaMu-7yeztc06tgP0CVMRnvGgas4ZQP5SCs,228
 tree_sitter_analyzer/api.py,sha256=gqHatRpVm8k0jEfFm45iokHRPYJjEcud6MtrCSg1V0A,22169
 tree_sitter_analyzer/cli_main.py,sha256=RAPn4VGHVOfC2vrU1Sef7PEPcypMwuI5GgWiwoYL1PE,11100
@@ -13,7 +13,7 @@ tree_sitter_analyzer/output_manager.py,sha256=hRAp6Aa9k05UVvZkOyRCEz2Lf7blx05fWn
 tree_sitter_analyzer/project_detector.py,sha256=-zmtm12EvVD_6TDxS_6KpzuswP2Bpppnxq50kAEDyMA,9430
 tree_sitter_analyzer/query_loader.py,sha256=rtUZ_ZBhacb2uvM8aPrf0XiigUDtxflfjbenfKcatEI,10407
 tree_sitter_analyzer/table_formatter.py,sha256=tPKw77LLlQ7k5MMs9_Ez7qsSroNaSzZPoplyPtKHLhA,28577
-tree_sitter_analyzer/utils.py,sha256=hezEhJ4TGAFTRa-Ii_i42jPLkspAme-GRsZR5e38OBQ,13650
+tree_sitter_analyzer/utils.py,sha256=YN4n_XDJQAvcP2eKqYV7AzsZW1UMtks9O4BLR2youjs,16110
 tree_sitter_analyzer/cli/__init__.py,sha256=O_3URpbdu5Ilb2-r48LjbZuWtOWQu_BhL3pa6C0G3Bk,871
 tree_sitter_analyzer/cli/__main__.py,sha256=Xq8o8-0dPnMDU9WZqmqhzr98rx8rvoffTUHAkAwl-L8,218
 tree_sitter_analyzer/cli/argument_validator.py,sha256=n336uNVWE9FFWc5s1ADKNQq53_BSnqdTtqEFk90UDBI,2574
@@ -72,16 +72,17 @@ tree_sitter_analyzer/mcp/tools/analyze_scale_tool.py,sha256=Yb9lpUPGuvRbawmE15ic
 tree_sitter_analyzer/mcp/tools/analyze_scale_tool_cli_compatible.py,sha256=mssed7bEfGeGxW4mOf7dg8BDS1oqHLolIBNX9DaZ3DM,8997
 tree_sitter_analyzer/mcp/tools/base_tool.py,sha256=qf2My325azlnKOugNVMN_R1jtZcjXVy354sGVKzvZls,3546
 tree_sitter_analyzer/mcp/tools/fd_rg_utils.py,sha256=9jQ4D5yREs7Nt8L0s-NdVtmaKXJAAOKqAAI8mkW3T2o,18664
-tree_sitter_analyzer/mcp/tools/find_and_grep_tool.py,sha256=9p_Olh6wjuUAVqHfXnsUj3crZtUV4_R6zAfKRqe8jTY,31623
+tree_sitter_analyzer/mcp/tools/find_and_grep_tool.py,sha256=OLJToDgLj74irikqC5kJQ_k5isAw9YzkVVOrQIRrQnc,32063
 tree_sitter_analyzer/mcp/tools/list_files_tool.py,sha256=nd6uiOqbsr8NUqNL46d8QnOM-XpMTDOFiaccjBaGLl8,18268
-tree_sitter_analyzer/mcp/tools/query_tool.py,sha256=BgkfLYGcRpRk7cNbhD1rOSnSvoZv2H9nPqnwX3DpXQs,17011
+tree_sitter_analyzer/mcp/tools/query_tool.py,sha256=3_TVIfkkZSJo0WNBsiTnctYlq59OVgZYI4IMX2-zsuA,17056
 tree_sitter_analyzer/mcp/tools/read_partial_tool.py,sha256=lC3Zigp3_v8RU_fi5Fz0O_idjP6z_AmgoqVQOethL3I,18493
-tree_sitter_analyzer/mcp/tools/search_content_tool.py,sha256=wGYjP5OZqqcKnLwF5sdpH3xMuUaxJmwYWU6Rg3R7CAw,32463
-tree_sitter_analyzer/mcp/tools/table_format_tool.py,sha256=pL0QAr1aINaTYqGKcutuENEwfvy60Cfcl9AVk5sG2VU,22559
+tree_sitter_analyzer/mcp/tools/search_content_tool.py,sha256=t-ui0KA78vKqIA5VCD_ep2dl0wexkRgqx9dvYvedies,32905
+tree_sitter_analyzer/mcp/tools/table_format_tool.py,sha256=lbE2GQKllsV0vGyhmX5wMPhGn9BT0FoRMV17FcE0FWo,22604
 tree_sitter_analyzer/mcp/tools/universal_analyze_tool.py,sha256=-zZnqN9WcoyRTKM_16ADH859LSebzi34BGYwQL2zCOs,25084
 tree_sitter_analyzer/mcp/utils/__init__.py,sha256=TgTTKsRJAqF95g1fAp5SR_zQVDkImpc_5R0Dw529UUw,3126
 tree_sitter_analyzer/mcp/utils/error_handler.py,sha256=msrQHX67K3vhJsEc3OPRz5mmWU_yoHz55Lnxy0IZuy4,18404
-tree_sitter_analyzer/mcp/utils/file_output_manager.py,sha256=4R-evFZgb7KJpxQjgrz3WMPjL4zJhUH_9aaEbMQTCN4,8747
+tree_sitter_analyzer/mcp/utils/file_output_factory.py,sha256=qhLP4p8wfqz0oM19iTlStxak8fu0Aq40OKdPmqkhPBg,7454
+tree_sitter_analyzer/mcp/utils/file_output_manager.py,sha256=_MideWK9KexXHpbEtxXpHyGA2Rp4m3xKVCvtIx4-Y-Q,10829
 tree_sitter_analyzer/mcp/utils/gitignore_detector.py,sha256=_KKd2tIqudG95Pn53wScDr5wZWEijuUA6CFc04J7Ubo,11942
 tree_sitter_analyzer/mcp/utils/path_resolver.py,sha256=77BmbyEuJCuDPNH9POcTOS4tYBorPu-IXFGpBC1DxOk,15006
 tree_sitter_analyzer/mcp/utils/search_cache.py,sha256=ZNv84st6PeejDY1B50AKTbItpXs9HS6JrpR-Ozjyc1c,12991
@@ -102,7 +103,7 @@ tree_sitter_analyzer/security/regex_checker.py,sha256=jWK6H8PTPgzbwRPfK_RZ8bBTS6
 tree_sitter_analyzer/security/validator.py,sha256=PJ2CxYANMi7Ot4rPq2sUgfEF0f7EXoS_3mWqEG4Y-8w,21966
 tree_sitter_analyzer/utils/__init__.py,sha256=U2zLA7-80BE7NB9nV5coL2hdS-TPey22U4il9VkPfRA,3747
 tree_sitter_analyzer/utils/tree_sitter_compat.py,sha256=9hvig3RQp_9H-YN1AWjW1Dl8fugYOPF-M8TRb41LMZU,10861
-tree_sitter_analyzer-1.8.2.dist-info/METADATA,sha256=ty5HIz_tOpOkNlGLuVpUyk6aSD6x9mKtvI4k7pu2MiI,48668
-tree_sitter_analyzer-1.8.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-tree_sitter_analyzer-1.8.2.dist-info/entry_points.txt,sha256=TJmEXxAMz3og3VPphTHsuE8tNJxf7GuAPjNHwVhXRnc,972
-tree_sitter_analyzer-1.8.2.dist-info/RECORD,,
+tree_sitter_analyzer-1.8.4.dist-info/METADATA,sha256=WWE_1AkppJ-PZ6PsD5aAa1jDwl7_vyPARYHEWSpduFA,49119
+tree_sitter_analyzer-1.8.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+tree_sitter_analyzer-1.8.4.dist-info/entry_points.txt,sha256=TJmEXxAMz3og3VPphTHsuE8tNJxf7GuAPjNHwVhXRnc,972
+tree_sitter_analyzer-1.8.4.dist-info/RECORD,,