@memberjunction/db-auto-doc 2.116.0 → 2.118.0

package/dist/types/config.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Configuration types for DBAutoDoc
+ */
+export interface DBAutoDocConfig {
+    version: string;
+    database: DatabaseConfig;
+    ai: AIConfig;
+    analysis: AnalysisConfig;
+    output: OutputConfig;
+    schemas: SchemaFilterConfig;
+    tables: TableFilterConfig;
+}
+export interface DatabaseConfig {
+    provider?: 'sqlserver' | 'mysql' | 'postgresql' | 'oracle';
+    server: string;
+    port?: number;
+    database: string;
+    user: string;
+    password: string;
+    encrypt?: boolean;
+    trustServerCertificate?: boolean;
+    connectionTimeout?: number;
+    requestTimeout?: number;
+    maxConnections?: number;
+    minConnections?: number;
+    idleTimeoutMillis?: number;
+}
+export interface AIConfig {
+    provider: 'openai' | 'anthropic' | 'groq' | 'mistral' | 'gemini';
+    model: string;
+    apiKey: string;
+    temperature?: number;
+    maxTokens?: number;
+    requestsPerMinute?: number;
+    effortLevel?: number;
+}
+export interface AnalysisConfig {
+    cardinalityThreshold: number;
+    sampleSize: number;
+    includeStatistics: boolean;
+    includePatternAnalysis: boolean;
+    convergence: ConvergenceConfig;
+    backpropagation: BackpropagationConfig;
+    sanityChecks: SanityCheckConfig;
+    guardrails?: GuardrailsConfig;
+    relationshipDiscovery?: RelationshipDiscoveryConfig;
+}
+export interface RelationshipDiscoveryConfig {
+    enabled: boolean;
+    triggers: {
+        runOnMissingPKs: boolean;
+        runOnInsufficientFKs: boolean;
+        fkDeficitThreshold: number;
+    };
+    tokenBudget: {
+        maxTokens?: number;
+        ratioOfTotal?: number;
+    };
+    confidence: {
+        primaryKeyMinimum: number;
+        foreignKeyMinimum: number;
+        llmValidationThreshold: number;
+    };
+    sampling: {
+        maxRowsPerTable: number;
+        statisticalSignificance: number;
+        valueOverlapSampleSize: number;
+    };
+    patterns: {
+        primaryKeyNames: string[];
+        foreignKeyNames: string[];
+        compositeKeyIndicators: string[];
+    };
+    llmValidation: {
+        enabled: boolean;
+        batchSize: number;
+    };
+    backpropagation: {
+        enabled: boolean;
+        maxIterations: number;
+    };
+}
+export interface GuardrailsConfig {
+    maxTokensPerRun?: number;
+    maxDurationSeconds?: number;
+    maxCostDollars?: number;
+    maxTokensPerPrompt?: number;
+    maxTokensPerPhase?: {
+        discovery?: number;
+        analysis?: number;
+        sanityChecks?: number;
+    };
+    maxTokensPerIteration?: number;
+    maxIterationDurationSeconds?: number;
+    warnThresholds?: {
+        tokenPercentage?: number;
+        durationPercentage?: number;
+        costPercentage?: number;
+        iterationTokenPercentage?: number;
+        phaseTokenPercentage?: number;
+    };
+    enabled?: boolean;
+    stopOnExceeded?: boolean;
+}
+export interface ConvergenceConfig {
+    maxIterations: number;
+    stabilityWindow: number;
+    confidenceThreshold: number;
+}
+export interface BackpropagationConfig {
+    enabled: boolean;
+    maxDepth: number;
+}
+export interface SanityCheckConfig {
+    dependencyLevel: boolean;
+    schemaLevel: boolean;
+    crossSchema: boolean;
+}
+export interface OutputConfig {
+    stateFile: string;
+    outputDir?: string;
+    sqlFile: string;
+    markdownFile: string;
+}
+export interface SchemaFilterConfig {
+    include?: string[];
+    exclude?: string[];
+}
+export interface TableFilterConfig {
+    exclude?: string[];
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

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

package/dist/types/config.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Configuration types for DBAutoDoc
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+;
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAoIF,CAAC"}

package/dist/types/discovery.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Type definitions for relationship discovery phase
+ * Used to detect primary keys and foreign keys in databases with missing metadata
+ */
+/**
+ * Evidence for why a column might be a primary key
+ */
+export interface PKEvidence {
+    uniqueness: number;
+    nullCount: number;
+    totalRows: number;
+    dataPattern: 'sequential' | 'guid' | 'composite' | 'natural' | 'unknown';
+    namingScore: number;
+    dataTypeScore: number;
+    warnings: string[];
+}
+/**
+ * Primary key candidate discovered during analysis
+ */
+export interface PKCandidate {
+    schemaName: string;
+    tableName: string;
+    columnNames: string[];
+    confidence: number;
+    evidence: PKEvidence;
+    discoveredInIteration: number;
+    validatedByLLM: boolean;
+    status: 'candidate' | 'confirmed' | 'rejected';
+}
+/**
+ * Evidence for why a column might be a foreign key
+ */
+export interface FKEvidence {
+    namingMatch: number;
+    valueOverlap: number;
+    cardinalityRatio: number;
+    dataTypeMatch: boolean;
+    nullPercentage: number;
+    sampleSize: number;
+    orphanCount: number;
+    warnings: string[];
+}
+/**
+ * Foreign key candidate discovered during analysis
+ */
+export interface FKCandidate {
+    schemaName: string;
+    sourceTable: string;
+    sourceColumn: string;
+    targetSchema: string;
+    targetTable: string;
+    targetColumn: string;
+    confidence: number;
+    evidence: FKEvidence;
+    discoveredInIteration: number;
+    validatedByLLM: boolean;
+    status: 'candidate' | 'confirmed' | 'rejected';
+}
+/**
+ * Statistics about a column's data (for discovery)
+ * Extended version of AutoDocColumnStatistics
+ */
+export interface ColumnStatistics {
+    columnName: string;
+    dataType: string;
+    totalRows: number;
+    nullCount: number;
+    distinctCount: number;
+    minValue?: string | number;
+    maxValue?: string | number;
+    avgLength?: number;
+    commonPatterns?: string[];
+    sampleValues: Array<string | number | null>;
+}
+/**
+ * Simpler column statistics interface for discovery
+ * Maps to what the driver provides
+ */
+export interface SimpleColumnStats {
+    totalRows: number;
+    nullCount: number;
+    distinctCount: number;
+    sampleValues: Array<string | number | null>;
+}
+/**
+ * Single iteration of the discovery process
+ */
+export interface RelationshipDiscoveryIteration {
+    iteration: number;
+    phase: 'sampling' | 'pk_detection' | 'fk_detection' | 'sanity_check' | 'llm_validation' | 'backprop';
+    startedAt: string;
+    completedAt: string;
+    tokensUsed: number;
+    discoveries: {
+        newPKs: PKCandidate[];
+        newFKs: FKCandidate[];
+        validated: string[];
+        rejected: string[];
+        confidenceChanges: Array<{
+            id: string;
+            oldConfidence: number;
+            newConfidence: number;
+            reason: string;
+        }>;
+    };
+    backpropTriggered: boolean;
+    backpropReason?: string;
+}
+/**
+ * Feedback from analysis phase back to discovery
+ */
+export interface AnalysisToDiscoveryFeedback {
+    type: 'pk_invalidated' | 'fk_invalidated' | 'new_relationship' | 'confidence_change';
+    evidence: string;
+    tableName: string;
+    columnName: string;
+    affectedCandidates: string[];
+    recommendation: 'remove' | 'downgrade_confidence' | 'upgrade_confidence' | 'add_new';
+    newConfidence?: number;
+    newRelationship?: {
+        targetTable: string;
+        targetColumn: string;
+    };
+}
+/**
+ * Complete state of relationship discovery phase
+ */
+export interface RelationshipDiscoveryPhase {
+    triggered: boolean;
+    triggerReason: 'missing_pks' | 'insufficient_fks' | 'both' | 'manual';
+    triggerDetails: {
+        tablesWithoutPK: number;
+        expectedFKs: number;
+        actualFKs: number;
+        fkDeficitPercentage: number;
+    };
+    startedAt: string;
+    completedAt?: string;
+    tokenBudget: {
+        allocated: number;
+        used: number;
+        remaining: number;
+    };
+    iterations: RelationshipDiscoveryIteration[];
+    discovered: {
+        primaryKeys: PKCandidate[];
+        foreignKeys: FKCandidate[];
+    };
+    schemaEnhancements: {
+        pkeysAdded: number;
+        fkeysAdded: number;
+        overallConfidence: number;
+    };
+    feedbackFromAnalysis: AnalysisToDiscoveryFeedback[];
+    summary: {
+        totalTablesAnalyzed: number;
+        tablesWithDiscoveredPKs: number;
+        relationshipsDiscovered: number;
+        averageConfidence: number;
+        highConfidenceCount: number;
+        mediumConfidenceCount: number;
+        lowConfidenceCount: number;
+        rejectedCount: number;
+    };
+}
+/**
+ * Discovery trigger analysis
+ */
+export interface DiscoveryTriggerAnalysis {
+    shouldRun: boolean;
+    reason: string;
+    details: {
+        totalTables: number;
+        tablesWithPK: number;
+        tablesWithoutPK: number;
+        totalFKs: number;
+        expectedMinFKs: number;
+        fkDeficit: number;
+        fkDeficitPercentage: number;
+    };
+}
+/**
+ * Cached column statistics for reuse across discovery and analysis
+ * Pre-computed once and stored to avoid redundant queries
+ */
+export interface CachedColumnStats {
+    schemaName: string;
+    tableName: string;
+    columnName: string;
+    dataType: string;
+    totalRows: number;
+    nullCount: number;
+    nullPercentage: number;
+    distinctCount: number;
+    uniqueness: number;
+    minValue?: string | number;
+    maxValue?: string | number;
+    avgLength?: number;
+    dataPattern: 'sequential' | 'guid' | 'composite' | 'natural' | 'unknown';
+    sampleValues: Array<string | number | null>;
+    valueDistribution?: Array<{
+        value: string | number;
+        frequency: number;
+    }>;
+    computedAt: string;
+    queryTimeMs: number;
+}
+/**
+ * Collection of cached stats for a table
+ */
+export interface TableStatsCache {
+    schemaName: string;
+    tableName: string;
+    totalRows: number;
+    columns: Map<string, CachedColumnStats>;
+    computedAt: string;
+}
+/**
+ * LLM context for relationship discovery
+ * Provides selective stats to LLM for intelligent reasoning
+ */
+export interface LLMDiscoveryContext {
+    targetTable: {
+        schema: string;
+        table: string;
+        rowCount: number;
+        columns: Array<{
+            name: string;
+            type: string;
+            uniqueness: number;
+            nullPercentage: number;
+            distinctCount: number;
+            dataPattern: string;
+            sampleValues: Array<string | number | null>;
+        }>;
+    };
+    relatedTables?: Array<{
+        schema: string;
+        table: string;
+        rowCount: number;
+        potentialRelationships: Array<{
+            columnName: string;
+            similarity: number;
+            reason: string;
+        }>;
+    }>;
+    pkCandidates: Array<{
+        columnNames: string[];
+        confidence: number;
+        reasoning: string;
+    }>;
+    fkCandidates: Array<{
+        sourceColumn: string;
+        targetTable: string;
+        targetColumn: string;
+        confidence: number;
+        reasoning: string;
+    }>;
+}
+/**
+ * LLM validation result
+ */
+export interface LLMValidationResult {
+    validated: boolean;
+    reasoning: string;
+    confidenceAdjustment: number;
+    recommendations: Array<{
+        type: 'confirm' | 'reject' | 'modify' | 'add_new';
+        target: 'pk' | 'fk';
+        schemaName?: string;
+        tableName?: string;
+        columnName?: string;
+        details: string;
+    }>;
+    tokensUsed: number;
+}
+//# sourceMappingURL=discovery.d.ts.map

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

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

package/dist/types/discovery.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Type definitions for relationship discovery phase
+ * Used to detect primary keys and foreign keys in databases with missing metadata
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=discovery.js.map

package/dist/types/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/types/discovery.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/driver.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Database driver abstraction types
+ * Defines database-agnostic interfaces for multi-provider support
+ */
+/**
+ * Database-agnostic schema representation
+ */
+export interface AutoDocSchema {
+    name: string;
+    description?: string;
+    tables: AutoDocTable[];
+}
+/**
+ * Database-agnostic table representation
+ */
+export interface AutoDocTable {
+    schemaName: string;
+    tableName: string;
+    rowCount: number;
+    columns: AutoDocColumn[];
+    foreignKeys: AutoDocForeignKey[];
+    primaryKeys: AutoDocPrimaryKey[];
+}
+/**
+ * Database-agnostic column representation
+ */
+export interface AutoDocColumn {
+    name: string;
+    dataType: string;
+    isNullable: boolean;
+    isPrimaryKey: boolean;
+    isForeignKey: boolean;
+    checkConstraint?: string;
+    defaultValue?: string;
+    maxLength?: number;
+    precision?: number;
+    scale?: number;
+}
+/**
+ * Database-agnostic foreign key representation
+ */
+export interface AutoDocForeignKey {
+    columnName: string;
+    referencedSchema: string;
+    referencedTable: string;
+    referencedColumn: string;
+    constraintName?: string;
+}
+/**
+ * Database-agnostic primary key representation
+ */
+export interface AutoDocPrimaryKey {
+    columnName: string;
+    ordinalPosition: number;
+    constraintName?: string;
+}
+/**
+ * Database-agnostic column statistics
+ */
+export interface AutoDocColumnStatistics {
+    totalRows: number;
+    distinctCount: number;
+    uniquenessRatio: number;
+    nullCount: number;
+    nullPercentage: number;
+    sampleValues: any[];
+    min?: any;
+    max?: any;
+    avg?: number;
+    stdDev?: number;
+    avgLength?: number;
+    maxLength?: number;
+    minLength?: number;
+    valueDistribution?: AutoDocValueDistribution[];
+}
+/**
+ * Value distribution for low-cardinality columns
+ */
+export interface AutoDocValueDistribution {
+    value: any;
+    frequency: number;
+    percentage: number;
+}
+/**
+ * Existing description from database metadata
+ */
+export interface AutoDocExistingDescription {
+    target: 'table' | 'column';
+    targetName: string;
+    description: string;
+}
+/**
+ * Database connection configuration (provider-agnostic)
+ */
+export interface AutoDocConnectionConfig {
+    provider: 'sqlserver' | 'mysql' | 'postgresql' | 'oracle';
+    host: string;
+    port?: number;
+    database: string;
+    user?: string;
+    username?: string;
+    password: string;
+    encrypt?: boolean;
+    trustServerCertificate?: boolean;
+    socketPath?: string;
+    ssl?: boolean | {
+        rejectUnauthorized?: boolean;
+    };
+    connectionTimeout?: number;
+    requestTimeout?: number;
+    maxConnections?: number;
+    minConnections?: number;
+    idleTimeoutMillis?: number;
+}
+/**
+ * Query result wrapper
+ */
+export interface AutoDocQueryResult<T = any> {
+    success: boolean;
+    data?: T[];
+    rowCount?: number;
+    errorMessage?: string;
+}
+/**
+ * Connection test result
+ */
+export interface AutoDocConnectionTestResult {
+    success: boolean;
+    message: string;
+    serverVersion?: string;
+    databaseName?: string;
+}
+/**
+ * Schema filter options
+ */
+export interface AutoDocSchemaFilter {
+    include?: string[];
+    exclude?: string[];
+}
+/**
+ * Table filter options
+ */
+export interface AutoDocTableFilter {
+    exclude?: string[];
+    includePattern?: RegExp;
+    excludePattern?: RegExp;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/types/driver.d.ts.map

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

package/dist/types/driver.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Database driver abstraction types
+ * Defines database-agnostic interfaces for multi-provider support
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=driver.js.map

package/dist/types/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../src/types/driver.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Centralized exports for all types
+ */
+export * from './state.js';
+export * from './config.js';
+export * from './analysis.js';
+export * from './prompts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Centralized exports for all types
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./state.js"), exports);
+__exportStar(require("./config.js"), exports);
+__exportStar(require("./analysis.js"), exports);
+__exportStar(require("./prompts.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,6CAA2B;AAC3B,8CAA4B;AAC5B,gDAA8B;AAC9B,+CAA6B"}