tree-sitter-analyzer 1.7.1__py3-none-any.whl → 1.7.2__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.7.1"
+__version__ = "1.7.2"
 __author__ = "aisheng.yu"
 __email__ = "aimasteracc@gmail.com"
 

tree_sitter_analyzer/mcp/tools/find_and_grep_tool.py

@@ -13,6 +13,7 @@ import time
 from typing import Any
 
 from ..utils.error_handler import handle_mcp_errors
+from ..utils.file_output_manager import FileOutputManager
 from ..utils.gitignore_detector import get_default_detector
 from . import fd_rg_utils
 from .base_tool import BaseMCPTool
@@ -23,6 +24,11 @@ logger = logging.getLogger(__name__)
 class FindAndGrepTool(BaseMCPTool):
     """MCP tool that composes fd and ripgrep with safety limits and metadata."""
 
+    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)
+
     def get_tool_definition(self) -> dict[str, Any]:
         return {
             "name": "find_and_grep",
@@ -191,6 +197,15 @@ class FindAndGrepTool(BaseMCPTool):
                         "default": False,
                         "description": "Return only the total match count as a number. Most token-efficient option for count queries. Takes priority over all other formats",
                     },
+                    "output_file": {
+                        "type": "string",
+                        "description": "Optional filename to save output to file (extension auto-detected based on content)",
+                    },
+                    "suppress_output": {
+                        "type": "boolean",
+                        "description": "When true and output_file is specified, suppress detailed output in response to save tokens",
+                        "default": False,
+                    },
                 },
                 "required": ["roots", "query"],
                 "additionalProperties": False,
@@ -373,11 +388,7 @@ class FindAndGrepTool(BaseMCPTool):
             context_before=arguments.get("context_before"),
             context_after=arguments.get("context_after"),
             encoding=arguments.get("encoding"),
-            max_count=fd_rg_utils.clamp_int(
-                arguments.get("max_count"),
-                fd_rg_utils.DEFAULT_RESULTS_LIMIT,
-                fd_rg_utils.MAX_RESULTS_HARD_CAP,
-            ),
+            max_count=arguments.get("max_count"),
             timeout_ms=arguments.get("timeout_ms"),
             roots=rg_roots,
             files_from=None,
@@ -427,9 +438,18 @@ class FindAndGrepTool(BaseMCPTool):
         else:
             # Parse full match details
             matches = fd_rg_utils.parse_rg_json_lines_to_matches(rg_out)
-            truncated_rg = len(matches) >= fd_rg_utils.MAX_RESULTS_HARD_CAP
-            if truncated_rg:
-                matches = matches[: fd_rg_utils.MAX_RESULTS_HARD_CAP]
+            
+            # Apply user-specified max_count limit if provided
+            # Note: ripgrep's -m option limits matches per file, not total matches
+            # So we need to apply the total limit here in post-processing
+            user_max_count = arguments.get("max_count")
+            if user_max_count is not None and len(matches) > user_max_count:
+                matches = matches[:user_max_count]
+                truncated_rg = True
+            else:
+                truncated_rg = len(matches) >= fd_rg_utils.MAX_RESULTS_HARD_CAP
+                if truncated_rg:
+                    matches = matches[: fd_rg_utils.MAX_RESULTS_HARD_CAP]
 
             # Apply path optimization if requested
             optimize_paths = arguments.get("optimize_paths", False)
@@ -452,12 +472,55 @@ class FindAndGrepTool(BaseMCPTool):
                     "fd_elapsed_ms": fd_elapsed_ms,
                     "rg_elapsed_ms": rg_elapsed_ms,
                 }
