@memberjunction/db-auto-doc 2.116.0 → 2.118.0

package/dist/core/ConvergenceDetector.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Determines when analysis has converged
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConvergenceDetector = void 0;
+class ConvergenceDetector {
+    constructor(config, stateManager, iterationTracker) {
+        this.config = config;
+        this.stateManager = stateManager;
+        this.iterationTracker = iterationTracker;
+    }
+    /**
+     * Check if analysis has converged
+     */
+    hasConverged(state, run) {
+        const reasons = [];
+        // 1. Check max iterations
+        if (run.iterationsPerformed >= this.config.maxIterations) {
+            return {
+                converged: true,
+                reason: `Reached maximum iteration limit (${this.config.maxIterations})`,
+                iterationsPerformed: run.iterationsPerformed,
+                suggestions: ['Consider increasing maxIterations if results are unsatisfactory']
+            };
+        }
+        // 2. Check stability window (no changes in last N iterations)
+        if (run.iterationsPerformed >= 2) {
+            const hasChanges = this.hasRecentChanges(run, this.config.stabilityWindow);
+            if (!hasChanges) {
+                reasons.push(`No changes in last ${this.config.stabilityWindow} iterations (stability achieved)`);
+            }
+        }
+        // 3. Check confidence threshold
+        const lowConfidenceTables = this.stateManager.getLowConfidenceTables(state, this.config.confidenceThreshold);
+        if (lowConfidenceTables.length === 0 && run.iterationsPerformed >= 1) {
+            reasons.push(`All tables meet confidence threshold (${this.config.confidenceThreshold})`);
+        }
+        // Converged if we have at least 2 reasons and minimum iterations
+        if (reasons.length >= 2 && run.iterationsPerformed >= 2) {
+            return {
+                converged: true,
+                reason: reasons.join('; '),
+                iterationsPerformed: run.iterationsPerformed
+            };
+        }
+        // Not yet converged
+        const suggestions = [];
+        if (lowConfidenceTables.length > 0) {
+            suggestions.push(`${lowConfidenceTables.length} tables below confidence threshold - needs more iteration`);
+        }
+        if (run.iterationsPerformed < 2) {
+            suggestions.push('Minimum 2 iterations required before convergence check');
+        }
+        return {
+            converged: false,
+            reason: 'Analysis still evolving',
+            iterationsPerformed: run.iterationsPerformed,
+            suggestions
+        };
+    }
+    /**
+     * Check if there were changes in recent iterations
+     */
+    hasRecentChanges(run, windowSize) {
+        // Get log entries from last window
+        const logsPerIteration = Math.ceil(run.processingLog.length / run.iterationsPerformed);
+        const windowLogs = run.processingLog.slice(-(windowSize * logsPerIteration));
+        return windowLogs.some(entry => entry.result === 'changed');
+    }
+    /**
+     * Calculate average confidence across all tables
+     */
+    calculateAverageConfidence(state) {
+        let totalConfidence = 0;
+        let count = 0;
+        for (const schema of state.schemas) {
+            for (const table of schema.tables) {
+                if (table.descriptionIterations.length > 0) {
+                    const latest = table.descriptionIterations[table.descriptionIterations.length - 1];
+                    if (latest.confidence !== undefined) {
+                        totalConfidence += latest.confidence;
+                        count++;
+                    }
+                }
+            }
+        }
+        return count > 0 ? totalConfidence / count : 0;
+    }
+}
+exports.ConvergenceDetector = ConvergenceDetector;
+//# sourceMappingURL=ConvergenceDetector.js.map

package/dist/core/ConvergenceDetector.js.map

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

