@duckcodeailabs/dql-cli 1.10.3 → 1.10.5

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-cli",
-  "version": "1.10.3",
+  "version": "1.10.5",
   "description": "Public CLI for parsing, formatting, testing, and certifying DQL blocks",
   "license": "Apache-2.0",
   "type": "module",
@@ -25,15 +25,15 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.104.2",
-    "@duckcodeailabs/dql-agent": "^1.10.3",
-    "@duckcodeailabs/dql-compiler": "^1.10.3",
-    "@duckcodeailabs/dql-connectors": "^1.10.3",
-    "@duckcodeailabs/dql-core": "^1.10.3",
-    "@duckcodeailabs/dql-governance": "^1.10.3",
-    "@duckcodeailabs/dql-mcp": "^1.10.3",
-    "@duckcodeailabs/dql-notebook": "^1.10.3",
-    "@duckcodeailabs/dql-project": "^1.10.3",
-    "@duckcodeailabs/dql-slack": "^1.10.3",
+    "@duckcodeailabs/dql-agent": "^1.10.5",
+    "@duckcodeailabs/dql-compiler": "^1.10.5",
+    "@duckcodeailabs/dql-connectors": "^1.10.5",
+    "@duckcodeailabs/dql-core": "^1.10.5",
+    "@duckcodeailabs/dql-governance": "^1.10.5",
+    "@duckcodeailabs/dql-mcp": "^1.10.5",
+    "@duckcodeailabs/dql-notebook": "^1.10.5",
+    "@duckcodeailabs/dql-project": "^1.10.5",
+    "@duckcodeailabs/dql-slack": "^1.10.5",
     "isomorphic-git": "^1.27.0",
     "js-yaml": "^4.1.0",
     "node-cron": "^3.0.3",

package/dist/semantic-execution/connection-identity.d.ts

@@ -0,0 +1,11 @@
+import { type WarehouseTargetIdentityV1 } from '@duckcodeailabs/dql-core';
+import type { ConnectionConfig, QueryExecutor } from '@duckcodeailabs/dql-connectors';
+/**
+ * Acquire the redacted warehouse identity on the same connector lease used by
+ * semantic validation/execution. Snowflake CURRENT_* values are authoritative;
+ * configured values remain the bounded fallback for other adapters.
+ */
+export declare function observeWarehouseTargetIdentity(executor: QueryExecutor, connection: ConnectionConfig): Promise<WarehouseTargetIdentityV1>;
+export declare function configuredWarehouseTargetIdentity(connection: ConnectionConfig): WarehouseTargetIdentityV1;
+export declare function connectionReference(connection: ConnectionConfig): string;
+//# sourceMappingURL=connection-identity.d.ts.map

package/dist/semantic-execution/connection-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-identity.d.ts","sourceRoot":"","sources":["../../src/semantic-execution/connection-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEtF;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,yBAAyB,CAAC,CAqCpC;AAED,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,gBAAgB,GAC3B,yBAAyB,CAO3B;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAcxE"}

package/dist/semantic-execution/connection-identity.js

