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

{tree_sitter_analyzer-1.2.3.dist-info → tree_sitter_analyzer-1.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.2.3
+Version: 1.2.4
 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
@@ -163,11 +163,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-1514%20passed-brightgreen.svg)](#quality-assurance)
-[![Coverage](https://img.shields.io/badge/coverage-74.10%25-green.svg)](#quality-assurance)
+[![Tests](https://img.shields.io/badge/tests-1564%20passed-brightgreen.svg)](#quality-assurance)
+[![Coverage](https://img.shields.io/badge/coverage-74.97%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.2.3-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.2.4-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)
 
 ## 🚀 Break LLM Token Limits, Let AI Understand Code Files of Any Size
@@ -220,10 +220,12 @@ Total Elements: 85 | Complexity: 348 (avg: 5.27, max: 15)
 |------------|------|------------|------------|--------------|-------------|
 | BigService | class | public | 17-1419 | 66 | 9 |
 
-### 🔄 **AI Assistant Three-Step Workflow**
-- **Step 1**: `check_code_scale` - Check file size and complexity
-- **Step 2**: `analyze_code_structure` - Generate detailed structure table with unified elements
-- **Step 3**: `extract_code_section` - Extract code snippets on demand
+### 🔄 **AI Assistant SMART Workflow**
+- **S**: `set_project_path` - Setup project root directory
+- **M**: `list_files`, `search_content`, `find_and_grep` - Map target files with precision
+- **A**: `analyze_code_structure` - Analyze core structure with unified elements
+- **R**: `extract_code_section` - Retrieve essential code snippets on demand
+- **T**: Advanced dependency tracing (when needed)
 
 ---
 
@@ -231,13 +233,31 @@ Total Elements: 85 | Complexity: 348 (avg: 5.27, max: 15)
 
 ### 🤖 AI Users (Claude Desktop, Cursor, etc.)
 
+**📋 0. Prerequisites (for Advanced MCP Tools)**
+For advanced file search and content analysis features, install these tools first:
+```bash
+# Install fd and ripgrep (see Prerequisites section for detailed instructions)
+# macOS
+brew install fd ripgrep
+
+# Windows (using winget - recommended)
+winget install sharkdp.fd BurntSushi.ripgrep.MSVC
+
+# Windows (alternative methods)
+# choco install fd ripgrep
+# scoop install fd ripgrep
+
+# Ubuntu/Debian
+sudo apt install fd-find ripgrep
+```
+
 **📦 1. One-click Installation**
 ```bash
 # macOS/Linux
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
 # Windows PowerShell
-powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
 **⚙️ 2. AI Client Configuration**
@@ -330,19 +350,25 @@ uv run python -m tree_sitter_analyzer examples/BigService.java --partial-read --
 
 ## 📖 Practical Usage Examples
 
-### 💬 AI IDE Prompts (Tested and Verified, Ready to Use)
+### 💬 AI IDE Prompts (SMART Analysis Workflow)
 
 > **✅ Test Verification Status:** All prompts below have been tested and verified in real environments, ensuring 100% availability
 > 
+> **🎯 SMART Analysis Workflow:**
+> - **S** - Setup project (set_project_path)
+> - **M** - Map target files (precision pattern matching)
+> - **A** - Analyze core structure (analyze_code_structure) 
+> - **R** - Retrieve essential code (extract_code_section)
+> - **T** - Trace dependencies (when needed)
+>
 > **⚠️ Important Notes:**
-> - **Step 0 is required** - Always set project path before using other tools
+> - Follow SMART workflow sequence for optimal results
 > - For files within the project, use **relative paths** (e.g., `examples/BigService.java`)
 > - For files outside the project, use **absolute paths** (e.g., `C:\git-public\tree-sitter-analyzer\examples\BigService.java`)
 > - All tools support both Windows and Unix style paths
 > - Project path should point to your code repository root directory
-> - You can set project path in MCP configuration or set it dynamically
 
-#### 🔧 **Step 0: Set Project Path (Required First Step)**
+#### 🔧 **S - Setup Project (Required First Step)**
 
 **Option 1: Configure in MCP Settings**
 ```json
@@ -384,7 +410,68 @@ Project path: C:\git-public\tree-sitter-analyzer
 - Example: `examples/BigService.java` instead of full paths
 - Once project path is successfully set, all subsequent analysis commands will automatically use this root directory
 
-#### 🔍 **Step 1: Check File Size**
+#### 🗺️ **M - Map Target Files (Precision Pattern Matching)**
+
+> **📋 Prerequisites:** This step requires `fd` and `ripgrep` tools to be installed. See [Prerequisites](#prerequisites) section for installation instructions.
+
+**Smart File Discovery:**
+```
+Find all Python files in the project
+```
+
+```
+List all Java files larger than 10KB
+```
+
+```
+Find configuration files (*.json, *.yaml, *.toml) in the project
+```
+
+**Intelligent Content Search:**
+```
+Search for "def authenticate" in all Python files with context
+```
+
+```
+Find all TODO comments in source files
+```
+
+```
+Search for "class.*Service" patterns in all files, case insensitive
+```
+
+**Combined Discovery & Search:**
+```
+Find all Python files and search for "async def" functions
+```
+
+```
+Search for "class.*Service" in all source files
+```
+
+**Return Format:**
+```json
+{
+  "success": true,
+  "results": [
+    {
+      "file": "tree_sitter_analyzer/core/query_service.py",
+      "line": 20,
+      "text": "class QueryService:",
+      "matches": [[0, 18]]
+    }
+  ],
+  "count": 25,
+  "meta": {
+    "searched_file_count": 256,
+    "truncated": false,
+    "fd_elapsed_ms": 225,
+    "rg_elapsed_ms": 2969
+  }
+}
+```
+
+#### 🔍 **A - Analyze Core Structure**
 
 **Method 1: Explicit Analysis Request**
 ```
@@ -435,7 +522,7 @@ Please analyze this file: C:\git-public\tree-sitter-analyzer\examples\BigService
 }
 ```
 
-#### 📊 **Step 2: Generate Structure Table**
+#### 📊 **R - Retrieve Essential Code**
 
 **Method 1: Explicit Table Request**
 ```
@@ -464,7 +551,7 @@ Please generate a detailed structure table: C:\git-public\tree-sitter-analyzer\e
 - Including class information, method list (with line numbers), field list
 - Method signatures, visibility, line ranges, complexity, and other detailed information
 
-#### ✂️ **Step 3: Extract Code Snippets**
+#### ✂️ **Precise Code Extraction**
 
 **Method 1: Explicit Extraction Request**
 ```
@@ -503,7 +590,7 @@ Please extract code snippet: C:\git-public\tree-sitter-analyzer\examples\BigServ
 }
 ```
 
-#### 🔍 **Step 4: Smart Query Filtering (v0.9.6+)**
+#### 🔗 **T - Trace Dependencies (Advanced Analysis)**
 
 **Error Handling Enhancement (v0.9.7):**
 - Improved `@handle_mcp_errors` decorator with tool name recognition
@@ -545,13 +632,15 @@ Please help me find all public getter methods with no parameters: examples/BigSe
 }
 ```
 
-#### 💡 **Important Notes**
+
+#### 💡 **SMART Workflow Best Practices**
 - **Natural Language**: Tell AI directly in natural language what you want, no need to remember complex parameter formats
-- **Path Processing**: After setting project path, relative paths automatically resolve to project root directory, absolute paths also fully supported
+- **Sequential Flow**: Follow S→M→A→R→T sequence for optimal analysis results
+- **Path Processing**: After setting project path, relative paths automatically resolve to project root directory
 - **Security Protection**: Tool automatically performs project boundary checks to ensure security
-- **Workflow**: Recommended to use in order: Step 0 (set path) → Step 1 → 2 → 4 (query filter) → 3 (precise extraction)
 - **Smart Understanding**: AI automatically understands your needs and calls appropriate tools
-- **Project Path**: Once project path is set, all subsequent operations automatically use that root directory
+- **Performance**: All MCP tools are optimized for speed with built-in timeouts and result limits
+- **Dependency Tracing**: Use T step only when you need to understand complex relationships between code elements
 
 ### 🛠️ CLI Command Examples
 
@@ -657,6 +746,98 @@ Deep integration through MCP protocol:
 - Roo Code
 - Other MCP-compatible AI tools
 
+### 🔍 **Advanced File Search & Content Analysis (v1.2.4+)**
+Powerful file discovery and content search capabilities powered by fd and ripgrep:
+
+#### **📋 Prerequisites**
+To use the advanced MCP tools (ListFilesTool, SearchContentTool, FindAndGrepTool), you need to install the following command-line tools:
+
+**Install fd (fast file finder):**
+```bash
+# macOS (using Homebrew)
+brew install fd
+
+# Windows (using winget - recommended)
+winget install sharkdp.fd
+
+# Windows (using Chocolatey)
+choco install fd
+
+# Windows (using Scoop)
+scoop install fd
+
+# Ubuntu/Debian
+sudo apt install fd-find
+
+# CentOS/RHEL/Fedora
+sudo dnf install fd-find
+
+# Arch Linux
+sudo pacman -S fd
+```
+
+**Install ripgrep (fast text search):**
+```bash
+# macOS (using Homebrew)
+brew install ripgrep
+
+# Windows (using winget - recommended)
+winget install BurntSushi.ripgrep.MSVC
+
+# Windows (using Chocolatey)
+choco install ripgrep
+
+# Windows (using Scoop)
+scoop install ripgrep
+
+# Ubuntu/Debian
+sudo apt install ripgrep
+
+# CentOS/RHEL/Fedora
+sudo dnf install ripgrep
+
+# Arch Linux
+sudo pacman -S ripgrep
+```
+
+**Verify Installation:**
+```bash
+# Check fd installation
+fd --version
+
+# Check ripgrep installation
+rg --version
+```
+
+> **⚠️ Important:** Without these tools installed, the advanced MCP file search and content analysis features will not work. The basic MCP tools (analyze_code_structure, extract_code_section, etc.) will continue to work normally.
+
+#### **🗂️ ListFilesTool - Smart File Discovery**
+- **Advanced filtering**: File type, size, modification time, extension-based filtering
+- **Pattern matching**: Glob patterns and regex support for flexible file discovery
+- **Metadata enrichment**: File size, modification time, directory status, and extension information
+- **Performance optimized**: Built on fd for lightning-fast file system traversal
+
+#### **🔎 SearchContentTool - Intelligent Content Search**
+- **Regex & literal search**: Flexible pattern matching with case sensitivity controls
+- **Context-aware results**: Configurable before/after context lines for better understanding
+- **Multiple output formats**: Standard results, count-only, summary, and grouped by file
+- **Encoding support**: Handle files with different text encodings
+- **Performance limits**: Built-in timeout and result limits for responsive operation
+
+#### **🎯 FindAndGrepTool - Combined Discovery & Search**
+- **Two-stage workflow**: First discover files with fd, then search content with ripgrep
+- **Comprehensive filtering**: Combine file discovery filters with content search patterns
+- **Advanced options**: Multiline patterns, word boundaries, fixed strings, and case controls
+- **Rich metadata**: File discovery timing, search timing, and result statistics
+- **Token optimization**: Path optimization and result grouping to minimize AI token usage
+
+#### **✨ Key Benefits:**
+- 🚀 **Enterprise-grade reliability**: 50+ comprehensive test cases ensuring stability
+- 🎯 **Token-efficient**: Multiple output formats optimized for AI assistant interactions
+- 🔧 **Highly configurable**: Extensive parameter support for precise control
+- 📊 **Performance monitoring**: Built-in timing and result statistics
+- 🛡️ **Error resilient**: Comprehensive error handling and validation
+
 ### 🌍 **Multi-language Support**
 - **Java** - Full support, including Spring, JPA frameworks
 - **Python** - Full support, including type annotations, decorators
@@ -762,6 +943,7 @@ uv run pytest tests/test_mcp_server_initialization.py -v
 - **Language detector**: 98.41% (Excellent)
 - **CLI main entry**: 94.36% (Excellent)
 - **Query filtering system**: 96.06% (Excellent)
+- **MCP fd/rg tools**: 93.04% (Excellent) - *New in v1.2.4*
 - **Query service**: 86.25% (Good)
 - **Error handling**: 82.76% (Good)
 
@@ -799,6 +981,32 @@ uv run python llm_code_checker.py path/to/new_file.py
 
 ---
 
+## 💝 Sponsors & Acknowledgments
+
+We are grateful to our sponsors who make this project possible:
+
+### 🌟 **Special Thanks**
+
+**[@o93](https://github.com/o93)** - *Primary Sponsor & Supporter*
+- 🚀 **MCP Tools Enhancement**: Sponsored the comprehensive MCP fd/ripgrep tools development
+- 🧪 **Testing Infrastructure**: Enabled enterprise-grade test coverage (50+ comprehensive test cases)
+- 🔧 **Quality Assurance**: Supported bug fixes and performance improvements
+- 💡 **Innovation Support**: Made early release of advanced file search and content analysis features possible
+
+*"Thanks to @o93's generous support, we were able to deliver powerful MCP tools that revolutionize how AI assistants interact with codebases. This sponsorship directly enabled the development of ListFilesTool, SearchContentTool, and FindAndGrepTool with comprehensive test coverage."*
+
+### 🤝 **Become a Sponsor**
+
+Your support helps us:
+- 🔬 Develop new features and tools
+- 🧪 Maintain comprehensive test coverage
+- 📚 Create better documentation
+- 🚀 Accelerate development cycles
+
+**[💖 Sponsor this project](https://github.com/sponsors/aimasteracc)** to help us continue building amazing tools for the developer community!
+
+---
+
 ## 🤝 Contributing
 
 We welcome all forms of contributions! Please see [Contributing Guide](CONTRIBUTING.md) for details.
@@ -833,8 +1041,9 @@ All AI prompts in this document have been thoroughly tested in real environments
 
 **Test Environment:**
 - Operating System: Windows 10
-- Project: tree-sitter-analyzer v1.2.0
+- Project: tree-sitter-analyzer v1.2.4
 - Test Files: BigService.java (1419 lines), sample.py (256 lines), MultiClass.java (54 lines)
-- Test Tools: All MCP tools (check_code_scale, analyze_code_structure, extract_code_section, query_code)
+- Test Coverage: 1564 tests passed, 74.97% coverage
+- Test Tools: All MCP tools (check_code_scale, analyze_code_structure, extract_code_section, query_code, list_files, search_content, find_and_grep)
 
 **🚀 Start Now** → [30-Second Quick Start](#-30-second-quick-start)

{tree_sitter_analyzer-1.2.3.dist-info → tree_sitter_analyzer-1.2.4.dist-info}/RECORD

@@ -45,11 +45,11 @@ tree_sitter_analyzer/interfaces/cli_adapter.py,sha256=8j3xL3k6wWrGQCq0KCntqbvSxK
 tree_sitter_analyzer/interfaces/mcp_adapter.py,sha256=iSWcm-bn8_pL6YBu1Rrzherv72-5WUiavColu3uhSAY,7707
 tree_sitter_analyzer/interfaces/mcp_server.py,sha256=dUFn1CyO2jLa_y5gGOGE-f0sLGAbjgp738uy5-aAphI,16510
 tree_sitter_analyzer/languages/__init__.py,sha256=VTXxJgVjHJAciLhX0zzXOS4EygZMtebeYUbi_0z6fGw,340
-tree_sitter_analyzer/languages/java_plugin.py,sha256=jKr_CBOGWfDREQbism16XArwZ4TvmC4hS3RdhU6C1PQ,50355
+tree_sitter_analyzer/languages/java_plugin.py,sha256=G90_LlKdHtZNOPYu8MGBbgw6qkTiwd_QJu0xID3LMPc,50509
 tree_sitter_analyzer/languages/javascript_plugin.py,sha256=k14kHfi5II9MRTsVuy0NQq5l2KZYncCnM1Q6T1c5q_U,15844
 tree_sitter_analyzer/languages/python_plugin.py,sha256=MJ03F_Nv-nmInIkEFmPyEXYhyGbLHyr5kCbj2taEDYk,29144
 tree_sitter_analyzer/mcp/__init__.py,sha256=8tC54ZYcZBcFEio-aDet7evzis50zV5gbHuvn_7K514,944
-tree_sitter_analyzer/mcp/server.py,sha256=ZLk2n37xqfKu1O8toSngir51SJW1_I8Mk-8c55rHrZI,30818
+tree_sitter_analyzer/mcp/server.py,sha256=k9WaDww6BXDDgRKZjvHx-cfOxglzdy4nQMia1i4UXNk,32021
 tree_sitter_analyzer/mcp/resources/__init__.py,sha256=D46ZDhPQaCrQze8dHmijMg1QZQ4ABRIjG532sFpuGPo,1367
 tree_sitter_analyzer/mcp/resources/code_file_resource.py,sha256=ZX5ZYSJfylBedpL80kTDlco2YZqgRMb5f3OW0VvOVRM,6166
 tree_sitter_analyzer/mcp/resources/project_stats_resource.py,sha256=r2owXkWrZ-Ee9hLGpt-SSNOxzrzuNVgNXcwxQghCcrM,20057
@@ -57,8 +57,12 @@ tree_sitter_analyzer/mcp/tools/__init__.py,sha256=9KfetZTaUhvWTeKuZPYzWb7ZomFQ8S
 tree_sitter_analyzer/mcp/tools/analyze_scale_tool.py,sha256=JyS9gey2oFoWjzsiiLjwcqTgwBYGlbY01vAK3QYUuF4,28470
 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=DXfKYHl6gFz9c7sFBn2Yp9ST8XjsOcsii89cFr8Qnmo,16844
+tree_sitter_analyzer/mcp/tools/find_and_grep_tool.py,sha256=uYHat0kShQyreK1TXtvBG1e_HAL8ZsRHr49CzP7PLAo,20272
+tree_sitter_analyzer/mcp/tools/list_files_tool.py,sha256=XWzk4ZHhXvvKOhebWa5tSsW5_mY4TOmCHdHoDYs6Q8Y,11937
 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=GCJQcCXfSlGD_BaDIoiomwL3E42a-7KswSItqPqz5Vs,15380
 tree_sitter_analyzer/mcp/tools/table_format_tool.py,sha256=NDIiCtmZSbCmaQOp7ED83jGE5DuJhx4mcUketVHrkjs,16024
 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
@@ -76,7 +80,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.2.3.dist-info/METADATA,sha256=CCFBPKrEicO0wogMoT87aQZ-RpaL9jzz3ej4tjUi2e8,32970
-tree_sitter_analyzer-1.2.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-tree_sitter_analyzer-1.2.3.dist-info/entry_points.txt,sha256=U4tfLGXgCWubKm2PyEb3zxhQ2pm7zVotMyfyS0CodD8,486
-tree_sitter_analyzer-1.2.3.dist-info/RECORD,,
+tree_sitter_analyzer-1.2.4.dist-info/METADATA,sha256=3Aho6-du1VHRVg0rPxbzWH9QKDakAQvZByOvemyA6EE,39669
+tree_sitter_analyzer-1.2.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+tree_sitter_analyzer-1.2.4.dist-info/entry_points.txt,sha256=U4tfLGXgCWubKm2PyEb3zxhQ2pm7zVotMyfyS0CodD8,486
+tree_sitter_analyzer-1.2.4.dist-info/RECORD,,