package/dist/core/GuardrailsManager.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Manages granular guardrails enforcement for DBAutoDoc analysis
+ *
+ * Supports:
+ * - Per-phase token limits (discovery, analysis, sanity checks)
+ * - Per-iteration token and duration limits
+ * - Cost-based limits with configurable thresholds
+ * - Configurable warning thresholds at percentages of limits
+ * - Detailed tracking of exceedances and warnings
+ */
+import { GuardrailsConfig } from '../types/config.js';
+import { AnalysisRun, GuardrailExceeded, GuardrailWarning } from '../types/state.js';
+export type PhaseType = 'discovery' | 'analysis' | 'sanityChecks';
+export interface GuardrailCheckResult {
+    canContinue: boolean;
+    warning?: string;
+    reason?: string;
+    warnings?: GuardrailWarning[];
+    exceedances?: GuardrailExceeded[];
+}
+export declare class GuardrailsManager {
+    private config;
+    private startTime;
+    private phaseStartTimes;
+    private currentPhase?;
+    private currentIteration;
+    private iterationStartTime?;
+    constructor(config?: GuardrailsConfig);
+    /**
+     * Begin tracking a new phase
+     */
+    startPhase(phase: PhaseType): void;
+    /**
+     * End tracking current phase and record metrics
+     */
+    endPhase(run: AnalysisRun, phase: PhaseType): void;
+    /**
+     * Start tracking a new iteration
+     */
+    startIteration(iteration: number): void;
+    /**
+     * End tracking current iteration and record metrics
+     */
+    endIteration(run: AnalysisRun, iteration: number): void;
+    /**
+     * Check all guardrails and return enforcement status
+     */
+    checkGuardrails(run: AnalysisRun): GuardrailCheckResult;
+    /**
+     * Record guardrail enforcement in the run
+     */
+    recordEnforcement(run: AnalysisRun, result: GuardrailCheckResult): void;
+    /**
+     * Get tokens used in a specific phase
+     */
+    private getPhaseTokens;
+    /**
+     * Get estimated cost for a specific phase
+     */
+    private getPhaseCost;
+    /**
+     * Get tokens used in current iteration
+     */
+    private getCurrentIterationTokens;
+    /**
+     * Create a stop result with warnings and exceedances
+     */
+    private createStopResult;
+    /**
+     * Get current elapsed time in seconds
+     */
+    getElapsedSeconds(): number;
+    /**
+     * Get current phase token budget (remaining tokens)
+     */
+    getPhaseTokenBudgetRemaining(phase: PhaseType): number | undefined;
+}
+//# sourceMappingURL=GuardrailsManager.d.ts.map

package/dist/core/GuardrailsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuardrailsManager.d.ts","sourceRoot":"","sources":["../../src/core/GuardrailsManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAqE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAExJ,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;AAElE,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAY;IACjC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,kBAAkB,CAAC,CAAS;gBAExB,MAAM,CAAC,EAAE,gBAAgB;IAKrC;;OAEG;IACI,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAKzC;;OAEG;IACI,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IA0BzD;;OAEG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK9C;;OAEG;IACI,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAqB9D;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,oBAAoB;IA+N9D;;OAEG;IACI,iBAAiB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAuB9E;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;OAEG;IACI,4BAA4B,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;CAU1E"}

package/dist/core/GuardrailsManager.js

