@liendev/lien 0.35.0 → 0.36.0

package/dist/index.js

@@ -5,6 +5,9 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
@@ -29,6 +32,70 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
+// src/utils/banner.ts
+import figlet from "figlet";
+import chalk from "chalk";
+import { createRequire } from "module";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+function wrapInBox(text, footer, padding = 1) {
+  const lines = text.split("\n").filter((line) => line.trim().length > 0);
+  const maxLength = Math.max(...lines.map((line) => line.length));
+  const horizontalBorder = "\u2500".repeat(maxLength + padding * 2);
+  const top = `\u250C${horizontalBorder}\u2510`;
+  const bottom = `\u2514${horizontalBorder}\u2518`;
+  const separator = `\u251C${horizontalBorder}\u2524`;
+  const paddedLines = lines.map((line) => {
+    const padRight = " ".repeat(maxLength - line.length + padding);
+    const padLeft = " ".repeat(padding);
+    return `\u2502${padLeft}${line}${padRight}\u2502`;
+  });
+  const totalPad = maxLength - footer.length;
+  const leftPad = Math.floor(totalPad / 2);
+  const rightPad = totalPad - leftPad;
+  const centeredFooter = " ".repeat(leftPad) + footer + " ".repeat(rightPad);
+  const paddedFooter = `\u2502${" ".repeat(padding)}${centeredFooter}${" ".repeat(padding)}\u2502`;
+  return [top, ...paddedLines, separator, paddedFooter, bottom].join("\n");
+}
+function showBanner() {
+  const banner = figlet.textSync("LIEN", {
+    font: "ANSI Shadow",
+    horizontalLayout: "fitted",
+    verticalLayout: "fitted"
+  });
+  const footer = `${PACKAGE_NAME} - v${VERSION}`;
+  const boxedBanner = wrapInBox(banner.trim(), footer);
+  console.error(chalk.cyan(boxedBanner));
+  console.error();
+}
+function showCompactBanner() {
+  const banner = figlet.textSync("LIEN", {
+    font: "ANSI Shadow",
+    horizontalLayout: "fitted",
+    verticalLayout: "fitted"
+  });
+  const footer = `${PACKAGE_NAME} - v${VERSION}`;
+  const boxedBanner = wrapInBox(banner.trim(), footer);
+  console.log(chalk.cyan(boxedBanner));
+  console.log();
+}
+var __filename, __dirname, require2, packageJson, PACKAGE_NAME, VERSION;
+var init_banner = __esm({
+  "src/utils/banner.ts"() {
+    "use strict";
+    __filename = fileURLToPath(import.meta.url);
+    __dirname = dirname(__filename);
+    require2 = createRequire(import.meta.url);
+    try {
+      packageJson = require2(join(__dirname, "../package.json"));
+    } catch {
+      packageJson = require2(join(__dirname, "../../package.json"));
+    }
+    PACKAGE_NAME = packageJson.name;
+    VERSION = packageJson.version;
+  }
+});
+
 // ../../node_modules/collect.js/dist/methods/symbol.iterator.js
 var require_symbol_iterator = __commonJS({
   "../../node_modules/collect.js/dist/methods/symbol.iterator.js"(exports, module) {
@@ -3595,115 +3662,65 @@ import { fileURLToPath as fileURLToPath3 } from "url";
 import { dirname as dirname3, join as join3 } from "path";
 
 // src/cli/init.ts
+init_banner();
 import fs from "fs/promises";
 import path from "path";
 import chalk2 from "chalk";
-
-// src/utils/banner.ts
-import figlet from "figlet";
-import chalk from "chalk";
-import { createRequire } from "module";
-import { fileURLToPath } from "url";
-import { dirname, join } from "path";
-var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname(__filename);
-var require2 = createRequire(import.meta.url);
-var packageJson;
-try {
-  packageJson = require2(join(__dirname, "../package.json"));
-} catch {
-  packageJson = require2(join(__dirname, "../../package.json"));
-}
-var PACKAGE_NAME = packageJson.name;
-var VERSION = packageJson.version;
-function wrapInBox(text, footer, padding = 1) {
-  const lines = text.split("\n").filter((line) => line.trim().length > 0);
-  const maxLength = Math.max(...lines.map((line) => line.length));
-  const horizontalBorder = "\u2500".repeat(maxLength + padding * 2);
-  const top = `\u250C${horizontalBorder}\u2510`;
-  const bottom = `\u2514${horizontalBorder}\u2518`;
-  const separator = `\u251C${horizontalBorder}\u2524`;
-  const paddedLines = lines.map((line) => {
-    const padRight = " ".repeat(maxLength - line.length + padding);
-    const padLeft = " ".repeat(padding);
-    return `\u2502${padLeft}${line}${padRight}\u2502`;
-  });
-  const totalPad = maxLength - footer.length;
-  const leftPad = Math.floor(totalPad / 2);
-  const rightPad = totalPad - leftPad;
-  const centeredFooter = " ".repeat(leftPad) + footer + " ".repeat(rightPad);
-  const paddedFooter = `\u2502${" ".repeat(padding)}${centeredFooter}${" ".repeat(padding)}\u2502`;
-  return [top, ...paddedLines, separator, paddedFooter, bottom].join("\n");
-}
-function showBanner() {
-  const banner = figlet.textSync("LIEN", {
-    font: "ANSI Shadow",
-    horizontalLayout: "fitted",
-    verticalLayout: "fitted"
-  });
-  const footer = `${PACKAGE_NAME} - v${VERSION}`;
-  const boxedBanner = wrapInBox(banner.trim(), footer);
-  console.error(chalk.cyan(boxedBanner));
-  console.error();
-}
-function showCompactBanner() {
-  const banner = figlet.textSync("LIEN", {
-    font: "ANSI Shadow",
-    horizontalLayout: "fitted",
-    verticalLayout: "fitted"
-  });
-  const footer = `${PACKAGE_NAME} - v${VERSION}`;
-  const boxedBanner = wrapInBox(banner.trim(), footer);
-  console.log(chalk.cyan(boxedBanner));
-  console.log();
-}
-
-// src/cli/init.ts
+var MCP_CONFIG = {
+  command: "lien",
+  args: ["serve"]
+};
 async function initCommand(options = {}) {
   showCompactBanner();
-  console.log(chalk2.bold("\nLien Initialization\n"));
-  console.log(chalk2.green("\u2713 No per-project configuration needed!"));
-  console.log(chalk2.dim("\nLien now uses:"));
-  console.log(chalk2.dim("  \u2022 Auto-detected frameworks"));
-  console.log(chalk2.dim("  \u2022 Sensible defaults for all settings"));
-  console.log(chalk2.dim("  \u2022 Global config (optional) at ~/.lien/config.json"));
-  console.log(chalk2.bold("\nNext steps:"));
-  console.log(chalk2.dim("  1. Run"), chalk2.bold("lien index"), chalk2.dim("to index your codebase"));
-  console.log(chalk2.dim("  2. Run"), chalk2.bold("lien serve"), chalk2.dim("to start the MCP server"));
-  console.log(chalk2.bold("\nGlobal Configuration (optional):"));
-  console.log(chalk2.dim("  To use Qdrant backend, create ~/.lien/config.json:"));
-  console.log(chalk2.dim("  {"));
-  console.log(chalk2.dim('    "backend": "qdrant",'));
-  console.log(chalk2.dim('    "qdrant": {'));
-  console.log(chalk2.dim('      "url": "http://localhost:6333",'));
-  console.log(chalk2.dim('      "apiKey": "optional-api-key"'));
-  console.log(chalk2.dim("    }"));
-  console.log(chalk2.dim("  }"));
-  console.log(chalk2.dim("\n  Or use environment variables:"));
-  console.log(chalk2.dim("    LIEN_BACKEND=qdrant"));
-  console.log(chalk2.dim("    LIEN_QDRANT_URL=http://localhost:6333"));
-  console.log(chalk2.dim("    LIEN_QDRANT_API_KEY=your-key"));
   const rootDir = options.path || process.cwd();
-  const configPath = path.join(rootDir, ".lien.config.json");
+  const cursorDir = path.join(rootDir, ".cursor");
+  const mcpConfigPath = path.join(cursorDir, "mcp.json");
+  let existingConfig = null;
+  try {
+    const raw = await fs.readFile(mcpConfigPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      existingConfig = parsed;
+    }
+  } catch {
+  }
+  if (existingConfig?.mcpServers?.lien) {
+    console.log(chalk2.green("\n\u2713 Already configured \u2014 .cursor/mcp.json contains lien entry"));
+  } else if (existingConfig) {
+    const servers = existingConfig.mcpServers;
+    const safeServers = servers && typeof servers === "object" && !Array.isArray(servers) ? servers : {};
+    safeServers.lien = MCP_CONFIG;
+    existingConfig.mcpServers = safeServers;
+    await fs.writeFile(mcpConfigPath, JSON.stringify(existingConfig, null, 2) + "\n");
+    console.log(chalk2.green("\n\u2713 Added lien to existing .cursor/mcp.json"));
+  } else {
+    await fs.mkdir(cursorDir, { recursive: true });
+    const config = { mcpServers: { lien: MCP_CONFIG } };
+    await fs.writeFile(mcpConfigPath, JSON.stringify(config, null, 2) + "\n");
+    console.log(chalk2.green("\n\u2713 Created .cursor/mcp.json"));
+  }
+  console.log(chalk2.dim("  Restart Cursor to activate.\n"));
+  const legacyConfigPath = path.join(rootDir, ".lien.config.json");
   try {
-    await fs.access(configPath);
-    console.log(chalk2.yellow("\n\u26A0\uFE0F  Note: .lien.config.json found but no longer used"));
+    await fs.access(legacyConfigPath);
+    console.log(chalk2.yellow("\u26A0\uFE0F  Note: .lien.config.json found but no longer used"));
     console.log(chalk2.dim("  You can safely delete it."));
   } catch {
   }
 }
 
 // src/cli/status.ts
+init_banner();
 import chalk3 from "chalk";
 import fs2 from "fs/promises";
 import path2 from "path";
 import os from "os";
-import crypto from "crypto";
 import {
   isGitRepo,
   getCurrentBranch,
   getCurrentCommit,
   readVersionFile,
+  extractRepoId,
   DEFAULT_CONCURRENCY,
   DEFAULT_EMBEDDING_BATCH_SIZE,
   DEFAULT_CHUNK_SIZE,
@@ -3712,12 +3729,14 @@ import {
 } from "@liendev/core";
 async function statusCommand() {
   const rootDir = process.cwd();
-  const projectName = path2.basename(rootDir);
-  const pathHash = crypto.createHash("md5").update(rootDir).digest("hex").substring(0, 8);
-  const indexPath = path2.join(os.homedir(), ".lien", "indices", `${projectName}-${pathHash}`);
+  const repoId = extractRepoId(rootDir);
+  const indexPath = path2.join(os.homedir(), ".lien", "indices", repoId);
   showCompactBanner();
   console.log(chalk3.bold("Status\n"));
-  console.log(chalk3.dim("Configuration:"), chalk3.green("\u2713 Using defaults (no per-project config needed)"));
+  console.log(
+    chalk3.dim("Configuration:"),
+    chalk3.green("\u2713 Using defaults (no per-project config needed)")
+  );
   try {
     const stats = await fs2.stat(indexPath);
     console.log(chalk3.dim("Index location:"), indexPath);
@@ -3725,7 +3744,7 @@ async function statusCommand() {
     try {
       const files = await fs2.readdir(indexPath, { recursive: true });
       console.log(chalk3.dim("Index files:"), files.length);
-    } catch (e) {
+    } catch {
     }
     console.log(chalk3.dim("Last modified:"), stats.mtime.toLocaleString());
     try {
@@ -3736,9 +3755,13 @@ async function statusCommand() {
       }
     } catch {
     }
-  } catch (error) {
+  } catch {
     console.log(chalk3.dim("Index status:"), chalk3.yellow("\u2717 Not indexed"));
-    console.log(chalk3.yellow("\nRun"), chalk3.bold("lien index"), chalk3.yellow("to index your codebase"));
+    console.log(
+      chalk3.yellow("\nRun"),
+      chalk3.bold("lien index"),
+      chalk3.yellow("to index your codebase")
+    );
   }
   console.log(chalk3.bold("\nFeatures:"));
   const isRepo = await isGitRepo(rootDir);
@@ -3775,8 +3798,9 @@ async function statusCommand() {
 }
 
 // src/cli/index-cmd.ts
-import chalk4 from "chalk";
-import ora from "ora";
+init_banner();
+import chalk5 from "chalk";
+import ora2 from "ora";
 import { indexCodebase } from "@liendev/core";
 
 // src/utils/loading-messages.ts
@@ -3855,17 +3879,28 @@ function getModelLoadingMessage() {
   return message;
 }
 
+// src/cli/utils.ts
+import ora from "ora";
+import chalk4 from "chalk";
+import { isLienError, getErrorMessage, getErrorStack } from "@liendev/core";
+function formatDuration(ms) {
+  if (ms < 1e3) {
+    return `${Math.round(ms)}ms`;
+  }
+  return `${(ms / 1e3).toFixed(1)}s`;
+}
+
 // src/cli/index-cmd.ts
 async function clearExistingIndex() {
   const { VectorDB: VectorDB2 } = await import("@liendev/core");
   const { ManifestManager: ManifestManager2 } = await import("@liendev/core");
-  console.log(chalk4.yellow("Clearing existing index and manifest..."));
+  console.log(chalk5.yellow("Clearing existing index and manifest..."));
   const vectorDB = new VectorDB2(process.cwd());
   await vectorDB.initialize();
   await vectorDB.clear();
   const manifest = new ManifestManager2(vectorDB.dbPath);
   await manifest.clear();
-  console.log(chalk4.green("\u2713 Index and manifest cleared\n"));
+  console.log(chalk5.green("\u2713 Index and manifest cleared\n"));
 }
 function createProgressTracker() {
   return {
@@ -3932,19 +3967,24 @@ function createProgressCallback(spinner, tracker) {
       if (progress.filesTotal && progress.filesProcessed !== void 0) {
         message = `${message} (${progress.filesProcessed}/${progress.filesTotal})`;
       }
-      spinner.succeed(chalk4.green(message));
+      spinner.succeed(chalk5.green(message));
     } else {
       updateSpinner(spinner, tracker);
     }
   };
 }
-function displayFinalResult(spinner, tracker, result) {
-  if (!tracker.completedViaProgress) {
-    if (result.filesIndexed === 0) {
-      spinner.succeed(chalk4.green("Index is up to date - no changes detected"));
-    } else {
-      spinner.succeed(chalk4.green(`Indexed ${result.filesIndexed} files, ${result.chunksCreated} chunks`));
-    }
+function displayFinalResult(spinner, tracker, result, durationMs) {
+  const timing = formatDuration(durationMs);
+  if (tracker.completedViaProgress) {
+    console.log(chalk5.dim(`  Completed in ${timing}`));
+  } else if (result.filesIndexed === 0) {
+    spinner.succeed(chalk5.green(`Index is up to date - no changes detected in ${timing}`));
+  } else {
+    spinner.succeed(
+      chalk5.green(
+        `Indexed ${result.filesIndexed} files, ${result.chunksCreated} chunks in ${timing}`
+      )
+    );
   }
 }
 async function indexCommand(options) {
@@ -3953,7 +3993,7 @@ async function indexCommand(options) {
     if (options.force) {
       await clearExistingIndex();
     }
-    const spinner = ora({
+    const spinner = ora2({
       text: "Starting indexing...",
       interval: 30
       // Faster refresh rate for smoother progress
@@ -3968,22 +4008,19 @@ async function indexCommand(options) {
     });
     stopMessageRotation(tracker);
     if (!result.success && result.error) {
-      spinner.fail(chalk4.red("Indexing failed"));
-      console.error(chalk4.red("\n" + result.error));
+      spinner.fail(chalk5.red("Indexing failed"));
+      console.error(chalk5.red("\n" + result.error));
       process.exit(1);
     }
-    displayFinalResult(spinner, tracker, result);
-    if (options.watch) {
-      console.log(chalk4.yellow("\n\u26A0\uFE0F  Watch mode not yet implemented"));
-    }
+    displayFinalResult(spinner, tracker, result, result.durationMs);
   } catch (error) {
-    console.error(chalk4.red("Error during indexing:"), error);
+    console.error(chalk5.red("Error during indexing:"), error);
     process.exit(1);
   }
 }
 
 // src/cli/serve.ts
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 import fs5 from "fs/promises";
 import path4 from "path";
 
@@ -3993,16 +4030,16 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { createRequire as createRequire2 } from "module";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { dirname as dirname2, join as join2 } from "path";
-import {
-  WorkerEmbeddings,
-  VERSION_CHECK_INTERVAL_MS,
-  createVectorDB
-} from "@liendev/core";
+import { WorkerEmbeddings, VERSION_CHECK_INTERVAL_MS, createVectorDB } from "@liendev/core";
 
 // src/watcher/index.ts
 import chokidar from "chokidar";
 import path3 from "path";
-import { detectEcosystems, getEcosystemExcludePatterns, ALWAYS_IGNORE_PATTERNS } from "@liendev/core";
+import {
+  detectEcosystems,
+  getEcosystemExcludePatterns,
+  ALWAYS_IGNORE_PATTERNS
+} from "@liendev/core";
 var FileWatcher = class {
   watcher = null;
   rootDir;
@@ -4115,7 +4152,7 @@ var FileWatcher = class {
   }
   /**
    * Starts watching files for changes.
-   * 
+   *
    * @param handler - Callback function called when files change
    */
   async start(handler) {
@@ -4131,7 +4168,7 @@ var FileWatcher = class {
   /**
    * Enable watching .git directory for git operations.
    * Call this after start() to enable event-driven git detection.
-   * 
+   *
    * @param onGitChange - Callback invoked when git operations detected
    */
   watchGit(onGitChange) {
@@ -4185,7 +4222,7 @@ var FileWatcher = class {
     this.gitChangeTimer = setTimeout(async () => {
       try {
         await this.gitChangeHandler?.();
-      } catch (error) {
+      } catch {
       }
       this.gitChangeTimer = null;
     }, this.GIT_DEBOUNCE_MS);
@@ -4194,7 +4231,7 @@ var FileWatcher = class {
    * Handles a file change event with smart batching.
    * Collects rapid changes across multiple files and processes them together.
    * Forces flush after MAX_BATCH_WAIT_MS even if changes keep arriving.
-   * 
+   *
    * If a batch is currently being processed by an async handler, waits for completion
    * before starting a new batch to prevent race conditions.
    */
@@ -4290,7 +4327,7 @@ var FileWatcher = class {
       } else {
         this.handleBatchComplete();
       }
-    } catch (error) {
+    } catch {
       this.handleBatchComplete();
     }
   }
@@ -4338,7 +4375,7 @@ var FileWatcher = class {
         modified,
         deleted
       });
-    } catch (error) {
+    } catch {
     }
   }
   /**
@@ -4400,10 +4437,7 @@ var FileWatcher = class {
 };
 
 // src/mcp/server-config.ts
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema
-} from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
 // src/mcp/utils/zod-to-json-schema.ts
 import { zodToJsonSchema } from "zod-to-json-schema";
@@ -8468,25 +8502,23 @@ var SemanticSearchSchema = external_exports.object({
     "Number of results to return.\n\nDefault: 5\nIncrease to 10-15 for broad exploration."
   ),
   crossRepo: external_exports.boolean().default(false).describe(
-    "If true, search across all repos in the organization (requires Qdrant backend).\n\nDefault: false (single-repo search)\nWhen enabled, results are grouped by repository."
+    "If true, search across all repos in the organization (requires a cross-repo-capable backend, currently Qdrant).\n\nDefault: false (single-repo search)\nWhen enabled, results are grouped by repository."
   ),
-  repoIds: external_exports.array(external_exports.string()).optional().describe(
+  repoIds: external_exports.array(external_exports.string().max(255)).optional().describe(
     "Optional: Filter to specific repos when crossRepo=true.\n\nIf provided, only searches within the specified repositories.\nIf omitted and crossRepo=true, searches all repos in the organization."
   )
 });
 
 // src/mcp/schemas/similarity.schema.ts
 var FindSimilarSchema = external_exports.object({
-  code: external_exports.string().min(24, "Code snippet must be at least 24 characters").describe(
+  code: external_exports.string().min(24, "Code snippet must be at least 24 characters").max(5e4, "Code snippet too long (max 50000 characters)").describe(
     "Code snippet to find similar implementations for.\n\nProvide a representative code sample that demonstrates the pattern you want to find similar examples of in the codebase."
   ),
-  limit: external_exports.number().int().min(1, "Limit must be at least 1").max(20, "Limit cannot exceed 20").default(5).describe(
-    "Number of similar code blocks to return.\n\nDefault: 5"
-  ),
-  language: external_exports.string().min(1, "Language filter cannot be empty").optional().describe(
+  limit: external_exports.number().int().min(1, "Limit must be at least 1").max(20, "Limit cannot exceed 20").default(5).describe("Number of similar code blocks to return.\n\nDefault: 5"),
+  language: external_exports.string().min(1, "Language filter cannot be empty").max(50).optional().describe(
     "Filter by programming language.\n\nExamples: 'typescript', 'python', 'javascript', 'php'\n\nIf omitted, searches all languages."
   ),
-  pathHint: external_exports.string().min(1, "Path hint cannot be empty").optional().describe(
+  pathHint: external_exports.string().min(1, "Path hint cannot be empty").max(500).optional().describe(
     "Filter by file path substring.\n\nOnly returns results where the file path contains this string (case-insensitive).\n\nExamples: 'src/api', 'components', 'utils'"
   )
 });
@@ -8494,8 +8526,8 @@ var FindSimilarSchema = external_exports.object({
 // src/mcp/schemas/file.schema.ts
 var GetFilesContextSchema = external_exports.object({
   filepaths: external_exports.union([
-    external_exports.string().min(1, "Filepath cannot be empty"),
-    external_exports.array(external_exports.string().min(1, "Filepath cannot be empty")).min(1, "Array must contain at least one filepath").max(50, "Maximum 50 files per request")
+    external_exports.string().min(1, "Filepath cannot be empty").max(1e3),
+    external_exports.array(external_exports.string().min(1, "Filepath cannot be empty").max(1e3)).min(1, "Array must contain at least one filepath").max(50, "Maximum 50 files per request")
   ]).describe(
     "Single filepath or array of filepaths (relative to workspace root).\n\nSingle file: 'src/components/Button.tsx'\nMultiple files: ['src/auth.ts', 'src/user.ts']\n\nMaximum 50 files per request for batch operations."
   ),
@@ -8506,10 +8538,10 @@ var GetFilesContextSchema = external_exports.object({
 
 // src/mcp/schemas/symbols.schema.ts
 var ListFunctionsSchema = external_exports.object({
-  pattern: external_exports.string().optional().describe(
+  pattern: external_exports.string().max(200).optional().describe(
     "Regex pattern to match symbol names.\n\nExamples:\n  - '.*Controller.*' to find all Controllers\n  - 'handle.*' to find handlers\n  - '.*Service$' to find Services\n\nIf omitted, returns all symbols."
   ),
-  language: external_exports.string().optional().describe(
+  language: external_exports.string().max(50).optional().describe(
     "Filter by programming language.\n\nExamples: 'typescript', 'python', 'javascript', 'php'\n\nIf omitted, searches all languages."
   ),
   symbolType: external_exports.enum(["function", "method", "class", "interface"]).optional().describe("Filter by symbol type. If omitted, returns all types."),
@@ -8523,23 +8555,23 @@ var ListFunctionsSchema = external_exports.object({
 
 // src/mcp/schemas/dependents.schema.ts
 var GetDependentsSchema = external_exports.object({
-  filepath: external_exports.string().min(1, "Filepath cannot be empty").describe(
+  filepath: external_exports.string().min(1, "Filepath cannot be empty").max(1e3).describe(
     "Path to file to find dependents for (relative to workspace root).\n\nExample: 'src/utils/validate.ts'\n\nReturns all files that import or depend on this file.\n\nNote: Scans up to 10,000 code chunks. For very large codebases,\nresults may be incomplete (a warning will be included if truncated)."
   ),
-  symbol: external_exports.string().min(1, "Symbol cannot be an empty string").optional().describe(
+  symbol: external_exports.string().min(1, "Symbol cannot be an empty string").max(500).optional().describe(
     "Optional: specific exported symbol to find usages of.\n\nWhen provided, returns call sites instead of just importing files.\n\nExample: 'validateEmail' to find where validateEmail() is called.\n\nResponse includes 'usages' array showing which functions call this symbol."
   ),
   depth: external_exports.number().int().min(1).max(1).default(1).describe(
     "Depth of transitive dependencies. Only depth=1 (direct dependents) is currently supported.\n\n1 = Direct dependents only"
   ),
   crossRepo: external_exports.boolean().default(false).describe(
-    "If true, find dependents across all repos in the organization (requires Qdrant backend).\n\nDefault: false (single-repo search)\nWhen enabled, results are grouped by repository."
+    "If true, find dependents across all repos in the organization (requires a cross-repo-capable backend, currently Qdrant).\n\nDefault: false (single-repo search)\nWhen enabled, results are grouped by repository."
   )
 });
 
 // src/mcp/schemas/complexity.schema.ts
 var GetComplexitySchema = external_exports.object({
-  files: external_exports.array(external_exports.string().min(1, "Filepath cannot be empty")).optional().describe(
+  files: external_exports.array(external_exports.string().min(1, "Filepath cannot be empty").max(1e3)).optional().describe(
     "Specific files to analyze. If omitted, analyzes entire codebase.\n\nExample: ['src/auth.ts', 'src/api/user.ts']"
   ),
   top: external_exports.number().int().min(1, "Top must be at least 1").max(50, "Top cannot exceed 50").default(10).describe(
@@ -8549,9 +8581,9 @@ var GetComplexitySchema = external_exports.object({
     "Only return functions above this complexity threshold.\n\nNote: Violations are first identified using the threshold from lien.config.json (default: 15). This parameter filters those violations to show only items above the specified value. Setting threshold below the config threshold will not show additional functions."
   ),
   crossRepo: external_exports.boolean().default(false).describe(
-    "If true, analyze complexity across all repos in the organization (requires Qdrant backend).\n\nDefault: false (single-repo analysis)\nWhen enabled, results are aggregated by repository."
+    "If true, analyze complexity across all repos in the organization (requires a cross-repo-capable backend, currently Qdrant).\n\nDefault: false (single-repo analysis)\nWhen enabled, results are aggregated by repository."
   ),
-  repoIds: external_exports.array(external_exports.string()).optional().describe(
+  repoIds: external_exports.array(external_exports.string().max(255)).optional().describe(
     "Optional: Filter to specific repos when crossRepo=true.\n\nIf provided, only analyzes the specified repositories.\nIf omitted and crossRepo=true, analyzes all repos in the organization."
   )
 });
@@ -8816,10 +8848,12 @@ function wrapToolHandler(schema, handler) {
 ${truncation.message}` : truncation.message;
       }
       return {
-        content: [{
-          type: "text",
-          text: JSON.stringify(result, null, 2)
-        }]
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(result, null, 2)
+          }
+        ]
       };
     } catch (error) {
       return formatErrorResponse(error);
@@ -8830,42 +8864,57 @@ function formatErrorResponse(error) {
   if (error instanceof ZodError) {
     return {
       isError: true,
-      content: [{
-        type: "text",
-        text: JSON.stringify({
-          error: "Invalid parameters",
-          code: LienErrorCode.INVALID_INPUT,
-          details: error.errors.map((e) => ({
-            field: e.path.join("."),
-            message: e.message
-          }))
-        }, null, 2)
-      }]
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            {
+              error: "Invalid parameters",
+              code: LienErrorCode.INVALID_INPUT,
+              details: error.errors.map((e) => ({
+                field: e.path.join("."),
+                message: e.message
+              }))
+            },
+            null,
+            2
+          )
+        }
+      ]
     };
   }
   if (error instanceof LienError) {
     return {
       isError: true,
-      content: [{
-        type: "text",
-        text: JSON.stringify(error.toJSON(), null, 2)
-      }]
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(error.toJSON(), null, 2)
+        }
+      ]
     };
   }
   console.error("Unexpected error in tool handler:", error);
   return {
     isError: true,
-    content: [{
-      type: "text",
-      text: JSON.stringify({
-        error: error instanceof Error ? error.message : "Unknown error",
-        code: LienErrorCode.INTERNAL_ERROR
-      }, null, 2)
-    }]
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(
+          {
+            error: error instanceof Error ? error.message : "Unknown error",
+            code: LienErrorCode.INTERNAL_ERROR
+          },
+          null,
+          2
+        )
+      }
+    ]
   };
 }
 
 // src/mcp/utils/metadata-shaper.ts
+import { normalizeToRelativePath } from "@liendev/core";
 var FIELD_ALLOWLISTS = {
   semantic_search: /* @__PURE__ */ new Set([
     "language",
@@ -8917,7 +8966,12 @@ var FIELD_ALLOWLISTS = {
 function deduplicateResults(results) {
   const seen = /* @__PURE__ */ new Set();
   return results.filter((r) => {
-    const key = JSON.stringify([r.metadata.repoId ?? "", r.metadata.file, r.metadata.startLine, r.metadata.endLine]);
+    const key = JSON.stringify([
+      r.metadata.repoId ?? "",
+      r.metadata.file ? normalizeToRelativePath(r.metadata.file) : "",
+      r.metadata.startLine,
+      r.metadata.endLine
+    ]);
     if (seen.has(key)) return false;
     seen.add(key);
     return true;
@@ -8974,7 +9028,6 @@ function shapeResults(results, tool) {
 }
 
 // src/mcp/handlers/semantic-search.ts
-import { QdrantDB } from "@liendev/core";
 function groupResultsByRepo(results) {
   const grouped = {};
   for (const result of results) {
@@ -8988,13 +9041,18 @@ function groupResultsByRepo(results) {
 }
 async function executeSearch(vectorDB, queryEmbedding, params, log) {
   const { query, limit, crossRepo, repoIds } = params;
-  if (crossRepo && vectorDB instanceof QdrantDB) {
+  if (crossRepo && vectorDB.supportsCrossRepo) {
     const results2 = await vectorDB.searchCrossRepo(queryEmbedding, limit, { repoIds });
-    log(`Found ${results2.length} results across ${Object.keys(groupResultsByRepo(results2)).length} repos`);
+    log(
+      `Found ${results2.length} results across ${Object.keys(groupResultsByRepo(results2)).length} repos`
+    );
     return { results: results2, crossRepoFallback: false };
   }
   if (crossRepo) {
-    log("Warning: crossRepo=true requires Qdrant backend. Falling back to single-repo search.", "warning");
+    log(
+      "Warning: crossRepo=true requires a cross-repo-capable backend. Falling back to single-repo search.",
+      "warning"
+    );
   }
   const results = await vectorDB.search(queryEmbedding, limit, query);
   log(`Found ${results.length} results`);
@@ -9003,7 +9061,9 @@ async function executeSearch(vectorDB, queryEmbedding, params, log) {
 function processResults(rawResults, crossRepoFallback, log) {
   const notes = [];
   if (crossRepoFallback) {
-    notes.push("Cross-repo search requires Qdrant backend. Fell back to single-repo search.");
+    notes.push(
+      "Cross-repo search requires a cross-repo-capable backend. Fell back to single-repo search."
+    );
   }
   const results = deduplicateResults(rawResults);
   if (results.length > 0 && results.every((r) => r.relevance === "not_relevant")) {
@@ -9015,33 +9075,32 @@ function processResults(rawResults, crossRepoFallback, log) {
 }
 async function handleSemanticSearch(args, ctx) {
   const { vectorDB, embeddings, log, checkAndReconnect, getIndexMetadata } = ctx;
-  return await wrapToolHandler(
-    SemanticSearchSchema,
-    async (validatedArgs) => {
-      const { crossRepo, repoIds, query, limit } = validatedArgs;
-      log(`Searching for: "${query}"${crossRepo ? " (cross-repo)" : ""}`);
-      await checkAndReconnect();
-      const queryEmbedding = await embeddings.embed(query);
-      const { results: rawResults, crossRepoFallback } = await executeSearch(
-        vectorDB,
-        queryEmbedding,
-        { query, limit: limit ?? 5, crossRepo, repoIds },
-        log
+  return await wrapToolHandler(SemanticSearchSchema, async (validatedArgs) => {
+    const { crossRepo, repoIds, query, limit } = validatedArgs;
+    log(`Searching for: "${query}"${crossRepo ? " (cross-repo)" : ""}`);
+    await checkAndReconnect();
+    const queryEmbedding = await embeddings.embed(query);
+    const { results: rawResults, crossRepoFallback } = await executeSearch(
+      vectorDB,
+      queryEmbedding,
+      { query, limit: limit ?? 5, crossRepo, repoIds },
+      log
+    );
+    const { results, notes } = processResults(rawResults, crossRepoFallback, log);
+    log(`Returning ${results.length} results`);
+    const shaped = shapeResults(results, "semantic_search");
+    if (shaped.length === 0) {
+      notes.push(
+        '0 results. Try rephrasing as a full question (e.g. "How does X work?"), or use grep for exact string matches. If the codebase was recently updated, run "lien reindex".'
       );
-      const { results, notes } = processResults(rawResults, crossRepoFallback, log);
-      log(`Returning ${results.length} results`);
-      const shaped = shapeResults(results, "semantic_search");
-      if (shaped.length === 0) {
-        notes.push('0 results. Try rephrasing as a full question (e.g. "How does X work?"), or use grep for exact string matches. If the codebase was recently updated, run "lien reindex".');
-      }
-      return {
-        indexInfo: getIndexMetadata(),
-        results: shaped,
-        ...crossRepo && vectorDB instanceof QdrantDB && { groupedByRepo: groupResultsByRepo(shaped) },
-        ...notes.length > 0 && { note: notes.join(" ") }
-      };
     }
-  )(args);
+    return {
+      indexInfo: getIndexMetadata(),
+      results: shaped,
+      ...crossRepo && vectorDB.supportsCrossRepo && { groupedByRepo: groupResultsByRepo(shaped) },
+      ...notes.length > 0 && { note: notes.join(" ") }
+    };
+  })(args);
 }
 
 // src/mcp/handlers/find-similar.ts
@@ -9060,151 +9119,52 @@ function pruneIrrelevantResults(results) {
 }
 async function handleFindSimilar(args, ctx) {
   const { vectorDB, embeddings, log, checkAndReconnect, getIndexMetadata } = ctx;
-  return await wrapToolHandler(
-    FindSimilarSchema,
-    async (validatedArgs) => {
-      log(`Finding similar code...`);
-      await checkAndReconnect();
-      const codeEmbedding = await embeddings.embed(validatedArgs.code);
-      const limit = validatedArgs.limit ?? 5;
-      const extraLimit = limit + 10;
-      let results = await vectorDB.search(codeEmbedding, extraLimit, validatedArgs.code);
-      results = deduplicateResults(results);
-      const inputCode = validatedArgs.code.trim();
-      results = results.filter((r) => {
-        if (r.score >= 0.1) return true;
-        return r.content.trim() !== inputCode;
-      });
-      const filtersApplied = { prunedLowRelevance: 0 };
-      if (validatedArgs.language) {
-        filtersApplied.language = validatedArgs.language;
-        results = applyLanguageFilter(results, validatedArgs.language);
-      }
-      if (validatedArgs.pathHint) {
-        filtersApplied.pathHint = validatedArgs.pathHint;
-        results = applyPathHintFilter(results, validatedArgs.pathHint);
-      }
-      const { filtered, prunedCount } = pruneIrrelevantResults(results);
-      filtersApplied.prunedLowRelevance = prunedCount;
-      const finalResults = filtered.slice(0, limit);
-      log(`Found ${finalResults.length} similar chunks`);
-      const hasFilters = filtersApplied.language || filtersApplied.pathHint || filtersApplied.prunedLowRelevance > 0;
-      return {
-        indexInfo: getIndexMetadata(),
-        results: shapeResults(finalResults, "find_similar"),
-        ...hasFilters && { filtersApplied },
-        ...finalResults.length === 0 && { note: "0 results. Ensure the code snippet is at least 24 characters and representative of the pattern. Try grep for exact string matches." }
-      };
-    }
-  )(args);
-}
-
-// src/mcp/utils/path-matching.ts
-import { getSupportedExtensions } from "@liendev/core";
-function escapeRegex(str) {
-  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-var extensionRegex = null;
-function getExtensionRegex() {
-  if (!extensionRegex) {
-    const extPattern = getSupportedExtensions().map(escapeRegex).join("|");
-    extensionRegex = new RegExp(`\\.(${extPattern})$`);
-  }
-  return extensionRegex;
-}
-function normalizePath(path7, workspaceRoot) {
-  let normalized = path7.replace(/['"]/g, "").trim().replace(/\\/g, "/");
-  normalized = normalized.replace(getExtensionRegex(), "");
-  if (normalized.startsWith(workspaceRoot + "/")) {
-    normalized = normalized.substring(workspaceRoot.length + 1);
-  }
-  return normalized;
-}
-function matchesAtBoundary(str, pattern) {
-  const index = str.indexOf(pattern);
-  if (index === -1) return false;
-  const charBefore = index > 0 ? str[index - 1] : "/";
-  if (charBefore !== "/" && index !== 0) return false;
-  const endIndex = index + pattern.length;
-  if (endIndex === str.length) return true;
-  const charAfter = str[endIndex];
-  return charAfter === "/";
-}
-function matchesFile(normalizedImport, normalizedTarget) {
-  if (normalizedImport === normalizedTarget) return true;
-  if (matchesAtBoundary(normalizedImport, normalizedTarget)) {
-    return true;
-  }
-  if (matchesAtBoundary(normalizedTarget, normalizedImport)) {
-    return true;
-  }
-  const cleanedImport = normalizedImport.replace(/^(\.\.?\/)+/, "");
-  if (matchesAtBoundary(cleanedImport, normalizedTarget) || matchesAtBoundary(normalizedTarget, cleanedImport)) {
-    return true;
-  }
-  if (matchesPHPNamespace(normalizedImport, normalizedTarget)) {
-    return true;
-  }
-  if (matchesPythonModule(normalizedImport, normalizedTarget)) {
-    return true;
-  }
-  return false;
-}
-function matchesDirectPythonModule(moduleAsPath, targetWithoutPy) {
-  return targetWithoutPy === moduleAsPath || targetWithoutPy === moduleAsPath + "/__init__" || targetWithoutPy.replace(/\/__init__$/, "") === moduleAsPath;
-}
-function matchesParentPythonPackage(moduleAsPath, targetWithoutPy) {
-  return targetWithoutPy.startsWith(moduleAsPath + "/");
-}
-function matchesSuffixPythonModule(moduleAsPath, targetWithoutPy) {
-  return targetWithoutPy.endsWith("/" + moduleAsPath) || targetWithoutPy.endsWith("/" + moduleAsPath + "/__init__");
-}
-function matchesWithSourcePrefix(moduleAsPath, targetWithoutPy) {
-  const moduleIndex = targetWithoutPy.indexOf(moduleAsPath);
-  if (moduleIndex < 0) return false;
-  const prefix = targetWithoutPy.substring(0, moduleIndex);
-  const prefixSlashes = (prefix.match(/\//g) || []).length;
-  return prefixSlashes <= 1 && (prefix === "" || prefix.endsWith("/"));
-}
-function matchesPythonModule(importPath, targetPath) {
-  if (!importPath.includes(".")) {
-    return false;
-  }
-  const moduleAsPath = importPath.replace(/\./g, "/");
-  const targetWithoutPy = targetPath.replace(/\.py$/, "");
-  return matchesDirectPythonModule(moduleAsPath, targetWithoutPy) || matchesParentPythonPackage(moduleAsPath, targetWithoutPy) || matchesSuffixPythonModule(moduleAsPath, targetWithoutPy) || matchesWithSourcePrefix(moduleAsPath, targetWithoutPy);
-}
-function matchesPHPNamespace(importPath, targetPath) {
-  const importComponents = importPath.split("/").filter(Boolean);
-  const targetComponents = targetPath.split("/").filter(Boolean);
-  if (importComponents.length === 0 || targetComponents.length === 0) {
-    return false;
-  }
-  let matched = 0;
-  for (let i = 1; i <= importComponents.length && i <= targetComponents.length; i++) {
-    const impComp = importComponents[importComponents.length - i].toLowerCase();
-    const targetComp = targetComponents[targetComponents.length - i].toLowerCase();
-    if (impComp === targetComp) {
-      matched++;
-    } else {
-      break;
-    }
-  }
-  return matched === importComponents.length;
-}
-function getCanonicalPath(filepath, workspaceRoot) {
-  let canonical = filepath.replace(/\\/g, "/");
-  if (canonical.startsWith(workspaceRoot + "/")) {
-    canonical = canonical.substring(workspaceRoot.length + 1);
-  }
-  return canonical;
-}
-function isTestFile(filepath) {
-  return /\.(test|spec)\.[^/]+$/.test(filepath) || /(^|[/\\])(test|tests|__tests__)[/\\]/.test(filepath);
+  return await wrapToolHandler(FindSimilarSchema, async (validatedArgs) => {
+    log(`Finding similar code...`);
+    await checkAndReconnect();
+    const codeEmbedding = await embeddings.embed(validatedArgs.code);
+    const limit = validatedArgs.limit ?? 5;
+    const extraLimit = limit + 10;
+    let results = await vectorDB.search(codeEmbedding, extraLimit, validatedArgs.code);
+    results = deduplicateResults(results);
+    const inputCode = validatedArgs.code.trim();
+    results = results.filter((r) => {
+      if (r.score >= 0.1) return true;
+      return r.content.trim() !== inputCode;
+    });
+    const filtersApplied = { prunedLowRelevance: 0 };
+    if (validatedArgs.language) {
+      filtersApplied.language = validatedArgs.language;
+      results = applyLanguageFilter(results, validatedArgs.language);
+    }
+    if (validatedArgs.pathHint) {
+      filtersApplied.pathHint = validatedArgs.pathHint;
+      results = applyPathHintFilter(results, validatedArgs.pathHint);
+    }
+    const { filtered, prunedCount } = pruneIrrelevantResults(results);
+    filtersApplied.prunedLowRelevance = prunedCount;
+    const finalResults = filtered.slice(0, limit);
+    log(`Found ${finalResults.length} similar chunks`);
+    const hasFilters = filtersApplied.language || filtersApplied.pathHint || filtersApplied.prunedLowRelevance > 0;
+    return {
+      indexInfo: getIndexMetadata(),
+      results: shapeResults(finalResults, "find_similar"),
+      ...hasFilters && { filtersApplied },
+      ...finalResults.length === 0 && {
+        note: "0 results. Ensure the code snippet is at least 24 characters and representative of the pattern. Try grep for exact string matches."
+      }
+    };
+  })(args);
 }
 
 // src/mcp/handlers/get-files-context.ts
-import { MAX_CHUNKS_PER_FILE } from "@liendev/core";
+import {
+  normalizePath,
+  matchesFile,
+  getCanonicalPath,
+  isTestFile,
+  MAX_CHUNKS_PER_FILE
+} from "@liendev/core";
 var SCAN_LIMIT = 1e4;
 async function searchFileChunks(filepaths, ctx) {
   const { vectorDB, workspaceRoot } = ctx;
@@ -9234,10 +9194,7 @@ async function findRelatedChunks(filepaths, fileChunksMap, ctx) {
       (embedding, i) => vectorDB.search(embedding, 5, filesWithChunks[i].chunks[0].content)
     )
   );
-  const relatedChunksMap = Array.from(
-    { length: filepaths.length },
-    () => []
-  );
+  const relatedChunksMap = Array.from({ length: filepaths.length }, () => []);
   filesWithChunks.forEach(({ filepath, index }, i) => {
     const related = relatedSearches[i];
     const targetCanonical = getCanonicalPath(filepath, workspaceRoot);
@@ -9287,10 +9244,7 @@ function deduplicateChunks(fileChunks, relatedChunks) {
 function buildFilesData(filepaths, fileChunksMap, relatedChunksMap, testAssociationsMap) {
   const filesData = {};
   filepaths.forEach((filepath, i) => {
-    const dedupedChunks = deduplicateChunks(
-      fileChunksMap[i],
-      relatedChunksMap[i] || []
-    );
+    const dedupedChunks = deduplicateChunks(fileChunksMap[i], relatedChunksMap[i] || []);
     filesData[filepath] = {
       chunks: dedupedChunks,
       testAssociations: testAssociationsMap[i]
@@ -9327,61 +9281,48 @@ function buildMultiFileResponse(filesData, indexInfo, note) {
 }
 async function handleGetFilesContext(args, ctx) {
   const { vectorDB, embeddings, log, checkAndReconnect, getIndexMetadata } = ctx;
-  return await wrapToolHandler(
-    GetFilesContextSchema,
-    async (validatedArgs) => {
-      const filepaths = Array.isArray(validatedArgs.filepaths) ? validatedArgs.filepaths : [validatedArgs.filepaths];
-      const isSingleFile = !Array.isArray(validatedArgs.filepaths);
-      log(`Getting context for: ${filepaths.join(", ")}`);
-      await checkAndReconnect();
-      const workspaceRoot = process.cwd().replace(/\\/g, "/");
-      const handlerCtx = {
-        vectorDB,
-        embeddings,
-        log,
-        workspaceRoot
-      };
-      const fileChunksMap = await searchFileChunks(filepaths, handlerCtx);
-      let relatedChunksMap = [];
-      if (validatedArgs.includeRelated !== false) {
-        relatedChunksMap = await findRelatedChunks(
-          filepaths,
-          fileChunksMap,
-          handlerCtx
-        );
-      }
-      const allChunks = await vectorDB.scanWithFilter({ limit: SCAN_LIMIT });
-      const hitScanLimit = allChunks.length === SCAN_LIMIT;
-      if (hitScanLimit) {
-        log(
-          `Scanned ${SCAN_LIMIT} chunks (limit reached). Test associations may be incomplete for large codebases.`,
-          "warning"
-        );
-      }
-      const testAssociationsMap = findTestAssociations(
-        filepaths,
-        allChunks,
-        handlerCtx
-      );
-      const filesData = buildFilesData(
-        filepaths,
-        fileChunksMap,
-        relatedChunksMap,
-        testAssociationsMap
-      );
-      const totalChunks = Object.values(filesData).reduce(
-        (sum, f) => sum + f.chunks.length,
-        0
+  return await wrapToolHandler(GetFilesContextSchema, async (validatedArgs) => {
+    const filepaths = Array.isArray(validatedArgs.filepaths) ? validatedArgs.filepaths : [validatedArgs.filepaths];
+    const isSingleFile = !Array.isArray(validatedArgs.filepaths);
+    log(`Getting context for: ${filepaths.join(", ")}`);
+    await checkAndReconnect();
+    const workspaceRoot = process.cwd().replace(/\\/g, "/");
+    const handlerCtx = {
+      vectorDB,
+      embeddings,
+      log,
+      workspaceRoot
+    };
+    const fileChunksMap = await searchFileChunks(filepaths, handlerCtx);
+    let relatedChunksMap = [];
+    if (validatedArgs.includeRelated !== false) {
+      relatedChunksMap = await findRelatedChunks(filepaths, fileChunksMap, handlerCtx);
+    }
+    const allChunks = await vectorDB.scanWithFilter({ limit: SCAN_LIMIT });
+    const hitScanLimit = allChunks.length === SCAN_LIMIT;
+    if (hitScanLimit) {
+      log(
+        `Scanned ${SCAN_LIMIT} chunks (limit reached). Test associations may be incomplete for large codebases.`,
+        "warning"
       );
-      log(`Found ${totalChunks} total chunks`);
-      const note = buildScanLimitNote(hitScanLimit);
-      const indexInfo = getIndexMetadata();
-      return isSingleFile ? buildSingleFileResponse(filepaths[0], filesData, indexInfo, note) : buildMultiFileResponse(filesData, indexInfo, note);
     }
-  )(args);
+    const testAssociationsMap = findTestAssociations(filepaths, allChunks, handlerCtx);
+    const filesData = buildFilesData(
+      filepaths,
+      fileChunksMap,
+      relatedChunksMap,
+      testAssociationsMap
+    );
+    const totalChunks = Object.values(filesData).reduce((sum, f) => sum + f.chunks.length, 0);
+    log(`Found ${totalChunks} total chunks`);
+    const note = buildScanLimitNote(hitScanLimit);
+    const indexInfo = getIndexMetadata();
+    return isSingleFile ? buildSingleFileResponse(filepaths[0], filesData, indexInfo, note) : buildMultiFileResponse(filesData, indexInfo, note);
+  })(args);
 }
 
 // src/mcp/handlers/list-functions.ts
+import { safeRegex } from "@liendev/core";
 async function performContentScan(vectorDB, args, fetchLimit, log) {
   log("Falling back to content scan...");
   let results = await vectorDB.scanWithFilter({
@@ -9390,11 +9331,15 @@ async function performContentScan(vectorDB, args, fetchLimit, log) {
     limit: fetchLimit
   });
   if (args.pattern) {
-    const regex = new RegExp(args.pattern, "i");
-    results = results.filter((r) => {
-      const symbolName = r.metadata?.symbolName;
-      return symbolName && regex.test(symbolName);
-    });
+    const regex = safeRegex(args.pattern);
+    if (regex) {
+      results = results.filter((r) => {
+        const symbolName = r.metadata?.symbolName;
+        return symbolName && regex.test(symbolName);
+      });
+    } else {
+      results = results.filter((r) => !!r.metadata?.symbolName);
+    }
   }
   return {
     results,
@@ -9431,45 +9376,50 @@ function paginateResults(results, offset, limit) {
 }
 async function handleListFunctions(args, ctx) {
   const { vectorDB, log, checkAndReconnect, getIndexMetadata } = ctx;
-  return await wrapToolHandler(
-    ListFunctionsSchema,
-    async (validatedArgs) => {
-      log("Listing functions with symbol metadata...");
-      await checkAndReconnect();
-      const limit = validatedArgs.limit ?? 50;
-      const offset = validatedArgs.offset ?? 0;
-      const fetchLimit = limit + offset + 1;
-      const queryResult = await queryWithFallback(vectorDB, validatedArgs, fetchLimit, log);
-      const { paginatedResults, hasMore, nextOffset } = paginateResults(queryResult.results, offset, limit);
-      log(`Found ${paginatedResults.length} matches using ${queryResult.method} method`);
-      const notes = [];
-      if (queryResult.results.length === 0) {
-        notes.push('0 results. Try a broader regex pattern (e.g. ".*") or omit the symbolType filter. Use semantic_search for behavior-based queries.');
-      } else if (paginatedResults.length === 0 && offset > 0) {
-        notes.push("No results for this page. The offset is beyond the available results; try reducing or resetting the offset to 0.");
-      }
-      if (queryResult.method === "content") {
-        notes.push('Using content search. Run "lien reindex" to enable faster symbol-based queries.');
-      }
-      return {
-        indexInfo: getIndexMetadata(),
-        method: queryResult.method,
-        hasMore,
-        ...nextOffset !== void 0 ? { nextOffset } : {},
-        results: shapeResults(paginatedResults, "list_functions"),
-        ...notes.length > 0 && { note: notes.join(" ") }
-      };
+  return await wrapToolHandler(ListFunctionsSchema, async (validatedArgs) => {
+    log("Listing functions with symbol metadata...");
+    await checkAndReconnect();
+    const limit = validatedArgs.limit ?? 50;
+    const offset = validatedArgs.offset ?? 0;
+    const fetchLimit = limit + offset + 1;
+    const queryResult = await queryWithFallback(vectorDB, validatedArgs, fetchLimit, log);
+    const { paginatedResults, hasMore, nextOffset } = paginateResults(
+      queryResult.results,
+      offset,
+      limit
+    );
+    log(`Found ${paginatedResults.length} matches using ${queryResult.method} method`);
+    const notes = [];
+    if (queryResult.results.length === 0) {
+      notes.push(
+        '0 results. Try a broader regex pattern (e.g. ".*") or omit the symbolType filter. Use semantic_search for behavior-based queries.'
+      );
+    } else if (paginatedResults.length === 0 && offset > 0) {
+      notes.push(
+        "No results for this page. The offset is beyond the available results; try reducing or resetting the offset to 0."
+      );
+    }
+    if (queryResult.method === "content") {
+      notes.push('Using content search. Run "lien reindex" to enable faster symbol-based queries.');
     }
-  )(args);
+    return {
+      indexInfo: getIndexMetadata(),
+      method: queryResult.method,
+      hasMore,
+      ...nextOffset !== void 0 ? { nextOffset } : {},
+      results: shapeResults(paginatedResults, "list_functions"),
+      ...notes.length > 0 && { note: notes.join(" ") }
+    };
+  })(args);
 }
 
-// src/mcp/handlers/get-dependents.ts
-import { QdrantDB as QdrantDB3 } from "@liendev/core";
-
 // src/mcp/handlers/dependency-analyzer.ts
-import { QdrantDB as QdrantDB2 } from "@liendev/core";
 import {
-  findTransitiveDependents
+  findTransitiveDependents,
+  normalizePath as normalizePath2,
+  matchesFile as matchesFile2,
+  getCanonicalPath as getCanonicalPath2,
+  isTestFile as isTestFile2
 } from "@liendev/core";
 var COMPLEXITY_THRESHOLDS = {
   HIGH_COMPLEXITY_DEPENDENT: 10,
@@ -9487,11 +9437,12 @@ var COMPLEXITY_THRESHOLDS = {
   MEDIUM_MAX: 15
   // Occasional branching
 };
+var scanCache = null;
 function collectNamedSymbolsFromChunk(chunk, normalizedTarget, normalizePathCached, symbols) {
   const importedSymbols = chunk.metadata.importedSymbols;
   if (!importedSymbols || typeof importedSymbols !== "object") return;
   for (const [importPath, syms] of Object.entries(importedSymbols)) {
-    if (matchesFile(normalizePathCached(importPath), normalizedTarget)) {
+    if (matchesFile2(normalizePathCached(importPath), normalizedTarget)) {
       for (const sym of syms) symbols.add(sym);
     }
   }
@@ -9499,7 +9450,7 @@ function collectNamedSymbolsFromChunk(chunk, normalizedTarget, normalizePathCach
 function collectRawImportSentinel(chunk, normalizedTarget, normalizePathCached, symbols) {
   const imports = chunk.metadata.imports || [];
   for (const imp of imports) {
-    if (matchesFile(normalizePathCached(imp), normalizedTarget)) symbols.add("*");
+    if (matchesFile2(normalizePathCached(imp), normalizedTarget)) symbols.add("*");
   }
 }
 function collectSymbolsFromChunk(chunk, normalizedTarget, normalizePathCached, symbols) {
@@ -9534,8 +9485,12 @@ function findReExportedSymbols(importsFromTarget, allExports) {
 function buildReExportGraph(allChunksByFile, normalizedTarget, normalizePathCached) {
   const reExporters = [];
   for (const [filepath, chunks] of allChunksByFile.entries()) {
-    if (matchesFile(filepath, normalizedTarget)) continue;
-    const importsFromTarget = collectImportedSymbolsFromTarget(chunks, normalizedTarget, normalizePathCached);
+    if (matchesFile2(filepath, normalizedTarget)) continue;
+    const importsFromTarget = collectImportedSymbolsFromTarget(
+      chunks,
+      normalizedTarget,
+      normalizePathCached
+    );
     const allExports = collectExportsFromChunks(chunks);
     if (importsFromTarget.size === 0 || allExports.size === 0) continue;
     const reExportedSymbols = findReExportedSymbols(importsFromTarget, allExports);
@@ -9551,7 +9506,7 @@ function fileImportsSymbolFromAny(chunks, targetSymbol, targetPaths, normalizePa
     if (!importedSymbols) return false;
     for (const [importPath, symbols] of Object.entries(importedSymbols)) {
       const normalizedImport = normalizePathCached(importPath);
-      const matchesAny = targetPaths.some((tp) => matchesFile(normalizedImport, tp));
+      const matchesAny = targetPaths.some((tp) => matchesFile2(normalizedImport, tp));
       if (matchesAny) {
         if (symbols.includes(targetSymbol)) return true;
         if (symbols.some((s) => s.startsWith("* as "))) return true;
@@ -9580,39 +9535,51 @@ function addChunkToImportIndex(chunk, normalizePathCached, importIndex) {
     }
   }
 }
-function addChunkToFileMap(chunk, normalizePathCached, fileMap) {
+function addChunkToFileMap(chunk, normalizePathCached, fileMap, seenRanges) {
   const canonical = normalizePathCached(chunk.metadata.file);
   if (!fileMap.has(canonical)) {
     fileMap.set(canonical, []);
+    seenRanges.set(canonical, /* @__PURE__ */ new Set());
   }
+  const rangeKey = `${chunk.metadata.startLine}-${chunk.metadata.endLine}`;
+  const seen = seenRanges.get(canonical);
+  if (seen.has(rangeKey)) return;
+  seen.add(rangeKey);
   fileMap.get(canonical).push(chunk);
 }
 async function scanChunksPaginated(vectorDB, crossRepo, log, normalizePathCached) {
   const importIndex = /* @__PURE__ */ new Map();
   const allChunksByFile = /* @__PURE__ */ new Map();
+  const seenRanges = /* @__PURE__ */ new Map();
   let totalChunks = 0;
-  if (crossRepo && vectorDB instanceof QdrantDB2) {
+  if (crossRepo && vectorDB.supportsCrossRepo) {
     const CROSS_REPO_LIMIT = 1e5;
     const allChunks = await vectorDB.scanCrossRepo({ limit: CROSS_REPO_LIMIT });
     totalChunks = allChunks.length;
     const hitLimit = totalChunks >= CROSS_REPO_LIMIT;
     if (hitLimit) {
-      log(`Warning: cross-repo scan hit ${CROSS_REPO_LIMIT} chunk limit. Results may be incomplete.`, "warning");
+      log(
+        `Warning: cross-repo scan hit ${CROSS_REPO_LIMIT} chunk limit. Results may be incomplete.`,
+        "warning"
+      );
     }
     for (const chunk of allChunks) {
       addChunkToImportIndex(chunk, normalizePathCached, importIndex);
-      addChunkToFileMap(chunk, normalizePathCached, allChunksByFile);
+      addChunkToFileMap(chunk, normalizePathCached, allChunksByFile, seenRanges);
     }
     return { importIndex, allChunksByFile, totalChunks, hitLimit };
   }
   if (crossRepo) {
-    log("Warning: crossRepo=true requires Qdrant backend. Falling back to single-repo paginated scan.", "warning");
+    log(
+      "Warning: crossRepo=true requires a cross-repo-capable backend. Falling back to single-repo paginated scan.",
+      "warning"
+    );
   }
   for await (const page of vectorDB.scanPaginated({ pageSize: 1e3 })) {
     totalChunks += page.length;
     for (const chunk of page) {
       addChunkToImportIndex(chunk, normalizePathCached, importIndex);
-      addChunkToFileMap(chunk, normalizePathCached, allChunksByFile);
+      addChunkToFileMap(chunk, normalizePathCached, allChunksByFile, seenRanges);
     }
   }
   return { importIndex, allChunksByFile, totalChunks, hitLimit: false };
@@ -9622,7 +9589,7 @@ function createPathNormalizer() {
   const cache = /* @__PURE__ */ new Map();
   return (path7) => {
     if (!cache.has(path7)) {
-      cache.set(path7, normalizePath(path7, workspaceRoot));
+      cache.set(path7, normalizePath2(path7, workspaceRoot));
     }
     return cache.get(path7);
   };
@@ -9631,7 +9598,7 @@ function groupChunksByFile(chunks) {
   const workspaceRoot = process.cwd().replace(/\\/g, "/");
   const chunksByFile = /* @__PURE__ */ new Map();
   for (const chunk of chunks) {
-    const canonical = getCanonicalPath(chunk.metadata.file, workspaceRoot);
+    const canonical = getCanonicalPath2(chunk.metadata.file, workspaceRoot);
     const existing = chunksByFile.get(canonical) || [];
     existing.push(chunk);
     chunksByFile.set(canonical, existing);
@@ -9641,18 +9608,22 @@ function groupChunksByFile(chunks) {
 function buildDependentsList(chunksByFile, symbol, normalizedTarget, normalizePathCached, targetFileChunks, filepath, log, reExporterPaths = []) {
   if (symbol) {
     validateSymbolExport(targetFileChunks, symbol, filepath, log);
-    return findSymbolUsages(chunksByFile, symbol, normalizedTarget, normalizePathCached, reExporterPaths);
+    return findSymbolUsages(
+      chunksByFile,
+      symbol,
+      normalizedTarget,
+      normalizePathCached,
+      reExporterPaths
+    );
   }
   const dependents = Array.from(chunksByFile.keys()).map((fp) => ({
     filepath: fp,
-    isTestFile: isTestFile(fp)
+    isTestFile: isTestFile2(fp)
   }));
   return { dependents, totalUsageCount: void 0 };
 }
 function validateSymbolExport(targetFileChunks, symbol, filepath, log) {
-  const exportsSymbol = targetFileChunks.some(
-    (chunk) => chunk.metadata.exports?.includes(symbol)
-  );
+  const exportsSymbol = targetFileChunks.some((chunk) => chunk.metadata.exports?.includes(symbol));
   if (!exportsSymbol) {
     log(`Warning: Symbol "${symbol}" not found in exports of ${filepath}`, "warning");
   }
@@ -9683,22 +9654,53 @@ function mergeTransitiveDependents(reExporters, importIndex, normalizedTarget, n
     log(`Found ${transitiveByFile.size} additional dependents via re-export chains`);
   }
 }
-async function findDependents(vectorDB, filepath, crossRepo, log, symbol) {
+async function getOrScanChunks(vectorDB, crossRepo, log, normalizePathCached, indexVersion) {
+  if (indexVersion !== void 0 && scanCache !== null && scanCache.indexVersion === indexVersion && scanCache.crossRepo === crossRepo) {
+    log(`Using cached import index (${scanCache.totalChunks} chunks, version ${indexVersion})`);
+    return scanCache;
+  }
+  const scanResult = await scanChunksPaginated(vectorDB, crossRepo, log, normalizePathCached);
+  if (indexVersion !== void 0) {
+    scanCache = { indexVersion, crossRepo, ...scanResult };
+  }
+  log(`Scanned ${scanResult.totalChunks} chunks for imports...`);
+  return scanResult;
+}
+function resolveTransitiveDependents(allChunksByFile, normalizedTarget, normalizePathCached, importIndex, chunksByFile, log) {
+  const reExporters = buildReExportGraph(allChunksByFile, normalizedTarget, normalizePathCached);
+  if (reExporters.length > 0) {
+    mergeTransitiveDependents(
+      reExporters,
+      importIndex,
+      normalizedTarget,
+      normalizePathCached,
+      allChunksByFile,
+      chunksByFile,
+      log
+    );
+  }
+  return reExporters;
+}
+async function findDependents(vectorDB, filepath, crossRepo, log, symbol, indexVersion) {
   const normalizePathCached = createPathNormalizer();
   const normalizedTarget = normalizePathCached(filepath);
-  const { importIndex, allChunksByFile, totalChunks, hitLimit } = await scanChunksPaginated(
+  const { importIndex, allChunksByFile, hitLimit } = await getOrScanChunks(
     vectorDB,
     crossRepo,
     log,
-    normalizePathCached
+    normalizePathCached,
+    indexVersion
   );
-  log(`Scanned ${totalChunks} chunks for imports...`);
   const dependentChunks = findDependentChunks(importIndex, normalizedTarget);
   const chunksByFile = groupChunksByFile(dependentChunks);
-  const reExporters = buildReExportGraph(allChunksByFile, normalizedTarget, normalizePathCached);
-  if (reExporters.length > 0) {
-    mergeTransitiveDependents(reExporters, importIndex, normalizedTarget, normalizePathCached, allChunksByFile, chunksByFile, log);
-  }
+  const reExporters = resolveTransitiveDependents(
+    allChunksByFile,
+    normalizedTarget,
+    normalizePathCached,
+    importIndex,
+    chunksByFile,
+    log
+  );
   const fileComplexities = calculateFileComplexities(chunksByFile);
   const complexityMetrics = calculateOverallComplexityMetrics(fileComplexities);
   const targetFileChunks = symbol ? allChunksByFile.get(normalizedTarget) ?? [] : [];
@@ -9748,7 +9750,7 @@ function findDependentChunks(importIndex, normalizedTarget) {
     }
   }
   for (const [normalizedImport, chunks] of importIndex.entries()) {
-    if (normalizedImport !== normalizedTarget && matchesFile(normalizedImport, normalizedTarget)) {
+    if (normalizedImport !== normalizedTarget && matchesFile2(normalizedImport, normalizedTarget)) {
       for (const chunk of chunks) {
         addChunk(chunk);
       }
@@ -9787,7 +9789,11 @@ function calculateOverallComplexityMetrics(fileComplexities) {
   const allMaxes = fileComplexities.map((f) => f.maxComplexity);
   const totalAvg = allAvgs.reduce((a, b) => a + b, 0) / allAvgs.length;
   const globalMax = Math.max(...allMaxes);
-  const highComplexityDependents = fileComplexities.filter((f) => f.maxComplexity > COMPLEXITY_THRESHOLDS.HIGH_COMPLEXITY_DEPENDENT).sort((a, b) => b.maxComplexity - a.maxComplexity).slice(0, 5).map((f) => ({ filepath: f.filepath, maxComplexity: f.maxComplexity, avgComplexity: f.avgComplexity }));
+  const highComplexityDependents = fileComplexities.filter((f) => f.maxComplexity > COMPLEXITY_THRESHOLDS.HIGH_COMPLEXITY_DEPENDENT).sort((a, b) => b.maxComplexity - a.maxComplexity).slice(0, 5).map((f) => ({
+    filepath: f.filepath,
+    maxComplexity: f.maxComplexity,
+    avgComplexity: f.avgComplexity
+  }));
   const complexityRiskBoost = calculateComplexityRiskBoost(totalAvg, globalMax);
   return {
     averageComplexity: Math.round(totalAvg * 10) / 10,
@@ -9860,7 +9866,7 @@ function findSymbolUsages(chunksByFile, targetSymbol, normalizedTarget, normaliz
     const usages = extractSymbolUsagesFromChunks(chunks, targetSymbol);
     dependents.push({
       filepath,
-      isTestFile: isTestFile(filepath),
+      isTestFile: isTestFile2(filepath),
       usages: usages.length > 0 ? usages : void 0
     });
     totalUsageCount += usages.length;
@@ -9913,12 +9919,14 @@ function extractSnippet(lines, callLine, startLine, symbolName) {
 
 // src/mcp/handlers/get-dependents.ts
 function checkCrossRepoFallback(crossRepo, vectorDB) {
-  return Boolean(crossRepo && !(vectorDB instanceof QdrantDB3));
+  return Boolean(crossRepo && !vectorDB.supportsCrossRepo);
 }
 function buildNotes(crossRepoFallback, hitLimit) {
   const notes = [];
   if (crossRepoFallback) {
-    notes.push("Cross-repo search requires Qdrant backend. Fell back to single-repo search.");
+    notes.push(
+      "Cross-repo search requires a cross-repo-capable backend. Fell back to single-repo search."
+    );
   }
   if (hitLimit) {
     notes.push("Scanned 10,000 chunks (limit reached). Results may be incomplete.");
@@ -9938,9 +9946,7 @@ function logRiskAssessment(analysis, riskLevel, symbol, log) {
       );
     }
   } else {
-    log(
-      `Found ${analysis.dependents.length} dependents ${prodTest} - risk: ${riskLevel}`
-    );
+    log(`Found ${analysis.dependents.length} dependents ${prodTest} - risk: ${riskLevel}`);
   }
 }
 function buildDependentsResponse(analysis, args, riskLevel, indexInfo, notes, crossRepo, vectorDB) {
@@ -9964,46 +9970,51 @@ function buildDependentsResponse(analysis, args, riskLevel, indexInfo, notes, cr
   if (notes.length > 0) {
     response.note = notes.join(" ");
   }
-  if (crossRepo && vectorDB instanceof QdrantDB3) {
+  if (crossRepo && vectorDB.supportsCrossRepo) {
     response.groupedByRepo = groupDependentsByRepo(analysis.dependents, analysis.allChunks);
   }
   return response;
 }
 async function handleGetDependents(args, ctx) {
   const { vectorDB, log, checkAndReconnect, getIndexMetadata } = ctx;
-  return await wrapToolHandler(
-    GetDependentsSchema,
-    async (validatedArgs) => {
-      const { crossRepo, filepath, symbol } = validatedArgs;
-      const symbolSuffix = symbol ? ` (symbol: ${symbol})` : "";
-      const crossRepoSuffix = crossRepo ? " (cross-repo)" : "";
-      log(`Finding dependents of: ${filepath}${symbolSuffix}${crossRepoSuffix}`);
-      await checkAndReconnect();
-      const analysis = await findDependents(vectorDB, filepath, crossRepo ?? false, log, symbol);
-      const riskLevel = calculateRiskLevel(
-        analysis.dependents.length,
-        analysis.complexityMetrics.complexityRiskBoost,
-        analysis.productionDependentCount
-      );
-      logRiskAssessment(analysis, riskLevel, symbol, log);
-      const crossRepoFallback = checkCrossRepoFallback(crossRepo, vectorDB);
-      const notes = buildNotes(crossRepoFallback, analysis.hitLimit);
-      return buildDependentsResponse(
-        analysis,
-        validatedArgs,
-        riskLevel,
-        getIndexMetadata(),
-        notes,
-        crossRepo,
-        vectorDB
-      );
-    }
-  )(args);
+  return await wrapToolHandler(GetDependentsSchema, async (validatedArgs) => {
+    const { crossRepo, filepath, symbol } = validatedArgs;
+    const symbolSuffix = symbol ? ` (symbol: ${symbol})` : "";
+    const crossRepoSuffix = crossRepo ? " (cross-repo)" : "";
+    log(`Finding dependents of: ${filepath}${symbolSuffix}${crossRepoSuffix}`);
+    await checkAndReconnect();
+    const indexInfo = getIndexMetadata();
+    const analysis = await findDependents(
+      vectorDB,
+      filepath,
+      crossRepo ?? false,
+      log,
+      symbol,
+      indexInfo.indexVersion
+    );
+    const riskLevel = calculateRiskLevel(
+      analysis.dependents.length,
+      analysis.complexityMetrics.complexityRiskBoost,
+      analysis.productionDependentCount
+    );
+    logRiskAssessment(analysis, riskLevel, symbol, log);
+    const crossRepoFallback = checkCrossRepoFallback(crossRepo, vectorDB);
+    const notes = buildNotes(crossRepoFallback, analysis.hitLimit);
+    return buildDependentsResponse(
+      analysis,
+      validatedArgs,
+      riskLevel,
+      indexInfo,
+      notes,
+      crossRepo,
+      vectorDB
+    );
+  })(args);
 }
 
 // src/mcp/handlers/get-complexity.ts
 var import_collect = __toESM(require_dist(), 1);
-import { ComplexityAnalyzer, QdrantDB as QdrantDB4 } from "@liendev/core";
+import { ComplexityAnalyzer } from "@liendev/core";
 function transformViolation(v, fileData) {
   return {
     filepath: v.filepath,
@@ -10042,7 +10053,7 @@ async function fetchCrossRepoChunks(vectorDB, crossRepo, repoIds, log) {
   if (!crossRepo) {
     return { chunks: [], fallback: false };
   }
-  if (vectorDB instanceof QdrantDB4) {
+  if (vectorDB.supportsCrossRepo) {
     const chunks = await vectorDB.scanCrossRepo({ limit: 1e5, repoIds });
     log(`Scanned ${chunks.length} chunks across repos`);
     return { chunks, fallback: false };
@@ -10051,7 +10062,11 @@ async function fetchCrossRepoChunks(vectorDB, crossRepo, repoIds, log) {
 }
 function processViolations(report, threshold, top) {
   const allViolations = (0, import_collect.default)(Object.entries(report.files)).flatMap(
-    ([, fileData]) => fileData.violations.map((v) => transformViolation(v, fileData))
+    ([
+      ,
+      /* filepath unused */
+      fileData
+    ]) => fileData.violations.map((v) => transformViolation(v, fileData))
   ).sortByDesc("complexity").all();
   const violations = threshold !== void 0 ? allViolations.filter((v) => v.complexity >= threshold) : allViolations;
   const severityCounts = (0, import_collect.default)(violations).countBy("severity").all();
@@ -10065,61 +10080,61 @@ function processViolations(report, threshold, top) {
   };
 }
 function buildCrossRepoFallbackNote(fallback) {
-  return fallback ? "Cross-repo analysis requires Qdrant backend. Fell back to single-repo analysis." : void 0;
+  return fallback ? "Cross-repo analysis requires a cross-repo-capable backend. Fell back to single-repo analysis." : void 0;
 }
 async function handleGetComplexity(args, ctx) {
   const { vectorDB, log, checkAndReconnect, getIndexMetadata } = ctx;
-  return await wrapToolHandler(
-    GetComplexitySchema,
-    async (validatedArgs) => {
-      const { crossRepo, repoIds, files, top, threshold } = validatedArgs;
-      log(`Analyzing complexity${crossRepo ? " (cross-repo)" : ""}...`);
-      await checkAndReconnect();
-      const { chunks: allChunks, fallback } = await fetchCrossRepoChunks(
-        vectorDB,
-        crossRepo,
-        repoIds,
-        log
-      );
-      const analyzer = new ComplexityAnalyzer(vectorDB);
-      const report = await analyzer.analyze(files, crossRepo && !fallback, repoIds);
-      log(`Analyzed ${report.summary.filesAnalyzed} files`);
-      const { violations, topViolations, bySeverity } = processViolations(
-        report,
-        threshold,
-        top ?? 10
+  return await wrapToolHandler(GetComplexitySchema, async (validatedArgs) => {
+    const { crossRepo, repoIds, files, top, threshold } = validatedArgs;
+    log(`Analyzing complexity${crossRepo ? " (cross-repo)" : ""}...`);
+    await checkAndReconnect();
+    const { chunks: allChunks, fallback } = await fetchCrossRepoChunks(
+      vectorDB,
+      crossRepo,
+      repoIds,
+      log
+    );
+    const analyzer = new ComplexityAnalyzer(vectorDB);
+    const report = await analyzer.analyze(files, crossRepo && !fallback, repoIds);
+    log(`Analyzed ${report.summary.filesAnalyzed} files`);
+    const { violations, topViolations, bySeverity } = processViolations(
+      report,
+      threshold,
+      top ?? 10
+    );
+    const note = buildCrossRepoFallbackNote(fallback);
+    if (note) {
+      log(
+        "Warning: crossRepo=true requires a cross-repo-capable backend. Falling back to single-repo analysis.",
+        "warning"
       );
-      const note = buildCrossRepoFallbackNote(fallback);
-      if (note) {
-        log("Warning: crossRepo=true requires Qdrant backend. Falling back to single-repo analysis.", "warning");
-      }
-      return {
-        indexInfo: getIndexMetadata(),
-        summary: {
-          filesAnalyzed: report.summary.filesAnalyzed,
-          avgComplexity: report.summary.avgComplexity,
-          maxComplexity: report.summary.maxComplexity,
-          violationCount: violations.length,
-          bySeverity
-        },
-        violations: topViolations,
-        ...crossRepo && !fallback && allChunks.length > 0 && {
-          groupedByRepo: groupViolationsByRepo(topViolations, allChunks)
-        },
-        ...note && { note }
-      };
     }
-  )(args);
+    return {
+      indexInfo: getIndexMetadata(),
+      summary: {
+        filesAnalyzed: report.summary.filesAnalyzed,
+        avgComplexity: report.summary.avgComplexity,
+        maxComplexity: report.summary.maxComplexity,
+        violationCount: violations.length,
+        bySeverity
+      },
+      violations: topViolations,
+      ...crossRepo && !fallback && allChunks.length > 0 && {
+        groupedByRepo: groupViolationsByRepo(topViolations, allChunks)
+      },
+      ...note && { note }
+    };
+  })(args);
 }
 
 // src/mcp/handlers/index.ts
 var toolHandlers = {
-  "semantic_search": handleSemanticSearch,
-  "find_similar": handleFindSimilar,
-  "get_files_context": handleGetFilesContext,
-  "list_functions": handleListFunctions,
-  "get_dependents": handleGetDependents,
-  "get_complexity": handleGetComplexity
+  semantic_search: handleSemanticSearch,
+  find_similar: handleFindSimilar,
+  get_files_context: handleGetFilesContext,
+  list_functions: handleListFunctions,
+  get_dependents: handleGetDependents,
+  get_complexity: handleGetComplexity
 };
 
 // src/mcp/server-config.ts
@@ -10207,7 +10222,7 @@ function mergePendingFiles(pendingFiles, newFiles) {
   }
 }
 function createReindexStateManager() {
-  let state = {
+  const state = {
     inProgress: false,
     pendingFiles: [],
     lastReindexTimestamp: null,
@@ -10231,12 +10246,12 @@ function createReindexStateManager() {
     },
     /**
      * Start a new reindex operation.
-     * 
+     *
      * **Important**: Silently ignores empty or null file arrays without incrementing
      * activeOperations. This is intentional - if there's no work to do, no operation
      * is started. Callers should check for empty arrays before calling if they need
      * to track "attempted" operations.
-     * 
+     *
      * @param files - Array of file paths to reindex. Empty/null arrays are ignored.
      */
     startReindex: (files) => {
@@ -10250,10 +10265,10 @@ function createReindexStateManager() {
     },
     /**
      * Mark a reindex operation as complete.
-     * 
+     *
      * Logs a warning if called without a matching startReindex.
      * Only clears state when all concurrent operations finish.
-     * 
+     *
      * @param durationMs - Duration of the reindex operation in milliseconds
      */
     completeReindex: (durationMs) => {
@@ -10272,7 +10287,7 @@ function createReindexStateManager() {
     },
     /**
      * Mark a reindex operation as failed.
-     * 
+     *
      * Logs a warning if called without a matching startReindex.
      * Only clears state when all concurrent operations finish/fail.
      */
@@ -10290,13 +10305,13 @@ function createReindexStateManager() {
     },
     /**
      * Manually reset state if it's stuck.
-     * 
+     *
      * **WARNING**: Only use this if you're certain operations have crashed without cleanup.
      * This will forcibly clear the inProgress flag and reset activeOperations counter.
-     * 
+     *
      * Use this when getState() health check detects stuck state and you've verified
      * no legitimate operations are running.
-     * 
+     *
      * @returns true if state was reset, false if state was already clean
      */
     resetIfStuck: () => {
@@ -10333,7 +10348,7 @@ import {
   indexSingleFile,
   ManifestManager,
   computeContentHash,
-  normalizeToRelativePath,
+  normalizeToRelativePath as normalizeToRelativePath2,
   createGitignoreFilter
 } from "@liendev/core";
 async function handleFileDeletion(filepath, vectorDB, log) {
@@ -10368,7 +10383,7 @@ async function handleBatchDeletions(deletedFiles, vectorDB, log) {
 }
 async function canSkipReindex(filepath, rootDir, vectorDB, log) {
   const manifest = new ManifestManager(vectorDB.dbPath);
-  const normalizedPath = normalizeToRelativePath(filepath, rootDir);
+  const normalizedPath = normalizeToRelativePath2(filepath, rootDir);
   const manifestData = await manifest.load();
   const existingEntry = manifestData?.files[normalizedPath];
   const { shouldReindex, newMtime } = await shouldReindexFile(filepath, existingEntry, log);
@@ -10425,7 +10440,7 @@ async function shouldReindexFile(filepath, existingEntry, log) {
 async function checkFilesAgainstManifest(files, rootDir, manifestFiles, log) {
   const results = [];
   for (const filepath of files) {
-    const normalizedPath = normalizeToRelativePath(filepath, rootDir);
+    const normalizedPath = normalizeToRelativePath2(filepath, rootDir);
     const existingEntry = manifestFiles[normalizedPath];
     const { shouldReindex, newMtime } = await shouldReindexFile(filepath, existingEntry, log);
     results.push({ filepath, normalizedPath, shouldReindex, newMtime });
@@ -10452,7 +10467,12 @@ async function filterModifiedFilesByHash(modifiedFiles, rootDir, vectorDB, log)
   const manifest = new ManifestManager(vectorDB.dbPath);
   const manifestData = await manifest.load();
   if (!manifestData) return modifiedFiles;
-  const checkResults = await checkFilesAgainstManifest(modifiedFiles, rootDir, manifestData.files, log);
+  const checkResults = await checkFilesAgainstManifest(
+    modifiedFiles,
+    rootDir,
+    manifestData.files,
+    log
+  );
   await updateUnchangedMtimes(manifest, checkResults);
   return checkResults.filter((r) => r.shouldReindex).map((r) => r.filepath);
 }
@@ -10474,7 +10494,9 @@ async function executeReindexOperations(filesToIndex, deletedFiles, rootDir, vec
   const operations = [];
   if (filesToIndex.length > 0) {
     log(`\u{1F4C1} ${filesToIndex.length} file(s) changed, reindexing...`);
-    operations.push(indexMultipleFiles(filesToIndex, vectorDB, embeddings, { verbose: false, rootDir }));
+    operations.push(
+      indexMultipleFiles(filesToIndex, vectorDB, embeddings, { verbose: false, rootDir })
+    );
   }
   if (deletedFiles.length > 0) {
     operations.push(handleBatchDeletions(deletedFiles, vectorDB, log));
@@ -10482,7 +10504,12 @@ async function executeReindexOperations(filesToIndex, deletedFiles, rootDir, vec
   await Promise.all(operations);
 }
 async function handleBatchEvent(event, rootDir, vectorDB, embeddings, log, reindexStateManager) {
-  const { filesToIndex, deletedFiles } = await prepareFilesForReindexing(event, rootDir, vectorDB, log);
+  const { filesToIndex, deletedFiles } = await prepareFilesForReindexing(
+    event,
+    rootDir,
+    vectorDB,
+    log
+  );
   const allFiles = [...filesToIndex, ...deletedFiles];
   if (allFiles.length === 0) {
     return;
@@ -10493,7 +10520,9 @@ async function handleBatchEvent(event, rootDir, vectorDB, embeddings, log, reind
     await executeReindexOperations(filesToIndex, deletedFiles, rootDir, vectorDB, embeddings, log);
     const duration = Date.now() - startTime;
     reindexStateManager.completeReindex(duration);
-    log(`\u2713 Processed ${filesToIndex.length} file(s) + ${deletedFiles.length} deletion(s) in ${duration}ms`);
+    log(
+      `\u2713 Processed ${filesToIndex.length} file(s) + ${deletedFiles.length} deletion(s) in ${duration}ms`
+    );
   } catch (error) {
     reindexStateManager.failReindex();
     log(`Batch reindex failed: ${error}`, "warning");
@@ -10512,7 +10541,7 @@ async function handleUnlinkEvent(filepath, vectorDB, log, reindexStateManager) {
   }
 }
 function isFileIgnored(filepath, rootDir, isIgnored) {
-  return isIgnored(normalizeToRelativePath(filepath, rootDir));
+  return isIgnored(normalizeToRelativePath2(filepath, rootDir));
 }
 function filterFileChangeEvent(event, ignoreFilter, rootDir) {
   return {
@@ -10555,7 +10584,15 @@ function createFileChangeHandler(rootDir, vectorDB, embeddings, log, reindexStat
     } else {
       if (isFileIgnored(event.filepath, rootDir, ignoreFilter)) return;
       await checkAndReconnect();
-      await handleSingleFileChange(event.filepath, type, rootDir, vectorDB, embeddings, log, reindexStateManager);
+      await handleSingleFileChange(
+        event.filepath,
+        type,
+        rootDir,
+        vectorDB,
+        embeddings,
+        log,
+        reindexStateManager
+      );
     }
   };
 }
@@ -10576,7 +10613,9 @@ async function handleGitStartup(rootDir, gitTracker, vectorDB, embeddings, log,
     log(`\u{1F33F} Git changes detected: ${filteredFiles.length} files changed`);
     try {
       await checkAndReconnect();
-      const count = await indexMultipleFiles2(filteredFiles, vectorDB, embeddings, { verbose: false });
+      const count = await indexMultipleFiles2(filteredFiles, vectorDB, embeddings, {
+        verbose: false
+      });
       const duration = Date.now() - startTime;
       reindexStateManager.completeReindex(duration);
       log(`\u2713 Reindexed ${count} files in ${duration}ms`);
@@ -10618,7 +10657,9 @@ function createGitPollInterval(rootDir, gitTracker, vectorDB, embeddings, log, r
         log(`\u{1F33F} Git change detected: ${filteredFiles.length} files changed`);
         try {
           await checkAndReconnect();
-          const count = await indexMultipleFiles2(filteredFiles, vectorDB, embeddings, { verbose: false });
+          const count = await indexMultipleFiles2(filteredFiles, vectorDB, embeddings, {
+            verbose: false
+          });
           const duration = Date.now() - startTime;
           reindexStateManager.completeReindex(duration);
           log(`\u2713 Background reindex complete: ${count} files in ${duration}ms`);
@@ -10684,7 +10725,13 @@ function createGitChangeHandler(rootDir, gitTracker, vectorDB, embeddings, log,
   let lastGitReindexTime = 0;
   const GIT_REINDEX_COOLDOWN_MS = 5e3;
   return async () => {
-    if (shouldSkipGitReindex(gitReindexInProgress, lastGitReindexTime, GIT_REINDEX_COOLDOWN_MS, reindexStateManager, log)) {
+    if (shouldSkipGitReindex(
+      gitReindexInProgress,
+      lastGitReindexTime,
+      GIT_REINDEX_COOLDOWN_MS,
+      reindexStateManager,
+      log
+    )) {
       return;
     }
     gitReindexInProgress = true;
@@ -10699,7 +10746,14 @@ function createGitChangeHandler(rootDir, gitTracker, vectorDB, embeddings, log,
         log
       );
       if (!filteredFiles) return;
-      await executeGitReindex(filteredFiles, vectorDB, embeddings, reindexStateManager, checkAndReconnect, log);
+      await executeGitReindex(
+        filteredFiles,
+        vectorDB,
+        embeddings,
+        reindexStateManager,
+        checkAndReconnect,
+        log
+      );
       lastGitReindexTime = Date.now();
     } catch (error) {
       log(`Git change handler failed: ${error}`, "warning");
@@ -10722,7 +10776,15 @@ async function setupGitDetection(rootDir, vectorDB, embeddings, log, reindexStat
   log("\u2713 Detected git repository");
   const gitTracker = new GitStateTracker(rootDir, vectorDB.dbPath);
   try {
-    await handleGitStartup(rootDir, gitTracker, vectorDB, embeddings, log, reindexStateManager, checkAndReconnect);
+    await handleGitStartup(
+      rootDir,
+      gitTracker,
+      vectorDB,
+      embeddings,
+      log,
+      reindexStateManager,
+      checkAndReconnect
+    );
   } catch (error) {
     log(`Failed to check git state on startup: ${error}`, "warning");
   }
@@ -10742,7 +10804,15 @@ async function setupGitDetection(rootDir, vectorDB, embeddings, log, reindexStat
   }
   const pollIntervalSeconds = DEFAULT_GIT_POLL_INTERVAL_MS2 / 1e3;
   log(`\u2713 Git detection enabled (polling fallback every ${pollIntervalSeconds}s)`);
-  const gitPollInterval = createGitPollInterval(rootDir, gitTracker, vectorDB, embeddings, log, reindexStateManager, checkAndReconnect);
+  const gitPollInterval = createGitPollInterval(
+    rootDir,
+    gitTracker,
+    vectorDB,
+    embeddings,
+    log,
+    reindexStateManager,
+    checkAndReconnect
+  );
   return { gitTracker, gitPollInterval };
 }
 async function filterGitChangedFiles(changedFiles, rootDir, ignoreFilter) {
@@ -10765,7 +10835,10 @@ async function filterGitChangedFiles(changedFiles, rootDir, ignoreFilter) {
 
 // src/mcp/cleanup.ts
 function setupCleanupHandlers(server, versionCheckInterval, gitPollInterval, fileWatcher, log) {
+  let cleaningUp = false;
   return async () => {
+    if (cleaningUp) return;
+    cleaningUp = true;
     try {
       log("Shutting down MCP server...");
       await server.close();
@@ -10796,7 +10869,9 @@ async function initializeDatabase(rootDir, log) {
     throw new Error("createVectorDB returned undefined or null");
   }
   if (typeof vectorDB.initialize !== "function") {
-    throw new Error(`Invalid vectorDB instance: ${vectorDB.constructor?.name || "unknown"}. Expected VectorDBInterface but got: ${JSON.stringify(Object.keys(vectorDB))}`);
+    throw new Error(
+      `Invalid vectorDB instance: ${vectorDB.constructor?.name || "unknown"}. Expected VectorDBInterface but got: ${JSON.stringify(Object.keys(vectorDB))}`
+    );
   }
   log("Loading embedding model...");
   await embeddings.initialize();
@@ -10828,7 +10903,14 @@ async function setupFileWatching(watch, rootDir, vectorDB, embeddings, log, rein
   log("\u{1F440} Starting file watcher...");
   const fileWatcher = new FileWatcher(rootDir);
   try {
-    const handler = createFileChangeHandler(rootDir, vectorDB, embeddings, log, reindexStateManager, checkAndReconnect);
+    const handler = createFileChangeHandler(
+      rootDir,
+      vectorDB,
+      embeddings,
+      log,
+      reindexStateManager,
+      checkAndReconnect
+    );
     await fileWatcher.start(handler);
     log(`\u2713 File watching enabled (watching ${fileWatcher.getWatchedFiles().length} files)`);
     return fileWatcher;
@@ -10915,9 +10997,31 @@ async function setupAndConnectServer(server, toolContext, log, versionCheckInter
   const { vectorDB, embeddings } = toolContext;
   registerMCPHandlers(server, toolContext, log);
   await handleAutoIndexing(vectorDB, rootDir, log);
-  const fileWatcher = await setupFileWatching(watch, rootDir, vectorDB, embeddings, log, reindexStateManager, toolContext.checkAndReconnect);
-  const { gitPollInterval } = await setupGitDetection(rootDir, vectorDB, embeddings, log, reindexStateManager, fileWatcher, toolContext.checkAndReconnect);
-  const cleanup = setupCleanupHandlers(server, versionCheckInterval, gitPollInterval, fileWatcher, log);
+  const fileWatcher = await setupFileWatching(
+    watch,
+    rootDir,
+    vectorDB,
+    embeddings,
+    log,
+    reindexStateManager,
+    toolContext.checkAndReconnect
+  );
+  const { gitPollInterval } = await setupGitDetection(
+    rootDir,
+    vectorDB,
+    embeddings,
+    log,
+    reindexStateManager,
+    fileWatcher,
+    toolContext.checkAndReconnect
+  );
+  const cleanup = setupCleanupHandlers(
+    server,
+    versionCheckInterval,
+    gitPollInterval,
+    fileWatcher,
+    log
+  );
   process.on("SIGINT", cleanup);
   process.on("SIGTERM", cleanup);
   const transport = setupTransport(log);
@@ -10940,7 +11044,11 @@ async function startMCPServer(options) {
   const server = createMCPServer();
   const log = createMCPLog(server, verbose);
   const reindexStateManager = createReindexStateManager();
-  const { interval: versionCheckInterval, checkAndReconnect, getIndexMetadata } = setupVersionChecking(vectorDB, log, reindexStateManager);
+  const {
+    interval: versionCheckInterval,
+    checkAndReconnect,
+    getIndexMetadata
+  } = setupVersionChecking(vectorDB, log, reindexStateManager);
   const toolContext = {
     vectorDB,
     embeddings,
@@ -10950,10 +11058,14 @@ async function startMCPServer(options) {
     getIndexMetadata,
     getReindexState: () => reindexStateManager.getState()
   };
-  await setupAndConnectServer(server, toolContext, log, versionCheckInterval, reindexStateManager, { rootDir, watch });
+  await setupAndConnectServer(server, toolContext, log, versionCheckInterval, reindexStateManager, {
+    rootDir,
+    watch
+  });
 }
 
 // src/cli/serve.ts
+init_banner();
 async function serveCommand(options) {
   const rootDir = options.root ? path4.resolve(options.root) : process.cwd();
   try {
@@ -10961,30 +11073,30 @@ async function serveCommand(options) {
       try {
         const stats = await fs5.stat(rootDir);
         if (!stats.isDirectory()) {
-          console.error(chalk5.red(`Error: --root path is not a directory: ${rootDir}`));
+          console.error(chalk6.red(`Error: --root path is not a directory: ${rootDir}`));
           process.exit(1);
         }
       } catch (error) {
         if (error.code === "ENOENT") {
-          console.error(chalk5.red(`Error: --root directory does not exist: ${rootDir}`));
+          console.error(chalk6.red(`Error: --root directory does not exist: ${rootDir}`));
         } else if (error.code === "EACCES") {
-          console.error(chalk5.red(`Error: --root directory is not accessible: ${rootDir}`));
+          console.error(chalk6.red(`Error: --root directory is not accessible: ${rootDir}`));
         } else {
-          console.error(chalk5.red(`Error: Failed to access --root directory: ${rootDir}`));
-          console.error(chalk5.dim(error.message));
+          console.error(chalk6.red(`Error: Failed to access --root directory: ${rootDir}`));
+          console.error(chalk6.dim(error.message));
         }
         process.exit(1);
       }
     }
     showBanner();
-    console.error(chalk5.bold("Starting MCP server...\n"));
+    console.error(chalk6.bold("Starting MCP server...\n"));
     if (options.root) {
-      console.error(chalk5.dim(`Serving from: ${rootDir}
+      console.error(chalk6.dim(`Serving from: ${rootDir}
 `));
     }
     if (options.watch) {
-      console.error(chalk5.yellow("\u26A0\uFE0F  --watch flag is deprecated (file watching is now default)"));
-      console.error(chalk5.dim("    Use --no-watch to disable file watching\n"));
+      console.error(chalk6.yellow("\u26A0\uFE0F  --watch flag is deprecated (file watching is now default)"));
+      console.error(chalk6.dim("    Use --no-watch to disable file watching\n"));
     }
     const watch = options.noWatch ? false : options.watch ? true : void 0;
     await startMCPServer({
@@ -10993,13 +11105,13 @@ async function serveCommand(options) {
       watch
     });
   } catch (error) {
-    console.error(chalk5.red("Failed to start MCP server:"), error);
+    console.error(chalk6.red("Failed to start MCP server:"), error);
     process.exit(1);
   }
 }
 
 // src/cli/complexity.ts
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import fs6 from "fs";
 import path5 from "path";
 import { VectorDB } from "@liendev/core";
@@ -11009,13 +11121,17 @@ var VALID_FAIL_ON = ["error", "warning"];
 var VALID_FORMATS = ["text", "json", "sarif"];
 function validateFailOn(failOn) {
   if (failOn && !VALID_FAIL_ON.includes(failOn)) {
-    console.error(chalk6.red(`Error: Invalid --fail-on value "${failOn}". Must be either 'error' or 'warning'`));
+    console.error(
+      chalk7.red(`Error: Invalid --fail-on value "${failOn}". Must be either 'error' or 'warning'`)
+    );
     process.exit(1);
   }
 }
 function validateFormat(format) {
   if (!VALID_FORMATS.includes(format)) {
-    console.error(chalk6.red(`Error: Invalid --format value "${format}". Must be one of: text, json, sarif`));
+    console.error(
+      chalk7.red(`Error: Invalid --format value "${format}". Must be one of: text, json, sarif`)
+    );
     process.exit(1);
   }
 }
@@ -11026,8 +11142,8 @@ function validateFilesExist(files, rootDir) {
     return !fs6.existsSync(fullPath);
   });
   if (missingFiles.length > 0) {
-    console.error(chalk6.red(`Error: File${missingFiles.length > 1 ? "s" : ""} not found:`));
-    missingFiles.forEach((file) => console.error(chalk6.red(`  - ${file}`)));
+    console.error(chalk7.red(`Error: File${missingFiles.length > 1 ? "s" : ""} not found:`));
+    missingFiles.forEach((file) => console.error(chalk7.red(`  - ${file}`)));
     process.exit(1);
   }
 }
@@ -11035,8 +11151,12 @@ async function ensureIndexExists(vectorDB) {
   try {
     await vectorDB.scanWithFilter({ limit: 1 });
   } catch {
-    console.error(chalk6.red("Error: Index not found"));
-    console.log(chalk6.yellow("\nRun"), chalk6.bold("lien index"), chalk6.yellow("to index your codebase first"));
+    console.error(chalk7.red("Error: Index not found"));
+    console.log(
+      chalk7.yellow("\nRun"),
+      chalk7.bold("lien index"),
+      chalk7.yellow("to index your codebase first")
+    );
     process.exit(1);
   }
 }
@@ -11046,10 +11166,6 @@ async function complexityCommand(options) {
     validateFailOn(options.failOn);
     validateFormat(options.format);
     validateFilesExist(options.files, rootDir);
-    if (options.threshold || options.cyclomaticThreshold || options.cognitiveThreshold) {
-      console.warn(chalk6.yellow("Warning: Threshold overrides via CLI flags are not supported."));
-      console.warn(chalk6.yellow("Use the MCP tool with threshold parameter for custom thresholds."));
-    }
     const vectorDB = new VectorDB(rootDir);
     await vectorDB.initialize();
     await ensureIndexExists(vectorDB);
@@ -11061,22 +11177,19 @@ async function complexityCommand(options) {
       if (hasViolations) process.exit(1);
     }
   } catch (error) {
-    console.error(chalk6.red("Error analyzing complexity:"), error);
+    console.error(chalk7.red("Error analyzing complexity:"), error);
     process.exit(1);
   }
 }
 
 // src/cli/config.ts
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 import path6 from "path";
 import os2 from "os";
-import {
-  loadGlobalConfig,
-  mergeGlobalConfig
-} from "@liendev/core";
+import { loadGlobalConfig, mergeGlobalConfig } from "@liendev/core";
 var CONFIG_PATH = path6.join(os2.homedir(), ".lien", "config.json");
 var ALLOWED_KEYS = {
-  "backend": {
+  backend: {
     values: ["lancedb", "qdrant"],
     description: "Vector database backend"
   },
@@ -11113,50 +11226,50 @@ function buildPartialConfig(key, value) {
 async function configSetCommand(key, value) {
   const allowed = ALLOWED_KEYS[key];
   if (!allowed) {
-    console.error(chalk7.red(`Unknown config key: "${key}"`));
-    console.log(chalk7.dim("Valid keys:"), Object.keys(ALLOWED_KEYS).join(", "));
+    console.error(chalk8.red(`Unknown config key: "${key}"`));
+    console.log(chalk8.dim("Valid keys:"), Object.keys(ALLOWED_KEYS).join(", "));
     process.exit(1);
   }
   if (allowed.values.length > 0 && !allowed.values.includes(value)) {
-    console.error(chalk7.red(`Invalid value "${value}" for ${key}`));
-    console.log(chalk7.dim("Valid values:"), allowed.values.join(", "));
+    console.error(chalk8.red(`Invalid value "${value}" for ${key}`));
+    console.log(chalk8.dim("Valid values:"), allowed.values.join(", "));
     process.exit(1);
   }
   if (key === "qdrant.apiKey") {
     const existing = await loadGlobalConfig();
     if (!existing.qdrant?.url) {
-      console.error(chalk7.red("Set qdrant.url first before setting qdrant.apiKey"));
+      console.error(chalk8.red("Set qdrant.url first before setting qdrant.apiKey"));
       process.exit(1);
     }
   }
   const partial = buildPartialConfig(key, value);
   await mergeGlobalConfig(partial);
-  console.log(chalk7.green(`Set ${key} = ${value}`));
-  console.log(chalk7.dim(`Config: ${CONFIG_PATH}`));
+  console.log(chalk8.green(`Set ${key} = ${value}`));
+  console.log(chalk8.dim(`Config: ${CONFIG_PATH}`));
 }
 async function configGetCommand(key) {
   if (!ALLOWED_KEYS[key]) {
-    console.error(chalk7.red(`Unknown config key: "${key}"`));
-    console.log(chalk7.dim("Valid keys:"), Object.keys(ALLOWED_KEYS).join(", "));
+    console.error(chalk8.red(`Unknown config key: "${key}"`));
+    console.log(chalk8.dim("Valid keys:"), Object.keys(ALLOWED_KEYS).join(", "));
     process.exit(1);
   }
   const config = await loadGlobalConfig();
   const value = getConfigValue(config, key);
   if (value === void 0) {
-    console.log(chalk7.dim(`${key}: (not set)`));
+    console.log(chalk8.dim(`${key}: (not set)`));
   } else {
     console.log(`${key}: ${value}`);
   }
 }
 async function configListCommand() {
   const config = await loadGlobalConfig();
-  console.log(chalk7.bold("Global Configuration"));
-  console.log(chalk7.dim(`File: ${CONFIG_PATH}
+  console.log(chalk8.bold("Global Configuration"));
+  console.log(chalk8.dim(`File: ${CONFIG_PATH}
 `));
   for (const [key, meta] of Object.entries(ALLOWED_KEYS)) {
     const value = getConfigValue(config, key);
-    const display = value ?? chalk7.dim("(not set)");
-    console.log(`  ${chalk7.cyan(key)}: ${display}  ${chalk7.dim(`\u2014 ${meta.description}`)}`);
+    const display = value ?? chalk8.dim("(not set)");
+    console.log(`  ${chalk8.cyan(key)}: ${display}  ${chalk8.dim(`\u2014 ${meta.description}`)}`);
   }
 }
 
@@ -11173,14 +11286,18 @@ try {
 var program = new Command();
 program.name("lien").description("Local semantic code search for AI assistants via MCP").version(packageJson3.version);
 program.command("init").description("Initialize Lien in the current directory").option("-u, --upgrade", "Upgrade existing config with new options").option("-y, --yes", "Skip interactive prompts and use defaults").option("-p, --path <path>", "Path to initialize (defaults to current directory)").action(initCommand);
-program.command("index").description("Index the codebase for semantic search").option("-f, --force", "Force full reindex (skip incremental)").option("-w, --watch", "Watch for changes and re-index automatically").option("-v, --verbose", "Show detailed logging during indexing").action(indexCommand);
-program.command("serve").description("Start the MCP server for Cursor integration").option("-p, --port <port>", "Port number (for future use)", "7133").option("--no-watch", "Disable file watching for this session").option("-w, --watch", "[DEPRECATED] File watching is now enabled by default").option("-r, --root <path>", "Root directory to serve (defaults to current directory)").action(serveCommand);
+program.command("index").description("Index the codebase for semantic search").option("-f, --force", "Force full reindex (skip incremental)").option("-v, --verbose", "Show detailed logging during indexing").action(indexCommand);
+program.command("serve").description(
+  "Start the MCP server (works with Cursor, Claude Code, Windsurf, and any MCP client)"
+).option("-p, --port <port>", "Port number (for future use)", "7133").option("--no-watch", "Disable file watching for this session").option("-w, --watch", "[DEPRECATED] File watching is now enabled by default").option("-r, --root <path>", "Root directory to serve (defaults to current directory)").action(serveCommand);
 program.command("status").description("Show indexing status and statistics").action(statusCommand);
-program.command("complexity").description("Analyze code complexity").option("--files <paths...>", "Specific files to analyze").option("--format <type>", "Output format: text, json, sarif", "text").option("--threshold <n>", "Override both complexity thresholds (cyclomatic & cognitive)").option("--cyclomatic-threshold <n>", "Override cyclomatic complexity threshold only").option("--cognitive-threshold <n>", "Override cognitive complexity threshold only").option("--fail-on <severity>", "Exit 1 if violations: error, warning").action(complexityCommand);
+program.command("complexity").description("Analyze code complexity").option("--files <paths...>", "Specific files to analyze").option("--format <type>", "Output format: text, json, sarif", "text").option("--fail-on <severity>", "Exit 1 if violations: error, warning").action(complexityCommand);
 var configCmd = program.command("config").description("Manage global configuration (~/.lien/config.json)");
 configCmd.command("set <key> <value>").description("Set a global config value").action(configSetCommand);
 configCmd.command("get <key>").description("Get a config value").action(configGetCommand);
 configCmd.command("list").description("Show all current config").action(configListCommand);
+program.addHelpText("beforeAll", `Quick start: run 'lien serve' in your project directory
+`);
 
 // src/index.ts
 program.parse();