@memberjunction/db-auto-doc 2.116.0 → 2.118.0

package/dist/discovery/ColumnStatsCache.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Column Statistics Cache
+ * Stores pre-computed column statistics to avoid redundant database queries
+ * Used across discovery and analysis phases
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ColumnStatsCache = void 0;
+class ColumnStatsCache {
+    constructor() {
+        this.tableCache = new Map();
+    }
+    /**
+     * Get table key for cache lookup
+     */
+    getTableKey(schemaName, tableName) {
+        return `${schemaName}.${tableName}`;
+    }
+    /**
+     * Get column key for cache lookup
+     */
+    getColumnKey(schemaName, tableName, columnName) {
+        return `${schemaName}.${tableName}.${columnName}`;
+    }
+    /**
+     * Store column statistics
+     */
+    setColumnStats(stats) {
+        const tableKey = this.getTableKey(stats.schemaName, stats.tableName);
+        let tableStats = this.tableCache.get(tableKey);
+        if (!tableStats) {
+            tableStats = {
+                schemaName: stats.schemaName,
+                tableName: stats.tableName,
+                totalRows: stats.totalRows,
+                columns: new Map(),
+                computedAt: stats.computedAt
+            };
+            this.tableCache.set(tableKey, tableStats);
+        }
+        tableStats.columns.set(stats.columnName, stats);
+    }
+    /**
+     * Get column statistics
+     */
+    getColumnStats(schemaName, tableName, columnName) {
+        const tableKey = this.getTableKey(schemaName, tableName);
+        const tableStats = this.tableCache.get(tableKey);
+        return tableStats?.columns.get(columnName);
+    }
+    /**
+     * Get all column statistics for a table
+     */
+    getTableStats(schemaName, tableName) {
+        const tableKey = this.getTableKey(schemaName, tableName);
+        return this.tableCache.get(tableKey);
+    }
+    /**
+     * Get all columns in a table
+     */
+    getTableColumns(schemaName, tableName) {
+        const tableStats = this.getTableStats(schemaName, tableName);
+        return tableStats ? Array.from(tableStats.columns.values()) : [];
+    }
+    /**
+     * Check if column stats exist
+     */
+    hasColumnStats(schemaName, tableName, columnName) {
+        return this.getColumnStats(schemaName, tableName, columnName) !== undefined;
+    }
+    /**
+     * Check if table stats exist
+     */
+    hasTableStats(schemaName, tableName) {
+        return this.getTableStats(schemaName, tableName) !== undefined;
+    }
+    /**
+     * Get all tables with cached stats
+     */
+    getAllTables() {
+        return Array.from(this.tableCache.values());
+    }
+    /**
+     * Find columns matching a pattern across all tables
+     * Useful for finding potential FK relationships
+     */
+    findColumnsMatching(predicate) {
+        const results = [];
+        for (const tableStats of this.tableCache.values()) {
+            for (const columnStats of tableStats.columns.values()) {
+                if (predicate(columnStats)) {
+                    results.push(columnStats);
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Find columns with similar names across tables
+     * Example: Find all columns named "*_id" or "*ID"
+     */
+    findColumnsByNamePattern(pattern) {
+        return this.findColumnsMatching(stats => pattern.test(stats.columnName));
+    }
+    /**
+     * Find highly unique columns (potential PKs)
+     */
+    findUniqueColumns(minUniqueness = 0.95) {
+        return this.findColumnsMatching(stats => stats.uniqueness >= minUniqueness && stats.nullCount === 0);
+    }
+    /**
+     * Find columns with same name across multiple tables
+     * Returns Map of columnName -> array of CachedColumnStats
+     */
+    findDuplicateColumnNames() {
+        const columnMap = new Map();
+        for (const tableStats of this.tableCache.values()) {
+            for (const columnStats of tableStats.columns.values()) {
+                const existing = columnMap.get(columnStats.columnName) || [];
+                existing.push(columnStats);
+                columnMap.set(columnStats.columnName, existing);
+            }
+        }
+        // Filter to only columns that appear in multiple tables
+        return new Map(Array.from(columnMap.entries()).filter(([_, stats]) => stats.length > 1));
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        let totalColumns = 0;
+        let totalStatsBytes = 0;
+        for (const tableStats of this.tableCache.values()) {
+            totalColumns += tableStats.columns.size;
+            // Rough estimate of memory usage
+            totalStatsBytes += JSON.stringify(Array.from(tableStats.columns.values())).length;
+        }
+        return {
+            totalTables: this.tableCache.size,
+            totalColumns,
+            totalStatsBytes,
+            avgColumnsPerTable: this.tableCache.size > 0 ? totalColumns / this.tableCache.size : 0
+        };
+    }
+    /**
+     * Clear all cached stats
+     */
+    clear() {
+        this.tableCache.clear();
+    }
+    /**
+     * Export cache to JSON for persistence in state file
+     */
+    toStateJSON() {
+        let totalColumns = 0;
+        const tables = {};
+        for (const [key, tableStats] of this.tableCache.entries()) {
+            const columns = Array.from(tableStats.columns.values());
+            totalColumns += columns.length;
+            tables[key] = {
+                schemaName: tableStats.schemaName,
+                tableName: tableStats.tableName,
+                totalRows: tableStats.totalRows,
+                columns
+            };
+        }
+        return {
+            computedAt: new Date().toISOString(),
+            totalSchemas: new Set(Array.from(this.tableCache.values()).map(t => t.schemaName)).size,
+            totalTables: this.tableCache.size,
+            totalColumns,
+            tables
+        };
+    }
+    /**
+     * Import cache from state JSON
+     */
+    fromStateJSON(data) {
+        this.clear();
+        for (const [key, tableEntry] of Object.entries(data.tables)) {
+            const columnMap = new Map();
+            for (const col of tableEntry.columns) {
+                columnMap.set(col.columnName, col);
+            }
+            this.tableCache.set(key, {
+                schemaName: tableEntry.schemaName,
+                tableName: tableEntry.tableName,
+                totalRows: tableEntry.totalRows,
+                columns: columnMap,
+                computedAt: data.computedAt
+            });
+        }
+    }
+    /**
+     * Merge cached stats into schema column definitions
+     * Replaces separate columnStatistics cache with embedded stats
+     */
+    mergeIntoSchemas(schemas) {
+        for (const schema of schemas) {
+            for (const table of schema.tables) {
+                const cacheKey = `${schema.name}.${table.name}`;
+                const tableStats = this.tableCache.get(cacheKey);
+                if (!tableStats)
+                    continue;
+                for (const column of table.columns) {
+                    const cachedStats = tableStats.columns.get(column.name);
+                    if (!cachedStats)
+                        continue;
+                    // Merge cached stats into column.statistics
+                    column.statistics = {
+                        totalRows: cachedStats.totalRows,
+                        distinctCount: cachedStats.distinctCount,
+                        uniquenessRatio: cachedStats.uniqueness,
+                        nullCount: cachedStats.nullCount,
+                        nullPercentage: cachedStats.nullPercentage,
+                        dataPattern: cachedStats.dataPattern,
+                        sampleValues: cachedStats.sampleValues,
+                        valueDistribution: cachedStats.valueDistribution,
+                        minValue: cachedStats.minValue,
+                        maxValue: cachedStats.maxValue,
+                        avgLength: cachedStats.avgLength,
+                        computedAt: cachedStats.computedAt,
+                        queryTimeMs: cachedStats.queryTimeMs
+                    };
+                }
+            }
+        }
+    }
+}
+exports.ColumnStatsCache = ColumnStatsCache;
+//# sourceMappingURL=ColumnStatsCache.js.map

package/dist/discovery/ColumnStatsCache.js.map

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

package/dist/discovery/DiscoveryEngine.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Discovery Engine
+ * Orchestrates relationship discovery with iterative refinement and backpropagation
+ */
+import { BaseAutoDocDriver } from '../drivers/BaseAutoDocDriver.js';
+import { ColumnStatsCache } from './ColumnStatsCache.js';
+import { SchemaDefinition, DatabaseDocumentation } from '../types/state.js';
+import { RelationshipDiscoveryPhase, DiscoveryTriggerAnalysis } from '../types/discovery.js';
+import { RelationshipDiscoveryConfig, AIConfig } from '../types/config.js';
+export interface DiscoveryEngineOptions {
+    driver: BaseAutoDocDriver;
+    config: RelationshipDiscoveryConfig;
+    aiConfig: AIConfig;
+    schemas: SchemaDefinition[];
+    onProgress?: (message: string, data?: any) => void;
+}
+export interface DiscoveryResult {
+    phase: RelationshipDiscoveryPhase;
+    guardrailsReached: boolean;
+    guardrailReason?: string;
+    statsCache: ColumnStatsCache;
+}
+export declare class DiscoveryEngine {
+    private driver;
+    private config;
+    private aiConfig;
+    private schemas;
+    private onProgress;
+    private statsCache;
+    private pkDetector;
+    private fkDetector;
+    private llmValidator?;
+    private sanityChecker?;
+    constructor(options: DiscoveryEngineOptions);
+    /**
+     * Get the column statistics cache
+     */
+    getStatsCache(): ColumnStatsCache;
+    /**
+     * Analyze if discovery should be triggered based on schema state
+     */
+    analyzeTrigger(): DiscoveryTriggerAnalysis;
+    /**
+     * Execute the discovery process
+     */
+    discover(maxTokens: number, triggerAnalysis: DiscoveryTriggerAnalysis): Promise<DiscoveryResult>;
+    /**
+     * Initialize discovery phase
+     */
+    private initializePhase;
+    /**
+     * Determine trigger reason from analysis
+     */
+    private determineTriggerReason;
+    /**
+     * Execute a single discovery iteration
+     */
+    private executeIteration;
+    /**
+     * Detect primary keys in all tables without PKs
+     */
+    private detectPrimaryKeys;
+    /**
+     * Detect foreign keys across all schemas
+     */
+    private detectForeignKeys;
+    /**
+     * Perform LLM validation on PK/FK candidates
+     */
+    private performLLMValidation;
+    /**
+     * Check if backpropagation should be triggered
+     */
+    private shouldTriggerBackprop;
+    /**
+     * Perform backpropagation to update confidence scores
+     */
+    private performBackpropagation;
+    /**
+     * Merge iteration discoveries into phase
+     */
+    private mergeDiscoveries;
+    /**
+     * Check if discovery should continue
+     */
+    private shouldContinueDiscovery;
+    /**
+     * Check guardrails
+     */
+    private checkGuardrails;
+    /**
+     * Calculate final summary statistics
+     */
+    private calculateSummary;
+    /**
+     * Apply discovered relationships to state
+     */
+    applyDiscoveriesToState(state: DatabaseDocumentation, phase: RelationshipDiscoveryPhase): void;
+}
+//# sourceMappingURL=DiscoveryEngine.d.ts.map

package/dist/discovery/DiscoveryEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoveryEngine.d.ts","sourceRoot":"","sources":["../../src/discovery/DiscoveryEngine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAKpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EACL,0BAA0B,EAI1B,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,2BAA2B,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,0BAA0B,CAAC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAwB;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAmB;gBAE7B,OAAO,EAAE,sBAAsB;IA2B3C;;OAEG;IACI,aAAa,IAAI,gBAAgB;IAIxC;;OAEG;IACI,cAAc,IAAI,wBAAwB;IA6DjD;;OAEG;IACU,QAAQ,CACnB,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,wBAAwB,GACxC,OAAO,CAAC,eAAe,CAAC;IA2E3B;;OAEG;IACH,OAAO,CAAC,eAAe;IA6CvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;YACW,gBAAgB;IAwK9B;;OAEG;YACW,iBAAiB;IAoC/B;;OAEG;YACW,iBAAiB;IAqC/B;;OAEG;YACW,oBAAoB;IAuJlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAuB7B;;OAEG;YACW,sBAAsB;IA4DpC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6B/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;OAEG;IACI,uBAAuB,CAC5B,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,0BAA0B,GAChC,IAAI;CA4CR"}