@memberjunction/db-auto-doc 2.117.0 → 2.119.0

package/dist/state/StateValidator.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Validates state file integrity
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateValidator = void 0;
+class StateValidator {
+    /**
+     * Validate state file
+     */
+    validate(state) {
+        const errors = [];
+        const warnings = [];
+        // Check required fields
+        if (!state.version) {
+            errors.push('Missing version field');
+        }
+        if (!state.database) {
+            errors.push('Missing database field');
+        }
+        else {
+            if (!state.database.name) {
+                errors.push('Missing database.name');
+            }
+            if (!state.database.server) {
+                errors.push('Missing database.server');
+            }
+        }
+        if (!state.schemas) {
+            errors.push('Missing schemas array');
+        }
+        else if (!Array.isArray(state.schemas)) {
+            errors.push('schemas must be an array');
+        }
+        if (!state.phases.descriptionGeneration) {
+            errors.push('Missing analysisRuns array');
+        }
+        else if (!Array.isArray(state.phases.descriptionGeneration)) {
+            errors.push('analysisRuns must be an array');
+        }
+        // Validate schemas
+        if (Array.isArray(state.schemas)) {
+            for (let i = 0; i < state.schemas.length; i++) {
+                const schema = state.schemas[i];
+                if (!schema.name) {
+                    errors.push(`Schema at index ${i} missing name`);
+                }
+                if (!schema.tables || !Array.isArray(schema.tables)) {
+                    errors.push(`Schema "${schema.name}" missing or invalid tables array`);
+                    continue;
+                }
+                // Validate tables
+                for (let j = 0; j < schema.tables.length; j++) {
+                    const table = schema.tables[j];
+                    if (!table.name) {
+                        errors.push(`Table at index ${j} in schema "${schema.name}" missing name`);
+                    }
+                    if (!table.columns || !Array.isArray(table.columns)) {
+                        errors.push(`Table "${table.name}" in schema "${schema.name}" missing or invalid columns array`);
+                    }
+                    if (!table.descriptionIterations || !Array.isArray(table.descriptionIterations)) {
+                        errors.push(`Table "${table.name}" in schema "${schema.name}" missing or invalid descriptionIterations array`);
+                    }
+                    // Validate foreign key references
+                    if (table.dependsOn && Array.isArray(table.dependsOn)) {
+                        for (const dep of table.dependsOn) {
+                            if (!this.tableExists(state, dep.schema, dep.table)) {
+                                warnings.push(`Table "${schema.name}.${table.name}" references non-existent table "${dep.schema}.${dep.table}"`);
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Validate analysis runs
+        if (Array.isArray(state.phases.descriptionGeneration)) {
+            for (let i = 0; i < state.phases.descriptionGeneration.length; i++) {
+                const run = state.phases.descriptionGeneration[i];
+                if (!run.runId) {
+                    errors.push(`Analysis run at index ${i} missing runId`);
+                }
+                if (!run.startedAt) {
+                    errors.push(`Analysis run at index ${i} missing startedAt`);
+                }
+                if (!run.status) {
+                    errors.push(`Analysis run at index ${i} missing status`);
+                }
+                else if (!['in_progress', 'completed', 'failed', 'converged'].includes(run.status)) {
+                    errors.push(`Analysis run at index ${i} has invalid status: ${run.status}`);
+                }
+                if (!run.processingLog || !Array.isArray(run.processingLog)) {
+                    errors.push(`Analysis run at index ${i} missing or invalid processingLog array`);
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    /**
+     * Check if a table exists in the state
+     */
+    tableExists(state, schemaName, tableName) {
+        const schema = state.schemas.find(s => s.name === schemaName);
+        if (!schema) {
+            return false;
+        }
+        return schema.tables.some(t => t.name === tableName);
+    }
+    /**
+     * Validate and repair if possible
+     */
+    validateAndRepair(state) {
+        const result = this.validate(state);
+        // Attempt simple repairs
+        if (!state.phases.descriptionGeneration) {
+            state.phases.descriptionGeneration = [];
+            result.warnings.push('Repaired: Created missing analysisRuns array');
+        }
+        if (!state.schemas) {
+            state.schemas = [];
+            result.warnings.push('Repaired: Created missing schemas array');
+        }
+        // Initialize missing iteration arrays
+        for (const schema of state.schemas) {
+            if (!schema.descriptionIterations) {
+                schema.descriptionIterations = [];
+            }
+            for (const table of schema.tables) {
+                if (!table.descriptionIterations) {
+                    table.descriptionIterations = [];
+                }
+                for (const column of table.columns) {
+                    if (!column.descriptionIterations) {
+                        column.descriptionIterations = [];
+                    }
+                }
+            }
+        }
+        // Re-validate after repairs
+        return this.validate(state);
+    }
+}
+exports.StateValidator = StateValidator;
+//# sourceMappingURL=StateValidator.js.map

package/dist/state/StateValidator.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Exports for state module
+ */
+export { StateManager } from './StateManager.js';
+export { IterationTracker } from './IterationTracker.js';
+export { StateValidator, ValidationResult } from './StateValidator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Exports for state module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateValidator = exports.IterationTracker = exports.StateManager = void 0;
+var StateManager_js_1 = require("./StateManager.js");
+Object.defineProperty(exports, "StateManager", { enumerable: true, get: function () { return StateManager_js_1.StateManager; } });
+var IterationTracker_js_1 = require("./IterationTracker.js");
+Object.defineProperty(exports, "IterationTracker", { enumerable: true, get: function () { return IterationTracker_js_1.IterationTracker; } });
+var StateValidator_js_1 = require("./StateValidator.js");
+Object.defineProperty(exports, "StateValidator", { enumerable: true, get: function () { return StateValidator_js_1.StateValidator; } });
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAAiD;AAAxC,+GAAA,YAAY,OAAA;AACrB,6DAAyD;AAAhD,uHAAA,gBAAgB,OAAA;AACzB,yDAAuE;AAA9D,mHAAA,cAAc,OAAA"}

package/dist/types/analysis.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Analysis-related types for DBAutoDoc
+ */
+import { TableDefinition } from './state.js';
+export interface DependencyGraph {
+    nodes: Map<string, TableNode>;
+    levels: TableNode[][];
+}
+export interface TableNode {
+    schema: string;
+    table: string;
+    fullName: string;
+    dependsOn: TableNode[];
+    dependents: TableNode[];
+    level: number;
+    tableDefinition?: TableDefinition;
+}
+export interface BackpropagationTrigger {
+    sourceTable: string;
+    targetTable: string;
+    insight: string;
+    confidence: number;
+}
+export interface ConvergenceResult {
+    converged: boolean;
+    reason: string;
+    iterationsPerformed: number;
+    suggestions?: string[];
+}
+export interface AnalysisMetrics {
+    tablesAnalyzed: number;
+    columnsAnalyzed: number;
+    totalTokensUsed: number;
+    totalCost: number;
+    averageConfidence: number;
+    lowConfidenceCount: number;
+    backpropagationCount: number;
+    iterationCount: number;
+}
+export interface TableAnalysisContext {
+    schema: string;
+    table: string;
+    rowCount: number;
+    columns: any[];
+    dependsOn: any[];
+    dependents: any[];
+    sampleData: any[];
+    parentDescriptions?: ParentTableDescription[];
+    userNotes?: string;
+    seedContext?: any;
+    allTables?: Array<{
+        schema: string;
+        name: string;
+    }>;
+}
+export interface ParentTableDescription {
+    schema: string;
+    table: string;
+    description: string;
+}
+export interface AnalysisResult {
+    success: boolean;
+    tableDescription?: string;
+    reasoning?: string;
+    confidence?: number;
+    columnDescriptions?: ColumnDescriptionResult[];
+    inferredBusinessDomain?: string;
+    errorMessage?: string;
+    tokensUsed: number;
+}
+export interface ColumnDescriptionResult {
+    columnName: string;
+    description: string;
+    reasoning: string;
+}
+//# sourceMappingURL=analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/types/analysis.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9B,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,kBAAkB,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC/C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/analysis.js

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

package/dist/types/analysis.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,143 @@
+/**
+ * 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;
+    sampleQueryGeneration?: SampleQueryGenerationConfig;
+}
+export interface SampleQueryGenerationConfig {
+    enabled: boolean;
+    queriesPerTable: number;
+    maxExecutionTime: number;
+    includeMultiQueryPatterns: boolean;
+    validateAlignment: boolean;
+    tokenBudget: number;
+    maxRowsInSample: number;
+    maxTables?: number;
+}
+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;;AAgJF,CAAC"}