tree-sitter-analyzer 1.9.1__py3-none-any.whl → 1.9.3__py3-none-any.whl

tree_sitter_analyzer/mypy_current_errors.txt

@@ -0,0 +1,2 @@
+mcp\server.py: error: Source file found twice under different module names:
+"tree_sitter_analyzer.mcp.server" and "mcp.server"

tree_sitter_analyzer/plugins/base.py

@@ -34,6 +34,10 @@ class ElementExtractor(ABC):
     meaningful code elements like functions, classes, variables, etc.
     """
 
+    def __init__(self) -> None:
+        """Initialize the element extractor."""
+        self.current_file: str = ""  # Current file being processed
+
     @abstractmethod
     def extract_functions(
         self, tree: "tree_sitter.Tree", source_code: str
@@ -98,6 +102,36 @@ class ElementExtractor(ABC):
         """
         pass
 
+    def extract_packages(self, tree: "tree_sitter.Tree", source_code: str) -> list[Any]:
+        """
+        Extract package declarations from the syntax tree.
+
+        Args:
+            tree: Tree-sitter AST
+            source_code: Original source code
+
+        Returns:
+            List of extracted package objects
+        """
+        # Default implementation returns empty list
+        return []
+
+    def extract_annotations(
+        self, tree: "tree_sitter.Tree", source_code: str
+    ) -> list[Any]:
+        """
+        Extract annotations from the syntax tree.
+
+        Args:
+            tree: Tree-sitter AST
+            source_code: Original source code
+
+        Returns:
+            List of extracted annotation objects
+        """
+        # Default implementation returns empty list
+        return []
+
     def extract_all_elements(
         self, tree: "tree_sitter.Tree", source_code: str
     ) -> list[CodeElement]:
@@ -123,6 +157,38 @@ class ElementExtractor(ABC):
 
         return elements
 
+    def extract_html_elements(
+        self, tree: "tree_sitter.Tree", source_code: str
+    ) -> list[Any]:
+        """
+        Extract HTML elements from the syntax tree.
+
+        Args:
+            tree: Tree-sitter AST
+            source_code: Original source code
+
+        Returns:
+            List of extracted HTML elements
+        """
+        # Default implementation returns empty list
+        return []
+
+    def extract_css_rules(
+        self, tree: "tree_sitter.Tree", source_code: str
+    ) -> list[Any]:
+        """
+        Extract CSS rules from the syntax tree.
+
+        Args:
+            tree: Tree-sitter AST
+            source_code: Original source code
+
+        Returns:
+            List of extracted CSS rules
+        """
+        # Default implementation returns empty list
+        return []
+
 
 class LanguagePlugin(ABC):
     """

tree_sitter_analyzer/queries/java.py

@@ -181,7 +181,7 @@ JAVA_QUERIES: dict[str, str] = {
     # --- Structural Information Extraction Queries ---
     "javadoc_comment": """
     (block_comment) @javadoc_comment
