tree-sitter-analyzer 1.2.3__py3-none-any.whl → 1.2.5__py3-none-any.whl

tree_sitter_analyzer/languages/java_plugin.py

@@ -185,16 +185,18 @@ class JavaElementExtractor(ElementExtractor):
         """Fallback import extraction using regex when tree-sitter fails"""
         imports = []
         lines = source_code.split("\n")
-        
+
         for line_num, line in enumerate(lines, 1):
             line = line.strip()
             if line.startswith("import ") and line.endswith(";"):
                 # Extract import statement
                 import_content = line[:-1]  # Remove semicolon
-                
+
                 if "static" in import_content:
                     # Static import
-                    static_match = re.search(r"import\s+static\s+([\w.]+)", import_content)
+                    static_match = re.search(
+                        r"import\s+static\s+([\w.]+)", import_content
+                    )
                     if static_match:
                         import_name = static_match.group(1)
                         if import_content.endswith(".*"):
@@ -202,18 +204,20 @@ class JavaElementExtractor(ElementExtractor):
                             parts = import_name.split(".")
                             if len(parts) > 1:
                                 import_name = ".".join(parts[:-1])
-                        
-                        imports.append(Import(
-                            name=import_name,
-                            start_line=line_num,
-                            end_line=line_num,
-                            raw_text=line,
-                            language="java",
-                            module_name=import_name,
-                            is_static=True,
-                            is_wildcard=import_content.endswith(".*"),
-                            import_statement=import_content,
-                        ))
+
+                        imports.append(
+                            Import(
+                                name=import_name,
+                                start_line=line_num,
+                                end_line=line_num,
+                                raw_text=line,
+                                language="java",
+                                module_name=import_name,
+                                is_static=True,
+                                is_wildcard=import_content.endswith(".*"),
+                                import_statement=import_content,
+                            )
+                        )
                 else:
                     # Normal import
                     normal_match = re.search(r"import\s+([\w.]+)", import_content)
@@ -224,19 +228,21 @@ class JavaElementExtractor(ElementExtractor):
                                 import_name = import_name[:-2]
                             elif import_name.endswith("."):
                                 import_name = import_name[:-1]
-                        
-                        imports.append(Import(
-                            name=import_name,
-                            start_line=line_num,
-                            end_line=line_num,
-                            raw_text=line,
-                            language="java",
-                            module_name=import_name,
-                            is_static=False,
-                            is_wildcard=import_content.endswith(".*"),
-                            import_statement=import_content,
-                        ))
-        
+
+                        imports.append(
+                            Import(
+                                name=import_name,
+                                start_line=line_num,
+                                end_line=line_num,
+                                raw_text=line,
+                                language="java",
+                                module_name=import_name,
+                                is_static=False,
+                                is_wildcard=import_content.endswith(".*"),
+                                import_statement=import_content,
+                            )
+                        )
+
         return imports
 
     def extract_packages(

tree_sitter_analyzer/mcp/server.py

@@ -60,8 +60,11 @@ from ..utils import setup_logger
 from . import MCP_INFO
 from .resources import CodeFileResource, ProjectStatsResource
 from .tools.analyze_scale_tool import AnalyzeScaleTool
+from .tools.find_and_grep_tool import FindAndGrepTool
+from .tools.list_files_tool import ListFilesTool
 from .tools.query_tool import QueryTool
 from .tools.read_partial_tool import ReadPartialTool
+from .tools.search_content_tool import SearchContentTool
 from .tools.table_format_tool import TableFormatTool
 
 # Set up logging
@@ -87,11 +90,15 @@ class TreeSitterAnalyzerMCPServer:
         self.security_validator = SecurityValidator(project_root)
         # Use unified analysis engine instead of deprecated AdvancedAnalyzer
 
-        # Initialize MCP tools with security validation (four core tools)
+        # Initialize MCP tools with security validation (core tools + fd/rg tools)
         self.query_tool = QueryTool(project_root)  # query_code
         self.read_partial_tool = ReadPartialTool(project_root)  # extract_code_section
         self.table_format_tool = TableFormatTool(project_root)  # analyze_code_structure
         self.analyze_scale_tool = AnalyzeScaleTool(project_root)  # check_code_scale
+        # New fd/rg tools
+        self.list_files_tool = ListFilesTool(project_root)  # list_files
+        self.search_content_tool = SearchContentTool(project_root)  # search_content
+        self.find_and_grep_tool = FindAndGrepTool(project_root)  # find_and_grep
 
         # Optional universal tool to satisfy initialization tests
         try:
@@ -466,6 +473,9 @@ class TreeSitterAnalyzerMCPServer:
                     },
                 ),
                 Tool(**self.query_tool.get_tool_definition()),