@@ -0,0 +1,81 @@
+import { createWarehouseTargetIdentity, semanticExecutionFingerprint, } from '@duckcodeailabs/dql-core';
+/**
+ * Acquire the redacted warehouse identity on the same connector lease used by
+ * semantic validation/execution. Snowflake CURRENT_* values are authoritative;
+ * configured values remain the bounded fallback for other adapters.
+ */
+export async function observeWarehouseTargetIdentity(executor, connection) {
+    const configured = configuredWarehouseContext(connection);
+    let observed = configured;
+    if (connection.driver === 'snowflake') {
+        try {
+            const result = await executor.executePositional(`SELECT
+           CURRENT_ACCOUNT() AS DQL_ACCOUNT,
+           CURRENT_DATABASE() AS DQL_DATABASE,
+           CURRENT_SCHEMA() AS DQL_SCHEMA,
+           CURRENT_ROLE() AS DQL_ROLE,
+           CURRENT_WAREHOUSE() AS DQL_WAREHOUSE`, [], connection, { maxRows: 1, maxBytes: 64 * 1024, deadlineMs: 30_000 });
+            const row = result.rows[0];
+            if (row) {
+                observed = {
+                    account: rowString(row, 'DQL_ACCOUNT') ?? configured.account,
+                    database: rowString(row, 'DQL_DATABASE') ?? configured.database,
+                    schema: rowString(row, 'DQL_SCHEMA') ?? configured.schema,
+                    role: rowString(row, 'DQL_ROLE') ?? configured.role,
+                    warehouse: rowString(row, 'DQL_WAREHOUSE') ?? configured.warehouse,
+                };
+            }
+        }
+        catch {
+            // The later target/preflight step preserves a real connector failure.
+            // Identity acquisition remains useful for dialects without CURRENT_*.
+        }
+    }
+    return createWarehouseTargetIdentity({
+        connectionRef: connectionReference(connection),
+        driver: connection.driver,
+        dialect: connection.driver,
+        redactedContext: observed,
+    });
+}
+export function configuredWarehouseTargetIdentity(connection) {
+    return createWarehouseTargetIdentity({
+        connectionRef: connectionReference(connection),
+        driver: connection.driver,
+        dialect: connection.driver,
+        redactedContext: configuredWarehouseContext(connection),
+    });
+}
+export function connectionReference(connection) {
+    return `connection:${semanticExecutionFingerprint({
+        driver: connection.driver,
+        host: connection.host,
+        account: connection.account,
+        database: connection.database,
+        catalog: connection.catalog,
+        schema: connection.schema,
+        role: connection.role,
+        warehouse: connection.warehouse,
+        filepath: connection.filepath,
+        projectId: connection.projectId,
+        httpPath: connection.httpPath,
+    }).slice(0, 24)}`;
+}
+function configuredWarehouseContext(connection) {
+    return {
+        account: connection.account ?? connection.host,
+        database: connection.database,
+        catalog: connection.catalog,
+        schema: connection.schema,
+        role: connection.role,
+        warehouse: connection.warehouse,
+    };
+}
+function rowString(row, key) {
+    const value = row[key] ?? row[key.toLowerCase()];
+    if (value === null || value === undefined)
+        return undefined;
+    const normalized = String(value).trim();
+    return normalized || undefined;
+}
+//# sourceMappingURL=connection-identity.js.map

package/dist/semantic-execution/connection-identity.js.map

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

package/dist/semantic-execution/execution-gateway.d.ts

@@ -0,0 +1,53 @@
+import { type SemanticAdapterIdV1, type SemanticExecutionReceiptV1, type SemanticTargetBindingV1, type WarehouseTargetIdentityV1 } from '@duckcodeailabs/dql-core';
+import { type ConnectionConfig, type QueryExecutor, type QueryResult } from '@duckcodeailabs/dql-connectors';
+import type { SemanticRuntimeCompileResult, SemanticRuntimeTrace } from '../semantic-runtime.js';
+import { type MetricFlowTargetMetadata } from './target-binding.js';
+export declare class SemanticPhysicalPreflightError extends Error {
+    readonly code: 'IDENTIFIER_SCOPE_INVALID' | 'PHYSICAL_PREFLIGHT_FAILED';
+    readonly details: {
+        adapterId: SemanticAdapterIdV1;
+        phase: 'validation';
+        queryId?: string;
+        sqlState?: string;
+        vendorCode?: string;
+        line?: number;
+        position?: number;
+        identifier?: string;
+        compiledSql?: string;
+        compiledSqlTruncated: boolean;
+        compiledSqlFingerprint: string;
+        sqlExcerpt?: {
+            startLine: number;
+            endLine: number;
+            text: string;
+        };
+        targetBinding: SemanticTargetBindingV1;
+        safeActions: string[];
+    };
+    constructor(adapterId: SemanticAdapterIdV1, error: unknown, sql: string, targetBinding: SemanticTargetBindingV1);
+}
+export interface SemanticExecutionGatewayResult {
+    compiled: SemanticRuntimeCompileResult;
+    preparedSql: string;
+    executionTarget: WarehouseTargetIdentityV1;
+    targetBinding: SemanticTargetBindingV1;
+    result: QueryResult;
+    executionReceipt: SemanticExecutionReceiptV1;
+    semanticTrace: SemanticRuntimeTrace;
+}
+export declare function executeTargetBoundSemanticQuery(input: {
+    executor: QueryExecutor;
+    connection: ConnectionConfig;
+    projectRoot: string;
+    plannedAdapter: SemanticAdapterIdV1;
+    metricFlow?: MetricFlowTargetMetadata;
+    compile: () => Promise<SemanticRuntimeCompileResult | null>;
+    prepareSql?: (sql: string) => {
+        sql: string;
+        connection?: ConnectionConfig;
+    };
+    rowBound?: number;
+}): Promise<SemanticExecutionGatewayResult | null>;
+export declare function semanticExecutionFailureCode(error: unknown): string | undefined;
+export declare function semanticExecutionFailureDetails(error: unknown): unknown;
+//# sourceMappingURL=execution-gateway.d.ts.map

