@memberjunction/db-auto-doc 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/plugins/index-advisor/IndexAdvisorTypes.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Types for the Index Advisor plugin's options and its section of the state file.
+ */
+import type { AutoDocIndex } from '../../types/driver.js';
+/** Where a proposal came from. */
+export type IndexProposalSource = 'FKCoverage' | 'SoftPrimaryKey' | 'LLM';
+/** A proposed new index. */
+export interface IndexProposal {
+    SchemaName: string;
+    TableName: string;
+    /** Key columns, in index order. */
+    Columns: string[];
+    /** Non-key covering columns (SQL Server / PostgreSQL INCLUDE). */
+    IncludeColumns: string[];
+    Source: IndexProposalSource;
+    Reason: string;
+    /** 1 (low) – 100 (high); larger tables score higher. */
+    Priority: number;
+    Evidence: IndexProposalEvidence;
+}
+export interface IndexProposalEvidence {
+    RowCount: number;
+    /** Distinct values of the leading column, when column statistics are available. */
+    LeadingColumnDistinctCount?: number;
+    /** `schema.table.column` the foreign key points at (FK coverage proposals). */
+    References?: string;
+    /** Confidence of the discovered key that motivated the proposal (0–100). */
+    KeyConfidence?: number;
+    /** Whether the motivating key is declared in the database or was discovered. */
+    KeyOrigin?: 'declared' | 'discovered';
+}
+/** An existing index whose job another index already does. Reported only; never dropped. */
+export interface RedundantIndex {
+    SchemaName: string;
+    TableName: string;
+    IndexName: string;
+    CoveredBy: string;
+    Reason: string;
+}
+/** Index Advisor options from the config file (`plugins[].Options`). */
+export interface IndexAdvisorOptions {
+    /** Tables with fewer rows get no proposals. Default 1000. */
+    MinRowCount: number;
+    /** Also index discovered (not just declared) foreign keys. Default true. */
+    IncludeDiscoveredFKs: boolean;
+    /** Minimum confidence for a discovered key to be used. Default 90. */
+    KeyMinConfidence: number;
+    /** Run the LLM review layer. Default true. */
+    LLMReview: boolean;
+    /** Most tables the LLM review looks at (largest first). Default 40. */
+    MaxLLMTables: number;
+    /** PostgreSQL: emit CREATE INDEX CONCURRENTLY (no write lock while building; runs outside a transaction). Default true. */
+    Concurrently: boolean;
+}
+/** The plugin's section of the state file (`state.plugins.IndexAdvisor.Data`). */
+export interface IndexAdvisorData {
+    AnalyzedAt: string;
+    Options: IndexAdvisorOptions;
+    Existing: AutoDocIndex[];
+    Proposed: IndexProposal[];
+    Redundant: RedundantIndex[];
+    /** Schemas whose existing indexes could not be read (proposals for them are skipped). */
+    SkippedSchemas: {
+        SchemaName: string;
+        Error: string;
+    }[];
+    /** What the LLM review did. Absent when the review was off. */
+    LLMReview?: IndexLLMReviewSummary;
+}
+/** Outcome of the LLM review layer. */
+export interface IndexLLMReviewSummary {
+    Model: string;
+    TablesReviewed: number;
+    TokensUsed: number;
+    /** Rule-based proposals the review removed, with its reason. */
+    Dropped: {
+        Proposal: IndexProposal;
+        Reason: string;
+    }[];
+    /** LLM suggestions that failed validation and were not applied. */
+    Rejected: {
+        TableName: string;
+        Columns: string[];
+        Why: string;
+    }[];
+    /** Tables whose review call failed; their rule-based proposals were kept unchanged. */
+    Errors: {
+        TableName: string;
+        Error: string;
+    }[];
+}
+/** One proposal decision the LLM returns. `Proposal` is the 1-based number shown in the prompt. */
+export interface IndexReviewDecision {
+    Proposal: number;
+    Action: 'keep' | 'drop' | 'modify';
+    Columns?: string[];
+    IncludeColumns?: string[];
+    Reason: string;
+}
+/** A new index the LLM suggests. */
+export interface IndexReviewAddition {
+    Columns: string[];
+    IncludeColumns?: string[];
+    Reason: string;
+}
+/** The LLM's full response for one table. */
+export interface IndexReviewResponse {
+    Decisions: IndexReviewDecision[];
+    Additions: IndexReviewAddition[];
+}
+//# sourceMappingURL=IndexAdvisorTypes.d.ts.map

package/dist/plugins/index-advisor/IndexAdvisorTypes.d.ts.map

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