-    (#match? @javadoc_comment "^/\\*\\*")
+    (#match? @javadoc_comment "^/\\\\\\\\\\\\*\\\\\\\\\\\\*")
     """,
     "class_with_javadoc": """
     (class_declaration

tree_sitter_analyzer/queries/javascript.py

@@ -56,13 +56,13 @@ JAVASCRIPT_QUERIES: dict[str, str] = {
     "class_declaration": """
     (class_declaration
         name: (identifier) @class_name
-        superclass: (class_heritage)? @superclass
+        (class_heritage)? @superclass
         body: (class_body) @body) @class_declaration
     """,
     "class_expression": """
     (class_expression
         name: (identifier)? @class_name
-        superclass: (class_heritage)? @superclass
+        (class_heritage)? @superclass
         body: (class_body) @body) @class_expression
     """,
     "class_method": """
@@ -542,13 +542,8 @@ FUNCTIONS = """
 CLASSES = """
 (class_declaration
     name: (identifier) @class.name
-    superclass: (class_heritage)? @class.superclass
+    (class_heritage)? @class.superclass
     body: (class_body) @class.body) @class.declaration
-
-(class_expression
-    name: (identifier)? @class.name
-    superclass: (class_heritage)? @class.superclass
-    body: (class_body) @class.body) @class.expression
 """
 
 VARIABLES = """

tree_sitter_analyzer/queries/markdown.py

@@ -176,7 +176,7 @@ def get_available_queries() -> list[str]:
     return sorted(queries + aliases)
 
 
-def get_query_info(query_name: str) -> dict[str, str]:
+def get_query_info(query_name: str) -> dict[str, str | bool]:
     """
     Get information about a query
 

tree_sitter_analyzer/queries/python.py

@@ -40,7 +40,7 @@ IMPORTS = """
 
 (import_from_statement
     module_name: (dotted_name)? @import.module
-    name: (import_list) @import.list) @import.from_list
+    name: (aliased_import) @import.aliased_item) @import.from_aliased
 
 (aliased_import
     name: (dotted_name) @import.name
@@ -335,7 +335,7 @@ PYTHON_QUERIES: dict[str, str] = {
     "import_from_list": """
     (import_from_statement
         module_name: (dotted_name)? @module_name
-        name: (import_list) @import_list) @import_from_list
+        name: (aliased_import) @import_item) @import_from_list
     """,
     "aliased_import": """
     (aliased_import

tree_sitter_analyzer/security/boundary_manager.py

@@ -45,8 +45,6 @@ class ProjectBoundaryManager:
             # Handle both string and Path objects
             if isinstance(project_root, str):
                 project_path = Path(project_root)
-            elif isinstance(project_root, Path):
-                project_path = project_root
             else:
                 raise SecurityError(f"Invalid project root type: {type(project_root)}")
 
@@ -150,18 +148,17 @@ class ProjectBoundaryManager:
             real_path = Path(file_path).resolve()
             try:
                 rel_path = real_path.relative_to(Path(self.project_root))
-                rel_path = str(rel_path)
             except ValueError:
                 # Path is not relative to project root
                 log_warning(f"Path not relative to project root: {file_path}")
                 return None
 
             # Ensure relative path doesn't start with ..
-            if rel_path.startswith(".."):
+            if str(rel_path).startswith(".."):
                 log_warning(f"Relative path calculation failed: {rel_path}")
                 return None
 
-            return rel_path
+            return str(rel_path)
 
         except Exception as e:
             log_warning(f"Relative path calculation error: {e}")

tree_sitter_analyzer/security/regex_checker.py

@@ -219,9 +219,9 @@ class RegexSafetyChecker:
 
             # Calculate complexity score
             metrics["complexity_score"] = (
-                metrics["length"] * 0.1
+                int(metrics["length"] * 0.1)
                 + metrics["quantifiers"] * 2
-                + metrics["groups"] * 1.5
+                + int(metrics["groups"] * 1.5)
                 + metrics["alternations"] * 3
                 + metrics["character_classes"] * 1
             )

tree_sitter_analyzer/security/validator.py

@@ -36,6 +36,8 @@ class SecurityValidator:
         Args:
             project_root: Optional project root directory for boundary checks
         """
+        self.boundary_manager: ProjectBoundaryManager | None
+
         # Ensure project_root is properly resolved if provided
         if project_root:
             try:
@@ -488,7 +490,9 @@ class SecurityValidator:
                 or "CI" in os.environ
                 or "GITHUB_ACTIONS" in os.environ
                 or any(
-                    "test" in arg.lower() for arg in os.sys.argv if hasattr(os, "sys")
+                    "test" in arg.lower()
+                    for arg in getattr(getattr(os, "sys", None), "argv", [])
+                    if hasattr(os, "sys")
                 )
             )
 

tree_sitter_analyzer/table_formatter.py

@@ -665,7 +665,7 @@ class TableFormatter:
 
         # Map<String,Object> -> M<S,O>
         if "Map<" in type_name:
-            return (
+            return str(
                 type_name.replace("Map<", "M<")
                 .replace("String", "S")
                 .replace("Object", "O")
@@ -673,17 +673,17 @@ class TableFormatter:
 
         # List<String> -> L<S>
         if "List<" in type_name:
-            return type_name.replace("List<", "L<").replace("String", "S")
+            return str(type_name.replace("List<", "L<").replace("String", "S"))
 
         # String[] -> S[]
         if "[]" in type_name:
             base_type = type_name.replace("[]", "")
             if base_type:
-                return type_mapping.get(base_type, base_type[0].upper()) + "[]"
+                return str(type_mapping.get(base_type, base_type[0].upper())) + "[]"
             else:
                 return "O[]"
 
-        return type_mapping.get(type_name, type_name)
+        return str(type_mapping.get(type_name, type_name))
 
     def _convert_visibility(self, visibility: str) -> str:
         """Convert visibility to symbol"""

tree_sitter_analyzer/utils/__init__.py

@@ -3,132 +3,38 @@
 Utilities package for tree_sitter_analyzer.
 
 This package contains utility modules for various functionality
-including tree-sitter API compatibility.
+including tree-sitter API compatibility and logging.
 """
 
 # Import from tree-sitter compatibility module
 from .tree_sitter_compat import TreeSitterQueryCompat, get_node_text_safe, log_api_info
 
-
-# Re-export logging functions from the parent utils module
-# We need to import these dynamically to avoid circular imports
-def _import_logging_functions():
-    """Dynamically import logging functions to avoid circular imports."""
-    import importlib.util
-    import os
-
-    # Import the utils.py file from the parent directory
-    parent_dir = os.path.dirname(os.path.dirname(__file__))
-    utils_path = os.path.join(parent_dir, "utils.py")
-    spec = importlib.util.spec_from_file_location(
-        "tree_sitter_analyzer_utils", utils_path
-    )
-    utils_module = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(utils_module)
-
-    return (
-        utils_module.setup_logger,
-        utils_module.log_debug,
-        utils_module.log_error,
-        utils_module.log_warning,
-        utils_module.log_info,
-        utils_module.log_performance,
-        utils_module.QuietMode,
-        utils_module.safe_print,
-        utils_module.LoggingContext,
-        utils_module.setup_performance_logger,
-        utils_module.create_performance_logger,
-    )
-
-
-# Import logging functions
-try:
-    (
-        setup_logger,
-        log_debug,
-        log_error,
-        log_warning,
-        log_info,
-        log_performance,
-        QuietMode,
-        safe_print,
-        LoggingContext,
-        setup_performance_logger,
-        create_performance_logger,
-    ) = _import_logging_functions()
-except Exception:
-    # Fallback logging functions if import fails
-    def setup_logger(name="tree_sitter_analyzer", level=30):
-        import logging
-
-        logger = logging.getLogger(name)
-        if not logger.handlers:
-            handler = logging.StreamHandler()
-            formatter = logging.Formatter(
-                "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
-            )
-            handler.setFormatter(formatter)
-            logger.addHandler(handler)
-        logger.setLevel(level)
-        return logger
-
-    def log_debug(msg, *args, **kwargs):
-        pass
-
-    def log_error(msg, *args, **kwargs):
-        print(f"ERROR: {msg}", *args)
-
-    def log_warning(msg, *args, **kwargs):
-        print(f"WARNING: {msg}", *args)
-
-    def log_info(msg, *args, **kwargs):
-        print(f"INFO: {msg}", *args)
-
-    def log_performance(operation, execution_time=None, details=None):
-        pass
-
-    # Fallback QuietMode class
-    class QuietMode:
-        def __init__(self, enabled=True):
-            self.enabled = enabled
-
-        def __enter__(self):
-            return self
-
-        def __exit__(self, exc_type, exc_val, exc_tb):
-            pass
-
-    # Fallback LoggingContext class
-    class LoggingContext:
-        def __init__(self, enabled=True, level=None):
-            self.enabled = enabled
-            self.level = level
-
-        def __enter__(self):
-            return self
-
-        def __exit__(self, exc_type, exc_val, exc_tb):
-            pass
-
-    def setup_performance_logger():
-        import logging
-
-        return logging.getLogger("performance")
-
-    def create_performance_logger(name):
-        import logging
-
-        return logging.getLogger(f"{name}.performance")
-
-    def safe_print(message, level="info", quiet=False):
-        if not quiet:
-            print(message)
-
+# Import logging functions directly from logging module
+from .logging import (
+    LoggingContext,
+    QuietMode,
+    SafeStreamHandler,
+    create_performance_logger,
+    log_debug,
+    log_error,
+    log_info,
+    log_performance,
+    log_warning,
+    logger,
+    perf_logger,
+    safe_print,
+    setup_logger,
+    setup_performance_logger,
+    setup_safe_logging_shutdown,
+    suppress_output,
+)
 
 __all__ = [
+    # Tree-sitter compatibility
     "TreeSitterQueryCompat",
     "get_node_text_safe",
     "log_api_info",
+    # Logging functionality
     "setup_logger",
     "log_debug",
     "log_error",
@@ -140,4 +46,9 @@ __all__ = [
     "LoggingContext",
     "setup_performance_logger",
     "create_performance_logger",
+    "SafeStreamHandler",
+    "setup_safe_logging_shutdown",
+    "suppress_output",
+    "logger",
+    "perf_logger",
 ]

tree_sitter_analyzer/{utils.py → utils/logging.py}

@@ -154,7 +154,7 @@ class SafeStreamHandler(logging.StreamHandler):
     A StreamHandler that safely handles closed streams
     """
 
-    def __init__(self, stream=None):
+    def __init__(self, stream: Any = None) -> None:
         # Default to sys.stderr to keep stdout clean for MCP stdio
         super().__init__(stream if stream is not None else sys.stderr)
 
@@ -449,4 +449,4 @@ class LoggingContext:
     def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
         if self.enabled and self.old_level is not None:
             # Always restore the saved level
-            self.target_logger.setLevel(self.old_level)
+            self.target_logger.setLevel(self.old_level)

tree_sitter_analyzer/utils/tree_sitter_compat.py

@@ -235,7 +235,7 @@ def get_node_text_safe(node: Any, source_code: str, encoding: str = "utf-8") ->
                     line = lines[start_point[0]]
                     start_col = max(0, min(start_point[1], len(line)))
                     end_col = max(start_col, min(end_point[1], len(line)))
-                    return line[start_col:end_col]
+                    return str(line[start_col:end_col])
                 else:
                     # Multiple lines
                     result_lines = []
@@ -258,7 +258,7 @@ def get_node_text_safe(node: Any, source_code: str, encoding: str = "utf-8") ->
         return ""
 
 
-def log_api_info():
+def log_api_info() -> None:
     """Log information about available tree-sitter APIs."""
     try:
         import tree_sitter

{tree_sitter_analyzer-1.9.1.dist-info → tree_sitter_analyzer-1.9.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tree-sitter-analyzer
-Version: 1.9.1
+Version: 1.9.3
 Summary: AI-era enterprise-grade code analysis tool with comprehensive HTML/CSS support, dynamic plugin architecture, and MCP integration
 Project-URL: Homepage, https://github.com/aimasteracc/tree-sitter-analyzer
 Project-URL: Documentation, https://github.com/aimasteracc/tree-sitter-analyzer#readme
@@ -33,6 +33,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: cachetools>=5.0.0
 Requires-Dist: chardet>=5.0.0
+Requires-Dist: deepdiff>=6.7.1
 Requires-Dist: mcp>=1.12.3
 Requires-Dist: psutil>=5.9.8
 Requires-Dist: tree-sitter-cpp<0.25.0,>=0.23.4
@@ -202,7 +203,7 @@ Description-Content-Type: text/markdown
 [![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.9.0-blue.svg)](https://github.com/aimasteracc/tree-sitter-analyzer/releases)
+[![Version](https://img.shields.io/badge/version-1.9.3-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)
 
@@ -250,9 +251,8 @@ Tree-sitter Analyzer is an enterprise-grade code analysis tool designed for the
 | **HTML** | 🆕 Complete Support | DOM structure analysis, element classification, attribute extraction, hierarchical relationships |
 | **CSS** | 🆕 Complete Support | Selector analysis, property classification, style rule extraction, intelligent categorization |
 | **Markdown** | Complete Support | Headers, code blocks, links, images, tables, task lists, blockquotes |
-| **C/C++** | Basic Support | Basic syntax parsing |
-| **Rust** | Basic Support | Basic syntax parsing |
-| **Go** | Basic Support | Basic syntax parsing |
+
+**Note:** Currently, only the above 7 languages have complete plugin implementations. Languages such as C/C++, Rust, Go, JSON are defined in `LanguageDetector` but do not have functional plugin implementations at this time.
 
 ### 🏆 Production Ready
 - **3,370 Tests** - 100% pass rate, enterprise-grade quality assurance
@@ -397,21 +397,21 @@ uv add "tree-sitter-analyzer[all,mcp]"
 
 ```bash
 # View help
-uv run python -m tree_sitter_analyzer --help
+uv run tree-sitter-analyzer --help
 
 # Analyze large file scale (1419 lines completed instantly)
-uv run python -m tree_sitter_analyzer examples/BigService.java --advanced --output-format=text
+uv run tree-sitter-analyzer examples/BigService.java --advanced --output-format text
 
 # Generate detailed structure table for code files
-uv run python -m tree_sitter_analyzer examples/BigService.java --table=full
+uv run tree-sitter-analyzer examples/BigService.java --table full
 
 # 🆕 HTML/CSS analysis with new architecture
-uv run python -m tree_sitter_analyzer examples/comprehensive_sample.html --table=html --output-format=text
-uv run python -m tree_sitter_analyzer examples/comprehensive_sample.css --advanced --output-format=text
-uv run python -m tree_sitter_analyzer examples/comprehensive_sample.html --structure --language html
+uv run tree-sitter-analyzer examples/comprehensive_sample.html --table full
+uv run tree-sitter-analyzer examples/comprehensive_sample.css --advanced --output-format text
+uv run tree-sitter-analyzer examples/comprehensive_sample.html --structure
 
 # Precise code extraction
-uv run python -m tree_sitter_analyzer examples/BigService.java --partial-read --start-line 93 --end-line 106
+uv run tree-sitter-analyzer examples/BigService.java --partial-read --start-line 93 --end-line 106
 ```
 
 ---
@@ -744,47 +744,47 @@ The `suppress_output` parameter in the `analyze_code_structure` tool:
 
 ```bash
 # Quick analysis (show summary information)
-uv run python -m tree_sitter_analyzer examples/BigService.java --summary
+uv run tree-sitter-analyzer examples/BigService.java --summary
 
 # Detailed analysis (show complete structure)
-uv run python -m tree_sitter_analyzer examples/BigService.java --structure
+uv run tree-sitter-analyzer examples/BigService.java --structure
 
 # Advanced analysis (including complexity metrics)
-uv run python -m tree_sitter_analyzer examples/BigService.java --advanced
+uv run tree-sitter-analyzer examples/BigService.java --advanced
 
 # Generate complete structure table
-uv run python -m tree_sitter_analyzer examples/BigService.java --table=full
+uv run tree-sitter-analyzer examples/BigService.java --table full
 
 # 🆕 HTML/CSS analysis with new architecture
-uv run python -m tree_sitter_analyzer examples/comprehensive_sample.html --table=full --output-format=text
-uv run python -m tree_sitter_analyzer examples/comprehensive_sample.css --table=full --output-format=text
-uv run python -m tree_sitter_analyzer examples/comprehensive_sample.html --advanced --output-format=text
-uv run python -m tree_sitter_analyzer examples/comprehensive_sample.css --advanced --output-format=text
+uv run tree-sitter-analyzer examples/comprehensive_sample.html --table full
+uv run tree-sitter-analyzer examples/comprehensive_sample.css --table full
+uv run tree-sitter-analyzer examples/comprehensive_sample.html --advanced
+uv run tree-sitter-analyzer examples/comprehensive_sample.css --advanced
 
 # Specify output format
-uv run python -m tree_sitter_analyzer examples/BigService.java --advanced --output-format=json
-uv run python -m tree_sitter_analyzer examples/BigService.java --advanced --output-format=text
+uv run tree-sitter-analyzer examples/BigService.java --advanced --output-format json
+uv run tree-sitter-analyzer examples/BigService.java --advanced --output-format text
 
 # Precise code extraction
-uv run python -m tree_sitter_analyzer examples/BigService.java --partial-read --start-line 93 --end-line 106
+uv run tree-sitter-analyzer examples/BigService.java --partial-read --start-line 93 --end-line 106
 
 # Specify programming language
-uv run python -m tree_sitter_analyzer script.py --language python --table=full
+uv run tree-sitter-analyzer script.py --language python --table full
 ```
 
 #### 🔍 Query and Filter Commands
 
 ```bash
 # Query specific elements
-uv run python -m tree_sitter_analyzer examples/BigService.java --query-key methods
-uv run python -m tree_sitter_analyzer examples/BigService.java --query-key classes
+uv run tree-sitter-analyzer examples/BigService.java --query-key methods
+uv run tree-sitter-analyzer examples/BigService.java --query-key classes
 
 # 🆕 v1.8.2 Correct Usage Examples
 # Correct: Use --query-key with --filter combination
-uv run python -m tree_sitter_analyzer examples/BigService.java --query-key methods --filter "name=main"
+uv run tree-sitter-analyzer examples/BigService.java --query-key methods --filter "name=main"
 
 # Correct: Generate complete structure table
-uv run python -m tree_sitter_analyzer examples/BigService.java --table full
+uv run tree-sitter-analyzer examples/BigService.java --table full
 
 # 🚫 v1.8.2 Incorrect Usage Examples (will show error)
 # Incorrect: Using --table and --query-key together (exclusive parameters)
@@ -881,7 +881,7 @@ uv run python -m tree_sitter_analyzer --show-query-languages
 | **✂️ Intelligent Code Extraction** | Precision Extraction Tool | Precise extraction by line range<br>Preserves original formatting and indentation<br>Includes position metadata<br>Efficient processing of large files | Zero-loss format preservation<br>Memory-optimized algorithms<br>Streaming processing support |
 | **🔍 Advanced Query Filtering** | Multi-dimensional Filters | **Exact match**: `--filter "name=main"`<br>**Pattern match**: `--filter "name=~auth*"`<br>**Parameter filter**: `--filter "params=2"`<br>**Modifier filter**: `--filter "static=true,public=true"`<br>**Compound conditions**: Combine multiple conditions for precise queries | Flexible query syntax<br>High-performance indexing<br>Intelligent caching mechanisms |
 | **🔗 AI Assistant Integration** | MCP Protocol Support | **Claude Desktop** - Full MCP support<br>**Cursor IDE** - Built-in MCP integration<br>**Roo Code** - MCP protocol support<br>**Other MCP-compatible tools** - Universal MCP server | Standard MCP protocol<br>Plug-and-play design<br>Cross-platform compatibility |
-| **🌍 Multi-language Support** | Enterprise Language Engine | **Java** - Complete support, including Spring, JPA frameworks<br>**Python** - Complete support, including type annotations, decorators<br>**JavaScript** - Enterprise-grade support, including ES6+, React/Vue/Angular, JSX<br>**TypeScript** - **Complete support**, including interfaces, types, decorators, TSX/JSX, framework detection<br>**HTML** - **🆕 Complete support**, including DOM structure, element classification, attribute extraction<br>**CSS** - **🆕 Complete support**, including selector analysis, property classification, style rules<br>**Markdown** - **Complete support**, including headers, code blocks, links, images, tables, task lists, blockquotes<br>**C/C++, Rust, Go** - Basic support | Framework-aware parsing<br>Syntax extension support<br>Continuous language updates |
+| **🌍 Multi-language Support** | Enterprise Language Engine | **Java** - Complete support, including Spring, JPA frameworks<br>**Python** - Complete support, including type annotations, decorators<br>**JavaScript** - Enterprise-grade support, including ES6+, React/Vue/Angular, JSX<br>**TypeScript** - **Complete support**, including interfaces, types, decorators, TSX/JSX, framework detection<br>**HTML** - **🆕 Complete support**, including DOM structure, element classification, attribute extraction<br>**CSS** - **🆕 Complete support**, including selector analysis, property classification, style rules<br>**Markdown** - **Complete support**, including headers, code blocks, links, images, tables, task lists, blockquotes<br><br>**Note**: Currently 7 languages have complete plugin implementations (Java, Python, JavaScript, TypeScript, HTML, CSS, Markdown). Languages such as C/C++, Rust, Go are defined but not yet implemented. | Framework-aware parsing<br>Syntax extension support<br>Continuous language updates |
 | **📁 Advanced File Search** | fd+ripgrep Integration | **ListFilesTool** - Intelligent file discovery with multiple filtering conditions<br>**SearchContentTool** - Intelligent content search using regular expressions<br>**FindAndGrepTool** - Combined discovery and search, two-stage workflow | Rust-based high-performance tools<br>Parallel processing capabilities<br>Intelligent cache optimization |
 | **🏗️ Unified Element System** | Revolutionary Architecture Design | **Single element list** - Unified management of all code elements (classes, methods, fields, imports, packages)<br>**Consistent element types** - Each element has an `element_type` attribute<br>**Simplified API** - Clearer interfaces and reduced complexity<br>**Better maintainability** - Single source of truth for all code elements | Unified data model<br>Type safety guarantees<br>Extensible design |
 
@@ -950,16 +950,56 @@ The project maintains high-quality test coverage. For detailed module coverage i
 ## 9. 📚 Documentation & Support
 
 ### 📖 Complete Documentation
-This project provides complete documentation support, including:
+This project provides complete documentation support:
 
+#### 🎯 Essential Developer Documentation
+- **[Change Management Quick Guide](CHANGE_MANAGEMENT_GUIDE.md)** ⭐ - **PMP vs OpenSpec Usage Rules** (1-minute check)
+- **[PMP-Compliant Document System](docs/ja/README.md)** - Complete guide for project management, feature specifications, and test management
+  - [Project Charter](docs/ja/project-management/00_プロジェクト憲章.md) - Overall project vision
+  - [Change Management Policy](docs/ja/project-management/05_変更管理方針.md) - Detailed change management rules
+  - [Quality Management Plan](docs/ja/project-management/03_品質管理計画.md) - Quality standards and KPIs
+  - [Test Strategy](docs/ja/test-management/00_テスト戦略.md) - Testing approach (3,370+ cases)
+
+#### 📚 User Documentation
 - **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
+
+#### 🔧 Technical Documentation
 - **Contributing Guide** - See [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) for development guidelines and document management
 - **Analysis Results** - See [docs/analysis/](docs/analysis/) for project analysis reports and metrics
 - **Feature Specifications** - See [specs/](specs/) for detailed feature specifications and implementation plans
 
+### 🔄 MCP Compatibility Testing
+For developers working with multiple versions of tree-sitter-analyzer, we provide a comprehensive compatibility testing framework, now featuring a **Smart JSON Comparison System**.
+
+- **[MCP Compatibility Test Standard](docs/mcp_compatibility_test_standard.md)** - Complete standardized process for version compatibility testing
+- **[Compatibility Test Tools](compatibility_test/README.md)** - Automated testing tools and scripts for version comparison
+- **[Troubleshooting Guide](compatibility_test/troubleshooting_guide.md)** - Solutions for common compatibility testing issues
+
+**Technical Documentation:**
+- **[MCP Direct Execution Technical Background](compatibility_test/MCP_DIRECT_EXECUTION_TECHNICAL_BACKGROUND.md)** - Technical rationale for why compatibility tests can execute tool classes directly without MCP server
+- **[Smart JSON Comparison System](docs/SMART_JSON_COMPARISON_SYSTEM.md)** - In-depth explanation of the new configuration-driven comparison system.
+
+**Key Features:**
+- **Smart JSON Comparison**: Advanced, configuration-driven comparison of complex JSON outputs.
+- **Configuration-Driven**: Use `comparison_config.json` to define comparison rules, ignore fields, and normalize data.
+- **Performance Field Filtering**: Automatically ignores volatile performance fields (e.g., `execution_time`) for stable comparisons.
+- **Array Normalization**: Normalizes and sorts arrays based on a specified key, ensuring order-independent comparisons.
+- **Normalized Output Generation**: Create normalized versions of JSON files for easier manual review and debugging.
+- **Deep Difference Analysis**: Utilizes the `deepdiff` library for granular and interpretable difference reporting.
+
+**Quick Start:**
+```bash
+# Run a standard comparison between two versions
+python compatibility_test/scripts/run_compatibility_test.py --version-a 1.9.2 --version-b 1.9.3
+
+# Use the smart comparison feature for complex JSON outputs
+python compatibility_test/scripts/analyze_differences.py --version-a 1.9.2 --version-b 1.9.3 --smart-compare --generate-normalized
+
+```
+
 ### 🤖 AI Collaboration Support
 This project supports AI-assisted development with professional quality control: