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

{mcp_code_indexer-1.4.1/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.4.1
+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?2)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?2)](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.4.1 → 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?2)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?2)](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.4.1 → 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.4.1 → mcp_code_indexer-1.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mcp-code-indexer"
-version = "1.4.1"
+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.4.1 → 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.4.1"
+        return "1.6.0"
 
 setup(
     name="mcp-code-indexer",

{mcp_code_indexer-1.4.1 → 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.4.1"
+__version__ = "1.6.0"
 __author__ = "MCP Code Indexer Contributors"
 __email__ = ""
 __license__ = "MIT"

{mcp_code_indexer-1.4.1 → mcp_code_indexer-1.6.0}/src/mcp_code_indexer/database/database.py

@@ -179,6 +179,126 @@ class DatabaseManager:
                     last_accessed=datetime.fromisoformat(row['last_accessed'])
                 )
             return None
+
+    async def find_matching_project(
+        self, 
+        project_name: str, 
+        remote_origin: Optional[str] = None,
+        upstream_origin: Optional[str] = None,
+        folder_path: Optional[str] = None
+    ) -> Optional[Project]:
+        """
+        Find project by matching criteria.
+        
+        Args:
+            project_name: Name of the project
+            remote_origin: Remote origin URL
+            upstream_origin: Upstream origin URL  
+            folder_path: Project folder path
+            
+        Returns:
+            Matching project or None
+        """
+        projects = await self.get_all_projects()
+        normalized_name = project_name.lower()
+        
+        best_match = None
+        best_score = 0
+        
+        for project in projects:
+            score = 0
+            match_factors = []
+            
+            # Check name match (case-insensitive)
+            if project.name.lower() == normalized_name:
+                score += 1
+                match_factors.append("name")
+            
+            # Check remote origin match
+            if remote_origin and project.remote_origin == remote_origin:
+                score += 1
+                match_factors.append("remote_origin")
+            
+            # Check upstream origin match
+            if upstream_origin and project.upstream_origin == upstream_origin:
+                score += 1
+                match_factors.append("upstream_origin")
+            
+            # Check folder path in aliases
+            if folder_path and folder_path in project.aliases:
+                score += 1
+                match_factors.append("folder_path")
+            
+            # Enhanced matching: If name matches and no remote origins are provided,
+            # consider it a strong match to prevent duplicates
+            if (score == 1 and "name" in match_factors and 
+                not remote_origin and not project.remote_origin and
+                not upstream_origin and not project.upstream_origin):
+                logger.info(f"Name-only match with no remotes for project {project.name} - treating as strong match")
+                score = 2  # Boost score to strong match level
+                match_factors.append("no_remotes_boost")
+            
+            # If we have 2+ matches, this is a strong candidate
+            if score >= 2:
+                if score > best_score:
+                    best_score = score
+                    best_match = project
+                    logger.info(f"Strong match for project {project.name} (score: {score}, factors: {match_factors})")
+        
+        return best_match
+
+    async def get_or_create_project(
+        self,
+        project_name: str,
+        folder_path: str,
+        remote_origin: Optional[str] = None,
+        upstream_origin: Optional[str] = None
+    ) -> Project:
+        """
+        Get or create a project using intelligent matching.
+        
+        Args:
+            project_name: Name of the project
+            folder_path: Project folder path
+            remote_origin: Remote origin URL
+            upstream_origin: Upstream origin URL
+            
+        Returns:
+            Existing or newly created project
+        """
+        # Try to find existing project
+        project = await self.find_matching_project(
+            project_name, remote_origin, upstream_origin, folder_path
+        )
+        
+        if project:
+            # Update aliases if folder path not already included
+            if folder_path not in project.aliases:
+                project.aliases.append(folder_path)
+                await self.update_project(project)
+                logger.info(f"Added folder path {folder_path} to project {project.name} aliases")
+            
+            # Update access time
+            await self.update_project_access_time(project.id)
+            return project
+        
+        # Create new project
+        from ..database.models import Project
+        import uuid
+        
+        new_project = Project(
+            id=str(uuid.uuid4()),
+            name=project_name,
+            remote_origin=remote_origin,
+            upstream_origin=upstream_origin,
+            aliases=[folder_path],
+            created=datetime.utcnow(),
+            last_accessed=datetime.utcnow()
+        )
+        
+        await self.create_project(new_project)
+        logger.info(f"Created new project: {new_project.name} ({new_project.id})")
+        return new_project
     
     async def update_project_access_time(self, project_id: str) -> None:
         """Update the last accessed time for a project."""

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

@@ -73,18 +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
-            git_diff = await self._get_git_diff()
+            # 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")
@@ -102,6 +118,7 @@ class GitHookHandler:
             # Build prompt for OpenRouter
             prompt = self._build_githook_prompt(
                 git_diff, 
+                commit_message,
                 current_overview, 
                 current_descriptions,
                 changed_files
@@ -204,6 +221,115 @@ class GitHookHandler:
                 return diff_result
             except subprocess.CalledProcessError as e:
                 raise GitHookError(f"Failed to get git diff: {e}")
+
+    async def _get_commit_message(self) -> str:
+        """
+        Get the commit message for context about what was changed.
+        
+        Returns:
+            Commit message as string
+        """
+        try:
+            # Get the commit message from the latest commit
+            message_result = await self._run_git_command([
+                "log", "-1", "--pretty=%B"
+            ])
+            return message_result.strip()
+            
+        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]:
         """
@@ -232,12 +358,12 @@ class GitHookHandler:
     async def _get_project_overview(self, project_info: Dict[str, Any]) -> str:
         """Get current project overview from database."""
         try:
-            # Try to get existing project
-            project = await self.db_manager.get_project(
+            # Try to find existing project
+            project = await self.db_manager.find_matching_project(
                 project_info["projectName"],
-                project_info["folderPath"],
                 project_info.get("remoteOrigin"),
-                project_info.get("upstreamOrigin")
+                project_info.get("upstreamOrigin"),
+                project_info["folderPath"]
             )
             
             if project:
@@ -255,12 +381,12 @@ class GitHookHandler:
     async def _get_all_descriptions(self, project_info: Dict[str, Any]) -> Dict[str, str]:
         """Get all current file descriptions from database."""
         try:
-            # Try to get existing project
-            project = await self.db_manager.get_project(
+            # Try to find existing project
+            project = await self.db_manager.find_matching_project(
                 project_info["projectName"],
-                project_info["folderPath"],
                 project_info.get("remoteOrigin"),
-                project_info.get("upstreamOrigin")
+                project_info.get("upstreamOrigin"),
+                project_info["folderPath"]
             )
             
             if project:
@@ -278,6 +404,7 @@ class GitHookHandler:
     def _build_githook_prompt(
         self, 
         git_diff: str, 
+        commit_message: str,
         overview: str, 
         descriptions: Dict[str, str], 
         changed_files: List[str]
@@ -287,6 +414,7 @@ class GitHookHandler:
         
         Args:
             git_diff: Git diff content
+            commit_message: Commit message explaining the changes
             overview: Current project overview
             descriptions: Current file descriptions
             changed_files: List of changed file paths
@@ -294,7 +422,10 @@ class GitHookHandler:
         Returns:
             Formatted prompt for the API
         """
-        return f"""Analyze this git diff and update the file descriptions and project overview as needed.
+        return f"""Analyze this git commit and update the file descriptions and project overview as needed.
+
+COMMIT MESSAGE:
+{commit_message or "No commit message available"}
 
 CURRENT PROJECT OVERVIEW:
 {overview or "No overview available"}
@@ -310,10 +441,12 @@ CHANGED FILES:
 
 INSTRUCTIONS:
 
-1. **File Descriptions**: Update descriptions for any files that have changed significantly. Only include files that need actual description updates.
+Use the COMMIT MESSAGE to understand the intent and context of the changes. The commit message explains what the developer was trying to accomplish.
+
+1. **File Descriptions**: Update descriptions for any files that have changed significantly. Consider both the diff content and the commit message context. Only include files that need actual description updates.
 
 2. **Project Overview**: Update ONLY if there are major structural changes like:
-   - New major features or components
+   - New major features or components (which may be indicated by commit message)
    - Architectural changes (new patterns, frameworks, or approaches)
    - Significant dependency additions
    - New API endpoints or workflows
@@ -485,22 +618,36 @@ Return ONLY the JSON, no other text."""
             # Update file descriptions
             file_updates = updates.get("file_updates", {})
             for file_path, description in file_updates.items():
-                await self.db_manager.upsert_file_description(
+                from mcp_code_indexer.database.models import FileDescription
+                from datetime import datetime
+                
+                file_desc = FileDescription(
                     project_id=project.id,
                     branch=project_info["branch"],
                     file_path=file_path,
-                    description=description
+                    description=description,
+                    file_hash=None,
+                    last_modified=datetime.utcnow(),
+                    version=1
                 )
+                await self.db_manager.create_file_description(file_desc)
                 self.logger.info(f"Updated description for {file_path}")
             
             # Update project overview if provided
             overview_update = updates.get("overview_update")
             if overview_update and overview_update.strip():
-                await self.db_manager.upsert_project_overview(
+                from mcp_code_indexer.database.models import ProjectOverview
+                from datetime import datetime
+                
+                overview = ProjectOverview(
                     project_id=project.id,
                     branch=project_info["branch"],
-                    overview=overview_update
+                    overview=overview_update,
+                    last_modified=datetime.utcnow(),
+                    total_files=len(file_updates),
+                    total_tokens=len(overview_update.split())
                 )
+                await self.db_manager.create_project_overview(overview)
                 self.logger.info("Updated project overview")
             
         except Exception as e:

{mcp_code_indexer-1.4.1 → 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:
@@ -510,6 +527,14 @@ async def handle_githook(args: argparse.Namespace) -> None:
         print(f"Git hook error: {e}", file=sys.stderr)
         sys.exit(1)
     finally:
+        # Clean up database connections
+        if 'db_manager' in locals():
+            try:
+                await db_manager.close_pool()
+                logger.debug("Database connections closed")
+            except Exception as e:
+                logger.warning(f"Error closing database connections: {e}")
+        
         logger.info("=== GITHOOK SESSION ENDED ===")
         
         # Close logger handlers to flush any remaining logs
@@ -674,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("")
     
@@ -760,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.4.1 → 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.4.1
+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?2)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?2)](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