@duckcodeailabs/dql-cli 1.4.3 → 1.5.0

package/dist/commands/compile.test.js

@@ -0,0 +1,115 @@
+import { describe, it, expect } from 'vitest';
+import { mkdtempSync, writeFileSync, readFileSync, mkdirSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { ManifestCache } from '@duckcodeailabs/dql-project';
+import { collectInputFiles } from '@duckcodeailabs/dql-core';
+import { runCompile } from './compile.js';
+const baseFlags = {
+    format: 'text',
+    verbose: false,
+    help: false,
+    version: false,
+    check: false,
+    open: null,
+    input: '',
+    outDir: '',
+    port: null,
+    chart: '',
+    domain: '',
+    owner: '',
+    queryOnly: false,
+    template: '',
+    connection: '',
+    skipTests: false,
+};
+function seedProject() {
+    const projectRoot = mkdtempSync(join(tmpdir(), 'dql-compile-'));
+    writeFileSync(join(projectRoot, 'dql.config.json'), JSON.stringify({ project: 'demo' }));
+    mkdirSync(join(projectRoot, 'blocks'), { recursive: true });
+    writeFileSync(join(projectRoot, 'blocks', 'revenue.dql'), `block "Revenue" {
+  domain = "sales"
+  type = "custom"
+  query = """SELECT SUM(amount) AS revenue FROM orders"""
+}`);
+    return projectRoot;
+}
+describe('runCompile cache integration', () => {
+    it('populates the SQLite cache and serves the next compile from it', async () => {
+        const projectRoot = seedProject();
+        try {
+            // First compile — cold miss, builds and writes to cache.
+            await runCompile(projectRoot, [], baseFlags);
+            const manifestPath = join(projectRoot, 'dql-manifest.json');
+            const firstManifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+            expect(firstManifest.blocks).toHaveProperty('Revenue');
+            // Cache file should exist and contain a hit for the current fingerprint.
+            const cachePath = join(projectRoot, '.dql', 'cache', 'manifest.sqlite');
+            const cache = new ManifestCache({ path: cachePath });
+            try {
+                const files = collectInputFiles({ projectRoot }).map((path) => ({ path }));
+                const fp = cache.fingerprint(files);
+                const lookup = cache.lookup(fp, files);
+                expect(lookup.hit).toBe(true);
+                if (lookup.hit) {
+                    expect(lookup.value.blocks).toHaveProperty('Revenue');
+                }
+            }
+            finally {
+                cache.close();
+            }
+        }
+        finally {
+            rmSync(projectRoot, { recursive: true, force: true });
+        }
+    });
+    it('invalidates the cache entry when a tracked file changes', async () => {
+        const projectRoot = seedProject();
+        try {
+            await runCompile(projectRoot, [], baseFlags);
+            const cachePath = join(projectRoot, '.dql', 'cache', 'manifest.sqlite');
+            const files1 = collectInputFiles({ projectRoot }).map((path) => ({ path }));
+            let fp1;
+            {
+                const cache = new ManifestCache({ path: cachePath });
+                fp1 = cache.fingerprint(files1);
+                expect(cache.lookup(fp1, files1).hit).toBe(true);
+                cache.close();
+            }
+            // Mutate a tracked block — fingerprint must change → miss under fp1.
+            writeFileSync(join(projectRoot, 'blocks', 'revenue.dql'), `block "Revenue" {
+  domain = "sales"
+  type = "custom"
+  query = """SELECT COUNT(*) AS revenue FROM orders"""
+}`);
+            {
+                const cache = new ManifestCache({ path: cachePath });
+                const files2 = collectInputFiles({ projectRoot }).map((path) => ({ path }));
+                const fp2 = cache.fingerprint(files2);
+                expect(fp2).not.toBe(fp1);
+                const lookup = cache.lookup(fp2, files2);
+                expect(lookup.hit).toBe(false);
+                if (!lookup.hit) {
+                    // Diff should report the block file as changed.
+                    expect(lookup.changedFiles).toContain(join(projectRoot, 'blocks', 'revenue.dql'));
+                }
+                cache.close();
+            }
+        }
+        finally {
+            rmSync(projectRoot, { recursive: true, force: true });
+        }
+    });
+    it('--no-cache skips the cache entirely (no .dql/cache directory created)', async () => {
+        const projectRoot = seedProject();
+        try {
+            await runCompile(projectRoot, ['--no-cache'], baseFlags);
+            expect(() => readFileSync(join(projectRoot, '.dql', 'cache', 'manifest.sqlite')))
+                .toThrow();
+        }
+        finally {
+            rmSync(projectRoot, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=compile.test.js.map

package/dist/commands/compile.test.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,3 @@
+import type { CLIFlags } from '../args.js';
+export declare function runDiff(firstArg: string | null, rest: string[], flags: CLIFlags): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/commands/diff.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { diffDQL, diffNotebook, renderDiffText } from '@duckcodeailabs/dql-core';
+import { findRepoContext, readHeadBlob } from '../git-service.js';
+export async function runDiff(firstArg, rest, flags) {
+    const secondArg = rest[0];
+    if (!firstArg) {
+        console.error('Usage: dql diff <path> | dql diff <before> <after>');
+        process.exit(1);
+    }
+    const report = secondArg
+        ? await diffTwoFiles(firstArg, secondArg)
+        : await diffAgainstHead(firstArg);
+    if (flags.format === 'json') {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        console.log(renderDiffText(report));
+    }
+    // Exit 1 when there are changes — makes it scriptable as a gate
+    // (`dql diff a b && echo unchanged`), mirroring git-diff and fmt --check.
+    if (!report.identical)
+        process.exit(1);
+}
+async function diffTwoFiles(beforePath, afterPath) {
+    const before = readFileSync(beforePath, 'utf-8');
+    const after = readFileSync(afterPath, 'utf-8');
+    return diffByExtension(afterPath, before, after);
+}
+async function diffAgainstHead(path) {
+    const absPath = resolve(path);
+    if (!existsSync(absPath)) {
+        console.error(`Error: file not found: ${path}`);
+        process.exit(1);
+    }
+    const ctx = findRepoContext(absPath);
+    if (!ctx) {
+        console.error(`Error: ${path} is not inside a git repository. Use: dql diff <before> <after>`);
+        process.exit(1);
+    }
+    const before = await readHeadBlob(ctx);
+    const after = readFileSync(absPath, 'utf-8');
+    return diffByExtension(absPath, before, after);
+}
+function diffByExtension(path, before, after) {
+    if (path.endsWith('.dqlnb')) {
+        return diffNotebook(before, after);
+    }
+    // diffDQL doesn't accept null — newly added files diff against empty source.
+    return diffDQL(before ?? '', after);
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAmB,MAAM,0BAA0B,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGlE,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAAuB,EACvB,IAAc,EACd,KAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,MAAM,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC;QACzC,CAAC,CAAC,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEpC,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,gEAAgE;IAChE,0EAA0E;IAC1E,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,UAAkB,EAAE,SAAiB;IAC/D,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,iEAAiE,CAAC,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,MAAqB,EAAE,KAAa;IACzE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,6EAA6E;IAC7E,OAAO,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { CLIFlags } from '../args.js';
+export declare function runDoctor(targetPath: string | null, flags: CLIFlags): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAS3C,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFzF"}

package/dist/commands/doctor.js

@@ -0,0 +1,191 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { QueryExecutor } from '@duckcodeailabs/dql-connectors';
+import { resolveSemanticLayerWithDiagnostics } from '@duckcodeailabs/dql-core';
+import { assertLocalQueryRuntimeReady, findProjectRoot, loadProjectConfig } from '../local-runtime.js';
+export async function runDoctor(targetPath, flags) {
+    const cwd = resolve(targetPath || '.');
+    const projectRoot = findProjectRoot(cwd);
+    const config = loadProjectConfig(projectRoot);
+    // loadProjectConfig normalizes connections.default → defaultConnection
+    const defaultConnection = config.defaultConnection;
+    // Detect dbt project for conditional checks
+    const isDbt = existsSync(join(projectRoot, 'dbt_project.yml'));
+    // For dbt projects, semantic-layer/ dir is not needed (dbt provides it)
+    const hasSemanticLayerDir = existsSync(join(projectRoot, 'semantic-layer'));
+    const semanticLayerOk = isDbt || hasSemanticLayerDir;
+    const semanticLayerDetail = isDbt
+        ? (hasSemanticLayerDir ? 'found' : 'provided by dbt')
+        : (hasSemanticLayerDir ? 'found' : 'missing');
+    // data/ is optional
+    const hasDataDir = existsSync(join(projectRoot, 'data'));
+    const checks = [
+        checkNodeVersion(),
+        {
+            name: 'Project root',
+            ok: existsSync(projectRoot),
+            detail: projectRoot,
+        },
+        {
+            name: 'dql.config.json',
+            ok: existsSync(join(projectRoot, 'dql.config.json')),
+            detail: existsSync(join(projectRoot, 'dql.config.json')) ? 'found' : 'missing',
+        },
+        {
+            name: 'blocks/',
+            ok: existsSync(join(projectRoot, 'blocks')),
+            detail: existsSync(join(projectRoot, 'blocks')) ? 'found' : 'missing',
+        },
+        {
+            name: 'semantic-layer/',
+            ok: semanticLayerOk,
+            detail: semanticLayerDetail,
+        },
+        {
+            name: 'data/',
+            ok: true,
+            detail: hasDataDir ? 'found' : 'not found (optional)',
+        },
+        {
+            name: 'Default connection',
+            ok: Boolean(defaultConnection?.driver),
+            detail: defaultConnection?.driver ? `driver=${defaultConnection.driver}` : 'not configured',
+        },
+        checkSemanticLayer(config.semanticLayer, projectRoot),
+    ];
+    checks.push(checkNotebookAssets());
+    if (defaultConnection?.driver === 'file' || defaultConnection?.driver === 'duckdb') {
+        checks.push(checkDuckDBDependency(projectRoot));
+    }
+    if (defaultConnection?.driver) {
+        checks.push(await checkLocalQueryRuntime(projectRoot, defaultConnection));
+    }
+    const passed = checks.filter((check) => check.ok).length;
+    if (flags.format === 'json') {
+        console.log(JSON.stringify({
+            ok: passed === checks.length,
+            projectRoot,
+            checks,
+        }, null, 2));
+        return;
+    }
+    console.log(`\n  DQL Doctor`);
+    console.log(`    Project: ${projectRoot}`);
+    console.log('');
+    for (const check of checks) {
+        console.log(`  ${check.ok ? '✓' : '✗'} ${check.name}`);
+        console.log(`    ${check.detail}`);
+    }
+    console.log('');
+    console.log(`  Summary: ${passed}/${checks.length} checks passed`);
+    console.log('');
+}
+function checkNodeVersion() {
+    const match = process.versions.node.match(/^(\d+)/);
+    const major = match ? Number(match[1]) : 0;
+    return {
+        name: 'Node.js',
+        ok: major >= 18,
+        detail: `version=${process.versions.node} (requires >= 18)`,
+    };
+}
+function checkDuckDBDependency(projectRoot) {
+    const packageJsonPath = join(projectRoot, 'package.json');
+    if (!existsSync(packageJsonPath)) {
+        return {
+            name: 'duckdb dependency',
+            ok: true,
+            detail: 'no project package.json; skipping dependency check',
+        };
+    }
+    try {
+        const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        const hasDuckDB = Boolean(pkg.dependencies?.duckdb || pkg.devDependencies?.duckdb);
+        return {
+            name: 'duckdb dependency',
+            ok: hasDuckDB,
+            detail: hasDuckDB ? 'duckdb listed in package.json' : 'add duckdb for file/duckdb local preview support',
+        };
+    }
+    catch {
+        return {
+            name: 'duckdb dependency',
+            ok: false,
+            detail: 'failed to parse package.json',
+        };
+    }
+}
+function checkSemanticLayer(semanticConfig, projectRoot) {
+    try {
+        const result = resolveSemanticLayerWithDiagnostics(semanticConfig, projectRoot);
+        if (result.errors.length > 0) {
+            return {
+                name: 'Semantic layer',
+                ok: false,
+                detail: result.errors.join('; '),
+            };
+        }
+        if (!result.layer) {
+            return {
+                name: 'Semantic layer',
+                ok: true,
+                detail: 'not configured (optional)',
+            };
+        }
+        const metrics = result.layer.listMetrics().length;
+        const dims = result.layer.listDimensions().length;
+        const provider = result.detectedProvider ?? 'configured';
+        return {
+            name: 'Semantic layer',
+            ok: true,
+            detail: `provider=${provider}, ${metrics} metrics, ${dims} dimensions`,
+        };
+    }
+    catch (err) {
+        return {
+            name: 'Semantic layer',
+            ok: false,
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+function checkNotebookAssets() {
+    const commandDir = dirname(fileURLToPath(import.meta.url));
+    const reactAppDir = resolve(commandDir, '../assets/dql-notebook');
+    const legacyAppDir = resolve(commandDir, '../assets/notebook-browser');
+    const hasReact = existsSync(join(reactAppDir, 'index.html'));
+    const hasLegacy = existsSync(join(legacyAppDir, 'index.html'));
+    return {
+        name: 'Notebook app assets',
+        ok: hasReact || hasLegacy,
+        detail: hasReact || hasLegacy
+            ? 'found'
+            : 'missing — try reinstalling: npm i -g @duckcodeailabs/dql-cli',
+    };
+}
+async function checkLocalQueryRuntime(projectRoot, connection) {
+    const previousCwd = process.cwd();
+    const executor = new QueryExecutor();
+    try {
+        process.chdir(projectRoot);
+        await assertLocalQueryRuntimeReady(executor, connection);
+        return {
+            name: 'Local query runtime',
+            ok: true,
+            detail: `driver=${connection.driver} is available`,
+        };
+    }
+    catch (error) {
+        return {
+            name: 'Local query runtime',
+            ok: false,
+            detail: error instanceof Error ? error.message : String(error),
+        };
+    }
+    finally {
+        process.chdir(previousCwd);
+        await executor.disconnect().catch(() => { });
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/doctor.test.d.ts

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

package/dist/commands/doctor.test.d.ts.map

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

package/dist/commands/doctor.test.js

@@ -0,0 +1,43 @@
+import { mkdtempSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { describe, expect, it, vi } from 'vitest';
+import { runDoctor } from './doctor.js';
+describe('runDoctor', () => {
+    it('reports health for a starter-like project', async () => {
+        const projectDir = mkdtempSync(join(tmpdir(), 'dql-doctor-'));
+        mkdirSync(join(projectDir, 'blocks'));
+        mkdirSync(join(projectDir, 'semantic-layer'));
+        mkdirSync(join(projectDir, 'data'));
+        writeFileSync(join(projectDir, 'dql.config.json'), JSON.stringify({
+            defaultConnection: { driver: 'file', filepath: ':memory:' },
+        }, null, 2));
+        writeFileSync(join(projectDir, 'package.json'), JSON.stringify({
+            dependencies: { duckdb: '^1.1.0' },
+        }, null, 2));
+        const spy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        await runDoctor(projectDir, {
+            check: false,
+            chart: '',
+            domain: '',
+            format: 'text',
+            help: false,
+            open: null,
+            input: '',
+            outDir: '',
+            owner: '',
+            port: null,
+            queryOnly: false,
+            template: 'starter',
+            connection: '',
+            verbose: false,
+            skipTests: false, version: false,
+        });
+        expect(spy).toHaveBeenCalled();
+        const output = spy.mock.calls.flat().join('\n');
+        expect(output).toContain('DQL Doctor');
+        expect(output).toContain('blocks/');
+        spy.mockRestore();
+    });
+});
+//# sourceMappingURL=doctor.test.js.map

package/dist/commands/doctor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.test.js","sourceRoot":"","sources":["../../src/commands/doctor.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;QAC9D,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC9C,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QACpC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;YAChE,iBAAiB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE;SAC5D,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACb,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;YAC7D,YAAY,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;SACnC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEb,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAElE,MAAM,SAAS,CAAC,UAAU,EAAE;YAC1B,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK;SACjC,CAAC,CAAC;QAEH,MAAM,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,GAAG,CAAC,WAAW,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/fmt.d.ts

@@ -0,0 +1,3 @@
+import type { CLIFlags } from '../args.js';
+export declare function runFmt(filePath: string, flags: CLIFlags): Promise<void>;
+//# sourceMappingURL=fmt.d.ts.map

package/dist/commands/fmt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fmt.d.ts","sourceRoot":"","sources":["../../src/commands/fmt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAc3C,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C7E"}

package/dist/commands/fmt.js

@@ -0,0 +1,53 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { canonicalize, canonicalizeNotebook } from '@duckcodeailabs/dql-core';
+/**
+ * Detect the deprecated top-level `workbook { }` construct without invoking
+ * the parser — a fast regex probe is enough because `workbook` at column 0
+ * (optionally decorated) is unambiguous. Track F flags but does not rewrite.
+ */
+function detectWorkbook(source) {
+    return /^\s*(?:@[\w_]+\s*(?:\([^)]*\))?\s*)*workbook\s+"/m.test(source);
+}
+const WORKBOOK_DEPRECATION = 'workbook { } is deprecated and will be removed in v1.3. See docs/migrations/workbook-to-dashboard.md.';
+export async function runFmt(filePath, flags) {
+    const source = readFileSync(filePath, 'utf-8');
+    const isNotebook = filePath.endsWith('.dqlnb');
+    const formatted = isNotebook ? canonicalizeNotebook(source) : canonicalize(source);
+    const changed = source !== formatted;
+    const usesWorkbook = !isNotebook && detectWorkbook(source);
+    if (flags.check) {
+        if (flags.format === 'json') {
+            console.log(JSON.stringify({
+                file: filePath,
+                changed,
+                mode: 'check',
+                deprecations: usesWorkbook ? ['workbook'] : [],
+            }, null, 2));
+        }
+        else {
+            if (changed)
+                console.log(`\n  ✗ Needs formatting: ${filePath}`);
+            else
+                console.log(`\n  ✓ Already formatted: ${filePath}`);
+            if (usesWorkbook)
+                console.log(`    ⚠ ${WORKBOOK_DEPRECATION}`);
+            console.log('');
+        }
+        if (changed || usesWorkbook)
+            process.exit(1);
+        return;
+    }
+    if (changed) {
+        writeFileSync(filePath, formatted, 'utf-8');
+    }
+    if (flags.format === 'json') {
+        console.log(JSON.stringify({ file: filePath, changed, mode: 'write' }, null, 2));
+    }
+    else if (changed) {
+        console.log(`\n  ✓ Formatted: ${filePath}\n`);
+    }
+    else {
+        console.log(`\n  ✓ No changes: ${filePath}\n`);
+    }
+}
+//# sourceMappingURL=fmt.js.map

package/dist/commands/fmt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fmt.js","sourceRoot":"","sources":["../../src/commands/fmt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAG9E;;;;GAIG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,OAAO,mDAAmD,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,oBAAoB,GACxB,uGAAuG,CAAC;AAE1G,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB,EAAE,KAAe;IAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,MAAM,KAAK,SAAS,CAAC;IACrC,MAAM,YAAY,GAAG,CAAC,UAAU,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAE3D,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO;gBACP,IAAI,EAAE,OAAO;gBACb,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE;aAC/C,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;;gBAC3D,OAAO,CAAC,GAAG,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;YACzD,IAAI,YAAY;gBAAE,OAAO,CAAC,GAAG,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,OAAO,IAAI,YAAY;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,aAAa,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,oBAAoB,QAAQ,IAAI,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,QAAQ,IAAI,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/commands/import.d.ts

@@ -0,0 +1,3 @@
+import type { CLIFlags } from '../args.js';
+export declare function runImport(source: string, rest: string[], flags: CLIFlags): Promise<void>;
+//# sourceMappingURL=import.d.ts.map

package/dist/commands/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD9F"}

package/dist/commands/import.js

@@ -0,0 +1,50 @@
+import { createBlockStudioImportSession } from '../block-studio-import.js';
+export async function runImport(source, rest, flags) {
+    if (source !== 'sql') {
+        console.error(`\n  ✗ Unknown import source: "${source}"`);
+        console.error('    Supported sources in this build: sql');
+        console.error('');
+        process.exit(1);
+    }
+    const inputPath = rest[0] || flags.input;
+    if (!inputPath) {
+        console.error('\n  ✗ Missing SQL import path.');
+        console.error('    Usage: dql import sql <file-or-folder> [--domain <name>] [--owner <name>]');
+        console.error('');
+        process.exit(1);
+    }
+    const session = createBlockStudioImportSession(process.cwd(), {
+        sourceKind: 'raw-sql',
+        inputPath,
+        domain: flags.domain || 'imported',
+        owner: flags.owner || '',
+    });
+    if (flags.format === 'json') {
+        console.log(JSON.stringify(session, null, 2));
+        return;
+    }
+    console.log('\n  DQL Import: SQL');
+    console.log('  ─────────────────────────────');
+    console.log(`  Session:     ${session.id}`);
+    console.log(`  Source:      ${session.inputPath}`);
+    console.log(`  Candidates:  ${session.candidates.length}`);
+    console.log(`  Domain:      ${session.defaults.domain}`);
+    if (session.defaults.owner)
+        console.log(`  Owner:       ${session.defaults.owner}`);
+    console.log('');
+    for (const candidate of session.candidates) {
+        const tables = candidate.lineage.sourceTables.length > 0
+            ? candidate.lineage.sourceTables.join(', ')
+            : 'not detected';
+        const warnings = candidate.lineage.warnings.length > 0
+            ? ` · ${candidate.lineage.warnings.join('; ')}`
+            : '';
+        console.log(`  • ${candidate.name}`);
+        console.log(`    ${candidate.id} · confidence ${Math.round(candidate.confidence * 100)}% · tables: ${tables}${warnings}`);
+    }
+    console.log('');
+    console.log('  Review in Block Studio Import, then run and save selected candidates as draft blocks.');
+    console.log(`  Import cache: .dql/imports/${session.id}/`);
+    console.log('');
+}
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

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

package/dist/commands/info.d.ts

@@ -0,0 +1,3 @@
+import type { CLIFlags } from '../args.js';
+export declare function runInfo(filePath: string, flags: CLIFlags): Promise<void>;
+//# sourceMappingURL=info.d.ts.map

package/dist/commands/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D9E"}