mcp-vector-search 0.6.1__tar.gz → 0.7.0__tar.gz

mcp_vector_search-0.7.0/.claude/agents/.dependency_cache

@@ -0,0 +1,34 @@
+{
+  "d034497a6e2fd8e364e1ad5c1ee4ede6": {
+    "timestamp": 1759849229.410353,
+    "results": {
+      "agents": {},
+      "summary": {
+        "total_agents": 32,
+        "agents_with_deps": 0,
+        "missing_python": [],
+        "missing_system": [],
+        "satisfied_python": [],
+        "satisfied_system": []
+      }
+    },
+    "deployment_hash": "2936bc4b98d1c0993dc1e13efe429caa81f3cf35e8941325c7d3adec79717a36",
+    "context": {}
+  },
+  "189dd82fac1105048b8504df1b053692": {
+    "timestamp": 1759858420.8634088,
+    "results": {
+      "agents": {},
+      "summary": {
+        "total_agents": 32,
+        "agents_with_deps": 0,
+        "missing_python": [],
+        "missing_system": [],
+        "satisfied_python": [],
+        "satisfied_system": []
+      }
+    },
+    "deployment_hash": "4a42139378fae180d5d7791bfd61fc03b867729b0f81a399413d33c94a441855",
+    "context": {}
+  }
+}

{mcp_vector_search-0.6.1 → mcp_vector_search-0.7.0}/.claude/agents/.mpm_deployment_state

