tree-sitter-analyzer 1.7.4__py3-none-any.whl → 1.7.7__py3-none-any.whl

tree_sitter_analyzer/mcp/tools/list_files_tool.py

@@ -181,6 +181,15 @@ class ListFilesTool(BaseMCPTool):
 
     @handle_mcp_errors("list_files")
     async def execute(self, arguments: dict[str, Any]) -> dict[str, Any]:
+        # Check if fd command is available
+        if not fd_rg_utils.check_external_command("fd"):
+            return {
+                "success": False,
+                "error": "fd command not found. Please install fd (https://github.com/sharkdp/fd) to use this tool.",
+                "count": 0,
+                "results": []
+            }
+        
         self.validate_arguments(arguments)
         roots = self._validate_roots(arguments["roots"])  # normalized absolutes
 

tree_sitter_analyzer/mcp/tools/query_tool.py

@@ -113,17 +113,24 @@ class QueryTool(BaseMCPTool):
         if not file_path:
             raise ValueError("file_path is required")
 
+        # Security validation BEFORE path resolution to catch symlinks
+        is_valid, error_msg = self.security_validator.validate_file_path(file_path)
+        if not is_valid:
+            raise ValueError(
+                f"Invalid or unsafe file path: {error_msg or file_path}"
+            )
+
         # Resolve file path to absolute path
         resolved_file_path = self.path_resolver.resolve(file_path)
         logger.info(f"Querying file: {file_path} (resolved to: {resolved_file_path})")
 
-        # Security validation using resolved path
+        # Additional security validation on resolved path
         is_valid, error_msg = self.security_validator.validate_file_path(
             resolved_file_path
         )
         if not is_valid:
             raise ValueError(
-                f"Invalid or unsafe file path: {error_msg or resolved_file_path}"
+                f"Invalid or unsafe resolved path: {error_msg or resolved_file_path}"
             )
 
         # Get query parameters

tree_sitter_analyzer/mcp/tools/read_partial_tool.py

@@ -116,34 +116,70 @@ class ReadPartialTool(BaseMCPTool):
         suppress_output = arguments.get("suppress_output", False)
         output_format = arguments.get("format", "text")
 
+        # Security validation BEFORE path resolution to catch symlinks
+        is_valid, error_msg = self.security_validator.validate_file_path(file_path, self.project_root)
+        if not is_valid:
+            logger.warning(
+                f"Security validation failed for file path: {file_path} - {error_msg}"
+            )
+            return {
+                "success": False,
+                "error": f"Security validation failed: {error_msg}",
+                "file_path": file_path
+            }
+
         # Resolve file path using common path resolver
         resolved_path = self.path_resolver.resolve(file_path)
 
-        # Security validation (validate resolved absolute path when possible)
-        is_valid, error_msg = self.security_validator.validate_file_path(resolved_path)
+        # Additional security validation on resolved path
+        is_valid, error_msg = self.security_validator.validate_file_path(resolved_path, self.project_root)
         if not is_valid:
             logger.warning(
-                f"Security validation failed for file path: {file_path} - {error_msg}"
+                f"Security validation failed for resolved path: {resolved_path} - {error_msg}"
             )
-            raise ValueError(f"Invalid file path: {error_msg}")
+            return {
+                "success": False,
+                "error": f"Security validation failed for resolved path: {error_msg}",
+                "file_path": file_path
+            }
 
         # Validate file exists
         if not Path(resolved_path).exists():
-            raise ValueError("Invalid file path: file does not exist")
+            return {
+                "success": False,
+                "error": "Invalid file path: file does not exist",
+                "file_path": file_path
+            }
 
         # Validate line numbers
         if start_line < 1:
-            raise ValueError("start_line must be >= 1")
+            return {
+                "success": False,
+                "error": "start_line must be >= 1",
+                "file_path": file_path
+            }
 
         if end_line is not None and end_line < start_line:
-            raise ValueError("end_line must be >= start_line")
+            return {
+                "success": False,
+                "error": "end_line must be >= start_line",
+                "file_path": file_path
+            }
 
         # Validate column numbers
         if start_column is not None and start_column < 0:
-            raise ValueError("start_column must be >= 0")
+            return {
+                "success": False,
+                "error": "start_column must be >= 0",
+                "file_path": file_path
+            }
 
         if end_column is not None and end_column < 0:
