@duckcodeailabs/dql-cli 1.8.2 → 1.8.4

package/dist/semantic-runtime.js

@@ -0,0 +1,238 @@
+import { compileDbtCloudSemanticQuery, listDbtCloudCompatibleDimensions, testDbtCloudSemanticConnection, } from './dbt-cloud-semantic.js';
+import { compileMetricFlowQuery, hasMetricFlowCli, MetricFlowUnavailableError } from './metricflow.js';
+import { getEffectiveDbtCloudSemanticSettings, getSemanticRuntimeSettings, semanticRuntimeDraft, } from './semantic-runtime-settings.js';
+export class SemanticRuntimeRequiredError extends Error {
+    code = 'SEMANTIC_RUNTIME_REQUIRED';
+    constructor(message) {
+        super(message);
+        this.name = 'SemanticRuntimeRequiredError';
+    }
+}
+const cloudProbeCache = new Map();
+export async function getSemanticRuntimeStatus(projectRoot, options = {}) {
+    const redacted = getSemanticRuntimeSettings(projectRoot);
+    const cloud = getEffectiveDbtCloudSemanticSettings(projectRoot);
+    const cliReady = hasMetricFlowCli();
+    let cloudTest;
+    if (cloud.configured && cloud.testState === 'passed') {
+        cloudTest = {
+            ok: true,
+            message: cloud.testMessage ?? 'Previously tested.',
+            dialect: cloud.dialect,
+            metricCount: cloud.metricCount,
+        };
+    }
+    else if (cloud.configured && options.probeConfiguredCloud) {
+        cloudTest = await probeDbtCloudSemanticRuntime(projectRoot).catch((error) => ({
+            ok: false,
+            message: error instanceof Error ? error.message : String(error),
+        }));
+    }
+    const cloudReady = Boolean(cloudTest?.ok);
+    const preference = redacted.preference;
+    const active = selectActiveAdapter(preference, cloudReady, cliReady);
+    const adapters = [
+        {
+            id: 'native',
+            label: 'DQL native semantic compiler',
+            bundled: true,
+            configured: true,
+            tested: true,
+            ready: true,
+            source: 'bundled',
+            detail: 'Bundled with DQL. Executes safe simple/additive metrics without an external runtime.',
+        },
+        {
+            id: 'metricflow-cli',
+            label: 'Local MetricFlow',
+            bundled: true,
+            configured: cliReady,
+            tested: cliReady,
+            ready: cliReady,
+            source: cliReady ? 'local' : 'none',
+            detail: cliReady
+                ? 'Detected a compatible `mf` executable.'
+                : 'Adapter is bundled; install a compatible dbt/MetricFlow Python runtime so `mf` is callable.',
+        },
+        {
+            id: 'dbt-cloud',
+            label: 'dbt Cloud Semantic Layer',
+            bundled: true,
+            configured: cloud.configured,
+            tested: cloudReady || cloud.testState === 'failed',
+            ready: cloudReady,
+            source: cloud.source,
+            detail: !cloud.configured
+                ? 'Adapter is bundled; configure Host, Environment ID, and a Semantic Layer service token.'
+                : cloudReady
+                    ? cloudTest?.message ?? 'Test passed.'
+                    : cloudTest?.message ?? cloud.testMessage ?? 'Configured but not tested.',
+        },
+    ];
+    const setup = active !== 'native'
+        ? null
+        : cloud.configured && !cloudReady
+            ? 'Test the configured dbt Cloud Semantic Layer connection, or install a compatible local MetricFlow runtime.'
+            : 'Configure dbt Cloud Semantic Layer, or install a compatible local MetricFlow runtime for derived, ratio, cumulative, and conversion metrics.';
+    return { preference, active, adapters, setup };
+}
+export async function testSemanticRuntimeDraft(projectRoot, input) {
+    const draft = semanticRuntimeDraft(projectRoot, input);
+    return testDbtCloudSemanticConnection(draft);
+}
+export async function compileSemanticRuntimeQuery(request, context) {
+    const status = await getSemanticRuntimeStatus(context.projectRoot, { probeConfiguredCloud: true });
+    const explicit = request.engine;
+    const fullRuntimeRequested = explicit === 'metricflow' || explicit === 'metricflow-cli' || explicit === 'dbt-cloud';
+    const candidates = explicit === 'native'
+        ? ['native']
+        : explicit === 'dbt-cloud'
+            ? ['dbt-cloud']
+            : explicit === 'metricflow-cli'
+                ? ['metricflow-cli']
+                : status.active === 'dbt-cloud'
+                    ? ['dbt-cloud', 'metricflow-cli', 'native']
+                    : status.active === 'metricflow-cli'
+                        ? ['metricflow-cli', 'dbt-cloud', 'native']
+                        : ['native'];
+    let lastRuntimeError;
+    for (const adapter of candidates) {
+        if (adapter === 'dbt-cloud') {
+            const adapterStatus = status.adapters.find((item) => item.id === adapter);
+            if (!adapterStatus?.ready)
+                continue;
+            try {
+                const result = await compileDbtCloudSemanticQuery(getEffectiveDbtCloudSemanticSettings(context.projectRoot), request);
+                return { sql: result.sql, joins: [], tables: [], engine: 'dbt-cloud' };
+            }
+            catch (error) {
+                lastRuntimeError = error instanceof Error ? error : new Error(String(error));
+                if (explicit === 'dbt-cloud')
+                    throw lastRuntimeError;
+                continue;
+            }
+        }
+        if (adapter === 'metricflow-cli') {
+            if (!hasMetricFlowCli())
+                continue;
+            try {
+                const dbtProjectPath = context.projectConfig.semanticLayer?.provider === 'dbt'
+                    ? context.projectConfig.semanticLayer.projectPath
+                    : context.projectConfig.dbt?.projectDir;
+                const compiled = compileMetricFlowQuery({
+                    projectRoot: context.projectRoot,
+                    dbtProjectPath,
+                    metrics: request.metrics,
+                    dimensions: request.dimensions,
+                    filters: request.filters,
+                    timeDimension: request.timeDimension,
+                    orderBy: request.orderBy,
+                    limit: request.limit,
+                    savedQuery: request.savedQuery,
+                });
+                return { sql: compiled.sql, joins: [], tables: [], engine: 'metricflow-cli' };
+            }
+            catch (error) {
+                lastRuntimeError = error instanceof Error ? error : new Error(String(error));
+                if (explicit === 'metricflow-cli' || explicit === 'metricflow')
+                    throw lastRuntimeError;
+                continue;
+            }
+        }
+        const composed = context.semanticLayer.composeQuery({
+            metrics: request.metrics,
+            dimensions: request.dimensions,
+            filters: request.filters,
+            limit: request.limit,
+            timeDimension: request.timeDimension,
+            orderBy: request.orderBy,
+            driver: context.driver,
+            tableMapping: context.tableMapping,
+        });
+        if (composed)
+            return { ...composed, engine: 'native' };
+    }
+    if (fullRuntimeRequested) {
+        throw lastRuntimeError ?? new SemanticRuntimeRequiredError(status.setup ?? 'The requested semantic runtime is unavailable.');
+    }
+    if (lastRuntimeError && !context.semanticLayer.canComposeMetric(request.metrics[0] ?? '')) {
+        throw new SemanticRuntimeRequiredError(lastRuntimeError.message);
+    }
+    return null;
+}
+export async function listRuntimeCompatibleDimensions(projectRoot, semanticLayer, metrics) {
+    if (metrics.length === 0)
+        return [];
+    const status = await getSemanticRuntimeStatus(projectRoot, { probeConfiguredCloud: true });
+    if (status.active === 'dbt-cloud') {
+        const cloud = await listDbtCloudCompatibleDimensions(getEffectiveDbtCloudSemanticSettings(projectRoot), metrics);
+        const localByName = new Map(semanticLayer.listDimensions().map((dimension) => [dimension.name.toLowerCase(), dimension]));
+        return cloud.map((dimension) => localByName.get(dimension.name.toLowerCase()) ?? {
+            name: dimension.name,
+            label: dimension.name.replace(/[_-]+/g, ' '),
+            description: dimension.description ?? '',
+            domain: '',
+            sql: dimension.name,
+            type: dimension.type?.toLowerCase() === 'time' ? 'date' : 'string',
+            table: '',
+            isTimeDimension: dimension.type?.toLowerCase() === 'time',
+            granularities: dimension.granularities.map((value) => value.toLowerCase()),
+            source: { provider: 'dbt', objectType: 'dimension', objectId: dimension.name, objectName: dimension.name },
+        });
+    }
+    return semanticLayer.listCompatibleDimensions(metrics);
+}
+export function semanticMetricExecutionCapability(metricName, semanticLayer, provider, runtime) {
+    const fullRuntime = runtime.active === 'dbt-cloud' || runtime.active === 'metricflow-cli'
+        ? runtime.active
+        : null;
+    if (provider === 'dbt' && fullRuntime) {
+        return { status: 'ready', engine: fullRuntime, reason: null };
+    }
+    if (semanticLayer.canComposeMetric(metricName)) {
+        return { status: 'ready', engine: 'native', reason: null };
+    }
+    const metric = semanticLayer.getMetric(metricName);
+    if (provider === 'dbt') {
+        const kind = metric?.metricType || metric?.aggregation || metric?.type || 'metric';
+        return {
+            status: 'requires_setup',
+            engine: null,
+            reason: `${kind} metric requires a full semantic runtime. ${runtime.setup ?? 'Configure dbt Cloud Semantic Layer or local MetricFlow.'}`,
+        };
+    }
+    return {
+        status: 'unsupported',
+        engine: null,
+        reason: 'The metric does not have enough composable measure and relation metadata.',
+    };
+}
+async function probeDbtCloudSemanticRuntime(projectRoot) {
+    const cloud = getEffectiveDbtCloudSemanticSettings(projectRoot);
+    if (!cloud.configured || !cloud.fingerprint) {
+        return { ok: false, message: 'dbt Cloud Semantic Layer is not configured.' };
+    }
+    const cached = cloudProbeCache.get(cloud.fingerprint);
+    if (cached && cached.expiresAt > Date.now())
+        return cached.result;
+    const result = await testDbtCloudSemanticConnection(cloud);
+    cloudProbeCache.set(cloud.fingerprint, { expiresAt: Date.now() + 5 * 60_000, result });
+    return result;
+}
+function selectActiveAdapter(preference, cloudReady, cliReady) {
+    if (preference === 'dbt-cloud')
+        return cloudReady ? 'dbt-cloud' : cliReady ? 'metricflow-cli' : 'native';
+    if (preference === 'metricflow-cli')
+        return cliReady ? 'metricflow-cli' : cloudReady ? 'dbt-cloud' : 'native';
+    if (preference === 'native')
+        return 'native';
+    if (cloudReady)
+        return 'dbt-cloud';
+    if (cliReady)
+        return 'metricflow-cli';
+    return 'native';
+}
+export function isSemanticRuntimeError(error) {
+    return error instanceof SemanticRuntimeRequiredError || error instanceof MetricFlowUnavailableError;
+}
+//# sourceMappingURL=semantic-runtime.js.map