@@ -0,0 +1,367 @@
+"use strict";
+/**
+ * Manages granular guardrails enforcement for DBAutoDoc analysis
+ *
+ * Supports:
+ * - Per-phase token limits (discovery, analysis, sanity checks)
+ * - Per-iteration token and duration limits
+ * - Cost-based limits with configurable thresholds
+ * - Configurable warning thresholds at percentages of limits
+ * - Detailed tracking of exceedances and warnings
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuardrailsManager = void 0;
+class GuardrailsManager {
+    constructor(config) {
+        this.phaseStartTimes = new Map();
+        this.currentIteration = 0;
+        this.config = config || {};
+        this.startTime = Date.now();
+    }
+    /**
+     * Begin tracking a new phase
+     */
+    startPhase(phase) {
+        this.currentPhase = phase;
+        this.phaseStartTimes.set(phase, Date.now());
+    }
+    /**
+     * End tracking current phase and record metrics
+     */
+    endPhase(run, phase) {
+        if (!run.phaseMetrics) {
+            run.phaseMetrics = {};
+        }
+        const startTime = this.phaseStartTimes.get(phase);
+        if (startTime) {
+            const metric = {
+                startedAt: new Date(startTime).toISOString(),
+                completedAt: new Date().toISOString(),
+                tokensUsed: this.getPhaseTokens(run, phase),
+                estimatedCost: this.getPhaseCost(run, phase)
+            };
+            if (phase === 'discovery') {
+                run.phaseMetrics.discovery = metric;
+            }
+            else if (phase === 'analysis') {
+                run.phaseMetrics.analysis = metric;
+            }
+            else if (phase === 'sanityChecks') {
+                run.phaseMetrics.sanityChecks = metric;
+            }
+        }
+        this.currentPhase = undefined;
+    }
+    /**
+     * Start tracking a new iteration
+     */
+    startIteration(iteration) {
+        this.currentIteration = iteration;
+        this.iterationStartTime = Date.now();
+    }
+    /**
+     * End tracking current iteration and record metrics
+     */
+    endIteration(run, iteration) {
+        if (!run.iterationMetrics) {
+            run.iterationMetrics = [];
+        }
+        if (this.iterationStartTime) {
+            const metric = {
+                iterationNumber: iteration,
+                startedAt: new Date(this.iterationStartTime).toISOString(),
+                completedAt: new Date().toISOString(),
+                tokensUsed: run.totalTokensUsed || 0,
+                estimatedCost: run.estimatedCost || 0,
+                duration: Date.now() - this.iterationStartTime
+            };
+            run.iterationMetrics.push(metric);
+        }
+        this.iterationStartTime = undefined;
+    }
+    /**
+     * Check all guardrails and return enforcement status
+     */
+    checkGuardrails(run) {
+        // If guardrails disabled, allow continuation
+        if (this.config.enabled === false) {
+            return { canContinue: true };
+        }
+        const elapsedSeconds = (Date.now() - this.startTime) / 1000;
+        const totalTokens = run.totalTokensUsed || 0;
+        const totalCost = run.estimatedCost || 0;
+        // Get default thresholds
+        const warnThresholds = this.config.warnThresholds || {};
+        const tokenWarnPercent = warnThresholds.tokenPercentage ?? 80;
+        const durationWarnPercent = warnThresholds.durationPercentage ?? 80;
+        const costWarnPercent = warnThresholds.costPercentage ?? 80;
+        const iterationTokenWarnPercent = warnThresholds.iterationTokenPercentage ?? 80;
+        const phaseTokenWarnPercent = warnThresholds.phaseTokenPercentage ?? 80;
+        const warnings = [];
+        const exceedances = [];
+        // 1. Check hard limits - STOP
+        if (this.config.maxTokensPerRun && totalTokens >= this.config.maxTokensPerRun) {
+            exceedances.push({
+                type: 'tokens_per_run',
+                limit: this.config.maxTokensPerRun,
+                actual: totalTokens,
+                unit: 'tokens'
+            });
+            return this.createStopResult(`Token limit exceeded: ${totalTokens.toLocaleString()} / ${this.config.maxTokensPerRun.toLocaleString()} tokens`, warnings, exceedances);
+        }
+        if (this.config.maxDurationSeconds && elapsedSeconds >= this.config.maxDurationSeconds) {
+            exceedances.push({
+                type: 'duration',
+                limit: this.config.maxDurationSeconds,
+                actual: Math.round(elapsedSeconds),
+                unit: 'seconds'
+            });
+            return this.createStopResult(`Duration limit exceeded: ${Math.round(elapsedSeconds)}s / ${this.config.maxDurationSeconds}s`, warnings, exceedances);
+        }
+        if (this.config.maxCostDollars && totalCost >= this.config.maxCostDollars) {
+            exceedances.push({
+                type: 'cost',
+                limit: this.config.maxCostDollars,
+                actual: Number(totalCost.toFixed(2)),
+                unit: 'dollars'
+            });
+            return this.createStopResult(`Cost limit exceeded: $${totalCost.toFixed(2)} / $${this.config.maxCostDollars.toFixed(2)}`, warnings, exceedances);
+        }
+        // 2. Check phase-specific token limits
+        if (this.currentPhase && this.config.maxTokensPerPhase) {
+            const phaseLimits = this.config.maxTokensPerPhase;
+            let phaseLimit;
+            let phaseTokens;
+            if (this.currentPhase === 'discovery' && phaseLimits.discovery) {
+                phaseLimit = phaseLimits.discovery;
+                phaseTokens = this.getPhaseTokens(run, 'discovery');
+            }
+            else if (this.currentPhase === 'analysis' && phaseLimits.analysis) {
+                phaseLimit = phaseLimits.analysis;
+                phaseTokens = this.getPhaseTokens(run, 'analysis');
+            }
+            else if (this.currentPhase === 'sanityChecks' && phaseLimits.sanityChecks) {
+                phaseLimit = phaseLimits.sanityChecks;
+                phaseTokens = this.getPhaseTokens(run, 'sanityChecks');
+            }
+            if (phaseLimit && phaseTokens !== undefined && phaseTokens >= phaseLimit) {
+                if (this.config.stopOnExceeded !== false) {
+                    exceedances.push({
+                        type: 'tokens_per_phase',
+                        phase: this.currentPhase,
+                        limit: phaseLimit,
+                        actual: phaseTokens,
+                        unit: 'tokens'
+                    });
+                    return this.createStopResult(`Phase token limit exceeded (${this.currentPhase}): ${phaseTokens.toLocaleString()} / ${phaseLimit.toLocaleString()} tokens`, warnings, exceedances);
+                }
+            }
+        }
+        // 3. Check per-iteration limits
+        if (this.currentIteration > 0 && this.config.maxTokensPerIteration) {
+            const iterationTokens = this.getCurrentIterationTokens(run);
+            if (iterationTokens >= this.config.maxTokensPerIteration) {
+                if (this.config.stopOnExceeded !== false) {
+                    exceedances.push({
+                        type: 'tokens_per_iteration',
+                        iteration: this.currentIteration,
+                        limit: this.config.maxTokensPerIteration,
+                        actual: iterationTokens,
+                        unit: 'tokens'
+                    });
+                    return this.createStopResult(`Iteration token limit exceeded (iteration ${this.currentIteration}): ${iterationTokens.toLocaleString()} / ${this.config.maxTokensPerIteration.toLocaleString()} tokens`, warnings, exceedances);
+                }
+            }
+        }
+        if (this.currentIteration > 0 && this.iterationStartTime && this.config.maxIterationDurationSeconds) {
+            const iterationDuration = (Date.now() - this.iterationStartTime) / 1000;
+            if (iterationDuration >= this.config.maxIterationDurationSeconds) {
+                if (this.config.stopOnExceeded !== false) {
+                    exceedances.push({
+                        type: 'iteration_duration',
+                        iteration: this.currentIteration,
+                        limit: this.config.maxIterationDurationSeconds,
+                        actual: Math.round(iterationDuration),
+                        unit: 'seconds'
+                    });
+                    return this.createStopResult(`Iteration duration exceeded (iteration ${this.currentIteration}): ${Math.round(iterationDuration)}s / ${this.config.maxIterationDurationSeconds}s`, warnings, exceedances);
+                }
+            }
+        }
+        // 4. Check warning thresholds
+        if (this.config.maxTokensPerRun) {
+            const tokenPercent = (totalTokens / this.config.maxTokensPerRun) * 100;
+            if (tokenPercent >= tokenWarnPercent) {
+                warnings.push({
+                    type: 'tokens_per_run',
+                    percentage: Math.round(tokenPercent),
+                    message: `Token usage at ${Math.round(tokenPercent)}% (${totalTokens.toLocaleString()} / ${this.config.maxTokensPerRun.toLocaleString()})`
+                });
+            }
+        }
+        if (this.config.maxDurationSeconds) {
+            const durationPercent = (elapsedSeconds / this.config.maxDurationSeconds) * 100;
+            if (durationPercent >= durationWarnPercent) {
+                warnings.push({
+                    type: 'duration',
+                    percentage: Math.round(durationPercent),
+                    message: `Duration at ${Math.round(durationPercent)}% (${Math.round(elapsedSeconds)}s / ${this.config.maxDurationSeconds}s)`
+                });
+            }
+        }
+        if (this.config.maxCostDollars) {
+            const costPercent = (totalCost / this.config.maxCostDollars) * 100;
+            if (costPercent >= costWarnPercent) {
+                warnings.push({
+                    type: 'cost',
+                    percentage: Math.round(costPercent),
+                    message: `Cost at ${Math.round(costPercent)}% ($${totalCost.toFixed(2)} / $${this.config.maxCostDollars.toFixed(2)})`
+                });
+            }
+        }
+        if (this.currentPhase && this.config.maxTokensPerPhase) {
+            const phaseLimits = this.config.maxTokensPerPhase;
+            let phaseLimit;
+            let phaseTokens;
+            if (this.currentPhase === 'discovery' && phaseLimits.discovery) {
+                phaseLimit = phaseLimits.discovery;
+                phaseTokens = this.getPhaseTokens(run, 'discovery');
+            }
+            else if (this.currentPhase === 'analysis' && phaseLimits.analysis) {
+                phaseLimit = phaseLimits.analysis;
+                phaseTokens = this.getPhaseTokens(run, 'analysis');
+            }
+            else if (this.currentPhase === 'sanityChecks' && phaseLimits.sanityChecks) {
+                phaseLimit = phaseLimits.sanityChecks;
+                phaseTokens = this.getPhaseTokens(run, 'sanityChecks');
+            }
+            if (phaseLimit && phaseTokens !== undefined) {
+                const phaseTokenPercent = (phaseTokens / phaseLimit) * 100;
+                if (phaseTokenPercent >= phaseTokenWarnPercent) {
+                    warnings.push({
+                        type: 'tokens_per_phase',
+                        phase: this.currentPhase,
+                        percentage: Math.round(phaseTokenPercent),
+                        message: `Phase token usage at ${Math.round(phaseTokenPercent)}% (${phaseTokens.toLocaleString()} / ${phaseLimit.toLocaleString()})`
+                    });
+                }
+            }
+        }
+        if (this.currentIteration > 0 && this.config.maxTokensPerIteration) {
+            const iterationTokens = this.getCurrentIterationTokens(run);
+            const iterationTokenPercent = (iterationTokens / this.config.maxTokensPerIteration) * 100;
+            if (iterationTokenPercent >= iterationTokenWarnPercent) {
+                warnings.push({
+                    type: 'tokens_per_iteration',
+                    iteration: this.currentIteration,
+                    percentage: Math.round(iterationTokenPercent),
+                    message: `Iteration token usage at ${Math.round(iterationTokenPercent)}% (${iterationTokens.toLocaleString()} / ${this.config.maxTokensPerIteration.toLocaleString()})`
+                });
+            }
+        }
+        return {
+            canContinue: true,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            exceedances: exceedances.length > 0 ? exceedances : undefined
+        };
+    }
+    /**
+     * Record guardrail enforcement in the run
+     */
+    recordEnforcement(run, result) {
+        if (!result.warnings && !result.exceedances && result.canContinue) {
+            return; // Nothing to record
+        }
+        if (!run.guardrailsEnforced) {
+            run.guardrailsEnforced = {
+                exceedances: [],
+                warnings: []
+            };
+        }
+        if (result.exceedances) {
+            run.guardrailsEnforced.exceedances.push(...result.exceedances);
+            run.guardrailsEnforced.stoppedDueToGuardrails = true;
+            run.guardrailsEnforced.stoppedReason = result.reason;
+        }
+        if (result.warnings) {
+            run.guardrailsEnforced.warnings.push(...result.warnings);
+        }
+    }
+    /**
+     * Get tokens used in a specific phase
+     */
+    getPhaseTokens(run, phase) {
+        if (!run.phaseMetrics)
+            return 0;
+        if (phase === 'discovery') {
+            return run.phaseMetrics.discovery?.tokensUsed || 0;
+        }
+        else if (phase === 'analysis') {
+            return run.phaseMetrics.analysis?.tokensUsed || 0;
+        }
+        else if (phase === 'sanityChecks') {
+            return run.phaseMetrics.sanityChecks?.tokensUsed || 0;
+        }
+        return 0;
+    }
+    /**
+     * Get estimated cost for a specific phase
+     */
+    getPhaseCost(run, phase) {
+        if (!run.phaseMetrics)
+            return 0;
+        if (phase === 'discovery') {
+            return run.phaseMetrics.discovery?.estimatedCost || 0;
+        }
+        else if (phase === 'analysis') {
+            return run.phaseMetrics.analysis?.estimatedCost || 0;
+        }
+        else if (phase === 'sanityChecks') {
+            return run.phaseMetrics.sanityChecks?.estimatedCost || 0;
+        }
+        return 0;
+    }
+    /**
+     * Get tokens used in current iteration
+     */
+    getCurrentIterationTokens(run) {
+        if (!run.iterationMetrics || run.iterationMetrics.length === 0) {
+            return 0;
+        }
+        // Return tokens for current iteration only (latest entry)
+        const currentMetric = run.iterationMetrics[run.iterationMetrics.length - 1];
+        return currentMetric.tokensUsed || 0;
+    }
+    /**
+     * Create a stop result with warnings and exceedances
+     */
+    createStopResult(reason, warnings, exceedances) {
+        return {
+            canContinue: false,
+            reason,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            exceedances: exceedances.length > 0 ? exceedances : undefined
+        };
+    }
+    /**
+     * Get current elapsed time in seconds
+     */
+    getElapsedSeconds() {
+        return (Date.now() - this.startTime) / 1000;
+    }
+    /**
+     * Get current phase token budget (remaining tokens)
+     */
+    getPhaseTokenBudgetRemaining(phase) {
+        if (!this.config.maxTokensPerPhase)
+            return undefined;
+        const limit = this.config.maxTokensPerPhase[phase];
+        if (!limit)
+            return undefined;
+        // This would need access to the current run to calculate remaining
+        // For now, just return the limit
+        return limit;
+    }
+}
+exports.GuardrailsManager = GuardrailsManager;
+//# sourceMappingURL=GuardrailsManager.js.map