-            raise ValueError("end_column must be >= 0")
+            return {
+                "success": False,
+                "error": "end_column must be >= 0",
+                "file_path": file_path
+            }
 
         logger.info(
             f"Reading partial content from {file_path}: lines {start_line}-{end_line or 'end'}"
@@ -160,9 +196,19 @@ class ReadPartialTool(BaseMCPTool):
                 )
 
                 if content is None:
-                    raise RuntimeError(
-                        f"Failed to read partial content from file: {file_path}"
-                    )
+                    return {
+                        "success": False,
+                        "error": f"Failed to read partial content from file: {file_path}",
+                        "file_path": file_path
+                    }
+                
+                # Check if content is empty or invalid range
+                if not content or content.strip() == "":
+                    return {
+                        "success": False,
+                        "error": f"Invalid line range or empty content: start_line={start_line}, end_line={end_line}",
+                        "file_path": file_path
+                    }
 
                 # Build result structure compatible with CLI --partial-read format
                 result_data = {
@@ -198,8 +244,14 @@ class ReadPartialTool(BaseMCPTool):
                     f"Successfully read {len(content)} characters from {file_path}"
                 )
 
+                # Calculate lines extracted
+                lines_extracted = len(content.split('\n')) if content else 0
+                if end_line:
+                    lines_extracted = end_line - start_line + 1
+
                 # Build result - conditionally include partial_content_result based on suppress_output
                 result = {
+                    "success": True,
                     "file_path": file_path,
                     "range": {
                         "start_line": start_line,
@@ -208,11 +260,39 @@ class ReadPartialTool(BaseMCPTool):
                         "end_column": end_column,
                     },
                     "content_length": len(content),
+                    "lines_extracted": lines_extracted,
                 }
 
                 # Only include partial_content_result if not suppressed or no output file specified
                 if not suppress_output or not output_file:
-                    result["partial_content_result"] = cli_output
+                    if output_format == "json":
+                        # For JSON format, return structured data with exact line count
+                        lines = content.split('\n') if content else []
+                        
+                        # If end_line is specified, ensure we return exactly the requested number of lines
+                        if end_line and len(lines) > lines_extracted:
+                            lines = lines[:lines_extracted]
+                        elif end_line and len(lines) < lines_extracted:
+                            # Pad with empty lines if needed (shouldn't normally happen)
+                            lines.extend([''] * (lines_extracted - len(lines)))
+                        
+                        result["partial_content_result"] = {
+                            "lines": lines,
+                            "metadata": {
+                                "file_path": file_path,
+                                "range": {
+                                    "start_line": start_line,
+                                    "end_line": end_line,
+                                    "start_column": start_column,
+                                    "end_column": end_column,
+                                },
+                                "content_length": len(content),
+                                "lines_count": len(lines)
+                            }
+                        }
+                    else:
+                        # For text/raw format, return CLI-compatible string
+                        result["partial_content_result"] = cli_output
 
                 # Handle file output if requested
                 if output_file:
@@ -254,7 +334,11 @@ class ReadPartialTool(BaseMCPTool):
 
         except Exception as e:
             logger.error(f"Error reading partial content from {file_path}: {e}")