package/dist/plugins/index-advisor/IndexAdvisorTypes.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the Index Advisor plugin's options and its section of the state file.
+ */
+export {};
+//# sourceMappingURL=IndexAdvisorTypes.js.map

package/dist/plugins/index-advisor/IndexAdvisorTypes.js.map

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

package/dist/plugins/index-advisor/IndexLLMReview.d.ts

@@ -0,0 +1,48 @@
+/**
+ * LLM review layer for the Index Advisor.
+ *
+ * Per table, the model sees the rule-based proposals plus the context DBAutoDoc built (column
+ * statistics, descriptions, existing indexes, sample queries) and may keep, drop or modify each
+ * proposal and suggest new ones. The model returns structured decisions, never SQL; every
+ * suggestion is validated deterministically before it is applied.
+ */
+import { PromptEngine } from '../../prompts/PromptEngine.js';
+import type { AIConfig } from '../../types/config.js';
+import type { DatabaseDocumentation, TableDefinition } from '../../types/state.js';
+import type { AutoDocIndex } from '../../types/driver.js';
+import type { IndexAdvisorData, IndexLLMReviewSummary, IndexProposal, IndexReviewResponse } from './IndexAdvisorTypes.js';
+/** A table chosen for review. */
+export interface IndexReviewTarget {
+    SchemaName: string;
+    Table: TableDefinition;
+}
+/** Result of applying one table's review response. */
+export interface IndexReviewApplyResult {
+    Proposals: IndexProposal[];
+    Dropped: IndexLLMReviewSummary['Dropped'];
+    Rejected: IndexLLMReviewSummary['Rejected'];
+}
+export declare class IndexLLMReviewer {
+    private promptEngine;
+    private ai;
+    private log;
+    constructor(promptEngine: PromptEngine, ai: AIConfig, log: (message: string) => void);
+    /** Creates a reviewer with its own prompt engine over the package's prompt templates. */
+    static Create(ai: AIConfig, log: (message: string) => void): Promise<IndexLLMReviewer>;
+    /** Reviews the selected tables and returns the revised proposal list plus a summary. */
+    Review(state: DatabaseDocumentation, data: IndexAdvisorData, platform: string): Promise<{
+        Proposals: IndexProposal[];
+        Summary: IndexLLMReviewSummary;
+    }>;
+    private reviewTable;
+}
+/**
+ * Tables worth reviewing: large enough, and either carrying a rule-based proposal or used by a
+ * sample query. Largest first, capped at MaxLLMTables.
+ */
+export declare function SelectReviewTables(state: DatabaseDocumentation, data: IndexAdvisorData): IndexReviewTarget[];
+/** Template context for `prompts/index-review.md`. */
+export declare function BuildReviewContext(state: DatabaseDocumentation, target: IndexReviewTarget, proposals: IndexProposal[], existing: AutoDocIndex[], platform: string): object;
+/** Applies one table's review response, validating every change. Pure; no LLM involved. */
+export declare function ApplyReviewResponse(target: IndexReviewTarget, proposals: IndexProposal[], existing: AutoDocIndex[], response: IndexReviewResponse): IndexReviewApplyResult;
+//# sourceMappingURL=IndexLLMReview.d.ts.map

package/dist/plugins/index-advisor/IndexLLMReview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexLLMReview.d.ts","sourceRoot":"","sources":["../../../src/plugins/index-advisor/IndexLLMReview.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAUhC,iCAAiC;AACjC,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC1C,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,CAAC;CAC7C;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,GAAG;gBAFH,YAAY,EAAE,YAAY,EAC1B,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IAGxC,yFAAyF;WACrE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOnG,wFAAwF;IAC3E,MAAM,CACjB,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,SAAS,EAAE,aAAa,EAAE,CAAC;QAAC,OAAO,EAAE,qBAAqB,CAAA;KAAE,CAAC;YAY5D,WAAW;CA6B1B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,EAAE,CAY5G;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,YAAY,EAAE,EACxB,QAAQ,EAAE,MAAM,GACf,MAAM,CAqBR;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,YAAY,EAAE,EACxB,QAAQ,EAAE,mBAAmB,GAC5B,sBAAsB,CAaxB"}

package/dist/plugins/index-advisor/IndexLLMReview.js

