@duckcodeailabs/dql-cli 1.8.4 → 1.8.6

package/dist/metricflow-installer.d.ts

@@ -0,0 +1,56 @@
+export type MetricFlowWarehouseAdapter = 'duckdb' | 'snowflake' | 'bigquery' | 'databricks' | 'redshift' | 'postgres' | 'trino';
+export type MetricFlowInstallState = 'idle' | 'queued' | 'running' | 'completed' | 'failed';
+export type MetricFlowInstallStage = 'detecting_python' | 'creating_environment' | 'installing' | 'parsing' | 'testing' | 'ready';
+export interface MetricFlowInstallJob {
+    id: string;
+    state: MetricFlowInstallState;
+    stage: MetricFlowInstallStage;
+    progress: number;
+    adapter: MetricFlowWarehouseAdapter;
+    packageSpec: string;
+    message: string;
+    createdAt: string;
+    updatedAt: string;
+    runtimePath: string;
+    runtimeVersion?: string;
+    logs: string[];
+    error?: string;
+}
+export interface MetricFlowInstallInput {
+    adapter: MetricFlowWarehouseAdapter;
+    dbtProjectDir: string;
+    profilesDir?: string;
+}
+type CommandResult = {
+    stdout: string;
+    stderr: string;
+};
+type CommandRunner = (command: string, args: string[], options: {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    timeoutMs: number;
+    onOutput: (line: string) => void;
+}) => Promise<CommandResult>;
+/** API-004 / UI-009: keep the Python semantic engine isolated and versioned
+ * independently from the user's system dbt installation. */
+export declare function metricFlowPackageSpec(adapter: MetricFlowWarehouseAdapter): string;
+export declare function metricFlowAdapterForDriver(driver: string | undefined): MetricFlowWarehouseAdapter | null;
+export declare function isMetricFlowWarehouseAdapter(value: unknown): value is MetricFlowWarehouseAdapter;
+export declare function managedMetricFlowPython(projectRoot: string): string;
+export declare function managedMetricFlowDbt(projectRoot: string): string;
+export declare class ManagedMetricFlowInstaller {
+    private readonly projectRoot;
+    private readonly runner;
+    private readonly jobs;
+    private latestId;
+    constructor(projectRoot: string, runner?: CommandRunner);
+    latest(): MetricFlowInstallJob | null;
+    get(id: string): MetricFlowInstallJob | null;
+    start(input: MetricFlowInstallInput): MetricFlowInstallJob;
+    private update;
+    private log;
+    private run;
+}
+export declare function metricFlowPythonCandidates(explicit?: string): string[];
+export {};
+//# sourceMappingURL=metricflow-installer.d.ts.map

package/dist/metricflow-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricflow-installer.d.ts","sourceRoot":"","sources":["../src/metricflow-installer.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;AAChI,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAC5F,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG,sBAAsB,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAElI,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,sBAAsB,CAAC;IAC9B,KAAK,EAAE,sBAAsB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,0BAA0B,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,0BAA0B,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,aAAa,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACxD,KAAK,aAAa,GAAG,CACnB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,KACnG,OAAO,CAAC,aAAa,CAAC,CAAC;AAY5B;4DAC4D;AAC5D,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAGjF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,0BAA0B,GAAG,IAAI,CAaxG;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAEhG;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,qBAAa,0BAA0B;IAKnC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2C;IAChE,OAAO,CAAC,QAAQ,CAAuB;gBAGpB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,aAA0B;IAGrD,MAAM,IAAI,oBAAoB,GAAG,IAAI;IAIrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAI5C,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,oBAAoB;IA4B1D,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,GAAG;YAYG,GAAG;CA4ElB;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAatE"}

package/dist/metricflow-installer.js

