mdcontext 0.1.0 → 0.2.0

package/dist/mcp/server.js

@@ -4,13 +4,17 @@ import {
   search,
   semanticSearch,
   summarizeFile
-} from "../chunk-VVTGZNBT.js";
+} from "../chunk-BNXWSZ63.js";
 import {
   buildIndex,
+  getIncomingLinks,
+  getOutgoingLinks,
   parseFile
-} from "../chunk-S7E6TFX6.js";
+} from "../chunk-MUJELQQ6.js";
+import "../chunk-7TOWB2XB.js";
 
 // src/mcp/server.ts
+import { createRequire } from "module";
 import * as path from "path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -19,6 +23,9 @@ import {
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { Effect } from "effect";
+var require2 = createRequire(import.meta.url);
+var packageJson = require2("../../package.json");
+var MCP_VERSION = packageJson.version;
 var tools = [
   {
     name: "md_search",
@@ -41,8 +48,8 @@ var tools = [
         },
         threshold: {
           type: "number",
-          description: "Minimum similarity threshold 0-1 (default: 0.5)",
-          default: 0.5
+          description: "Minimum similarity threshold 0-1 (default: 0.35)",
+          default: 0.35
         }
       },
       required: ["query"]
@@ -138,13 +145,41 @@ var tools = [
         }
       }
     }
