@memberjunction/db-auto-doc 2.117.0 → 2.119.0

package/dist/types/prompts.js.map

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

package/dist/types/sample-queries.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Sample query generation types for DBAutoDoc
+ * These queries serve as reference implementations for AI agents like Skip
+ */
+/**
+ * Phase 1: Query Planning - lightweight descriptions of what queries to create
+ */
+export interface QueryPlan {
+    id: string;
+    name: string;
+    description: string;
+    businessPurpose: string;
+    queryType: QueryType;
+    queryPattern: QueryPattern;
+    complexity: QueryComplexity;
+    primaryEntities: EntityReference[];
+    relatedEntities: EntityReference[];
+    relatedQueryIds: string[];
+    confidence: number;
+    reasoning?: string;
+}
+/**
+ * Phase 2: SQL Generation - detailed SQL implementation for a single query
+ */
+export interface QuerySQL {
+    sqlQuery: string;
+    parameters: QueryParameter[];
+    sampleResultColumns: ResultColumn[];
+    filteringRules: string[];
+    aggregationRules: string[];
+    joinRules: string[];
+    alignmentNotes?: string;
+}
+/**
+ * Complete sample query combining plan + SQL + execution results
+ */
+export interface SampleQuery {
+    /** Unique identifier for this query */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detailed description of what this query does */
+    description: string;
+    /** Business purpose and use case */
+    businessPurpose: string;
+    /** Schema this query belongs to */
+    schema: string;
+    /** Entity context */
+    primaryEntities: EntityReference[];
+    relatedEntities: EntityReference[];
+    /** Query metadata */
+    queryType: QueryType;
+    queryPattern: QueryPattern;
+    complexity: QueryComplexity;
+    /** The actual SQL query */
+    sqlQuery: string;
+    /** Query parameters */
+    parameters: QueryParameter[];
+    /** Results documentation */
+    sampleResultColumns: ResultColumn[];
+    sampleResultRows: Record<string, unknown>[];
+    expectedRowCount?: RowCountRange;
+    /** Business logic documentation */
+    filteringRules: string[];
+    aggregationRules: string[];
+    joinRules: string[];
+    /** For multi-query alignment */
+    relatedQueries?: string[];
+    alignmentNotes?: string;
+    /** Execution metadata */
+    executionTime?: number;
+    validated: boolean;
+    validationError?: string;
+    /** Generation metadata */
+    generatedAt: string;
+    confidence: number;
+    modelUsed: string;
+    reasoning?: string;
+}
+export interface EntityReference {
+    schema: string;
+    table: string;
+    alias?: string;
+}
+export type QueryType = 'aggregation' | 'filter' | 'join' | 'detail' | 'summary' | 'ranking' | 'time-series' | 'drill-down';
+export type QueryPattern = 'simple-select' | 'filtered-select' | 'aggregation-group-by' | 'time-series-aggregation' | 'join-detail' | 'left-join-counts' | 'drill-down-detail' | 'ranking-top-n' | 'multi-level-aggregation';
+export type QueryComplexity = 'simple' | 'moderate' | 'complex';
+export interface QueryParameter {
+    name: string;
+    dataType: string;
+    description: string;
+    required: boolean;
+    defaultValue?: string;
+    exampleValues: string[];
+}
+export interface ResultColumn {
+    name: string;
+    dataType: string;
+    description: string;
+    isMeasure: boolean;
+    isDimension: boolean;
+}
+export interface RowCountRange {
+    min: number;
+    max: number;
+    typical: number;
+}
+export interface SampleQueryGenerationResult {
+    success: boolean;
+    queries: SampleQuery[];
+    summary: SampleQueryGenerationSummary;
+    errorMessage?: string;
+}
+export interface SampleQueryGenerationSummary {
+    totalQueriesGenerated: number;
+    queriesValidated: number;
+    queriesFailed: number;
+    totalExecutionTime: number;
+    tokensUsed: number;
+    estimatedCost: number;
+    averageConfidence: number;
+    queriesByType: Record<QueryType, number>;
+    queriesByPattern: Record<QueryPattern, number>;
+    queriesByComplexity: Record<QueryComplexity, number>;
+}
+export interface SampleQueryGenerationConfig {
+    enabled: boolean;
+    queriesPerTable: number;
+    maxExecutionTime: number;
+    includeMultiQueryPatterns: boolean;
+    validateAlignment: boolean;
+    tokenBudget: number;
+    queryTypes?: QueryType[];
+    maxRowsInSample: number;
+    maxTables?: number;
+}
+export interface QueryGenerationContext {
+    schema: string;
+    tables: TableContext[];
+    existingQueries: SampleQuery[];
+}
+export interface TableContext {
+    name: string;
+    description?: string;
+    rowCount: number;
+    columns: ColumnContext[];
+    primaryKeys: string[];
+    foreignKeys: ForeignKeyContext[];
+    dependents: string[];
+}
+export interface ColumnContext {
+    name: string;
+    dataType: string;
+    description?: string;
+    isPrimaryKey: boolean;
+    isForeignKey: boolean;
+    isNullable: boolean;
+    possibleValues?: unknown[];
+    statistics?: {
+        distinctCount?: number;
+        min?: unknown;
+        max?: unknown;
+        avg?: number;
+    };
+}
+export interface ForeignKeyContext {
+    column: string;
+    referencesSchema: string;
+    referencesTable: string;
+    referencesColumn: string;
+}
+//# sourceMappingURL=sample-queries.d.ts.map

