@duckcodeailabs/dql-core 1.6.20 → 1.6.22

package/dist/lineage/derivation.js

@@ -0,0 +1,177 @@
+/**
+ * "Show your work" — consumer-facing derivation walk.
+ *
+ * A derivation walk is the plain-language story of how a single certified (or
+ * generated) answer was produced: the value, the governed block that owns it,
+ * the business terms and metrics/dimensions it draws on, the dbt model/source
+ * it ultimately reads from, and the freshness/owner/review state that makes it
+ * trustworthy.
+ *
+ * It is NOT the raw author lineage graph. It deliberately hides depth: a flat,
+ * ordered list of steps the UI can reveal one level at a time. The structured
+ * payload is assembled entirely from data that already exists —
+ * `queryBusiness360` (businessDefinition / businessComposition /
+ * technicalSources / consumers / gaps / evidence) plus the answer's source
+ * block governance fields — so no lineage is rebuilt and no schema changes.
+ */
+const DEFAULT_MAX_PER_KIND = 3;
+/**
+ * Assemble a consumer-facing derivation walk from an already-computed
+ * `queryBusiness360` result plus the answer's source block. Pure and
+ * synchronous — safe to call from a browser bundle.
+ */
+export function buildDerivationWalk(input) {
+    const { business360, block, value, generated = false } = input;
+    const maxPerKind = input.maxPerKind ?? DEFAULT_MAX_PER_KIND;
+    const focus = business360.focus;
+    const steps = [];
+    // 1) Value — the thing the consumer actually asked about.
+    if (value) {
+        steps.push({
+            kind: 'value',
+            name: value,
+            detail: focus.name ? `Reported by ${focus.name}.` : undefined,
+        });
+    }
+    // 2) Block / business asset that owns the answer.
+    const blockOwner = block?.owner ?? focus.owner;
+    const blockStatus = (block?.status ?? focus.status);
+    const reviewCadence = block?.reviewCadence ?? metadataString(focus.metadata, 'reviewCadence');
+    steps.push({
+        kind: 'block',
+        name: focus.name,
+        owner: blockOwner,
+        status: blockStatus,
+        detail: blockDetail({
+            reviewCadence,
+            businessOutcome: block?.businessOutcome ?? metadataString(focus.metadata, 'businessOutcome'),
+            decisionUse: block?.decisionUse,
+        }),
+    });
+    // 3) Business terms that define the language of the answer.
+    const termAssets = uniqueByName([
+        ...business360.businessDefinition.terms,
+        ...business360.businessDefinition.definedByTerms,
+    ]);
+    for (const term of termAssets.slice(0, maxPerKind)) {
+        if (term.id === focus.id)
+            continue;
+        steps.push({
+            kind: 'term',
+            name: term.name,
+            owner: term.owner,
+            detail: 'Business term this answer is defined in.',
+        });
+    }
+    // 4) Metrics / dimensions referenced by the block (semantic layer).
+    for (const metric of dedupeNames(block?.metricRefs).slice(0, maxPerKind)) {
+        steps.push({ kind: 'metric', name: metric, detail: 'Governed metric used in the calculation.' });
+    }
+    for (const dimension of dedupeNames(block?.dimensionRefs).slice(0, maxPerKind)) {
+        steps.push({ kind: 'dimension', name: dimension, detail: 'Dimension used to slice the value.' });
+    }
+    // 5) dbt models / sources — the technical floor of the trust chain.
+    for (const model of business360.technicalSources.dbtModels.slice(0, maxPerKind)) {
+        steps.push({
+            kind: 'model',
+            name: model.name,
+            detail: 'dbt model the certified SQL builds on.',
+        });
+    }
+    const sourceAssets = uniqueByName([
+        ...business360.technicalSources.dbtSources,
+        ...business360.technicalSources.sourceTables,
+    ]);
+    for (const source of sourceAssets.slice(0, maxPerKind)) {
+        steps.push({
+            kind: 'source',
+            name: source.name,
+            detail: 'Raw source table the data originates from.',
+        });
+    }
+    const caveats = dedupeNames(block?.caveats ?? metadataStringArray(focus.metadata, 'caveats'));
+    return {
+        value,
+        summary: buildSummary({ focus, blockOwner, reviewCadence, generated, sourceAssets }),
+        steps,
+        trustLabel: input.trustLabel ?? (generated ? 'review_required' : undefined),
+        // Explicit `freshness` input wins; otherwise derive a marker from the
+        // block's upstream data health, then fall back to any focus metadata.
+        freshness: input.freshness ??
+            freshnessFromDataState(block?.dataState, block?.dataStateDetail) ??
+            metadataString(focus.metadata, 'freshness'),
+        caveats: caveats.length > 0 ? caveats : undefined,
+    };
+}
+/**
+ * Render a derivation-walk freshness marker from a block's `dataState`. Returns
+ * `undefined` for `fresh`/`unknown`/missing so a healthy or un-instrumented
+ * block shows no freshness downgrade.
+ */
+function freshnessFromDataState(dataState, detail) {
+    switch (dataState) {
+        case 'failed':
+            return detail ? `upstream failed — ${detail}` : 'upstream failed';
+        case 'stale':
+            return detail ? `stale data — ${detail}` : 'stale data';
+        default:
+            return undefined;
+    }
+}
+function blockDetail(input) {
+    const parts = [];
+    if (input.businessOutcome)
+        parts.push(input.businessOutcome);
+    else if (input.decisionUse)
+        parts.push(`Supports: ${input.decisionUse}.`);
+    if (input.reviewCadence)
+        parts.push(`Reviewed ${input.reviewCadence}.`);
+    return parts.length > 0 ? parts.join(' ') : undefined;
+}
+function buildSummary(input) {
+    const ownerPhrase = input.blockOwner ? ` owned by ${input.blockOwner}` : '';
+    const sourcePhrase = input.sourceAssets.length > 0
+        ? ` It traces back to ${input.sourceAssets[0].name}.`
+        : '';
+    if (input.generated) {
+        return `This value was generated from ${input.focus.name}${ownerPhrase} and still needs analyst review before it can be certified.${sourcePhrase}`;
+    }
+    const cadencePhrase = input.reviewCadence ? `, reviewed ${input.reviewCadence}` : '';
+    return `This value comes from the certified ${input.focus.name}${ownerPhrase}${cadencePhrase}.${sourcePhrase}`;
+}
+function metadataString(metadata, key) {
+    const value = metadata?.[key];
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+}
+function metadataStringArray(metadata, key) {
+    const value = metadata?.[key];
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === 'string' && item.trim().length > 0)
+        : [];
+}
+function dedupeNames(values) {
+    if (!values)
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const value of values) {
+        const trimmed = typeof value === 'string' ? value.trim() : '';
+        if (!trimmed || seen.has(trimmed.toLowerCase()))
+            continue;
+        seen.add(trimmed.toLowerCase());
+        out.push(trimmed);
+    }
+    return out;
+}
+function uniqueByName(assets) {
+    const seen = new Set();
+    const out = [];
+    for (const asset of assets) {
+        if (seen.has(asset.id))
+            continue;
+        seen.add(asset.id);
+        out.push(asset);
+    }
+    return out;
+}
+//# sourceMappingURL=derivation.js.map

