@duckcodeailabs/dql-cli 1.4.3 → 1.4.4

package/schedule/runs.js

@@ -0,0 +1,41 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+const RUNS_DIR = '.dql/runs';
+export function ensureRunsDir(projectRoot) {
+    const dir = join(projectRoot, RUNS_DIR);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+export function writeRunRecord(projectRoot, record) {
+    const dir = ensureRunsDir(projectRoot);
+    const stamp = record.startedAt.replace(/[:.]/g, '-');
+    const safeName = record.block.replace(/[^a-zA-Z0-9_-]+/g, '_');
+    const file = join(dir, `${stamp}-${safeName}.json`);
+    writeFileSync(file, JSON.stringify(record, null, 2) + '\n', 'utf-8');
+    return file;
+}
+export function listRunRecords(projectRoot, limit = 20) {
+    const dir = join(projectRoot, RUNS_DIR);
+    if (!existsSync(dir))
+        return [];
+    const files = readdirSync(dir)
+        .filter((f) => f.endsWith('.json'))
+        .sort()
+        .reverse()
+        .slice(0, limit);
+    const records = [];
+    for (const f of files) {
+        try {
+            const raw = readFileSync(join(dir, f), 'utf-8');
+            records.push(JSON.parse(raw));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`[dql schedule] skipping malformed run record ${f}: ${msg}`);
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=runs.js.map

package/schedule/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/schedule/runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAE7B,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,MAAiB;IACnE,MAAM,GAAG,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,QAAQ,OAAO,CAAC,CAAC;IACpD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAmB,EAAE,KAAK,GAAG,EAAE;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAClC,IAAI,EAAE;SACN,OAAO,EAAE;SACT,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAEnB,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/schedule/service.d.ts

@@ -0,0 +1,13 @@
+import { type ConnectionConfig } from '@duckcodeailabs/dql-connectors';
+import type { ScheduledAppDashboard, ScheduledBlock } from './types.js';
+export interface ServiceOptions {
+    projectRoot?: string;
+    connection?: ConnectionConfig;
+}
+export interface StartedService {
+    blocks: ScheduledBlock[];
+    apps: ScheduledAppDashboard[];
+    stop: () => Promise<void>;
+}
+export declare function startScheduleService(options?: ServiceOptions): Promise<StartedService>;
+//# sourceMappingURL=service.d.ts.map

package/schedule/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/schedule/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAKtF,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwFhG"}

package/schedule/service.js

@@ -0,0 +1,87 @@
+import { QueryExecutor } from '@duckcodeailabs/dql-connectors';
+import { buildManifest } from '@duckcodeailabs/dql-core';
+import { findProjectRoot, loadProjectConfig, normalizeProjectConnection } from '../local-runtime.js';
+import { discoverScheduledBlocks } from './discovery.js';
+import { runAppDashboard, runBlock } from './runner.js';
+export async function startScheduleService(options = {}) {
+    const projectRoot = options.projectRoot ?? findProjectRoot(process.cwd());
+    const projectConfig = loadProjectConfig(projectRoot);
+    const connection = options.connection ??
+        normalizeProjectConnection(projectConfig.defaultConnection ?? { driver: 'duckdb' }, projectRoot);
+    const executor = new QueryExecutor();
+    const blocks = discoverScheduledBlocks(projectRoot);
+    const manifest = buildManifest({ projectRoot });
+    const apps = Object.values(manifest.apps ?? {}).flatMap((app) => (app.schedules ?? [])
+        .filter((schedule) => schedule.enabled !== false)
+        .map((schedule) => ({
+        appId: app.id,
+        dashboardId: schedule.dashboard,
+        scheduleId: schedule.id,
+        cron: schedule.cron,
+    })));
+    // Dynamic import so node-cron stays off the hot path for one-shot commands.
+    const nodeCron = (await import('node-cron'));
+    const tasks = [];
+    for (const block of blocks) {
+        if (!nodeCron.validate(block.schedule.cron)) {
+            console.error(`[schedule] invalid cron "${block.schedule.cron}" on ${block.name}, skipping`);
+            continue;
+        }
+        const task = nodeCron.schedule(block.schedule.cron, () => {
+            void (async () => {
+                try {
+                    const record = await runBlock(block.path, {
+                        executor,
+                        connection,
+                        projectRoot,
+                        trigger: 'cron',
+                    });
+                    const breached = record.alerts.filter((a) => a.breached).length;
+                    const tag = record.error ? 'error' : breached > 0 ? `breached:${breached}` : 'ok';
+                    console.log(`[schedule] ${record.startedAt} ${block.name} → ${tag}`);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(`[schedule] run failed for ${block.name}: ${msg}`);
+                }
+            })();
+        });
+        tasks.push({ stop: () => task.stop() });
+    }
+    for (const appSchedule of apps) {
+        if (!nodeCron.validate(appSchedule.cron)) {
+            console.error(`[schedule] invalid cron "${appSchedule.cron}" on ${appSchedule.appId}/${appSchedule.scheduleId}, skipping`);
+            continue;
+        }
+        const task = nodeCron.schedule(appSchedule.cron, () => {
+            void (async () => {
+                try {
+                    const record = await runAppDashboard(appSchedule.appId, appSchedule.dashboardId, {
+                        executor,
+                        connection,
+                        projectRoot,
+                        trigger: 'cron',
+                        scheduleId: appSchedule.scheduleId,
+                    });
+                    const failed = record.queries.filter((q) => q.error).length;
+                    const tag = record.error ? 'error' : failed > 0 ? `tile-errors:${failed}` : 'ok';
+                    console.log(`[schedule] ${record.startedAt} ${appSchedule.appId}/${appSchedule.dashboardId} → ${tag}`);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(`[schedule] app run failed for ${appSchedule.appId}/${appSchedule.scheduleId}: ${msg}`);
+                }
+            })();
+        });
+        tasks.push({ stop: () => task.stop() });
+    }
+    return {
+        blocks,
+        apps,
+        async stop() {
+            for (const t of tasks)
+                t.stop();
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/schedule/service.js.map

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

package/schedule/types.d.ts

@@ -0,0 +1,70 @@
+import type { ScheduleIR, NotificationIR, AlertIR, DigestDiagnostic } from '@duckcodeailabs/dql-compiler';
+export interface ScheduledBlock {
+    /** Absolute path to the .dql file. */
+    path: string;
+    /** Name derived from the path, e.g. "finance/revenue_by_month". */
+    name: string;
+    schedule: ScheduleIR;
+    notifications: NotificationIR[];
+    alerts: AlertIR[];
+}
+export interface ScheduledAppDashboard {
+    appId: string;
+    dashboardId: string;
+    scheduleId: string;
+    cron: string;
+}
+export interface AlertEvaluation {
+    alert: AlertIR;
+    breached: boolean;
+    observedValue?: number;
+    reason?: string;
+    error?: string;
+}
+export interface QueryRunResult {
+    chartId: string;
+    sql: string;
+    rowCount: number;
+    durationMs: number;
+    error?: string;
+    preview?: Array<Record<string, unknown>>;
+}
+export interface RunRecord {
+    startedAt: string;
+    finishedAt: string;
+    block: string;
+    path: string;
+    trigger: 'manual' | 'cron';
+    queries: QueryRunResult[];
+    alerts: AlertEvaluation[];
+    notifications: Array<{
+        type: string;
+        recipients: string[];
+        delivered: boolean;
+        error?: string;
+    }>;
+    error?: string;
+}
+export interface NotifierPayload {
+    block: string;
+    path: string;
+    startedAt: string;
+    alerts: AlertEvaluation[];
+    queries: QueryRunResult[];
+    trigger: 'manual' | 'cron';
+    /** Rendered digest HTML (present when the block is a digest). */
+    html?: string;
+    /** Digest markdown sibling — preferred as an email/slack preview body. */
+    markdown?: string;
+    /** Title/name shown in digest headers, defaults to `block` when absent. */
+    digestTitle?: string;
+    digestDiagnostics?: DigestDiagnostic[];
+}
+export interface Notifier {
+    type: 'email' | 'slack' | 'file';
+    send(recipients: string[], payload: NotifierPayload): Promise<{
+        delivered: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/schedule/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schedule/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE1G,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,UAAU,CAAC;IACrB,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvG"}

package/schedule/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/schedule/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schedule/types.ts"],"names":[],"mappings":""}

package/semantic-import.d.ts

@@ -0,0 +1,135 @@
+import { type CubeDefinition, type HierarchyDefinition, type SemanticLayer, type SemanticLayerProviderConfig, type SemanticSourceMetadata, type SnowflakeQueryExecutor } from '@duckcodeailabs/dql-core';
+export interface SemanticImportManifestObject {
+    id: string;
+    kind: 'cube' | 'metric' | 'measure' | 'dimension' | 'time_dimension' | 'entity' | 'hierarchy' | 'segment' | 'pre_aggregation' | 'semantic_model' | 'saved_query';
+    name: string;
+    label: string;
+    domain: string;
+    cube?: string;
+    filePath: string;
+    source?: SemanticSourceMetadata;
+}
+export interface SemanticImportManifest {
+    version: 1;
+    mode: 'imported';
+    provider: 'dbt' | 'cubejs' | 'snowflake';
+    importedAt: string;
+    source: {
+        projectPath?: string;
+        repoUrl?: string;
+        branch?: string;
+        subPath?: string;
+        connection?: string;
+    };
+    warnings: string[];
+    generatedFiles: string[];
+    objects: SemanticImportManifestObject[];
+}
+export interface SemanticImportResult {
+    manifest: SemanticImportManifest;
+    counts: Record<SemanticImportManifestObject['kind'], number>;
+}
+export interface SemanticImportPreview {
+    provider: 'dbt' | 'cubejs' | 'snowflake';
+    counts: Record<SemanticImportManifestObject['kind'], number>;
+    domains: string[];
+    warnings: string[];
+    objects: Array<{
+        kind: SemanticImportManifestObject['kind'];
+        name: string;
+        label: string;
+        domain: string;
+    }>;
+}
+export interface SemanticSyncDiff {
+    added: Array<{
+        kind: SemanticImportManifestObject['kind'];
+        name: string;
+        label: string;
+        domain: string;
+    }>;
+    removed: Array<{
+        kind: SemanticImportManifestObject['kind'];
+        name: string;
+        label: string;
+        domain: string;
+    }>;
+    changed: Array<{
+        kind: SemanticImportManifestObject['kind'];
+        name: string;
+        label: string;
+        domain: string;
+    }>;
+    unchanged: number;
+}
+export interface SemanticTreeNode {
+    id: string;
+    label: string;
+    kind: 'provider' | 'domain' | 'cube' | 'group' | SemanticImportManifestObject['kind'];
+    count?: number;
+    meta?: Record<string, string | number | boolean | null | undefined>;
+    children?: SemanticTreeNode[];
+}
+export interface SemanticObjectDetail {
+    id: string;
+    kind: SemanticImportManifestObject['kind'];
+    name: string;
+    label: string;
+    description: string;
+    domain: string;
+    cube?: string;
+    table?: string;
+    sql?: string;
+    type?: string;
+    tags: string[];
+    owner: string | null;
+    source: SemanticSourceMetadata | null;
+    filePath: string | null;
+    importedAt: string | null;
+    joins?: CubeDefinition['joins'];
+    levels?: HierarchyDefinition['levels'];
+    measures?: string[];
+    dimensions?: string[];
+    timeDimension?: string;
+    granularity?: string;
+    refreshKey?: string;
+    agg?: string;
+    expr?: string;
+    metricType?: string;
+    typeParams?: Record<string, unknown>;
+    filter?: unknown;
+    entities?: string[];
+    savedQueryMetrics?: string[];
+    exports?: Array<Record<string, unknown>>;
+}
+export declare function performSemanticImport(opts: {
+    targetProjectRoot: string;
+    provider: 'dbt' | 'cubejs' | 'snowflake';
+    sourceConfig: SemanticLayerProviderConfig;
+    executeQuery?: SnowflakeQueryExecutor;
+}): Promise<SemanticImportResult>;
+export declare function syncSemanticImport(opts: {
+    targetProjectRoot: string;
+    executeQuery?: SnowflakeQueryExecutor;
+}): Promise<SemanticImportResult>;
+export declare function loadSemanticImportManifest(projectRoot: string): SemanticImportManifest | null;
+export declare function buildSemanticTree(layer: SemanticLayer, manifest: SemanticImportManifest | null): SemanticTreeNode;
+export declare function buildSemanticObjectDetail(layer: SemanticLayer, manifest: SemanticImportManifest | null, id: string): SemanticObjectDetail | null;
+/**
+ * Preview a semantic import without writing any files.
+ * Returns counts, domains, warnings, and object summaries.
+ */
+export declare function previewSemanticImport(opts: {
+    targetProjectRoot: string;
+    provider: 'dbt' | 'cubejs' | 'snowflake';
+    sourceConfig: SemanticLayerProviderConfig;
+    executeQuery?: SnowflakeQueryExecutor;
+}): Promise<SemanticImportPreview>;
+/**
+ * Compute the diff between the current manifest and a fresh import, without applying changes.
+ */
+export declare function computeSyncDiff(opts: {
+    targetProjectRoot: string;
+    executeQuery?: SnowflakeQueryExecutor;
+}): Promise<SemanticSyncDiff>;
+//# sourceMappingURL=semantic-import.d.ts.map

package/semantic-import.d.ts.map

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