@milo4jo/contextkit 0.1.0 → 0.3.0

package/README.md

@@ -1,22 +1,46 @@
 # ContextKit 🎯
 
-> Smart context selection for AI coding assistants
+> **Stop dumping your entire codebase into AI prompts.**  
+> ContextKit selects the *right* context for any query — saving tokens and improving answers.
 
-ContextKit indexes your codebase and selects the most relevant chunks for any query — fitting them into your token budget.
+[![npm version](https://img.shields.io/npm/v/@milo4jo/contextkit)](https://www.npmjs.com/package/@milo4jo/contextkit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## Why?
+---
+
+## The Problem
 
-AI coding assistants work better with relevant context. But dumping your entire codebase into the prompt wastes tokens and dilutes focus.
+AI coding assistants are only as good as the context you give them. But:
 
-ContextKit solves this:
-1. **Index** your code locally (embeddings stay on your machine)
-2. **Query** with natural language
-3. **Get** the most relevant chunks, formatted and ready to paste
+- **Too much context** = expensive, slow, diluted focus
+- **Too little context** = hallucinations, wrong answers
+- **Manual selection** = tedious, doesn't scale
+
+**ContextKit fixes this.** It indexes your code and intelligently selects the most relevant chunks for any query.
+
+## How It Works
+
+```
+┌──────────────┐     ┌──────────────┐     ┌──────────────┐
+│  Your Code   │ ──▶ │   Index      │ ──▶ │   Select     │
+│  (files)     │     │  (local db)  │     │  (semantic)  │
+└──────────────┘     └──────────────┘     └──────────────┘
+                                                  │
+                                                  ▼
+                                          ┌──────────────┐
+                                          │  Optimized   │
+                                          │   Context    │
+                                          └──────────────┘
+```
+
+1. **Index** your codebase (embeddings stored locally)
+2. **Query** in natural language
+3. **Get** the most relevant code chunks, ready to paste
 
 ## Install
 
 ```bash
-npm install -g contextkit
+npm install -g @milo4jo/contextkit
 ```
 
 ## Quick Start
@@ -26,22 +50,64 @@ npm install -g contextkit
 cd your-project
 contextkit init
 
-# Add source directories
+# Add directories to index
 contextkit source add ./src
 contextkit source add ./lib
 
-# Index everything
+# Build the index
 contextkit index
 
-# Find relevant context
+# Find relevant context for any query
 contextkit select "How does authentication work?"
 ```
 
+**Output:**
+
+```markdown
+## src/auth/middleware.ts (lines 1-45)
+```typescript
+export const authMiddleware = async (req, res, next) => {
+  const token = req.headers.authorization?.split(' ')[1];
+  if (!token) return res.status(401).json({ error: 'No token' });
+  // ...
+}
+```
+
+## src/auth/utils.ts (lines 12-30)
+```typescript
+export function validateToken(token: string): User | null {
+  // ...
+}
+```
+
+---
+📊 2,847 tokens | 6 chunks | 2 files
+```
+
+## Why ContextKit?
+
+| Approach | Problem |
+|----------|---------|
+| **Dump everything** | Expensive, hits token limits, noisy |
+| **Basic RAG** | Returns "similar" not "relevant" |
+| **Manual selection** | Tedious, doesn't scale |
+| **ContextKit** | ✅ Intelligent, fast, local-first |
+
+### vs. LangChain / LlamaIndex
+
+Those are full frameworks. ContextKit does **one thing well**: context selection. No lock-in, no complexity.
+
+### vs. Vector Databases (Pinecone, Chroma)
+
+They're storage. ContextKit adds the **intelligence layer** — scoring, budgeting, formatting.
+
+---
+
 ## Commands
 
 ### `contextkit init`
 
-Initialize ContextKit in your project. Creates `.contextkit/` directory with config and database.
+Initialize ContextKit in your project. Creates `.contextkit/` directory.
 
 ```bash
 contextkit init
@@ -49,31 +115,35 @@ contextkit init
 
 ### `contextkit source`
 
-Manage source directories to index.
+Manage which directories to index.
 
 ```bash
-# Add a source
-contextkit source add ./src
-
-# List sources
-contextkit source list
-
-# Remove a source
-contextkit source remove src
+contextkit source add ./src        # Add a source
+contextkit source list             # List all sources
+contextkit source remove src       # Remove a source
 ```
 
 ### `contextkit index`
 
-Index all configured sources. Re-run after code changes.
+Build or rebuild the index. Uses incremental indexing by default (only re-indexes changed files).
 
 ```bash
-# Index everything
-contextkit index
+contextkit index                   # Incremental index (fast)
+contextkit index --force           # Full re-index
+contextkit index --source src      # Index specific source
+```
+
+### `contextkit watch`
 
-# Index specific source
-contextkit index --source src
+Watch sources and auto-reindex on changes.
+
+```bash
+contextkit watch                   # Watch with 1s debounce
+contextkit watch --debounce 2000   # Custom debounce (ms)
 ```
 
+Press `Ctrl+C` to stop watching.
+
 ### `contextkit select`
 
 Find relevant context for a query.
@@ -82,7 +152,7 @@ Find relevant context for a query.
 # Basic usage
 contextkit select "How does the auth middleware work?"
 
-# Limit token budget (default: 8000)
+# Set token budget (default: 8000)
 contextkit select "error handling" --budget 4000
 
 # Filter to specific sources
@@ -91,38 +161,77 @@ contextkit select "database queries" --sources src,lib
 # Show scoring details
 contextkit select "user validation" --explain
 
-# JSON output for scripts
+# JSON output (for scripts/integrations)
 contextkit select "API routes" --json
 ```
 
-## Output Format
+---
 
-```markdown
-## src/auth/middleware.ts (lines 1-45)
-```typescript
-export const authMiddleware = async (req, res, next) => {
-  // ... relevant code
-}
-```
+## 🤖 MCP Server (Claude Desktop Integration)
 
-## src/auth/utils.ts (lines 12-30)
-```typescript
-export function validateToken(token: string) {
-  // ... relevant code
+ContextKit includes an **MCP server** for seamless integration with Claude Desktop and other MCP-compatible AI assistants.
+
+### What is MCP?
+
+[Model Context Protocol](https://modelcontextprotocol.io/) is a standard for connecting AI assistants to external tools. With MCP, Claude can directly use ContextKit to find relevant code.
+
+### Setup for Claude Desktop
+
+**1. Find your config file:**
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+**2. Add ContextKit:**
+
+```json
+{
+  "mcpServers": {
+    "contextkit": {
+      "command": "contextkit-mcp",
+      "args": [],
+      "env": {
+        "CONTEXTKIT_PROJECT": "/path/to/your/project"
+      }
+    }
+  }
 }
 ```
 
----
-📊 3,847 tokens | 8 chunks | 2 files
-```
+**3. Restart Claude Desktop**
 
-## How It Works
+### Available Tools
+
+Once configured, Claude can use these tools:
+
+| Tool | Description |
+|------|-------------|
+| `contextkit_select` | Find relevant context for any query |
+| `contextkit_index` | Re-index the codebase |
+| `contextkit_status` | Check index status (files, chunks, etc.) |
+
+### Example Conversation
+
+> **You:** Find all code related to user authentication
+>
+> **Claude:** *[Uses contextkit_select]* I found the relevant code. Here's what handles authentication:
+> - `src/auth/middleware.ts` - The main auth middleware
+> - `src/auth/jwt.ts` - Token validation
+> - ...
 
-1. **Chunking**: Files are split into ~500 token chunks with overlap
-2. **Embedding**: Each chunk is embedded using [gte-small](https://huggingface.co/thenlper/gte-small) (runs locally)
-3. **Search**: Your query is embedded and compared via cosine similarity
-4. **Scoring**: Chunks are ranked by similarity + path relevance
-5. **Budget**: Top chunks are selected until token budget is filled
+### Manual Server Start
+
+For debugging or other MCP clients:
+
+```bash
+# Start the MCP server
+contextkit mcp
+
+# With a specific project
+CONTEXTKIT_PROJECT=/path/to/project contextkit mcp
+```
+
+---
 
 ## Configuration
 
@@ -138,44 +247,100 @@ sources:
       include:
         - "**/*.ts"
         - "**/*.js"
+        - "**/*.tsx"
       exclude:
         - "**/node_modules/**"
         - "**/*.test.ts"
+        - "**/*.spec.ts"
 
 settings:
-  chunk_size: 500      # Target tokens per chunk
-  chunk_overlap: 50    # Overlap between chunks
+  chunk_size: 500        # Target tokens per chunk
+  chunk_overlap: 50      # Overlap between chunks
+  embedding_model: gte-small
 ```
 
-## Global Options
+---
+
+## Privacy & Security
+
+- ✅ **All processing is local** — nothing leaves your machine
+- ✅ **Embeddings stored locally** in `.contextkit/index.db`
+- ✅ **No API keys required** — uses local embedding model
+- ✅ **`.contextkit` is gitignored** automatically
 
-All commands support:
+---
 
-| Option | Description |
-|--------|-------------|
-| `--json` | Output as JSON |
-| `--plain` | No colors (or set `NO_COLOR=1`) |
-| `--quiet` | Suppress non-essential output |
+## Technical Details
 
-## Privacy
+### How Selection Works
 
-- All processing happens locally
-- Embeddings are stored in `.contextkit/index.db`
-- No data leaves your machine
-- Add `.contextkit` to `.gitignore` (done automatically)
+1. **Chunking** — Files split into ~500 token chunks with overlap
+2. **Embedding** — Each chunk embedded with [gte-small](https://huggingface.co/thenlper/gte-small) (runs locally)
+3. **Similarity** — Query embedded and compared via cosine similarity
+4. **Scoring** — Chunks ranked by similarity + path relevance + recency
+5. **Budgeting** — Top chunks selected until token budget filled
 
-## Requirements
+### Requirements
 
 - Node.js 18+
-- ~500MB disk space for embedding model (downloaded on first run)
+- ~500MB disk space (embedding model downloaded on first run)
+
+---
 
-## Coming Soon
+## Try the Demo
 
-- MCP server for Claude Desktop
-- Agent skill for OpenCode/Clawdbot
-- Configurable embedding models
-- Incremental indexing
+Want to see ContextKit in action? Check out the [demo project](./examples/demo-project/):
+
+```bash
+cd examples/demo-project
+contextkit init
+contextkit source add ./src
+contextkit index
+contextkit select "How does authentication work?"
+```
+
+---
+
+## Roadmap
+
+- [x] CLI with init, source, index, select
+- [x] MCP server for Claude Desktop
+- [x] Demo project for testing
+- [x] Incremental indexing (only changed files)
+- [x] Watch mode (auto-reindex on save)
+- [x] Multi-factor scoring algorithm
+- [ ] VS Code extension
+- [ ] Cursor integration
+- [ ] Cloud sync (optional)
+
+---
+
+## Contributing
+
+Contributions welcome! Please read the [contributing guide](./CONTRIBUTING.md) first.
+
+```bash
+# Clone and setup
+git clone https://github.com/milo4jo/contextkit.git
+cd contextkit
+npm install
+npm run build
+
+# Run tests
+npm test
+
+# Link for local development
+npm link
+```
+
+---
 
 ## License
 
-MIT
+MIT © [Milo](https://github.com/milo4jo)
+
+---
+
+<p align="center">
+  Built with 🦊 by Milo
+</p>

package/dist/commands/index-cmd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,eAAO,MAAM,YAAY,SAiIrB,CAAC"}
+{"version":3,"file":"index-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,eAAO,MAAM,YAAY,SA0IrB,CAAC"}

package/dist/commands/index-cmd.js

@@ -10,6 +10,7 @@ import { SourceNotFoundError } from '../errors/index.js';
 export const indexCommand = new Command('index')
     .description('Index all sources')
     .option('-s, --source <name>', 'Index only a specific source')
+    .option('-f, --force', 'Force full re-index (ignore cached hashes)')
     .action(async (options) => {
     ensureInitialized();
     const config = loadConfig();
@@ -81,7 +82,7 @@ export const indexCommand = new Command('index')
         const stats = await indexSources(sourcesToIndex, process.cwd(), db, {
             chunkSize: config.settings.chunk_size,
             chunkOverlap: config.settings.chunk_overlap,
-        }, onProgress);
+        }, onProgress, { force: options.force });
         // Stop progress bar
         if (progressBar) {
             progressBar.stop();
@@ -90,7 +91,14 @@ export const indexCommand = new Command('index')
         if (!opts.quiet) {
             writeMessage('');
             const timeStr = (stats.timeMs / 1000).toFixed(1);
-            writeSuccess(`Indexed ${stats.chunks} chunks from ${stats.files} files in ${timeStr}s`);
+            // Show incremental stats
+            if (stats.filesUnchanged > 0 || stats.filesRemoved > 0) {
+                writeSuccess(`Indexed ${stats.chunks} chunks from ${stats.files} files in ${timeStr}s`);
+                writeMessage(formatDim(`  ${stats.filesChanged} changed, ${stats.filesUnchanged} unchanged, ${stats.filesRemoved} removed`));
+            }
+            else {
+                writeSuccess(`Indexed ${stats.chunks} chunks from ${stats.files} files in ${timeStr}s`);
+            }
             if (stats.skipped > 0) {
                 writeMessage(formatDim(`  (${stats.skipped} files skipped - too large or binary)`));
             }

package/dist/commands/index-cmd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-cmd.js","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,mBAAmB,CAAC;KAChC,MAAM,CAAC,qBAAqB,EAAE,8BAA8B,CAAC;KAC7D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,iBAAiB,EAAE,CAAC;IAEpB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAEzC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,YAAY,CAAC,uBAAuB,CAAC,CAAC;QACtC,YAAY,CAAC,0BAA0B,aAAa,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,uCAAuC;IACvC,IAAI,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,cAAc,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,gBAAgB;IAChB,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAE1B,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,YAAY,CAAC,qBAAqB,CAAC,CAAC;YACpC,YAAY,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QAED,wCAAwC;QACxC,IAAI,WAAW,GAAiC,IAAI,CAAC;QACrD,IAAI,aAAa,GAAG,EAAE,CAAC;QACvB,IAAI,YAAY,GAAG,EAAE,CAAC;QAEtB,IAAI,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,WAAW,GAAG,IAAI,WAAW,CAAC,SAAS,CACrC;gBACE,MAAM,EAAE,WAAW,eAAe,CAAC,YAAY,CAAC,wBAAwB;gBACxE,eAAe,EAAE,GAAG;gBACpB,iBAAiB,EAAE,GAAG;gBACtB,UAAU,EAAE,IAAI;aACjB,EACD,WAAW,CAAC,OAAO,CAAC,cAAc,CACnC,CAAC;QACJ,CAAC;QAED,oBAAoB;QACpB,MAAM,UAAU,GAAG,CAAC,QAAuB,EAAE,EAAE;YAC7C,MAAM,UAAU,GAAG;gBACjB,SAAS,EAAE,iBAAiB;gBAC5B,QAAQ,EAAE,iBAAiB;gBAC3B,SAAS,EAAE,iBAAiB;gBAC5B,OAAO,EAAE,iBAAiB;aAC3B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAElB,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,aAAa,KAAK,QAAQ,CAAC,QAAQ,IAAI,YAAY,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAC3E,IAAI,aAAa,EAAE,CAAC;wBAClB,WAAW,CAAC,IAAI,EAAE,CAAC;oBACrB,CAAC;oBACD,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC;oBAClC,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC;oBAC9B,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,EAAE;wBACxC,KAAK,EAAE,UAAU;wBACjB,MAAM,EAAE,QAAQ,CAAC,QAAQ;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBACD,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACvB,8BAA8B;gBAC9B,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACxC,YAAY,CACV,GAAG,UAAU,KAAK,QAAQ,CAAC,QAAQ,MAAM,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,CAC9E,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,eAAe;QACf,MAAM,KAAK,GAAG,MAAM,YAAY,CAC9B,cAAc,EACd,OAAO,CAAC,GAAG,EAAE,EACb,EAAE,EACF;YACE,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;YACrC,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;SAC5C,EACD,UAAU,CACX,CAAC;QAEF,oBAAoB;QACpB,IAAI,WAAW,EAAE,CAAC;YAChB,WAAW,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QAED,iBAAiB;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,YAAY,CAAC,EAAE,CAAC,CAAC;YACjB,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACjD,YAAY,CAAC,WAAW,KAAK,CAAC,MAAM,gBAAgB,KAAK,CAAC,KAAK,aAAa,OAAO,GAAG,CAAC,CAAC;YAExF,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;gBACtB,YAAY,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,OAAO,uCAAuC,CAAC,CAAC,CAAC;YACtF,CAAC;YACD,YAAY,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QAED,cAAc;QACd,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,SAAS,CACP,IAAI,CAAC,SAAS,CACZ;gBACE,MAAM,EAAE,SAAS;gBACjB,KAAK;aACN,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACJ,CAAC;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index-cmd.js","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"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"}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Command
+ *
+ * Start the Model Context Protocol server for AI assistant integration.
+ */
+import { Command } from "commander";
+export declare const mcpCommand: Command;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,UAAU,SAYnB,CAAC"}

package/dist/commands/mcp.js

@@ -0,0 +1,23 @@
+/**
+ * MCP Command
+ *
+ * Start the Model Context Protocol server for AI assistant integration.
+ */
+import { Command } from "commander";
+import { startMcpServer } from "../mcp/server.js";
+import { writeMessage, writeError } from "../utils/streams.js";
+export const mcpCommand = new Command("mcp")
+    .description("Start MCP server for AI assistant integration")
+    .option("--stdio", "Use stdio transport (default)")
+    .action(async () => {
+    try {
+        writeMessage("Starting ContextKit MCP server...");
+        await startMcpServer();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        writeError(`Failed to start MCP server: ${message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;KAClD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,YAAY,CAAC,mCAAmC,CAAC,CAAC;QAClD,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,UAAU,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/commands/watch.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Watch Command
+ *
+ * Watches source directories and auto-reindexes on changes.
+ */
+import { Command } from 'commander';
+export declare const watchCommand: Command;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,eAAO,MAAM,YAAY,SAiLrB,CAAC"}