+  },
+  {
+    name: "md_links",
+    description: "Get outgoing links from a markdown file. Shows what files this document references/links to.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Path to the markdown file"
+        }
+      },
+      required: ["path"]
+    }
+  },
+  {
+    name: "md_backlinks",
+    description: "Get incoming links to a markdown file. Shows what files reference/link to this document.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Path to the markdown file"
+        }
+      },
+      required: ["path"]
+    }
   }
 ];
 var handleMdSearch = async (args, rootPath) => {
   const query = args.query;
   const limit = args.limit ?? 5;
   const pathFilter = args.path_filter;
-  const threshold = args.threshold ?? 0.5;
+  const threshold = args.threshold ?? 0.35;
   const result = await Effect.runPromise(
     semanticSearch(rootPath, query, {
       limit,
@@ -206,7 +241,6 @@ var handleMdStructure = async (args, rootPath) => {
   const resolvedPath = path.isAbsolute(filePath) ? filePath : path.join(rootPath, filePath);
   const result = await Effect.runPromise(
     parseFile(resolvedPath).pipe(
-      Effect.mapError((e) => new Error(`${e._tag}: ${e.message}`)),
       Effect.catchAll((e) => Effect.succeed({ error: e.message }))
     )
   );
@@ -319,11 +353,69 @@ var handleMdIndex = async (args, rootPath) => {
     ]
   };
 };
+var handleMdLinks = async (args, rootPath) => {
+  const filePath = args.path;
+  const resolvedPath = path.isAbsolute(filePath) ? filePath : path.join(rootPath, filePath);
+  const result = await Effect.runPromise(
+    getOutgoingLinks(rootPath, resolvedPath).pipe(
+      Effect.catchAll((e) => Effect.succeed({ error: e.message }))
+    )
+  );
+  if ("error" in result) {
+    return {
+      content: [{ type: "text", text: `Error: ${result.error}` }],
+      isError: true
+    };
+  }
+  const links = result;
+  const relativePath = path.relative(rootPath, resolvedPath);
+  return {
+    content: [
+      {
+        type: "text",
+        text: links.length > 0 ? `Outgoing links from ${relativePath}:
+
+${links.map((l) => `  -> ${l}`).join("\n")}
+
+Total: ${links.length} links` : `No outgoing links from ${relativePath}`
+      }
+    ]
+  };
+};
+var handleMdBacklinks = async (args, rootPath) => {
+  const filePath = args.path;
+  const resolvedPath = path.isAbsolute(filePath) ? filePath : path.join(rootPath, filePath);
+  const result = await Effect.runPromise(
+    getIncomingLinks(rootPath, resolvedPath).pipe(
+      Effect.catchAll((e) => Effect.succeed({ error: e.message }))
+    )
+  );
+  if ("error" in result) {
+    return {
+      content: [{ type: "text", text: `Error: ${result.error}` }],
+      isError: true
+    };
+  }
+  const links = result;
+  const relativePath = path.relative(rootPath, resolvedPath);
+  return {
+    content: [
+      {
+        type: "text",
+        text: links.length > 0 ? `Incoming links to ${relativePath}:
+
+${links.map((l) => `  <- ${l}`).join("\n")}
+
+Total: ${links.length} backlinks` : `No incoming links to ${relativePath}`
+      }
+    ]
+  };
+};
 var createServer = (rootPath) => {
   const server = new Server(
     {
       name: "mdcontext-mcp",
-      version: "0.1.0"
+      version: MCP_VERSION
     },
     {
       capabilities: {
@@ -347,6 +439,10 @@ var createServer = (rootPath) => {
         return handleMdKeywordSearch(args ?? {}, rootPath);
       case "md_index":
         return handleMdIndex(args ?? {}, rootPath);
+      case "md_links":
+        return handleMdLinks(args ?? {}, rootPath);
+      case "md_backlinks":
+        return handleMdBacklinks(args ?? {}, rootPath);
       default:
         return {
           content: [{ type: "text", text: `Unknown tool: ${name}` }],

package/dist/schema-BAWSG7KY.js

@@ -0,0 +1,22 @@
+import {
+  AISummarizationConfig,
+  EmbeddingsConfig,
+  IndexConfig,
+  MdContextConfig,
+  OutputConfig,
+  PathsConfig,
+  SearchConfig,
+  SummarizationConfig,
+  defaultConfig
+} from "./chunk-7TOWB2XB.js";
+export {
+  AISummarizationConfig,
+  EmbeddingsConfig,
+  IndexConfig,
+  MdContextConfig,
+  OutputConfig,
+  PathsConfig,
+  SearchConfig,
+  SummarizationConfig,
+  defaultConfig
+};

package/dist/schema-E3QUPL26.js

@@ -0,0 +1,20 @@
+import {
+	defaultConfig,
+	EmbeddingsConfig,
+	IndexConfig,
+	MdContextConfig,
+	OutputConfig,
+	PathsConfig,
+	SearchConfig,
+	SummarizationConfig,
+} from "./chunk-LBSDNLEM.js";
+export {
+	EmbeddingsConfig,
+	IndexConfig,
+	MdContextConfig,
+	OutputConfig,
+	PathsConfig,
+	SearchConfig,
+	SummarizationConfig,
+	defaultConfig,
+};

package/dist/schema-EHL7WUT6.js

@@ -0,0 +1,20 @@
+import {
+	defaultConfig,
+	EmbeddingsConfig,
+	IndexConfig,
+	MdContextConfig,
+	OutputConfig,
+	PathsConfig,
+	SearchConfig,
+	SummarizationConfig,
+} from "./chunk-SJCDV2ST.js";
+export {
+	EmbeddingsConfig,
+	IndexConfig,
+	MdContextConfig,
+	OutputConfig,
+	PathsConfig,
+	SearchConfig,
+	SummarizationConfig,
+	defaultConfig,
+};

package/docs/019-USAGE.md

@@ -33,7 +33,9 @@ npx mdcontext --help
 **Requirements:**
 
 - Node.js 18+
-- OpenAI API key (for semantic search only)
+- Embedding provider for semantic search (see [CONFIG.md](./CONFIG.md) for options):
+  - OpenAI or OpenRouter (cloud, requires API key)
+  - Ollama or LM Studio (free, local, no API key needed)
 
 ---
 
@@ -51,8 +53,21 @@ mdcontext tree ./docs/README.md       # Document outline
 mdcontext context ./docs/README.md
 
 # 4. Enable semantic search (optional)
+# Choose ONE provider:
+
+# Option A: OpenAI (cloud, requires API key)
 export OPENAI_API_KEY=sk-...
 mdcontext index --embed
+
+# Option B: Ollama (free, local, no API key needed)
+ollama serve && ollama pull nomic-embed-text
+mdcontext index --embed --provider ollama --provider-model nomic-embed-text
+
+# Option C: LM Studio (free, local, no API key needed)
+# Start LM Studio, load an embedding model, then:
+mdcontext index --embed --provider lm-studio
+
+# Then search by meaning:
 mdcontext search "how to authenticate"
 ```
 
@@ -527,6 +542,20 @@ mdcontext context -t 1000 a.md b.md c.md
 
 ## Configuration
 
+mdcontext supports a layered configuration system with files, environment variables, and CLI flags.
+
+**Quick start:**
+
+```bash
+# Create a config file
+mdcontext config init
+
+# Check current configuration
+mdcontext config check
+```
+
+**For full configuration documentation, see [CONFIG.md](./CONFIG.md).**
+
 ### Index Directory
 
 By default, indexes are stored in `.mdcontext/` in your project root:
@@ -544,9 +573,13 @@ By default, indexes are stored in `.mdcontext/` in your project root:
 
 ### Environment Variables
 
-| Variable         | Required            | Description    |
-| ---------------- | ------------------- | -------------- |
-| `OPENAI_API_KEY` | For semantic search | OpenAI API key |
+| Variable             | Required                    | Description                          |
+| -------------------- | --------------------------- | ------------------------------------ |
+| `OPENAI_API_KEY`     | For OpenAI provider         | OpenAI API key (cloud provider)      |
+| `OPENROUTER_API_KEY` | For OpenRouter provider     | OpenRouter API key (cloud provider)  |
+| N/A                  | Ollama / LM Studio          | Local providers - no API key needed  |
+
+All configuration options can also be set via `MDCONTEXT_*` environment variables. See [CONFIG.md](./CONFIG.md#environment-variables) for the complete reference.
 
 ### Supported File Types
 
@@ -571,8 +604,14 @@ Run `mdcontext index` to build the index first.
 
 ### "Semantic search not available"
 
-1. Set `OPENAI_API_KEY` environment variable
+1. Set up an embedding provider:
+   - **OpenAI (cloud):** Set `OPENAI_API_KEY` environment variable
+   - **OpenRouter (cloud):** Set `OPENROUTER_API_KEY` environment variable
+   - **Ollama (free, local):** Run `ollama serve` (no API key needed)
+   - **LM Studio (free, local):** Start the server GUI (no API key needed)
 2. Run `mdcontext index --embed` to build embedding index
+   - For local providers: `mdcontext index --embed --provider ollama`
+3. See [CONFIG.md](./CONFIG.md) for detailed provider setup
 
 ### "File not found in index"
 

package/docs/020-current-implementation.md

@@ -104,7 +104,7 @@ interface VectorEntry {
 
 - HNSW stores cosine distance (1 - similarity)
 - Search returns `similarity = 1 - distance`
-- Results filtered by threshold (default: 0.45)
+- Results filtered by threshold (default: 0.35)
 
 ### 3. Semantic Search (`src/embeddings/semantic-search.ts`)
 
@@ -151,7 +151,7 @@ Document: {documentTitle}
   - If < 10 seconds: auto-create silently
   - Otherwise: prompt user for choice
 
-**Default Search Threshold**: 0.45 (raised from 0.3 to filter low-quality matches)
+**Default Search Threshold**: 0.35 (raised from 0.3 to filter low-quality matches)
 
 ## Data Flow
 
@@ -225,7 +225,7 @@ Document: {documentTitle}
                                ▼
 ┌─────────────────────────────────────────────────────────────────────────┐
 │ 5. Post-Processing                                                       │
-│    - Filter by similarity threshold (default: 0.45)                      │
+│    - Filter by similarity threshold (default: 0.35)                      │
 │    - Filter by path pattern (if specified)                               │
 │    - Truncate to requested limit                                         │
 └──────────────────────────────┬──────────────────────────────────────────┘
@@ -249,11 +249,11 @@ Located in `.mdcontext/` directory:
 
 ## Current Limitations and Gaps
 
-### 1. Single Provider Lock-in
+### 1. ~~Single Provider Lock-in~~ RESOLVED (ALP-215)
 
-- **Issue**: Only OpenAI embeddings supported
-- **Impact**: Requires API key, incurs costs, no offline capability
-- **Code Location**: `openai-provider.ts` is the only provider implementation
+- **RESOLVED**: Multiple embedding providers now supported (OpenAI, Ollama, LM Studio, OpenRouter)
+- **Impact**: Users can choose local providers for offline capability and cost savings
+- **Code Location**: `provider-factory.ts` handles provider selection based on config
 
 ### 2. No Incremental Updates
 
@@ -347,7 +347,7 @@ efConstruction: 200                  // vector-store.ts
 
 // Search
 defaultLimit: 10                     // search.ts
-defaultThreshold: 0.45               // search.ts
+defaultThreshold: 0.35               // search.ts
 autoIndexThreshold: 10 seconds       // search.ts
 ```
 

package/docs/021-DOGFOODING-FINDINGS.md

@@ -67,7 +67,7 @@ mdcontext search "authentication" ./docs
 
 **Impact:** Major limitation for discovery. Users searching for concepts/keywords get no results if those words aren't in headings.
 
-**Note:** Full semantic search requires OpenAI API key + `--embed` flag, but structural search should at least search content.
+**Note:** Full semantic search requires an embedding provider (OpenAI, Ollama, LM Studio, or OpenRouter) + `--embed` flag. See [CONFIG.md](./CONFIG.md) for free local options. Structural search should at least search content.
 
 ---