@@ -0,0 +1,181 @@
+/**
+ * LLM review layer for the Index Advisor.
+ *
+ * Per table, the model sees the rule-based proposals plus the context DBAutoDoc built (column
+ * statistics, descriptions, existing indexes, sample queries) and may keep, drop or modify each
+ * proposal and suggest new ones. The model returns structured decisions, never SQL; every
+ * suggestion is validated deterministically before it is applied.
+ */
+import * as path from 'path';
+import { fileURLToPath } from 'node:url';
+import { PromptEngine } from '../../prompts/PromptEngine.js';
+import { IsCovered, IsPoorKeyColumn, IndexPriority } from './IndexRules.js';
+const MAX_KEY_COLUMNS = 5;
+const MAX_INCLUDE_COLUMNS = 10;
+const MAX_SAMPLE_QUERIES = 3;
+const MAX_SQL_CHARS = 1500;
+const MODEL_OVERRIDE_KEY = 'indexAdvisor';
+const lower = (s) => s.toLowerCase();
+export class IndexLLMReviewer {
+    constructor(promptEngine, ai, log) {
+        this.promptEngine = promptEngine;
+        this.ai = ai;
+        this.log = log;
+    }
+    /** Creates a reviewer with its own prompt engine over the package's prompt templates. */
+    static async Create(ai, log) {
+        const promptsDir = path.join(path.dirname(fileURLToPath(import.meta.url)), '../../../prompts');
+        const engine = new PromptEngine(ai, promptsDir);
+        await engine.Initialize();
+        return new IndexLLMReviewer(engine, ai, log);
+    }
+    /** Reviews the selected tables and returns the revised proposal list plus a summary. */
+    async Review(state, data, platform) {
+        const override = this.ai.modelOverrides?.[MODEL_OVERRIDE_KEY];
+        const summary = {
+            Model: override?.model ?? this.ai.model, TablesReviewed: 0, TokensUsed: 0, Dropped: [], Rejected: [], Errors: []
+        };
+        let proposals = [...data.Proposed];
+        for (const target of SelectReviewTables(state, data)) {
+            proposals = await this.reviewTable(state, data, target, platform, proposals, summary);
+        }
+        return { Proposals: proposals.sort((a, b) => b.Priority - a.Priority), Summary: summary };
+    }
+    async reviewTable(state, data, target, platform, proposals, summary) {
+        const isThisTable = (p) => sameTable(p, target);
+        const tableProposals = proposals.filter(isThisTable);
+        const existing = data.Existing.filter((ix) => sameTable(ix, target));
+        const override = this.ai.modelOverrides?.[MODEL_OVERRIDE_KEY];
+        const result = await this.promptEngine.ExecutePrompt('index-review', BuildReviewContext(state, target, tableProposals, existing, platform), { responseFormat: 'JSON', temperature: override?.temperature ?? 0.1, maxTokens: override?.maxTokens ?? this.ai.maxTokens, modelOverride: override?.model, effortLevelOverride: override?.effortLevel });
+        summary.TablesReviewed++;
+        summary.TokensUsed += result.tokensUsed;
+        if (!result.success || !result.result) {
+            summary.Errors.push({ TableName: target.Table.name, Error: result.errorMessage ?? 'empty response' });
+            this.log(`Index Advisor review failed for ${target.SchemaName}.${target.Table.name} (keeping rule-based proposals)`);
+            return proposals;
+        }
+        const applied = ApplyReviewResponse(target, tableProposals, existing, result.result);
+        summary.Dropped.push(...applied.Dropped);
+        summary.Rejected.push(...applied.Rejected);
+        return [...proposals.filter((p) => !isThisTable(p)), ...applied.Proposals];
+    }
+}
+/**
+ * Tables worth reviewing: large enough, and either carrying a rule-based proposal or used by a
+ * sample query. Largest first, capped at MaxLLMTables.
+ */
+export function SelectReviewTables(state, data) {
+    const wanted = new Set([
+        ...data.Proposed.map((p) => tableId(p.SchemaName, p.TableName)),
+        ...(state.sampleQueries?.queries ?? []).flatMap((q) => [...q.primaryEntities, ...q.relatedEntities].map((e) => tableId(e.schema, e.table)))
+    ]);
+    const skipped = new Set(data.SkippedSchemas.map((s) => lower(s.SchemaName)));
+    return state.schemas
+        .filter((s) => !skipped.has(lower(s.name)))
+        .flatMap((s) => s.tables.map((t) => ({ SchemaName: s.name, Table: t })))
+        .filter((t) => t.Table.rowCount >= data.Options.MinRowCount && wanted.has(tableId(t.SchemaName, t.Table.name)))
+        .sort((a, b) => b.Table.rowCount - a.Table.rowCount)
+        .slice(0, data.Options.MaxLLMTables);
+}
+/** Template context for `prompts/index-review.md`. */
+export function BuildReviewContext(state, target, proposals, existing, platform) {
+    const t = target.Table;
+    return {
+        platform,
+        table: { schema: target.SchemaName, name: t.name, rowCount: t.rowCount, description: t.description ?? '' },
+        columns: t.columns.map((c) => ({
+            name: c.name,
+            dataType: c.dataType,
+            distinctCount: c.statistics?.distinctCount ?? null,
+            nullPercentage: c.statistics ? Math.round(c.statistics.nullPercentage) : null,
+            description: (c.description ?? '').slice(0, 160)
+        })),
+        existing: existing.map((ix) => ({
+            name: ix.IndexName, columns: ix.Columns, include: ix.IncludeColumns, isUnique: ix.IsUnique, isPrimaryKey: ix.IsPrimaryKey, filter: ix.FilterDefinition ?? ''
+        })),
+        proposals: proposals.map((p) => ({ columns: p.Columns, reason: p.Reason })),
+        sampleQueries: (state.sampleQueries?.queries ?? [])
+            .filter((q) => [...q.primaryEntities, ...q.relatedEntities].some((e) => tableId(e.schema, e.table) === tableId(target.SchemaName, t.name)))
+            .slice(0, MAX_SAMPLE_QUERIES)
+            .map((q) => ({ name: q.name, sql: q.sqlQuery.slice(0, MAX_SQL_CHARS) }))
+    };
+}
+/** Applies one table's review response, validating every change. Pure; no LLM involved. */
+export function ApplyReviewResponse(target, proposals, existing, response) {
+    const out = { Proposals: [], Dropped: [], Rejected: [] };
+    const decisions = new Map((Array.isArray(response.Decisions) ? response.Decisions : []).map((d) => [d.Proposal, d]));
+    proposals.forEach((proposal, i) => applyDecision(target, proposal, decisions.get(i + 1), existing, out));
+    for (const addition of Array.isArray(response.Additions) ? response.Additions : []) {
+        const candidate = {
+            SchemaName: target.SchemaName, TableName: target.Table.name, Columns: addition.Columns ?? [], IncludeColumns: addition.IncludeColumns ?? [],
+            Source: 'LLM', Reason: addition.Reason ?? '', Priority: Math.max(1, IndexPriority(target.Table.rowCount) - 5),
+            Evidence: { RowCount: target.Table.rowCount }
+        };
+        acceptIfValid(target, candidate, existing, out);
+    }
+    return out;
+}
+function applyDecision(target, proposal, decision, existing, out) {
+    if (decision?.Action === 'drop' && decision.Reason) {
+        out.Dropped.push({ Proposal: proposal, Reason: decision.Reason });
+        return;
+    }
+    if (decision?.Action === 'modify') {
+        const modified = {
+            ...proposal,
+            Columns: decision.Columns ?? proposal.Columns,
+            IncludeColumns: decision.IncludeColumns ?? proposal.IncludeColumns,
+            Reason: `${proposal.Reason} Adjusted by review: ${decision.Reason}`
+        };
+        if (acceptIfValid(target, modified, existing, out)) {
+            return;
+        }
+    }
+    // keep, no decision, or an invalid modification: the rule-based proposal stands
+    acceptIfValid(target, proposal, existing, out);
+}
+/** Validates a proposal against the table and what is already planned; records rejections. */
+function acceptIfValid(target, p, existing, out) {
+    const why = validate(target, p, existing, out.Proposals);
+    if (why) {
+        out.Rejected.push({ TableName: target.Table.name, Columns: p.Columns, Why: why });
+        return false;
+    }
+    out.Proposals.push({ ...p, Columns: canonical(target.Table, p.Columns), IncludeColumns: canonical(target.Table, p.IncludeColumns) });
+    return true;
+}
+function validate(target, p, existing, planned) {
+    const columns = p.Columns ?? [];
+    const include = p.IncludeColumns ?? [];
+    const unknown = [...columns, ...include].filter((c) => !findColumn(target.Table, c));
+    if (columns.length === 0 || columns.length > MAX_KEY_COLUMNS)
+        return `needs 1–${MAX_KEY_COLUMNS} key columns`;
+    if (include.length > MAX_INCLUDE_COLUMNS)
+        return `too many INCLUDE columns`;
+    if (unknown.length)
+        return `unknown column(s): ${unknown.join(', ')}`;
+    if (new Set(columns.map(lower)).size !== columns.length)
+        return 'repeats a key column';
+    if (include.some((c) => columns.some((k) => lower(k) === lower(c))))
+        return 'INCLUDE repeats a key column';
+    if (IsPoorKeyColumn(findColumn(target.Table, columns[0])))
+        return `leading column ${columns[0]} is a poor index key`;
+    if (IsCovered(columns, existing))
+        return 'an existing index already starts with these columns';
+    if (planned.some((q) => q.Columns.length === columns.length && q.Columns.every((c, i) => lower(c) === lower(columns[i]))))
+        return 'duplicates another proposal';
+    return null;
+}
+function findColumn(table, name) {
+    return table.columns.find((c) => lower(c.name) === lower(name));
+}
+function canonical(table, names) {
+    return names.map((n) => findColumn(table, n)?.name ?? n);
+}
+function sameTable(item, target) {
+    return lower(item.SchemaName) === lower(target.SchemaName) && lower(item.TableName) === lower(target.Table.name);
+}
+function tableId(schema, table) {
+    return `${lower(schema)}.${lower(table)}`;
+}
+//# sourceMappingURL=IndexLLMReview.js.map

