mcp-vector-search 0.12.6__py3-none-any.whl → 1.0.3__py3-none-any.whl

mcp_vector_search/cli/didyoumean.py

@@ -212,6 +212,17 @@ COMMON_TYPOS = {
     "grep": "search",
     "s": "search",  # Single letter shortcut
     "f": "search",  # Alternative shortcut for find
+    # Chat command variations
+    "cht": "chat",
+    "caht": "chat",
+    "chta": "chat",
+    "ask": "chat",
+    "question": "chat",
+    "qa": "chat",
+    "llm": "chat",
+    "gpt": "chat",
+    "explain": "chat",
+    "answer": "chat",
     # Index command variations
     "indx": "index",
     "idx": "index",
@@ -333,9 +344,18 @@ COMMAND_INFO = {
         "examples": [
             'mcp-vector-search search "authentication function"',
             'mcp-vector-search search "error handling" --limit 5',
-            'mcp-vector-search find "database connection"',
+            'mcp-vector-search search --files "*.ts" "query"',
         ],
-        "related": ["search-similar", "search-context", "find", "interactive"],
+        "related": ["chat", "index", "status"],
+    },
+    "chat": {
+        "description": "Ask AI questions about your code (requires API key)",
+        "examples": [
+            'mcp-vector-search chat "where is the database configured?"',
+            'mcp-vector-search chat "how does authentication work?"',
+            'mcp-vector-search chat --limit 3 "explain error handling"',
+        ],
+        "related": ["search", "status", "index"],
     },
     "index": {
         "description": "Index codebase for semantic search",

mcp_vector_search/cli/main.py

@@ -1,5 +1,8 @@
 """Main CLI application for MCP Vector Search."""
 
+import faulthandler
+import signal
+import sys
 from pathlib import Path
 
 import typer
@@ -9,9 +12,52 @@ from rich.traceback import install
 
 from .. import __build__, __version__
 from .didyoumean import add_common_suggestions, create_enhanced_typer
-from .output import print_warning, setup_logging
+from .output import setup_logging
 from .suggestions import get_contextual_suggestions
 
+
+# ============================================================================
+# SIGNAL HANDLERS - Register early for crash diagnostics
+# ============================================================================
+def _handle_segfault(signum: int, frame) -> None:
+    """Handle segmentation faults with helpful error message.
+
+    Segmentation faults typically occur due to corrupted ChromaDB index data
+    or issues with native libraries (sentence-transformers, tree-sitter).
+
+    Args:
+        signum: Signal number (SIGSEGV = 11)
+        frame: Current stack frame (unused)
+    """
+    error_message = """
+╭─────────────────────────────────────────────────────────────────╮
+│ ⚠️  Segmentation Fault Detected                                  │
+├─────────────────────────────────────────────────────────────────┤
+│ This usually indicates corrupted index data or a crash in       │
+│ native libraries (ChromaDB, sentence-transformers, tree-sitter).│
+│                                                                 │
+│ To fix this, please run:                                        │
+│   1. mcp-vector-search reset index --force                      │
+│   2. mcp-vector-search index                                    │
+│                                                                 │
+│ This will rebuild your search index from scratch.               │
+│                                                                 │
+│ If the problem persists:                                        │
+│   - Try updating dependencies: pip install -U mcp-vector-search │
+│   - Check GitHub issues: github.com/bobmatnyc/mcp-vector-search │
+╰─────────────────────────────────────────────────────────────────╯
+"""
+    print(error_message, file=sys.stderr)
+    sys.exit(139)  # Standard segfault exit code (128 + 11)
+
+
+# Register signal handler for segmentation faults
+signal.signal(signal.SIGSEGV, _handle_segfault)
+
+# Enable faulthandler for better crash diagnostics
+# This prints Python traceback on segfaults before signal handler runs
+faulthandler.enable()
+
 # Install rich traceback handler
 install(show_locals=True)
 
@@ -22,45 +68,65 @@ console = Console()
 app = create_enhanced_typer(
     name="mcp-vector-search",
     help="""
-🔍 [bold]CLI-first semantic code search with MCP integration[/bold]
-
-Semantic search finds code by meaning, not just keywords. Perfect for exploring
-unfamiliar codebases, finding similar patterns, and integrating with AI tools.
-
-[bold cyan]Quick Start:[/bold cyan]
-  1. Initialize: [green]mcp-vector-search init[/green]
-  2. Search code: [green]mcp-vector-search search "your query"[/green]
-  3. Check status: [green]mcp-vector-search status[/green]
-
-[bold cyan]Main Commands:[/bold cyan]
+🔍 [bold]MCP Vector Search - Semantic Code Search CLI[/bold]
+
+Search your codebase by meaning, not just keywords. Find similar code patterns,
+explore unfamiliar projects, and integrate with AI coding tools via MCP.
+
+[bold cyan]QUICK START:[/bold cyan]
+  mcp-vector-search setup           # One-time setup (recommended)
+  mcp-vector-search search "query"  # Search by meaning
+  mcp-vector-search chat "question" # Ask AI about your code
+
+[bold cyan]MAIN COMMANDS:[/bold cyan]
+  setup     🚀 Zero-config setup (indexes + configures MCP)
+  search    🔍 Semantic search (finds code by meaning)
+  chat      🤖 LLM-powered Q&A about your code (needs API key)
+  status    📊 Show project status
+  visualize 📊 Interactive code graph
+
+[bold cyan]AI CHAT SETUP:[/bold cyan]
+  The 'chat' command requires an OpenRouter API key:
+  1. Get key: [cyan]https://openrouter.ai/keys[/cyan]
+  2. Set: [yellow]export OPENROUTER_API_KEY='your-key'[/yellow]
+
+[bold cyan]EXAMPLES:[/bold cyan]
+  mcp-vector-search search "error handling"
+  mcp-vector-search search --files "*.ts" "authentication"
+  mcp-vector-search chat "where is the database configured?"
+  mcp-vector-search chat "how does auth work in this project?"
+
+[bold cyan]MORE COMMANDS:[/bold cyan]
   install    📦 Install project and MCP integrations
   uninstall  🗑️  Remove MCP integrations
-  init       🔧 Initialize project (simple)
+  init       🔧 Initialize project (advanced)
   demo       🎬 Run interactive demo
   doctor     🩺 Check system health
-  status     📊 Show project status
-  search     🔍 Search code semantically
   index      📇 Index codebase
+  reset      🔄 Reset and recovery operations
   mcp        🔌 MCP server operations
   config     ⚙️  Configure settings
-  visualize  📊 Visualize code relationships
   help       ❓ Get help
   version    ℹ️  Show version
 
-[dim]For detailed help: [cyan]mcp-vector-search COMMAND --help[/cyan][/dim]
+[dim]For more: [cyan]mcp-vector-search COMMAND --help[/cyan][/dim]
     """,
     add_completion=False,
     rich_markup_mode="rich",
 )
 
 # Import command modules
+from .commands.analyze import analyze_app  # noqa: E402
+from .commands.chat import chat_app  # noqa: E402
 from .commands.config import config_app  # noqa: E402
 from .commands.demo import demo_app  # noqa: E402
 from .commands.index import index_app  # noqa: E402
 from .commands.init import init_app  # noqa: E402
 from .commands.install import install_app  # noqa: E402
 from .commands.mcp import mcp_app  # noqa: E402
+from .commands.reset import reset_app  # noqa: E402
 from .commands.search import search_app, search_main  # noqa: E402, F401
+from .commands.setup import setup_app  # noqa: E402
 from .commands.status import main as status_main  # noqa: E402
 from .commands.uninstall import uninstall_app  # noqa: E402
 from .commands.visualize import app as visualize_app  # noqa: E402
@@ -69,6 +135,9 @@ from .commands.visualize import app as visualize_app  # noqa: E402
 # MAIN COMMANDS - Clean hierarchy
 # ============================================================================
 
+# 0. SETUP - Smart zero-config setup (RECOMMENDED!)
+app.add_typer(setup_app, name="setup", help="🚀 Smart zero-config setup (recommended)")
+
 # 1. INSTALL - Install project and MCP integrations (NEW!)
 app.add_typer(
     install_app, name="install", help="📦 Install project and MCP integrations"
@@ -95,6 +164,9 @@ app.command("status", help="📊 Show project status and statistics")(status_mai
 # Register search as both a command and a typer group
 app.add_typer(search_app, name="search", help="🔍 Search code semantically")
 
+# 7.5. CHAT - LLM-powered intelligent search
+app.add_typer(chat_app, name="chat", help="🤖 Ask questions about code with LLM")
+
 # 8. INDEX - Index codebase
 app.add_typer(index_app, name="index", help="📇 Index codebase for semantic search")
 
@@ -104,152 +176,26 @@ app.add_typer(mcp_app, name="mcp", help="🔌 MCP server operations")
 # 10. CONFIG - Configuration
 app.add_typer(config_app, name="config", help="⚙️  Manage project configuration")
 
-# 11. VISUALIZE - Code graph visualization
+# 10.5. RESET - Reset and recovery operations
+app.add_typer(reset_app, name="reset", help="🔄 Reset and recovery operations")
+
+# 11. ANALYZE - Code complexity analysis
+app.add_typer(
+    analyze_app, name="analyze", help="📈 Analyze code complexity and quality"
+)
+
+# 12. VISUALIZE - Code graph visualization
 app.add_typer(
     visualize_app, name="visualize", help="📊 Visualize code chunk relationships"
 )
 
-# 12. HELP - Enhanced help
+# 13. HELP - Enhanced help
 # (defined below inline)
 
-# 13. VERSION - Version info
+# 14. VERSION - Version info
 # (defined below inline)
 
 
-# ============================================================================
-# DEPRECATED COMMANDS - With helpful suggestions
-# ============================================================================
-
-
-def _deprecated_command(old_cmd: str, new_cmd: str):
-    """Helper to create deprecated command with suggestion."""
-
-    def wrapper(*args, **kwargs):
-        print_warning(
-            f"⚠️  The command '{old_cmd}' is deprecated.\n"
-            f"   Please use '{new_cmd}' instead.\n"
-            f"   Run: [cyan]mcp-vector-search {new_cmd} --help[/cyan] for details."
-        )
-        raise typer.Exit(1)
-
-    return wrapper
-
-
-# NOTE: 'install' command is now the primary command for project installation
-# Old 'install' was deprecated in favor of 'init' in v0.7.0
-# Now 'install' is back as the hierarchical installation command in v0.13.0
-
-
-# Deprecated: find -> search
-@app.command("find", hidden=True)
-def deprecated_find():
-    """[DEPRECATED] Use 'search' instead."""
-    _deprecated_command("find", "search")()
-
-
-# Deprecated: search-similar -> search --similar
-@app.command("search-similar", hidden=True)
-def deprecated_search_similar():
-    """[DEPRECATED] Use 'search --similar' instead."""
-    _deprecated_command("search-similar", "search --similar")()
-
-
-# Deprecated: search-context -> search --context
-@app.command("search-context", hidden=True)
-def deprecated_search_context():
-    """[DEPRECATED] Use 'search --context' instead."""
-    _deprecated_command("search-context", "search --context")()
-
-
-# Deprecated: interactive -> search interactive
-@app.command("interactive", hidden=True)
-def deprecated_interactive():
-    """[DEPRECATED] Use 'search interactive' instead."""
-    _deprecated_command("interactive", "search interactive")()
-
-
-# Deprecated: history -> search history
-@app.command("history", hidden=True)
-def deprecated_history():
-    """[DEPRECATED] Use 'search history' instead."""
-    _deprecated_command("history", "search history")()
-
-
-# Deprecated: favorites -> search favorites
-@app.command("favorites", hidden=True)
-def deprecated_favorites():
-    """[DEPRECATED] Use 'search favorites' instead."""
-    _deprecated_command("favorites", "search favorites")()
-
-
-# Deprecated: add-favorite -> search favorites add
-@app.command("add-favorite", hidden=True)
-def deprecated_add_favorite():
-    """[DEPRECATED] Use 'search favorites add' instead."""
-    _deprecated_command("add-favorite", "search favorites add")()
-
-
-# Deprecated: remove-favorite -> search favorites remove
-@app.command("remove-favorite", hidden=True)
-def deprecated_remove_favorite():
-    """[DEPRECATED] Use 'search favorites remove' instead."""
-    _deprecated_command("remove-favorite", "search favorites remove")()
-
-
-# Deprecated: health -> index health
-@app.command("health", hidden=True)
-def deprecated_health():
-    """[DEPRECATED] Use 'index health' instead."""
-    _deprecated_command("health", "index health")()
-
-
-# Deprecated: watch -> index watch
-@app.command("watch", hidden=True)
-def deprecated_watch():
-    """[DEPRECATED] Use 'index watch' instead."""
-    _deprecated_command("watch", "index watch")()
-
-
-# Deprecated: auto-index -> index auto
-@app.command("auto-index", hidden=True)
-def deprecated_auto_index():
-    """[DEPRECATED] Use 'index auto' instead."""
-    _deprecated_command("auto-index", "index auto")()
-
-
-# Deprecated: reset -> mcp reset or config reset
-@app.command("reset", hidden=True)
-def deprecated_reset():
-    """[DEPRECATED] Use 'mcp reset' or 'config reset' instead."""
-    print_warning(
-        "⚠️  The 'reset' command is deprecated.\n"
-        "   Use [cyan]mcp-vector-search mcp reset[/cyan] for MCP reset\n"
-        "   Use [cyan]mcp-vector-search config reset[/cyan] for config reset"
-    )
-    raise typer.Exit(1)
-
-
-# Deprecated: init-check -> init check
-@app.command("init-check", hidden=True)
-def deprecated_init_check():
-    """[DEPRECATED] Use 'init check' instead."""
-    _deprecated_command("init-check", "init check")()
-
-
-# Deprecated: init-mcp -> mcp install
-@app.command("init-mcp", hidden=True)
-def deprecated_init_mcp():
-    """[DEPRECATED] Use 'mcp install' instead."""
-    _deprecated_command("init-mcp", "mcp install")()
-
-
-# Deprecated: init-models -> config models
-@app.command("init-models", hidden=True)
-def deprecated_init_models():
-    """[DEPRECATED] Use 'config models' instead."""
-    _deprecated_command("init-models", "config models")()
-
-
 # ============================================================================
 # MAIN INLINE COMMANDS
 # ============================================================================
@@ -329,6 +275,15 @@ def version_command() -> None:
     console.print("[dim]Built with ChromaDB, Tree-sitter, and modern Python[/dim]")
 
 
+def _version_callback(value: bool) -> None:
+    """Handle --version flag eagerly before command parsing."""
+    if value:
+        console.print(
+            f"[bold blue]mcp-vector-search[/bold blue] version [green]{__version__}[/green] [dim](build {__build__})[/dim]"
+        )
+        raise typer.Exit()
+
+
 @app.callback()
 def main(
     ctx: typer.Context,
@@ -338,6 +293,8 @@ def main(
         "-v",
         help="Show version and exit",
         rich_help_panel="ℹ️  Information",
+        is_eager=True,
+        callback=lambda v: _version_callback(v),
     ),
     verbose: bool = typer.Option(
         False,
@@ -368,9 +325,8 @@ def main(
     A modern, lightweight tool for semantic code search using ChromaDB and Tree-sitter.
     Designed for local development with optional MCP server integration.
     """
-    if version:
-        console.print(f"mcp-vector-search version {__version__} (build {__build__})")
-        raise typer.Exit()
+    # Note: --version is handled by _version_callback with is_eager=True
+    # This ensures it runs before no_args_is_help check
 
     # Setup logging
     log_level = "DEBUG" if verbose else "ERROR" if quiet else "WARNING"
@@ -439,8 +395,8 @@ def cli_with_suggestions():
     except click.Abort:
         # User interrupted (Ctrl+C)
         sys.exit(1)
-    except SystemExit:
-        # Re-raise system exits
+    except (SystemExit, click.exceptions.Exit):
+        # Re-raise system exits and typer.Exit
         raise
     except Exception as e:
         # For other exceptions, show error and exit if verbose logging is enabled

mcp_vector_search/cli/output.py

@@ -97,9 +97,11 @@ def print_project_info(project_info: ProjectInfo) -> None:
     table.add_row("Initialized", "✓" if project_info.is_initialized else "✗")
     table.add_row(
         "Languages",
-        ", ".join(project_info.languages)
-        if project_info.languages
-        else "None detected",
+        (
+            ", ".join(project_info.languages)
+            if project_info.languages
+            else "None detected"
+        ),
     )
     table.add_row("Indexable Files", str(project_info.file_count))
 
@@ -248,16 +250,30 @@ def print_dependency_status(
 
 
 def print_json(data: Any, title: str | None = None) -> None:
-    """Print data as formatted JSON."""
-    import json
+    """Print data as formatted JSON.
+
+    When title is None (typical for --json flag), outputs raw JSON to stdout
+    for machine consumption (e.g., piping to json.tool).
+    When title is provided, uses Rich formatting for human-readable display.
 
-    json_str = json.dumps(data, indent=2, default=str)
-    syntax = Syntax(json_str, "json", theme="monokai")
+    Args:
+        data: Data to serialize as JSON
+        title: Optional title for Rich panel display
+    """
+    import json
 
     if title:
+        # Human-readable display with Rich formatting
+        json_str = json.dumps(data, indent=2, default=str)
+        syntax = Syntax(json_str, "json", theme="monokai")
         console.print(Panel(syntax, title=title, border_style="blue"))
     else:
-        console.print(syntax)
+        # Machine-readable output: raw JSON to stdout
+        # Use sys.stdout.write to bypass Rich console formatting
+        json_str = json.dumps(data, indent=2, default=str, ensure_ascii=False)
+        sys.stdout.write(json_str)
+        sys.stdout.write("\n")
+        sys.stdout.flush()
 
 
 def print_panel(

mcp_vector_search/config/__init__.py

@@ -1 +1,5 @@
 """Configuration management for MCP Vector Search."""
+
+from .thresholds import ComplexityThresholds, SmellThresholds, ThresholdConfig
+
+__all__ = ["ComplexityThresholds", "SmellThresholds", "ThresholdConfig"]

mcp_vector_search/config/default_thresholds.yaml

@@ -0,0 +1,52 @@
+# Code Quality Threshold Configuration
+# Customize these values to match your project's standards
+
+complexity:
+  # Cognitive complexity grade thresholds
+  cognitive_a: 5      # Grade A: 0-5 (excellent)
+  cognitive_b: 10     # Grade B: 6-10 (good)
+  cognitive_c: 20     # Grade C: 11-20 (acceptable)
+  cognitive_d: 30     # Grade D: 21-30 (needs improvement)
+  # Grade F: 31+ (refactor recommended)
+
+  # Cyclomatic complexity thresholds
+  cyclomatic_low: 4       # Low: 1-4
+  cyclomatic_moderate: 10 # Moderate: 5-10
+  cyclomatic_high: 20     # High: 11-20
+  # Very high: 21+
+
+  # Nesting depth thresholds
+  nesting_warning: 3    # Warning level
+  nesting_error: 5      # Error level
+
+  # Parameter count thresholds
+  parameters_warning: 4   # Warning level
+  parameters_error: 7     # Error level
+
+  # Method count thresholds (per class)
+  methods_warning: 10     # Warning level
+  methods_error: 20       # Error level
+
+smells:
+  # Long method (lines of code)
+  long_method_lines: 50
+
+  # Too many parameters
+  too_many_parameters: 5
+
+  # Deep nesting
+  deep_nesting_depth: 4
+
+  # High complexity
+  high_complexity: 15
+
+  # God class (too many methods)
+  god_class_methods: 20
+
+  # Feature envy (external calls)
+  feature_envy_external_calls: 5
+
+# Quality gate settings
+fail_on_f_grade: true       # Fail quality gate on F grade
+fail_on_smell_count: 10     # Fail if more than N smells total
+warn_on_d_grade: true       # Warn on D grade

mcp_vector_search/config/settings.py

@@ -49,6 +49,18 @@ class ProjectConfig(BaseSettings):
         default=True,
         description="Respect .gitignore patterns when indexing files",
     )
+    openrouter_api_key: str | None = Field(
+        default=None,
+        description="OpenRouter API key for chat command (optional, can also use env var)",
+    )
+    openai_api_key: str | None = Field(
+        default=None,
+        description="OpenAI API key for chat command (optional, can also use env var)",
+    )
+    preferred_llm_provider: str | None = Field(
+        default=None,
+        description="Preferred LLM provider: 'openai' or 'openrouter' (auto-detect if not set)",
+    )
 
     @field_validator("project_root", "index_path", mode="before")
     @classmethod