driftdetect-core 0.4.1 → 0.4.2

package/dist/lake/callgraph-shard-store.js

@@ -0,0 +1,466 @@
+/**
+ * Call Graph Shard Store
+ *
+ * Manages sharded call graph storage - one file per source file.
+ * This allows loading only the call graph data you need.
+ *
+ * Storage structure:
+ * .drift/lake/callgraph/
+ *   ├── index.json           # Call graph summary index
+ *   ├── entry-points.json    # API entry points
+ *   └── files/
+ *       ├── {file-hash}.json # Functions in each source file
+ *       └── ...
+ *
+ * Key features:
+ * - Load call graph by file (not all at once)
+ * - Pre-computed entry points
+ * - Incremental updates per file
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { EventEmitter } from 'node:events';
+import { LAKE_DIRS, DEFAULT_DATA_LAKE_CONFIG, } from './types.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const CALLGRAPH_DIR = 'callgraph';
+const FILES_SUBDIR = 'files';
+const INDEX_FILE = 'index.json';
+const ENTRY_POINTS_FILE = 'entry-points.json';
+const STORE_VERSION = '1.0.0';
+// ============================================================================
+// Helper Functions
+// ============================================================================
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function ensureDir(dirPath) {
+    await fs.mkdir(dirPath, { recursive: true });
+}
+function generateChecksum(data) {
+    const content = JSON.stringify(data);
+    return crypto.createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+function hashFilePath(file) {
+    return crypto.createHash('sha256').update(file).digest('hex').slice(0, 12);
+}
+// ============================================================================
+// Call Graph Shard Store Class
+// ============================================================================
+export class CallGraphShardStore extends EventEmitter {
+    config;
+    callgraphDir;
+    filesDir;
+    // In-memory cache
+    indexCache = null;
+    entryPointsCache = null;
+    fileCache = new Map();
+    constructor(config = {}) {
+        super();
+        this.config = { ...DEFAULT_DATA_LAKE_CONFIG, ...config };
+        this.callgraphDir = path.join(this.config.rootDir, LAKE_DIRS.root, LAKE_DIRS.lake, CALLGRAPH_DIR);
+        this.filesDir = path.join(this.callgraphDir, FILES_SUBDIR);
+    }
+    // ==========================================================================
+    // Initialization
+    // ==========================================================================
+    async initialize() {
+        await ensureDir(this.callgraphDir);
+        await ensureDir(this.filesDir);
+    }
+    // ==========================================================================
+    // Index Operations
+    // ==========================================================================
+    /**
+     * Get the call graph index
+     */
+    async getIndex() {
+        if (this.indexCache) {
+            return this.indexCache;
+        }
+        const indexPath = path.join(this.callgraphDir, INDEX_FILE);
+        if (!(await fileExists(indexPath))) {
+            return null;
+        }
+        try {
+            const content = await fs.readFile(indexPath, 'utf-8');
+            this.indexCache = JSON.parse(content);
+            return this.indexCache;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save the call graph index
+     */
+    async saveIndex(index) {
+        await ensureDir(this.callgraphDir);
+        const indexPath = path.join(this.callgraphDir, INDEX_FILE);
+        await fs.writeFile(indexPath, JSON.stringify(index, null, 2));
+        this.indexCache = index;
+        this.emit('index:saved');
+    }
+    /**
+     * Build call graph index from file shards
+     */
+    async buildIndex() {
+        const fileHashes = await this.listFiles();
+        const fileEntries = [];
+        const entryPoints = [];
+        const dataAccessors = [];
+        let totalFunctions = 0;
+        let totalCalls = 0;
+        let totalEntryPoints = 0;
+        let totalDataAccessors = 0;
+        let totalDepth = 0;
+        for (const fileHash of fileHashes) {
+            const shard = await this.getFileShard(fileHash);
+            if (!shard)
+                continue;
+            const entryPointCount = shard.functions.filter(f => f.isEntryPoint).length;
+            const dataAccessorCount = shard.functions.filter(f => f.isDataAccessor).length;
+            const callCount = shard.functions.reduce((sum, f) => sum + f.calls.length, 0);
+            totalFunctions += shard.functions.length;
+            totalCalls += callCount;
+            totalEntryPoints += entryPointCount;
+            totalDataAccessors += dataAccessorCount;
+            fileEntries.push({
+                file: shard.file,
+                fileHash,
+                functionCount: shard.functions.length,
+                entryPointCount,
+                dataAccessorCount,
+                lastUpdated: new Date().toISOString(),
+            });
+            // Collect entry points
+            for (const fn of shard.functions.filter(f => f.isEntryPoint)) {
+                entryPoints.push({
+                    id: fn.id,
+                    name: fn.name,
+                    file: shard.file,
+                    line: fn.startLine,
+                    reachableFunctions: 0, // Would need full graph traversal
+                    reachableTables: fn.dataAccess.length,
+                });
+            }
+            // Collect data accessors
+            for (const fn of shard.functions.filter(f => f.isDataAccessor)) {
+                const tables = [...new Set(fn.dataAccess.map(da => da.table))];
+                const operations = [...new Set(fn.dataAccess.map(da => da.operation))];
+                dataAccessors.push({
+                    id: fn.id,
+                    name: fn.name,
+                    file: shard.file,
+                    line: fn.startLine,
+                    tables,
+                    operations,
+                });
+            }
+        }
+        // Calculate average depth (simplified)
+        const avgDepth = totalFunctions > 0 ? totalCalls / totalFunctions : 0;
+        totalDepth = avgDepth;
+        // Sort and limit
+        entryPoints.sort((a, b) => b.reachableTables - a.reachableTables);
+        dataAccessors.sort((a, b) => b.tables.length - a.tables.length);
+        const index = {
+            version: STORE_VERSION,
+            generatedAt: new Date().toISOString(),
+            summary: {
+                totalFiles: fileEntries.length,
+                totalFunctions,
+                totalCalls,
+                entryPoints: totalEntryPoints,
+                dataAccessors: totalDataAccessors,
+                avgDepth: Math.round(totalDepth * 100) / 100,
+            },
+            files: fileEntries,
+            topEntryPoints: entryPoints.slice(0, 10),
+            topDataAccessors: dataAccessors.slice(0, 10),
+        };
+        await this.saveIndex(index);
+        return index;
+    }
+    // ==========================================================================
+    // File Shard Operations
+    // ==========================================================================
+    /**
+     * Get call graph data for a specific file
+     */
+    async getFileShard(fileHash) {
+        // Check cache first
+        const cached = this.fileCache.get(fileHash);
+        if (cached) {
+            return cached;
+        }
+        const filePath = path.join(this.filesDir, `${fileHash}.json`);
+        if (!(await fileExists(filePath))) {
+            return null;
+        }
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const data = JSON.parse(content);
+            const shard = {
+                file: data.file,
+                functions: data.functions,
+            };
+            this.fileCache.set(fileHash, shard);
+            return shard;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get call graph data for a file by path
+     */
+    async getFileShardByPath(file) {
+        const fileHash = hashFilePath(file);
+        return this.getFileShard(fileHash);
+    }
+    /**
+     * Save call graph data for a file
+     */
+    async saveFileShard(shard) {
+        await ensureDir(this.filesDir);
+        const fileHash = hashFilePath(shard.file);
+        const filePath = path.join(this.filesDir, `${fileHash}.json`);
+        const shardFile = {
+            version: STORE_VERSION,
+            generatedAt: new Date().toISOString(),
+            checksum: generateChecksum(shard.functions),
+            ...shard,
+        };
+        await fs.writeFile(filePath, JSON.stringify(shardFile, null, 2));
+        this.fileCache.set(fileHash, shard);
+        this.emit('file:saved', shard.file);
+    }
+    /**
+     * Get call graph data for multiple files
+     */
+    async getFileShards(fileHashes) {
+        const results = [];
+        const shards = await Promise.all(fileHashes.map(h => this.getFileShard(h)));
+        for (const shard of shards) {
+            if (shard) {
+                results.push(shard);
+            }
+        }
+        return results;
+    }
+    /**
+     * List all file hashes with call graph data
+     */
+    async listFiles() {
+        if (!(await fileExists(this.filesDir))) {
+            return [];
+        }
+        const files = await fs.readdir(this.filesDir);
+        return files
+            .filter(f => f.endsWith('.json'))
+            .map(f => f.replace('.json', ''));
+    }
+    /**
+     * Delete call graph data for a file
+     */
+    async deleteFileShard(fileHash) {
+        const filePath = path.join(this.filesDir, `${fileHash}.json`);
+        try {
+            await fs.unlink(filePath);
+            this.fileCache.delete(fileHash);
+            this.emit('file:deleted', fileHash);
+        }
+        catch {
+            // Ignore if doesn't exist
+        }
+    }
+    // ==========================================================================
+    // Entry Points Operations
+    // ==========================================================================
+    /**
+     * Get entry points data
+     */
+    async getEntryPoints() {
+        if (this.entryPointsCache) {
+            return this.entryPointsCache;
+        }
+        const filePath = path.join(this.callgraphDir, ENTRY_POINTS_FILE);
+        if (!(await fileExists(filePath))) {
+            return null;
+        }
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            this.entryPointsCache = JSON.parse(content);
+            return this.entryPointsCache;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Save entry points data
+     */
+    async saveEntryPoints(data) {
+        await ensureDir(this.callgraphDir);
+        const filePath = path.join(this.callgraphDir, ENTRY_POINTS_FILE);
+        await fs.writeFile(filePath, JSON.stringify(data, null, 2));
+        this.entryPointsCache = data;
+        this.emit('entrypoints:saved');
+    }
+    /**
+     * Build entry points from file shards
+     */
+    async buildEntryPoints() {
+        const fileHashes = await this.listFiles();
+        const entryPoints = [];
+        for (const fileHash of fileHashes) {
+            const shard = await this.getFileShard(fileHash);
+            if (!shard)
+                continue;
+            for (const fn of shard.functions.filter(f => f.isEntryPoint)) {
+                const tables = [...new Set(fn.dataAccess.map(da => da.table))];
+                const sensitiveFields = []; // Would need security data
+                entryPoints.push({
+                    id: fn.id,
+                    name: fn.name,
+                    file: shard.file,
+                    line: fn.startLine,
+                    endLine: fn.endLine,
+                    type: this.inferEntryPointType(fn.name, shard.file),
+                    reachableFunctions: fn.calls,
+                    reachableTables: tables,
+                    reachableSensitiveFields: sensitiveFields,
+                });
+            }
+        }
+        const data = {
+            version: STORE_VERSION,
+            generatedAt: new Date().toISOString(),
+            entryPoints,
+        };
+        await this.saveEntryPoints(data);
+        return data;
+    }
+    // ==========================================================================
+    // Query Helpers
+    // ==========================================================================
+    /**
+     * Get function by ID
+     */
+    async getFunction(functionId) {
+        const fileHashes = await this.listFiles();
+        for (const fileHash of fileHashes) {
+            const shard = await this.getFileShard(fileHash);
+            if (!shard)
+                continue;
+            const fn = shard.functions.find(f => f.id === functionId);
+            if (fn)
+                return fn;
+        }
+        return null;
+    }
+    /**
+     * Get all functions that access a specific table
+     */
+    async getFunctionsByTable(table) {
+        const fileHashes = await this.listFiles();
+        const results = [];
+        for (const fileHash of fileHashes) {
+            const shard = await this.getFileShard(fileHash);
+            if (!shard)
+                continue;
+            for (const fn of shard.functions) {
+                if (fn.dataAccess.some(da => da.table === table)) {
+                    results.push({ ...fn, file: shard.file });
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Get all data access for a specific table
+     */
+    async getDataAccessByTable(table) {
+        const fileHashes = await this.listFiles();
+        const results = [];
+        for (const fileHash of fileHashes) {
+            const shard = await this.getFileShard(fileHash);
+            if (!shard)
+                continue;
+            for (const fn of shard.functions) {
+                for (const da of fn.dataAccess) {
+                    if (da.table === table) {
+                        results.push({ ...da, functionId: fn.id, file: shard.file });
+                    }
+                }
+            }
+        }
+        return results;
+    }
+    // ==========================================================================
+    // Cache Management
+    // ==========================================================================
+    /**
+     * Invalidate caches
+     */
+    invalidateCache(fileHash) {
+        if (fileHash) {
+            this.fileCache.delete(fileHash);
+        }
+        else {
+            this.indexCache = null;
+            this.entryPointsCache = null;
+            this.fileCache.clear();
+        }
+    }
+    /**
+     * Get cache stats
+     */
+    getCacheStats() {
+        return {
+            cachedFiles: this.fileCache.size,
+            hasIndex: this.indexCache !== null,
+            hasEntryPoints: this.entryPointsCache !== null,
+        };
+    }
+    // ==========================================================================
+    // Private Helpers
+    // ==========================================================================
+    inferEntryPointType(name, file) {
+        const nameLower = name.toLowerCase();
+        const fileLower = file.toLowerCase();
+        if (fileLower.includes('controller'))
+            return 'controller';
+        if (fileLower.includes('route'))
+            return 'route';
+        if (fileLower.includes('handler'))
+            return 'handler';
+        if (fileLower.includes('api'))
+            return 'api';
+        if (nameLower.includes('handler'))
+            return 'handler';
+        if (nameLower.includes('controller'))
+            return 'controller';
+        if (nameLower.startsWith('get') || nameLower.startsWith('post') ||
+            nameLower.startsWith('put') || nameLower.startsWith('delete')) {
+            return 'api';
+        }
+        return 'other';
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createCallGraphShardStore(config = {}) {
+    return new CallGraphShardStore(config);
+}
+//# sourceMappingURL=callgraph-shard-store.js.map

package/dist/lake/callgraph-shard-store.js.map

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

package/dist/lake/examples-store.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Examples Store
+ *
+ * Manages pre-extracted code examples for patterns.
+ * This allows drift_code_examples to return instantly without reading source files.
+ *
+ * Storage structure:
+ * .drift/lake/examples/
+ *   ├── index.json           # Example index (pattern -> file mapping)
+ *   └── patterns/
+ *       ├── {pattern-id}.json  # Pre-extracted examples for each pattern
+ *       └── ...
+ *
+ * Key features:
+ * - Pre-extracted code snippets with context
+ * - Quality scoring for example selection
+ * - Incremental updates per pattern
+ */
+import { EventEmitter } from 'node:events';
+import type { PatternExamples, DataLakeConfig } from './types.js';
+import type { PatternCategory } from '../store/types.js';
+export interface ExamplesIndex {
+    version: string;
+    generatedAt: string;
+    totalPatterns: number;
+    totalExamples: number;
+    patterns: ExampleIndexEntry[];
+}
+export interface ExampleIndexEntry {
+    patternId: string;
+    patternName: string;
+    category: PatternCategory;
+    exampleCount: number;
+    bestQuality: number;
+    lastUpdated: string;
+}
+export interface ExampleExtractionOptions {
+    /** Maximum examples per pattern */
+    maxExamples?: number;
+    /** Lines of context around each example */
+    contextLines?: number;
+    /** Minimum quality score to include */
+    minQuality?: number;
+    /** Include outlier examples */
+    includeOutliers?: boolean;
+}
+export declare class ExamplesStore extends EventEmitter {
+    private readonly config;
+    private readonly examplesDir;
+    private readonly patternsDir;
+    private indexCache;
+    private examplesCache;
+    constructor(config?: Partial<DataLakeConfig>);
+    initialize(): Promise<void>;
+    /**
+     * Get the examples index
+     */
+    getIndex(): Promise<ExamplesIndex | null>;
+    /**
+     * Save the examples index
+     */
+    saveIndex(index: ExamplesIndex): Promise<void>;
+    /**
+     * Build examples index from pattern examples
+     */
+    buildIndex(): Promise<ExamplesIndex>;
+    /**
+     * Get examples for a specific pattern
+     */
+    getPatternExamples(patternId: string): Promise<PatternExamples | null>;
+    /**
+     * Save examples for a pattern
+     */
+    savePatternExamples(examples: PatternExamples): Promise<void>;
+    /**
+     * Get examples for multiple patterns
+     */
+    getMultiplePatternExamples(patternIds: string[]): Promise<PatternExamples[]>;
+    /**
+     * Get examples by category
+     */
+    getExamplesByCategory(category: PatternCategory): Promise<PatternExamples[]>;
+    /**
+     * List all patterns with examples
+     */
+    listPatterns(): Promise<string[]>;
+    /**
+     * Delete examples for a pattern
+     */
+    deletePatternExamples(patternId: string): Promise<void>;
+    /**
+     * Extract examples from source code for a pattern
+     *
+     * This method reads source files and extracts code snippets with context.
+     * It's called during scan/materialize, not at query time.
+     */
+    extractExamples(patternId: string, patternName: string, category: PatternCategory, locations: Array<{
+        file: string;
+        line: number;
+        endLine?: number;
+    }>, outliers: Array<{
+        file: string;
+        line: number;
+        endLine?: number;
+    }>, options?: ExampleExtractionOptions): Promise<PatternExamples>;
+    /**
+     * Extract a single example from a source file
+     */
+    private extractSingleExample;
+    /**
+     * Calculate quality score for an example
+     */
+    private calculateExampleQuality;
+    /**
+     * Invalidate caches
+     */
+    invalidateCache(patternId?: string): void;
+    /**
+     * Get cache stats
+     */
+    getCacheStats(): {
+        cachedPatterns: number;
+        hasIndex: boolean;
+    };
+}
+export declare function createExamplesStore(config?: Partial<DataLakeConfig>): ExamplesStore;
+//# sourceMappingURL=examples-store.d.ts.map

package/dist/lake/examples-store.d.ts.map

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