@duckcodeailabs/dql-core 1.6.21 → 1.6.23

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lineage/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,YAAY,GAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lineage/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,GAC9B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC"}

package/dist/lineage/index.js

@@ -1,9 +1,11 @@
 // Lineage analysis — SQL parsing, dependency resolution, graph building, and domain lineage
 export { analyzeSqlReferences, extractTablesFromSql, } from './sql-parser.js';
-export { extractColumnLineage, } from './column-lineage.js';
+export { extractColumnLineage, extractRefColumnUsage, } from './column-lineage.js';
 export { resolveDependencies, getUpstream, getDownstream, } from './dependency-resolver.js';
 export { LineageGraph, getLayerForNodeType, } from './lineage-graph.js';
 export { buildLineageGraph, } from './builder.js';
 export { queryLineage, queryBusiness360, queryCompleteLineagePaths, } from './query.js';
 export { buildTrustChain, analyzeImpact, detectDomainFlows, getDomainTrustOverview, } from './domain-lineage.js';
+export { buildDerivationWalk, } from './derivation.js';
+export { classifyBlockChange, changedBlocksFromDiff, computeImpact, computeImpactFromDiff, renderImpactText, } from './impact.js';
 //# sourceMappingURL=index.js.map

package/dist/lineage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lineage/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAIrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,GAIrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,aAAa,GAGd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,YAAY,EACZ,mBAAmB,GAOpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,GASlB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,GAc1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,sBAAsB,GAMvB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lineage/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAIrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GAKtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,aAAa,GAGd,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,YAAY,EACZ,mBAAmB,GAOpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,iBAAiB,GASlB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,GAc1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,sBAAsB,GAMvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,GAMpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,gBAAgB,GASjB,MAAM,aAAa,CAAC"}

package/dist/manifest/builder.d.ts

@@ -91,6 +91,22 @@ interface ProjectConfig {
         /** Path to datalex-manifest.json, absolute or relative to projectRoot */
         manifestPath?: string;
     };
