driftdetect-mcp 0.4.0 → 0.4.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Geoffrey Fernald
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin/server.d.ts

@@ -3,8 +3,10 @@
  * Drift MCP Server Entry Point
  *
  * Usage:
- *   drift-mcp                    # Run in current directory
- *   drift-mcp /path/to/project   # Run for specific project
+ *   drift-mcp                       # Run server in current directory
+ *   drift-mcp /path/to/project      # Run for specific project
+ *   drift-mcp --no-cache            # Disable response caching
+ *   drift-mcp --no-rate-limit       # Disable rate limiting
  *
  * MCP Config (add to mcp.json):
  * {
@@ -15,6 +17,14 @@
  *     }
  *   }
  * }
+ *
+ * Features:
+ * - DataLake as central source of truth (pre-computed views, sharded storage)
+ * - Layered tool architecture (orchestration → discovery → exploration → detail)
+ * - Intent-aware context synthesis via drift_context
+ * - Token budget awareness and cursor-based pagination
+ * - Structured error handling with recovery hints
+ * - Response caching, rate limiting, and metrics
  */
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/bin/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/bin/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/bin/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG"}

package/dist/bin/server.js

@@ -3,8 +3,10 @@
  * Drift MCP Server Entry Point
  *
  * Usage:
- *   drift-mcp                    # Run in current directory
- *   drift-mcp /path/to/project   # Run for specific project
+ *   drift-mcp                       # Run server in current directory
+ *   drift-mcp /path/to/project      # Run for specific project
+ *   drift-mcp --no-cache            # Disable response caching
+ *   drift-mcp --no-rate-limit       # Disable rate limiting
  *
  * MCP Config (add to mcp.json):
  * {
@@ -15,12 +17,30 @@
  *     }
  *   }
  * }
+ *
+ * Features:
+ * - DataLake as central source of truth (pre-computed views, sharded storage)
+ * - Layered tool architecture (orchestration → discovery → exploration → detail)
+ * - Intent-aware context synthesis via drift_context
+ * - Token budget awareness and cursor-based pagination
+ * - Structured error handling with recovery hints
+ * - Response caching, rate limiting, and metrics
  */
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { createDriftMCPServer } from '../server.js';
+import { createEnterpriseMCPServer } from '../enterprise-server.js';
 async function main() {
-    const projectRoot = process.argv[2] ?? process.cwd();
-    const server = createDriftMCPServer({ projectRoot });
+    const args = process.argv.slice(2);
+    // Parse flags
+    const noCache = args.includes('--no-cache');
+    const noRateLimit = args.includes('--no-rate-limit');
+    // Get project root (first non-flag argument, or cwd)
+    const projectRoot = args.find(arg => !arg.startsWith('--')) ?? process.cwd();
+    const server = createEnterpriseMCPServer({
+        projectRoot,
+        enableCache: !noCache,
+        enableRateLimiting: !noRateLimit,
+        enableMetrics: true,
+    });
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // Handle graceful shutdown

package/dist/bin/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/bin/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAErD,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/bin/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,cAAc;IACd,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAErD,qDAAqD;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAE7E,MAAM,MAAM,GAAG,yBAAyB,CAAC;QACvC,WAAW;QACX,WAAW,EAAE,CAAC,OAAO;QACrB,kBAAkB,EAAE,CAAC,WAAW;QAChC,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/enterprise-server.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Enterprise Drift MCP Server
+ *
+ * Layered tool architecture following Block's pattern:
+ * - Discovery: Lightweight status and capability tools
+ * - Exploration: Paginated listing tools
+ * - Detail: Focused single-item tools
+ *
+ * Features:
+ * - Token budget awareness
+ * - Cursor-based pagination
+ * - Structured error handling with recovery hints
+ * - Response caching
+ * - Rate limiting
+ * - Metrics collection
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export interface EnterpriseMCPConfig {
+    projectRoot: string;
+    enableCache?: boolean;
+    enableRateLimiting?: boolean;
+    enableMetrics?: boolean;
+    maxRequestsPerMinute?: number;
+}
+export declare function createEnterpriseMCPServer(config: EnterpriseMCPConfig): Server;
+/**
+ * Get tool categories for documentation
+ */
+export declare function getToolCategories(): {
+    orchestration: string[];
+    discovery: string[];
+    exploration: string[];
+    detail: string[];
+};
+/**
+ * Get all tools
+ */
+export declare function getAllTools(): {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+}[];
+//# sourceMappingURL=enterprise-server.d.ts.map

package/dist/enterprise-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enterprise-server.d.ts","sourceRoot":"","sources":["../src/enterprise-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAkDnE,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAwF7E;AAgHD;;GAEG;AACH,wBAAgB,iBAAiB;;;;;EAEhC;AAED;;GAEG;AACH,wBAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE1B"}

package/dist/enterprise-server.js

@@ -0,0 +1,201 @@
+/**
+ * Enterprise Drift MCP Server
+ *
+ * Layered tool architecture following Block's pattern:
+ * - Discovery: Lightweight status and capability tools
+ * - Exploration: Paginated listing tools
+ * - Detail: Focused single-item tools
+ *
+ * Features:
+ * - Token budget awareness
+ * - Cursor-based pagination
+ * - Structured error handling with recovery hints
+ * - Response caching
+ * - Rate limiting
+ * - Metrics collection
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { PatternStore, ManifestStore, HistoryStore, DNAStore, BoundaryStore, ContractStore, CallGraphStore, createDataLake, } from 'driftdetect-core';
+// Infrastructure
+import { handleError, rateLimiter, metrics, createCache, } from './infrastructure/index.js';
+// Tool definitions
+import { ALL_TOOLS, TOOL_CATEGORIES } from './tools/registry.js';
+// Discovery handlers
+import { handleStatus } from './tools/discovery/status.js';
+import { handleCapabilities } from './tools/discovery/capabilities.js';
+// Exploration handlers
+import { handlePatternsList } from './tools/exploration/patterns-list.js';
+import { handleSecuritySummary } from './tools/exploration/security-summary.js';
+import { handleContractsList } from './tools/exploration/contracts-list.js';
+import { handleTrends } from './tools/exploration/trends.js';
+// Detail handlers
+import { handlePatternGet } from './tools/detail/pattern-get.js';
+import { handleCodeExamples } from './tools/detail/code-examples.js';
+import { handleFilesList } from './tools/detail/files-list.js';
+import { handleFilePatterns } from './tools/detail/file-patterns.js';
+import { handleImpactAnalysis } from './tools/detail/impact-analysis.js';
+import { handleReachability } from './tools/detail/reachability.js';
+import { handleDNAProfile } from './tools/detail/dna-profile.js';
+// Orchestration handlers
+import { handleContext } from './tools/orchestration/index.js';
+export function createEnterpriseMCPServer(config) {
+    const server = new Server({ name: 'drift-enterprise', version: '2.0.0' }, { capabilities: { tools: {} } });
+    // Initialize stores
+    const stores = {
+        pattern: new PatternStore({ rootDir: config.projectRoot }),
+        manifest: new ManifestStore(config.projectRoot),
+        history: new HistoryStore({ rootDir: config.projectRoot }),
+        dna: new DNAStore({ rootDir: config.projectRoot }),
+        boundary: new BoundaryStore({ rootDir: config.projectRoot }),
+        contract: new ContractStore({ rootDir: config.projectRoot }),
+        callGraph: new CallGraphStore({ rootDir: config.projectRoot }),
+    };
+    // Initialize data lake for optimized queries
+    const dataLake = createDataLake({ rootDir: config.projectRoot });
+    // Initialize cache if enabled
+    const cache = config.enableCache !== false
+        ? createCache(config.projectRoot)
+        : null;
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        metrics.increment('tools.list');
+        return { tools: ALL_TOOLS };
+    });
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args = {} } = request.params;
+        const startTime = Date.now();
+        try {
+            // Rate limiting
+            if (config.enableRateLimiting !== false) {
+                try {
+                    rateLimiter.checkLimit(name, 'default');
+                }
+                catch {
+                    metrics.increment('tools.rate_limited', { tool: name });
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: 'Rate limit exceeded',
+                                    hint: 'Wait a moment before making more requests',
+                                    retryAfter: 60,
+                                }),
+                            }],
+                        isError: true,
+                    };
+                }
+            }
+            // Check cache
+            const cacheKey = cache?.generateKey(name, args);
+            if (cache && cacheKey) {
+                const cached = await cache.get(cacheKey);
+                if (cached) {
+                    metrics.increment('tools.cache_hit', { tool: name });
+                    return cached.data;
+                }
+            }
+            // Route to handler
+            const result = await routeToolCall(name, args, stores, config.projectRoot, dataLake);
+            // Cache result
+            if (cache && cacheKey && result && !('isError' in result && result.isError)) {
+                await cache.set(cacheKey, result);
+            }
+            // Record metrics
+            metrics.increment('tools.call', { tool: name });
+            metrics.observe('tools.duration_ms', Date.now() - startTime, { tool: name });
+            return result;
+        }
+        catch (error) {
+            metrics.increment('tools.error', { tool: name });
+            return handleError(error);
+        }
+    });
+    return server;
+}
+async function routeToolCall(name, args, stores, projectRoot, dataLake) {
+    // ============================================================================
+    // Orchestration Tools (Meta Layer - Start Here)
+    // ============================================================================
+    switch (name) {
+        case 'drift_context':
+            return handleContext({
+                pattern: stores.pattern,
+                manifest: stores.manifest,
+                boundary: stores.boundary,
+                callGraph: stores.callGraph,
+                dna: stores.dna,
+            }, projectRoot, args);
+    }
+    // ============================================================================
+    // Discovery Tools (Layer 1)
+    // ============================================================================
+    switch (name) {
+        case 'drift_status':
+            return handleStatus(stores.pattern, args, dataLake);
+        case 'drift_capabilities':
+            return handleCapabilities(args);
+    }
+    // ============================================================================
+    // Exploration Tools (Layer 2)
+    // ============================================================================
+    switch (name) {
+        case 'drift_patterns_list':
+            return handlePatternsList(stores.pattern, args, dataLake);
+        case 'drift_security_summary':
+            return handleSecuritySummary(stores.boundary, args);
+        case 'drift_contracts_list':
+            return handleContractsList(stores.contract, args);
+        case 'drift_trends':
+            return handleTrends(stores.history, args);
+    }
+    // ============================================================================
+    // Detail Tools (Layer 3)
+    // ============================================================================
+    switch (name) {
+        // Pattern detail tools
+        case 'drift_pattern_get':
+            return handlePatternGet(stores.pattern, args);
+        case 'drift_code_examples':
+            return handleCodeExamples(stores.pattern, projectRoot, args);
+        // File detail tools
+        case 'drift_files_list':
+            return handleFilesList(stores.manifest, args);
+        case 'drift_file_patterns':
+            return handleFilePatterns(stores.manifest, args);
+        // Call graph analysis tools
+        case 'drift_impact_analysis':
+            return handleImpactAnalysis(projectRoot, args);
+        case 'drift_reachability':
+            return handleReachability(projectRoot, args);
+        // DNA tools
+        case 'drift_dna_profile':
+            return handleDNAProfile(stores.dna, args);
+    }
+    // Unknown tool
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    error: `Unknown tool: ${name}`,
+                    hint: 'Use drift_capabilities to see available tools',
+                    availableTools: TOOL_CATEGORIES,
+                }),
+            }],
+        isError: true,
+    };
+}
+/**
+ * Get tool categories for documentation
+ */
+export function getToolCategories() {
+    return TOOL_CATEGORIES;
+}
+/**
+ * Get all tools
+ */
+export function getAllTools() {
+    return ALL_TOOLS;
+}
+//# sourceMappingURL=enterprise-server.js.map

package/dist/enterprise-server.js.map

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

package/dist/index.d.ts

@@ -3,11 +3,24 @@
  *
  * Exposes drift functionality as MCP tools for AI agents.
  * This enables structured, type-safe access to codebase patterns.
+ *
+ * The server uses the DataLake as the central source of truth for all data:
+ * - Pre-computed views for instant status/pattern queries
+ * - Sharded storage for efficient category-based lookups
+ * - Automatic fallback to source stores when lake data unavailable
+ *
+ * Features:
+ * - Layered tool architecture (orchestration → discovery → exploration → detail)
+ * - Intent-aware context synthesis via drift_context
+ * - Token budget awareness and cursor-based pagination
+ * - Structured error handling with recovery hints
+ * - Response caching, rate limiting, and metrics
  */
-export { createDriftMCPServer } from './server.js';
-export type { DriftMCPConfig } from './server.js';
+export { createEnterpriseMCPServer as createDriftMCPServer, createEnterpriseMCPServer, getAllTools, getToolCategories, } from './enterprise-server.js';
+export type { EnterpriseMCPConfig, EnterpriseMCPConfig as DriftMCPConfig } from './enterprise-server.js';
 export { PackManager, DEFAULT_PACKS } from './packs.js';
 export type { PackDefinition, PackMeta, PackResult, PackUsage, SuggestedPack, } from './packs.js';
 export { FeedbackManager } from './feedback.js';
 export type { ExampleFeedback, FeedbackStats, LocationScore, } from './feedback.js';
+export { createResponseBuilder, TokenEstimator, CursorManager, DriftError, Errors, createCache, rateLimiter, metrics, } from './infrastructure/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EACV,cAAc,EACd,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EACV,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EACL,yBAAyB,IAAI,oBAAoB,EACjD,yBAAyB,EACzB,WAAW,EACX,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,IAAI,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzG,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EACV,cAAc,EACd,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EACV,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,UAAU,EACV,MAAM,EACN,WAAW,EACX,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -3,8 +3,24 @@
  *
  * Exposes drift functionality as MCP tools for AI agents.
  * This enables structured, type-safe access to codebase patterns.
+ *
+ * The server uses the DataLake as the central source of truth for all data:
+ * - Pre-computed views for instant status/pattern queries
+ * - Sharded storage for efficient category-based lookups
+ * - Automatic fallback to source stores when lake data unavailable
+ *
+ * Features:
+ * - Layered tool architecture (orchestration → discovery → exploration → detail)
+ * - Intent-aware context synthesis via drift_context
+ * - Token budget awareness and cursor-based pagination
+ * - Structured error handling with recovery hints
+ * - Response caching, rate limiting, and metrics
  */
-export { createDriftMCPServer } from './server.js';
+// Primary Server Export
+export { createEnterpriseMCPServer as createDriftMCPServer, createEnterpriseMCPServer, getAllTools, getToolCategories, } from './enterprise-server.js';
+// Utilities
 export { PackManager, DEFAULT_PACKS } from './packs.js';
 export { FeedbackManager } from './feedback.js';
+// Infrastructure (for custom server implementations)
+export { createResponseBuilder, TokenEstimator, CursorManager, DriftError, Errors, createCache, rateLimiter, metrics, } from './infrastructure/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AASxD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,wBAAwB;AACxB,OAAO,EACL,yBAAyB,IAAI,oBAAoB,EACjD,yBAAyB,EACzB,WAAW,EACX,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAGhC,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AASxD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAOhD,qDAAqD;AACrD,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,UAAU,EACV,MAAM,EACN,WAAW,EACX,WAAW,EACX,OAAO,GACR,MAAM,2BAA2B,CAAC"}

package/dist/infrastructure/cache.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Response Cache
+ *
+ * Multi-level caching for MCP responses:
+ * - L1: In-memory LRU cache (fast, limited size)
+ * - L2: File-based cache (slower, larger, persistent)
+ *
+ * Features:
+ * - Automatic invalidation on pattern changes
+ * - TTL-based expiration
+ * - Cache key generation from tool + args
+ */
+export interface CachedResponse<T = unknown> {
+    data: T;
+    createdAt: number;
+    expiresAt: number;
+    source?: 'l1' | 'l2';
+    invalidationKeys?: string[] | undefined;
+}
+export interface CacheConfig {
+    l1MaxSize: number;
+    l1TtlMs: number;
+    l2Enabled: boolean;
+    l2TtlMs: number;
+    l2CacheDir?: string | undefined;
+}
+export declare class ResponseCache {
+    private l1;
+    private config;
+    private invalidationIndex;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Get cached response
+     */
+    get<T>(key: string): Promise<CachedResponse<T> | null>;
+    /**
+     * Set cached response
+     */
+    set<T>(key: string, data: T, options?: {
+        ttlMs?: number;
+        invalidationKeys?: string[];
+    }): Promise<void>;
+    /**
+     * Delete cached response
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Invalidate all caches matching an invalidation key
+     */
+    invalidate(invalidationKey: string): Promise<number>;
+    /**
+     * Invalidate caches for specific categories
+     */
+    invalidateCategories(categories: string[]): Promise<number>;
+    /**
+     * Invalidate all pattern-related caches
+     */
+    invalidatePatterns(): Promise<number>;
+    /**
+     * Clear all caches
+     */
+    clear(): Promise<void>;
+    /**
+     * Generate cache key from tool name and arguments
+     */
+    generateKey(tool: string, args: Record<string, unknown>): string;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        l1Size: number;
+        l1MaxSize: number;
+        invalidationKeys: number;
+    };
+    private isExpired;
+    private getFromL2;
+    private setToL2;
+    private deleteFromL2;
+    private clearL2;
+    private getL2Path;
+}
+/**
+ * Create a cache instance with project-specific L2 directory
+ */
+export declare function createCache(projectRoot: string, config?: Partial<CacheConfig>): ResponseCache;
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/infrastructure/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACzC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AA+DD,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAmC;IAC7C,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,iBAAiB,CAAuC;gBAEpD,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAK7C;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAoB5D;;OAEG;IACG,GAAG,CAAC,CAAC,EACT,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,EACP,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,GACL,OAAO,CAAC,IAAI,CAAC;IAiChB;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC;;OAEG;IACG,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB1D;;OAEG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQjE;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAkBhE;;OAEG;IACH,QAAQ,IAAI;QACV,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAUD,OAAO,CAAC,SAAS;YAIH,SAAS;YAYT,OAAO;YAYP,YAAY;YAWZ,OAAO;IAUrB,OAAO,CAAC,SAAS;CAQlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,aAAa,CAOjG"}