+                Tool(**self.list_files_tool.get_tool_definition()),
+                Tool(**self.search_content_tool.get_tool_definition()),
+                Tool(**self.find_and_grep_tool.get_tool_definition()),
             ]
 
             logger.info(f"Returning {len(tools)} tools: {[t.name for t in tools]}")
@@ -545,6 +555,15 @@ class TreeSitterAnalyzerMCPServer:
                 elif name == "query_code":
                     result = await self.query_tool.execute(arguments)
 
+                elif name == "list_files":
+                    result = await self.list_files_tool.execute(arguments)
+
+                elif name == "search_content":
+                    result = await self.search_content_tool.execute(arguments)
+
+                elif name == "find_and_grep":
+                    result = await self.find_and_grep_tool.execute(arguments)
+
                 else:
                     raise ValueError(f"Unknown tool: {name}")
 
@@ -653,6 +672,9 @@ class TreeSitterAnalyzerMCPServer:
         self.read_partial_tool.set_project_path(project_path)
         self.table_format_tool.set_project_path(project_path)
         self.analyze_scale_tool.set_project_path(project_path)
+        self.list_files_tool.set_project_path(project_path)
+        self.search_content_tool.set_project_path(project_path)
+        self.find_and_grep_tool.set_project_path(project_path)
 
         # Update universal tool if available
         if hasattr(self, "universal_analyze_tool") and self.universal_analyze_tool:

tree_sitter_analyzer/mcp/tools/fd_rg_utils.py

