mcp-vector-search 0.4.13__py3-none-any.whl → 0.4.14__py3-none-any.whl

mcp_vector_search/__init__.py

@@ -1,7 +1,7 @@
 """MCP Vector Search - CLI-first semantic code search with MCP integration."""
 
-__version__ = "0.4.13"
-__build__ = "15"
+__version__ = "0.4.14"
+__build__ = "16"
 __author__ = "Robert Matsuoka"
 __email__ = "bobmatnyc@gmail.com"
 

mcp_vector_search/cli/main.py

@@ -112,7 +112,15 @@ def interactive_search(
         None, "--project-root", "-p", help="Project root directory"
     ),
 ) -> None:
-    """Start an interactive search session with filtering and refinement."""
+    """Start an interactive search session with filtering and refinement.
+
+    The interactive mode provides a rich terminal interface for searching your codebase
+    with real-time filtering, query refinement, and result navigation.
+
+    Examples:
+        mcp-vector-search interactive
+        mcp-vector-search interactive --project-root /path/to/project
+    """
     import asyncio
 
     from .interactive import start_interactive_search
@@ -137,7 +145,15 @@ def show_history(
         None, "--project-root", "-p", help="Project root directory"
     ),
 ) -> None:
-    """Show search history."""
+    """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 history
+        mcp-vector-search history --limit 50
+    """
     from .history import show_search_history
 
     root = project_root or ctx.obj.get("project_root") or Path.cwd()
@@ -151,7 +167,14 @@ def show_favorites_cmd(
         None, "--project-root", "-p", help="Project root directory"
     ),
 ) -> None:
-    """Show favorite queries."""
+    """Show favorite queries.
+
+    Displays your saved favorite search queries. Favorites allow you to quickly
+    access frequently used searches without typing them again.
+
+    Examples:
+        mcp-vector-search favorites
+    """
     from .history import show_favorites
 
     root = project_root or ctx.obj.get("project_root") or Path.cwd()
@@ -167,7 +190,15 @@ def add_favorite(
         None, "--project-root", "-p", help="Project root directory"
     ),
 ) -> None:
-    """Add a query to favorites."""
+    """Add a query to favorites.
+
+    Save a search query to your favorites list for quick access later.
+    Optionally include a description to help remember what the query is for.
+
+    Examples:
+        mcp-vector-search add-favorite "authentication functions"
+        mcp-vector-search add-favorite "error handling" --desc "Error handling patterns"
+    """
     from .history import SearchHistory
 
     root = project_root or ctx.obj.get("project_root") or Path.cwd()
@@ -183,7 +214,13 @@ def remove_favorite(
         None, "--project-root", "-p", help="Project root directory"
     ),
 ) -> None:
-    """Remove a query from favorites."""
+    """Remove a query from favorites.
+
+    Remove a previously saved favorite query from your favorites list.
+
+    Examples:
+        mcp-vector-search remove-favorite "authentication functions"
+    """
     from .history import SearchHistory
 
     root = project_root or ctx.obj.get("project_root") or Path.cwd()
@@ -293,7 +330,14 @@ def help_contextual() -> None:
 
 @app.command()
 def doctor() -> None:
-    """Check system dependencies and configuration."""
+    """Check system dependencies and configuration.
+
+    Runs diagnostic checks to ensure all required dependencies are installed
+    and properly configured. Use this command to troubleshoot installation issues.
+
+    Examples:
+        mcp-vector-search doctor
+    """
     from .commands.status import check_dependencies
 
     console.print("[bold blue]MCP Vector Search - System Check[/bold blue]\n")
@@ -357,9 +401,13 @@ def cli_with_suggestions():
         # Re-raise system exits
         raise
     except Exception as e:
-        # For other exceptions, show error and exit
-        click.echo(f"Unexpected error: {e}", err=True)
-        sys.exit(1)
+        # For other exceptions, show error and exit if verbose logging is enabled
+        # Suppress internal framework errors in normal operation
+        if "--verbose" in sys.argv or "-v" in sys.argv:
+            click.echo(f"Unexpected error: {e}", err=True)
+            sys.exit(1)
+        # Otherwise, just exit silently to avoid confusing error messages
+        pass
 
 
 if __name__ == "__main__":

{mcp_vector_search-0.4.13.dist-info → mcp_vector_search-0.4.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-vector-search
-Version: 0.4.13
+Version: 0.4.14
 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.4.13.dist-info → mcp_vector_search-0.4.14.dist-info}/RECORD