package/dist/plugins/index-advisor/IndexLLMReview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexLLMReview.js","sourceRoot":"","sources":["../../../src/plugins/index-advisor/IndexLLMReview.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQ5E,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAC/B,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAE1C,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAe7C,MAAM,OAAO,gBAAgB;IAC3B,YACU,YAA0B,EAC1B,EAAY,EACZ,GAA8B;QAF9B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,OAAE,GAAF,EAAE,CAAU;QACZ,QAAG,GAAH,GAAG,CAA2B;IACrC,CAAC;IAEJ,yFAAyF;IAClF,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAY,EAAE,GAA8B;QACrE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAC/F,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAChD,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,wFAAwF;IACjF,KAAK,CAAC,MAAM,CACjB,KAA4B,EAC5B,IAAsB,EACtB,QAAgB;QAEhB,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,kBAAkB,CAAC,CAAC;QAC9D,MAAM,OAAO,GAA0B;YACrC,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;SACjH,CAAC;QACF,IAAI,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACrD,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC5F,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,KAA4B,EAC5B,IAAsB,EACtB,MAAyB,EACzB,QAAgB,EAChB,SAA0B,EAC1B,OAA8B;QAE9B,MAAM,WAAW,GAAG,CAAC,CAAgB,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/D,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,kBAAkB,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAClD,cAAc,EACd,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,CAAC,EACrE,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,WAAW,EAAE,CACvM,CAAC;QACF,OAAO,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACtC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,gBAAgB,EAAE,CAAC,CAAC;YACtG,IAAI,CAAC,GAAG,CAAC,mCAAmC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,iCAAiC,CAAC,CAAC;YACrH,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACrF,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7E,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA4B,EAAE,IAAsB;IACrF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAS;QAC7B,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;KAC5I,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,OAAO;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;SAC1C,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;SACvE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;SAC9G,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;SACnD,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AACzC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,kBAAkB,CAChC,KAA4B,EAC5B,MAAyB,EACzB,SAA0B,EAC1B,QAAwB,EACxB,QAAgB;IAEhB,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IACvB,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE;QAC1G,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,aAAa,EAAE,CAAC,CAAC,UAAU,EAAE,aAAa,IAAI,IAAI;YAClD,cAAc,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI;YAC7E,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACjD,CAAC,CAAC;QACH,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC,gBAAgB,IAAI,EAAE;SAC7J,CAAC,CAAC;QACH,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3E,aAAa,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,IAAI,EAAE,CAAC;aAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;aAC1I,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,mBAAmB,CACjC,MAAyB,EACzB,SAA0B,EAC1B,QAAwB,EACxB,QAA6B;IAE7B,MAAM,GAAG,GAA2B,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACjF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrH,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IACzG,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACnF,MAAM,SAAS,GAAkB;YAC/B,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,IAAI,EAAE;YAC3I,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC7G,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE;SAC9C,CAAC;QACF,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CACpB,MAAyB,EACzB,QAAuB,EACvB,QAA8D,EAC9D,QAAwB,EACxB,GAA2B;IAE3B,IAAI,QAAQ,EAAE,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACnD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAkB;YAC9B,GAAG,QAAQ;YACX,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;YAC7C,cAAc,EAAE,QAAQ,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;YAClE,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,wBAAwB,QAAQ,CAAC,MAAM,EAAE;SACpE,CAAC;QACF,IAAI,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;YACnD,OAAO;QACT,CAAC;IACH,CAAC;IACD,gFAAgF;IAChF,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,8FAA8F;AAC9F,SAAS,aAAa,CAAC,MAAyB,EAAE,CAAgB,EAAE,QAAwB,EAAE,GAA2B;IACvH,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IACzD,IAAI,GAAG,EAAE,CAAC;QACR,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IACrI,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,MAAyB,EAAE,CAAgB,EAAE,QAAwB,EAAE,OAAwB;IAC/G,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,IAAI,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACrF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe;QAAE,OAAO,WAAW,eAAe,cAAc,CAAC;IAC9G,IAAI,OAAO,CAAC,MAAM,GAAG,mBAAmB;QAAE,OAAO,0BAA0B,CAAC;IAC5E,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,sBAAsB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM;QAAE,OAAO,sBAAsB,CAAC;IACvF,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,8BAA8B,CAAC;IAC3G,IAAI,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAE,CAAC;QAAE,OAAO,kBAAkB,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC;IACtH,IAAI,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,OAAO,qDAAqD,CAAC;IAC/F,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,6BAA6B,CAAC;IAChK,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,KAAsB,EAAE,IAAY;IACtD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,SAAS,CAAC,KAAsB,EAAE,KAAe;IACxD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAAC,IAA+C,EAAE,MAAyB;IAC3F,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnH,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,KAAa;IAC5C,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/plugins/index-advisor/IndexMigrationGenerator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Turns Index Advisor proposals into a dialect-specific, Flyway-style SQL migration.
+ */
+import type { AutoDocExportFile, AutoDocExporterOptions } from '../types.js';
+import type { IndexAdvisorData, IndexProposal } from './IndexAdvisorTypes.js';
+type Provider = AutoDocExporterOptions['Provider'];
+export declare class IndexMigrationGenerator {
+    /** Returns the migration file (plus a Flyway `.conf` when PostgreSQL CONCURRENTLY is on), or nothing when there are no proposals. */
+    Generate(data: IndexAdvisorData, options: AutoDocExporterOptions): AutoDocExportFile[];
+    /**
+     * Index name for a proposal: IX_<table>_<columns>, shortened with a hash suffix when too long.
+     * PostgreSQL index names must be unique per schema, and the readable part is lossy (Order.Line_ID and
+     * Order_Line.ID both give IX_Order_Line_ID), so PostgreSQL names always carry a hash of the exact table and columns.
+     */
+    static IndexName(proposal: Pick<IndexProposal, 'TableName' | 'Columns'>, provider: Provider): string;
+    /** Flattens text onto one line so it cannot end a `--` comment and become executable SQL. */
+    static CommentText(text: string): string;
+    /** yyyyMMddHHmm (UTC) from an ISO timestamp. */
+    static Timestamp(iso: string): string;
+    private buildScript;
+    private statement;
+    /** Quotes an identifier for the platform, doubling any embedded quote character. */
+    static Quote(identifier: string, provider: Provider): string;
+    /** 8-hex-digit FNV-1a hash, used to keep shortened index names unique. */
+    private static hash;
+}
+export {};
+//# sourceMappingURL=IndexMigrationGenerator.d.ts.map

