mcp-code-indexer 1.5.0__tar.gz → 1.6.0__tar.gz

{mcp_code_indexer-1.5.0/src/mcp_code_indexer.egg-info → mcp_code_indexer-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-code-indexer
-Version: 1.5.0
+Version: 1.6.0
 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.
 Author: MCP Code Indexer Contributors
 Maintainer: MCP Code Indexer Contributors
@@ -57,8 +57,8 @@ Dynamic: requires-python
 
 # MCP Code Indexer 🚀
 
-[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?3)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?3)](https://pypi.org/project/mcp-code-indexer/)
+[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?4)](https://badge.fury.io/py/mcp-code-indexer)
+[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?4)](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. Instead of repeatedly scanning files, agents get instant access to intelligent descriptions, semantic search, and context-aware recommendations.
@@ -246,6 +246,28 @@ The server provides **11 powerful MCP tools** for intelligent codebase managemen
 
 💡 **Pro Tip**: Always start with `check_codebase_size` to get personalized recommendations for navigating your specific codebase.
 
+## 🔗 Git Hook Integration
+
+Keep your codebase documentation automatically synchronized with automated analysis on every commit, rebase, or merge:
+
+```bash
+# Analyze current staged changes
+mcp-code-indexer --githook
+
+# Analyze a specific commit
+mcp-code-indexer --githook abc123def
+
+# Analyze a commit range (perfect for rebases)
+mcp-code-indexer --githook abc123 def456
+```
+
+**🎯 Perfect for**:
+- **Automated documentation** that never goes stale
+- **Rebase-aware analysis** that handles complex git operations
+- **Zero-effort maintenance** with background processing
+
+See the **[Git Hook Setup Guide](docs/git-hook-setup.md)** for complete installation instructions including post-commit, post-merge, and post-rewrite hooks.
+
 ## 🏗️ Architecture Highlights
 
 ### Performance Optimized

{mcp_code_indexer-1.5.0 → mcp_code_indexer-1.6.0}/README.md

@@ -1,7 +1,7 @@
 # MCP Code Indexer 🚀
 
-[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?3)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?3)](https://pypi.org/project/mcp-code-indexer/)
+[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?4)](https://badge.fury.io/py/mcp-code-indexer)
+[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?4)](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. Instead of repeatedly scanning files, agents get instant access to intelligent descriptions, semantic search, and context-aware recommendations.
@@ -189,6 +189,28 @@ The server provides **11 powerful MCP tools** for intelligent codebase managemen
 
 💡 **Pro Tip**: Always start with `check_codebase_size` to get personalized recommendations for navigating your specific codebase.
 
+## 🔗 Git Hook Integration
+
+Keep your codebase documentation automatically synchronized with automated analysis on every commit, rebase, or merge:
+
+```bash
+# Analyze current staged changes
+mcp-code-indexer --githook
+
+# Analyze a specific commit
+mcp-code-indexer --githook abc123def
+
+# Analyze a commit range (perfect for rebases)
+mcp-code-indexer --githook abc123 def456
+```
+
+**🎯 Perfect for**:
+- **Automated documentation** that never goes stale
+- **Rebase-aware analysis** that handles complex git operations
+- **Zero-effort maintenance** with background processing
+
+See the **[Git Hook Setup Guide](docs/git-hook-setup.md)** for complete installation instructions including post-commit, post-merge, and post-rewrite hooks.
+
 ## 🏗️ Architecture Highlights
 
 ### Performance Optimized

{mcp_code_indexer-1.5.0 → mcp_code_indexer-1.6.0}/docs/git-hook-setup.md

@@ -40,11 +40,25 @@ Before setting up automatic hooks, test the functionality manually:
 # Navigate to your git project
 cd /path/to/your/project
 
-# Test git hook analysis on recent changes
+# Test git hook analysis on recent changes (staged changes)
 mcp-code-indexer --githook
+
+# Or analyze a specific commit
+mcp-code-indexer --githook abc123def
+
+# Or analyze a range of commits (useful for rebases)
+mcp-code-indexer --githook abc123..def456
 ```
 
-**What you'll see**: The tool analyzes recent git changes and updates descriptions for modified files.
+**What you'll see**: The tool analyzes git changes and updates descriptions for modified files.
+
+### Usage Modes
+
+The `--githook` command supports three modes:
+
+1. **Current Changes** (default): `--githook` - Analyzes staged changes
+2. **Specific Commit**: `--githook COMMIT_HASH` - Analyzes a particular commit
+3. **Commit Range**: `--githook HASH1 HASH2` - Analyzes all commits from HASH1 to HASH2
 
 ### Automatic Setup
 
@@ -90,6 +104,69 @@ Make it executable:
 chmod +x .git/hooks/post-merge
 ```
 
+#### Post-Rewrite Hook (Recommended for Rebases)
+
+For handling **rebases**, **amends**, and other commit-rewriting operations, use the `post-rewrite` hook. This ensures descriptions are updated for all rewritten commits:
+
+Create `.git/hooks/post-rewrite`:
+
+```bash
+#!/bin/bash
+set -eo pipefail
+
+# MCP Code Indexer - Auto-update descriptions after rebase/amend
+
+cd "$(git rev-parse --show-toplevel)"
+
+# Read the list of rewritten commits from stdin
+first_hash=""
+last_hash=""
+count=0
+
+while read -r old_sha new_sha; do
+  # Skip invalid lines (e.g., comments)
+  [[ "$old_sha" =~ ^# ]] && continue
+  
+  # Track first and last commits
+  if [ $count -eq 0 ]; then
+    first_hash="$new_sha"
+  fi
+  last_hash="$new_sha"
+  ((count++))
+done < "$1"
+
+# Process the commit range if we have commits
+if [ $count -gt 0 ]; then
+  if [ $count -eq 1 ]; then
+    # Single commit
+    mcp-code-indexer --githook "$first_hash" >> ~/.mcp-code-index/githook.log 2>&1 &
+  else
+    # Commit range - use first commit's parent to last commit
+    parent_hash=$(git rev-parse "${first_hash}~1" 2>/dev/null || echo "")
+    if [ -n "$parent_hash" ]; then
+      mcp-code-indexer --githook "$parent_hash" "$last_hash" >> ~/.mcp-code-index/githook.log 2>&1 &
+    else
+      # If no parent (first commit), process each individually
+      mcp-code-indexer --githook "$first_hash" >> ~/.mcp-code-index/githook.log 2>&1 &
+    fi
+  fi
+  disown  # Detach background process
+fi
+
+exit 0
+```
+
+Make it executable:
+```bash
+chmod +x .git/hooks/post-rewrite
+```
+
+**🎯 Why Post-Rewrite?**
+- **Handles rebases**: Processes all rewritten commits after `git rebase`
+- **Non-blocking**: Runs in background, doesn't slow down git operations  
+- **Efficient**: Processes commit ranges instead of individual commits
+- **Comprehensive**: Works with `git commit --amend`, interactive rebases, etc.
+
 ## 🔧 Configuration Options
 
 ### Environment Variables

{mcp_code_indexer-1.5.0 → mcp_code_indexer-1.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mcp-code-indexer"
-version = "1.5.0"
+version = "1.6.0"
 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."
 readme = "README.md"
 license = {text = "MIT"}

{mcp_code_indexer-1.5.0 → mcp_code_indexer-1.6.0}/setup.py

@@ -21,7 +21,7 @@ def get_version():
         return data["project"]["version"]
     except Exception:
         # Fallback version if reading fails
-        return "1.5.0"
+        return "1.6.0"
 
 setup(
     name="mcp-code-indexer",

{mcp_code_indexer-1.5.0 → mcp_code_indexer-1.6.0}/src/mcp_code_indexer/__init__.py

@@ -6,7 +6,7 @@ intelligent codebase navigation through searchable file descriptions,
 token-aware overviews, and advanced merge capabilities.
 """
 
-__version__ = "1.5.0"
+__version__ = "1.6.0"
 __author__ = "MCP Code Indexer Contributors"
 __email__ = ""
 __license__ = "MIT"

{mcp_code_indexer-1.5.0 → mcp_code_indexer-1.6.0}/src/mcp_code_indexer/git_hook_handler.py

@@ -73,19 +73,34 @@ class GitHookHandler:
         if not self.api_key:
             raise GitHookError("OPENROUTER_API_KEY environment variable is required for git hook mode")
     
-    async def run_githook_mode(self) -> None:
+    async def run_githook_mode(
+        self, 
+        commit_hash: Optional[str] = None, 
+        commit_range: Optional[Tuple[str, str]] = None
+    ) -> None:
         """
         Run in git hook mode - analyze changes and update descriptions.
         
+        Args:
+            commit_hash: Process a specific commit by hash
+            commit_range: Process commits in range (start_hash, end_hash)
+        
         This is the main entry point for git hook functionality.
         """
         try:
             # Get git info from current directory
             project_info = await self._identify_project_from_git()
             
-            # Get git diff and commit message
-            git_diff = await self._get_git_diff()
-            commit_message = await self._get_commit_message()
+            # Get git diff and commit message based on mode
+            if commit_hash:
+                git_diff = await self._get_git_diff_for_commit(commit_hash)
+                commit_message = await self._get_commit_message_for_commit(commit_hash)
+            elif commit_range:
+                git_diff = await self._get_git_diff_for_range(commit_range[0], commit_range[1])
+                commit_message = await self._get_commit_messages_for_range(commit_range[0], commit_range[1])
+            else:
+                git_diff = await self._get_git_diff()
+                commit_message = await self._get_commit_message()
             
             if not git_diff or len(git_diff) > self.config["max_diff_size"]:
                 self.logger.info(f"Skipping git hook update - diff too large or empty")
@@ -224,6 +239,97 @@ class GitHookHandler:
         except subprocess.CalledProcessError:
             # If no commits exist yet, return empty string
             return ""
+
+    async def _get_git_diff_for_commit(self, commit_hash: str) -> str:
+        """
+        Get git diff for a specific commit.
+        
+        Args:
+            commit_hash: The commit hash to analyze
+            
+        Returns:
+            Git diff content as string
+        """
+        try:
+            # Get diff for the specific commit compared to its parent
+            diff_result = await self._run_git_command([
+                "diff", "--no-color", "--no-ext-diff", f"{commit_hash}~1..{commit_hash}"
+            ])
+            return diff_result
+            
+        except subprocess.CalledProcessError:
+            # If parent doesn't exist (first commit), diff against empty tree
+            try:
+                diff_result = await self._run_git_command([
+                    "diff", "--no-color", "--no-ext-diff", "4b825dc642cb6eb9a060e54bf8d69288fbee4904", commit_hash
+                ])
+                return diff_result
+            except subprocess.CalledProcessError as e:
+                raise GitHookError(f"Failed to get git diff for commit {commit_hash}: {e}")
+
+    async def _get_git_diff_for_range(self, start_hash: str, end_hash: str) -> str:
+        """
+        Get git diff for a range of commits.
+        
+        Args:
+            start_hash: Starting commit hash (exclusive)
+            end_hash: Ending commit hash (inclusive)
+            
+        Returns:
+            Git diff content as string
+        """
+        try:
+            diff_result = await self._run_git_command([
+                "diff", "--no-color", "--no-ext-diff", f"{start_hash}..{end_hash}"
+            ])
+            return diff_result
+        except subprocess.CalledProcessError as e:
+            raise GitHookError(f"Failed to get git diff for range {start_hash}..{end_hash}: {e}")
+
+    async def _get_commit_message_for_commit(self, commit_hash: str) -> str:
+        """
+        Get the commit message for a specific commit.
+        
+        Args:
+            commit_hash: The commit hash
+            
+        Returns:
+            Commit message as string
+        """
+        try:
+            message_result = await self._run_git_command([
+                "log", "-1", "--pretty=%B", commit_hash
+            ])
+            return message_result.strip()
+        except subprocess.CalledProcessError as e:
+            raise GitHookError(f"Failed to get commit message for {commit_hash}: {e}")
+
+    async def _get_commit_messages_for_range(self, start_hash: str, end_hash: str) -> str:
+        """
+        Get commit messages for a range of commits.
+        
+        Args:
+            start_hash: Starting commit hash (exclusive)
+            end_hash: Ending commit hash (inclusive)
+            
+        Returns:
+            Combined commit messages as string
+        """
+        try:
+            # Get all commit messages in the range
+            message_result = await self._run_git_command([
+                "log", "--pretty=%B", f"{start_hash}..{end_hash}"
+            ])
+            
+            # Clean up and format the messages
+            messages = message_result.strip()
+            if messages:
+                return f"Combined commit messages for range {start_hash}..{end_hash}:\n\n{messages}"
+            else:
+                return f"No commits found in range {start_hash}..{end_hash}"
+                
+        except subprocess.CalledProcessError as e:
+            raise GitHookError(f"Failed to get commit messages for range {start_hash}..{end_hash}: {e}")
     
     def _extract_changed_files(self, git_diff: str) -> List[str]:
         """

{mcp_code_indexer-1.5.0 → mcp_code_indexer-1.6.0}/src/mcp_code_indexer/main.py

@@ -82,8 +82,11 @@ def parse_arguments() -> argparse.Namespace:
     
     parser.add_argument(
         "--githook",
-        action="store_true",
-        help="Git hook mode: auto-update descriptions based on git diff using OpenRouter API"
+        nargs="*",
+        metavar="COMMIT_HASH",
+        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)"
     )
     
     parser.add_argument(
@@ -462,12 +465,16 @@ async def handle_githook(args: argparse.Namespace) -> None:
         from .database.database import DatabaseManager
         from .git_hook_handler import GitHookHandler
         
+        # Process commit hash arguments
+        commit_hashes = args.githook if args.githook else []
+        
         logger.info("Starting git hook execution", extra={
             "structured_data": {
                 "args": {
                     "db_path": str(args.db_path),
                     "cache_dir": str(args.cache_dir),
-                    "token_limit": args.token_limit
+                    "token_limit": args.token_limit,
+                    "commit_hashes": commit_hashes
                 }
             }
         })
@@ -497,7 +504,17 @@ async def handle_githook(args: argparse.Namespace) -> None:
         
         # Run git hook analysis
         logger.info("Starting git hook analysis")
-        await git_handler.run_githook_mode()
+        if len(commit_hashes) == 0:
+            # Process current staged changes
+            await git_handler.run_githook_mode()
+        elif len(commit_hashes) == 1:
+            # Process specific commit
+            await git_handler.run_githook_mode(commit_hash=commit_hashes[0])
+        elif len(commit_hashes) == 2:
+            # Process commit range
+            await git_handler.run_githook_mode(commit_range=(commit_hashes[0], commit_hashes[1]))
+        else:
+            raise ValueError("--githook accepts 0, 1, or 2 commit hashes")
         logger.info("Git hook analysis completed successfully")
         
     except Exception as e:
@@ -682,15 +699,18 @@ def generate_project_markdown(project, branch, overview, files, logger):
     
     markdown_lines = []
     
-    # Project header
-    markdown_lines.append(f"# {project.name}")
+    # Project header with sentence case
+    project_name = project.name.title() if project.name.islower() else project.name
+    markdown_lines.append(f"# {project_name}")
     markdown_lines.append("")
     
     # Project metadata
     if project.remote_origin:
         markdown_lines.append(f"**Repository:** {project.remote_origin}")
+        markdown_lines.append("")
     if project.upstream_origin:
         markdown_lines.append(f"**Upstream:** {project.upstream_origin}")
+        markdown_lines.append("")
     markdown_lines.append(f"**Branch:** {branch}")
     markdown_lines.append("")
     
@@ -768,8 +788,8 @@ async def main() -> None:
     """Main entry point for the MCP server."""
     args = parse_arguments()
     
-    # Handle git hook command
-    if args.githook:
+    # Handle git hook command  
+    if args.githook is not None:
         await handle_githook(args)
         return
     

{mcp_code_indexer-1.5.0 → mcp_code_indexer-1.6.0/src/mcp_code_indexer.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-code-indexer
-Version: 1.5.0
+Version: 1.6.0
 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.
 Author: MCP Code Indexer Contributors
 Maintainer: MCP Code Indexer Contributors
@@ -57,8 +57,8 @@ Dynamic: requires-python
 
 # MCP Code Indexer 🚀
 
-[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?3)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?3)](https://pypi.org/project/mcp-code-indexer/)
+[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?4)](https://badge.fury.io/py/mcp-code-indexer)
+[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?4)](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. Instead of repeatedly scanning files, agents get instant access to intelligent descriptions, semantic search, and context-aware recommendations.
@@ -246,6 +246,28 @@ The server provides **11 powerful MCP tools** for intelligent codebase managemen
 
 💡 **Pro Tip**: Always start with `check_codebase_size` to get personalized recommendations for navigating your specific codebase.
 
+## 🔗 Git Hook Integration
+
+Keep your codebase documentation automatically synchronized with automated analysis on every commit, rebase, or merge:
+
+```bash
+# Analyze current staged changes
+mcp-code-indexer --githook
+
+# Analyze a specific commit
+mcp-code-indexer --githook abc123def
+
+# Analyze a commit range (perfect for rebases)
+mcp-code-indexer --githook abc123 def456
+```
+
+**🎯 Perfect for**:
+- **Automated documentation** that never goes stale
+- **Rebase-aware analysis** that handles complex git operations
+- **Zero-effort maintenance** with background processing
+
+See the **[Git Hook Setup Guide](docs/git-hook-setup.md)** for complete installation instructions including post-commit, post-merge, and post-rewrite hooks.
+
 ## 🏗️ Architecture Highlights
 
 ### Performance Optimized