-            raise
+            return {
+                "success": False,
+                "error": str(e),
+                "file_path": file_path
+            }
 
     def _read_file_partial(
         self,

tree_sitter_analyzer/mcp/tools/search_content_tool.py

@@ -289,6 +289,15 @@ class SearchContentTool(BaseMCPTool):
 
     @handle_mcp_errors("search_content")
     async def execute(self, arguments: dict[str, Any]) -> dict[str, Any] | int:
+        # Check if rg command is available
+        if not fd_rg_utils.check_external_command("rg"):
+            return {
+                "success": False,
+                "error": "rg (ripgrep) command not found. Please install ripgrep (https://github.com/BurntSushi/ripgrep) to use this tool.",
+                "count": 0,
+                "results": []
+            }
+        
         self.validate_arguments(arguments)
 
         roots = arguments.get("roots")

tree_sitter_analyzer/mcp/tools/table_format_tool.py

@@ -242,6 +242,7 @@ class TableFormatTool(BaseMCPTool):
             package_info = {"name": packages[0].name}
 
         return {
+            "success": True,
             "file_path": result.file_path,
             "language": result.language,
             "package": package_info,
@@ -378,18 +379,26 @@ class TableFormatTool(BaseMCPTool):
             output_file = args.get("output_file")
             suppress_output = args.get("suppress_output", False)
 
+            # Security validation BEFORE path resolution to catch symlinks
+            is_valid, error_msg = self.security_validator.validate_file_path(file_path)
+            if not is_valid:
+                self.logger.warning(
+                    f"Security validation failed for file path: {file_path} - {error_msg}"
+                )
+                raise ValueError(f"Invalid file path: {error_msg}")
+
             # Resolve file path using common path resolver
             resolved_path = self.path_resolver.resolve(file_path)
 
-            # Security validation
+            # Additional security validation on resolved path
             is_valid, error_msg = self.security_validator.validate_file_path(
                 resolved_path
             )
             if not is_valid:
                 self.logger.warning(
-                    f"Security validation failed for file path: {file_path} - {error_msg}"
+                    f"Security validation failed for resolved path: {resolved_path} - {error_msg}"
                 )
-                raise ValueError(f"Invalid file path: {error_msg}")
+                raise ValueError(f"Invalid resolved path: {error_msg}")
 
             # Sanitize format_type input
             if format_type:
@@ -470,6 +479,7 @@ class TableFormatTool(BaseMCPTool):
 
                 # Build result - conditionally include table_output based on suppress_output
                 result = {
+                    "success": True,
                     "format_type": format_type,
                     "file_path": file_path,
                     "language": language,

tree_sitter_analyzer/security/validator.py

@@ -100,12 +100,13 @@ class SecurityValidator:
 
             # Layer 4: Absolute path check (cross-platform)
             if Path(file_path).is_absolute() or file_path.startswith(("/", "\\")):
+                log_debug(f"Processing absolute path: {file_path}")
                 # If project boundaries are configured, enforce them strictly
                 if self.boundary_manager and self.boundary_manager.project_root:
                     if not self.boundary_manager.is_within_project(file_path):
                         return False, "Absolute path must be within project directory"
-                    # Within project
-                    return True, ""
+                    # Within project - continue with symlink checks
+                    log_debug("Absolute path is within project, continuing with symlink checks")
                 else:
                     # In test/dev contexts without project boundaries, allow absolute
                     # paths under system temp folder only (safe sandbox)
@@ -113,12 +114,13 @@ class SecurityValidator:
 
                     temp_dir = Path(tempfile.gettempdir()).resolve()
                     real_path = Path(file_path).resolve()
+                    log_debug(f"Checking if {real_path} is under temp dir {temp_dir}")
                     try:
                         real_path.relative_to(temp_dir)
-                        return True, ""
+                        log_debug("Path is under temp directory, continuing with symlink checks")
+                        # Don't return here - continue with symlink checks
                     except ValueError:
-                        pass
-                    return False, "Absolute file paths are not allowed"
+                        return False, "Absolute file paths are not allowed"
 
             # Layer 5: Path normalization and traversal check
             norm_path = str(Path(file_path))
@@ -136,12 +138,69 @@ class SecurityValidator:
                         "Access denied. File path must be within project directory",
                     )
 
-            # Layer 7: Symbolic link check (if file exists)
+            # Layer 7: Symbolic link and junction check (check both original and resolved paths)
+            # First check the original file_path directly for symlinks and junctions
+            try:
+                original_path = Path(file_path)
+                log_debug(f"Checking symlink status for original path: {original_path}")
+                # Check for symlinks even if the file doesn't exist yet (broken symlinks)
+                is_symlink = original_path.is_symlink()
+                log_debug(f"original_path.is_symlink() = {is_symlink}")
+                if is_symlink:
+                    log_warning(f"Symbolic link detected in original path: {original_path}")
+                    return False, "Symbolic links are not allowed"
+                
+                # Additional check for Windows junctions and reparse points (only if exists)
+                if original_path.exists() and self._is_junction_or_reparse_point(original_path):
+                    log_warning(f"Junction or reparse point detected in original path: {original_path}")
+                    return False, "Junctions and reparse points are not allowed"
+                    
+            except (OSError, PermissionError) as e:
+                # If we can't check symlink status, continue with other checks
+                log_debug(f"Exception checking symlink status: {e}")
+                pass
+            
+            # Then check the full path (base_path + norm_path) if base_path is provided
             if base_path:
                 full_path = Path(base_path) / norm_path
-                if full_path.exists() and full_path.is_symlink():
-                    log_warning(f"Symbolic link detected: {full_path}")
-                    return False, "Symbolic links are not allowed"
+                
+                # Check if the full path is a symlink or junction
+                try:
+                    # Check for symlinks even if the file doesn't exist yet (broken symlinks)
+                    if full_path.is_symlink():
+                        log_warning(f"Symbolic link detected: {full_path}")
+                        return False, "Symbolic links are not allowed"
+                    
+                    # Additional check for Windows junctions and reparse points (only if exists)
+                    if full_path.exists() and self._is_junction_or_reparse_point(full_path):
+                        log_warning(f"Junction or reparse point detected: {full_path}")
+                        return False, "Junctions and reparse points are not allowed"
+                        
+                except (OSError, PermissionError):
+                    # If we can't check symlink status due to permissions, be cautious
+                    log_warning(f"Cannot verify symlink status for: {full_path}")
+                    pass
+                
+                # Check parent directories for junctions (Windows-specific security measure)
+                try:
+                    if self._has_junction_in_path(full_path):
+                        log_warning(f"Junction detected in path hierarchy: {full_path}")
+                        return False, "Paths containing junctions are not allowed"
+                except (OSError, PermissionError):
+                    # If we can't check parent directories, continue
+                    pass
+            else:
+                # For absolute paths or when no base_path is provided, use original_path
+                full_path = original_path
+                
+                # Check parent directories for junctions
+                try:
+                    if self._has_junction_in_path(full_path):
+                        log_warning(f"Junction detected in path hierarchy: {full_path}")
+                        return False, "Paths containing junctions are not allowed"
+                except (OSError, PermissionError):
+                    # If we can't check parent directories, continue
+                    pass
 
             log_debug(f"File path validation passed: {file_path}")
             return True, ""
@@ -268,3 +327,103 @@ class SecurityValidator:
         except Exception as e:
             log_warning(f"Glob pattern validation error: {e}")
             return False, f"Validation error: {str(e)}"
+
+    def validate_path(self, path: str, base_path: str | None = None) -> tuple[bool, str]:
+        """
+        Alias for validate_file_path for backward compatibility.
+        
+        Args:
+            path: Path to validate
+            base_path: Optional base path for relative path validation
+            
+        Returns:
+            Tuple of (is_valid, error_message)
+        """
+        return self.validate_file_path(path, base_path)
+
+    def is_safe_path(self, path: str, base_path: str | None = None) -> bool:
+        """
+        Check if a path is safe (backward compatibility method).
+        
+        Args:
+            path: Path to check
+            base_path: Optional base path for relative path validation
+            
+        Returns:
+            True if path is safe, False otherwise
+        """
+        is_valid, _ = self.validate_file_path(path, base_path)
+        return is_valid
+
+    def _is_junction_or_reparse_point(self, path: Path) -> bool:
+        """
+        Check if a path is a Windows junction or reparse point.
+        
+        Args:
+            path: Path to check
+            
+        Returns:
+            True if the path is a junction or reparse point
+        """
+        try:
+            import platform
+            if platform.system() != "Windows":
+                return False
+                
+            # On Windows, check for reparse points using stat
+            import stat
+            if path.exists():
+                path_stat = path.stat()
+                # Check if it has the reparse point attribute
+                if hasattr(stat, 'FILE_ATTRIBUTE_REPARSE_POINT'):
+                    return bool(path_stat.st_file_attributes & stat.FILE_ATTRIBUTE_REPARSE_POINT)
+                
+            # Alternative method using Windows API
+            try:
+                import ctypes
+                from ctypes import wintypes
+                
+                # GetFileAttributesW function
+                _GetFileAttributesW = ctypes.windll.kernel32.GetFileAttributesW
+                _GetFileAttributesW.argtypes = [wintypes.LPCWSTR]
+                _GetFileAttributesW.restype = wintypes.DWORD
+                
+                FILE_ATTRIBUTE_REPARSE_POINT = 0x400
+                INVALID_FILE_ATTRIBUTES = 0xFFFFFFFF
+                
+                attributes = _GetFileAttributesW(str(path))
+                if attributes != INVALID_FILE_ATTRIBUTES:
+                    return bool(attributes & FILE_ATTRIBUTE_REPARSE_POINT)
+                    
+            except (ImportError, AttributeError, OSError):
+                pass
+                
+        except Exception:
+            # If any error occurs, assume it's not a junction for safety
+            pass
+            
+        return False
+
+    def _has_junction_in_path(self, path: Path) -> bool:
+        """
+        Check if any parent directory in the path is a junction.
+        
+        Args:
+            path: Path to check
+            
+        Returns:
+            True if any parent directory is a junction
+        """
+        try:
+            current_path = path.resolve() if path.exists() else path
+            
+            # Check each parent directory
+            for parent in current_path.parents:
+                if self._is_junction_or_reparse_point(parent):
+                    return True
+                    
+        except Exception:
+            # If any error occurs, assume no junctions for safety
+            pass
+            
+        return False

{tree_sitter_analyzer-1.7.4.dist-info → tree_sitter_analyzer-1.7.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.7.4
+Version: 1.7.7
 Summary: Extensible multi-language code analyzer framework using Tree-sitter with dynamic plugin architecture
 Project-URL: Homepage, https://github.com/aimasteracc/tree-sitter-analyzer
 Project-URL: Documentation, https://github.com/aimasteracc/tree-sitter-analyzer#readme
@@ -34,6 +34,7 @@ Requires-Python: >=3.10
 Requires-Dist: cachetools>=5.0.0
 Requires-Dist: chardet>=5.0.0
 Requires-Dist: mcp>=1.12.3
+Requires-Dist: psutil>=5.9.8
 Requires-Dist: tree-sitter-cpp<0.25.0,>=0.23.4
 Requires-Dist: tree-sitter-java<0.25.0,>=0.23.5
 Requires-Dist: tree-sitter-javascript<0.25.0,>=0.23.1
@@ -123,6 +124,21 @@ Requires-Dist: tree-sitter-typescript<0.25.0,>=0.20.0; extra == 'full'
 Requires-Dist: types-psutil>=5.9.0; extra == 'full'
 Provides-Extra: go
 Requires-Dist: tree-sitter-go<0.25.0,>=0.20.0; extra == 'go'
+Provides-Extra: integration
+Requires-Dist: anyio>=4.0.0; extra == 'integration'
+Requires-Dist: mcp>=1.12.2; extra == 'integration'
+Requires-Dist: memory-profiler>=0.61.0; extra == 'integration'
+Requires-Dist: psutil>=5.9.8; extra == 'integration'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'integration'
+Requires-Dist: pytest-benchmark>=4.0.0; extra == 'integration'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'integration'
+Requires-Dist: pytest-mock>=3.14.1; extra == 'integration'
+Requires-Dist: pytest>=8.4.1; extra == 'integration'
+Requires-Dist: tree-sitter-java>=0.23.5; extra == 'integration'
+Requires-Dist: tree-sitter-javascript>=0.23.1; extra == 'integration'
+Requires-Dist: tree-sitter-markdown>=0.3.1; extra == 'integration'
+Requires-Dist: tree-sitter-python>=0.23.0; extra == 'integration'
+Requires-Dist: tree-sitter-typescript>=0.20.0; extra == 'integration'
 Provides-Extra: java
 Requires-Dist: tree-sitter-java<0.25.0,>=0.23.5; extra == 'java'
 Provides-Extra: javascript
@@ -171,11 +187,12 @@ 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-2934%20passed-brightgreen.svg)](#quality-assurance)
-[![Coverage](https://img.shields.io/badge/coverage-80.09%25-green.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-3088%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.7.4-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.7.5-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)
 
 ## 🚀 Enterprise-Grade Code Analysis Tool for the AI Era
@@ -225,8 +242,8 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 | **Go** | Basic Support | Basic syntax parsing |
 
 ### 🏆 Production Ready
-- **2,934 Tests** - 100% pass rate, enterprise-grade quality assurance
-- **80.09% Coverage** - Comprehensive test coverage
+- **3,088 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
 
@@ -736,13 +753,13 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **2,934 tests** - 100% pass rate ✅
-- **80.09% code coverage** - Comprehensive test suite
+- **3,088 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.7.4)
-- ✅ **📊 Enhanced Quality Metrics** - Test count increased to 2934 (up from 2831), coverage improved to 80.09%
+### ⚡ Latest Quality Achievements (v1.7.5)
+- ✅ **📊 Enhanced Quality Metrics** - Test count increased to 3,088 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
@@ -772,19 +789,15 @@ uv run pytest tests/test_mcp_server_initialization.py -v
 
 ### 📈 Test Coverage Details
 
-| Module Category | Module Name | Coverage | Quality Level | Main Features |
-|------------------|-------------|-----------|---------------|---------------|
-| **🔧 Core Modules** | Language Detector | 98.41% | Excellent | Automatic programming language recognition |
-| | CLI Main Entry | 94.36% | Excellent | Command line interface |
-| | Query Filter System | 96.06% | Excellent | Code querying and filtering |
-| | Query Service | 86.25% | Good | Query execution engine |
-| | MCP Error Handling | 82.76% | Good | AI assistant integration error handling |
-| **🌍 Language Plugins** | Java Plugin | 80.30% | Excellent | Complete enterprise-grade support |
-| | JavaScript Plugin | 76.74% | Good | Modern ES6+ feature support |
-| | Python Plugin | 82.84% | Excellent | Complete type annotation support |
-| **🤖 MCP Tools** | File Search Tool | 88.77% | Excellent | fd/ripgrep integration |
-| | Content Search Tool | 92.70% | Excellent | Regular expression search |
-| | Combined Search Tool | 91.57% | Excellent | Two-stage search |
+The project maintains high-quality test coverage. For detailed module coverage information, please visit:
+
+[![Coverage Details](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer/branch/main/graph/badge.svg)](https://codecov.io/gh/aimasteracc/tree-sitter-analyzer)
+
+**Click the badge above to view:**
+- 📊 **Module-by-Module Coverage** - Detailed coverage statistics for each module
+- 📈 **Coverage Trends** - Historical coverage change trends
+- 🔍 **Uncovered Code Lines** - Specific locations of untested code
+- 📋 **Detailed Reports** - Complete coverage analysis reports
 
 ### ✅ Documentation Verification Status
 
@@ -797,7 +810,7 @@ uv run pytest tests/test_mcp_server_initialization.py -v
 **Verification environment:**
 - Operating systems: Windows 10, macOS, Linux
 - Python version: 3.10+
-- Project version: tree-sitter-analyzer v1.7.4
+- Project version: tree-sitter-analyzer v1.7.5
 - Test files: BigService.java (1419 lines), sample.py (256 lines), MultiClass.java (54 lines)
 
 ---
@@ -805,26 +818,22 @@ uv run pytest tests/test_mcp_server_initialization.py -v
 ## 9. 📚 Documentation & Support
 
 ### 📖 Complete Documentation
-- **[User MCP Setup Guide](MCP_SETUP_USERS.md)** - Simple setup guide
-- **[Developer MCP Setup Guide](MCP_SETUP_DEVELOPERS.md)** - Local development setup
-- **[Project Root Configuration](PROJECT_ROOT_CONFIG.md)** - Complete configuration reference
-- **[API Documentation](docs/api.md)** - Detailed API reference
-- **[Contributing Guide](CONTRIBUTING.md)** - How to contribute code
-- **[Onboarding & Training Guide](training/README.md)** - System onboarding materials for new members/maintainers
+This project provides complete documentation support, including:
+
+- **Quick Start Guide** - See the [Quick Start](#3--quick-start) section of this README
+- **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
 
 ### 🤖 AI Collaboration Support
 This project supports AI-assisted development with professional quality control:
 
 ```bash
-# AI system pre-generation checks
+# AI system code generation pre-checks
 uv run python check_quality.py --new-code-only
 uv run python llm_code_checker.py --check-all
 ```
 
-📖 **Detailed guides**:
-- [AI Collaboration Guide](AI_COLLABORATION_GUIDE.md)
-- [LLM Coding Guidelines](LLM_CODING_GUIDELINES.md)
-
 ### 💝 Sponsors & Acknowledgments
 
 **[@o93](https://github.com/o93)** - *Lead Sponsor & Supporter*