@@ -0,0 +1,549 @@
+#!/usr/bin/env python3
+"""
+Shared utilities for fd/ripgrep based MCP tools.
+
+This module centralizes subprocess execution, command building, result caps,
+and JSON line parsing for ripgrep.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import os
+import tempfile
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+
+# Safety caps (hard limits)
+MAX_RESULTS_HARD_CAP = 10000
+DEFAULT_RESULTS_LIMIT = 2000
+
+DEFAULT_RG_MAX_FILESIZE = "10M"
+RG_MAX_FILESIZE_HARD_CAP_BYTES = 200 * 1024 * 1024  # 200M
+
+DEFAULT_RG_TIMEOUT_MS = 4000
+RG_TIMEOUT_HARD_CAP_MS = 30000
+
+
+def clamp_int(value: int | None, default_value: int, hard_cap: int) -> int:
+    if value is None:
+        return default_value
+    try:
+        v = int(value)
+    except (TypeError, ValueError):
+        return default_value
+    return max(0, min(v, hard_cap))
+
+
+def parse_size_to_bytes(size_str: str) -> int | None:
+    """Parse ripgrep --max-filesize strings like '10M', '200K' to bytes."""
+    if not size_str:
+        return None
+    s = size_str.strip().upper()
+    try:
+        if s.endswith("K"):
+            return int(float(s[:-1]) * 1024)
+        if s.endswith("M"):
+            return int(float(s[:-1]) * 1024 * 1024)
+        if s.endswith("G"):
+            return int(float(s[:-1]) * 1024 * 1024 * 1024)
+        return int(s)
+    except ValueError:
+        return None
+
+
+async def run_command_capture(
+    cmd: list[str],
+    input_data: bytes | None = None,
+    timeout_ms: int | None = None,
+) -> tuple[int, bytes, bytes]:
+    """Run a subprocess and capture output.
+
+    Returns (returncode, stdout, stderr). On timeout, kills process and returns 124.
+    Separated into a util for easy monkeypatching in tests.
+    """
+    # Create process
+    proc = await asyncio.create_subprocess_exec(
+        *cmd,
+        stdin=asyncio.subprocess.PIPE if input_data is not None else None,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE,
+    )
+
+    # Compute timeout seconds
+    timeout_s: float | None = None
+    if timeout_ms and timeout_ms > 0:
+        timeout_s = timeout_ms / 1000.0
+
+    try:
+        stdout, stderr = await asyncio.wait_for(
+            proc.communicate(input=input_data), timeout=timeout_s
+        )
+        return proc.returncode, stdout, stderr
+    except asyncio.TimeoutError:
+        try:
+            proc.kill()
+        finally:
+            with contextlib.suppress(Exception):
+                await proc.wait()
+        return 124, b"", f"Timeout after {timeout_ms} ms".encode()
+
+
+def build_fd_command(
+    *,
+    pattern: str | None,
+    glob: bool,
+    types: list[str] | None,
+    extensions: list[str] | None,
+    exclude: list[str] | None,
+    depth: int | None,
+    follow_symlinks: bool,
+    hidden: bool,
+    no_ignore: bool,
+    size: list[str] | None,
+    changed_within: str | None,
+    changed_before: str | None,
+    full_path_match: bool,
+    absolute: bool,
+    limit: int | None,
+    roots: list[str],
+) -> list[str]:
+    """Build an fd command with appropriate flags."""
+    cmd: list[str] = ["fd", "--color", "never"]
+    if glob:
+        cmd.append("--glob")
+    if full_path_match:
+        cmd.append("-p")
+    if absolute:
+        cmd.append("-a")
+    if follow_symlinks:
+        cmd.append("-L")
+    if hidden:
+        cmd.append("-H")
+    if no_ignore:
+        cmd.append("-I")
+    if depth is not None:
+        cmd += ["-d", str(depth)]
+    if types:
+        for t in types:
+            cmd += ["-t", str(t)]
+    if extensions:
+        for ext in extensions:
+            if ext.startswith("."):
+                ext = ext[1:]
+            cmd += ["-e", ext]
+    if exclude:
+        for ex in exclude:
+            cmd += ["-E", ex]
+    if size:
+        for s in size:
+            cmd += ["-S", s]
+    if changed_within:
+        cmd += ["--changed-within", str(changed_within)]
+    if changed_before:
+        cmd += ["--changed-before", str(changed_before)]
+    if limit is not None:
+        cmd += ["--max-results", str(limit)]
+
+    # Add search paths using --search-path option for better reliability
+    # This avoids conflicts between pattern and path arguments
+    if roots:
+        for root in roots:
+            cmd += ["--search-path", root]
+
+    # Pattern goes last if specified
+    if pattern:
+        cmd.append(pattern)
+
+    return cmd
+
+
+def normalize_max_filesize(user_value: str | None) -> str:
+    if not user_value:
+        return DEFAULT_RG_MAX_FILESIZE
+    bytes_val = parse_size_to_bytes(user_value)
+    if bytes_val is None:
+        return DEFAULT_RG_MAX_FILESIZE
+    if bytes_val > RG_MAX_FILESIZE_HARD_CAP_BYTES:
+        return "200M"
+    return user_value
+
+
+def build_rg_command(
+    *,
+    query: str,
+    case: str | None,
+    fixed_strings: bool,
+    word: bool,
+    multiline: bool,
+    include_globs: list[str] | None,
+    exclude_globs: list[str] | None,
+    follow_symlinks: bool,
+    hidden: bool,
+    no_ignore: bool,
+    max_filesize: str | None,
+    context_before: int | None,
+    context_after: int | None,
+    encoding: str | None,
+    max_count: int | None,
+    timeout_ms: int | None,
+    roots: list[str] | None,
+    files_from: str | None,
+    count_only_matches: bool = False,
+) -> list[str]:
+    """Build ripgrep command with JSON output and options."""
+    if count_only_matches:
+        # Use --count-matches for count-only mode (no JSON output)
+        cmd: list[str] = [
+            "rg",
+            "--count-matches",
+            "--no-heading",
+            "--color",
+            "never",
+        ]
+    else:
+        # Use --json for full match details
+        cmd: list[str] = [
+            "rg",
+            "--json",
+            "--no-heading",
+            "--color",
+            "never",
+        ]
+
+    # Case sensitivity
+    if case == "smart":
+        cmd.append("-S")
+    elif case == "insensitive":
+        cmd.append("-i")
+    elif case == "sensitive":
+        cmd.append("-s")
+
+    if fixed_strings:
+        cmd.append("-F")
+    if word:
+        cmd.append("-w")
+    if multiline:
+        # Prefer --multiline (does not imply binary)
+        cmd.append("--multiline")
+
+    if follow_symlinks:
+        cmd.append("-L")
+    if hidden:
+        cmd.append("-H")
+    if no_ignore:
+        # Use -u (respect ignore but include hidden); do not escalate to -uu automatically
+        cmd.append("-u")
+
+    if include_globs:
+        for g in include_globs:
+            cmd += ["-g", g]
+    if exclude_globs:
+        for g in exclude_globs:
+            # ripgrep exclusion via !pattern
+            if not g.startswith("!"):
+                cmd += ["-g", f"!{g}"]
+            else:
+                cmd += ["-g", g]
+
+    if context_before is not None:
+        cmd += ["-B", str(context_before)]
+    if context_after is not None:
+        cmd += ["-A", str(context_after)]
+    if encoding:
+        cmd += ["--encoding", encoding]
+    if max_count is not None:
+        cmd += ["-m", str(max_count)]
+
+    # Normalize filesize
+    cmd += ["--max-filesize", normalize_max_filesize(max_filesize)]
+
+    # Only add timeout if supported (check if timeout_ms is provided and > 0)
+    # Note: --timeout flag may not be available in all ripgrep versions
+    # For now, we'll skip the timeout flag to ensure compatibility
+    # effective_timeout = clamp_int(timeout_ms, DEFAULT_RG_TIMEOUT_MS, RG_TIMEOUT_HARD_CAP_MS)
+    # cmd += ["--timeout", str(effective_timeout)]
+
+    # Query must be last before roots/files
+    cmd.append(query)
+
+    # Skip --files-from flag as it's not supported in this ripgrep version
+    # Use roots instead for compatibility
+    if roots:
+        cmd += roots
+    # Note: files_from functionality is disabled for compatibility
+
+    return cmd
+
+
+def parse_rg_json_lines_to_matches(stdout_bytes: bytes) -> list[dict[str, Any]]:
+    """Parse ripgrep JSON event stream and keep only match events."""
+    results: list[dict[str, Any]] = []
+    for raw_line in stdout_bytes.splitlines():
+        if not raw_line.strip():
+            continue
+        try:
+            evt = json.loads(raw_line.decode("utf-8", errors="replace"))
+        except (json.JSONDecodeError, UnicodeDecodeError):  # nosec B112
+            continue
+        if evt.get("type") != "match":
+            continue
+        data = evt.get("data", {})
+        path_text = (data.get("path", {}) or {}).get("text")
+        line_number = data.get("line_number")
+        line_text = (data.get("lines", {}) or {}).get("text")
+        submatches_raw = data.get("submatches", []) or []
+        # Normalize line content to reduce token usage
+        normalized_line = " ".join(line_text.split()) if line_text else ""
+
+        # Simplify submatches - remove redundant match text, keep only positions
+        simplified_matches = []
+        for sm in submatches_raw:
+            start = sm.get("start")
+            end = sm.get("end")
+            if start is not None and end is not None:
+                simplified_matches.append([start, end])
+
+        results.append(
+            {
+                "file": path_text,
+                "line": line_number,  # Shortened field name
+                "text": normalized_line,  # Normalized content
+                "matches": simplified_matches,  # Simplified match positions
+            }
+        )
+    return results
+
+
+def group_matches_by_file(matches: list[dict[str, Any]]) -> dict[str, Any]:
+    """Group matches by file to eliminate file path duplication."""
+    if not matches:
+        return {"success": True, "count": 0, "files": []}
+
+    # Group matches by file
+    file_groups: dict[str, list[dict[str, Any]]] = {}
+    total_matches = 0
+
+    for match in matches:
+        file_path = match.get("file", "unknown")
+        if file_path not in file_groups:
+            file_groups[file_path] = []
+
+        # Create match entry without file path
+        match_entry = {
+            "line": match.get("line", match.get("line_number", "?")),
+            "text": match.get("text", match.get("line", "")),
+            "positions": match.get("matches", match.get("submatches", [])),
+        }
+        file_groups[file_path].append(match_entry)
+        total_matches += 1
+
+    # Convert to grouped structure
+    files = []
+    for file_path, file_matches in file_groups.items():
+        files.append({"file": file_path, "matches": file_matches})
+
+    return {"success": True, "count": total_matches, "files": files}
+
+
+def optimize_match_paths(matches: list[dict[str, Any]]) -> list[dict[str, Any]]:
+    """Optimize file paths in match results to reduce token consumption."""
+    if not matches:
+        return matches
+
+    # Find common prefix among all file paths
+    file_paths = [match.get("file", "") for match in matches if match.get("file")]
+    common_prefix = ""
+    if len(file_paths) > 1:
+        import os
+
+        try:
+            common_prefix = os.path.commonpath(file_paths)
+        except (ValueError, TypeError):
+            common_prefix = ""
+
+    # Optimize each match
+    optimized_matches = []
+    for match in matches:
+        optimized_match = match.copy()
+        file_path = match.get("file")
+        if file_path:
+            optimized_match["file"] = _optimize_file_path(file_path, common_prefix)
+        optimized_matches.append(optimized_match)
+
+    return optimized_matches
+
+
+def _optimize_file_path(file_path: str, common_prefix: str = "") -> str:
+    """Optimize file path for token efficiency by removing common prefixes and shortening."""
+    if not file_path:
+        return file_path
+
+    # Remove common prefix if provided
+    if common_prefix and file_path.startswith(common_prefix):
+        optimized = file_path[len(common_prefix) :].lstrip("/\\")
+        if optimized:
+            return optimized
+
+    # For very long paths, show only the last few components
+    from pathlib import Path
+
+    path_obj = Path(file_path)
+    parts = path_obj.parts
+
+    if len(parts) > 4:
+        # Show first part + ... + last 3 parts
+        return str(Path(parts[0]) / "..." / Path(*parts[-3:]))
+
+    return file_path
+
+
+def summarize_search_results(
+    matches: list[dict[str, Any]], max_files: int = 10, max_total_lines: int = 50
+) -> dict[str, Any]:
+    """Summarize search results to reduce context size while preserving key information."""
+    if not matches:
+        return {
+            "total_matches": 0,
+            "total_files": 0,
+            "summary": "No matches found",
+            "top_files": [],
+        }
+
+    # Group matches by file and find common prefix for optimization
+    file_groups: dict[str, list[dict[str, Any]]] = {}
+    all_file_paths = []
+    for match in matches:
+        file_path = match.get("file", "unknown")
+        all_file_paths.append(file_path)
+        if file_path not in file_groups:
+            file_groups[file_path] = []
+        file_groups[file_path].append(match)
+
+    # Find common prefix to optimize paths
+    common_prefix = ""
+    if len(all_file_paths) > 1:
+        import os
+
+        common_prefix = os.path.commonpath(all_file_paths) if all_file_paths else ""
+
+    # Sort files by match count (descending)
+    sorted_files = sorted(file_groups.items(), key=lambda x: len(x[1]), reverse=True)
+
+    # Create summary
+    total_matches = len(matches)
+    total_files = len(file_groups)
+
+    # Top files with match counts
+    top_files = []
+    remaining_lines = max_total_lines
+
+    for file_path, file_matches in sorted_files[:max_files]:
+        match_count = len(file_matches)
+
+        # Include a few sample lines from this file
+        sample_lines = []
+        lines_to_include = min(3, remaining_lines, len(file_matches))
+
+        for _i, match in enumerate(file_matches[:lines_to_include]):
+            line_num = match.get(
+                "line", match.get("line_number", "?")
+            )  # Support both old and new format
+            line_text = match.get(
+                "text", match.get("line", "")
+            ).strip()  # Support both old and new format
+            if line_text:
+                # Truncate long lines and remove extra whitespace to save tokens
+                truncated_line = " ".join(line_text.split())[:60]
+                if len(line_text) > 60:
+                    truncated_line += "..."
+                sample_lines.append(f"L{line_num}: {truncated_line}")
+                remaining_lines -= 1
+
+        # Optimize file path for token efficiency
+        optimized_path = _optimize_file_path(file_path, common_prefix)
+
+        top_files.append(
+            {
+                "file": optimized_path,
+                "match_count": match_count,
+                "sample_lines": sample_lines,
+            }
+        )
+
+        if remaining_lines <= 0:
+            break
+
+    # Create summary text
+    if total_files <= max_files:
+        summary = f"Found {total_matches} matches in {total_files} files"
+    else:
+        summary = f"Found {total_matches} matches in {total_files} files (showing top {len(top_files)})"
+
+    return {
+        "total_matches": total_matches,
+        "total_files": total_files,
+        "summary": summary,
+        "top_files": top_files,
+        "truncated": total_files > max_files,
+    }
+
+
+def parse_rg_count_output(stdout_bytes: bytes) -> dict[str, int]:
+    """Parse ripgrep --count-matches output and return file->count mapping."""
+    results: dict[str, int] = {}
+    total_matches = 0
+
+    for line in stdout_bytes.decode("utf-8", errors="replace").splitlines():
+        line = line.strip()
+        if not line:
+            continue
+
+        # Format: "file_path:count"
+        if ":" in line:
+            file_path, count_str = line.rsplit(":", 1)
+            try:
+                count = int(count_str)
+                results[file_path] = count
+                total_matches += count
+            except ValueError:
+                # Skip lines that don't have valid count format
+                continue
+
+    # Add total count as special key
+    results["__total__"] = total_matches
+    return results
+
+
+@dataclass
+class TempFileList:
+    path: str
+
+    def __enter__(self) -> TempFileList:
+        return self
+
+    def __exit__(self, exc_type, exc, tb) -> None:
+        with contextlib.suppress(Exception):
+            Path(self.path).unlink(missing_ok=True)
+
+
+class contextlib:  # minimal shim for suppress without importing globally
+    class suppress:
+        def __init__(self, *exceptions: type[BaseException]) -> None:
+            self.exceptions = exceptions
+
+        def __enter__(self) -> None:  # noqa: D401
+            return None
+
+        def __exit__(self, exc_type, exc, tb) -> bool:
+            return exc_type is not None and issubclass(exc_type, self.exceptions)
+
+
+def write_files_to_temp(files: list[str]) -> TempFileList:
+    fd, temp_path = tempfile.mkstemp(prefix="rg-files-", suffix=".lst")
+    os.close(fd)
+    content = "\n".join(files)
+    Path(temp_path).write_text(content, encoding="utf-8")
+    return TempFileList(path=temp_path)