@duckcodeailabs/dql-cli 1.4.3 → 1.4.4

package/commands/init.js

@@ -0,0 +1,250 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { basename, join, relative, resolve } from 'node:path';
+import { createWelcomeNotebook, serializeNotebook } from '@duckcodeailabs/dql-notebook';
+import { performSemanticImport } from '../semantic-import.js';
+import { runNotebook } from './notebook.js';
+export async function runInit(targetArg, flags) {
+    const targetDir = resolve(targetArg || '.');
+    const projectName = basename(targetDir) || 'dql-project';
+    // Create target directory if it doesn't exist
+    if (!existsSync(targetDir)) {
+        mkdirSync(targetDir, { recursive: true });
+    }
+    // Refuse to clobber a project that's already been initialized. `--force`
+    // lets us patch missing dirs; it still won't overwrite config/notebooks.
+    const alreadyInitialized = existsSync(join(targetDir, 'dql.config.json')) || existsSync(join(targetDir, 'cdql.yaml'));
+    if (alreadyInitialized && !flags.force) {
+        console.error('✗ This directory already has a DQL project (dql.config.json exists).');
+        console.error('  Re-run with --force to patch missing dirs without overwriting config.');
+        process.exitCode = 1;
+        return;
+    }
+    // Detect if this is a dbt project — either *in* this directory, or as a
+    // sibling (the canonical `acme/dbt/` + `acme/analytics/` layout).
+    let isDbt = existsSync(join(targetDir, 'dbt_project.yml'));
+    let dbtProjectDir = isDbt ? targetDir : null;
+    if (!dbtProjectDir) {
+        for (const rel of ['..', '../..', '../dbt', '../../dbt']) {
+            const probe = join(targetDir, rel, 'dbt_project.yml');
+            if (existsSync(probe)) {
+                dbtProjectDir = resolve(targetDir, rel);
+                isDbt = true;
+                break;
+            }
+        }
+    }
+    const hasDbtSemanticDefinitions = dbtProjectDir
+        ? containsDbtSemanticDefinitions(join(dbtProjectDir, 'models'))
+        : false;
+    // Detect DuckDB file in the directory
+    const duckdbPath = detectDuckDBFile(targetDir);
+    // Don't overwrite existing dql.config.json
+    const configPath = join(targetDir, 'dql.config.json');
+    if (!existsSync(configPath)) {
+        const config = buildConfig(projectName, isDbt, duckdbPath, dbtProjectDir, targetDir);
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    }
+    // Create DQL directories
+    const dirs = ['blocks', 'notebooks'];
+    if (!isDbt) {
+        dirs.push('semantic-layer', 'semantic-layer/metrics', 'semantic-layer/dimensions');
+    }
+    for (const dir of dirs) {
+        const dirPath = join(targetDir, dir);
+        if (!existsSync(dirPath)) {
+            mkdirSync(dirPath, { recursive: true });
+        }
+    }
+    // Create .gitignore for DQL artifacts
+    const gitignorePath = join(targetDir, '.gitignore');
+    const dqlIgnoreEntries = '\n# DQL\ndql-manifest.json\n*.duckdb\n*.duckdb.wal\n.dql/runs/\n.dql/cache/\n*.dqlnb.run.json\n*.dql.run.json\n';
+    if (existsSync(gitignorePath)) {
+        const existing = readFileSync(gitignorePath, 'utf-8');
+        if (!existing.includes('dql-manifest.json')) {
+            writeFileSync(gitignorePath, existing + dqlIgnoreEntries);
+        }
+    }
+    else {
+        writeFileSync(gitignorePath, 'node_modules/\n' + dqlIgnoreEntries);
+    }
+    // Create welcome notebook with driver-aware SQL
+    const notebookPath = join(targetDir, 'notebooks', 'welcome.dqlnb');
+    if (!existsSync(notebookPath)) {
+        const configJson = existsSync(configPath) ? JSON.parse(readFileSync(configPath, 'utf-8')) : {};
+        const driver = configJson?.connections?.default?.driver ?? 'duckdb';
+        const nb = createWelcomeNotebook(isDbt ? 'dbt' : 'default', projectName, driver);
+        writeFileSync(notebookPath, serializeNotebook(nb), 'utf-8');
+    }
+    let importedSemanticCatalog = false;
+    if (isDbt && hasDbtSemanticDefinitions && !existsSync(join(targetDir, 'semantic-layer', 'imports', 'manifest.json'))) {
+        await performSemanticImport({
+            targetProjectRoot: targetDir,
+            provider: 'dbt',
+            sourceConfig: {
+                provider: 'dbt',
+                projectPath: '.',
+            },
+        });
+        importedSemanticCatalog = true;
+    }
+    // Output
+    if (flags.format === 'json') {
+        console.log(JSON.stringify({
+            project: projectName,
+            path: targetDir,
+            created: true,
+            dbt: isDbt,
+            duckdb: duckdbPath ?? null,
+        }, null, 2));
+        return;
+    }
+    console.log(`\n  ✓ DQL project initialized: ${projectName}`);
+    console.log(`    Path: ${targetDir}`);
+    console.log('');
+    console.log('  Detected:');
+    if (isDbt && dbtProjectDir && dbtProjectDir !== targetDir) {
+        console.log(`    dbt project: sibling at ${dbtProjectDir}`);
+    }
+    else {
+        console.log(`    dbt project: ${isDbt ? 'yes (dbt_project.yml found)' : 'no'}`);
+    }
+    console.log(`    DuckDB file: ${duckdbPath ?? 'none (using :memory:)'}`);
+    if (isDbt) {
+        console.log(`    Semantic layer: ${importedSemanticCatalog ? 'imported dbt catalog into semantic-layer/' : hasDbtSemanticDefinitions ? 'dbt project with semantic definitions detected' : 'dbt project detected (no semantic definitions imported)'}`);
+    }
+    console.log('');
+    console.log('  Created:');
+    console.log('    dql.config.json');
+    console.log('    blocks/');
+    console.log('    notebooks/welcome.dqlnb');
+    if (importedSemanticCatalog) {
+        console.log('    semantic-layer/ (imported local semantic catalog)');
+    }
+    console.log('');
+    console.log('  Next steps:');
+    const step = targetArg && targetArg !== '.' ? 1 : 0;
+    if (step === 1)
+        console.log(`    ${step}. cd ${targetArg}`);
+    console.log(`    ${step + 1}. dql doctor`);
+    console.log(`    ${step + 2}. dql notebook`);
+    if (isDbt) {
+        if (!importedSemanticCatalog && hasDbtSemanticDefinitions) {
+            console.log(`    ${step + 3}. dql semantic import dbt .`);
+            console.log(`    ${step + 4}. dql compile --dbt-manifest target/manifest.json`);
+        }
+        else {
+            console.log(`    ${step + 3}. dql compile --dbt-manifest target/manifest.json`);
+        }
+    }
+    console.log('');
+    if (flags.open) {
+        await runNotebook(targetDir, flags);
+    }
+}
+function containsDbtSemanticDefinitions(root) {
+    if (!existsSync(root))
+        return false;
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current)
+            continue;
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const fullPath = join(current, entry);
+            let stats;
+            try {
+                stats = statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (stats.isDirectory()) {
+                stack.push(fullPath);
+                continue;
+            }
+            if (!entry.endsWith('.yml') && !entry.endsWith('.yaml'))
+                continue;
+            try {
+                const contents = readFileSync(fullPath, 'utf-8');
+                if (contents.includes('semantic_models:') || contents.includes('\nmetrics:') || contents.startsWith('metrics:')) {
+                    return true;
+                }
+            }
+            catch {
+                // Ignore unreadable files during best-effort detection.
+            }
+        }
+    }
+    return false;
+}
+function detectDuckDBFile(dir) {
+    // Common DuckDB file locations in dbt projects
+    const candidates = [
+        'jaffle_shop.duckdb',
+        'dev.duckdb',
+        'database.duckdb',
+        'analytics.duckdb',
+        'target/dev.duckdb',
+        'target/jaffle_shop.duckdb',
+        'reports/jaffle_shop.duckdb',
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(join(dir, candidate))) {
+            return candidate;
+        }
+    }
+    // Search root directory for any .duckdb file
+    try {
+        const entries = readdirSync(dir);
+        const duckdb = entries.find((e) => e.endsWith('.duckdb'));
+        return duckdb ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function buildConfig(projectName, isDbt, duckdbPath, dbtProjectDir, projectRoot) {
+    const config = {
+        project: projectName,
+        connections: {
+            default: {
+                driver: 'duckdb',
+                filepath: duckdbPath ?? ':memory:',
+            },
+        },
+    };
+    if (isDbt) {
+        // Normalize dbt path to a repo-relative form if possible — makes
+        // dql.config.json portable across machines.
+        const projectPath = dbtProjectDir && dbtProjectDir !== projectRoot
+            ? relativePath(projectRoot, dbtProjectDir)
+            : '.';
+        config.semanticLayer = {
+            provider: 'dbt',
+            projectPath,
+        };
+        // Tell `dql sync dbt` and `dql compile` where to find target/manifest.json
+        // without requiring --dbt-manifest on every invocation.
+        config.dbt = {
+            projectDir: projectPath,
+            manifestPath: 'target/manifest.json',
+        };
+    }
+    else {
+        config.semanticLayer = {
+            provider: 'dql',
+        };
+    }
+    return config;
+}
+function relativePath(from, to) {
+    return relative(from, to) || '.';
+}
+//# sourceMappingURL=init.js.map

package/commands/init.js.map

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

package/commands/init.test.d.ts

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

package/commands/init.test.d.ts.map

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

package/commands/init.test.js

@@ -0,0 +1,118 @@
+import { mkdirSync, mkdtempSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { describe, expect, it } from 'vitest';
+import { runInit } from './init.js';
+describe('runInit', () => {
+    it('scaffolds a DQL project with config, blocks dir, and notebook', async () => {
+        const targetDir = mkdtempSync(join(tmpdir(), 'dql-init-'));
+        const projectDir = join(targetDir, 'demo-project');
+        await runInit(projectDir, {
+            check: false,
+            chart: '',
+            domain: '',
+            format: 'json',
+            help: false,
+            open: null,
+            input: '',
+            outDir: '',
+            owner: '',
+            port: null,
+            queryOnly: false,
+            template: '',
+            connection: '',
+            verbose: false,
+            skipTests: false, version: false,
+        });
+        const contents = readdirSync(projectDir);
+        expect(contents).toContain('blocks');
+        expect(contents).toContain('dql.config.json');
+        expect(contents).toContain('notebooks');
+        const config = readFileSync(join(projectDir, 'dql.config.json'), 'utf-8');
+        expect(config).toContain('demo-project');
+        expect(config).toContain('duckdb');
+        const notebook = readFileSync(join(projectDir, 'notebooks', 'welcome.dqlnb'), 'utf-8');
+        expect(notebook).toContain('DQL');
+    });
+    it('detects a Jaffle Shop-style dbt project and DuckDB file', async () => {
+        const projectDir = mkdtempSync(join(tmpdir(), 'dql-init-dbt-'));
+        writeFileSync(join(projectDir, 'dbt_project.yml'), 'name: "jaffle_shop"\n');
+        writeFileSync(join(projectDir, 'jaffle_shop.duckdb'), '');
+        await runInit(projectDir, {
+            check: false,
+            chart: '',
+            domain: '',
+            format: 'json',
+            help: false,
+            open: null,
+            input: '',
+            outDir: '',
+            owner: '',
+            port: null,
+            queryOnly: false,
+            template: '',
+            connection: '',
+            verbose: false,
+            skipTests: false, version: false,
+        });
+        const config = JSON.parse(readFileSync(join(projectDir, 'dql.config.json'), 'utf-8'));
+        expect(config.connections.default.filepath).toBe('jaffle_shop.duckdb');
+        expect(config.semanticLayer.provider).toBe('dbt');
+        expect(config.semanticLayer.projectPath).toBe('.');
+        expect(readdirSync(projectDir)).not.toContain('semantic-layer');
+    });
+    it('auto-imports dbt semantic definitions into local semantic-layer YAML on init', async () => {
+        const projectDir = mkdtempSync(join(tmpdir(), 'dql-init-dbt-semantic-'));
+        const metricsDir = join(projectDir, 'models', 'metrics');
+        mkdirSync(metricsDir, { recursive: true });
+        writeFileSync(join(projectDir, 'dbt_project.yml'), 'name: "jaffle_shop"\n');
+        writeFileSync(join(projectDir, 'jaffle_shop.duckdb'), '');
+        writeFileSync(join(metricsDir, 'orders.yml'), `semantic_models:
+  - name: orders
+    model: ref('fct_orders')
+    defaults:
+      agg_time_dimension: ordered_at
+    entities:
+      - name: order
+        type: primary
+        expr: order_id
+    dimensions:
+      - name: ordered_at
+        type: time
+        type_params:
+          time_granularity: day
+    measures:
+      - name: order_total
+        agg: sum
+        expr: order_total
+metrics:
+  - name: order_total
+    type: simple
+    type_params:
+      measure: order_total
+`);
+        await runInit(projectDir, {
+            check: false,
+            chart: '',
+            domain: '',
+            format: 'json',
+            help: false,
+            open: null,
+            input: '',
+            outDir: '',
+            owner: '',
+            port: null,
+            queryOnly: false,
+            template: '',
+            connection: '',
+            verbose: false,
+            skipTests: false, version: false,
+        });
+        const config = JSON.parse(readFileSync(join(projectDir, 'dql.config.json'), 'utf-8'));
+        expect(config.semanticLayer.provider).toBe('dql');
+        expect(config.semanticLayer.path).toBe('./semantic-layer');
+        expect(readdirSync(projectDir)).toContain('semantic-layer');
+        expect(readFileSync(join(projectDir, 'semantic-layer', 'imports', 'manifest.json'), 'utf-8')).toContain('"provider": "dbt"');
+    });
+});
+//# sourceMappingURL=init.test.js.map

package/commands/init.test.js.map

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

package/commands/lineage.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `dql lineage` — Answer-layer lineage analysis.
+ *
+ * Shows how data flows from source tables through blocks, semantic metrics,
+ * domains, and charts. Tracks trust chains and cross-domain impacts.
+ *
+ * Usage:
+ *   dql lineage [path]                    Show full lineage graph summary
+ *   dql lineage <name> [path]             Show upstream/downstream for a block, table, or metric
+ *   dql lineage --table <name> [path]     Show lineage for a specific source table
+ *   dql lineage --metric <name> [path]    Show lineage for a specific metric
+ *   dql lineage --domain <name> [path]    Show lineage within a domain
+ *   dql lineage --impact <name> [path]    Impact analysis: what breaks if this node changes?
+ *   dql lineage --trust-chain <from> <to> Show trust chain between two blocks
+ *   dql lineage --search <term> [path]    Search lineage nodes by name
+ *   dql lineage --focus <name> [path]     Show a focused lineage subgraph
+ *   dql lineage --dashboard <name> [path] Show lineage for a dashboard/notebook
+ *   dql lineage --dbt [path]              Show the dbt portion of lineage
+ *   dql lineage --export [path]           Export lineage as JSON
+ *   dql lineage --no-manifest             Force live scan (skip dql-manifest.json)
+ */
+import type { CLIFlags } from '../args.js';
+export declare function runLineage(blockNameOrPath: string | null, rest: string[], flags: CLIFlags): Promise<void>;
+//# sourceMappingURL=lineage.d.ts.map

package/commands/lineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../../src/commands/lineage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAoBH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAsB,UAAU,CAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAiHf"}