@duckcodeailabs/dql-cli 1.0.3 → 1.2.0

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"}

package/dist/schedule/discovery.js

@@ -0,0 +1,36 @@
+import { readFileSync } from 'node:fs';
+import { relative } from 'node:path';
+import { compile } from '@duckcodeailabs/dql-compiler';
+import { collectInputFiles } from '@duckcodeailabs/dql-core';
+export function discoverScheduledBlocks(projectRoot) {
+    const files = collectInputFiles({ projectRoot }).filter((f) => f.endsWith('.dql'));
+    const out = [];
+    for (const path of files) {
+        let source;
+        try {
+            source = readFileSync(path, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const result = compile(source, { file: path });
+        for (const dashboard of result.dashboards) {
+            const meta = dashboard.metadata;
+            if (!meta.schedule?.cron)
+                continue;
+            out.push({
+                path,
+                name: deriveBlockName(projectRoot, path),
+                schedule: meta.schedule,
+                notifications: meta.notifications ?? [],
+                alerts: meta.alerts ?? [],
+            });
+        }
+    }
+    return out;
+}
+export function deriveBlockName(projectRoot, absPath) {
+    const rel = relative(projectRoot, absPath);
+    return rel.replace(/\.dql$/, '').replace(/\\/g, '/');
+}
+//# sourceMappingURL=discovery.js.map

package/dist/schedule/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/schedule/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,MAAM,GAAG,GAAqB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI;gBAAE,SAAS;YACnC,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI;gBACJ,IAAI,EAAE,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC;gBACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;gBACvC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;aAC1B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,OAAe;IAClE,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC"}

package/dist/schedule/notifiers/email.d.ts

@@ -0,0 +1,3 @@
+import type { Notifier } from '../types.js';
+export declare function createEmailNotifier(): Notifier;
+//# sourceMappingURL=email.d.ts.map

package/dist/schedule/notifiers/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/schedule/notifiers/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAE7D,wBAAgB,mBAAmB,IAAI,QAAQ,CA0C9C"}

package/dist/schedule/notifiers/email.js

@@ -0,0 +1,76 @@
+export function createEmailNotifier() {
+    return {
+        type: 'email',
+        async send(recipients, payload) {
+            if (recipients.length === 0) {
+                return { delivered: false, error: 'no email recipients provided' };
+            }
+            const smtpUrl = process.env.DQL_SMTP_URL;
+            const from = process.env.DQL_SMTP_FROM ?? 'dql@localhost';
+            const subject = buildSubject(payload);
+            // Digest runs deliver the rendered HTML + markdown sibling as the email
+            // body; non-digest runs fall back to the legacy alert/query summary.
+            const textBody = payload.markdown ?? buildBody(payload);
+            const htmlBody = payload.html;
+            if (!smtpUrl) {
+                console.log(`[dql schedule] email stub — no DQL_SMTP_URL set`);
+                console.log(`  to: ${recipients.join(', ')}`);
+                console.log(`  subject: ${subject}`);
+                if (htmlBody)
+                    console.log(`  html: ${htmlBody.length} chars`);
+                console.log(textBody);
+                return { delivered: true };
+            }
+            try {
+                // Dynamic import so nodemailer only loads when SMTP is actually configured.
+                const nodemailer = (await import('nodemailer'));
+                const transporter = nodemailer.createTransport(smtpUrl);
+                await transporter.sendMail({
+                    from,
+                    to: recipients.join(', '),
+                    subject,
+                    text: textBody,
+                    ...(htmlBody ? { html: htmlBody } : {}),
+                });
+                return { delivered: true };
+            }
+            catch (err) {
+                return { delivered: false, error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    };
+}
+function buildSubject(payload) {
+    const breached = payload.alerts.filter((a) => a.breached).length;
+    if (payload.markdown) {
+        return `[DQL Digest] ${payload.digestTitle ?? payload.block}`;
+    }
+    const prefix = breached > 0 ? `[DQL ALERT]` : `[DQL]`;
+    return `${prefix} ${payload.block} — ${payload.trigger} run`;
+}
+function buildBody(payload) {
+    const lines = [
+        `Block: ${payload.block}`,
+        `Path: ${payload.path}`,
+        `Started: ${payload.startedAt}`,
+        `Trigger: ${payload.trigger}`,
+        '',
+    ];
+    if (payload.alerts.length > 0) {
+        lines.push('Alerts:');
+        for (const a of payload.alerts) {
+            lines.push(`  ${a.breached ? '!' : '-'} ${a.alert.conditionSQL} ${a.alert.operator ?? '>'} ${a.alert.threshold ?? 0}` +
+                (a.observedValue !== undefined ? ` (observed ${a.observedValue})` : '') +
+                (a.error ? ` [error: ${a.error}]` : ''));
+            if (a.alert.message)
+                lines.push(`    message: ${a.alert.message}`);
+        }
+        lines.push('');
+    }
+    lines.push('Queries:');
+    for (const q of payload.queries) {
+        lines.push(`  ${q.chartId}: ${q.rowCount} rows in ${q.durationMs}ms${q.error ? ` [error: ${q.error}]` : ''}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=email.js.map

package/dist/schedule/notifiers/email.js.map

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

package/dist/schedule/notifiers/file.d.ts

@@ -0,0 +1,3 @@
+import type { Notifier } from '../types.js';
+export declare function createFileNotifier(projectRoot: string): Notifier;
+//# sourceMappingURL=file.d.ts.map

package/dist/schedule/notifiers/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/schedule/notifiers/file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAkBhE"}

package/dist/schedule/notifiers/file.js

@@ -0,0 +1,50 @@
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname, isAbsolute, join } from 'node:path';
+export function createFileNotifier(projectRoot) {
+    return {
+        type: 'file',
+        async send(recipients, payload) {
+            const targets = recipients.length > 0 ? recipients : ['.dql/runs/notifications.log'];
+            try {
+                for (const target of targets) {
+                    const abs = isAbsolute(target) ? target : join(projectRoot, target);
+                    const dir = dirname(abs);
+                    if (!existsSync(dir))
+                        mkdirSync(dir, { recursive: true });
+                    appendFileSync(abs, formatLine(payload) + '\n', 'utf-8');
+                }
+                return { delivered: true };
+            }
+            catch (err) {
+                return { delivered: false, error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    };
+}
+function formatLine(payload) {
+    const breached = payload.alerts.filter((a) => a.breached).length;
+    return JSON.stringify({
+        time: payload.startedAt,
+        block: payload.block,
+        trigger: payload.trigger,
+        breached,
+        alerts: payload.alerts.map((a) => ({
+            condition: a.alert.conditionSQL,
+            operator: a.alert.operator,
+            threshold: a.alert.threshold,
+            observed: a.observedValue,
+            breached: a.breached,
+            message: a.alert.message,
+        })),
+        ...(payload.markdown !== undefined
+            ? {
+                digest: {
+                    title: payload.digestTitle ?? payload.block,
+                    markdown: payload.markdown,
+                    diagnostics: payload.digestDiagnostics ?? [],
+                },
+            }
+            : {}),
+    });
+}
+//# sourceMappingURL=file.js.map

package/dist/schedule/notifiers/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/schedule/notifiers/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtD,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO;YAC5B,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;YACrF,IAAI,CAAC;gBACH,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;oBACpE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;oBACzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;wBAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC1D,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC3D,CAAC;gBACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC7B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACvF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,OAAwB;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IACjE,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,IAAI,EAAE,OAAO,CAAC,SAAS;QACvB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ;QACR,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY;YAC/B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ;YAC1B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS;YAC5B,QAAQ,EAAE,CAAC,CAAC,aAAa;YACzB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;YAChC,CAAC,CAAC;gBACE,MAAM,EAAE;oBACN,KAAK,EAAE,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,KAAK;oBAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,WAAW,EAAE,OAAO,CAAC,iBAAiB,IAAI,EAAE;iBAC7C;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/schedule/notifiers/index.d.ts

@@ -0,0 +1,10 @@
+import type { NotificationIR } from '@duckcodeailabs/dql-compiler';
+import type { NotifierPayload } from '../types.js';
+export interface NotificationDispatchResult {
+    type: string;
+    recipients: string[];
+    delivered: boolean;
+    error?: string;
+}
+export declare function dispatchNotifications(notifications: NotificationIR[], payload: NotifierPayload, projectRoot: string): Promise<NotificationDispatchResult[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/schedule/notifiers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schedule/notifiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,aAAa,CAAC;AAK7D,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,cAAc,EAAE,EAC/B,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,0BAA0B,EAAE,CAAC,CA+BvC"}

package/dist/schedule/notifiers/index.js

@@ -0,0 +1,33 @@
+import { createEmailNotifier } from './email.js';
+import { createFileNotifier } from './file.js';
+import { createSlackNotifier } from './slack.js';
+export async function dispatchNotifications(notifications, payload, projectRoot) {
+    const notifiers = {
+        email: createEmailNotifier(),
+        slack: createSlackNotifier(),
+        file: createFileNotifier(projectRoot),
+    };
+    const out = [];
+    for (const n of notifications) {
+        const notifier = notifiers[n.type];
+        if (!notifier) {
+            out.push({
+                type: n.type,
+                recipients: n.recipients,
+                delivered: false,
+                error: `no notifier registered for type "${n.type}"`,
+            });
+            continue;
+        }
+        const result = await notifier.send(n.recipients, payload);
+        out.push({ type: n.type, recipients: n.recipients, ...result });
+    }
+    // Always append to file log for audit trail, even if no explicit file target.
+    const fileLog = notifiers.file;
+    const auditResult = await fileLog.send([], payload);
+    if (auditResult.delivered || auditResult.error) {
+        out.push({ type: 'file', recipients: ['.dql/runs/notifications.log'], ...auditResult });
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/schedule/notifiers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schedule/notifiers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AASjD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,aAA+B,EAC/B,OAAwB,EACxB,WAAmB;IAEnB,MAAM,SAAS,GAA6B;QAC1C,KAAK,EAAE,mBAAmB,EAAE;QAC5B,KAAK,EAAE,mBAAmB,EAAE;QAC5B,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC;KACtC,CAAC;IAEF,MAAM,GAAG,GAAiC,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,SAAS,EAAE,KAAK;gBAChB,KAAK,EAAE,oCAAoC,CAAC,CAAC,IAAI,GAAG;aACrD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,8EAA8E;IAC9E,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC;IAC/B,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QAC/C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,6BAA6B,CAAC,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/schedule/notifiers/slack.d.ts

@@ -0,0 +1,3 @@
+import type { Notifier } from '../types.js';
+export declare function createSlackNotifier(): Notifier;
+//# sourceMappingURL=slack.d.ts.map

package/dist/schedule/notifiers/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/schedule/notifiers/slack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAE7D,wBAAgB,mBAAmB,IAAI,QAAQ,CAyD9C"}

package/dist/schedule/notifiers/slack.js

@@ -0,0 +1,58 @@
+export function createSlackNotifier() {
+    return {
+        type: 'slack',
+        async send(recipients, payload) {
+            const webhook = process.env.DQL_SLACK_WEBHOOK;
+            if (!webhook) {
+                return {
+                    delivered: false,
+                    error: 'DQL_SLACK_WEBHOOK environment variable is not set',
+                };
+            }
+            const breached = payload.alerts.filter((a) => a.breached);
+            const hasDigest = Boolean(payload.markdown);
+            // Skip noise: no digest to deliver AND no alert breached.
+            if (!hasDigest && breached.length === 0) {
+                return { delivered: true };
+            }
+            const channels = recipients.length > 0 ? recipients : ['#default'];
+            const text = hasDigest
+                ? [
+                    `*[DQL Digest] ${payload.digestTitle ?? payload.block}*`,
+                    `Generated: ${payload.startedAt} (${payload.trigger})`,
+                    '',
+                    truncateMarkdown(payload.markdown, 2500),
+                ].join('\n')
+                : [
+                    `*[DQL] ${payload.block}* — ${breached.length} alert(s) breached`,
+                    `Triggered: ${payload.trigger} at ${payload.startedAt}`,
+                    ...breached.map((a) => `• \`${a.alert.conditionSQL}\` ${a.alert.operator ?? '>'} ${a.alert.threshold ?? 0} — observed \`${a.observedValue}\`${a.alert.message ? ` — ${a.alert.message}` : ''}`),
+                ].join('\n');
+            try {
+                for (const channel of channels) {
+                    const res = await fetch(webhook, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({ channel, text }),
+                    });
+                    if (!res.ok) {
+                        return {
+                            delivered: false,
+                            error: `slack webhook returned ${res.status} ${res.statusText}`,
+                        };
+                    }
+                }
+                return { delivered: true };
+            }
+            catch (err) {
+                return { delivered: false, error: err instanceof Error ? err.message : String(err) };
+            }
+        },
+    };
+}
+function truncateMarkdown(md, limit) {
+    if (md.length <= limit)
+        return md;
+    return md.slice(0, limit).trimEnd() + '\n…';
+}
+//# sourceMappingURL=slack.js.map

package/dist/schedule/notifiers/slack.js.map

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

package/dist/schedule/runner.d.ts

@@ -0,0 +1,11 @@
+import type { QueryExecutor, ConnectionConfig } from '@duckcodeailabs/dql-connectors';
+import type { RunRecord } from './types.js';
+export interface RunOptions {
+    executor: QueryExecutor;
+    connection: ConnectionConfig;
+    projectRoot?: string;
+    trigger?: 'manual' | 'cron';
+    previewRows?: number;
+}
+export declare function runBlock(absPath: string, options: RunOptions): Promise<RunRecord>;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/schedule/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAOtF,OAAO,KAAK,EAAmC,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAwHvF"}

package/dist/schedule/runner.js

@@ -0,0 +1,109 @@
+import { readFileSync } from 'node:fs';
+import { compile } from '@duckcodeailabs/dql-compiler';
+import { findProjectRoot, loadProjectConfig, prepareLocalExecution } from '../local-runtime.js';
+import { isDigestOutput, runDigestBuild } from '../digest.js';
+import { evaluateAlerts } from './alerts.js';
+import { deriveBlockName } from './discovery.js';
+import { dispatchNotifications } from './notifiers/index.js';
+import { writeRunRecord } from './runs.js';
+export async function runBlock(absPath, options) {
+    const projectRoot = options.projectRoot ?? findProjectRoot(process.cwd());
+    const projectConfig = loadProjectConfig(projectRoot);
+    const trigger = options.trigger ?? 'manual';
+    const previewRows = options.previewRows ?? 3;
+    const startedAt = new Date().toISOString();
+    const block = deriveBlockName(projectRoot, absPath);
+    let queries = [];
+    let alertResults = [];
+    let notifications = [];
+    let error;
+    try {
+        const source = readFileSync(absPath, 'utf-8');
+        const compiled = compile(source, { file: absPath });
+        if (compiled.errors.length > 0) {
+            error = compiled.errors.join('; ');
+        }
+        const dashboard = compiled.dashboards[0];
+        if (!dashboard) {
+            error = error ?? 'compile produced no dashboards';
+        }
+        else {
+            // Execute each chart query.
+            for (const q of dashboard.metadata.queries) {
+                const t0 = Date.now();
+                try {
+                    const prepared = prepareLocalExecution(q.sql, options.connection, projectRoot, projectConfig);
+                    const result = await options.executor.executeQuery(prepared.sql, [], {}, prepared.connection);
+                    queries.push({
+                        chartId: q.id,
+                        sql: q.sql,
+                        rowCount: result.rows.length,
+                        durationMs: Date.now() - t0,
+                        preview: result.rows.slice(0, previewRows),
+                    });
+                }
+                catch (err) {
+                    queries.push({
+                        chartId: q.id,
+                        sql: q.sql,
+                        rowCount: 0,
+                        durationMs: Date.now() - t0,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+            // Evaluate alerts.
+            alertResults = await evaluateAlerts(dashboard.metadata.alerts ?? [], options.executor, options.connection);
+            // Fire notifications only if at least one alert breached OR no alerts were
+            // declared (so scheduled runs without alerts still produce an audit entry).
+            const anyBreached = alertResults.some((a) => a.breached);
+            const hasAlerts = alertResults.length > 0;
+            const shouldNotify = anyBreached || !hasAlerts;
+            if (shouldNotify && (dashboard.metadata.notifications?.length ?? 0) > 0) {
+                const payload = {
+                    block,
+                    path: absPath,
+                    startedAt,
+                    alerts: alertResults,
+                    queries,
+                    trigger,
+                };
+                if (isDigestOutput(dashboard)) {
+                    try {
+                        const digest = await runDigestBuild(dashboard, projectRoot);
+                        payload.html = digest.html;
+                        payload.markdown = digest.markdown;
+                        payload.digestTitle = dashboard.metadata.title ?? block;
+                        payload.digestDiagnostics = digest.diagnostics;
+                    }
+                    catch (err) {
+                        payload.digestDiagnostics = [
+                            {
+                                level: 'warning',
+                                message: `digest build failed: ${err instanceof Error ? err.message : String(err)}`,
+                            },
+                        ];
+                    }
+                }
+                notifications = await dispatchNotifications(dashboard.metadata.notifications ?? [], payload, projectRoot);
+            }
+        }
+    }
+    catch (err) {
+        error = err instanceof Error ? err.message : String(err);
+    }
+    const record = {
+        startedAt,
+        finishedAt: new Date().toISOString(),
+        block,
+        path: absPath,
+        trigger,
+        queries,
+        alerts: alertResults,
+        notifications,
+        error,
+    };
+    writeRunRecord(projectRoot, record);
+    return record;
+}
+//# sourceMappingURL=runner.js.map

package/dist/schedule/runner.js.map

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

package/dist/schedule/runs.d.ts

@@ -0,0 +1,5 @@
+import type { RunRecord } from './types.js';
+export declare function ensureRunsDir(projectRoot: string): string;
+export declare function writeRunRecord(projectRoot: string, record: RunRecord): string;
+export declare function listRunRecords(projectRoot: string, limit?: number): RunRecord[];
+//# sourceMappingURL=runs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/schedule/runs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,CAO7E;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,SAAS,EAAE,CAoB3E"}

package/dist/schedule/runs.js

@@ -0,0 +1,40 @@
+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 {
+            /* skip malformed */
+        }
+    }
+    return records;
+}
+//# sourceMappingURL=runs.js.map

package/dist/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,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/schedule/service.d.ts

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

package/dist/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;AAItF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,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,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiDhG"}