package/dist/types/sample-queries.d.ts.map

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

package/dist/types/sample-queries.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Sample query generation types for DBAutoDoc
+ * These queries serve as reference implementations for AI agents like Skip
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=sample-queries.js.map

package/dist/types/sample-queries.js.map

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

package/dist/types/state.d.ts

@@ -0,0 +1,291 @@
+/**
+ * State file format for DBAutoDoc
+ * Tracks all documentation, iterations, and analysis progress
+ */
+import { RelationshipDiscoveryPhase, CachedColumnStats } from './discovery.js';
+import { SampleQuery, SampleQueryGenerationSummary } from './sample-queries.js';
+export interface DatabaseDocumentation {
+    version: string;
+    summary: AnalysisSummary;
+    database: DatabaseInfo;
+    seedContext?: SeedContext;
+    phases: AnalysisPhases;
+    schemas: SchemaDefinition[];
+    resumedFromFile?: string;
+}
+/**
+ * Summary of analysis with timing and high-level metrics
+ * Moved timing fields from top-level DatabaseDocumentation here
+ */
+export interface AnalysisSummary {
+    createdAt: string;
+    lastModified: string;
+    totalIterations: number;
+    totalPromptsRun: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalTokens: number;
+    estimatedCost: number;
+    totalSchemas: number;
+    totalTables: number;
+    totalColumns: number;
+}
+export interface DatabaseInfo {
+    name: string;
+    server: string;
+    analyzedAt: string;
+}
+export interface SeedContext {
+    overallPurpose?: string;
+    businessDomains?: string[];
+    customInstructions?: string;
+    industryContext?: string;
+}
+/**
+ * Multi-phase workflow organization
+ * Each phase is optional and tracked separately
+ */
+export interface AnalysisPhases {
+    keyDetection?: RelationshipDiscoveryPhase;
+    descriptionGeneration: AnalysisRun[];
+    sampleQueryGeneration?: SampleQueryGenerationPhase;
+}
+/**
+ * Sample query generation phase results
+ */
+export interface SampleQueryGenerationPhase {
+    startedAt: string;
+    completedAt?: string;
+    status: 'running' | 'completed' | 'failed';
+    queries: SampleQuery[];
+    summary: SampleQueryGenerationSummary;
+    errorMessage?: string;
+}
+export interface SchemaDefinition {
+    name: string;
+    tables: TableDefinition[];
+    description?: string;
+    descriptionIterations: DescriptionIteration[];
+    inferredPurpose?: string;
+    businessDomains?: string[];
+}
+export interface TableDefinition {
+    name: string;
+    rowCount: number;
+    dependencyLevel?: number;
+    dependsOn: ForeignKeyReference[];
+    dependents: ForeignKeyReference[];
+    columns: ColumnDefinition[];
+    description?: string;
+    descriptionIterations: DescriptionIteration[];
+    userNotes?: string;
+    userDescription?: string;
+    userApproved?: boolean;
+}
+export interface ColumnDefinition {
+    name: string;
+    dataType: string;
+    isNullable: boolean;
+    isPrimaryKey: boolean;
+    isForeignKey: boolean;
+    foreignKeyReferences?: ForeignKeyReference;
+    checkConstraint?: string;
+    defaultValue?: string;
+    possibleValues?: any[];
+    statistics?: ColumnStatistics;
+    description?: string;
+    descriptionIterations: DescriptionIteration[];
+}
+export interface ForeignKeyReference {
+    schema: string;
+    table: string;
+    column: string;
+    referencedColumn: string;
+}
+/**
+ * Column statistics merged from both discovery cache and description analysis
+ * Replaces separate ColumnStatisticsCache - now embedded in column definitions
+ */
+export interface ColumnStatistics {
+    totalRows: number;
+    distinctCount: number;
+    uniquenessRatio: number;
+    nullCount: number;
+    nullPercentage: number;
+    dataPattern?: 'sequential' | 'guid' | 'composite' | 'natural' | 'unknown';
+    sampleValues: any[];
+    valueDistribution?: Array<{
+        value: string | number;
+        frequency: number;
+    }>;
+    min?: any;
+    max?: any;
+    minValue?: string | number;
+    maxValue?: string | number;
+    avg?: number;
+    stdDev?: number;
+    median?: number;
+    percentiles?: {
+        p25: number;
+        p50: number;
+        p75: number;
+        p95: number;
+    };
+    avgLength?: number;
+    maxLength?: number;
+    minLength?: number;
+    commonPrefixes?: string[];
+    formatPattern?: string;
+    containsUrls?: boolean;
+    containsEmails?: boolean;
+    containsPhones?: boolean;
+    computedAt?: string;
+    queryTimeMs?: number;
+}
+export interface DescriptionIteration {
+    description: string;
+    reasoning: string;
+    generatedAt: string;
+    modelUsed: string;
+    confidence?: number;
+    triggeredBy?: 'initial' | 'backpropagation' | 'refinement' | 'dependency_sanity_check' | 'schema_sanity_check' | 'cross_schema_sanity_check';
+    changedFrom?: string;
+}
+export interface AnalysisRun {
+    runId: string;
+    startedAt: string;
+    completedAt?: string;
+    status: 'in_progress' | 'completed' | 'failed' | 'converged';
+    levelsProcessed: number;
+    iterationsPerformed: number;
+    backpropagationCount: number;
+    sanityCheckCount: number;
+    converged: boolean;
+    convergenceReason?: string;
+    modelUsed: string;
+    vendor: string;
+    temperature: number;
+    topP?: number;
+    topK?: number;
+    totalTokensUsed: number;
+    estimatedCost: number;
+    warnings: string[];
+    errors: string[];
+    processingLog: ProcessingLogEntry[];
+    sanityChecks: SanityCheckRecord[];
+    resumedFromFile?: string;
+    resumedAt?: string;
+    phaseMetrics?: PhaseMetrics;
+    iterationMetrics?: IterationMetrics[];
+    guardrailsEnforced?: GuardrailEnforcement;
+}
+/**
+ * Per-phase token and cost metrics for granular guardrail enforcement
+ */
+export interface PhaseMetrics {
+    discovery?: PhaseMetric;
+    analysis?: PhaseMetric;
+    sanityChecks?: PhaseMetric;
+}
+export interface PhaseMetric {
+    startedAt: string;
+    completedAt?: string;
+    tokensUsed: number;
+    estimatedCost: number;
+    warned?: boolean;
+    exceeded?: boolean;
+}
+/**
+ * Per-iteration metrics for detecting iteration-level resource exhaustion
+ */
+export interface IterationMetrics {
+    iterationNumber: number;
+    startedAt: string;
+    completedAt?: string;
+    tokensUsed: number;
+    estimatedCost: number;
+    duration: number;
+    warned?: boolean;
+}
+/**
+ * Information about guardrails that were enforced or triggered
+ */
+export interface GuardrailEnforcement {
+    exceedances: GuardrailExceeded[];
+    warnings: GuardrailWarning[];
+    stoppedDueToGuardrails?: boolean;
+    stoppedReason?: string;
+}
+export interface GuardrailExceeded {
+    type: 'tokens_per_run' | 'tokens_per_phase' | 'tokens_per_iteration' | 'duration' | 'cost' | 'iteration_duration';
+    phase?: string;
+    iteration?: number;
+    limit: number;
+    actual: number;
+    unit: string;
+}
+export interface GuardrailWarning {
+    type: string;
+    phase?: string;
+    iteration?: number;
+    percentage: number;
+    message: string;
+}
+export interface ProcessingLogEntry {
+    timestamp: string;
+    level: number;
+    schema: string;
+    table: string;
+    action: 'analyze' | 'backpropagate' | 'dependency_sanity_check' | 'schema_sanity_check' | 'cross_schema_sanity_check';
+    result: 'success' | 'changed' | 'unchanged' | 'error';
+    message?: string;
+    tokensUsed?: number;
+    promptInput?: string;
+    promptOutput?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    semanticComparison?: {
+        tableMateriallyChanged: boolean;
+        tableChangeReasoning: string;
+        columnChanges: Array<{
+            columnName: string;
+            materiallyChanged: boolean;
+            changeReasoning: string;
+        }>;
+    };
+}
+export interface SanityCheckRecord {
+    timestamp: string;
+    checkType: 'dependency_level' | 'schema_level' | 'cross_schema';
+    scope: string;
+    hasMaterialIssues: boolean;
+    issuesFound: number;
+    tablesAffected: string[];
+    result: 'no_issues' | 'issues_corrected' | 'issues_flagged';
+    tokensUsed: number;
+    promptInput?: string;
+    promptOutput?: string;
+}
+/**
+ * DEPRECATED: ColumnStatisticsCache is no longer used
+ * Statistics are now embedded directly in ColumnDefinition.statistics
+ * This type remains for backward compatibility with old state files
+ */
+export interface ColumnStatisticsCache {
+    computedAt: string;
+    totalSchemas: number;
+    totalTables: number;
+    totalColumns: number;
+    tables: Record<string, TableStatisticsEntry>;
+}
+/**
+ * DEPRECATED: TableStatisticsEntry is no longer used
+ * This type remains for backward compatibility with old state files
+ */
+export interface TableStatisticsEntry {
+    schemaName: string;
+    tableName: string;
+    totalRows: number;
+    columns: CachedColumnStats[];
+}
+//# sourceMappingURL=state.d.ts.map

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

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

package/dist/types/state.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * State file format for DBAutoDoc
+ * Tracks all documentation, iterations, and analysis progress
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=state.js.map

package/dist/types/state.js.map

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

package/dist/utils/config-loader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Configuration loading utilities
+ */
+import { DBAutoDocConfig } from '../types/config.js';
+export declare class ConfigLoader {
+    /**
+     * Load configuration from file
+     * Supports environment variable expansion using ${ENV_VAR} syntax
+     */
+    static load(configPath: string): Promise<DBAutoDocConfig>;
+    /**
+     * Expand environment variables in string
+     * Supports ${VAR_NAME} syntax
+     */
+    private static expandEnvVars;
+    /**
+     * Save configuration to file
+     */
+    static save(config: DBAutoDocConfig, configPath: string): Promise<void>;
+    /**
+     * Create default configuration
+     */
+    static createDefault(): DBAutoDocConfig;
+    /**
+     * Validate configuration
+     */
+    private static validate;
+}
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/utils/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,qBAAa,YAAY;IACvB;;;OAGG;WACiB,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAkBtE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAU5B;;OAEG;WACiB,IAAI,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpF;;OAEG;WACW,aAAa,IAAI,eAAe;IAuD9C;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ;CA6BxB"}