@duckcodeailabs/dql-cli 1.0.3 → 1.2.0

package/dist/schedule/service.js

@@ -0,0 +1,49 @@
+import { QueryExecutor } from '@duckcodeailabs/dql-connectors';
+import { findProjectRoot, loadProjectConfig, normalizeProjectConnection } from '../local-runtime.js';
+import { discoverScheduledBlocks } from './discovery.js';
+import { 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);
+    // 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() });
+    }
+    return {
+        blocks,
+        async stop() {
+            for (const t of tasks)
+                t.stop();
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/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/dist/schedule/types.d.ts

@@ -0,0 +1,64 @@
+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 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/dist/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,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/dist/schedule/types.js

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

package/dist/schedule/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duckcodeailabs/dql-cli",
-  "version": "1.0.3",
+  "version": "1.2.0",
   "description": "Public CLI for parsing, formatting, testing, and certifying DQL blocks",
   "license": "Apache-2.0",
   "type": "module",
@@ -19,18 +19,25 @@
     "directory": "apps/cli"
   },
   "dependencies": {
-    "@duckcodeailabs/dql-connectors": "^1.0.3",
-    "@duckcodeailabs/dql-core": "^1.0.3",
-    "@duckcodeailabs/dql-compiler": "^1.0.3",
-    "@duckcodeailabs/dql-project": "^1.0.3",
-    "@duckcodeailabs/dql-governance": "^1.0.3",
-    "@duckcodeailabs/dql-notebook": "^1.0.3"
+    "@duckcodeailabs/dql-compiler": "^1.2.0",
+    "@duckcodeailabs/dql-connectors": "^1.2.0",
+    "@duckcodeailabs/dql-core": "^1.2.0",
+    "@duckcodeailabs/dql-governance": "^1.2.0",
+    "@duckcodeailabs/dql-mcp": "^1.2.0",
+    "@duckcodeailabs/dql-notebook": "^1.2.0",
+    "@duckcodeailabs/dql-project": "^1.2.0",
+    "isomorphic-git": "^1.27.0",
+    "js-yaml": "^4.1.0",
+    "node-cron": "^3.0.3",
+    "nodemailer": "^6.9.16"
   },
   "devDependencies": {
-    "typescript": "^5.7.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node-cron": "^3.0.11",
+    "@types/nodemailer": "^6.4.17",
     "tsx": "^4.19.0",
-    "vitest": "^3.0.0",
-    "@duckcodeailabs/dql-notebook-app": "1.0.3"
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
   },
   "engines": {
     "node": ">=18.0.0"