package/dist/lineage/derivation.js.map

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

package/dist/lineage/impact.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Impact analysis + re-certification gating for DQL's answer layer.
+ *
+ * DQL composition is unbounded freeform `ref()`. The safety net: when a block
+ * changes, you must know what downstream *certified* work it invalidates.
+ *
+ * Given changed block name(s) — from `dql diff` or explicit input — this module:
+ *   1. walks the dependency DAG **downstream** to the full transitive set,
+ *   2. flags the cross-domain edges that get invalidated,
+ *   3. computes the resulting `domainTrust` delta,
+ *   4. produces a **required re-cert** list (certified downstream depending on
+ *      a changed block's semantics).
+ *
+ * It also classifies whether a given block change is *semantic* (affects what
+ * the block computes) or purely cosmetic (description/owner/tag/viz only).
+ * The classification is **conservative**: when unsure, treat the change as
+ * semantic so re-cert is required rather than silently skipped.
+ *
+ * This is the LOCAL engine. It does not manage org-wide workflow, approvals,
+ * audit, or auto-re-certification — that is the cloud product.
+ */
+import type { LineageGraph } from './lineage-graph.js';
+import type { DiffChange } from '../format/diff.js';
+/** Reason a changed block was (or was not) classified as a semantic change. */
+export type SemanticVerdict = 'semantic' | 'non-semantic';
+export interface ChangedBlock {
+    /** Block name (matches `block:<name>` in the lineage graph). */
+    name: string;
+    /** Whether the change affects what the block computes. */
+    verdict: SemanticVerdict;
+    /** Field paths that changed (for block-changed diffs). */
+    changedFields: string[];
+    /** True when the block was added or removed (always semantic). */
+    structural: boolean;
+}
+/**
+ * Classify a single block-level `DiffChange` as semantic or non-semantic.
+ *
+ * - Added/removed blocks are always semantic (structural).
+ * - A changed block is non-semantic only when **every** changed field is in
+ *   {@link NON_SEMANTIC_BLOCK_FIELDS}. A single unrecognized or semantic field
+ *   makes the whole change semantic (conservative default).
+ */
+export declare function classifyBlockChange(change: DiffChange): ChangedBlock | null;
+/**
+ * Extract the set of changed blocks from a diff report's changes, classifying
+ * each as semantic or non-semantic. Non-block changes (dashboards, workbooks,
+ * cells, notebooks) are ignored here — impact is keyed off block identity.
+ */
+export declare function changedBlocksFromDiff(changes: DiffChange[]): ChangedBlock[];
+export interface ImpactedNode {
+    id: string;
+    type: string;
+    name: string;
+    domain?: string;
+    status?: string;
+    owner?: string;
+}
+export interface CrossDomainImpact {
+    from: string;
+    to: string;
+    /** Invalidated boundary edges: source feeds a target in another domain. */
+    edges: Array<{
+        source: string;
+        target: string;
+    }>;
+}
+export interface DomainTrustDelta {
+    domain: string;
+    /** Certified count before vs. after re-cert demotions. */
+    certifiedBefore: number;
+    certifiedAfter: number;
+    total: number;
+    trustBefore: number;
+    trustAfter: number;
+    /** trustAfter - trustBefore (≤ 0). */
+    delta: number;
+}
+export interface RecertItem {
+    id: string;
+    name: string;
+    domain?: string;
+    owner?: string;
+    /** The changed block(s) whose semantics this artifact transitively depends on. */
+    invalidatedBy: string[];
+}
+export interface ImpactReport {
+    /** Changed blocks that were analyzed (semantic + non-semantic). */
+    changedBlocks: ChangedBlock[];
+    /** Changed blocks with a semantic verdict — only these propagate impact. */
+    semanticChanges: string[];
+    /** Full transitive downstream set across all semantic changes (excludes domain nodes). */
+    downstream: ImpactedNode[];
+    /** Cross-domain edges inside the invalidated zone, grouped by from→to. */
+    crossDomainImpacts: CrossDomainImpact[];
+    /** Certified artifacts that must be re-certified. */
+    requiresRecert: RecertItem[];
+    /** Per-domain trust delta caused by demoting the re-cert set. */
+    domainTrustDelta: DomainTrustDelta[];
+    /** True when certified downstream is invalidated and not already pending re-cert. */
+    hasCertifiedInvalidation: boolean;
+}
+export interface ComputeImpactOptions {
+    /**
+     * When true (default), a re-cert is only required for downstream nodes still
+     * marked `certified`. Nodes already `pending_recertification` are reported in
+     * the downstream set but do not, on their own, trip the gate — they are
+     * already flagged. Set false to also count `pending_recertification`.
+     */
+    ignoreAlreadyPending?: boolean;
+}
+/**
+ * Compute the impact of a set of changed blocks against a lineage graph.
+ *
+ * Only blocks with a **semantic** verdict propagate downstream impact; a purely
+ * cosmetic change (description/owner/tag only) produces an empty downstream set
+ * and never trips the re-cert gate.
+ */
+export declare function computeImpact(graph: LineageGraph, changedBlocks: ChangedBlock[], options?: ComputeImpactOptions): ImpactReport;
+/**
+ * One-shot helper: classify a diff's block changes and compute the impact
+ * report in a single call.
+ */
+export declare function computeImpactFromDiff(graph: LineageGraph, changes: DiffChange[], options?: ComputeImpactOptions): ImpactReport;
+/** Render an impact report as human-readable text for the CLI. */
+export declare function renderImpactText(report: ImpactReport): string;
+//# sourceMappingURL=impact.d.ts.map

package/dist/lineage/impact.d.ts.map

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

package/dist/lineage/impact.js

@@ -0,0 +1,305 @@
+/**
+ * Impact analysis + re-certification gating for DQL's answer layer.
+ *
+ * DQL composition is unbounded freeform `ref()`. The safety net: when a block
+ * changes, you must know what downstream *certified* work it invalidates.
+ *
+ * Given changed block name(s) — from `dql diff` or explicit input — this module:
+ *   1. walks the dependency DAG **downstream** to the full transitive set,
+ *   2. flags the cross-domain edges that get invalidated,
+ *   3. computes the resulting `domainTrust` delta,
+ *   4. produces a **required re-cert** list (certified downstream depending on
+ *      a changed block's semantics).
+ *
+ * It also classifies whether a given block change is *semantic* (affects what
+ * the block computes) or purely cosmetic (description/owner/tag/viz only).
+ * The classification is **conservative**: when unsure, treat the change as
+ * semantic so re-cert is required rather than silently skipped.
+ *
+ * This is the LOCAL engine. It does not manage org-wide workflow, approvals,
+ * audit, or auto-re-certification — that is the cloud product.
+ */
+import { getDomainTrustOverview } from './domain-lineage.js';
+// ---- Semantic-change classification ----
+/**
+ * Block-diff field paths that are **non-semantic**: they describe or annotate
+ * the block but do not change what it computes. A change confined entirely to
+ * these fields does not invalidate certification.
+ *
+ * Everything else (query, params, metric refs, tests, domain, type, business
+ * rules, visualization, …) is treated as semantic. This is deliberately a
+ * deny-list of known-cosmetic fields rather than an allow-list of semantic
+ * ones, so an unrecognized/new field defaults to "semantic" → needs re-cert.
+ */
+const NON_SEMANTIC_BLOCK_FIELDS = new Set([
+    'description',
+    'owner',
+    'tags',
+    'businessOutcome',
+    'businessOwner',
+    'decisionUse',
+    'reviewCadence',
+    'caveats',
+]);
+/**
+ * Classify a single block-level `DiffChange` as semantic or non-semantic.
+ *
+ * - Added/removed blocks are always semantic (structural).
+ * - A changed block is non-semantic only when **every** changed field is in
+ *   {@link NON_SEMANTIC_BLOCK_FIELDS}. A single unrecognized or semantic field
+ *   makes the whole change semantic (conservative default).
+ */
+export function classifyBlockChange(change) {
+    switch (change.kind) {
+        case 'block-added':
+        case 'block-removed':
+            return { name: change.name, verdict: 'semantic', changedFields: [], structural: true };
+        case 'block-changed': {
+            const fields = change.fields.map((f) => f.path);
+            const allCosmetic = fields.length > 0 && fields.every((p) => isNonSemanticField(p));
+            return {
+                name: change.name,
+                verdict: allCosmetic ? 'non-semantic' : 'semantic',
+                changedFields: fields,
+                structural: false,
+            };
+        }
+        default:
+            return null;
+    }
+}
+/** A field path is non-semantic when its leading segment is a known cosmetic field. */
+function isNonSemanticField(path) {
+    // `tags`, `description`, … are top-level; `params.region`, `tests[..]`,
+    // `visualization.title`, `query` are semantic. Only the exact known cosmetic
+    // field names count as non-semantic.
+    return NON_SEMANTIC_BLOCK_FIELDS.has(path);
+}
+/**
+ * Extract the set of changed blocks from a diff report's changes, classifying
+ * each as semantic or non-semantic. Non-block changes (dashboards, workbooks,
+ * cells, notebooks) are ignored here — impact is keyed off block identity.
+ */
+export function changedBlocksFromDiff(changes) {
+    const out = [];
+    for (const change of changes) {
+        const classified = classifyBlockChange(change);
+        if (classified)
+            out.push(classified);
+    }
+    return out;
+}
+/**
+ * Compute the impact of a set of changed blocks against a lineage graph.
+ *
+ * Only blocks with a **semantic** verdict propagate downstream impact; a purely
+ * cosmetic change (description/owner/tag only) produces an empty downstream set
+ * and never trips the re-cert gate.
+ */
+export function computeImpact(graph, changedBlocks, options = {}) {
+    const ignoreAlreadyPending = options.ignoreAlreadyPending ?? true;
+    const semantic = changedBlocks.filter((b) => b.verdict === 'semantic');
+    const semanticNames = semantic.map((b) => b.name);
+    // Resolve each changed block to its graph node id. A changed block may not
+    // exist in the graph (e.g. removed, or never compiled) — skip those for the
+    // downstream walk but keep them in the report.
+    const sourceIds = [];
+    const sourceNameById = new Map();
+    for (const block of semantic) {
+        const id = `block:${block.name}`;
+        if (graph.getNode(id)) {
+            sourceIds.push(id);
+            sourceNameById.set(id, block.name);
+        }
+    }
+    // Full transitive downstream union. Track which changed block(s) reach each
+    // downstream node so the re-cert list can attribute invalidations precisely.
+    const downstreamById = new Map();
+    const reachedBy = new Map();
+    for (const id of sourceIds) {
+        const blockName = sourceNameById.get(id);
+        for (const node of graph.descendants(id)) {
+            if (node.type === 'domain')
+                continue;
+            downstreamById.set(node.id, node);
+            const set = reachedBy.get(node.id) ?? new Set();
+            set.add(blockName);
+            reachedBy.set(node.id, set);
+        }
+    }
+    const downstream = [...downstreamById.values()]
+        .map(toImpactedNode)
+        .sort((a, b) => a.id.localeCompare(b.id));
+    // Cross-domain edges fully contained in the invalidated zone (source = a
+    // changed block or a downstream node; target = a downstream node).
+    const zoneIds = new Set([...sourceIds, ...downstreamById.keys()]);
+    const crossDomainImpacts = collectCrossDomainImpacts(graph, zoneIds);
+    // Re-cert list: certified downstream nodes invalidated by a semantic change.
+    const requiresRecert = [];
+    for (const node of downstreamById.values()) {
+        if (node.status !== 'certified') {
+            if (!(node.status === 'pending_recertification' && !ignoreAlreadyPending))
+                continue;
+        }
+        requiresRecert.push({
+            id: node.id,
+            name: node.name,
+            domain: node.domain,
+            owner: node.owner,
+            invalidatedBy: [...(reachedBy.get(node.id) ?? new Set())].sort(),
+        });
+    }
+    requiresRecert.sort((a, b) => a.id.localeCompare(b.id));
+    const domainTrustDelta = computeDomainTrustDelta(graph, requiresRecert);
+    return {
+        changedBlocks,
+        semanticChanges: semanticNames,
+        downstream,
+        crossDomainImpacts,
+        requiresRecert,
+        domainTrustDelta,
+        hasCertifiedInvalidation: requiresRecert.length > 0,
+    };
+}
+function toImpactedNode(node) {
+    return {
+        id: node.id,
+        type: node.type,
+        name: node.name,
+        domain: node.domain,
+        status: node.status,
+        owner: node.owner,
+    };
+}
+/**
+ * Collect cross-domain edges whose source and target both lie inside the
+ * invalidated zone, grouped by `from → to` domain pair.
+ */
+function collectCrossDomainImpacts(graph, zoneIds) {
+    const byPair = new Map();
+    for (const edge of graph.getCrossDomainEdges()) {
+        if (!zoneIds.has(edge.source) || !zoneIds.has(edge.target))
+            continue;
+        const from = edge.sourceDomain ?? graph.getNode(edge.source)?.domain ?? '(unknown)';
+        const to = edge.targetDomain ?? graph.getNode(edge.target)?.domain ?? '(unknown)';
+        const key = `${from}→${to}`;
+        let impact = byPair.get(key);
+        if (!impact) {
+            impact = { from, to, edges: [] };
+            byPair.set(key, impact);
+        }
+        impact.edges.push({ source: edge.source, target: edge.target });
+    }
+    return [...byPair.values()].sort((a, b) => `${a.from}→${a.to}`.localeCompare(`${b.from}→${b.to}`));
+}
+/**
+ * Compute the per-domain `domainTrust` delta that results from demoting every
+ * re-cert artifact out of `certified`. The "before" view uses the live graph;
+ * the "after" view recomputes trust as if each re-cert block were no longer
+ * certified (it would become `pending_recertification`).
+ *
+ * Only block-typed re-cert items affect trust scores, mirroring
+ * {@link getDomainTrustOverview} which counts blocks only.
+ */
+function computeDomainTrustDelta(graph, requiresRecert) {
+    // Map domain → set of block names losing certified status.
+    const demotedByDomain = new Map();
+    const affectedDomains = new Set();
+    for (const item of requiresRecert) {
+        const node = graph.getNode(item.id);
+        if (!node || node.type !== 'block')
+            continue;
+        const domain = node.domain ?? '(unassigned)';
+        demotedByDomain.set(domain, (demotedByDomain.get(domain) ?? 0) + 1);
+        affectedDomains.add(domain);
+    }
+    const deltas = [];
+    for (const domain of affectedDomains) {
+        const overview = getDomainTrustOverview(graph, domain);
+        const total = overview.totalBlocks;
+        const certifiedBefore = overview.certified;
+        const demoted = demotedByDomain.get(domain) ?? 0;
+        const certifiedAfter = Math.max(0, certifiedBefore - demoted);
+        const trustBefore = total > 0 ? certifiedBefore / total : 0;
+        const trustAfter = total > 0 ? certifiedAfter / total : 0;
+        deltas.push({
+            domain,
+            certifiedBefore,
+            certifiedAfter,
+            total,
+            trustBefore,
+            trustAfter,
+            delta: trustAfter - trustBefore,
+        });
+    }
+    return deltas.sort((a, b) => a.domain.localeCompare(b.domain));
+}
+// ---- Convenience: full report from a diff ----
+/**
+ * One-shot helper: classify a diff's block changes and compute the impact
+ * report in a single call.
+ */
+export function computeImpactFromDiff(graph, changes, options) {
+    return computeImpact(graph, changedBlocksFromDiff(changes), options);
+}
+// ---- Text rendering ----
+/** Render an impact report as human-readable text for the CLI. */
+export function renderImpactText(report) {
+    const lines = [];
+    lines.push('  Impact Analysis');
+    lines.push('  ' + '='.repeat(50));
+    if (report.changedBlocks.length === 0) {
+        lines.push('');
+        lines.push('  No block changes detected.');
+        return lines.join('\n');
+    }
+    lines.push('');
+    lines.push('  Changed blocks:');
+    for (const block of report.changedBlocks) {
+        const tag = block.structural
+            ? '(structural)'
+            : block.verdict === 'non-semantic'
+                ? '(non-semantic — no re-cert)'
+                : '(semantic)';
+        lines.push(`    ${block.name} ${tag}`);
+    }
+    lines.push('');
+    lines.push(`  Transitive downstream affected: ${report.downstream.length}`);
+    for (const node of report.downstream) {
+        const badge = node.status === 'certified' ? ' [certified]' : node.status ? ` [${node.status}]` : '';
+        const domain = node.domain ? ` (${node.domain})` : '';
+        lines.push(`    - ${node.type}:${node.name}${domain}${badge}`);
+    }
+    if (report.crossDomainImpacts.length > 0) {
+        lines.push('');
+        lines.push('  Cross-domain edges invalidated:');
+        for (const impact of report.crossDomainImpacts) {
+            lines.push(`    ${impact.from} -> ${impact.to} (${impact.edges.length} edge(s))`);
+        }
+    }
+    if (report.domainTrustDelta.length > 0) {
+        lines.push('');
+        lines.push('  domainTrust delta:');
+        for (const d of report.domainTrustDelta) {
+            const before = (d.trustBefore * 100).toFixed(0);
+            const after = (d.trustAfter * 100).toFixed(0);
+            const pts = (d.delta * 100).toFixed(0);
+            lines.push(`    ${d.domain}: ${d.certifiedBefore}/${d.total} -> ${d.certifiedAfter}/${d.total} certified ` +
+                `(${before}% -> ${after}%, ${pts} pts)`);
+        }
+    }
+    lines.push('');
+    if (report.requiresRecert.length > 0) {
+        lines.push(`  Requires re-certification (${report.requiresRecert.length}):`);
+        for (const item of report.requiresRecert) {
+            const owner = item.owner ? ` — ${item.owner}` : '';
+            lines.push(`    ! ${item.name}${item.domain ? ` (${item.domain})` : ''}${owner}`);
+            lines.push(`        invalidated by: ${item.invalidatedBy.join(', ')}`);
+        }
+    }
+    else {
+        lines.push('  No certified downstream invalidated. Re-cert not required.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=impact.js.map

package/dist/lineage/impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.js","sourceRoot":"","sources":["../../src/lineage/impact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAqB,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,2CAA2C;AAE3C;;;;;;;;;GASG;AACH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAS;IAChD,aAAa;IACb,OAAO;IACP,MAAM;IACN,iBAAiB;IACjB,eAAe;IACf,aAAa;IACb,eAAe;IACf,SAAS;CACV,CAAC,CAAC;AAgBH;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,aAAa,CAAC;QACnB,KAAK,eAAe;YAClB,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACzF,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;YACpF,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU;gBAClD,aAAa,EAAE,MAAM;gBACrB,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,SAAS,kBAAkB,CAAC,IAAY;IACtC,wEAAwE;IACxE,6EAA6E;IAC7E,qCAAqC;IACrC,OAAO,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAqB;IACzD,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,UAAU;YAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAsED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAmB,EACnB,aAA6B,EAC7B,UAAgC,EAAE;IAElC,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,IAAI,CAAC;IAElE,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAElD,2EAA2E;IAC3E,4EAA4E;IAC5E,+CAA+C;IAC/C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,cAAc,GAAG,IAAI,GAAG,EAAuB,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IACjD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YACrC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAClC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;YACxD,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACnB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAmB,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;SAC5D,GAAG,CAAC,cAAc,CAAC;SACnB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5C,yEAAyE;IACzE,mEAAmE;IACnE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,SAAS,EAAE,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAErE,6EAA6E;IAC7E,MAAM,cAAc,GAAiB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,yBAAyB,IAAI,CAAC,oBAAoB,CAAC;gBAAE,SAAS;QACtF,CAAC;QACD,cAAc,CAAC,IAAI,CAAC;YAClB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,aAAa,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;SACjE,CAAC,CAAC;IACL,CAAC;IACD,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAExD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAExE,OAAO;QACL,aAAa;QACb,eAAe,EAAE,aAAa;QAC9B,UAAU;QACV,kBAAkB;QAClB,cAAc;QACd,gBAAgB;QAChB,wBAAwB,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,IAAiB;IACvC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB,CAAC,KAAmB,EAAE,OAAoB;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IACpD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,SAAS;QACrE,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,WAAW,CAAC;QACpF,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,WAAW,CAAC;QAClF,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACrG,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,KAAmB,EAAE,cAA4B;IAChF,2DAA2D;IAC3D,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC;QAC7C,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACpE,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC;QACnC,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,CAAC;QAC3C,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC;QAC9D,MAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC;YACV,MAAM;YACN,eAAe;YACf,cAAc;YACd,KAAK;YACL,WAAW;YACX,UAAU;YACV,KAAK,EAAE,UAAU,GAAG,WAAW;SAChC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,iDAAiD;AAEjD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAmB,EACnB,OAAqB,EACrB,OAA8B;IAE9B,OAAO,aAAa,CAAC,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,2BAA2B;AAE3B,kEAAkE;AAClE,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAElC,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU;YAC1B,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,cAAc;gBAChC,CAAC,CAAC,6BAA6B;gBAC/B,CAAC,CAAC,YAAY,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qCAAqC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,MAAM,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,WAAW,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAChD,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,KAAK,aAAa;gBAC7F,IAAI,MAAM,QAAQ,KAAK,MAAM,GAAG,OAAO,CAC1C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,gCAAgC,MAAM,CAAC,cAAc,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7E,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YAClF,KAAK,CAAC,IAAI,CAAC,2BAA2B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/lineage/index.d.ts

@@ -1,8 +1,10 @@
 export { analyzeSqlReferences, extractTablesFromSql, type SqlColumnReference, type SqlParseResult, type SqlReferenceAnalysis, } from './sql-parser.js';
-export { extractColumnLineage, type ColumnLineageEntry, type ColumnLineageResult, type ColumnSource, } from './column-lineage.js';
+export { extractColumnLineage, extractRefColumnUsage, type ColumnLineageEntry, type ColumnLineageResult, type ColumnSource, type RefColumnUsage, } from './column-lineage.js';
 export { resolveDependencies, getUpstream, getDownstream, type BlockDependencyInfo, type DependencyResolutionResult, } from './dependency-resolver.js';
 export { LineageGraph, getLayerForNodeType, type LineageNode, type LineageEdge, type LineageNodeType, type LineageEdgeType, type LineageLayer, type LineageGraphJSON, } from './lineage-graph.js';
 export { buildLineageGraph, type LineageBlockInput, type LineageMetricInput, type LineageDimensionInput, type LineageDbtModelInput, type LineageDashboardInput, type LineageBusinessViewInput, type LineageTermInput, type LineageBuilderOptions, } from './builder.js';
 export { queryLineage, queryBusiness360, queryCompleteLineagePaths, type LineageQuery, type LineageQueryResult, type Business360Asset, type Business360BlockContract, type Business360Edge, type Business360Gap, type Business360Options, type Business360Reusability, type Business360Result, type Business360ResultV2, type LineagePath, type CompletePathResult, type CompletePathOptions, } from './query.js';
 export { buildTrustChain, analyzeImpact, detectDomainFlows, getDomainTrustOverview, type TrustChain, type TrustChainNode, type ImpactAnalysis, type DomainImpact, type DomainFlow, } from './domain-lineage.js';
+export { buildDerivationWalk, type DerivationWalk, type DerivationStep, type DerivationStepKind, type DerivationFocusBlock, type BuildDerivationWalkInput, } from './derivation.js';
+export { classifyBlockChange, changedBlocksFromDiff, computeImpact, computeImpactFromDiff, renderImpactText, type ChangedBlock, type SemanticVerdict, type ImpactReport, type ImpactedNode, type CrossDomainImpact, type DomainTrustDelta, type RecertItem, type ComputeImpactOptions, } from './impact.js';
 //# sourceMappingURL=index.d.ts.map