@@ -0,0 +1,276 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { managedMetricFlowBin, managedMetricFlowRuntimeRoot } from './metricflow.js';
+const SUPPORTED_ADAPTERS = new Set([
+    'duckdb',
+    'snowflake',
+    'bigquery',
+    'databricks',
+    'redshift',
+    'postgres',
+    'trino',
+]);
+/** API-004 / UI-009: keep the Python semantic engine isolated and versioned
+ * independently from the user's system dbt installation. */
+export function metricFlowPackageSpec(adapter) {
+    if (!SUPPORTED_ADAPTERS.has(adapter))
+        throw new Error(`Unsupported MetricFlow warehouse adapter: ${adapter}`);
+    return `dbt-metricflow[dbt-${adapter}]>=0.13,<0.14`;
+}
+export function metricFlowAdapterForDriver(driver) {
+    switch (driver?.trim().toLowerCase()) {
+        case 'file':
+        case 'duckdb': return 'duckdb';
+        case 'postgresql':
+        case 'postgres': return 'postgres';
+        case 'snowflake': return 'snowflake';
+        case 'bigquery': return 'bigquery';
+        case 'databricks': return 'databricks';
+        case 'redshift': return 'redshift';
+        case 'trino': return 'trino';
+        default: return null;
+    }
+}
+export function isMetricFlowWarehouseAdapter(value) {
+    return typeof value === 'string' && SUPPORTED_ADAPTERS.has(value);
+}
+export function managedMetricFlowPython(projectRoot) {
+    return process.platform === 'win32'
+        ? join(managedMetricFlowRuntimeRoot(projectRoot), 'Scripts', 'python.exe')
+        : join(managedMetricFlowRuntimeRoot(projectRoot), 'bin', 'python');
+}
+export function managedMetricFlowDbt(projectRoot) {
+    return process.platform === 'win32'
+        ? join(managedMetricFlowRuntimeRoot(projectRoot), 'Scripts', 'dbt.exe')
+        : join(managedMetricFlowRuntimeRoot(projectRoot), 'bin', 'dbt');
+}
+export class ManagedMetricFlowInstaller {
+    projectRoot;
+    runner;
+    jobs = new Map();
+    latestId = null;
+    constructor(projectRoot, runner = runCommand) {
+        this.projectRoot = projectRoot;
+        this.runner = runner;
+    }
+    latest() {
+        return this.latestId ? cloneJob(this.jobs.get(this.latestId) ?? null) : null;
+    }
+    get(id) {
+        return cloneJob(this.jobs.get(id) ?? null);
+    }
+    start(input) {
+        const current = this.latest();
+        if (current && (current.state === 'queued' || current.state === 'running'))
+            return current;
+        if (!SUPPORTED_ADAPTERS.has(input.adapter))
+            throw new Error(`Unsupported MetricFlow warehouse adapter: ${input.adapter}`);
+        if (!existsSync(join(input.dbtProjectDir, 'dbt_project.yml'))) {
+            throw new Error('Connect a valid dbt project before installing its semantic runtime.');
+        }
+        const now = new Date().toISOString();
+        const id = `metricflow-install-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+        const job = {
+            id,
+            state: 'queued',
+            stage: 'detecting_python',
+            progress: 3,
+            adapter: input.adapter,
+            packageSpec: metricFlowPackageSpec(input.adapter),
+            message: 'Preparing the isolated MetricFlow runtime.',
+            createdAt: now,
+            updatedAt: now,
+            runtimePath: managedMetricFlowRuntimeRoot(this.projectRoot),
+            logs: [],
+        };
+        this.jobs.set(id, job);
+        this.latestId = id;
+        queueMicrotask(() => void this.run(id, input));
+        return cloneJob(job);
+    }
+    update(id, patch) {
+        const current = this.jobs.get(id);
+        if (!current)
+            return null;
+        const next = { ...current, ...patch, updatedAt: new Date().toISOString() };
+        this.jobs.set(id, next);
+        return next;
+    }
+    log(id, raw) {
+        const current = this.jobs.get(id);
+        if (!current)
+            return;
+        const additions = redactInstallOutput(raw)
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => line.slice(0, 500));
+        if (additions.length === 0)
+            return;
+        this.update(id, { logs: [...current.logs, ...additions].slice(-120) });
+    }
+    async run(id, input) {
+        const onOutput = (line) => this.log(id, line);
+        try {
+            this.update(id, { state: 'running', message: 'Detecting a compatible Python runtime.' });
+            const python = detectPythonExecutable();
+            this.log(id, `Using ${python.bin} (${python.version}).`);
+            const runtimeRoot = managedMetricFlowRuntimeRoot(this.projectRoot);
+            mkdirSync(join(this.projectRoot, '.dql', 'runtimes'), { recursive: true });
+            this.update(id, { stage: 'creating_environment', progress: 12, message: 'Creating an isolated project-local Python environment.' });
+            await this.runner(python.bin, ['-m', 'venv', runtimeRoot], {
+                cwd: this.projectRoot,
+                timeoutMs: 90_000,
+                onOutput,
+            });
+            const runtimePython = managedMetricFlowPython(this.projectRoot);
+            this.update(id, { stage: 'installing', progress: 28, message: `Installing MetricFlow for ${input.adapter}. This can take a few minutes.` });
+            await this.runner(runtimePython, [
+                '-m', 'pip', 'install', '--disable-pip-version-check', '--upgrade', metricFlowPackageSpec(input.adapter),
+            ], {
+                cwd: this.projectRoot,
+                timeoutMs: 10 * 60_000,
+                onOutput,
+            });
+            const environment = {
+                ...process.env,
+                ...(input.profilesDir ? { DBT_PROFILES_DIR: input.profilesDir } : {}),
+            };
+            const semanticManifestPath = join(input.dbtProjectDir, 'target', 'semantic_manifest.json');
+            if (!existsSync(semanticManifestPath)) {
+                this.update(id, { stage: 'parsing', progress: 78, message: 'Generating the dbt semantic manifest.' });
+                await this.runner(managedMetricFlowDbt(this.projectRoot), [
+                    'parse', '--project-dir', input.dbtProjectDir,
+                    ...(input.profilesDir ? ['--profiles-dir', input.profilesDir] : []),
+                ], {
+                    cwd: input.dbtProjectDir,
+                    env: environment,
+                    timeoutMs: 3 * 60_000,
+                    onOutput,
+                });
+            }
+            this.update(id, { stage: 'testing', progress: 88, message: 'Testing MetricFlow against the connected dbt project.' });
+            const version = await this.runner(managedMetricFlowBin(this.projectRoot), ['--version'], {
+                cwd: input.dbtProjectDir,
+                env: environment,
+                timeoutMs: 30_000,
+                onOutput,
+            });
+            await this.runner(managedMetricFlowBin(this.projectRoot), ['list', 'metrics'], {
+                cwd: input.dbtProjectDir,
+                env: environment,
+                timeoutMs: 2 * 60_000,
+                onOutput,
+            });
+            const runtimeVersion = `${version.stdout}\n${version.stderr}`.trim().split(/\r?\n/)[0] || 'MetricFlow installed';
+            this.update(id, {
+                state: 'completed',
+                stage: 'ready',
+                progress: 100,
+                runtimeVersion,
+                message: 'MetricFlow is installed, tested, and active for this project.',
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.log(id, message);
+            this.update(id, {
+                state: 'failed',
+                progress: Math.max(5, this.jobs.get(id)?.progress ?? 5),
+                message: 'MetricFlow setup needs attention. Your existing dbt and DQL configuration was not replaced.',
+                error: message,
+            });
+        }
+    }
+}
+export function metricFlowPythonCandidates(explicit) {
+    // Prefer a compatible, version-pinned interpreter before the unversioned
+    // binaries. Homebrew may make `python3` point at a newer release before
+    // dbt-metricflow supports it while keeping python3.13/3.12 installed.
+    return [
+        ...(explicit?.trim() ? [explicit.trim()] : []),
+        'python3.13',
+        'python3.12',
+        'python3.11',
+        'python3.10',
+        'python3',
+        'python',
+    ];
+}
+function detectPythonExecutable() {
+    const candidates = metricFlowPythonCandidates(process.env.DQL_PYTHON_BIN);
+    for (const bin of candidates) {
+        const result = spawnSync(bin, ['--version'], { encoding: 'utf-8', timeout: 3000, env: process.env });
+        if (result.error || result.status !== 0)
+            continue;
+        const version = `${result.stdout ?? ''}${result.stderr ?? ''}`.trim();
+        const parsed = /Python\s+(\d+)\.(\d+)/i.exec(version);
+        if (!parsed)
+            continue;
+        const major = Number(parsed[1]);
+        const minor = Number(parsed[2]);
+        if (major === 3 && minor >= 10 && minor < 14)
+            return { bin, version };
+    }
+    throw new Error('Compatible Python 3.10–3.13 was not found. Install an approved version, or set DQL_PYTHON_BIN to that executable.');
+}
+function runCommand(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: options.env ?? process.env,
+            shell: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        const fail = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            reject(error);
+        };
+        const append = (kind, chunk) => {
+            const text = String(chunk);
+            if (kind === 'stdout')
+                stdout = `${stdout}${text}`.slice(-256_000);
+            else
+                stderr = `${stderr}${text}`.slice(-256_000);
+            options.onOutput(text);
+        };
+        child.stdout?.on('data', (chunk) => append('stdout', chunk));
+        child.stderr?.on('data', (chunk) => append('stderr', chunk));
+        const timer = setTimeout(() => {
+            child.kill('SIGTERM');
+            fail(new Error(`${command} timed out after ${Math.round(options.timeoutMs / 1000)} seconds.`));
+        }, options.timeoutMs);
+        child.on('error', (error) => {
+            clearTimeout(timer);
+            fail(error);
+        });
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            if (settled)
+                return;
+            settled = true;
+            if (code === 0)
+                resolve({ stdout, stderr });
+            else
+                reject(new Error(`${command} exited with code ${code ?? 'unknown'}: ${redactInstallOutput(stderr || stdout).trim().slice(-2000)}`));
+        });
+    });
+}
+function redactInstallOutput(value) {
+    return value
+        .replace(/(https?:\/\/)[^\s/@:]+:[^\s/@]+@/gi, '$1***@')
+        .replace(/(https?:\/\/)[^\s/@]+@/gi, '$1***@')
+        .replace(/([?&](?:access_token|auth|key|password|secret|token)=)[^&\s]+/gi, '$1***')
+        .replace(/(authorization:\s*)(?:bearer\s+)?[^\s]+/gi, '$1***')
+        .replace(/\b(token|password|secret|api[_-]?key)=([^\s]+)/gi, '$1=***');
+}
+function cloneJob(job) {
+    return job ? { ...job, logs: [...job.logs] } : null;
+}
+//# sourceMappingURL=metricflow-installer.js.map

package/dist/metricflow-installer.js.map

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

package/dist/metricflow.d.ts

@@ -1,9 +1,16 @@
+export type MetricFlowCliSource = 'env' | 'managed' | 'path';
+export interface MetricFlowCliResolution {
+    bin: string;
+    source: MetricFlowCliSource;
+    version: string;
+}
 export declare class MetricFlowUnavailableError extends Error {
     constructor(message: string);
 }
 export interface MetricFlowQueryRequest {
     projectRoot: string;
     dbtProjectPath?: string;
+    profilesDir?: string;
     metrics: string[];
     dimensions: string[];
     timeDimension?: {
@@ -23,15 +30,26 @@ export interface MetricFlowQueryRequest {
     limit?: number;
     savedQuery?: string;
 }
+export declare function managedMetricFlowRuntimeRoot(projectRoot: string): string;
+export declare function managedMetricFlowBin(projectRoot: string): string;
+/** Resolve the semantic compiler without mutating PATH. A DQL-managed,
+ * project-local runtime is considered before the user's ambient executable so
+ * Settings installations work after completion without restarting the server. */
+export declare function resolveMetricFlowCli(projectRoot?: string): MetricFlowCliResolution | null;
 export interface MetricFlowCompileResult {
     sql: string;
     command: string[];
     stdout: string;
     stderr: string;
 }
+export type MetricFlowCompileMode = 'legacy-compile' | 'explain';
+/** dbt-metricflow 0.13 removed `mf query --compile`. Its quiet explain mode
+ * emits only the compiled SQL and does not print the result table. Keep the
+ * legacy flag for existing user-managed MetricFlow installations. */
+export declare function metricFlowCompileMode(version: string): MetricFlowCompileMode;
 export declare function resolveDbtProjectRoot(projectRoot: string, configuredPath?: string): string;
 export declare function hasDbtSemanticManifest(projectRoot: string, configuredPath?: string): boolean;
 /** Check whether the configured MetricFlow executable is callable. */
-export declare function hasMetricFlowCli(): boolean;
+export declare function hasMetricFlowCli(projectRoot?: string): boolean;
 export declare function compileMetricFlowQuery(request: MetricFlowQueryRequest): MetricFlowCompileResult;
 //# sourceMappingURL=metricflow.d.ts.map

package/dist/metricflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metricflow.d.ts","sourceRoot":"","sources":["../src/metricflow.ts"],"names":[],"mappings":"AAIA,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnG,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAE5F;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,IAAI,OAAO,CAQ1C;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,uBAAuB,CA0C/F"}
+{"version":3,"file":"metricflow.d.ts","sourceRoot":"","sources":["../src/metricflow.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnG,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;iFAEiF;AACjF,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAuBzF;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAEjE;;qEAEqE;AACrE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAM5E;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAE5F;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,uBAAuB,CAgD/F"}

package/dist/metricflow.js

@@ -7,6 +7,53 @@ export class MetricFlowUnavailableError extends Error {
         this.name = 'MetricFlowUnavailableError';
     }
 }
+export function managedMetricFlowRuntimeRoot(projectRoot) {
+    return join(projectRoot, '.dql', 'runtimes', 'metricflow');
+}
+export function managedMetricFlowBin(projectRoot) {
+    return process.platform === 'win32'
+        ? join(managedMetricFlowRuntimeRoot(projectRoot), 'Scripts', 'mf.exe')
+        : join(managedMetricFlowRuntimeRoot(projectRoot), 'bin', 'mf');
+}
+/** Resolve the semantic compiler without mutating PATH. A DQL-managed,
+ * project-local runtime is considered before the user's ambient executable so
+ * Settings installations work after completion without restarting the server. */
+export function resolveMetricFlowCli(projectRoot) {
+    const explicit = process.env.DQL_METRICFLOW_BIN || process.env.METRICFLOW_BIN;
+    const candidates = explicit
+        ? [{ bin: explicit, source: 'env' }]
+        : [
+            ...(projectRoot ? [{ bin: managedMetricFlowBin(projectRoot), source: 'managed' }] : []),
+            { bin: 'mf', source: 'path' },
+        ];
+    for (const candidate of candidates) {
+        if (candidate.source === 'managed' && !existsSync(candidate.bin))
+            continue;
+        const result = spawnSync(candidate.bin, ['--version'], {
+            encoding: 'utf-8',
+            env: process.env,
+            timeout: 3000,
+        });
+        if (!result.error && result.status === 0) {
+            return {
+                ...candidate,
+                version: `${result.stdout ?? ''}${result.stderr ?? ''}`.trim().split('\n')[0] ?? '',
+            };
+        }
+    }
+    return null;
+}
+/** dbt-metricflow 0.13 removed `mf query --compile`. Its quiet explain mode
+ * emits only the compiled SQL and does not print the result table. Keep the
+ * legacy flag for existing user-managed MetricFlow installations. */
+export function metricFlowCompileMode(version) {
+    const match = /(?:version\s*)?(\d+)\.(\d+)\.(\d+)/i.exec(version);
+    if (!match)
+        return 'legacy-compile';
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return major > 0 || minor >= 13 ? 'explain' : 'legacy-compile';
+}
 export function resolveDbtProjectRoot(projectRoot, configuredPath) {
     return configuredPath ? resolve(projectRoot, configuredPath) : projectRoot;
 }
@@ -14,26 +61,26 @@ export function hasDbtSemanticManifest(projectRoot, configuredPath) {
     return existsSync(join(resolveDbtProjectRoot(projectRoot, configuredPath), 'target', 'semantic_manifest.json'));
 }
 /** Check whether the configured MetricFlow executable is callable. */
-export function hasMetricFlowCli() {
-    const bin = process.env.DQL_METRICFLOW_BIN || process.env.METRICFLOW_BIN || 'mf';
-    const result = spawnSync(bin, ['--version'], {
-        encoding: 'utf-8',
-        env: process.env,
-        timeout: 3000,
-    });
-    return !result.error && result.status === 0;
+export function hasMetricFlowCli(projectRoot) {
+    return resolveMetricFlowCli(projectRoot) !== null;
 }
 export function compileMetricFlowQuery(request) {
     const dbtRoot = resolveDbtProjectRoot(request.projectRoot, request.dbtProjectPath);
     if (!existsSync(join(dbtRoot, 'target', 'semantic_manifest.json'))) {
         throw new MetricFlowUnavailableError('dbt semantic execution requires target/semantic_manifest.json. Run `dbt parse` or `dbt build` in the dbt project, then retry.');
     }
-    const bin = process.env.DQL_METRICFLOW_BIN || process.env.METRICFLOW_BIN || 'mf';
-    const args = buildMetricFlowArgs(request);
+    const resolvedCli = resolveMetricFlowCli(request.projectRoot);
+    const bin = resolvedCli?.bin ?? process.env.DQL_METRICFLOW_BIN ?? process.env.METRICFLOW_BIN ?? 'mf';
+    const args = buildMetricFlowArgs(request, metricFlowCompileMode(resolvedCli?.version ?? ''));
     const result = spawnSync(bin, args, {
         cwd: dbtRoot,
         encoding: 'utf-8',
-        env: process.env,
+        env: {
+            ...process.env,
+            ...(request.profilesDir
+                ? { DBT_PROFILES_DIR: resolve(request.projectRoot, request.profilesDir) }
+                : {}),
+        },
     });
     if (result.error) {
         if (result.error.code === 'ENOENT') {
@@ -57,8 +104,10 @@ export function compileMetricFlowQuery(request) {
         stderr,
     };
 }
-function buildMetricFlowArgs(request) {
-    const args = ['query', '--compile'];
+function buildMetricFlowArgs(request, mode) {
+    const args = mode === 'explain'
+        ? ['query', '--explain', '--quiet']
+        : ['query', '--compile'];
     if (request.savedQuery) {
         args.push('--saved-query', request.savedQuery);
     }
@@ -80,7 +129,11 @@ function buildMetricFlowArgs(request) {
     for (const order of request.orderBy ?? []) {
         if (!order.name)
             continue;
-        args.push('--order', `${order.name} ${order.direction ?? 'asc'}`);
+        args.push('--order', mode === 'explain' && order.direction === 'desc'
+            ? `-${order.name}`
+            : mode === 'explain'
+                ? order.name
+                : `${order.name} ${order.direction ?? 'asc'}`);
     }
     if (request.limit && Number.isFinite(request.limit)) {
         args.push('--limit', String(request.limit));

package/dist/metricflow.js.map

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

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-cli",
-  "version": "1.8.4",
+  "version": "1.8.6",
   "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.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",
+    "@duckcodeailabs/dql-agent": "^1.8.6",
+    "@duckcodeailabs/dql-compiler": "^1.8.6",
+    "@duckcodeailabs/dql-connectors": "^1.8.6",
+    "@duckcodeailabs/dql-core": "^1.8.6",
+    "@duckcodeailabs/dql-governance": "^1.8.6",
+    "@duckcodeailabs/dql-mcp": "^1.8.6",
+    "@duckcodeailabs/dql-notebook": "^1.8.6",
+    "@duckcodeailabs/dql-project": "^1.8.6",
+    "@duckcodeailabs/dql-slack": "^1.8.6",
     "isomorphic-git": "^1.27.0",
     "js-yaml": "^4.1.0",
     "node-cron": "^3.0.3",

package/dist/semantic-runtime.d.ts

@@ -10,12 +10,13 @@ export interface SemanticRuntimeProjectConfig {
     };
     dbt?: {
         projectDir?: string;
+        profilesDir?: string;
     };
 }
 export interface SemanticRuntimeAdapterStatus {
     id: SemanticRuntimeAdapterId;
     label: string;
-    bundled: true;
+    bundled: boolean;
     configured: boolean;
     tested: boolean;
     ready: boolean;
@@ -64,11 +65,20 @@ export interface SemanticRuntimeCompileContext {
 }
 export interface SemanticRuntimeCompileResult extends ComposeQueryResult {
     engine: SemanticRuntimeAdapterId;
+    /** The governed request actually compiled after deterministic normalization. */
+    effectiveRequest: SemanticRuntimeQueryRequest;
 }
 export declare class SemanticRuntimeRequiredError extends Error {
     readonly code = "SEMANTIC_RUNTIME_REQUIRED";
     constructor(message: string);
 }
+/**
+ * API-004 / AGT-001: MetricFlow requires `metric_time` whenever an input metric uses a time offset.
+ * dbt stores that requirement in the metric definition, so normalize it once at
+ * the shared runtime boundary instead of asking every UI and agent route to infer
+ * the same compiler constraint independently.
+ */
+export declare function normalizeSemanticRuntimeQueryRequest(request: SemanticRuntimeQueryRequest, semanticLayer: SemanticLayer): SemanticRuntimeQueryRequest;
 export declare function getSemanticRuntimeStatus(projectRoot: string, options?: {
     probeConfiguredCloud?: boolean;
 }): Promise<SemanticRuntimeStatus>;