driftdetect-mcp 0.1.0

package/README.md

@@ -0,0 +1,122 @@
+# Drift MCP Server
+
+MCP (Model Context Protocol) server that exposes drift functionality to AI agents like Claude, Kiro, and other MCP-compatible tools.
+
+## Installation
+
+```bash
+npm install -g driftdetect-mcp
+# or
+pnpm add -g driftdetect-mcp
+```
+
+## Configuration
+
+Add to your MCP config (`.kiro/settings/mcp.json` for Kiro, or `~/.config/claude/mcp.json` for Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "drift": {
+      "command": "npx",
+      "args": ["driftdetect-mcp", "/path/to/your/project"]
+    }
+  }
+}
+```
+
+Or if installed globally:
+
+```json
+{
+  "mcpServers": {
+    "drift": {
+      "command": "drift-mcp",
+      "args": ["/path/to/your/project"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### `drift_status`
+Get overall codebase pattern health and statistics.
+
+### `drift_patterns`
+Query patterns by category with optional confidence filtering.
+
+**Parameters:**
+- `categories` (optional): Array of categories to query
+- `minConfidence` (optional): Minimum confidence score (0.0-1.0)
+
+### `drift_files`
+Get patterns found in a specific file or glob pattern.
+
+**Parameters:**
+- `path` (required): File path or glob pattern
+- `category` (optional): Filter by category
+
+### `drift_where`
+Find where a pattern is used across the codebase.
+
+**Parameters:**
+- `pattern` (required): Pattern name or ID to search
+- `category` (optional): Filter by category
+
+### `drift_export`
+Export patterns in AI-optimized format for code generation context.
+
+**Parameters:**
+- `categories` (optional): Categories to export
+- `format` (optional): `ai-context`, `json`, or `summary`
+- `compact` (optional): Reduce output verbosity
+
+### `drift_contracts`
+Get frontend/backend API contract status and mismatches.
+
+**Parameters:**
+- `status` (optional): `all`, `verified`, `mismatch`, or `discovered`
+
+## Categories
+
+Drift tracks 15 pattern categories:
+- `api` - API route patterns, response formats
+- `auth` - Authentication and authorization
+- `security` - Security patterns and practices
+- `errors` - Error handling patterns
+- `logging` - Logging conventions
+- `testing` - Test structure and mocking
+- `data-access` - Database and data layer patterns
+- `config` - Configuration management
+- `types` - TypeScript type patterns
+- `structural` - File/folder organization
+- `components` - UI component patterns
+- `styling` - CSS/styling conventions
+- `accessibility` - A11y patterns
+- `documentation` - Doc patterns
+- `performance` - Performance optimizations
+
+## Example Usage
+
+Once configured, AI agents can query your codebase patterns:
+
+```
+Agent: "How does this codebase handle authentication?"
+→ Uses drift_patterns with categories: ["auth", "security"]
+
+Agent: "Show me the API patterns before I add a new endpoint"
+→ Uses drift_export with categories: ["api"] and format: "ai-context"
+
+Agent: "Are there any API contract mismatches?"
+→ Uses drift_contracts with status: "mismatch"
+```
+
+## Prerequisites
+
+Run `drift scan` in your project first to build the pattern database:
+
+```bash
+cd /path/to/your/project
+npx driftdetect scan
+```

package/dist/bin/server.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Drift MCP Server Entry Point
+ *
+ * Usage:
+ *   drift-mcp                    # Run in current directory
+ *   drift-mcp /path/to/project   # Run for specific project
+ *
+ * MCP Config (add to mcp.json):
+ * {
+ *   "mcpServers": {
+ *     "drift": {
+ *       "command": "npx",
+ *       "args": ["driftdetect-mcp", "/path/to/your/project"]
+ *     }
+ *   }
+ * }
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

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

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

package/dist/bin/server.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * Drift MCP Server Entry Point
+ *
+ * Usage:
+ *   drift-mcp                    # Run in current directory
+ *   drift-mcp /path/to/project   # Run for specific project
+ *
+ * MCP Config (add to mcp.json):
+ * {
+ *   "mcpServers": {
+ *     "drift": {
+ *       "command": "npx",
+ *       "args": ["driftdetect-mcp", "/path/to/your/project"]
+ *     }
+ *   }
+ * }
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createDriftMCPServer } from '../server.js';
+async function main() {
+    const projectRoot = process.argv[2] ?? process.cwd();
+    const server = createDriftMCPServer({ projectRoot });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        await server.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await server.close();
+        process.exit(0);
+    });
+}
+main().catch((error) => {
+    console.error('Failed to start Drift MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/bin/server.js.map

@@ -0,0 +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"}

package/dist/feedback.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Example Quality Feedback System
+ *
+ * Tracks user feedback on pattern examples to improve future suggestions.
+ * Feedback is stored per-project and used to boost/penalize pattern locations.
+ */
+export interface ExampleFeedback {
+    patternId: string;
+    patternName: string;
+    category: string;
+    file: string;
+    line: number;
+    rating: 'good' | 'bad' | 'irrelevant';
+    reason?: string | undefined;
+    timestamp: string;
+}
+export interface FeedbackStats {
+    totalFeedback: number;
+    goodExamples: number;
+    badExamples: number;
+    irrelevantExamples: number;
+    topGoodPatterns: Array<{
+        pattern: string;
+        count: number;
+    }>;
+    topBadPatterns: Array<{
+        pattern: string;
+        count: number;
+    }>;
+    topBadFiles: Array<{
+        file: string;
+        count: number;
+    }>;
+}
+export interface LocationScore {
+    file: string;
+    boost: number;
+    confidence: number;
+}
+export declare class FeedbackManager {
+    private feedbackDir;
+    private feedbackFile;
+    private scoresFile;
+    private feedback;
+    private locationScores;
+    private initialized;
+    constructor(projectRoot: string);
+    initialize(): Promise<void>;
+    private loadFeedback;
+    private loadScores;
+    private saveFeedback;
+    private saveScores;
+    /**
+     * Record feedback on an example
+     */
+    recordFeedback(feedback: Omit<ExampleFeedback, 'timestamp'>): Promise<void>;
+    private updateLocationScore;
+    /**
+     * Get the quality score for a file (used to rank examples)
+     * Returns a multiplier: 1.0 = neutral, >1 = boosted, <1 = penalized
+     */
+    getFileScore(file: string): number;
+    /**
+     * Check if a file should be excluded based on consistent bad feedback
+     */
+    shouldExcludeFile(file: string): boolean;
+    /**
+     * Get feedback statistics
+     */
+    getStats(): Promise<FeedbackStats>;
+    /**
+     * Get all feedback for export/analysis
+     */
+    getAllFeedback(): Promise<ExampleFeedback[]>;
+    /**
+     * Clear all feedback (for testing or reset)
+     */
+    clearFeedback(): Promise<void>;
+}
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,cAAc,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAMzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YASnB,YAAY;YASZ,UAAU;YAUV,YAAY;YAIZ,UAAU;IAKxB;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;YAsBnE,mBAAmB;IA4BjC;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAqBlC;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQxC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC;IAqDxC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKlD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAMrC"}

package/dist/feedback.js

@@ -0,0 +1,197 @@
+/**
+ * Example Quality Feedback System
+ *
+ * Tracks user feedback on pattern examples to improve future suggestions.
+ * Feedback is stored per-project and used to boost/penalize pattern locations.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+// ============================================================================
+// Feedback Manager
+// ============================================================================
+export class FeedbackManager {
+    feedbackDir;
+    feedbackFile;
+    scoresFile;
+    feedback = [];
+    locationScores = new Map();
+    initialized = false;
+    constructor(projectRoot) {
+        this.feedbackDir = path.join(projectRoot, '.drift', 'feedback');
+        this.feedbackFile = path.join(this.feedbackDir, 'examples.json');
+        this.scoresFile = path.join(this.feedbackDir, 'scores.json');
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        await fs.mkdir(this.feedbackDir, { recursive: true });
+        await this.loadFeedback();
+        await this.loadScores();
+        this.initialized = true;
+    }
+    async loadFeedback() {
+        try {
+            const content = await fs.readFile(this.feedbackFile, 'utf-8');
+            this.feedback = JSON.parse(content);
+        }
+        catch {
+            this.feedback = [];
+        }
+    }
+    async loadScores() {
+        try {
+            const content = await fs.readFile(this.scoresFile, 'utf-8');
+            const scores = JSON.parse(content);
+            this.locationScores = new Map(scores.map(s => [s.file, s]));
+        }
+        catch {
+            this.locationScores = new Map();
+        }
+    }
+    async saveFeedback() {
+        await fs.writeFile(this.feedbackFile, JSON.stringify(this.feedback, null, 2), 'utf-8');
+    }
+    async saveScores() {
+        const scores = Array.from(this.locationScores.values());
+        await fs.writeFile(this.scoresFile, JSON.stringify(scores, null, 2), 'utf-8');
+    }
+    /**
+     * Record feedback on an example
+     */
+    async recordFeedback(feedback) {
+        await this.initialize();
+        const entry = {
+            ...feedback,
+            timestamp: new Date().toISOString(),
+        };
+        this.feedback.push(entry);
+        // Update location scores
+        await this.updateLocationScore(feedback.file, feedback.rating);
+        // Keep last 5000 feedback entries
+        if (this.feedback.length > 5000) {
+            this.feedback = this.feedback.slice(-5000);
+        }
+        await this.saveFeedback();
+        await this.saveScores();
+    }
+    async updateLocationScore(file, rating) {
+        const existing = this.locationScores.get(file) || {
+            file,
+            boost: 0,
+            confidence: 0,
+        };
+        // Update boost based on rating
+        const delta = rating === 'good' ? 0.1 : rating === 'bad' ? -0.15 : -0.05;
+        existing.boost = Math.max(-1, Math.min(1, existing.boost + delta));
+        // Increase confidence with each feedback
+        existing.confidence = Math.min(1, existing.confidence + 0.1);
+        this.locationScores.set(file, existing);
+        // Also update directory-level scores for pattern propagation
+        const dir = path.dirname(file);
+        const dirScore = this.locationScores.get(dir) || {
+            file: dir,
+            boost: 0,
+            confidence: 0,
+        };
+        dirScore.boost = Math.max(-1, Math.min(1, dirScore.boost + delta * 0.3));
+        dirScore.confidence = Math.min(1, dirScore.confidence + 0.03);
+        this.locationScores.set(dir, dirScore);
+    }
+    /**
+     * Get the quality score for a file (used to rank examples)
+     * Returns a multiplier: 1.0 = neutral, >1 = boosted, <1 = penalized
+     */
+    getFileScore(file) {
+        const fileScore = this.locationScores.get(file);
+        const dirScore = this.locationScores.get(path.dirname(file));
+        let boost = 0;
+        let confidence = 0;
+        if (fileScore) {
+            boost += fileScore.boost * fileScore.confidence;
+            confidence = Math.max(confidence, fileScore.confidence);
+        }
+        if (dirScore) {
+            boost += dirScore.boost * dirScore.confidence * 0.5;
+            confidence = Math.max(confidence, dirScore.confidence * 0.5);
+        }
+        // Convert boost to multiplier: -1 -> 0.3, 0 -> 1.0, 1 -> 1.7
+        return 1 + (boost * 0.7);
+    }
+    /**
+     * Check if a file should be excluded based on consistent bad feedback
+     */
+    shouldExcludeFile(file) {
+        const score = this.locationScores.get(file);
+        if (!score)
+            return false;
+        // Exclude if we have high confidence that this file produces bad examples
+        return score.boost < -0.5 && score.confidence > 0.5;
+    }
+    /**
+     * Get feedback statistics
+     */
+    async getStats() {
+        await this.initialize();
+        const goodExamples = this.feedback.filter(f => f.rating === 'good').length;
+        const badExamples = this.feedback.filter(f => f.rating === 'bad').length;
+        const irrelevantExamples = this.feedback.filter(f => f.rating === 'irrelevant').length;
+        // Count patterns
+        const patternCounts = new Map();
+        for (const f of this.feedback) {
+            const key = `${f.category}/${f.patternName}`;
+            const counts = patternCounts.get(key) || { good: 0, bad: 0 };
+            if (f.rating === 'good')
+                counts.good++;
+            else if (f.rating === 'bad')
+                counts.bad++;
+            patternCounts.set(key, counts);
+        }
+        // Count bad files
+        const fileCounts = new Map();
+        for (const f of this.feedback) {
+            if (f.rating === 'bad' || f.rating === 'irrelevant') {
+                fileCounts.set(f.file, (fileCounts.get(f.file) || 0) + 1);
+            }
+        }
+        const topGoodPatterns = Array.from(patternCounts.entries())
+            .filter(([, c]) => c.good > 0)
+            .sort((a, b) => b[1].good - a[1].good)
+            .slice(0, 5)
+            .map(([pattern, counts]) => ({ pattern, count: counts.good }));
+        const topBadPatterns = Array.from(patternCounts.entries())
+            .filter(([, c]) => c.bad > 0)
+            .sort((a, b) => b[1].bad - a[1].bad)
+            .slice(0, 5)
+            .map(([pattern, counts]) => ({ pattern, count: counts.bad }));
+        const topBadFiles = Array.from(fileCounts.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10)
+            .map(([file, count]) => ({ file, count }));
+        return {
+            totalFeedback: this.feedback.length,
+            goodExamples,
+            badExamples,
+            irrelevantExamples,
+            topGoodPatterns,
+            topBadPatterns,
+            topBadFiles,
+        };
+    }
+    /**
+     * Get all feedback for export/analysis
+     */
+    async getAllFeedback() {
+        await this.initialize();
+        return [...this.feedback];
+    }
+    /**
+     * Clear all feedback (for testing or reset)
+     */
+    async clearFeedback() {
+        this.feedback = [];
+        this.locationScores = new Map();
+        await this.saveFeedback();
+        await this.saveScores();
+    }
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Drift MCP Server
+ *
+ * Exposes drift functionality as MCP tools for AI agents.
+ * This enables structured, type-safe access to codebase patterns.
+ */
+export { createDriftMCPServer } from './server.js';
+export type { DriftMCPConfig } from './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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Drift MCP Server
+ *
+ * Exposes drift functionality as MCP tools for AI agents.
+ * This enables structured, type-safe access to codebase patterns.
+ */
+export { createDriftMCPServer } from './server.js';
+export { PackManager, DEFAULT_PACKS } from './packs.js';
+export { FeedbackManager } from './feedback.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/packs.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Pattern Packs - Pre-defined bundles of patterns for common tasks
+ *
+ * Provides cached, task-oriented pattern context for AI agents.
+ */
+import { PatternStore } from 'driftdetect-core';
+export interface PackDefinition {
+    name: string;
+    description: string;
+    categories: string[];
+    patterns?: string[] | undefined;
+    maxExamples?: number;
+    contextLines?: number;
+    minConfidence?: number;
+    includeDeprecated?: boolean;
+}
+export interface PackMeta {
+    name: string;
+    generatedAt: string;
+    patternHash: string;
+    sourceFiles: string[];
+    packDefHash: string;
+}
+export interface PackResult {
+    content: string;
+    fromCache: boolean;
+    generatedAt: string;
+    staleReason?: string;
+}
+export interface PackUsage {
+    categories: string[];
+    patterns?: string[] | undefined;
+    timestamp: string;
+    context?: 'code_generation' | 'review' | 'onboarding' | 'unknown';
+}
+export interface SuggestedPack {
+    name: string;
+    description: string;
+    categories: string[];
+    patterns?: string[] | undefined;
+    usageCount: number;
+    lastUsed: string;
+}
+export declare const DEFAULT_PACKS: PackDefinition[];
+export declare class PackManager {
+    private projectRoot;
+    private store;
+    private packsDir;
+    private cacheDir;
+    private customPacks;
+    constructor(projectRoot: string, store: PatternStore);
+    initialize(): Promise<void>;
+    private ensureDirectories;
+    private loadCustomPacks;
+    getAllPacks(): PackDefinition[];
+    getPack(name: string): PackDefinition | undefined;
+    getPackContent(name: string, options?: {
+        refresh?: boolean;
+    }): Promise<PackResult>;
+    private checkStaleness;
+    private generatePack;
+    private hashPackDef;
+    private computePatternHash;
+    refreshAllPacks(): Promise<Map<string, PackResult>>;
+    /**
+     * Track pack/category usage for learning
+     */
+    trackUsage(usage: PackUsage): Promise<void>;
+    /**
+     * Suggest packs based on usage patterns
+     */
+    suggestPacks(): Promise<SuggestedPack[]>;
+    /**
+     * Create a custom pack from suggestion or manual definition
+     */
+    createCustomPack(pack: PackDefinition): Promise<void>;
+    /**
+     * Delete a custom pack
+     */
+    deleteCustomPack(name: string): Promise<boolean>;
+    /**
+     * Infer packs from codebase structure (co-occurring patterns)
+     */
+    inferPacksFromStructure(): Promise<SuggestedPack[]>;
+}
+//# sourceMappingURL=packs.d.ts.map

package/dist/packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packs.d.ts","sourceRoot":"","sources":["../src/packs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,YAAY,EAA+B,MAAM,kBAAkB,CAAC;AA8G7E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,iBAAiB,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;CACnE;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,eAAO,MAAM,aAAa,EAAE,cAAc,EAwCzC,CAAC;AAMF,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAwB;gBAE/B,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;IAO9C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAMnB,iBAAiB;YAKjB,eAAe;IAW7B,WAAW,IAAI,cAAc,EAAE;IAY/B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,UAAU,CAAC;YA0C9E,cAAc;YA0Cd,YAAY;IAgL1B,OAAO,CAAC,WAAW;YAUL,kBAAkB;IAU1B,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAazD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBjD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA4E9C;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3D;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCtD;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;CA+D1D"}