@liendev/lien 0.24.0 → 0.25.0

package/README.md

@@ -4,7 +4,7 @@
 
 **Give AI deep understanding of your codebase through semantic search. 100% local, 100% private.**
 
-Lien connects AI coding assistants like Cursor to your codebase through the Model Context Protocol (MCP). Ask questions in natural language, get precise answers from semantic search—all running locally on your machine.
+Lien connects AI coding assistants like Cursor and Claude Code to your codebase through the Model Context Protocol (MCP). Ask questions in natural language, get precise answers from semantic search—all running locally on your machine.
 
 📚 **[Full Documentation](https://lien.dev)** | 🚀 **[Getting Started](https://lien.dev/guide/getting-started)** | 🔍 **[How It Works](https://lien.dev/how-it-works)**
 
@@ -15,7 +15,7 @@ Lien connects AI coding assistants like Cursor to your codebase through the Mode
 - 🔒 **100% Local & Private** - All code analysis happens on your machine
 - 🚀 **Semantic Search** - Natural language queries: "How does authentication work?"
 - 🌐 **Cross-Repo Search** - Search across all repositories in your organization (Qdrant backend)
-- 🎯 **MCP Integration** - Works seamlessly with Cursor and other MCP-compatible tools
+- 🎯 **MCP Integration** - Works seamlessly with Cursor, Claude Code, and other MCP-compatible tools
 - ⚡ **Fast** - Sub-500ms queries, minutes to index large codebases
 - 🆓 **Free Forever** - No API costs, no subscriptions, no usage limits
 - 📦 **Framework-Aware** - Auto-detects Node.js, Laravel, Shopify; supports 15+ languages
@@ -39,7 +39,7 @@ npm install -g @liendev/lien
   }
 }
 
-# 3. Restart Cursor and start asking questions!
+# 3. Restart your AI assistant (Cursor, Claude Code) and start asking questions!
 ```
 
 That's it—zero configuration needed. Lien auto-detects your project and indexes on first use.
@@ -99,7 +99,7 @@ Lien tracks code complexity with intuitive outputs:
 ## Documentation
 
 - **[Installation](https://lien.dev/guide/installation)** - npm, npx, or local setup
-- **[Getting Started](https://lien.dev/guide/getting-started)** - Step-by-step configuration for Cursor
+- **[Getting Started](https://lien.dev/guide/getting-started)** - Step-by-step configuration for Cursor or Claude Code
 - **[Configuration](https://lien.dev/guide/configuration)** - Customize indexing, thresholds, performance
 - **[CLI Commands](https://lien.dev/guide/cli-commands)** - Full command reference
 - **[MCP Tools](https://lien.dev/guide/mcp-tools)** - Complete API reference for all 6 tools

package/dist/index.js

@@ -8292,11 +8292,17 @@ var SemanticSearchSchema = external_exports.object({
 
 // src/mcp/schemas/similarity.schema.ts
 var FindSimilarSchema = external_exports.object({
-  code: external_exports.string().min(10, "Code snippet must be at least 10 characters").describe(
+  code: external_exports.string().min(24, "Code snippet must be at least 24 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(
+    "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(
+    "Filter by file path substring.\n\nOnly returns results where the file path contains this string (case-insensitive).\n\nExamples: 'src/api', 'components', 'utils'"
   )
 });
 
@@ -8378,7 +8384,13 @@ Results include a relevance category (highly_relevant, relevant, loosely_related
 - Finding duplicate implementations
 - Refactoring similar patterns together
 
-Provide at least 10 characters of code to match against. Results include a relevance category for each match.`
+Provide at least 24 characters of code to match against. Results include a relevance category for each match.
+
+Optional filters:
+- language: Filter by programming language (e.g., "typescript", "python")
+- pathHint: Filter by file path substring (e.g., "src/api", "components")
+
+Low-relevance results (not_relevant) are automatically pruned.`
   ),
   toMCPToolSchema(
     GetFilesContextSchema,
@@ -8576,6 +8588,19 @@ async function handleSemanticSearch(args, ctx) {
 }
 
 // src/mcp/handlers/find-similar.ts
+function applyLanguageFilter(results, language) {
+  const lang = language.toLowerCase();
+  return results.filter((r) => r.metadata.language?.toLowerCase() === lang);
+}
+function applyPathHintFilter(results, pathHint) {
+  const hint = pathHint.toLowerCase();
+  return results.filter((r) => (r.metadata.file?.toLowerCase() ?? "").includes(hint));
+}
+function pruneIrrelevantResults(results) {
+  const beforePrune = results.length;
+  const filtered = results.filter((r) => r.relevance !== "not_relevant");
+  return { filtered, prunedCount: beforePrune - filtered.length };
+}
 async function handleFindSimilar(args, ctx) {
   const { vectorDB, embeddings, log, checkAndReconnect, getIndexMetadata } = ctx;
   return await wrapToolHandler(
@@ -8584,11 +8609,27 @@ async function handleFindSimilar(args, ctx) {
       log(`Finding similar code...`);
       await checkAndReconnect();
       const codeEmbedding = await embeddings.embed(validatedArgs.code);
-      const results = await vectorDB.search(codeEmbedding, validatedArgs.limit, validatedArgs.code);
-      log(`Found ${results.length} similar chunks`);
+      const limit = validatedArgs.limit ?? 5;
+      const extraLimit = limit + 10;
+      let results = await vectorDB.search(codeEmbedding, extraLimit, validatedArgs.code);
+      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
+        results: finalResults,
+        ...hasFilters && { filtersApplied }
       };
     }
   )(args);