@duckcodeailabs/dql-cli 1.4.3 → 1.5.0

package/dist/local-runtime.test.js

@@ -0,0 +1,241 @@
+import { describe, expect, it } from 'vitest';
+import { createBlockArtifacts, createSemanticBuilderBlock, formatLocalQueryRuntimeError, normalizeProjectConnection, prepareLocalExecution, resolveProjectRelativeSqlPaths, serializeJSON, validateBlockStudioSource, } from './local-runtime.js';
+import { afterEach } from 'vitest';
+import { mkdtempSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { SemanticLayer } from '@duckcodeailabs/dql-core';
+const tempDirs = [];
+afterEach(() => {
+    while (tempDirs.length > 0) {
+        const dir = tempDirs.pop();
+        if (dir)
+            rmSync(dir, { recursive: true, force: true });
+    }
+});
+describe('formatLocalQueryRuntimeError', () => {
+    it('explains missing DuckDB native bindings with actionable guidance', () => {
+        const message = formatLocalQueryRuntimeError({ driver: 'file', filepath: ':memory:' }, new Error("Cannot find module '/tmp/duckdb/lib/binding/duckdb.node'"));
+        expect(message).toContain('DuckDB native bindings could not be loaded');
+        expect(message).toContain(`Current Node.js runtime: ${process.versions.node}`);
+        expect(message).toContain('Node 18, 20, or 22');
+        expect(message).toContain('pnpm install');
+    });
+});
+describe('serializeJSON', () => {
+    it('serializes safe bigint values as numbers', () => {
+        expect(serializeJSON({ revenue: 42n })).toBe('{"revenue":42}');
+    });
+    it('serializes unsafe bigint values as strings', () => {
+        const value = BigInt(Number.MAX_SAFE_INTEGER) + 1n;
+        expect(serializeJSON({ revenue: value })).toBe(`{"revenue":"${value.toString()}"}`);
+    });
+});
+describe('resolveProjectRelativeSqlPaths', () => {
+    it('rewrites notebook sample file paths relative to the selected project', () => {
+        const sql = "SELECT * FROM read_csv_auto('./data/revenue.csv')";
+        const resolved = resolveProjectRelativeSqlPaths(sql, '/tmp/demo-project');
+        expect(resolved).toBe("SELECT * FROM read_csv_auto('/tmp/demo-project/data/revenue.csv')");
+    });
+    it('leaves unrelated string literals untouched', () => {
+        const sql = "SELECT './data/revenue.csv' AS label";
+        expect(resolveProjectRelativeSqlPaths(sql, '/tmp/demo-project')).toBe(sql);
+    });
+});
+describe('normalizeProjectConnection', () => {
+    it('resolves relative local database paths against the project root', () => {
+        expect(normalizeProjectConnection({ driver: 'duckdb', filepath: './local/dev.duckdb' }, '/tmp/demo-project')).toEqual({ driver: 'duckdb', filepath: '/tmp/demo-project/local/dev.duckdb' });
+    });
+});
+describe('prepareLocalExecution', () => {
+    it('rewrites SQL paths for file-backed notebook queries', () => {
+        const prepared = prepareLocalExecution("SELECT * FROM read_csv_auto('./data/revenue.csv')", { driver: 'file', filepath: ':memory:' }, '/tmp/demo-project', { dataDir: './data' });
+        expect(prepared.connection).toEqual({ driver: 'file', filepath: ':memory:' });
+        expect(prepared.sql).toBe("SELECT * FROM read_csv_auto('/tmp/demo-project/data/revenue.csv')");
+    });
+});
+describe('semantic block save artifacts', () => {
+    it('writes both the block file and semantic companion metadata for save-from-cell flows', () => {
+        const projectRoot = mkdtempSync(join(tmpdir(), 'dql-block-artifacts-'));
+        tempDirs.push(projectRoot);
+        writeFileSync(join(projectRoot, 'dql.config.json'), '{}\n');
+        const created = createBlockArtifacts(projectRoot, {
+            name: 'Revenue Summary',
+            domain: 'finance',
+            content: 'SELECT @metric(total_revenue), @dim(order_date);',
+            description: 'Finance summary block',
+            tags: ['finance', 'exec'],
+        });
+        expect(created.path).toBe('blocks/finance/revenue-summary.dql');
+        expect(created.companionPath).toBe('semantic-layer/blocks/finance/revenue-summary.yaml');
+        expect(readFileSync(join(projectRoot, created.path), 'utf-8')).toContain('@metric(total_revenue)');
+        const companion = readFileSync(join(projectRoot, created.companionPath), 'utf-8');
+        expect(companion).toContain('provider: dql');
+        expect(companion).toContain('semanticMetrics:');
+        expect(companion).toContain('  - total_revenue');
+        expect(companion).toContain('semanticDimensions:');
+        expect(companion).toContain('  - order_date');
+        expect(companion).toContain('reviewStatus: draft');
+    });
+    it('writes semantic builder blocks with lineage companion metadata', () => {
+        const projectRoot = mkdtempSync(join(tmpdir(), 'dql-builder-artifacts-'));
+        tempDirs.push(projectRoot);
+        writeFileSync(join(projectRoot, 'dql.config.json'), '{}\n');
+        const created = createSemanticBuilderBlock(projectRoot, {
+            name: 'Executive Revenue',
+            domain: 'finance',
+            description: 'Executive revenue cut',
+            owner: 'finance-analytics',
+            tags: ['finance'],
+            metrics: ['total_revenue'],
+            dimensions: ['sales_channel'],
+            timeDimension: { name: 'order_date', granularity: 'month' },
+            chart: 'line',
+            blockType: 'semantic',
+            sql: 'SELECT 1',
+            tables: ['analytics.orders'],
+            provider: 'dbt',
+        });
+        expect(created.path).toBe('blocks/finance/executive-revenue.dql');
+        expect(created.content).toContain('type = "semantic"');
+        expect(created.content).toContain('metric = "total_revenue"');
+        const companion = readFileSync(join(projectRoot, created.companionPath), 'utf-8');
+        expect(companion).toContain('provider: dbt');
+        expect(companion).toContain('lineage:');
+        expect(companion).toContain('analytics.orders');
+        expect(companion).toContain('semanticMetrics:');
+        expect(companion).toContain('  - total_revenue');
+        expect(companion).toContain('semanticDimensions:');
+        expect(companion).toContain('  - sales_channel');
+        expect(companion).toContain('  - order_date');
+    });
+});
+describe('validateBlockStudioSource', () => {
+    const semanticLayer = new SemanticLayer({
+        metrics: [
+            {
+                name: 'total_revenue',
+                label: 'Total Revenue',
+                description: 'Revenue metric',
+                domain: 'finance',
+                sql: 'SUM(revenue)',
+                type: 'sum',
+                table: 'orders',
+                tags: [],
+            },
+        ],
+        dimensions: [
+            {
+                name: 'customer_type',
+                label: 'Customer Type',
+                description: 'Customer type dimension',
+                domain: 'finance',
+                sql: 'customer_type',
+                type: 'string',
+                table: 'orders',
+                tags: [],
+            },
+        ],
+        hierarchies: [],
+    });
+    it('composes executable SQL for semantic blocks with metric and dimensions', () => {
+        const source = `block "Revenue by Type" {
+  domain = "finance"
+  type = "semantic"
+  description = ""
+  owner = ""
+  tags = []
+  metric = "total_revenue"
+  dimensions = ["customer_type"]
+}`;
+        const validation = validateBlockStudioSource(source, semanticLayer);
+        expect(validation.valid).toBe(true);
+        expect(validation.executableSql).toContain('SUM(revenue) AS total_revenue');
+        expect(validation.executableSql).toContain('customer_type AS customer_type');
+        expect(validation.executableSql).toContain('GROUP BY customer_type');
+    });
+    it('returns an actionable diagnostic when a semantic block is missing a metric', () => {
+        const source = `block "Revenue by Type" {
+  domain = "finance"
+  type = "semantic"
+  description = ""
+  owner = ""
+  tags = []
+  dimensions = ["customer_type"]
+}`;
+        const validation = validateBlockStudioSource(source, semanticLayer);
+        expect(validation.valid).toBe(false);
+        expect(validation.executableSql).toBeNull();
+        expect(validation.diagnostics.some((item) => item.code === 'semantic_metric_missing')).toBe(true);
+    });
+    it('returns a semantic validation error for unknown dimensions', () => {
+        const source = `block "Revenue by Type" {
+  domain = "finance"
+  type = "semantic"
+  description = ""
+  owner = ""
+  tags = []
+  metric = "total_revenue"
+  dimensions = ["missing_dimension"]
+}`;
+        const validation = validateBlockStudioSource(source, semanticLayer);
+        expect(validation.valid).toBe(false);
+        expect(validation.diagnostics.some((item) => item.code === 'semantic_ref' && item.message.includes('missing_dimension'))).toBe(true);
+    });
+    it('keeps custom block validation behavior unchanged', () => {
+        const source = `block "Custom Revenue" {
+  domain = "finance"
+  type = "custom"
+  description = ""
+  owner = ""
+  tags = []
+
+  query = """
+SELECT revenue
+FROM orders
+"""
+}`;
+        const validation = validateBlockStudioSource(source, semanticLayer);
+        expect(validation.valid).toBe(true);
+        expect(validation.executableSql).toContain('SELECT revenue');
+    });
+    it('resolves semantic refs inside custom block SQL before execution', () => {
+        const source = `block "Revenue Query" {
+  domain = "finance"
+  type = "custom"
+  description = ""
+  owner = ""
+  tags = []
+
+  query = """
+SELECT
+  @metric(total_revenue),
+  @dim(customer_type)
+FROM orders
+GROUP BY @dim(customer_type)
+"""
+}`;
+        const validation = validateBlockStudioSource(source, semanticLayer);
+        expect(validation.valid).toBe(true);
+        expect(validation.executableSql).toContain('SUM(revenue) AS total_revenue');
+        expect(validation.executableSql).toContain('customer_type AS customer_type');
+        expect(validation.executableSql).toContain('GROUP BY customer_type');
+    });
+    it('returns a semantic validation error for unresolved refs in custom SQL', () => {
+        const source = `block "Broken Revenue Query" {
+  domain = "finance"
+  type = "custom"
+  description = ""
+  owner = ""
+  tags = []
+
+  query = """
+SELECT @metric(missing_metric)
+"""
+}`;
+        const validation = validateBlockStudioSource(source, semanticLayer);
+        expect(validation.valid).toBe(false);
+        expect(validation.diagnostics.some((item) => item.code === 'semantic_ref' && item.message.includes('missing_metric'))).toBe(true);
+    });
+});
+//# sourceMappingURL=local-runtime.test.js.map

package/dist/local-runtime.test.js.map

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

package/dist/metricflow.d.ts

@@ -0,0 +1,35 @@
+export declare class MetricFlowUnavailableError extends Error {
+    constructor(message: string);
+}
+export interface MetricFlowQueryRequest {
+    projectRoot: string;
+    dbtProjectPath?: string;
+    metrics: string[];
+    dimensions: string[];
+    timeDimension?: {
+        name: string;
+        granularity: string;
+    };
+    filters?: Array<{
+        dimension?: string;
+        operator?: string;
+        values?: string[];
+        expression?: string;
+    }>;
+    orderBy?: Array<{
+        name: string;
+        direction?: 'asc' | 'desc';
+    }>;
+    limit?: number;
+    savedQuery?: string;
+}
+export interface MetricFlowCompileResult {
+    sql: string;
+    command: string[];
+    stdout: string;
+    stderr: string;
+}
+export declare function resolveDbtProjectRoot(projectRoot: string, configuredPath?: string): string;
+export declare function hasDbtSemanticManifest(projectRoot: string, configuredPath?: string): boolean;
+export declare function compileMetricFlowQuery(request: MetricFlowQueryRequest): MetricFlowCompileResult;
+//# sourceMappingURL=metricflow.d.ts.map

package/dist/metricflow.d.ts.map

@@ -0,0 +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,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,uBAAuB,CA0C/F"}

package/dist/metricflow.js

@@ -0,0 +1,122 @@
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { spawnSync } from 'node:child_process';
+export class MetricFlowUnavailableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MetricFlowUnavailableError';
+    }
+}
+export function resolveDbtProjectRoot(projectRoot, configuredPath) {
+    return configuredPath ? resolve(projectRoot, configuredPath) : projectRoot;
+}
+export function hasDbtSemanticManifest(projectRoot, configuredPath) {
+    return existsSync(join(resolveDbtProjectRoot(projectRoot, configuredPath), 'target', 'semantic_manifest.json'));
+}
+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 result = spawnSync(bin, args, {
+        cwd: dbtRoot,
+        encoding: 'utf-8',
+        env: process.env,
+    });
+    if (result.error) {
+        if (result.error.code === 'ENOENT') {
+            throw new MetricFlowUnavailableError('MetricFlow CLI was not found. Install dbt Semantic Layer dependencies so `mf` is on PATH, or set DQL_METRICFLOW_BIN to the MetricFlow executable.');
+        }
+        throw result.error;
+    }
+    const stdout = result.stdout ?? '';
+    const stderr = result.stderr ?? '';
+    if (result.status !== 0) {
+        throw new Error(`MetricFlow compile failed (${result.status}): ${stderr || stdout || 'no output'}`);
+    }
+    const sql = extractCompiledSql(stdout);
+    if (!sql) {
+        throw new Error('MetricFlow compile completed but no SQL statement was found in stdout.');
+    }
+    return {
+        sql,
+        command: [bin, ...args],
+        stdout,
+        stderr,
+    };
+}
+function buildMetricFlowArgs(request) {
+    const args = ['query', '--compile'];
+    if (request.savedQuery) {
+        args.push('--saved-query', request.savedQuery);
+    }
+    else {
+        if (request.metrics.length === 0) {
+            throw new Error('MetricFlow semantic query requires at least one metric.');
+        }
+        args.push('--metrics', request.metrics.join(','));
+        const groupBy = [...request.dimensions];
+        if (request.timeDimension) {
+            groupBy.push(`${request.timeDimension.name}__${request.timeDimension.granularity}`);
+        }
+        if (groupBy.length > 0)
+            args.push('--group-by', groupBy.join(','));
+    }
+    for (const where of buildWhereClauses(request.filters ?? [])) {
+        args.push('--where', where);
+    }
+    for (const order of request.orderBy ?? []) {
+        if (!order.name)
+            continue;
+        args.push('--order', `${order.name} ${order.direction ?? 'asc'}`);
+    }
+    if (request.limit && Number.isFinite(request.limit)) {
+        args.push('--limit', String(request.limit));
+    }
+    return args;
+}
+function buildWhereClauses(filters) {
+    return filters.flatMap((filter) => {
+        if (filter.expression?.trim())
+            return [filter.expression.trim()];
+        if (!filter.dimension || !filter.operator)
+            return [];
+        const values = filter.values ?? [];
+        const quote = (value) => /^-?\d+(\.\d+)?$/.test(value.trim())
+            ? value
+            : `'${value.replace(/'/g, "''")}'`;
+        const first = values[0] ?? '';
+        switch (filter.operator) {
+            case 'equals':
+                return values.length <= 1
+                    ? [`{{ Dimension('${filter.dimension}') }} = ${quote(first)}`]
+                    : [`{{ Dimension('${filter.dimension}') }} IN (${values.map(quote).join(', ')})`];
+            case 'not_equals':
+                return [`{{ Dimension('${filter.dimension}') }} != ${quote(first)}`];
+            case 'in':
+                return values.length > 0 ? [`{{ Dimension('${filter.dimension}') }} IN (${values.map(quote).join(', ')})`] : [];
+            case 'not_in':
+                return values.length > 0 ? [`{{ Dimension('${filter.dimension}') }} NOT IN (${values.map(quote).join(', ')})`] : [];
+            case 'gt':
+                return [`{{ Dimension('${filter.dimension}') }} > ${quote(first)}`];
+            case 'gte':
+                return [`{{ Dimension('${filter.dimension}') }} >= ${quote(first)}`];
+            case 'lt':
+                return [`{{ Dimension('${filter.dimension}') }} < ${quote(first)}`];
+            case 'lte':
+                return [`{{ Dimension('${filter.dimension}') }} <= ${quote(first)}`];
+            default:
+                return [];
+        }
+    });
+}
+function extractCompiledSql(output) {
+    const normalized = output.trim();
+    const index = normalized.search(/\b(with|select)\b/i);
+    if (index < 0)
+        return '';
+    return normalized.slice(index).trim().replace(/;?\s*$/, '');
+}
+//# sourceMappingURL=metricflow.js.map