@@ -1,6 +1,6 @@
 {
-  "deployment_hash": "2936bc4b98d1c0993dc1e13efe429caa81f3cf35e8941325c7d3adec79717a36",
-  "last_check_time": 1759849229.410526,
+  "deployment_hash": "4a42139378fae180d5d7791bfd61fc03b867729b0f81a399413d33c94a441855",
+  "last_check_time": 1759858420.863677,
   "last_check_results": {
     "agents": {},
     "summary": {

{mcp_vector_search-0.6.1 → mcp_vector_search-0.7.0}/CLAUDE.md

@@ -64,11 +64,11 @@ This file provides comprehensive guidance for Claude Code (claude.ai/code) and C
 
 ### 🟡 Quick Start for Users (RECOMMENDED WORKFLOW)
 
-**New users should use the enhanced install command:**
+**New users should use the init command:**
 
 ```bash
 # Interactive setup (recommended)
-mcp-vector-search install
+mcp-vector-search init
 
 # This single command will:
 # 1. Initialize project configuration
@@ -77,25 +77,24 @@ mcp-vector-search install
 # 4. Provide next-step hints
 ```
 
-**Advanced install options:**
+**Advanced init options:**
 
 ```bash
 # Skip MCP configuration
-mcp-vector-search install --no-mcp
+mcp-vector-search init --no-mcp
 
 # Skip automatic indexing
-mcp-vector-search install --no-index
-
-# Specify MCP tool directly
-mcp-vector-search install --mcp-tool "Claude Code"
+mcp-vector-search init --no-auto-index
 
 # Custom file extensions
-mcp-vector-search install --extensions .py,.js,.ts,.dart
+mcp-vector-search init --extensions .py,.js,.ts,.dart
 
 # Combine options
-mcp-vector-search install --no-index --mcp-tool "Cursor"
+mcp-vector-search init --no-auto-index --no-mcp
 ```
 
+**Deprecated commands:** The `install` command has been replaced by `init`. Use `mcp-vector-search init` instead.
+
 ### 🔴 Core Architecture (MUST UNDERSTAND)
 - **Vector Database**: ChromaDB with connection pooling (13.6% performance boost)
 - **Embedding Model**: Configurable sentence transformers (default: all-MiniLM-L6-v2)
@@ -120,75 +119,72 @@ make publish       # Publish to PyPI
 make quality       # Run all quality checks (lint, type, test, security)
 ```
 
-## 🔴 Essential Development Commands (CRITICAL - LEARN THESE FIRST)
+## 🔴 Essential Commands (CRITICAL - LEARN THESE FIRST)
 
-### 🔴 Development Setup (REQUIRED)
+### 🔴 Main Commands (ALL USERS MUST KNOW)
 ```bash
-# ONE-COMMAND SETUP (Use this FIRST)
-make dev-setup     # Sets up entire development environment
-
-# Alternative manual setup
-uv sync            # Install dependencies
-uv pip install -e . # Editable install
-
-# Verify installation
-make verify-setup  # Check all tools and dependencies
+# Core Workflow
+mcp-vector-search init          # Initialize project
+mcp-vector-search doctor        # Check system health
+mcp-vector-search status        # Show project status
+mcp-vector-search search "query" # Search code
+mcp-vector-search index         # Index codebase
+mcp-vector-search mcp           # MCP integration
+mcp-vector-search config        # Configuration
+mcp-vector-search help          # Get help
+mcp-vector-search version       # Show version
 ```
 
-### 🔴 Testing (CRITICAL)
+### 🔴 Search Commands (PRIMARY USER INTERFACE)
 ```bash
-# PRIMARY TESTING COMMANDS (use these)
-make test          # Run ALL tests with coverage (MAIN COMMAND)
-make test-quick    # Fast tests without coverage
-make test-unit     # Unit tests only
-make test-integration # Integration tests only
-
-# Specific testing (when needed)
-make test-file FILE=test_indexer.py    # Single test file
-make test-pattern PATTERN="search"      # Pattern matching
-make test-debug    # Tests with debugging output
+# Basic Search
+mcp-vector-search search "authentication"           # Semantic search
+mcp-vector-search search "auth" --language python   # Filter by language
+mcp-vector-search search "error" --files "src/*.py" # Filter by files
+
+# Advanced Search
+mcp-vector-search search "file.py" --similar        # Find similar code
+mcp-vector-search search "impl rate limit" --context # Context search
+
+# Search Subcommands
+mcp-vector-search search interactive   # Interactive mode
+mcp-vector-search search history       # View search history
+mcp-vector-search search favorites list # Manage favorites
 ```
 
-### 🔴 Code Quality (REQUIRED BEFORE COMMITS)
+### 🔴 Index Commands (CODE INDEXING)
 ```bash
-# PRIMARY QUALITY COMMANDS (use these)
-make quality       # Run ALL quality checks (lint, type, security)
-make lint-fix      # Format and auto-fix all issues (MAIN COMMAND)
-make typecheck     # Type checking with mypy
-make security      # Security and safety checks
-
-# Individual tools (for specific issues)
-make format        # Code formatting only
-make lint          # Linting without fixes
+# Indexing
+mcp-vector-search index              # Index all files
+mcp-vector-search index --incremental # Smart incremental index
+
+# Index Subcommands
+mcp-vector-search index watch        # Watch for changes
+mcp-vector-search index auto setup   # Setup auto-indexing
+mcp-vector-search index health       # Check index health
 ```
 
-### 🔴 Building & Releasing (CRITICAL WORKFLOWS)
+### 🔴 Configuration Commands
 ```bash
-# PRIMARY RELEASE COMMANDS (single-path workflows)
-make release-patch # Complete patch release (0.4.0 → 0.4.1)
-make release-minor # Complete minor release (0.4.0 → 0.5.0) 
-make release-major # Complete major release (0.4.0 → 1.0.0)
-make publish       # Publish to PyPI (after release)
-
-# Version management
-make version-show  # Display current version
-make version-check # Validate version consistency
-
-# Build operations
-make build         # Build package for distribution
-make clean         # Clean all build artifacts
+# Config Management
+mcp-vector-search config show        # Show current config
+mcp-vector-search config set key val # Set config value
+mcp-vector-search config models      # List embedding models
+mcp-vector-search config reset       # Reset to defaults
 ```
 
-### 🟡 Local Testing (HIGH PRIORITY)
+### 🟡 Development Commands (FOR CONTRIBUTORS)
 ```bash
-# PRIMARY TESTING WORKFLOWS
-make test-deployment    # Test local deployment
-make test-integration   # Test on sample projects
-make test-mcp          # Test MCP server integration
-
-# Manual testing (when needed)
-./scripts/deploy-test.sh
-cd ~/other-project && mcp-vector-search init && mcp-vector-search index
+# Development Setup
+make dev-setup     # One-command environment setup
+make test          # Run all tests with coverage
+make lint-fix      # Format and fix all issues
+make quality       # All quality checks
+
+# Release Workflow
+make release-patch # Patch release (0.4.0 → 0.4.1)
+make release-minor # Minor release (0.4.0 → 0.5.0)
+make publish       # Publish to PyPI
 ```
 
 ## 🟡 High-Level Architecture (HIGH PRIORITY - UNDERSTAND FOR DEVELOPMENT)
@@ -512,8 +508,34 @@ mcp-vector-search auto-index check --dry-run --verbose
 - Use semantic search commands in Claude Desktop after setup
 - Maintain real-time indexing for best Claude experience
 
+## ⚪ Deprecated Commands (OPTIONAL AWARENESS)
+
+**The following commands are deprecated and will show migration warnings:**
+
+| Old Command | New Command | Reason |
+|-------------|-------------|---------|
+| `install` | `init` | Renamed for clarity |
+| `demo` | `init --help` | Removed |
+| `find` | `search` | Simplified |
+| `search-similar` | `search --similar` | Moved to option |
+| `search-context` | `search --context` | Moved to option |
+| `interactive` | `search interactive` | Moved to subcommand |
+| `history` | `search history` | Moved to subcommand |
+| `favorites` | `search favorites` | Moved to subcommand |
+| `add-favorite` | `search favorites add` | Nested subcommand |
+| `remove-favorite` | `search favorites remove` | Nested subcommand |
+| `health` | `index health` | Moved to subcommand |
+| `watch` | `index watch` | Moved to subcommand |
+| `auto-index` | `index auto` | Moved to subcommand |
+| `reset` | `mcp reset` or `config reset` | Split by function |
+| `init-check` | `init check` | Nested subcommand |
+| `init-mcp` | `mcp install` | Reorganized |
+| `init-models` | `config models` | Reorganized |
+
+**All deprecated commands display helpful migration messages when used.**
+
 ---
 
-**🏆 This CLAUDE.md is optimized for Claude Code and Claude MPM integration.**  
-**📚 Use the priority system (🔴🟡🟢⚪) to focus on what matters most.**  
+**🏆 This CLAUDE.md is optimized for Claude Code and Claude MPM integration.**
+**📚 Use the priority system (🔴🟡🟢⚪) to focus on what matters most.**
 **🔍 Quick reference: `make help` shows all available commands.**

{mcp_vector_search-0.6.1 → mcp_vector_search-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-vector-search
-Version: 0.6.1
+Version: 0.7.0
 Summary: CLI-first semantic code search with MCP integration
 Project-URL: Homepage, https://github.com/bobmatnyc/mcp-vector-search
 Project-URL: Documentation, https://mcp-vector-search.readthedocs.io

{mcp_vector_search-0.6.1 → mcp_vector_search-0.7.0}/src/mcp_vector_search/__init__.py

@@ -1,7 +1,7 @@
 """MCP Vector Search - CLI-first semantic code search with MCP integration."""
 
-__version__ = "0.6.1"
-__build__ = "21"
+__version__ = "0.7.0"
+__build__ = "22"
 __author__ = "Robert Matsuoka"
 __email__ = "bobmatnyc@gmail.com"
 

{mcp_vector_search-0.6.1 → mcp_vector_search-0.7.0}/src/mcp_vector_search/cli/commands/config.py

@@ -347,5 +347,35 @@ def _show_available_keys() -> None:
     )
 
 
+# ============================================================================
+# CONFIG SUBCOMMANDS
+# ============================================================================
+
+
+@config_app.command("models")
+def list_embedding_models() -> None:
+    """📚 List available embedding models.
+
+    Shows all available embedding models that can be used for semantic search.
+    You can also use any model from Hugging Face that's compatible with sentence-transformers.
+
+    Examples:
+        mcp-vector-search config models
+    """
+    from ...config.defaults import DEFAULT_EMBEDDING_MODELS
+
+    console.print("[bold blue]Available Embedding Models:[/bold blue]\n")
+
+    for category, model in DEFAULT_EMBEDDING_MODELS.items():
+        console.print(f"[cyan]{category.title()}:[/cyan] {model}")
+
+    console.print(
+        "\n[dim]You can also use any model from Hugging Face that's compatible with sentence-transformers[/dim]"
+    )
+    console.print(
+        "[dim]Set model: [cyan]mcp-vector-search config set embedding_model MODEL_NAME[/cyan][/dim]"
+    )
+
+
 if __name__ == "__main__":
     config_app()

{mcp_vector_search-0.6.1 → mcp_vector_search-0.7.0}/src/mcp_vector_search/cli/commands/index.py

@@ -495,5 +495,87 @@ async def _clean_index(project_root: Path) -> None:
         print_success("Index cleaned successfully")
 
 
+# ============================================================================
+# INDEX SUBCOMMANDS
+# ============================================================================
+
+
+@index_app.command("watch")
+def watch_cmd(
+    project_root: Path = typer.Argument(
+        Path.cwd(),
+        help="Project root directory to watch",
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        readable=True,
+    ),
+) -> None:
+    """👀 Watch for file changes and auto-update index.
+
+    Monitors your project directory for file changes and automatically updates
+    the search index when files are modified, added, or deleted.
+
+    Examples:
+        mcp-vector-search index watch
+        mcp-vector-search index watch /path/to/project
+    """
+    from .watch import app as watch_app
+
+    # Import and run watch command
+    watch_app()
+
+
+@index_app.command("auto")
+def auto_cmd() -> None:
+    """🔄 Manage automatic indexing.
+
+    Configure automatic indexing strategies like git hooks and scheduled tasks.
+    This command provides subcommands for setup, status, and checking.
+
+    Examples:
+        mcp-vector-search index auto setup
+        mcp-vector-search index auto status
+        mcp-vector-search index auto check
+    """
+    from .auto_index import auto_index_app
+
+    # This will show help for the auto subcommands
+    auto_index_app()
+
+
+@index_app.command("health")
+def health_cmd(
+    project_root: Path | None = typer.Option(
+        None,
+        "--project-root",
+        "-p",
+        help="Project root directory",
+        exists=True,
+        file_okay=False,
+        dir_okay=True,
+        readable=True,
+    ),
+    repair: bool = typer.Option(
+        False,
+        "--repair",
+        help="Attempt to repair index issues",
+    ),
+) -> None:
+    """🩺 Check index health and optionally repair.
+
+    Validates the search index integrity and provides diagnostic information.
+    Can attempt to repair common issues automatically.
+
+    Examples:
+        mcp-vector-search index health
+        mcp-vector-search index health --repair
+    """
+    from .reset import health_main
+
+    # Call the health function from reset.py
+    health_main(project_root=project_root, repair=repair)
+
+
 if __name__ == "__main__":
     index_app()

{mcp_vector_search-0.6.1 → mcp_vector_search-0.7.0}/src/mcp_vector_search/cli/commands/search.py

@@ -20,13 +20,24 @@ from ..output import (
     print_tip,
 )
 
-# Create search subcommand app with "did you mean" functionality (kept for backward compatibility)
-search_app = create_enhanced_typer(help="Search code semantically")
+# Create search subcommand app with "did you mean" functionality
+search_app = create_enhanced_typer(
+    help="🔍 Search code semantically",
+    invoke_without_command=True,
+)
+
 
+# Define search_main as the callback for the search command
+# This makes `mcp-vector-search search "query"` work as main search
+# and `mcp-vector-search search SUBCOMMAND` work for subcommands
 
+
+@search_app.callback(invoke_without_command=True)
 def search_main(
     ctx: typer.Context,
-    query: str = typer.Argument(..., help="Search query or file path (for --similar)"),
+    query: str | None = typer.Argument(
+        None, help="Search query or file path (for --similar)"
+    ),
     project_root: Path | None = typer.Option(
         None,
         "--project-root",
@@ -161,6 +172,15 @@ def search_main(
 
     [dim]💡 Tip: Use quotes for multi-word queries. Adjust --threshold for more/fewer results.[/dim]
     """
+    # If no query provided and no subcommand invoked, exit (show help)
+    if query is None:
+        if ctx.invoked_subcommand is None:
+            # No query and no subcommand - show help
+            raise typer.Exit()
+        else:
+            # A subcommand was invoked - let it handle the request
+            return
+
     try:
         project_root = project_root or ctx.obj.get("project_root") or Path.cwd()
 
@@ -640,10 +660,113 @@ async def run_context_search(
             )
 
 
-# Add commands to search_app for backward compatibility
+# ============================================================================
+# SEARCH SUBCOMMANDS
+# ============================================================================
+
+
+@search_app.command("interactive")
+def interactive_search(
+    ctx: typer.Context,
+    project_root: Path | None = typer.Option(
+        None, "--project-root", "-p", help="Project root directory"
+    ),
+) -> None:
+    """🎯 Start an interactive search session.
+
+    Provides a rich terminal interface for searching your codebase with real-time
+    filtering, query refinement, and result navigation.
+
+    Examples:
+        mcp-vector-search search interactive
+        mcp-vector-search search interactive --project-root /path/to/project
+    """
+    import asyncio
+
+    from ..interactive import start_interactive_search
+    from ..output import console
+
+    root = project_root or ctx.obj.get("project_root") or Path.cwd()
+
+    try:
+        asyncio.run(start_interactive_search(root))
+    except KeyboardInterrupt:
+        console.print("\n[yellow]Interactive search cancelled[/yellow]")
+    except Exception as e:
+        print_error(f"Interactive search failed: {e}")
+        raise typer.Exit(1)
+
+
+@search_app.command("history")
+def show_history(
+    ctx: typer.Context,
+    limit: int = typer.Option(20, "--limit", "-l", help="Number of entries to show"),
+    project_root: Path | None = typer.Option(
+        None, "--project-root", "-p", help="Project root directory"
+    ),
+) -> None:
+    """📜 Show search history.
+
+    Displays your recent search queries with timestamps and result counts.
+    Use this to revisit previous searches or track your search patterns.
+
+    Examples:
+        mcp-vector-search search history
+        mcp-vector-search search history --limit 50
+    """
+    from ..history import show_search_history
+
+    root = project_root or ctx.obj.get("project_root") or Path.cwd()
+    show_search_history(root, limit)
+
+
+@search_app.command("favorites")
+def show_favorites_cmd(
+    ctx: typer.Context,
+    action: str | None = typer.Argument(None, help="Action: list, add, remove"),
+    query: str | None = typer.Argument(None, help="Query to add/remove"),
+    description: str | None = typer.Option(
+        None, "--desc", help="Description for favorite"
+    ),
+    project_root: Path | None = typer.Option(
+        None, "--project-root", "-p", help="Project root directory"
+    ),
+) -> None:
+    """⭐ Manage favorite queries.
+
+    List, add, or remove favorite search queries for quick access.
+
+    Examples:
+        mcp-vector-search search favorites                # List all favorites
+        mcp-vector-search search favorites list           # List all favorites
+        mcp-vector-search search favorites add "auth"     # Add favorite
+        mcp-vector-search search favorites remove "auth"  # Remove favorite
+    """
+    from ..history import SearchHistory, show_favorites
+
+    root = project_root or ctx.obj.get("project_root") or Path.cwd()
+    history_manager = SearchHistory(root)
+
+    # Default to list if no action provided
+    if not action or action == "list":
+        show_favorites(root)
+    elif action == "add":
+        if not query:
+            print_error("Query is required for 'add' action")
+            raise typer.Exit(1)
+        history_manager.add_favorite(query, description)
+    elif action == "remove":
+        if not query:
+            print_error("Query is required for 'remove' action")
+            raise typer.Exit(1)
+        history_manager.remove_favorite(query)
+    else:
+        print_error(f"Unknown action: {action}. Use: list, add, or remove")
+        raise typer.Exit(1)
+
+
+# Add main command to search_app (allows: mcp-vector-search search main "query")
 search_app.command("main")(search_main)
-search_app.command("similar")(search_similar_cmd)
-search_app.command("context")(search_context_cmd)
 
 
 if __name__ == "__main__":