package/dist/semantic-execution/execution-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-gateway.d.ts","sourceRoot":"","sources":["../../src/semantic-execution/execution-gateway.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAE/B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAE,0BAA0B,GAAG,2BAA2B,CAAC;IACxE,QAAQ,CAAC,OAAO,EAAE;QAChB,SAAS,EAAE,mBAAmB,CAAC;QAC/B,KAAK,EAAE,YAAY,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,OAAO,CAAC;QAC9B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,UAAU,CAAC,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAClE,aAAa,EAAE,uBAAuB,CAAC;QACvC,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;gBAGA,SAAS,EAAE,mBAAmB,EAC9B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,uBAAuB;CAgCzC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,4BAA4B,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,yBAAyB,CAAC;IAC3C,aAAa,EAAE,uBAAuB,CAAC;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,gBAAgB,EAAE,0BAA0B,CAAC;IAC7C,aAAa,EAAE,oBAAoB,CAAC;CACrC;AAED,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,mBAAmB,CAAC;IACpC,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC,OAAO,EAAE,MAAM,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAC5D,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;KAAE,CAAC;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,8BAA8B,GAAG,IAAI,CAAC,CA2GjD;AAqGD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAU/E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqBvE"}

package/dist/semantic-execution/execution-gateway.js

@@ -0,0 +1,239 @@
+import { randomUUID } from 'node:crypto';
+import { semanticExecutionFingerprint, } from '@duckcodeailabs/dql-core';
+import { ConnectorQueryError, } from '@duckcodeailabs/dql-connectors';
+import { observeWarehouseTargetIdentity } from './connection-identity.js';
+import { SemanticAdapterDriftError, buildSemanticTargetBinding, } from './target-binding.js';
+export class SemanticPhysicalPreflightError extends Error {
+    code;
+    details;
+    constructor(adapterId, error, sql, targetBinding) {
+        const connector = error instanceof ConnectorQueryError ? error : undefined;
+        const detail = error instanceof Error ? error.message : String(error);
+        const identifier = extractInvalidIdentifier(detail);
+        const line = connector?.line ?? extractSqlLocation(detail).line;
+        const position = connector?.position ?? extractSqlLocation(detail).position;
+        const maxSqlChars = 1_000_000;
+        const compiledSql = sql.length <= maxSqlChars ? sql : sql.slice(0, maxSqlChars);
+        super(`The semantic query compiled, but warehouse validation failed: ${detail}`, error instanceof Error ? { cause: error } : undefined);
+        this.name = 'SemanticPhysicalPreflightError';
+        this.code = identifier ? 'IDENTIFIER_SCOPE_INVALID' : 'PHYSICAL_PREFLIGHT_FAILED';
+        this.details = {
+            adapterId,
+            phase: 'validation',
+            queryId: connector?.queryId,
+            sqlState: connector?.sqlState,
+            vendorCode: connector?.vendorCode,
+            line,
+            position,
+            identifier,
+            compiledSql,
+            compiledSqlTruncated: sql.length > maxSqlChars,
+            compiledSqlFingerprint: semanticExecutionFingerprint(sql),
+            sqlExcerpt: line ? sqlExcerpt(sql, line) : undefined,
+            targetBinding,
+            safeActions: ['refresh_snapshot', 'reapply_semantic_runtime', 'open_sql_notebook'],
+        };
+    }
+}
+export async function executeTargetBoundSemanticQuery(input) {
+    const startedAt = Date.now();
+    const executionTarget = await observeWarehouseTargetIdentity(input.executor, input.connection);
+    // Target validation intentionally happens before a remote compiler is called.
+    buildSemanticTargetBinding({
+        projectRoot: input.projectRoot,
+        adapterId: input.plannedAdapter,
+        executionTarget,
+        metricFlow: input.metricFlow,
+    });
+    const compileStartedAt = Date.now();
+    const compiled = await input.compile();
+    if (!compiled)
+        return null;
+    if (compiled.engine !== input.plannedAdapter) {
+        throw new SemanticAdapterDriftError(input.plannedAdapter, compiled.engine);
+    }
+    const targetBinding = buildSemanticTargetBinding({
+        projectRoot: input.projectRoot,
+        adapterId: compiled.engine,
+        executionTarget,
+        metricFlow: input.metricFlow,
+    });
+    const prepared = input.prepareSql?.(compiled.sql) ?? { sql: compiled.sql, connection: input.connection };
+    const preparedConnection = prepared.connection ?? input.connection;
+    const validationStartedAt = Date.now();
+    await preflightCompiledSql(input.executor, preparedConnection, prepared.sql, compiled.engine, targetBinding);
+    const executionStartedAt = Date.now();
+    const rowBound = Math.max(1, Math.min(input.rowBound ?? 10_000, 100_000));
+    const result = await input.executor.executePositional(prepared.sql, [], preparedConnection, {
+        maxRows: rowBound,
+        maxBytes: 16 * 1024 * 1024,
+        batchSize: 500,
+        deadlineMs: 120_000,
+    });
+    const runtimeBindings = runtimeBindingsFromTrace(compiled.semanticTrace);
+    const compiledSqlFingerprint = semanticExecutionFingerprint(compiled.sql);
+    const executedSqlFingerprint = semanticExecutionFingerprint(prepared.sql);
+    const planFingerprint = semanticExecutionFingerprint({
+        request: compiled.effectiveRequest,
+        adapterId: compiled.engine,
+        snapshotId: targetBinding.semanticSnapshot.snapshotId,
+    });
+    const executablePlanFingerprint = semanticExecutionFingerprint({
+        planFingerprint,
+        targetBindingFingerprint: targetBinding.bindingFingerprint,
+        executedSqlFingerprint,
+    });
+    const receipt = {
+        version: 1,
+        receiptId: `semantic-receipt:${randomUUID()}`,
+        runId: `semantic-run:${randomUUID()}`,
+        snapshotId: targetBinding.semanticSnapshot.snapshotId,
+        planId: `semantic-plan:${planFingerprint.slice(0, 24)}`,
+        planFingerprint,
+        executablePlanId: `semantic-executable:${executablePlanFingerprint.slice(0, 24)}`,
+        executablePlanFingerprint,
+        targetBindingFingerprint: targetBinding.bindingFingerprint,
+        adapterId: compiled.engine,
+        executionTargetFingerprint: executionTarget.identityFingerprint,
+        runtimeBindings,
+        compiledSqlFingerprint,
+        executedSqlFingerprint,
+        parameterFingerprint: semanticExecutionFingerprint([]),
+        queryId: result.queryId,
+        sqlState: result.sqlState,
+        vendorCode: result.vendorCode,
+        outcome: 'succeeded',
+        outputColumns: result.columns.map((column) => column.name),
+        rowCount: result.rowCount,
+        rowBound,
+        resultFingerprint: semanticExecutionFingerprint({
+            columns: result.columns.map((column) => column.name),
+            rows: result.rows,
+            rowCount: result.rowCount,
+        }),
+        timingsMs: {
+            planning: compileStartedAt - startedAt,
+            compilation: validationStartedAt - compileStartedAt,
+            validation: executionStartedAt - validationStartedAt,
+            execution: Date.now() - executionStartedAt,
+        },
+    };
+    return {
+        compiled,
+        preparedSql: prepared.sql,
+        executionTarget,
+        targetBinding,
+        result,
+        executionReceipt: receipt,
+        semanticTrace: traceAfterExecution(compiled.semanticTrace, targetBinding, receipt, result.queryId),
+    };
+}
+async function preflightCompiledSql(executor, connection, sql, adapterId, targetBinding) {
+    // Snowflake EXPLAIN resolves relations, columns, aliases and permissions
+    // without accepting the result as an analytical execution.
+    if (connection.driver !== 'snowflake')
+        return;
+    try {
+        await executor.executePositional(`EXPLAIN USING TEXT ${sql}`, [], connection, { maxRows: 500, maxBytes: 1024 * 1024, batchSize: 100, deadlineMs: 60_000 });
+    }
+    catch (error) {
+        throw new SemanticPhysicalPreflightError(adapterId, error, sql, targetBinding);
+    }
+}
+function extractInvalidIdentifier(message) {
+    return message.match(/\binvalid identifier\s+['"]([^'"]+)['"]/i)?.[1];
+}
+function extractSqlLocation(message) {
+    const match = message.match(/\bline\s+(\d+)\s+at\s+position\s+(\d+)/i);
+    return match
+        ? { line: Number(match[1]), position: Number(match[2]) }
+        : {};
+}
+function sqlExcerpt(sql, line) {
+    const lines = sql.split(/\r?\n/);
+    const boundedLine = Math.max(1, Math.min(line, lines.length));
+    const startLine = Math.max(1, boundedLine - 3);
+    const endLine = Math.min(lines.length, boundedLine + 3);
+    return {
+        startLine,
+        endLine,
+        text: lines.slice(startLine - 1, endLine)
+            .map((value, index) => `${String(startLine + index).padStart(4, ' ')} | ${value}`)
+            .join('\n'),
+    };
+}
+function runtimeBindingsFromTrace(trace) {
+    return trace.bindings.map((binding) => ({
+        role: binding.role,
+        qualifiedId: semanticExecutionFingerprint({
+            authoringReference: binding.authoringReference,
+            runtimeReference: binding.runtimeReference,
+            entityPath: binding.entityPath,
+        }),
+        authoringReference: binding.authoringReference,
+        runtimeReference: binding.runtimeReference,
+        entityPath: [...binding.entityPath],
+    }));
+}
+function traceAfterExecution(trace, targetBinding, executionReceipt, queryId) {
+    return {
+        ...trace,
+        targetBinding,
+        executionReceipt,
+        steps: trace.steps.flatMap((step) => step.id === 'execute_query'
+            ? [
+                {
+                    id: 'validate_execution_target',
+                    label: 'Validate semantic and warehouse targets',
+                    status: 'completed',
+                    detail: `Bound ${targetBinding.adapterId} to target ${targetBinding.executionTarget.identityFingerprint.slice(0, 12)}.`,
+                },
+                {
+                    id: 'preflight_physical_sql',
+                    label: 'Preflight compiled physical SQL',
+                    status: 'completed',
+                    detail: targetBinding.executionTarget.driver === 'snowflake'
+                        ? 'Snowflake EXPLAIN resolved physical relations, columns, aliases, and access before execution.'
+                        : 'The connector does not expose a separate physical preflight; bounded execution retained the target contract.',
+                },
+                {
+                    ...step,
+                    status: 'completed',
+                    detail: queryId
+                        ? `Executed on the bound warehouse target · query ${queryId}.`
+                        : 'Executed on the bound warehouse target.',
+                },
+            ]
+            : [step]),
+    };
+}
+export function semanticExecutionFailureCode(error) {
+    if (error
+        && typeof error === 'object'
+        && 'code' in error
+        && typeof error.code === 'string') {
+        return error.code;
+    }
+    return undefined;
+}
+export function semanticExecutionFailureDetails(error) {
+    if (error
+        && typeof error === 'object'
+        && 'details' in error
+        && error.details !== undefined) {
+        return error.details;
+    }
+    if (error instanceof ConnectorQueryError) {
+        return {
+            driver: error.driver,
+            queryId: error.queryId,
+            sqlState: error.sqlState,
+            vendorCode: error.vendorCode,
+            line: error.line,
+            position: error.position,
+            retryable: error.retryable,
+        };
+    }
+    return undefined;
+}
+//# sourceMappingURL=execution-gateway.js.map