package/dist/semantic-runtime.js.map

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

package/dist/version-status.d.ts

@@ -0,0 +1,28 @@
+export interface DqlRuntimeVersionStatus {
+    /** Version of the code actually serving this process. */
+    runningVersion: string;
+    /** ISO timestamp of process start — identifies a server started before a rebuild/upgrade. */
+    processStartedAt: string;
+    /** Where the running code lives: the project's node_modules, a global install, or a dev checkout. */
+    invocationSource: 'project_local' | 'global' | 'dev_or_unknown';
+    /** Range declared for @duckcodeailabs/dql-cli in the project package.json, if any. */
+    projectPinnedRange?: string;
+    /** Version installed in the project's node_modules, if any. */
+    projectInstalledVersion?: string;
+    /** Latest published version from npm, when the background check has succeeded. */
+    latestKnownVersion?: string;
+    latestCheckStatus: 'ok' | 'unknown';
+    /** Human-readable drift warnings; empty means no drift detected. */
+    drift: string[];
+    upgradeCommand?: string;
+}
+/** Best-effort latest published version; never throws, never blocks longer than 2s. */
+export declare function fetchLatestPublishedDqlVersion(): Promise<string | undefined>;
+/** Synchronous view of the cached latest version (health endpoints must stay fast). */
+export declare function cachedLatestPublishedDqlVersion(): string | undefined;
+export declare function resolveDqlRuntimeVersionStatus(input: {
+    projectRoot: string;
+    runningVersion: string;
+    runtimeUrl?: string;
+}): DqlRuntimeVersionStatus;
+//# sourceMappingURL=version-status.d.ts.map