+
+                # Handle output suppression and file output for grouped results
+                output_file = arguments.get("output_file")
+                suppress_output = arguments.get("suppress_output", False)
+
+                # Handle file output if requested
+                if output_file:
+                    try:
+                        # Save full result to file
+                        import json
+                        json_content = json.dumps(grouped_result, indent=2, ensure_ascii=False)
+                        file_path = self.file_output_manager.save_to_file(
+                            content=json_content,
+                            base_name=output_file
+                        )
+                        
+                        # If suppress_output is True, return minimal response
+                        if suppress_output:
+                            minimal_result = {
+                                "success": grouped_result.get("success", True),
+                                "count": grouped_result.get("count", 0),
+                                "output_file": output_file,
+                                "file_saved": f"Results saved to {file_path}"
+                            }
+                            return minimal_result
+                        else:
+                            # Include file info in full response
+                            grouped_result["output_file"] = output_file
+                            grouped_result["file_saved"] = f"Results saved to {file_path}"
+                    except Exception as e:
+                        logger.error(f"Failed to save output to file: {e}")
+                        grouped_result["file_save_error"] = str(e)
+                        grouped_result["file_saved"] = False
+                elif suppress_output:
+                    # If suppress_output is True but no output_file, remove detailed results
+                    minimal_result = {
+                        "success": grouped_result.get("success", True),
+                        "count": grouped_result.get("count", 0),
+                        "summary": grouped_result.get("summary", {}),
+                        "meta": grouped_result.get("meta", {})
+                    }
+                    return minimal_result
+
                 return grouped_result
 
             # Check if summary_only mode is requested
             if arguments.get("summary_only", False):
                 summary = fd_rg_utils.summarize_search_results(matches)
-                return {
+                result = {
                     "success": True,
                     "summary_only": True,
                     "summary": summary,
@@ -468,10 +531,53 @@ class FindAndGrepTool(BaseMCPTool):
                         "rg_elapsed_ms": rg_elapsed_ms,
                     },
                 }
+
+                # Handle output suppression and file output for summary results
+                output_file = arguments.get("output_file")
+                suppress_output = arguments.get("suppress_output", False)
+
+                # Handle file output if requested
+                if output_file:
+                    try:
+                        # Save full result to file
+                        import json
+                        json_content = json.dumps(result, indent=2, ensure_ascii=False)
+                        file_path = self.file_output_manager.save_to_file(
+                            content=json_content,
+                            base_name=output_file
+                        )
+                        
+                        # If suppress_output is True, return minimal response
+                        if suppress_output:
+                            minimal_result = {
+                                "success": result.get("success", True),
+                                "count": len(matches),
+                                "output_file": output_file,
+                                "file_saved": f"Results saved to {file_path}"
+                            }
+                            return minimal_result
+                        else:
+                            # Include file info in full response
+                            result["output_file"] = output_file
+                            result["file_saved"] = f"Results saved to {file_path}"
+                    except Exception as e:
+                        logger.error(f"Failed to save output to file: {e}")
+                        result["file_save_error"] = str(e)
+                        result["file_saved"] = False
+                elif suppress_output:
+                    # If suppress_output is True but no output_file, remove detailed results
+                    minimal_result = {
+                        "success": result.get("success", True),
+                        "count": len(matches),
+                        "summary": result.get("summary", {}),
+                        "meta": result.get("meta", {})
+                    }
+                    return minimal_result
+
+                return result
             else:
-                return {
+                result = {
                     "success": True,
-                    "results": matches,
                     "count": len(matches),
                     "meta": {
                         "searched_file_count": searched_file_count,
@@ -480,3 +586,70 @@ class FindAndGrepTool(BaseMCPTool):
                         "rg_elapsed_ms": rg_elapsed_ms,
                     },
                 }
+
+                # Handle output suppression and file output
+                output_file = arguments.get("output_file")
+                suppress_output = arguments.get("suppress_output", False)
+
+                # Add results to response unless suppressed
+                if not suppress_output or not output_file:
+                    result["results"] = matches
+
+                # Handle file output if requested
+                if output_file:
+                    try:
+                        # Create detailed output for file
+                        file_content = {
+                            "success": True,
+                            "results": matches,
+                            "count": len(matches),
+                            "files": fd_rg_utils.group_matches_by_file(matches)["files"] if matches else [],
+                            "summary": fd_rg_utils.summarize_search_results(matches),
+                            "meta": result["meta"]
+                        }
+
+                        # Convert to JSON for file output
+                        # Save full result to file using FileOutputManager
+                        import json
+                        json_content = json.dumps(file_content, indent=2, ensure_ascii=False)
+                        file_path = self.file_output_manager.save_to_file(
+                            content=json_content,
+                            base_name=output_file
+                        )
+                        
+                        # Check if suppress_output is enabled
+                        suppress_output = arguments.get("suppress_output", False)
+                        if suppress_output:
+                            # Return minimal response to save tokens
+                            minimal_result = {
+                                "success": result.get("success", True),
+                                "count": result.get("count", 0),
+                                "output_file": output_file,
+                                "file_saved": f"Results saved to {file_path}"
+                            }
+                            return minimal_result
+                        else:
+                            # Include file info in full response
+                            result["output_file"] = output_file
+                            result["file_saved"] = f"Results saved to {file_path}"
+
+                        logger.info(f"Search results saved to: {file_path}")
+
+                    except Exception as e:
+                        logger.error(f"Failed to save output to file: {e}")
+                        result["file_save_error"] = str(e)
+                        result["file_saved"] = False
+                else:
+                    # Handle suppress_output without file output
+                    suppress_output = arguments.get("suppress_output", False)
+                    if suppress_output:
+                        # Return minimal response without detailed match results
+                        minimal_result = {
+                            "success": result.get("success", True),
+                            "count": result.get("count", 0),
+                            "summary": result.get("summary", {}),
+                            "meta": result.get("meta", {})
+                        }
+                        return minimal_result
+
+                return result

tree_sitter_analyzer/mcp/tools/list_files_tool.py

@@ -13,6 +13,7 @@ from pathlib import Path
 from typing import Any
 
 from ..utils.error_handler import handle_mcp_errors
+from ..utils.file_output_manager import FileOutputManager
 from ..utils.gitignore_detector import get_default_detector
 from . import fd_rg_utils
 from .base_tool import BaseMCPTool
@@ -110,6 +111,15 @@ class ListFilesTool(BaseMCPTool):
                         "default": False,
                         "description": "Return only the total count of matching files instead of file details. Useful for quick statistics",
                     },
+                    "output_file": {
+                        "type": "string",
+                        "description": "Optional filename to save output to file (extension auto-detected based on content)"
+                    },
+                    "suppress_output": {
+                        "type": "boolean",
+                        "description": "When true and output_file is specified, suppress detailed output in response to save tokens",
+                        "default": False
+                    },
                 },
                 "required": ["roots"],
                 "additionalProperties": False,
@@ -243,7 +253,7 @@ class ListFilesTool(BaseMCPTool):
             else:
                 truncated = False
 