package/dist/plugins/index-advisor/IndexMigrationGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexMigrationGenerator.d.ts","sourceRoot":"","sources":["../../../src/plugins/index-advisor/IndexMigrationGenerator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE9E,KAAK,QAAQ,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;AAOnD,qBAAa,uBAAuB;IAClC,qIAAqI;IAC9H,QAAQ,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB,GAAG,iBAAiB,EAAE;IAc7F;;;;OAIG;WACW,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,SAAS,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAa3G,6FAA6F;WAC/E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI/C,gDAAgD;WAClC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAM5C,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,SAAS;IAmBjB,oFAAoF;WACtE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAWnE,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,IAAI;CAQpB"}

package/dist/plugins/index-advisor/IndexMigrationGenerator.js

@@ -0,0 +1,98 @@
+/**
+ * Turns Index Advisor proposals into a dialect-specific, Flyway-style SQL migration.
+ */
+/** Maximum identifier length per platform. */
+const MAX_IDENTIFIER = { sqlserver: 128, postgresql: 63, mysql: 64 };
+const BASE_NAME = 'dbautodoc_indexes';
+export class IndexMigrationGenerator {
+    /** Returns the migration file (plus a Flyway `.conf` when PostgreSQL CONCURRENTLY is on), or nothing when there are no proposals. */
+    Generate(data, options) {
+        if (data.Proposed.length === 0) {
+            return [];
+        }
+        const concurrently = options.Provider === 'postgresql' && data.Options.Concurrently;
+        const fileName = `${options.FileNamePrefix ?? `V${IndexMigrationGenerator.Timestamp(data.AnalyzedAt)}__`}${BASE_NAME}.sql`;
+        const files = [{ FileName: fileName, Content: this.buildScript(data, options.Provider, concurrently) }];
+        if (concurrently) {
+            // CREATE INDEX CONCURRENTLY cannot run inside a transaction; tell Flyway to run this script without one.
+            files.push({ FileName: `${fileName}.conf`, Content: 'executeInTransaction=false\n' });
+        }
+        return files;
+    }
+    /**
+     * Index name for a proposal: IX_<table>_<columns>, shortened with a hash suffix when too long.
+     * PostgreSQL index names must be unique per schema, and the readable part is lossy (Order.Line_ID and
+     * Order_Line.ID both give IX_Order_Line_ID), so PostgreSQL names always carry a hash of the exact table and columns.
+     */
+    static IndexName(proposal, provider) {
+        const raw = `IX_${proposal.TableName}_${proposal.Columns.join('_')}`.replace(/[^A-Za-z0-9_]/g, '_');
+        const max = MAX_IDENTIFIER[provider];
+        if (provider === 'postgresql') {
+            const suffix = IndexMigrationGenerator.hash(JSON.stringify([proposal.TableName, proposal.Columns]));
+            return `${raw.slice(0, max - 9)}_${suffix}`;
+        }
+        if (raw.length <= max) {
+            return raw;
+        }
+        return `${raw.slice(0, max - 9)}_${IndexMigrationGenerator.hash(raw)}`;
+    }
+    /** Flattens text onto one line so it cannot end a `--` comment and become executable SQL. */
+    static CommentText(text) {
+        return text.replace(/[\r\n\u0085\u2028\u2029]+/g, ' ');
+    }
+    /** yyyyMMddHHmm (UTC) from an ISO timestamp. */
+    static Timestamp(iso) {
+        const d = new Date(iso);
+        const pad = (n) => String(n).padStart(2, '0');
+        return `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}`;
+    }
+    buildScript(data, provider, concurrently) {
+        const header = [
+            `-- Index migration generated by DBAutoDoc Index Advisor (${data.AnalyzedAt}).`,
+            `-- Platform: ${provider}. ${data.Proposed.length} proposed index(es), highest priority first.`,
+            '-- Review before applying. Each index is created only if it does not already exist.',
+            provider === 'mysql' ? '-- MySQL has no CREATE INDEX IF NOT EXISTS; re-running this script fails on indexes that already exist.' : ''
+        ].filter((l) => l.length > 0);
+        const statements = data.Proposed.map((p) => `-- ${p.Source}: ${IndexMigrationGenerator.CommentText(p.Reason)}\n${this.statement(p, provider, concurrently)}`);
+        return `${header.join('\n')}\n\n${statements.join('\n\n')}\n`;
+    }
+    statement(p, provider, concurrently) {
+        const name = IndexMigrationGenerator.IndexName(p, provider);
+        const q = (id) => IndexMigrationGenerator.Quote(id, provider);
+        const table = `${q(p.SchemaName)}.${q(p.TableName)}`;
+        const columns = p.Columns.map(q).join(', ');
+        const include = p.IncludeColumns.length && provider !== 'mysql' ? ` INCLUDE (${p.IncludeColumns.map(q).join(', ')})` : '';
+        switch (provider) {
+            case 'sqlserver':
+                return [
+                    `IF NOT EXISTS (SELECT 1 FROM sys.indexes WHERE name = N'${name}' AND object_id = OBJECT_ID(N'${table.replace(/'/g, "''")}'))`,
+                    `    CREATE NONCLUSTERED INDEX ${q(name)} ON ${table} (${columns})${include};`
+                ].join('\n');
+            case 'postgresql':
+                return `CREATE INDEX ${concurrently ? 'CONCURRENTLY ' : ''}IF NOT EXISTS ${q(name)} ON ${table} (${columns})${include};`;
+            case 'mysql':
+                return `CREATE INDEX ${q(name)} ON ${table} (${columns});`;
+        }
+    }
+    /** Quotes an identifier for the platform, doubling any embedded quote character. */
+    static Quote(identifier, provider) {
+        switch (provider) {
+            case 'sqlserver':
+                return `[${identifier.replace(/]/g, ']]')}]`;
+            case 'postgresql':
+                return `"${identifier.replace(/"/g, '""')}"`;
+            case 'mysql':
+                return `\`${identifier.replace(/`/g, '``')}\``;
+        }
+    }
+    /** 8-hex-digit FNV-1a hash, used to keep shortened index names unique. */
+    static hash(value) {
+        let h = 0x811c9dc5;
+        for (let i = 0; i < value.length; i++) {
+            h ^= value.charCodeAt(i);
+            h = Math.imul(h, 0x01000193);
+        }
+        return (h >>> 0).toString(16).padStart(8, '0');
+    }
+}
+//# sourceMappingURL=IndexMigrationGenerator.js.map