package/dist/version-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-status.d.ts","sourceRoot":"","sources":["../src/version-status.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,gBAAgB,EAAE,MAAM,CAAC;IACzB,qGAAqG;IACrG,gBAAgB,EAAE,eAAe,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAChE,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,IAAI,GAAG,SAAS,CAAC;IACpC,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AASD,uFAAuF;AACvF,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwBlF;AAED,uFAAuF;AACvF,wBAAgB,+BAA+B,IAAI,MAAM,GAAG,SAAS,CAGpE;AAiCD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,uBAAuB,CA4B1B"}

package/dist/version-status.js

@@ -0,0 +1,118 @@
+/**
+ * Runtime version-drift status (REL-002 / Slice 1).
+ *
+ * A stale runtime is the #1 way "the fix didn't work" reports happen: the
+ * project pins one dql-cli version, the global binary is another, and the
+ * long-running server is a third. This module makes drift VISIBLE (doctor,
+ * /api/health, Settings) without ever blocking offline use — the latest-version
+ * lookup is best-effort with a hard 2s timeout and a 24h in-memory cache, and
+ * every failure degrades to 'unknown'.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const PROCESS_STARTED_AT = new Date().toISOString();
+const LATEST_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const LATEST_FETCH_TIMEOUT_MS = 2_000;
+let latestCache;
+let latestInFlight;
+/** Best-effort latest published version; never throws, never blocks longer than 2s. */
+export async function fetchLatestPublishedDqlVersion() {
+    if (process.env.DQL_DISABLE_VERSION_CHECK === '1')
+        return undefined;
+    if (latestCache && Date.now() - latestCache.fetchedAt < LATEST_CACHE_TTL_MS)
+        return latestCache.version;
+    if (latestInFlight)
+        return latestInFlight;
+    latestInFlight = (async () => {
+        try {
+            const res = await fetch('https://registry.npmjs.org/@duckcodeailabs/dql-cli/latest', {
+                signal: AbortSignal.timeout(LATEST_FETCH_TIMEOUT_MS),
+                headers: { accept: 'application/json' },
+            });
+            if (!res.ok)
+                return undefined;
+            const body = await res.json();
+            if (typeof body.version === 'string' && body.version.trim()) {
+                latestCache = { version: body.version.trim(), fetchedAt: Date.now() };
+                return latestCache.version;
+            }
+            return undefined;
+        }
+        catch {
+            return undefined;
+        }
+        finally {
+            latestInFlight = undefined;
+        }
+    })();
+    return latestInFlight;
+}
+/** Synchronous view of the cached latest version (health endpoints must stay fast). */
+export function cachedLatestPublishedDqlVersion() {
+    if (latestCache && Date.now() - latestCache.fetchedAt < LATEST_CACHE_TTL_MS)
+        return latestCache.version;
+    return undefined;
+}
+function readProjectCliDeclaration(projectRoot) {
+    const result = {};
+    try {
+        const pkgPath = join(projectRoot, 'package.json');
+        if (existsSync(pkgPath)) {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            result.range = pkg.devDependencies?.['@duckcodeailabs/dql-cli'] ?? pkg.dependencies?.['@duckcodeailabs/dql-cli'];
+        }
+    }
+    catch { /* unreadable package.json is not a drift signal */ }
+    try {
+        const installedPath = join(projectRoot, 'node_modules', '@duckcodeailabs', 'dql-cli', 'package.json');
+        if (existsSync(installedPath)) {
+            const installed = JSON.parse(readFileSync(installedPath, 'utf-8'));
+            if (typeof installed.version === 'string')
+                result.installed = installed.version;
+        }
+    }
+    catch { /* missing/unreadable install handled by drift text */ }
+    return result;
+}
+function classifyInvocationSource(projectRoot, runtimeUrl) {
+    try {
+        const runtimePath = fileURLToPath(runtimeUrl);
+        if (runtimePath.startsWith(join(projectRoot, 'node_modules')))
+            return 'project_local';
+        if (/[\\/](lib[\\/])?node_modules[\\/]/.test(runtimePath))
+            return 'global';
+    }
+    catch { /* non-file URL (bundled) */ }
+    return 'dev_or_unknown';
+}
+export function resolveDqlRuntimeVersionStatus(input) {
+    const { range, installed } = readProjectCliDeclaration(input.projectRoot);
+    const latest = cachedLatestPublishedDqlVersion();
+    const invocationSource = classifyInvocationSource(input.projectRoot, input.runtimeUrl ?? import.meta.url);
+    const drift = [];
+    if (installed && input.runningVersion !== 'unknown' && installed !== input.runningVersion) {
+        drift.push(`The running DQL server is ${input.runningVersion}, but this project's local install is ${installed}. Restart via the project (npx dql / npm run notebook) or align the versions — fixes in one are invisible in the other.`);
+    }
+    if (latest && input.runningVersion !== 'unknown' && input.runningVersion !== latest) {
+        drift.push(`A newer dql-cli is published (${latest}; running ${input.runningVersion}).`);
+    }
+    if (latest && installed && installed !== latest) {
+        drift.push(`The project pins/installs ${installed}, but ${latest} is the latest published version.`);
+    }
+    const upgradeCommand = installed
+        ? `npm install @duckcodeailabs/dql-cli@${latest ?? 'latest'}`
+        : `npm install -g @duckcodeailabs/dql-cli@${latest ?? 'latest'}`;
+    return {
+        runningVersion: input.runningVersion,
+        processStartedAt: PROCESS_STARTED_AT,
+        invocationSource,
+        ...(range ? { projectPinnedRange: range } : {}),
+        ...(installed ? { projectInstalledVersion: installed } : {}),
+        ...(latest ? { latestKnownVersion: latest } : {}),
+        latestCheckStatus: latest ? 'ok' : 'unknown',
+        drift,
+        ...(drift.length > 0 ? { upgradeCommand } : {}),
+    };
+}
+//# sourceMappingURL=version-status.js.map

package/dist/version-status.js.map

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

package/package.json

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