package/dist/semantic-execution/execution-gateway.js.map

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

package/dist/semantic-execution/target-binding.d.ts

@@ -0,0 +1,57 @@
+import { type SemanticAdapterIdV1, type SemanticTargetBindingV1, type WarehouseTargetIdentityV1, type WarehouseTargetMismatchV1 } from '@duckcodeailabs/dql-core';
+export declare class SemanticExecutionTargetMismatchError extends Error {
+    readonly code = "EXECUTION_TARGET_MISMATCH";
+    readonly details: {
+        adapterId: SemanticAdapterIdV1;
+        expectedTargetFingerprint: string;
+        actualTargetFingerprint: string;
+        mismatches: WarehouseTargetMismatchV1[];
+    };
+    constructor(input: {
+        adapterId: SemanticAdapterIdV1;
+        expected: WarehouseTargetIdentityV1;
+        actual: WarehouseTargetIdentityV1;
+        mismatches: WarehouseTargetMismatchV1[];
+    });
+}
+export declare class SemanticAdapterDriftError extends Error {
+    readonly code = "SEMANTIC_ADAPTER_DRIFT";
+    readonly details: {
+        plannedAdapter: SemanticAdapterIdV1;
+        compiledAdapter: SemanticAdapterIdV1;
+    };
+    constructor(plannedAdapter: SemanticAdapterIdV1, compiledAdapter: SemanticAdapterIdV1);
+}
+export declare class SemanticSourceBindingMissingError extends Error {
+    readonly code = "SEMANTIC_SOURCE_DRIFT";
+    readonly details: {
+        adapterId: 'dbt-cloud';
+        environmentId?: string;
+        metricInventoryState: 'missing' | 'partial';
+        safeActions: string[];
+    };
+    constructor(input: {
+        environmentId?: string;
+        metricInventoryState: 'missing' | 'partial';
+    });
+}
+export interface MetricFlowTargetMetadata {
+    expectedTarget?: WarehouseTargetIdentityV1;
+    profileName?: string;
+    targetName?: string;
+    profilesPath?: string;
+    runtimeVersion?: string;
+}
+export declare function assertSemanticExecutionTarget(input: {
+    projectRoot: string;
+    adapterId: SemanticAdapterIdV1;
+    executionTarget: WarehouseTargetIdentityV1;
+    metricFlow?: MetricFlowTargetMetadata;
+}): WarehouseTargetIdentityV1;
+export declare function buildSemanticTargetBinding(input: {
+    projectRoot: string;
+    adapterId: SemanticAdapterIdV1;
+    executionTarget: WarehouseTargetIdentityV1;
+    metricFlow?: MetricFlowTargetMetadata;
+}): SemanticTargetBindingV1;
+//# sourceMappingURL=target-binding.d.ts.map