@@ -1,11 +1,11 @@
-mcp_vector_search/__init__.py,sha256=ilm99bkUT26l6D7BKcDcqFnqeicx6ChwMeFa0XXR8tA,300
+mcp_vector_search/__init__.py,sha256=ir_M_lclJGDDVJ6Gf_IYKqrhZLJU1I7Tq1zE7pTA7dM,300
 mcp_vector_search/py.typed,sha256=lCKeV9Qcn9sGtbRsgg-LJO2ZwWRuknnnlmomq3bJFH0,43
 mcp_vector_search/cli/__init__.py,sha256=TNB7CaOASz8u3yHWLbNmo8-GtHF0qwUjVKWAuNphKgo,40
 mcp_vector_search/cli/didyoumean.py,sha256=eq2uhP3E3qrPHmk2BrbFq8i8nT896uq24_IB8dzMHIk,16092
 mcp_vector_search/cli/export.py,sha256=iluxuRT2KELdKlQeDAlVkteiel4GGrng153UAw9H0as,10804
 mcp_vector_search/cli/history.py,sha256=osQVNiTIdGSRZQiJEjC_AYMmHxaqv7RSKSeuO325Ip0,9115
 mcp_vector_search/cli/interactive.py,sha256=T7P4dAdvbglznzQYgiePv5YNyOx9FeE57Y3OKYnnbYE,12744
-mcp_vector_search/cli/main.py,sha256=x_Nym0BzYmgfAM5-nCIfidv_QQeEPu9dC6UqSGovJiM,13661
+mcp_vector_search/cli/main.py,sha256=I5WXHyB654YV0j2HODSv8Cy_zm_xfr91pFCSTb_0hLQ,15342
 mcp_vector_search/cli/output.py,sha256=TGtWHrsfFg2tFf05aplZI2pDkoSnlKf_if78qXSRDtE,8077
 mcp_vector_search/cli/suggestions.py,sha256=J7GB4r4PBqGY5QO20ZjfLLls1y1QYdvq0VxE-U3Cz70,12717
 mcp_vector_search/cli/commands/__init__.py,sha256=vQls-YKZ54YEwmf7g1dL0T2SS9D4pdQljXzsUChG_V4,42
@@ -49,8 +49,8 @@ mcp_vector_search/utils/__init__.py,sha256=Eq6lY-oPMfCt-GpPUbg9QbmTHuQVmTaVDBMU2
 mcp_vector_search/utils/gitignore.py,sha256=U1-1FERSYnDbxkH8JGG_azLxLasqkAh1urRUbZskmRU,8208
 mcp_vector_search/utils/timing.py,sha256=THC7mfbTYnUpnnDcblgQacYMzbEkfFoIShx6plmhCgg,11285
 mcp_vector_search/utils/version.py,sha256=d7fS-CLemxb8UzZ9j18zH0Y0Ud097ljKKYYOPulnGPE,1138
-mcp_vector_search-0.4.13.dist-info/METADATA,sha256=QnVr42SbpYWvo5lPQ83hUNKWrd69IdQetlmo3AiMoR8,15890
-mcp_vector_search-0.4.13.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcp_vector_search-0.4.13.dist-info/entry_points.txt,sha256=y3Ygtc_JiBchNEIL-tPABo7EbzBExGAxwGdkkeP5D2I,86
-mcp_vector_search-0.4.13.dist-info/licenses/LICENSE,sha256=FqZUgGJH_tZKZLQsMCpXaLawRyLmyFKRVfMwYyEcyTs,1072
-mcp_vector_search-0.4.13.dist-info/RECORD,,
+mcp_vector_search-0.4.14.dist-info/METADATA,sha256=EbalUrvvEgqQn5hGu1sD0WyDnL3EFQmZB2meZzmNRdA,15890
+mcp_vector_search-0.4.14.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcp_vector_search-0.4.14.dist-info/entry_points.txt,sha256=y3Ygtc_JiBchNEIL-tPABo7EbzBExGAxwGdkkeP5D2I,86
+mcp_vector_search-0.4.14.dist-info/licenses/LICENSE,sha256=FqZUgGJH_tZKZLQsMCpXaLawRyLmyFKRVfMwYyEcyTs,1072
+mcp_vector_search-0.4.14.dist-info/RECORD,,