+    /**
+     * Optional `dql propose` conventions. Refines the convention-agnostic
+     * classifier + bounded selection. All fields are optional; defaults apply.
+     */
+    propose?: {
+        /** Folders/tags that mean business (default ["marts","core","reporting"]). */
+        businessLayers?: string[];
+        /** Folders/tags that mean plumbing (default ["staging","intermediate","base"]). */
+        excludeLayers?: string[];
+        /** Max candidates generated per domain (default 8). */
+        maxPerDomain?: number;
+        /** Minimum demand score a candidate needs to be selected (default 0). */
+        minScore?: number;
+        /** Optional AI enrichment toggle (default "auto"). */
+        aiEnrichment?: 'auto' | 'on' | 'off';
+    };
 }
 /**
  * Load `dql.config.json`. Exposed so CLI commands can read the same config

package/dist/manifest/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/manifest/builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,OAAO,KAAK,EACV,WAAW,EAeZ,MAAM,YAAY,CAAC;AAcpB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAmDzE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CA8HxE;AAID,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,GAAG,CAAC,EAAE;QACJ,0EAA0E;QAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,6FAA6F;QAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,iGAAiG;IACjG,OAAO,CAAC,EAAE;QACR,yEAAyE;QACzE,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAQpE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAgBf;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,aAAa,GAC3B,MAAM,GAAG,IAAI,CAef"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/manifest/builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,OAAO,KAAK,EACV,WAAW,EAeZ,MAAM,YAAY,CAAC;AAepB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAmDzE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAgJxE;AAID,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;OAGG;IACH,GAAG,CAAC,EAAE;QACJ,0EAA0E;QAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,6FAA6F;QAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,iGAAiG;IACjG,OAAO,CAAC,EAAE;QACR,yEAAyE;QACzE,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF;;;OAGG;IACH,OAAO,CAAC,EAAE;QACR,8EAA8E;QAC9E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,mFAAmF;QACnF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,uDAAuD;QACvD,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,yEAAyE;QACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,sDAAsD;QACtD,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;KACtC,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAQpE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CAgBf;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,aAAa,GAC3B,MAAM,GAAG,IAAI,CAef"}

package/dist/manifest/builder.js

@@ -8,14 +8,16 @@
 import { readdirSync, readFileSync, existsSync } from 'node:fs';
 import { join, extname, relative } from 'node:path';
 import { Parser } from '../parser/index.js';
-import { analyze } from '../semantic/index.js';
+import { analyze, detectTrustConflicts } from '../semantic/index.js';
 import { extractTablesFromSql } from '../lineage/sql-parser.js';
 import { extractColumnLineage } from '../lineage/column-lineage.js';
+import { detectOutputDrift } from './output-drift.js';
 import { buildLineageGraph } from '../lineage/builder.js';
 import { detectDomainFlows, getDomainTrustOverview } from '../lineage/domain-lineage.js';
 import { loadSemanticLayerFromDir } from '../semantic/index.js';
 import { DataLexContractRegistry } from '../contracts/index.js';
 import { loadAppDocument, findAppDocuments, findDashboardsForApp, loadDashboardDocument, extractDashboardBlockRefs, appFolderRelPath, } from '../apps/index.js';
+import { loadDbtRunState, applyBlockDataState } from './dbt-freshness.js';
 /**
  * Enumerate every file whose contents could change the manifest output.
  *
@@ -121,6 +123,14 @@ export function buildManifest(options) {
     validateDomains(domains, blocks, businessViews, terms, diagnostics);
     validateBusinessViews(businessViews, blocks, diagnostics);
     validateTermRefs(terms, blocks, businessViews, diagnostics);
+    // Cross-artifact trust-conflict detection: two certified terms / blocks that
+    // claim the same concept/grain but disagree. Additive `kind: 'conflict'`
+    // diagnostics; conservative heuristics avoid false positives.
+    diagnostics.push(...detectTrustConflicts(terms, blocks));
+    // Output-contract drift detection: a parent block `ref()`s a child and
+    // references a column the child no longer outputs. Additive `kind: 'drift'`
+    // warnings — never fails the build; freeform composition stays unrestricted.
+    diagnostics.push(...detectOutputDrift(blocks));
     // Load semantic layer
     const semanticDir = resolveSemanticPath(projectRoot, config);
     const { metrics, dimensions } = loadSemanticDefinitions(projectRoot, semanticDir);
@@ -148,11 +158,19 @@ export function buildManifest(options) {
     let dbtImport;
     if (options.dbtManifestPath) {
         const filters = options.dbtImportFilters ?? config.dbtImport;
+        // Freshness-aware trust — read dbt's run artifacts (run_results.json + source
+        // freshness) alongside the manifest, READ-ONLY. Empty/absent → every node is
+        // `unknown` and blocks are left untouched (additive, backward compatible).
+        const runState = loadDbtRunState(options.dbtManifestPath);
         dbtImport = importDbtManifest(options.dbtManifestPath, sources, referencedTables, {
             maxHops: options.maxDbtHops,
             selectiveThreshold: options.selectiveDbtThreshold ?? 200,
             filters,
+            runState,
         });
+        // Roll up per-model run state into each certified block's effective
+        // `dataState` via its transitive dbt upstreams.
+        applyBlockDataState(blocks, sources, dbtImport.dbtDag, runState);
     }
     // Apps & dashboards (consumption layer). Scanned after blocks/notebooks
     // because dashboard refs are resolved against the block path → name map.
@@ -1039,9 +1057,10 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
         const database = node.database;
         const dependsOn = Array.isArray(node.depends_on?.nodes) ? node.depends_on.nodes : [];
         const lookupKeys = buildLookupKeys(name, schema, database);
+        const primaryLookupKeys = buildPrimaryLookupKeys(name, schema, database);
         const tags = Array.isArray(node.tags) ? node.tags : [];
         const path = (node.original_file_path ?? node.path);
-        index.set(uniqueId, { uniqueId, name, type: 'model', schema, database, dependsOn, lookupKeys, tags, path, raw: node });
+        index.set(uniqueId, { uniqueId, name, type: 'model', schema, database, dependsOn, lookupKeys, primaryLookupKeys, tags, path, raw: node });
     }
     const rawSources = manifest.sources ?? {};
     for (const [uniqueId, src] of Object.entries(rawSources)) {
@@ -1051,9 +1070,10 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
         const schema = src.schema;
         const database = src.database;
         const lookupKeys = buildLookupKeys(name, schema, database);
+        const primaryLookupKeys = buildPrimaryLookupKeys(name, schema, database);
         const tags = Array.isArray(src.tags) ? src.tags : [];
         const path = (src.original_file_path ?? src.path);
-        index.set(uniqueId, { uniqueId, name, type: 'source', schema, database, dependsOn: [], lookupKeys, tags, path, raw: src });
+        index.set(uniqueId, { uniqueId, name, type: 'source', schema, database, dependsOn: [], lookupKeys, primaryLookupKeys, tags, path, raw: src });
     }
     const totalDbtModels = [...index.values()].filter((e) => e.type === 'model').length;
     const filters = opts.filters;
@@ -1073,21 +1093,33 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
         // Multiple dbt nodes may share a short alias, so short-name matches are
         // used only when they resolve unambiguously.
         const nameToIds = new Map();
-        const addNameLookup = (key, uniqueId) => {
+        const primaryNameToIds = new Map();
+        const addTo = (map, key, uniqueId) => {
             const normalized = key.toLowerCase();
-            const existing = nameToIds.get(normalized);
+            const existing = map.get(normalized);
             if (existing)
                 existing.add(uniqueId);
             else
-                nameToIds.set(normalized, new Set([uniqueId]));
+                map.set(normalized, new Set([uniqueId]));
         };
         for (const entry of index.values()) {
-            for (const key of entry.lookupKeys) {
-                addNameLookup(key, entry.uniqueId);
-            }
+            for (const key of entry.lookupKeys)
+                addTo(nameToIds, key, entry.uniqueId);
+            for (const key of entry.primaryLookupKeys)
+                addTo(primaryNameToIds, key, entry.uniqueId);
         }
         const resolveDbtAnchor = (ref) => {
-            for (const key of buildReferencedTableLookupKeys(ref)) {
+            const refKeys = buildReferencedTableLookupKeys(ref);
+            // Prefer an unambiguous match on EXACT model names before falling back to
+            // dbt role-prefix-stripped aliases — otherwise `dev.customers` is ambiguous
+            // between the `customers` mart and the stripped alias of `stg_customers`,
+            // and the anchor (and its whole upstream subgraph) is silently skipped.
+            for (const key of refKeys) {
+                const ids = primaryNameToIds.get(key);
+                if (ids?.size === 1)
+                    return [...ids][0];
+            }
+            for (const key of refKeys) {
                 const ids = nameToIds.get(key);
                 if (ids?.size === 1)
                     return [...ids][0];
@@ -1172,6 +1204,7 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
                     type: v.data_type,
                 }))
                 : undefined;
+            const modelRunState = opts.runState?.byUniqueId.get(uid);
             if (!sources[tableName]) {
                 sources[tableName] = { name: tableName, origin: 'dbt', referencedBy: [] };
             }
@@ -1187,6 +1220,7 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
                         { name: v.name, description: v.description, type: v.data_type },
                     ]))
                     : undefined,
+                runState: modelRunState,
             };
             if (sources[tableName].origin === 'sql')
                 sources[tableName].origin = 'dbt';
@@ -1202,6 +1236,7 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
                 database: entry.database,
                 materialized: node.config?.materialized,
                 description: node.description,
+                runState: modelRunState,
             });
             for (const dep of selectedDeps) {
                 dbtDagEdges.push({ source: dep, target: uid });
@@ -1215,11 +1250,13 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
             if (!sources[tableName]) {
                 sources[tableName] = { name: tableName, origin: 'dbt', referencedBy: [] };
             }
+            const sourceRunState = opts.runState?.byUniqueId.get(uid);
             sources[tableName].dbtModel = {
                 uniqueId: uid,
                 database: entry.database,
                 schema: entry.schema,
                 description: src.description,
+                runState: sourceRunState,
             };
             dbtDagModels.push({
                 uniqueId: uid,
@@ -1229,6 +1266,7 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
                 schema: entry.schema,
                 database: entry.database,
                 description: src.description,
+                runState: sourceRunState,
             });
             sourcesImported++;
         }
@@ -1243,9 +1281,23 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
         maxHops: opts.maxHops,
         importedAt: new Date().toISOString(),
         dbtDag: { models: dbtDagModels, edges: dbtDagEdges },
+        runResultsPath: opts.runState?.runResultsPath,
     };
 }
 /** Build all normalised lookup keys for a dbt node name. */
