feat: promote query as primary search command, add CLI aliases

List query first in --help as the recommended search method. Add
vector-search and deep-search as undocumented CLI aliases matching
MCP tool names.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -19,9 +19,9 @@ qmd multi-get <pattern>           # Get multiple docs by glob or comma-separated
 qmd status                        # Show index status and collections
 qmd update [--pull]               # Re-index all collections (--pull: git pull first)
 qmd embed                         # Generate vector embeddings (uses node-llama-cpp)
-qmd search <query>                # BM25 full-text search
-qmd vsearch <query>               # Vector similarity search
-qmd query <query>                 # Hybrid search with reranking (best quality)
+qmd query <query>                 # Search with query expansion + reranking (recommended)
+qmd search <query>                # Full-text keyword search (BM25, no LLM)
+qmd vsearch <query>               # Vector similarity search (no reranking)
 qmd mcp                           # Start MCP server (stdio transport)
 qmd mcp --http [--port N]         # Start MCP server (HTTP, default port 8181)
 qmd mcp --http --daemon           # Start as background daemon

src/qmd.ts

@@ -2118,9 +2118,9 @@ function showHelp(): void {
   console.log("  qmd update [--pull]           - Re-index all collections (--pull: git pull first)");
   console.log("  qmd embed [-f]                - Create vector embeddings (800 tokens/chunk, 15% overlap)");
   console.log("  qmd cleanup                   - Remove cache and orphaned data, vacuum DB");
-  console.log("  qmd search <query>            - Full-text search (BM25)");
-  console.log("  qmd vsearch <query>           - Vector similarity search");
-  console.log("  qmd query <query>             - Combined search with query expansion + reranking");
+  console.log("  qmd query <query>             - Search with query expansion + reranking (recommended)");
+  console.log("  qmd search <query>            - Full-text keyword search (BM25, no LLM)");
+  console.log("  qmd vsearch <query>           - Vector similarity search (no reranking)");
   console.log("  qmd mcp                       - Start MCP server (stdio transport)");
   console.log("  qmd mcp --http [--port N]     - Start MCP server (HTTP transport, default port 8181)");
   console.log("  qmd mcp --http --daemon       - Start MCP server as background daemon");
@@ -2365,6 +2365,7 @@ if (import.meta.main) {
       break;
 
     case "vsearch":
+    case "vector-search": // undocumented alias
       if (!cli.query) {
         console.error("Usage: qmd vsearch [options] <query>");
         process.exit(1);
@@ -2377,6 +2378,7 @@ if (import.meta.main) {
       break;
 
     case "query":
+    case "deep-search": // undocumented alias
       if (!cli.query) {
         console.error("Usage: qmd query [options] <query>");
         process.exit(1);