package/dist/core/GuardrailsManager.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Exports for core module
+ */
+export { AnalysisEngine } from './AnalysisEngine.js';
+export { BackpropagationEngine } from './BackpropagationEngine.js';
+export { ConvergenceDetector } from './ConvergenceDetector.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Exports for core module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConvergenceDetector = exports.BackpropagationEngine = exports.AnalysisEngine = void 0;
+var AnalysisEngine_js_1 = require("./AnalysisEngine.js");
+Object.defineProperty(exports, "AnalysisEngine", { enumerable: true, get: function () { return AnalysisEngine_js_1.AnalysisEngine; } });
+var BackpropagationEngine_js_1 = require("./BackpropagationEngine.js");
+Object.defineProperty(exports, "BackpropagationEngine", { enumerable: true, get: function () { return BackpropagationEngine_js_1.BackpropagationEngine; } });
+var ConvergenceDetector_js_1 = require("./ConvergenceDetector.js");
+Object.defineProperty(exports, "ConvergenceDetector", { enumerable: true, get: function () { return ConvergenceDetector_js_1.ConvergenceDetector; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yDAAqD;AAA5C,mHAAA,cAAc,OAAA;AACvB,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA"}

package/dist/database/Database.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Database connection and introspection classes
+ * Primary interface for all database operations
+ */
+import { BaseAutoDocDriver } from '../drivers/BaseAutoDocDriver.js';
+import { AutoDocConnectionConfig } from '../types/driver.js';
+import { SchemaDefinition, ColumnDefinition } from '../types/state.js';
+import { SchemaFilterConfig, TableFilterConfig, AnalysisConfig } from '../types/config.js';
+import '../drivers/SQLServerDriver.js';
+import '../drivers/MySQLDriver.js';
+import '../drivers/PostgreSQLDriver.js';
+/**
+ * Create a database driver instance
+ */
+export declare function createDriver(config: AutoDocConnectionConfig): BaseAutoDocDriver;
+/**
+ * Database connection class
+ * Provides connection management and query execution
+ */
+export declare class DatabaseConnection {
+    private driver;
+    constructor(dbConfig: AutoDocConnectionConfig);
+    connect(): Promise<void>;
+    test(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    query<T = any>(queryText: string, maxRetries?: number): Promise<{
+        success: boolean;
+        data?: T[];
+        errorMessage?: string;
+    }>;
+    close(): Promise<void>;
+    getDriver(): BaseAutoDocDriver;
+}
+/**
+ * Database introspector
+ * Retrieves schema and table information from the database
+ */
+export declare class Introspector {
+    private driver;
+    constructor(driver: BaseAutoDocDriver);
+    getSchemas(schemaFilter: SchemaFilterConfig, tableFilter: TableFilterConfig): Promise<SchemaDefinition[]>;
+    getExistingDescriptions(schemaName: string, tableName: string): Promise<Map<string, string>>;
+}
+/**
+ * Data sampler
+ * Analyzes table data and gathers column statistics
+ */
+export declare class DataSampler {
+    private driver;
+    private config;
+    constructor(driver: BaseAutoDocDriver, config: AnalysisConfig);
+    analyzeTable(schemaName: string, tableName: string, columns: ColumnDefinition[]): Promise<void>;
+}
+//# sourceMappingURL=Database.d.ts.map

package/dist/database/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../src/database/Database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAmB,gBAAgB,EAAuB,MAAM,mBAAmB,CAAC;AAC7G,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,+BAA+B,CAAC;AACvC,OAAO,2BAA2B,CAAC;AACnC,OAAO,gCAAgC,CAAC;AAExC;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAiB/E;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,QAAQ,EAAE,uBAAuB;IAIhC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAItD,KAAK,CAAC,CAAC,GAAG,GAAG,EACxB,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAU,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAItD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,SAAS,IAAI,iBAAiB;CAGtC;AAED;;;GAGG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEhC,UAAU,CACrB,YAAY,EAAE,kBAAkB,EAChC,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAuEjB,uBAAuB,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAWhC;AAED;;;GAGG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;gBADN,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,cAAc;IAGnB,YAAY,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC;CAkCjB"}