-            return {
+            result = {
                 "success": True,
                 "count_only": True,
                 "total_count": total_count,
@@ -251,6 +261,52 @@ class ListFilesTool(BaseMCPTool):
                 "elapsed_ms": elapsed_ms,
             }
 
+            # Handle file output for count_only mode
+            output_file = arguments.get("output_file")
+            suppress_output = arguments.get("suppress_output", False)
+            
+            if output_file:
+                file_manager = FileOutputManager(self.project_root)
+                file_content = {
+                    "count_only": True,
+                    "total_count": total_count,
+                    "truncated": truncated,
+                    "elapsed_ms": elapsed_ms,
+                    "query_info": {
+                        "roots": arguments.get("roots", []),
+                        "pattern": arguments.get("pattern"),
+                        "glob": arguments.get("glob", False),
+                        "types": arguments.get("types"),
+                        "extensions": arguments.get("extensions"),
+                        "exclude": arguments.get("exclude"),
+                        "limit": limit,
+                    }
+                }
+                
+                try:
+                    import json
+                    json_content = json.dumps(file_content, indent=2, ensure_ascii=False)
+                    saved_path = file_manager.save_to_file(
+                        content=json_content,
+                        base_name=output_file
+                    )
+                    result["output_file"] = saved_path
+                    
+                    if suppress_output:
+                        # Return minimal response to save tokens
+                        return {
+                            "success": True,
+                            "count_only": True,
+                            "total_count": total_count,
+                            "output_file": saved_path,
+                            "message": f"Count results saved to {saved_path}"
+                        }
+                except Exception as e:
+                    logger.warning(f"Failed to save output file: {e}")
+                    result["output_file_error"] = str(e)
+
+            return result
+
         # Truncate defensively even if fd didn't
         truncated = False
         if len(lines) > fd_rg_utils.MAX_RESULTS_HARD_CAP:
@@ -283,10 +339,64 @@ class ListFilesTool(BaseMCPTool):
             except (OSError, ValueError):  # nosec B112
                 continue
 
-        return {
+        result = {
             "success": True,
             "count": len(results),
             "truncated": truncated,
             "elapsed_ms": elapsed_ms,
             "results": results,
         }
+
+        # Handle file output for detailed results
+        output_file = arguments.get("output_file")
+        suppress_output = arguments.get("suppress_output", False)
+        
+        if output_file:
+            file_manager = FileOutputManager(self.project_root)
+            file_content = {
+                "count": len(results),
+                "truncated": truncated,
+                "elapsed_ms": elapsed_ms,
+                "results": results,
+                "query_info": {
+                    "roots": arguments.get("roots", []),
+                    "pattern": arguments.get("pattern"),
+                    "glob": arguments.get("glob", False),
+                    "types": arguments.get("types"),
+                    "extensions": arguments.get("extensions"),
+                    "exclude": arguments.get("exclude"),
+                    "depth": arguments.get("depth"),
+                    "follow_symlinks": arguments.get("follow_symlinks", False),
+                    "hidden": arguments.get("hidden", False),
+                    "no_ignore": no_ignore,
+                    "size": arguments.get("size"),
+                    "changed_within": arguments.get("changed_within"),
+                    "changed_before": arguments.get("changed_before"),
+                    "full_path_match": arguments.get("full_path_match", False),
+                    "absolute": arguments.get("absolute", True),
+                    "limit": limit,
+                }
+            }
+            
+            try:
+                import json
+                json_content = json.dumps(file_content, indent=2, ensure_ascii=False)
+                saved_path = file_manager.save_to_file(
+                    content=json_content,
+                    base_name=output_file
+                )
+                result["output_file"] = saved_path
+                
+                if suppress_output:
+                    # Return minimal response to save tokens
+                    return {
+                        "success": True,
+                        "count": len(results),
+                        "output_file": saved_path,
+                        "message": f"File list results saved to {saved_path}"
+                    }
+            except Exception as e:
+                logger.warning(f"Failed to save output file: {e}")
+                result["output_file_error"] = str(e)
+
+        return result

tree_sitter_analyzer/mcp/tools/search_content_tool.py

@@ -13,6 +13,7 @@ from pathlib import Path
 from typing import Any
 
 from ..utils.error_handler import handle_mcp_errors
+from ..utils.file_output_manager import FileOutputManager
 from ..utils.gitignore_detector import get_default_detector
 from ..utils.search_cache import get_default_cache
 from . import fd_rg_utils
@@ -36,6 +37,7 @@ class SearchContentTool(BaseMCPTool):
         """
         super().__init__(project_root)
         self.cache = get_default_cache() if enable_cache else None
+        self.file_output_manager = FileOutputManager(project_root)
 
     def get_tool_definition(self) -> dict[str, Any]:
         return {
@@ -153,6 +155,15 @@ class SearchContentTool(BaseMCPTool):
                         "default": False,
                         "description": "Return only the total match count as a number. Most token-efficient option for count queries. Takes priority over all other formats",
                     },
+                    "output_file": {
+                        "type": "string",
+                        "description": "Optional filename to save output to file (extension auto-detected based on content)",
+                    },
+                    "suppress_output": {
+                        "type": "boolean",
+                        "description": "When true and output_file is specified, suppress detailed output in response to save tokens",
+                        "default": False,
+                    },
                 },
                 "required": ["query"],
                 "anyOf": [
@@ -312,12 +323,18 @@ class SearchContentTool(BaseMCPTool):
                     cached_result["cache_hit"] = True
                 return cached_result
 
-        # Clamp counts to safety limits
-        max_count = fd_rg_utils.clamp_int(
-            arguments.get("max_count"),
-            fd_rg_utils.DEFAULT_RESULTS_LIMIT,
-            fd_rg_utils.DEFAULT_RESULTS_LIMIT,
-        )
+        # Handle max_count parameter properly
+        # If user specifies max_count, use it directly (with reasonable upper limit)
+        # If not specified, use None to let ripgrep return all matches (subject to hard cap later)
+        max_count = arguments.get("max_count")
+        if max_count is not None:
+            # Clamp user-specified max_count to reasonable limits
+            # Use 1 as minimum default, but respect user's small values
+            max_count = fd_rg_utils.clamp_int(
+                max_count,
+                1,  # Minimum default value
+                fd_rg_utils.DEFAULT_RESULTS_LIMIT,  # Upper limit for safety
+            )
         timeout_ms = arguments.get("timeout_ms")
 
         # Note: --files-from is not supported in this ripgrep version
@@ -461,9 +478,18 @@ class SearchContentTool(BaseMCPTool):
 
         # Handle normal mode
         matches = fd_rg_utils.parse_rg_json_lines_to_matches(out)
-        truncated = len(matches) >= fd_rg_utils.MAX_RESULTS_HARD_CAP
-        if truncated:
-            matches = matches[: fd_rg_utils.MAX_RESULTS_HARD_CAP]
+        
+        # Apply user-specified max_count limit if provided
+        # Note: ripgrep's -m option limits matches per file, not total matches
+        # So we need to apply the total limit here in post-processing
+        user_max_count = arguments.get("max_count")
+        if user_max_count is not None and len(matches) > user_max_count:
+            matches = matches[:user_max_count]
+            truncated = True
+        else:
+            truncated = len(matches) >= fd_rg_utils.MAX_RESULTS_HARD_CAP
+            if truncated:
+                matches = matches[: fd_rg_utils.MAX_RESULTS_HARD_CAP]
 
         # Apply path optimization if requested
         optimize_paths = arguments.get("optimize_paths", False)
@@ -475,6 +501,54 @@ class SearchContentTool(BaseMCPTool):
         if group_by_file and matches:
             result = fd_rg_utils.group_matches_by_file(matches)
 
+            # Handle output suppression and file output for grouped results
+            output_file = arguments.get("output_file")
+            suppress_output = arguments.get("suppress_output", False)
+
+            # Handle file output if requested
+            if output_file:
+                try:
+                    # Save full result to file
+                    import json
+                    json_content = json.dumps(result, indent=2, ensure_ascii=False)
+                    file_path = self.file_output_manager.save_to_file(
+                        content=json_content,
+                        base_name=output_file
+                    )
+                    
+                    # If suppress_output is True, return minimal response
+                    if suppress_output:
+                        minimal_result = {
+                            "success": result.get("success", True),
+                            "count": result.get("count", 0),
+                            "output_file": output_file,
+                            "file_saved": f"Results saved to {file_path}"
+                        }
+                        # Cache the full result, not the minimal one
+                        if self.cache and cache_key:
+                            self.cache.set(cache_key, result)
+                        return minimal_result
+                    else:
+                        # Include file info in full response
+                        result["output_file"] = output_file
+                        result["file_saved"] = f"Results saved to {file_path}"
+                except Exception as e:
+                    logger.error(f"Failed to save output to file: {e}")
+                    result["file_save_error"] = str(e)
+                    result["file_saved"] = False
+            elif suppress_output:
+                # If suppress_output is True but no output_file, remove detailed results
+                minimal_result = {
+                    "success": result.get("success", True),
+                    "count": result.get("count", 0),
+                    "summary": result.get("summary", {}),
+                    "meta": result.get("meta", {})
+                }
+                # Cache the full result, not the minimal one
+                if self.cache and cache_key:
+                    self.cache.set(cache_key, result)
+                return minimal_result
+
             # Cache the result
             if self.cache and cache_key:
                 self.cache.set(cache_key, result)
@@ -492,6 +566,54 @@ class SearchContentTool(BaseMCPTool):
                 "summary": summary,
             }
 
+            # Handle output suppression and file output for summary results
+            output_file = arguments.get("output_file")
+            suppress_output = arguments.get("suppress_output", False)
+
+            # Handle file output if requested
+            if output_file:
+                try:
+                    # Save full result to file
+                    import json
+                    json_content = json.dumps(result, indent=2, ensure_ascii=False)
+                    file_path = self.file_output_manager.save_to_file(
+                        content=json_content,
+                        base_name=output_file
+                    )
+                    
+                    # If suppress_output is True, return minimal response
+                    if suppress_output:
+                        minimal_result = {
+                            "success": result.get("success", True),
+                            "count": result.get("count", 0),
+                            "output_file": output_file,
+                            "file_saved": f"Results saved to {file_path}"
+                        }
+                        # Cache the full result, not the minimal one
+                        if self.cache and cache_key:
+                            self.cache.set(cache_key, result)
+                        return minimal_result
+                    else:
+                        # Include file info in full response
+                        result["output_file"] = output_file
+                        result["file_saved"] = f"Results saved to {file_path}"
+                except Exception as e:
+                    logger.error(f"Failed to save output to file: {e}")
+                    result["file_save_error"] = str(e)
+                    result["file_saved"] = False
+            elif suppress_output:
+                # If suppress_output is True but no output_file, remove detailed results
+                minimal_result = {
+                    "success": result.get("success", True),
+                    "count": result.get("count", 0),
+                    "summary": result.get("summary", {}),
+                    "elapsed_ms": result.get("elapsed_ms", 0)
+                }
+                # Cache the full result, not the minimal one
+                if self.cache and cache_key:
+                    self.cache.set(cache_key, result)
+                return minimal_result
+
             # Cache the result
             if self.cache and cache_key:
                 self.cache.set(cache_key, result)
@@ -503,9 +625,87 @@ class SearchContentTool(BaseMCPTool):
             "count": len(matches),
             "truncated": truncated,
             "elapsed_ms": elapsed_ms,
-            "results": matches,
         }
 
+        # Handle output suppression and file output
+        output_file = arguments.get("output_file")
+        suppress_output = arguments.get("suppress_output", False)
+
+        # Always add results to the base result for file saving
+        result["results"] = matches
+
+        # Handle file output if requested
+        if output_file:
+            try:
+                # Create detailed output for file
+                file_content = {
+                    "success": True,
+                    "count": len(matches),
+                    "truncated": truncated,
+                    "elapsed_ms": elapsed_ms,
+                    "results": matches,
+                    "summary": fd_rg_utils.summarize_search_results(matches),
+                    "grouped_by_file": fd_rg_utils.group_matches_by_file(matches)["files"] if matches else []
+                }
+
+                # Convert to JSON for file output
+                import json
+                json_content = json.dumps(file_content, indent=2, ensure_ascii=False)
+
+                # Save to file
+                saved_file_path = self.file_output_manager.save_to_file(
+                    content=json_content,
+                    base_name=output_file
+                )
+
+                result["output_file_path"] = saved_file_path
+                result["file_saved"] = True
+
+                logger.info(f"Search results saved to: {saved_file_path}")
+
+            except Exception as e:
+                logger.error(f"Failed to save output to file: {e}")
+                result["file_save_error"] = str(e)
+                result["file_saved"] = False
+
+        # Handle file output and suppression
+        output_file = arguments.get("output_file")
+        suppress_output = arguments.get("suppress_output", False)
+        
+        if output_file:
+            # Save full result to file
+            import json
+            json_content = json.dumps(result, indent=2, ensure_ascii=False)
+            file_path = self.file_output_manager.save_to_file(
+                content=json_content,
+                base_name=output_file
+            )
+            
+            # If suppress_output is True, return minimal response
+            if suppress_output:
+                minimal_result = {
+                    "success": result.get("success", True),
+                    "count": result.get("count", 0),
+                    "output_file": output_file,
+                    "file_saved": f"Results saved to {file_path}"
+                }
+                # Cache the full result, not the minimal one
+                if self.cache and cache_key:
+                    self.cache.set(cache_key, result)
+                return minimal_result
+            else:
+                # Include file info in full response
+                result["output_file"] = output_file
+                result["file_saved"] = f"Results saved to {file_path}"
+        elif suppress_output:
+            # If suppress_output is True but no output_file, remove results from response
+            result_copy = result.copy()
+            result_copy.pop("results", None)
+            # Cache the full result, not the minimal one
+            if self.cache and cache_key:
+                self.cache.set(cache_key, result)
+            return result_copy
+
         # Cache the result
         if self.cache and cache_key:
             self.cache.set(cache_key, result)

{tree_sitter_analyzer-1.7.1.dist-info → tree_sitter_analyzer-1.7.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.7.1
+Version: 1.7.2
 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
@@ -165,11 +165,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-2662%20passed-brightgreen.svg)](#quality-assurance)
-[![Coverage](https://img.shields.io/badge/coverage-79.16%25-green.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-2675%20passed-brightgreen.svg)](#quality-assurance)
+[![Coverage](https://img.shields.io/badge/coverage-78.85%25-green.svg)](#quality-assurance)
 [![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.1-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.7.2-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
 [![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
@@ -218,8 +218,8 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 | **Go** | Basic Support | Basic syntax parsing |
 
 ### 🏆 Production Ready
-- **2,662 Tests** - 100% pass rate, enterprise-grade quality assurance
-- **79.16% Coverage** - Comprehensive test coverage
+- **2,675 Tests** - 100% pass rate, enterprise-grade quality assurance
+- **78.85% Coverage** - Comprehensive test coverage
 - **Cross-platform Support** - Compatible with Windows, macOS, Linux
 - **Continuous Maintenance** - Active development and community support
 
@@ -585,9 +585,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.7.0 New Feature: suppress_output Function
+### 🆕 v1.7.2 New Feature: File Output Optimization
 
-The newly added `suppress_output` parameter in the `analyze_code_structure` tool is a revolutionary token optimization feature:
+MCP search tools' newly added file output optimization feature is a revolutionary token-saving solution:
+
+- **🎯 File Output Optimization**: `find_and_grep`, `list_files`, and `search_content` tools now include `suppress_output` and `output_file` parameters
+- **🔄 Automatic Format Detection**: Smart file format selection (JSON/Markdown) based on content type
+- **💾 Massive Token Savings**: Response size reduced by up to 99% when saving large search results to files
+- **📚 ROO Rules Documentation**: Added comprehensive tree-sitter-analyzer MCP optimization usage guide
+- **🔧 Backward Compatibility**: Optional feature that doesn't affect existing functionality
+
+### 🆕 v1.7.0 Feature: suppress_output Function
+
+The `suppress_output` parameter in the `analyze_code_structure` tool:
 
 - **Problem solved**: When analysis results are too large, traditional methods return complete table data, consuming massive tokens
 - **Intelligent optimization**: When `suppress_output=true` and `output_file` specified, only basic metadata is returned
@@ -708,16 +718,18 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 ## 8. 🏆 Quality Assurance
 
 ### 📊 Quality Metrics
-- **2,662 tests** - 100% pass rate ✅
-- **79.16% code coverage** - Comprehensive test suite
+- **2,675 tests** - 100% pass rate ✅
+- **78.85% code coverage** - Comprehensive test suite
 - **Zero test failures** - Production ready
 - **Cross-platform support** - Windows, macOS, Linux
 
-### ⚡ Latest Quality Achievements (v1.7.0)
-- ✅ **Token saving feature** - New suppress_output parameter automatically suppresses table output when file output is specified, saving AI token consumption
-- ✅ **Intelligent output control** - Automatically optimizes response size when output_file is specified and suppress_output=true
-- ✅ **Enterprise-grade test coverage** - Comprehensive test suite including complete validation of suppress_output functionality
-- ✅ **MCP tool enhancement** - Complete MCP server tool set supporting advanced file search and content analysis
+### ⚡ Latest Quality Achievements (v1.7.2)
+- ✅ **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
 
@@ -760,7 +772,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.0
+- Project version: tree-sitter-analyzer v1.7.2
 - Test files: BigService.java (1419 lines), sample.py (256 lines), MultiClass.java (54 lines)
 
 ---

{tree_sitter_analyzer-1.7.1.dist-info → tree_sitter_analyzer-1.7.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-tree_sitter_analyzer/__init__.py,sha256=Ef0vV4IRflLl-9sQtumxc31etSQ9V6jofhzbUOHp1zQ,3067
+tree_sitter_analyzer/__init__.py,sha256=kz0kyobXXhmOq8JWuJHjr3MhC9OfOGOJ5CAcq7e_0d4,3067
 tree_sitter_analyzer/__main__.py,sha256=Zl79tpe4UaMu-7yeztc06tgP0CVMRnvGgas4ZQP5SCs,228
 tree_sitter_analyzer/api.py,sha256=jzwID6fJNdhQkJP3D0lzBVPhOnGIN4tyyMtmRYdK9zI,22753
 tree_sitter_analyzer/cli_main.py,sha256=BuaM-L-Jx3G49qvAUOQVsw0wEM-X0UzPaRszRZBist4,10374
@@ -64,11 +64,11 @@ tree_sitter_analyzer/mcp/tools/analyze_scale_tool.py,sha256=JyS9gey2oFoWjzsiiLjw
 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=R1ICH40vkWO3OdKZjxok9ptQZpZ6-tM5SkLHHOC4-BE,17749
-tree_sitter_analyzer/mcp/tools/find_and_grep_tool.py,sha256=G-aExFZUvpJtitmEfYAClsHmQ1p3HqsT4IkOlym9R_o,22100
-tree_sitter_analyzer/mcp/tools/list_files_tool.py,sha256=TA1BRQtb-D5x1pD-IcRJYnP0WnnFfl9q7skI25MOdHk,12873
+tree_sitter_analyzer/mcp/tools/find_and_grep_tool.py,sha256=2Y5V61T4-Y90W38erzIN6D1orlYlkPx9kaoKTfmInEs,31038
+tree_sitter_analyzer/mcp/tools/list_files_tool.py,sha256=JxgLpFgJFk6_9VtlvzOlzWnfYs9yZOPIVwnl10pRoZU,17864
 tree_sitter_analyzer/mcp/tools/query_tool.py,sha256=1xY1ONNY2sIFJxoILlnNzBnwGVgzEF7vVJ2ccqR9auA,10879
 tree_sitter_analyzer/mcp/tools/read_partial_tool.py,sha256=BMAJF205hTIrYTQJG6N1-vVuKSby2CSm9nWzSMMWceI,11339
-tree_sitter_analyzer/mcp/tools/search_content_tool.py,sha256=PDYY_O7T0y4bnC6JNjtL1_TyZcib0EpxnPA6PfKueoQ,22489
+tree_sitter_analyzer/mcp/tools/search_content_tool.py,sha256=2HbHxRzPkddXPgwKrx8ACZMuVF6R9fLZXM_EWILu-l4,31994
 tree_sitter_analyzer/mcp/tools/table_format_tool.py,sha256=VhmrDSKE5WdnoJhWjZc67z5q3qiBMBhNFW9uZ22psU8,21252
 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
@@ -89,7 +89,7 @@ tree_sitter_analyzer/security/__init__.py,sha256=ZTqTt24hsljCpTXAZpJC57L7MU5lJLT
 tree_sitter_analyzer/security/boundary_manager.py,sha256=3eeENRKWtz2pyZHzd8DiVaq8fdeC6s1eVOuBylSmQPg,9347
 tree_sitter_analyzer/security/regex_checker.py,sha256=jWK6H8PTPgzbwRPfK_RZ8bBTS6rtEbgjY5vr3YWjQ_U,9616
 tree_sitter_analyzer/security/validator.py,sha256=yR4qTWEcXpR--bSFwtWvSgY0AzqujOFAqlc1Z7dlTdk,9809
-tree_sitter_analyzer-1.7.1.dist-info/METADATA,sha256=AcTmJrBzB1FGvHkyUK9ic-9bR5HVuEZnExYb69aEBt8,36459
-tree_sitter_analyzer-1.7.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-tree_sitter_analyzer-1.7.1.dist-info/entry_points.txt,sha256=gbMks8mHqDZWyGnawAW2uNU5g-mrD1vLBiIoLvnaJP0,780
-tree_sitter_analyzer-1.7.1.dist-info/RECORD,,
+tree_sitter_analyzer-1.7.2.dist-info/METADATA,sha256=1JDW31p0z4DGtk18wP8h9Z7idPGSQvr9BbS-4wcz0-U,37336
+tree_sitter_analyzer-1.7.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+tree_sitter_analyzer-1.7.2.dist-info/entry_points.txt,sha256=gbMks8mHqDZWyGnawAW2uNU5g-mrD1vLBiIoLvnaJP0,780
+tree_sitter_analyzer-1.7.2.dist-info/RECORD,,