mcp-code-indexer 3.4.0__tar.gz → 3.4.2__tar.gz

{mcp_code_indexer-3.4.0 → mcp_code_indexer-3.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mcp-code-indexer
-Version: 3.4.0
+Version: 3.4.2
 Summary: MCP server that tracks file descriptions across codebases, enabling AI agents to efficiently navigate and understand code through searchable summaries and token-aware overviews.
 License: MIT
 Keywords: mcp,model-context-protocol,code-indexer,ai-tools,codebase-navigation,file-descriptions,llm-tools
@@ -40,8 +40,8 @@ Description-Content-Type: text/markdown
 
 # MCP Code Indexer 🚀
 
-[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?31)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?31)](https://pypi.org/project/mcp-code-indexer/)
+[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?33)](https://badge.fury.io/py/mcp-code-indexer)
+[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?33)](https://pypi.org/project/mcp-code-indexer/)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 A production-ready **Model Context Protocol (MCP) server** that revolutionizes how AI agents navigate and understand codebases. Built for high-concurrency environments with advanced database resilience, the server provides instant access to intelligent descriptions, semantic search, and context-aware recommendations while maintaining 800+ writes/sec throughput.
@@ -245,8 +245,14 @@ mcp-code-indexer --githook
 # Analyze a specific commit
 mcp-code-indexer --githook abc123def
 
+# Analyze using HEAD syntax
+mcp-code-indexer --githook HEAD
+mcp-code-indexer --githook HEAD~1
+mcp-code-indexer --githook HEAD~3
+
 # Analyze a commit range (perfect for rebases)
 mcp-code-indexer --githook abc123 def456
+mcp-code-indexer --githook HEAD~5 HEAD
 ```
 
 **🎯 Perfect for**:

{mcp_code_indexer-3.4.0 → mcp_code_indexer-3.4.2}/README.md

@@ -1,7 +1,7 @@
 # MCP Code Indexer 🚀
 
-[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?31)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?31)](https://pypi.org/project/mcp-code-indexer/)
+[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?33)](https://badge.fury.io/py/mcp-code-indexer)
+[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?33)](https://pypi.org/project/mcp-code-indexer/)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 A production-ready **Model Context Protocol (MCP) server** that revolutionizes how AI agents navigate and understand codebases. Built for high-concurrency environments with advanced database resilience, the server provides instant access to intelligent descriptions, semantic search, and context-aware recommendations while maintaining 800+ writes/sec throughput.
@@ -205,8 +205,14 @@ mcp-code-indexer --githook
 # Analyze a specific commit
 mcp-code-indexer --githook abc123def
 
+# Analyze using HEAD syntax
+mcp-code-indexer --githook HEAD
+mcp-code-indexer --githook HEAD~1
+mcp-code-indexer --githook HEAD~3
+
 # Analyze a commit range (perfect for rebases)
 mcp-code-indexer --githook abc123 def456
+mcp-code-indexer --githook HEAD~5 HEAD
 ```
 
 **🎯 Perfect for**:

{mcp_code_indexer-3.4.0 → mcp_code_indexer-3.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "mcp-code-indexer"
-version = "3.4.0"
+version = "3.4.2"
 description = "MCP server that tracks file descriptions across codebases, enabling AI agents to efficiently navigate and understand code through searchable summaries and token-aware overviews."
 authors = ["MCP Code Indexer Contributors"]
 maintainers = ["MCP Code Indexer Contributors"]

{mcp_code_indexer-3.4.0 → mcp_code_indexer-3.4.2}/src/mcp_code_indexer/git_hook_handler.py

@@ -88,6 +88,21 @@ class GitHookHandler:
                 "OPENROUTER_API_KEY environment variable is required for git hook mode"
             )
 
+    def _log_and_print(self, message: str, level: str = "info") -> None:
+        """
+        Log message and also print to stdout for user visibility.
+        
+        Args:
+            message: Message to log and print
+            level: Log level (info, warning, error)
+        """
+        # Log to logger
+        getattr(self.logger, level)(message)
+        
+        # Also print to stdout with prefix for visibility
+        prefix = "🔍" if level == "info" else "⚠️" if level == "warning" else "❌"
+        print(f"{prefix} {message}")
+
     async def run_githook_mode(
         self,
         commit_hash: Optional[str] = None,
@@ -103,21 +118,20 @@ class GitHookHandler:
         This is the main entry point for git hook functionality.
         """
         try:
-            self.logger.info("=== Git Hook Analysis Started ===")
+            self._log_and_print("=== Git Hook Analysis Started ===")
             if commit_hash:
-                self.logger.info(f"Mode: Single commit ({commit_hash})")
+                self._log_and_print(f"Mode: Single commit ({commit_hash})")
             elif commit_range:
-                self.logger.info(
+                self._log_and_print(
                     f"Mode: Commit range ({commit_range[0]}..{commit_range[1]})"
                 )
             else:
-                self.logger.info("Mode: Staged changes")
+                self._log_and_print("Mode: Staged changes")
 
             # Get git info from current directory
             project_info = await self._identify_project_from_git()
-            self.logger.info(
-                f"Project identified: {project_info.get('name', 'Unknown')} "
-                f"at {project_info.get('folderPath', 'Unknown')}"
+            self._log_and_print(
+                f"Project: {project_info.get('name', 'Unknown')}"
             )
 
             # Get git diff and commit message based on mode
@@ -137,25 +151,23 @@ class GitHookHandler:
 
             # Log diff details
             if not git_diff:
-                self.logger.info("Skipping git hook update - no git diff")
+                self._log_and_print("No changes detected, skipping analysis")
                 return
 
             diff_tokens = self.token_counter.count_tokens(git_diff)
-            self.logger.info(f"Git diff: {diff_tokens} tokens")
+            self._log_and_print(f"Analyzing diff: {diff_tokens:,} tokens")
 
             # Fetch current state
-            self.logger.info("Fetching current project state...")
+            self._log_and_print("Fetching current project state...")
             current_overview = await self._get_project_overview(project_info)
             current_descriptions = await self._get_all_descriptions(project_info)
             changed_files = self._extract_changed_files(git_diff)
 
             if not changed_files:
-                self.logger.info("No changed files detected in git diff")
+                self._log_and_print("No files changed, skipping analysis")
                 return
 
-            self.logger.info(
-                f"Found {len(changed_files)} changed files: {', '.join(changed_files)}"
-            )
+            self._log_and_print(f"Found {len(changed_files)} changed files")
             overview_tokens = (
                 self.token_counter.count_tokens(current_overview)
                 if current_overview
@@ -175,13 +187,23 @@ class GitHookHandler:
 
             # Apply updates to database
             await self._apply_updates(project_info, updates)
-
-            self.logger.info(
-                f"Git hook update completed successfully for {len(changed_files)} files"
-            )
+            
+            # Count actual updates
+            file_update_count = len(updates.get("file_updates", {}))
+            overview_updated = bool(updates.get("overview_update"))
+            
+            if file_update_count > 0 or overview_updated:
+                update_parts = []
+                if file_update_count > 0:
+                    update_parts.append(f"{file_update_count} file descriptions")
+                if overview_updated:
+                    update_parts.append("project overview")
+                self._log_and_print(f"✅ Updated {' and '.join(update_parts)}")
+            else:
+                self._log_and_print("✅ Analysis complete, no updates needed")
 
         except Exception as e:
-            self.logger.error(f"Git hook mode failed: {e}")
+            self._log_and_print(f"Git hook analysis failed: {e}", "error")
             self.logger.error(f"Exception details: {type(e).__name__}: {str(e)}")
             import traceback
 
@@ -230,16 +252,12 @@ class GitHookHandler:
 
         if prompt_tokens <= token_limit:
             # Use single-stage approach
-            self.logger.info("Using single-stage analysis (within token limit)")
+            self._log_and_print("Using single-stage analysis")
             result = await self._call_openrouter(single_stage_prompt)
-            self.logger.info("Single-stage analysis completed")
             return result
         else:
             # Fall back to two-stage approach
-            self.logger.info(
-                f"Single-stage prompt too large ({prompt_tokens} tokens), "
-                f"falling back to two-stage analysis"
-            )
+            self._log_and_print("Using two-stage analysis (large diff)")
 
             # Try two-stage analysis first
             try:
@@ -250,9 +268,8 @@ class GitHookHandler:
             except GitHookError as e:
                 if "too large" in str(e).lower():
                     # Fall back to chunked processing
-                    self.logger.info(
-                        "Two-stage analysis failed due to size, "
-                        "falling back to chunked processing"
+                    self._log_and_print(
+                        "Using chunked processing (very large diff)"
                     )
                     return await self._analyze_with_chunking(
                         git_diff, commit_message, current_overview,
@@ -634,7 +651,7 @@ Return ONLY a JSON object:
         Returns:
             Dict containing file_updates and overview_update
         """
-        self.logger.info(
+        self._log_and_print(
             f"Starting chunked processing for {len(changed_files)} files"
         )
 
@@ -650,7 +667,7 @@ Return ONLY a JSON object:
             git_diff, changed_files
         )
         
-        self.logger.info(f"Using chunk size of {chunk_size} files per chunk")
+        self._log_and_print(f"Processing in {chunk_size}-file chunks")
         
         all_file_updates = {}
         
@@ -659,7 +676,7 @@ Return ONLY a JSON object:
             chunk_number = (i // chunk_size) + 1
             total_chunks = (len(changed_files) + chunk_size - 1) // chunk_size
             
-            self.logger.info(
+            self._log_and_print(
                 f"Processing chunk {chunk_number}/{total_chunks} "
                 f"({len(chunk_files)} files)"
             )

{mcp_code_indexer-3.4.0 → mcp_code_indexer-3.4.2}/src/mcp_code_indexer/main.py

@@ -63,7 +63,7 @@ def parse_arguments() -> argparse.Namespace:
     parser.add_argument(
         "--getprojects",
         action="store_true",
-        help="List all projects with IDs, branches, and description counts",
+        help="List all projects with IDs and file description counts",
     )
 
     parser.add_argument(
@@ -75,10 +75,10 @@ def parse_arguments() -> argparse.Namespace:
     parser.add_argument(
         "--dumpdescriptions",
         nargs="+",
-        metavar=("PROJECT_ID", "BRANCH"),
+        metavar="PROJECT_ID",
         help=(
             "Export descriptions for a project. Usage: "
-            "--dumpdescriptions PROJECT_ID [BRANCH]"
+            "--dumpdescriptions PROJECT_ID"
         ),
     )
 
@@ -89,8 +89,8 @@ def parse_arguments() -> argparse.Namespace:
         help=(
             "Git hook mode: auto-update descriptions based on git diff using "
             "OpenRouter API. Usage: --githook (current changes), --githook HASH "
-            "(specific commit), --githook HASH1 HASH2 (commit range from "
-            "HASH1 to HASH2)"
+            "(specific commit), --githook HASH1 HASH2 (commit range). "
+            "Supports: commit hashes, HEAD, HEAD~1, HEAD~3, branch names, tags."
         ),
     )
 
@@ -138,17 +138,12 @@ async def handle_getprojects(args: argparse.Namespace) -> None:
             print(f"ID: {project.id}")
             print(f"Name: {project.name}")
 
-            # Get branch information
+            # Get file description count
             try:
-                branch_counts = await db_manager.get_branch_file_counts(project.id)
-                if branch_counts:
-                    print("Branches:")
-                    for branch, count in branch_counts.items():
-                        print(f"  - {branch}: {count} descriptions")
-                else:
-                    print("Branches: No descriptions found")
+                file_count = await db_manager.get_file_count(project.id)
+                print(f"Files: {file_count} descriptions")
             except Exception as e:
-                print(f"Branches: Error loading branch info - {e}")
+                print(f"Files: Error loading file count - {e}")
 
             print("-" * 80)
 
@@ -288,11 +283,6 @@ async def handle_runcommand(args: argparse.Namespace) -> None:
                 tool_arguments = json_data
                 logger.info("Auto-detected tool: update_file_description")
                 print("Auto-detected tool: update_file_description", file=sys.stderr)
-            elif "branch" in json_data:
-                tool_name = "check_codebase_size"
-                tool_arguments = json_data
-                logger.info("Auto-detected tool: check_codebase_size")
-                print("Auto-detected tool: check_codebase_size", file=sys.stderr)
             else:
                 logger.error(
                     "Could not auto-detect tool from arguments",
@@ -449,7 +439,6 @@ async def handle_dumpdescriptions(args: argparse.Namespace) -> None:
         sys.exit(1)
 
     project_id = args.dumpdescriptions[0]
-    branch = args.dumpdescriptions[1] if len(args.dumpdescriptions) > 1 else None
 
     db_manager = None
     try:
@@ -461,16 +450,10 @@ async def handle_dumpdescriptions(args: argparse.Namespace) -> None:
         token_counter = TokenCounter(args.token_limit)
 
         # Get file descriptions
-        if branch:
-            file_descriptions = await db_manager.get_all_file_descriptions(
-                project_id=project_id, branch=branch
-            )
-            print(f"File descriptions for project {project_id}, branch {branch}:")
-        else:
-            file_descriptions = await db_manager.get_all_file_descriptions(
-                project_id=project_id
-            )
-            print(f"File descriptions for project {project_id} (all branches):")
+        file_descriptions = await db_manager.get_all_file_descriptions(
+            project_id=project_id
+        )
+        print(f"File descriptions for project {project_id}:")
 
         print("=" * 80)
 
@@ -481,8 +464,6 @@ async def handle_dumpdescriptions(args: argparse.Namespace) -> None:
             total_tokens = 0
             for desc in file_descriptions:
                 print(f"File: {desc.file_path}")
-                if branch is None:
-                    print(f"Branch: {desc.branch}")
                 print(f"Description: {desc.description}")
                 print("-" * 40)
 
@@ -714,7 +695,6 @@ async def handle_map(args: argparse.Namespace) -> None:
             sys.exit(1)
 
         project = project_data["project"]
-        branch = project_data["branch"]
         overview = project_data["overview"]
         files = project_data["files"]
 
@@ -723,7 +703,6 @@ async def handle_map(args: argparse.Namespace) -> None:
             extra={
                 "structured_data": {
                     "project_name": project.name,
-                    "branch": branch,
                     "file_count": len(files),
                     "has_overview": overview is not None,
                 }
@@ -732,7 +711,7 @@ async def handle_map(args: argparse.Namespace) -> None:
 
         # Generate markdown
         markdown_content = generate_project_markdown(
-            project, branch, overview, files, logger
+            project, overview, files, logger
         )
 
         # Output the markdown
@@ -766,7 +745,7 @@ async def handle_map(args: argparse.Namespace) -> None:
             logger.removeHandler(handler)
 
 
-def generate_project_markdown(project, branch, overview, files, logger):
+def generate_project_markdown(project, overview, files, logger):
     """Generate the markdown content for the project map."""
     import re
     from collections import defaultdict
@@ -779,10 +758,6 @@ def generate_project_markdown(project, branch, overview, files, logger):
     markdown_lines.append(f"# {project_name}")
     markdown_lines.append("")
 
-    # Project metadata
-    markdown_lines.append(f"**Branch:** {branch}")
-    markdown_lines.append("")
-
     # Project overview (with header demotion if needed)
     if overview and overview.overview:
         markdown_lines.append("## Project Overview")