+/**
+ * Lookup keys from a dbt node's EXACT name (no role-prefix stripping), so a
+ * mart `customers` and a staging `stg_customers` never collide on the same key.
+ */
+function buildPrimaryLookupKeys(name, schema, database) {
+    const alias = name.toLowerCase();
+    const keys = new Set([alias]);
+    if (schema)
+        keys.add(`${schema}.${alias}`.toLowerCase());
+    if (schema && database)
+        keys.add(`${database}.${schema}.${alias}`.toLowerCase());
+    return [...keys];
+}
 function buildLookupKeys(name, schema, database) {
     const aliases = new Set([name.toLowerCase()]);
     const stripped = stripDbtRolePrefix(name);
@@ -1816,8 +1868,63 @@ function blockDeclToManifestBlock(block, filePath) {
                 unresolved: c.unresolved,
             }))
             : undefined,
+        outputContract: buildOutputContract(Array.isArray(block.outputs) ? block.outputs : undefined, columnLineage),
     };
 }
+/**
+ * Build a block's typed `outputContract` — the columns a parent that `ref()`s
+ * this block can rely on. Additive and distinct from `outputs` (column-lineage
+ * shaped). Source of truth, in priority order:
+ *
+ *   1. `declaredOutputs` (reviewer-declared field names) when present. These
+ *      are the contract the block author committed to, so they win. Column
+ *      lineage is used only to enrich `role`/`type` for matching names.
+ *   2. Otherwise, the resolved column-lineage output columns — but only when
+ *      the projection is fully resolved (no `*`/unresolved entries). A star or
+ *      unparsed projection means the schema is open, so we emit no contract and
+ *      drift detection stays silent for this block (conservative).
+ *
+ * Returns undefined when neither source yields a usable schema, keeping the
+ * field optional and backward-compatible.
+ */
+function buildOutputContract(declaredOutputs, columnLineage) {
+    const roleByName = new Map();
+    if (columnLineage?.parsed) {
+        for (const col of columnLineage.columns) {
+            if (col.isAggregate)
+                roleByName.set(col.name.toLowerCase(), 'metric');
+        }
+    }
+    if (Array.isArray(declaredOutputs) && declaredOutputs.length > 0) {
+        const seen = new Set();
+        const contract = [];
+        for (const raw of declaredOutputs) {
+            const name = typeof raw === 'string' ? raw.trim() : '';
+            if (!name || seen.has(name.toLowerCase()))
+                continue;
+            seen.add(name.toLowerCase());
+            contract.push({ name, role: roleByName.get(name.toLowerCase()) });
+        }
+        return contract.length > 0 ? contract : undefined;
+    }
+    if (!columnLineage?.parsed || columnLineage.columns.length === 0)
+        return undefined;
+    // Only emit a derived contract when every output column is resolved — a star
+    // or unresolved entry means we cannot enumerate the real output schema.
+    if (columnLineage.columns.some((c) => c.unresolved || c.name === '*' || c.name.endsWith('.*'))) {
+        return undefined;
+    }
+    const seen = new Set();
+    const contract = [];
+    for (const col of columnLineage.columns) {
+        const name = col.name?.trim();
+        if (!name || seen.has(name.toLowerCase()))
+            continue;
+        seen.add(name.toLowerCase());
+        contract.push({ name, role: col.isAggregate ? 'metric' : undefined });
+    }
+    return contract.length > 0 ? contract : undefined;
+}
 function domainDeclToManifestDomain(domain, filePath) {
     return {
         name: domain.name,