package/dist/semantic-execution/target-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-binding.d.ts","sourceRoot":"","sources":["../../src/semantic-execution/target-binding.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,mBAAmB,EAGxB,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAGlC,qBAAa,oCAAqC,SAAQ,KAAK;IAC7D,QAAQ,CAAC,IAAI,+BAA+B;IAC5C,QAAQ,CAAC,OAAO,EAAE;QAChB,SAAS,EAAE,mBAAmB,CAAC;QAC/B,yBAAyB,EAAE,MAAM,CAAC;QAClC,uBAAuB,EAAE,MAAM,CAAC;QAChC,UAAU,EAAE,yBAAyB,EAAE,CAAC;KACzC,CAAC;gBAEU,KAAK,EAAE;QACjB,SAAS,EAAE,mBAAmB,CAAC;QAC/B,QAAQ,EAAE,yBAAyB,CAAC;QACpC,MAAM,EAAE,yBAAyB,CAAC;QAClC,UAAU,EAAE,yBAAyB,EAAE,CAAC;KACzC;CAcF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,OAAO,EAAE;QAAE,cAAc,EAAE,mBAAmB,CAAC;QAAC,eAAe,EAAE,mBAAmB,CAAA;KAAE,CAAC;gBAEpF,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB;CAKtF;AAED,qBAAa,iCAAkC,SAAQ,KAAK;IAC1D,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,OAAO,EAAE;QAChB,SAAS,EAAE,WAAW,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,SAAS,GAAG,SAAS,CAAC;QAC5C,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;gBAEU,KAAK,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,SAAS,GAAG,SAAS,CAAA;KAAE;CAa3F;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,yBAAyB,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,eAAe,EAAE,yBAAyB,CAAC;IAC3C,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC,GAAG,yBAAyB,CAe5B;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,eAAe,EAAE,yBAAyB,CAAC;IAC3C,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC,GAAG,uBAAuB,CAgD1B"}