dep-context-mcp 1.0.0

package/README.md

@@ -0,0 +1,380 @@
+# Dependency Context MCP Server
+
+An MCP (Model Context Protocol) server that provides AI coding assistants with context about project dependencies by reading directly from `node_modules`. Solves the "dependency blindness" problem with zero network calls and no external service dependencies.
+
+## The Problem
+
+AI coding assistants don't know what's in your `node_modules`. When you ask "how do I use zod for validation?", they either hallucinate outdated APIs or give generic advice. This MCP server gives them full visibility into your actual installed dependencies.
+
+## Features
+
+- **Local-First Architecture**: Reads dependency metadata and types directly from `node_modules`
+- **Type Extraction**: Parses `.d.ts` files using TypeScript compiler API to extract full public APIs
+- **Semantic Search** (optional): Natural language search across all your dependencies using vector embeddings
+- **Caching**: Generates compact API snapshots, cached locally and invalidated by version changes
+- **Handles Complex Packages**: Follows re-exports, import-then-export patterns, and bundled/minified `.d.ts` files
+
+## Quick Start
+
+No installation needed - MCP clients run it via `npx`:
+
+1. Add to your MCP client config (see [Configuration](#mcp-client-configuration))
+2. Point `cwd` to your project directory
+3. Ask your AI about your dependencies
+
+```json
+{
+  "mcpServers": {
+    "dep-context": {
+      "command": "npx",
+      "args": ["dep-context-mcp"],
+      "cwd": "/path/to/your/project"
+    }
+  }
+}
+```
+
+Then just ask:
+
+> "Show me the API for lodash"
+> "How do I use fast-check for property testing?"
+> "Search for functions that handle debouncing"
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_dependency_context` | Get full API context for an installed dependency |
+| `list_dependencies` | List all dependencies with cache status |
+| `refresh_dependency` | Force regeneration of a dependency snapshot |
+| `search_dependencies` | Text-based search by name/description |
+| `search_codebase` | **Semantic search** across dependency APIs (auto-indexes on first use) |
+| `get_index_status` | Check vector index status |
+| `get_package_relationships` | Analyse package dependencies and relationships |
+
+## Semantic Search (Optional)
+
+The basic tools work out of the box. For semantic search ("find functions that delay execution"), you need:
+
+### Option 1: Ollama (Recommended - Free & Local)
+
+1. Install [Ollama](https://ollama.ai)
+2. Pull the embedding model:
+   ```bash
+   ollama pull nomic-embed-text
+   ```
+3. Enable in config:
+   ```json
+   {
+     "vectorSearch": {
+       "enabled": true
+     }
+   }
+   ```
+
+This uses file-based storage by default - fine for small/medium projects (<50 packages). The entire index is rewritten on each update, so indexing many packages will be slow.
+
+### Option 2: Ollama + ChromaDB (Better Performance)
+
+For larger projects, add ChromaDB for faster vector search and incremental updates.
+
+**Docker (recommended):**
+```bash
+# Start ChromaDB container
+docker run -d --name chromadb -p 8000:8000 chromadb/chroma
+
+# Verify it's running
+curl http://localhost:8000/api/v2/heartbeat
+```
+
+**Docker Compose:**
+```yaml
+services:
+  chromadb:
+    image: chromadb/chroma
+    ports:
+      - "8000:8000"
+    volumes:
+      - chromadb_data:/chroma/chroma
+volumes:
+  chromadb_data:
+```
+
+**Without Docker (pip):**
+```bash
+pip install chromadb
+chroma run --host localhost --port 8000
+```
+
+The MCP auto-detects ChromaDB on localhost:8000. No config changes needed - just start ChromaDB and reconnect the MCP.
+
+To verify ChromaDB is being used, check the MCP logs for:
+```
+[dep-context] Using ChromaDB at http://localhost:8000
+```
+
+### Option 3: OpenAI Embeddings
+
+If you prefer OpenAI:
+
+```json
+{
+  "vector": {
+    "enabled": true,
+    "embedding": {
+      "provider": "openai",
+      "openai": {
+        "apiKey": "${OPENAI_API_KEY}"
+      }
+    }
+  }
+}
+```
+
+The `${OPENAI_API_KEY}` syntax references an environment variable - safe to commit to source control. Set the actual key in your environment or shell profile.
+
+Alternatively, set the key directly (don't commit this):
+```json
+"apiKey": "sk-your-actual-key"
+```
+
+## Configuration
+
+Create `dep-context.config.json` in your project root (all fields optional):
+
+```json
+{
+  "projectRoot": ".",
+  "nodeModulesPath": "./node_modules",
+  "cacheDir": "./.cache/dep-context",
+  
+  "extraction": {
+    "includeReadme": true,
+    "includeJsDoc": true,
+    "includeExamples": true,
+    "maxReadmeLength": 5000,
+    "maxExamples": 10
+  },
+  
+  "vectorSearch": {
+    "enabled": false,
+    "embedding": {
+      "provider": "ollama",
+      "ollama": {
+        "baseUrl": "http://localhost:11434",
+        "model": "nomic-embed-text"
+      },
+      "openai": {
+        "apiKey": "${OPENAI_API_KEY}",
+        "model": "text-embedding-3-small"
+      }
+    },
+    "storage": {
+      "type": "auto",
+      "chromaHost": "http://localhost:8000"
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Purpose |
+|----------|---------|
+| `OPENAI_API_KEY` | OpenAI API key (when using OpenAI embeddings) |
+
+Use `${VAR_NAME}` syntax in config to reference environment variables.
+
+Variables can be set via:
+- `.env` file in your project root (recommended - add to `.gitignore`)
+- Shell environment / profile
+- MCP client `env` config
+
+Example `.env`:
+```
+OPENAI_API_KEY=sk-your-key-here
+```
+
+## MCP Client Configuration
+
+**Important:** This server needs to know which project to analyse. Specify the project path via `cwd` in your config.
+
+### Kiro
+
+> **Why workspace-level config?**
+> 
+> MCP configs can live in two places:
+> - **User-level** (`~/.kiro/settings/mcp.json`) — shared across all projects
+> - **Workspace-level** (`.kiro/settings/mcp.json` in your project) — project-specific
+> 
+> Since `cwd` must point to each project's root directory, configure this MCP at the **workspace level**. This way each project automatically uses its own `node_modules`.
+
+Create `.kiro/settings/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "dep-context": {
+      "command": "npx",
+      "args": ["dep-context-mcp"],
+      "cwd": "/path/to/your/project",
+      "disabled": false,
+      "autoApprove": [
+        "list_dependencies", 
+        "get_dependency_context", 
+        "refresh_dependency", 
+        "search_dependencies",
+        "search_codebase",
+        "get_index_status",
+        "get_package_relationships"
+      ]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "dep-context": {
+      "command": "npx",
+      "args": ["dep-context-mcp"],
+      "cwd": "/path/to/your/project"
+    }
+  }
+}
+```
+
+## How to Use
+
+Once configured, just ask your AI assistant naturally:
+
+### Basic queries (always work)
+> "Show me the API for lodash"
+> "What functions does axios export?"
+> "List all my dependencies"
+
+### Semantic search (requires Ollama or OpenAI)
+> "Find functions that handle rate limiting"
+> "Search for validation utilities"
+> "What can I use for debouncing?"
+
+### Package relationships
+> "What does axios depend on?"
+> "Which packages depend on lodash?"
+
+## What You Get
+
+When you ask about a dependency, the AI receives a comprehensive snapshot:
+
+```markdown
+# lodash v4.17.21
+
+A modern JavaScript utility library delivering modularity, performance & extras.
+
+## Functions
+
+### debounce
+function debounce<T extends (...args: any) => any>(
+  func: T,
+  wait?: number,
+  options?: DebounceSettings
+): DebouncedFunc<T>
+
+Creates a debounced function that delays invoking func...
+
+### chunk
+function chunk<T>(array: ArrayLike<T>, size?: number): T[][]
+
+Creates an array of elements split into groups the length of size.
+
+[... all exported functions, classes, interfaces, types ...]
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Licence
+
+MIT
+
+[... hundreds more functions, all with signatures and docs]
+```
+
+## Configuration
+
+Create a `config.json` in your project root (optional - sensible defaults are used):
+
+```json
+{
+  "projectRoot": ".",
+  "nodeModulesPath": "./node_modules",
+  "cacheDir": "./.cache/dep-context",
+  "extraction": {
+    "includeReadme": true,
+    "includeJsDoc": true,
+    "maxReadmeLength": 5000
+  }
+}
+```
+
+## How It Works
+
+1. **Package Resolution**: Locates packages in `node_modules`, handling hoisted and nested structures
+2. **Type Extraction**: Uses TypeScript compiler API to parse `.d.ts` files and extract all exports
+3. **Re-export Following**: Follows `export * from` and `export { x } from` patterns recursively
+4. **Snapshot Generation**: Creates AI-optimised markdown with all API information
+5. **Caching**: Stores snapshots locally, keyed by package name and version
+6. **MCP Integration**: Exposes tools via Model Context Protocol for AI assistants
+
+## Tips for Better AI Integration
+
+The AI won't automatically know to check your dependencies before implementing code. You can guide it with a steering file.
+
+### Kiro Steering Example
+
+Create `.kiro/steering/dependencies.md`:
+
+```markdown
+---
+inclusion: always
+---
+
+# Dependency Awareness
+
+Before implementing features, check what libraries are available:
+
+1. Use `list_dependencies` to see installed packages
+2. Use `search_codebase` to find relevant functions (e.g., "validation", "date formatting")
+3. Use `get_dependency_context` to get full API details for specific packages
+
+Prefer using existing dependencies over adding new ones or writing from scratch.
+```
+
+This tells the AI to proactively check your dependencies when coding.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+```
+
+## Licence
+
+MIT

package/dist/analysis/relationships.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Package relationship analysis
+ */
+import type { PackageResolverLike } from '../tools/get-dependency.js';
+export interface PackageRelationships {
+    dependsOn: string[];
+    dependedBy: string[];
+    similarTo: Array<{
+        name: string;
+        score: number;
+    }>;
+}
+export interface RelationshipAnalyzerDeps {
+    resolver: PackageResolverLike;
+    listDependencies: () => Promise<Array<{
+        name: string;
+        version: string;
+        dependencies?: Record<string, string>;
+    }>>;
+}
+export interface RelationshipAnalyzer {
+    analyze(packageName: string): Promise<PackageRelationships>;
+}
+export declare function createRelationshipAnalyzer(deps: RelationshipAnalyzerDeps): RelationshipAnalyzer;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/analysis/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../src/analysis/relationships.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAErE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,gBAAgB,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC,CAAA;CACjH;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAC5D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,oBAAoB,CA0B/F"}

package/dist/analysis/relationships.js

@@ -0,0 +1,26 @@
+/**
+ * Package relationship analysis
+ */
+export function createRelationshipAnalyzer(deps) {
+    async function analyze(packageName) {
+        const allDeps = await deps.listDependencies();
+        // Get what this package depends on
+        const resolved = await deps.resolver.resolve(packageName);
+        const dependsOn = resolved.success && resolved.metadata
+            ? Object.keys(resolved.metadata.dependencies || {})
+            : [];
+        // Find packages that depend on this one
+        const dependedBy = [];
+        for (const dep of allDeps) {
+            if (dep.dependencies && dep.dependencies[packageName]) {
+                dependedBy.push(dep.name);
+            }
+        }
+        // Similar packages would require vector search - return empty for now
+        // Will be populated when vector search is enabled
+        const similarTo = [];
+        return { dependsOn, dependedBy, similarTo };
+    }
+    return { analyze };
+}
+//# sourceMappingURL=relationships.js.map

package/dist/analysis/relationships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.js","sourceRoot":"","sources":["../../src/analysis/relationships.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,MAAM,UAAU,0BAA0B,CAAC,IAA8B;IACvE,KAAK,UAAU,OAAO,CAAC,WAAmB;QACxC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;QAE7C,mCAAmC;QACnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QACzD,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ;YACrD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC;YACnD,CAAC,CAAC,EAAE,CAAA;QAEN,wCAAwC;QACxC,MAAM,UAAU,GAAa,EAAE,CAAA;QAC/B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;gBACtD,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,sEAAsE;QACtE,kDAAkD;QAClD,MAAM,SAAS,GAA2C,EAAE,CAAA;QAE5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAA;IAC7C,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAA;AACpB,CAAC"}

package/dist/build-info.d.ts

@@ -0,0 +1,15 @@
+export declare const BUILD_INFO: {
+    readonly version: "1.0.0";
+    readonly name: "dep-context-mcp";
+    readonly description: "MCP server providing AI coding assistants with dependency context from node_modules";
+    readonly author: "Johnny Jarecsni";
+    readonly license: "MIT";
+    readonly buildTimestamp: "2026-01-21T23:38:18.430Z";
+    readonly gitCommit: "85687be";
+    readonly gitBranch: "main";
+    readonly nodeVersion: "v22.17.0";
+    readonly platform: "darwin";
+    readonly arch: "arm64";
+};
+export declare const COPYRIGHT_NOTICE: string;
+//# sourceMappingURL=build-info.d.ts.map

package/dist/build-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.d.ts","sourceRoot":"","sources":["../src/build-info.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AAEX,eAAO,MAAM,gBAAgB,QAO5B,CAAC"}

package/dist/build-info.js

@@ -0,0 +1,24 @@
+// This file is auto-generated during build
+// Do not edit manually - regenerated on each build
+export const BUILD_INFO = {
+    "version": "1.0.0",
+    "name": "dep-context-mcp",
+    "description": "MCP server providing AI coding assistants with dependency context from node_modules",
+    "author": "Johnny Jarecsni",
+    "license": "MIT",
+    "buildTimestamp": "2026-01-21T23:38:18.430Z",
+    "gitCommit": "85687be",
+    "gitBranch": "main",
+    "nodeVersion": "v22.17.0",
+    "platform": "darwin",
+    "arch": "arm64"
+};
+export const COPYRIGHT_NOTICE = `dep-context-mcp v${BUILD_INFO.version}
+Copyright (c) 2026 Johnny Jarecsni
+Licensed under the MIT License.
+
+Built on ${BUILD_INFO.buildTimestamp} from commit ${BUILD_INFO.gitCommit} (${BUILD_INFO.gitBranch})
+
+For more information, visit: https://github.com/jarecsni/dep-context-mcp
+`;
+//# sourceMappingURL=build-info.js.map

package/dist/build-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../src/build-info.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,mDAAmD;AAEnD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,OAAO;IAClB,MAAM,EAAE,iBAAiB;IACzB,aAAa,EAAE,qFAAqF;IACpG,QAAQ,EAAE,iBAAiB;IAC3B,SAAS,EAAE,KAAK;IAChB,gBAAgB,EAAE,0BAA0B;IAC5C,WAAW,EAAE,SAAS;IACtB,WAAW,EAAE,MAAM;IACnB,aAAa,EAAE,UAAU;IACzB,UAAU,EAAE,QAAQ;IACpB,MAAM,EAAE,OAAO;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,UAAU,CAAC,OAAO;;;;WAI3D,UAAU,CAAC,cAAc,gBAAgB,UAAU,CAAC,SAAS,KAAK,UAAU,CAAC,SAAS;;;CAGhG,CAAC"}

package/dist/cache/manager.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cache manager - handles persistent storage of snapshots
+ */
+import type { Snapshot } from '../extraction/snapshot.js';
+import { type CacheRegistry, type CacheEntry } from './registry.js';
+export type { CacheRegistry, CacheEntry };
+export interface CacheManager {
+    get(packageName: string, version: string): Promise<Snapshot | undefined>;
+    set(snapshot: Snapshot): Promise<void>;
+    invalidate(packageName: string): Promise<void>;
+    invalidateAll(): Promise<void>;
+    getRegistry(): Promise<CacheRegistry>;
+    has(packageName: string, version: string): Promise<boolean>;
+}
+/**
+ * Creates a CacheManager instance
+ */
+export declare function createCacheManager(cacheDir: string): CacheManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/cache/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/cache/manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAQL,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,eAAe,CAAA;AAEtB,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,CAAA;AAEzC,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAA;IACxE,GAAG,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;IACrC,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5D;AAiBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAmIjE"}

package/dist/cache/manager.js

@@ -0,0 +1,131 @@
+/**
+ * Cache manager - handles persistent storage of snapshots
+ */
+import { readFile, writeFile, unlink, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { loadRegistry, saveRegistry, addEntry, removeEntry, getEntry, hasValidEntry, createEmptyRegistry } from './registry.js';
+/**
+ * Converts a package name to a safe filename
+ * @scope/package -> @scope__package
+ */
+function toSafeFilename(packageName) {
+    return packageName.replace(/\//g, '__');
+}
+/**
+ * Gets the snapshot filename for a package
+ */
+function getSnapshotFilename(packageName, version) {
+    return `${toSafeFilename(packageName)}@${version}.md`;
+}
+/**
+ * Creates a CacheManager instance
+ */
+export function createCacheManager(cacheDir) {
+    const snapshotsDir = join(cacheDir, 'snapshots');
+    // In-memory registry cache
+    let registryCache;
+    async function ensureRegistry() {
+        if (!registryCache) {
+            registryCache = await loadRegistry(cacheDir);
+        }
+        return registryCache;
+    }
+    async function persistRegistry() {
+        if (registryCache) {
+            await saveRegistry(cacheDir, registryCache);
+        }
+    }
+    return {
+        async get(packageName, version) {
+            const registry = await ensureRegistry();
+            // Check if we have a valid entry for this version
+            if (!hasValidEntry(registry, packageName, version)) {
+                return undefined;
+            }
+            const entry = getEntry(registry, packageName);
+            const snapshotPath = join(cacheDir, entry.snapshotPath);
+            // Check if file exists
+            if (!existsSync(snapshotPath)) {
+                // File missing - remove from registry
+                registryCache = removeEntry(registry, packageName);
+                await persistRegistry();
+                return undefined;
+            }
+            try {
+                const content = await readFile(snapshotPath, 'utf-8');
+                return {
+                    packageName: entry.packageName,
+                    version: entry.version,
+                    generatedAt: entry.generatedAt,
+                    content,
+                    checksum: entry.checksum
+                };
+            }
+            catch {
+                // Read error - remove from registry
+                registryCache = removeEntry(registry, packageName);
+                await persistRegistry();
+                return undefined;
+            }
+        },
+        async set(snapshot) {
+            // Ensure snapshots directory exists
+            await mkdir(snapshotsDir, { recursive: true });
+            const filename = getSnapshotFilename(snapshot.packageName, snapshot.version);
+            const snapshotPath = join(snapshotsDir, filename);
+            const relativePath = `snapshots/${filename}`;
+            // Write snapshot file
+            await writeFile(snapshotPath, snapshot.content, 'utf-8');
+            // Update registry
+            const registry = await ensureRegistry();
+            registryCache = addEntry(registry, snapshot.packageName, snapshot.version, relativePath, snapshot.generatedAt, snapshot.checksum);
+            await persistRegistry();
+        },
+        async invalidate(packageName) {
+            const registry = await ensureRegistry();
+            const entry = getEntry(registry, packageName);
+            if (entry) {
+                // Delete snapshot file
+                const snapshotPath = join(cacheDir, entry.snapshotPath);
+                if (existsSync(snapshotPath)) {
+                    try {
+                        await unlink(snapshotPath);
+                    }
+                    catch {
+                        // Ignore deletion errors
+                    }
+                }
+                // Remove from registry
+                registryCache = removeEntry(registry, packageName);
+                await persistRegistry();
+            }
+        },
+        async invalidateAll() {
+            const registry = await ensureRegistry();
+            // Delete all snapshot files
+            for (const entry of Object.values(registry.entries)) {
+                const snapshotPath = join(cacheDir, entry.snapshotPath);
+                if (existsSync(snapshotPath)) {
+                    try {
+                        await unlink(snapshotPath);
+                    }
+                    catch {
+                        // Ignore deletion errors
+                    }
+                }
+            }
+            // Reset registry
+            registryCache = createEmptyRegistry();
+            await persistRegistry();
+        },
+        async getRegistry() {
+            return ensureRegistry();
+        },
+        async has(packageName, version) {
+            const registry = await ensureRegistry();
+            return hasValidEntry(registry, packageName, version);
+        }
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/cache/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/cache/manager.ts"],"names":[],"mappings":"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"}