@duckcodeailabs/dql-core 1.6.20 → 1.6.22

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.
@@ -335,6 +353,7 @@ function scanBlocks(projectRoot, dirs, diagnostics, datalexRegistry) {
                     const block = stmt;
                     if (block.kind !== 'BlockDecl')
                         continue;
+                    const nextBlock = blockDeclToManifestBlock(block, relPath);
                     if (blocks[block.name]) {
                         diagnostics?.push({
                             kind: 'resolve',
@@ -343,7 +362,9 @@ function scanBlocks(projectRoot, dirs, diagnostics, datalexRegistry) {
                             message: `duplicate block "${block.name}" also declared in ${blocks[block.name].filePath}`,
                         });
                     }
-                    blocks[block.name] = blockDeclToManifestBlock(block, relPath);
+                    if (!blocks[block.name] || shouldReplaceDuplicateBlock(blocks[block.name], nextBlock)) {
+                        blocks[block.name] = nextBlock;
+                    }
                 }
             }
             catch (err) {
@@ -361,6 +382,26 @@ function scanBlocks(projectRoot, dirs, diagnostics, datalexRegistry) {
     }
     return blocks;
 }
+function shouldReplaceDuplicateBlock(existing, next) {
+    return duplicateBlockPriority(next) > duplicateBlockPriority(existing);
+}
+function duplicateBlockPriority(block) {
+    let score = 0;
+    if (block.status === 'certified')
+        score += 100;
+    else if (block.status === 'review')
+        score += 60;
+    else if (block.status === 'draft')
+        score += 20;
+    else
+        score += 10;
+    const path = block.filePath.replaceAll('\\', '/');
+    if (!path.includes('/_drafts/') && !path.startsWith('_drafts/') && !path.startsWith('blocks/_drafts/'))
+        score += 10;
+    if (path.startsWith('domains/') || path.startsWith('blocks/'))
+        score += 5;
+    return score;
+}
 // ---- Business View Scanning ----
 function scanBusinessViews(projectRoot, dirs, diagnostics) {
     const views = {};
@@ -1016,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)) {
@@ -1028,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;
@@ -1050,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];
@@ -1149,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: [] };
             }
@@ -1164,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';
@@ -1179,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 });
@@ -1192,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,
@@ -1206,6 +1266,7 @@ function importDbtManifest(manifestPath, sources, referencedTables, opts = {}) {
                 schema: entry.schema,
                 database: entry.database,
                 description: src.description,
+                runState: sourceRunState,
             });
             sourcesImported++;
         }
@@ -1220,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);
@@ -1793,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,