package/dist/plugins/index-advisor/IndexMigrationGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexMigrationGenerator.js","sourceRoot":"","sources":["../../../src/plugins/index-advisor/IndexMigrationGenerator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,8CAA8C;AAC9C,MAAM,cAAc,GAA6B,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAE/F,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAEtC,MAAM,OAAO,uBAAuB;IAClC,qIAAqI;IAC9H,QAAQ,CAAC,IAAsB,EAAE,OAA+B;QACrE,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,KAAK,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QACpF,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,uBAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,SAAS,MAAM,CAAC;QAC3H,MAAM,KAAK,GAAwB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;QAC7H,IAAI,YAAY,EAAE,CAAC;YACjB,yGAAyG;YACzG,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,QAAQ,OAAO,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAS,CAAC,QAAsD,EAAE,QAAkB;QAChG,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACpG,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpG,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;QAC9C,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,6FAA6F;IACtF,MAAM,CAAC,WAAW,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,gDAAgD;IACzC,MAAM,CAAC,SAAS,CAAC,GAAW;QACjC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,GAAG,CAAC,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;IAClI,CAAC;IAEO,WAAW,CAAC,IAAsB,EAAE,QAAkB,EAAE,YAAqB;QACnF,MAAM,MAAM,GAAG;YACb,4DAA4D,IAAI,CAAC,UAAU,IAAI;YAC/E,gBAAgB,QAAQ,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,8CAA8C;YAC/F,qFAAqF;YACrF,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,yGAAyG,CAAC,CAAC,CAAC,EAAE;SACtI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;QAC9J,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAChE,CAAC;IAEO,SAAS,CAAC,CAAgB,EAAE,QAAkB,EAAE,YAAqB;QAC3E,MAAM,IAAI,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,IAAI,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1H,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,WAAW;gBACd,OAAO;oBACL,2DAA2D,IAAI,iCAAiC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK;oBAC9H,iCAAiC,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,OAAO,IAAI,OAAO,GAAG;iBAC/E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,KAAK,YAAY;gBACf,OAAO,gBAAgB,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,OAAO,IAAI,OAAO,GAAG,CAAC;YAC3H,KAAK,OAAO;gBACV,OAAO,gBAAgB,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,OAAO,IAAI,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,oFAAoF;IAC7E,MAAM,CAAC,KAAK,CAAC,UAAkB,EAAE,QAAkB;QACxD,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,WAAW;gBACd,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;YAC/C,KAAK,YAAY;gBACf,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;YAC/C,KAAK,OAAO;gBACV,OAAO,KAAK,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;QACnD,CAAC;IACH,CAAC;IAED,0EAA0E;IAClE,MAAM,CAAC,IAAI,CAAC,KAAa;QAC/B,IAAI,CAAC,GAAG,UAAU,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACzB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/plugins/index-advisor/IndexRules.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Deterministic index rules. Pure functions over the state file and the existing indexes,
+ * so they can be tested without a database.
+ */
+import type { DatabaseDocumentation, TableDefinition, ColumnDefinition } from '../../types/state.js';
+import type { AutoDocIndex } from '../../types/driver.js';
+import type { IndexAdvisorOptions, IndexProposal, RedundantIndex } from './IndexAdvisorTypes.js';
+/** Proposes indexes for uncovered foreign keys and discovered primary keys. */
+export declare function ProposeIndexes(state: DatabaseDocumentation, existing: AutoDocIndex[], options: IndexAdvisorOptions): IndexProposal[];
+/** Flags existing indexes whose key columns are a prefix of (or equal to) another index's. */
+export declare function FindRedundantIndexes(existing: AutoDocIndex[]): RedundantIndex[];
+/** True when an index on `table` already starts with exactly these columns. */
+export declare function IsCovered(columns: string[], tableIndexes: AutoDocIndex[]): boolean;
+/** Larger tables benefit most: 1k rows → ~30, 100k → ~50, 10M → ~70, capped at 100. */
+export declare function IndexPriority(rowCount: number): number;
+/** True for columns that make poor leading index keys (large/unstructured types, ≤2 distinct values). */
+export declare function IsPoorKeyColumn(column: ColumnDefinition): boolean;
+export declare function FindTable(state: DatabaseDocumentation, schemaName: string, tableName: string): TableDefinition | undefined;
+//# sourceMappingURL=IndexRules.d.ts.map

package/dist/plugins/index-advisor/IndexRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexRules.d.ts","sourceRoot":"","sources":["../../../src/plugins/index-advisor/IndexRules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACrG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAyB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAiBxH,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,mBAAmB,GAC3B,aAAa,EAAE,CAajB;AAED,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,cAAc,EAAE,CAiB/E;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,OAAO,CAElF;AAkFD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAGjE;AAiCD,wBAAgB,SAAS,CAAC,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAI1H"}