@duckcodeailabs/dql-core 1.6.21 → 1.6.22

package/dist/trust/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/trust/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,uCAAuC;AACvC,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,UAAU,GACV,cAAc,GACd,sBAAsB,GACtB,UAAU,CAAC;AAEf,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3E,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,EAAE,EAAE,YAAY,CAAC;IACjB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,+DAA+D;IAC/D,KAAK,EAAE,eAAe,CAAC;IACvB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,eAAe,CAAC;IACvB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uFAAuF;AACvF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,oBAAoB,CAoCnE,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,EAAE,YAAY,EAM3C,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,kCAAkC,uBAAuB,CAAC;AAEvE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,eAAe,CAAC;AACvD,eAAO,MAAM,+BAA+B,oBAAoB,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAS/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,kBAAkB,CAIrB;AAED,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,EAAE,YAAqC,CAAC;AAI3E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,SAAS,CAAC,EAAE,MAAM,GACjB,kBAAkB,CAWpB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAe5E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CA0B9E"}

package/dist/trust/labels.js

@@ -0,0 +1,185 @@
+/**
+ * Canonical trust-label vocabulary.
+ *
+ * DQL's three-tier trust routing implies labels everywhere — the MCP server's
+ * answer contract, the agent answer-loop source tiers, and the UI badge. This
+ * module defines that vocabulary **once** so every surface speaks the same
+ * language. It is intentionally a pure, dependency-free module (no node-only
+ * imports) so it can be mirrored into the browser-only `dql-ui` package without
+ * pulling the rest of `dql-core` into a UI bundle.
+ *
+ * Each label is structured as a **base label + optional qualifier** so that
+ * downgrade/composition states stay representable. For example, a sibling
+ * change elsewhere may emit a "Certified · invariant violated" downgrade: that
+ * is base `Certified` plus the qualifier `invariant violated`. Consumers can
+ * render the base alone, or `base · qualifier` when a qualifier is present,
+ * without inventing new top-level labels.
+ *
+ * The vocabulary is **additive and backward compatible**: existing manifests,
+ * route values, and `status` strings keep working, and any unrecognized label
+ * id degrades to a safe default (`Insufficient-Context`) rather than throwing.
+ */
+/** Canonical vocabulary, defined once. Order is the trust hierarchy (best → worst). */
+export const TRUST_LABELS = {
+    certified: {
+        id: 'certified',
+        base: 'Certified',
+        severity: 'ok',
+        color: 'green',
+        description: 'Governed, human-certified artifact answering at the requested grain.',
+    },
+    reviewed: {
+        id: 'reviewed',
+        base: 'Reviewed',
+        severity: 'info',
+        color: 'blue',
+        description: 'Human-reviewed but not certified; safe as trusted context.',
+    },
+    ai_generated: {
+        id: 'ai_generated',
+        base: 'AI-Generated',
+        severity: 'caution',
+        color: 'amber',
+        description: 'AI-drafted answer that requires human review before stakeholder use.',
+    },
+    insufficient_context: {
+        id: 'insufficient_context',
+        base: 'Insufficient-Context',
+        severity: 'caution',
+        color: 'slate',
+        description: 'Not enough governed metadata to answer safely; clarification needed.',
+    },
+    conflict: {
+        id: 'conflict',
+        base: 'Conflict',
+        severity: 'blocked',
+        color: 'red',
+        description: 'Two governed definitions claim the same concept but disagree; a human must pick the winner.',
+    },
+};
+/** Ordered list of canonical labels (best → worst). */
+export const TRUST_LABEL_ORDER = [
+    'certified',
+    'reviewed',
+    'ai_generated',
+    'insufficient_context',
+    'conflict',
+];
+/** Convenience display qualifier shown when a certified artifact is downgraded. */
+export const TRUST_QUALIFIER_INVARIANT_VIOLATED = 'invariant violated';
+/**
+ * Freshness-aware-trust qualifiers. These compose with a base label exactly
+ * like {@link TRUST_QUALIFIER_INVARIANT_VIOLATED}: a certified block whose
+ * upstream data is stale renders "Certified · stale data"; one whose upstream
+ * dbt run failed renders "Certified · upstream failed".
+ *
+ * `data freshness unknown` is intentionally NOT surfaced as a downgrade — a
+ * missing `run_results.json` should degrade silently to the plain base label
+ * (see {@link dataStateQualifier}), so projects that have not wired dbt run
+ * artifacts keep showing "Certified".
+ */
+export const TRUST_QUALIFIER_STALE_DATA = 'stale data';
+export const TRUST_QUALIFIER_UPSTREAM_FAILED = 'upstream failed';
+/**
+ * Map a data-health state to its trust qualifier, or `undefined` when the data
+ * axis should not downgrade the label. `fresh` and `unknown` both return
+ * `undefined` so a healthy (or un-instrumented) block shows the plain base
+ * label; only `stale` and `failed` produce a visible "· …" qualifier.
+ */
+export function dataStateQualifier(dataState) {
+    switch (dataState) {
+        case 'failed':
+            return TRUST_QUALIFIER_UPSTREAM_FAILED;
+        case 'stale':
+            return TRUST_QUALIFIER_STALE_DATA;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Compose the effective trust label for an artifact, folding the data-freshness
+ * axis into a base trust label. When `dataState` is `stale`/`failed` the
+ * returned label is `<base> · <freshness qualifier>`; otherwise it is the base
+ * label unchanged. An explicit `existingQualifier` (e.g. "invariant violated")
+ * takes precedence so the two downgrade features never fight over the one
+ * qualifier slot — invariant violations are a stronger signal than staleness.
+ *
+ * Pure and dependency-free; safe to call from any surface (MCP, agent, UI).
+ */
+export function composeEffectiveTrust(input) {
+    const qualifier = input.existingQualifier?.trim() || dataStateQualifier(input.dataState);
+    return resolveTrustLabel(input.id, qualifier);
+}
+/** The safe default for any unknown/unmapped label id. */
+export const DEFAULT_TRUST_LABEL_ID = 'insufficient_context';
+const QUALIFIER_SEPARATOR = ' · ';
+/**
+ * Resolve a canonical label by id, composing an optional qualifier into a ready
+ * display string. An unknown id degrades to the safe default rather than
+ * throwing, so older/forward manifests never break a consumer.
+ */
+export function resolveTrustLabel(id, qualifier) {
+    const def = (id && TRUST_LABELS[id]) || TRUST_LABELS[DEFAULT_TRUST_LABEL_ID];
+    const trimmedQualifier = qualifier?.trim() || undefined;
+    return {
+        id: def.id,
+        base: def.base,
+        qualifier: trimmedQualifier,
+        severity: def.severity,
+        color: def.color,
+        display: trimmedQualifier ? `${def.base}${QUALIFIER_SEPARATOR}${trimmedQualifier}` : def.base,
+    };
+}
+/**
+ * Map an agent/MCP answer route to its canonical trust label id. Additive: an
+ * unrecognized route degrades to the safe default.
+ */
+export function trustLabelIdForRoute(route) {
+    switch (route) {
+        case 'certified':
+            return 'certified';
+        case 'conflict':
+            return 'conflict';
+        case 'generated_sql':
+            return 'ai_generated';
+        case 'research':
+            return 'reviewed';
+        case 'clarify':
+            return 'insufficient_context';
+        default:
+            return DEFAULT_TRUST_LABEL_ID;
+    }
+}
+/**
+ * Map a legacy artifact `status` / trust-tier string (as found on manifests and
+ * catalog objects) to a canonical label id. Additive and lenient: unknown
+ * statuses degrade to the safe default.
+ */
+export function trustLabelIdForStatus(status) {
+    switch (status) {
+        case 'certified':
+        case 'approved':
+            return 'certified';
+        case 'reviewed':
+        case 'review':
+        case 'research':
+            return 'reviewed';
+        case 'ai_generated':
+        case 'generated':
+        case 'draft':
+        case 'draft_ready':
+        case 'pending':
+        case 'analyst_review_required':
+            return 'ai_generated';
+        case 'conflict':
+            return 'conflict';
+        case 'mixed':
+        case 'unknown':
+        case 'uncertified':
+        case 'none':
+            return 'insufficient_context';
+        default:
+            return DEFAULT_TRUST_LABEL_ID;
+    }
+}
+//# sourceMappingURL=labels.js.map

package/dist/trust/labels.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-core",
-  "version": "1.6.21",
+  "version": "1.6.22",
   "description": "DQL language core: lexer, parser, AST, semantic analysis",
   "license": "Apache-2.0",
   "type": "module",
@@ -14,6 +14,10 @@
     "./format": {
       "types": "./dist/format/index.d.ts",
       "import": "./dist/format/index.js"
+    },
+    "./lineage": {
+      "types": "./dist/lineage/index.d.ts",
+      "import": "./dist/lineage/index.js"
     }
   },
   "files": [