package/dist/metricflow.js.map

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

package/dist/metricflow.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metricflow.test.d.ts.map

package/dist/metricflow.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricflow.test.d.ts","sourceRoot":"","sources":["../src/metricflow.test.ts"],"names":[],"mappings":""}

package/dist/metricflow.test.js

@@ -0,0 +1,54 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { chmodSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { compileMetricFlowQuery, MetricFlowUnavailableError } from './metricflow.js';
+describe('MetricFlow compile wrapper', () => {
+    let tmpDir;
+    let previousBin;
+    beforeEach(() => {
+        tmpDir = mkdtempSync(join(tmpdir(), 'dql-mf-'));
+        previousBin = process.env.DQL_METRICFLOW_BIN;
+    });
+    afterEach(() => {
+        if (previousBin === undefined) {
+            delete process.env.DQL_METRICFLOW_BIN;
+        }
+        else {
+            process.env.DQL_METRICFLOW_BIN = previousBin;
+        }
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('compiles through mf and extracts SQL from mixed stdout', () => {
+        mkdirSync(join(tmpDir, 'target'), { recursive: true });
+        writeFileSync(join(tmpDir, 'target', 'semantic_manifest.json'), '{}', 'utf-8');
+        const bin = join(tmpDir, 'mf');
+        writeFileSync(bin, [
+            '#!/bin/sh',
+            'printf "%s\\n" "$*" > args.txt',
+            'printf "%s\\n" "info: compiling"',
+            'printf "%s\\n" "SELECT metric_time, revenue FROM compiled_metric_sql"',
+        ].join('\n'), 'utf-8');
+        chmodSync(bin, 0o755);
+        process.env.DQL_METRICFLOW_BIN = bin;
+        const result = compileMetricFlowQuery({
+            projectRoot: tmpDir,
+            metrics: ['revenue'],
+            dimensions: ['region'],
+            timeDimension: { name: 'metric_time', granularity: 'month' },
+            filters: [{ expression: "{{ Dimension('region') }} = 'NA'" }],
+            limit: 25,
+        });
+        expect(result.sql).toBe('SELECT metric_time, revenue FROM compiled_metric_sql');
+        expect(result.command).toContain('--compile');
+        expect(result.command).toContain('--metrics');
+    });
+    it('returns a setup error when semantic_manifest.json is missing', () => {
+        expect(() => compileMetricFlowQuery({
+            projectRoot: tmpDir,
+            metrics: ['revenue'],
+            dimensions: [],
+        })).toThrow(MetricFlowUnavailableError);
+    });
+});
+//# sourceMappingURL=metricflow.test.js.map

package/dist/metricflow.test.js.map

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

package/dist/open-browser.d.ts

@@ -0,0 +1,2 @@
+export declare function maybeOpenBrowser(url: string, shouldOpen: boolean): void;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../src/open-browser.ts"],"names":[],"mappings":"AAEA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAevE"}

package/dist/open-browser.js

@@ -0,0 +1,29 @@
+import { spawn } from 'node:child_process';
+export function maybeOpenBrowser(url, shouldOpen) {
+    if (!shouldOpen)
+        return;
+    const command = browserCommand();
+    if (!command)
+        return;
+    try {
+        const child = spawn(command.bin, [...command.args, url], {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+    }
+    catch {
+        // best-effort only; keep CLI flow quiet if no browser opener exists
+    }
+}
+function browserCommand() {
+    switch (process.platform) {
+        case 'darwin':
+            return { bin: 'open', args: [] };
+        case 'win32':
+            return { bin: 'cmd', args: ['/c', 'start', ''] };
+        default:
+            return { bin: 'xdg-open', args: [] };
+    }
+}
+//# sourceMappingURL=open-browser.js.map

package/dist/open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../src/open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,UAAmB;IAC/D,IAAI,CAAC,UAAU;QAAE,OAAO;IAExB,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE;YACvD,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;IACtE,CAAC;AACH,CAAC;AAED,SAAS,cAAc;IACrB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC;QACnD;YACE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/schedule/alerts.d.ts

@@ -0,0 +1,5 @@
+import type { AlertIR } from '@duckcodeailabs/dql-compiler';
+import type { QueryExecutor, ConnectionConfig } from '@duckcodeailabs/dql-connectors';
+import type { AlertEvaluation } from './types.js';
+export declare function evaluateAlerts(alerts: AlertIR[], executor: QueryExecutor, connection: ConnectionConfig): Promise<AlertEvaluation[]>;
+//# sourceMappingURL=alerts.d.ts.map

package/dist/schedule/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/schedule/alerts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,wBAAsB,cAAc,CAClC,MAAM,EAAE,OAAO,EAAE,EACjB,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,eAAe,EAAE,CAAC,CA+B5B"}

package/dist/schedule/alerts.js

@@ -0,0 +1,54 @@
+export async function evaluateAlerts(alerts, executor, connection) {
+    const results = [];
+    for (const alert of alerts) {
+        try {
+            const result = await executor.executeQuery(alert.conditionSQL, [], {}, connection);
+            const firstRow = result.rows[0] ?? {};
+            const firstCol = Object.values(firstRow)[0];
+            const observedValue = toNumber(firstCol);
+            if (observedValue === null) {
+                results.push({
+                    alert,
+                    breached: false,
+                    reason: 'condition SQL did not return a numeric first column',
+                });
+                continue;
+            }
+            const breached = compareThreshold(observedValue, alert.operator ?? '>', alert.threshold ?? 0);
+            results.push({ alert, breached, observedValue });
+        }
+        catch (err) {
+            results.push({
+                alert,
+                breached: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return results;
+}
+function compareThreshold(value, op, threshold) {
+    switch (op) {
+        case '>': return value > threshold;
+        case '<': return value < threshold;
+        case '>=': return value >= threshold;
+        case '<=': return value <= threshold;
+        case '==': return value === threshold;
+        case '!=': return value !== threshold;
+        default: return value > threshold;
+    }
+}
+function toNumber(v) {
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'bigint')
+        return Number(v);
+    if (typeof v === 'string') {
+        const n = Number(v);
+        return Number.isFinite(n) ? n : null;
+    }
+    if (typeof v === 'boolean')
+        return v ? 1 : 0;
+    return null;
+}
+//# sourceMappingURL=alerts.js.map

package/dist/schedule/alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/schedule/alerts.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAiB,EACjB,QAAuB,EACvB,UAA4B;IAE5B,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;YACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEzC,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK;oBACL,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,qDAAqD;iBAC9D,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,QAAQ,IAAI,GAAG,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;YAC9F,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK;gBACL,QAAQ,EAAE,KAAK;gBACf,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,EAAuB,EAAE,SAAiB;IACjF,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,SAAS,CAAC;QACnC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,SAAS,CAAC;QACnC,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,SAAS,CAAC;QACrC,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,SAAS,CAAC;QACrC,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,SAAS,CAAC;QACtC,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,SAAS,CAAC;QACtC,OAAO,CAAC,CAAC,OAAO,KAAK,GAAG,SAAS,CAAC;IACpC,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/schedule/discovery.d.ts

@@ -0,0 +1,4 @@
+import type { ScheduledBlock } from './types.js';
+export declare function discoverScheduledBlocks(projectRoot: string): ScheduledBlock[];
+export declare function deriveBlockName(projectRoot: string, absPath: string): string;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/schedule/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/schedule/discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CA2B7E;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5E"}