askdb 1.0.0-beta.47 → 1.0.0-beta.49

package/dist/ask.d.ts

@@ -0,0 +1,15 @@
+import { type CommandSpec } from "./command.js";
+import { type CliLoggingFlags } from "./logger.js";
+type AskOptions = CliLoggingFlags & {
+    schema?: string;
+    question?: string;
+    explain?: boolean;
+    mockSql?: string;
+    mode?: string;
+    omitSensitiveFromPrompt?: boolean;
+};
+/** `askdb ask`: SQL for one question, on stdout after `-- sql --`. */
+export declare function askCommand(): CommandSpec<AskOptions>;
+export declare function runAskCli(argv: readonly string[]): Promise<number>;
+export {};
+//# sourceMappingURL=ask.d.ts.map

package/dist/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAc,KAAK,WAAW,EAAa,MAAM,cAAc,CAAC;AACvE,OAAO,EAAqD,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAOtG,KAAK,UAAU,GAAG,eAAe,GAAG;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,CAAC;AAyCF,sEAAsE;AACtE,wBAAgB,UAAU,IAAI,WAAW,CAAC,UAAU,CAAC,CAapD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAElE"}

package/dist/ask.js

@@ -0,0 +1,168 @@
+import { createAiRegistry } from "@askdb/ai";
+import { createAskDb } from "@askdb/client";
+import { getAskDbRuntimeConfig } from "@askdb/config";
+import { AskDbError, AskDbLogEvent, formatAskDbModesV1, formatSensitiveReference, loadSchema, parseAskDbModeV1, SchemaParseError, } from "@askdb/core";
+import { errorMessage, printCliError } from "./cli-error.js";
+import { runCommand } from "./command.js";
+import { createCliLogger, loggingFlags, resolveCliLogLevel } from "./logger.js";
+// Batteries-included surface: every built-in provider is registered, and each
+// loads its @ai-sdk/* package only when first used, so env config alone
+// selects the provider.
+const ai = createAiRegistry();
+const ASK_FLAGS = [
+    {
+        names: ["-s", "--schema"],
+        value: "<path>",
+        help: "Schema v2 directory, bundled JSON, or schema.json. Default: introspection.outputDir, or ./askdb/.",
+        apply: (opts, value) => (opts.schema = value),
+    },
+    {
+        names: ["-q", "--question"],
+        value: "<text>",
+        help: "The natural-language question (required).",
+        apply: (opts, value) => (opts.question = value),
+    },
+    {
+        names: ["--mode"],
+        value: "<id>",
+        help: () => `Operating mode (${formatAskDbModesV1()}). Can tighten config modes.askdbMode (default schema_only), never loosen it.`,
+        apply: (opts, value) => (opts.mode = value),
+    },
+    {
+        names: ["--explain"],
+        help: "After the SQL, print a JSON block describing the heuristic guardrails satisfied.",
+        apply: (opts) => (opts.explain = true),
+    },
+    {
+        names: ["--omit-sensitive-from-prompt"],
+        help: "Omit sensitive column/table names from the NL→SQL prompt. Default: include them, tagged as sensitive.",
+        apply: (opts) => (opts.omitSensitiveFromPrompt = true),
+    },
+    {
+        names: ["--mock-sql"],
+        value: "<sql>",
+        help: "Deterministic NL→SQL for tests (bypasses the live model call). Default: dev.mockSql.",
+        apply: (opts, value) => (opts.mockSql = value),
+    },
+    ...loggingFlags(),
+];
+/** `askdb ask`: SQL for one question, on stdout after `-- sql --`. */
+export function askCommand() {
+    return {
+        name: "ask",
+        summary: "Generate SQL from schema + question",
+        usage: ['askdb ask --question "<text>" [--schema <path>] [--mode <id>] [--explain]'],
+        flags: ASK_FLAGS,
+        initial: () => ({}),
+        check(opts) {
+            if (opts.question === undefined)
+                throw new Error("Missing --question <text>.");
+        },
+        needsConfig: () => true,
+        run: runAsk,
+    };
+}
+export function runAskCli(argv) {
+    return runCommand(askCommand(), argv);
+}
+async function runAsk(opts) {
+    const question = opts.question;
+    let logLevel;
+    // Only the flag is parsed here: the facade applies config `modes.askdbMode` (ADR 0025).
+    let mode;
+    const runtime = getAskDbRuntimeConfig();
+    try {
+        logLevel = resolveCliLogLevel(opts, runtime);
+        mode = opts.mode === undefined ? undefined : parseAskDbModeV1(opts.mode);
+    }
+    catch (e) {
+        printCliError(e);
+        return 1;
+    }
+    const logger = createCliLogger(opts, runtime, logLevel);
+    const mockSql = opts.mockSql ?? runtime.dev.mockSql;
+    const aiConfig = mockSql ? undefined : ai.resolveAiConfig(runtime.ai.aiEnv);
+    if (!mockSql && !aiConfig) {
+        process.stderr.write(`${ai.keyMissingMessage("NL→SQL generation")}\n`);
+        process.stderr.write("Tip: in tests, pass --mock-sql or set dev.mockSql in askdb.config to bypass live model calls.\n");
+        return 1;
+    }
+    logger.info({ event: AskDbLogEvent.RunStart }, "askdb run start");
+    try {
+        const schema = loadSchemaFromPath(opts.schema ?? runtime.introspection.outputDir);
+        const askdb = createAskDb({
+            config: runtime,
+            registry: ai,
+            onResolve: (info) => {
+                if (info.dialect.note) {
+                    logger.info({ event: "askdb.pipeline.dialect_override", note: info.dialect.note }, info.dialect.note);
+                    process.stderr.write(`Note: ${info.dialect.note}\n`);
+                }
+            },
+        });
+        const out = await askdb.ask(question, {
+            schema: { schema },
+            logger,
+            mode,
+            explain: opts.explain,
+            // The facade adds config `modes.omitSensitiveFromPrompt` as a floor.
+            omitSensitiveIdentifiersFromNlToSqlPrompt: opts.omitSensitiveFromPrompt,
+            // When --mock-sql flag is set explicitly (not just from runtime config),
+            // pass it as a per-call deps override so the flag wins over config.
+            ...(opts.mockSql !== undefined
+                ? {
+                    deps: {
+                        generateText: (async () => ({ text: opts.mockSql })),
+                    },
+                }
+                : {}),
+        });
+        // `ask()` runs the sensitive-identifier guardrail in warn mode and emits
+        // askdb.pipeline.sensitive_sql_warning through the logger above; the CLI
+        // only renders it for the operator.
+        const sensitive = out.sensitiveGuardrail;
+        if (sensitive && sensitive.references.length > 0) {
+            const cols = sensitive.references.map(formatSensitiveReference);
+            process.stderr.write(`Warning: generated SQL references sensitive columns: ${cols.join(", ")}\n` +
+                "Review carefully before sharing or running this SQL outside AskDB.\n");
+        }
+        if (sensitive?.unresolvedScope) {
+            process.stderr.write(`Note: ${sensitive.unresolvedScope.message}\n`);
+        }
+        process.stdout.write("-- sql --\n");
+        process.stdout.write(`${out.sql}\n`);
+        if (opts.explain) {
+            process.stdout.write("-- explain --\n");
+            process.stdout.write(`${JSON.stringify(out.explain ?? null, null, 2)}\n`);
+        }
+        logger.info({ event: AskDbLogEvent.RunEnd, ok: true }, "askdb run end");
+        return 0;
+    }
+    catch (error) {
+        logger.error({ event: AskDbLogEvent.RunError, errMessage: errorMessage(error) }, "askdb run error");
+        printCliError(error);
+        return 1;
+    }
+}
+function formatSchemaPathHint(schemaPath) {
+    return `Schema path: ${schemaPath}\nHint: Try \`fixtures/schemas/orders-users.schema/\` (v2 directory) as a known-good example.`;
+}
+function loadSchemaFromPath(schemaPath) {
+    try {
+        return loadSchema(schemaPath);
+    }
+    catch (e) {
+        const code = e.code;
+        if (code === "ENOENT") {
+            throw new AskDbError(`Schema path not found.\n${formatSchemaPathHint(schemaPath)}`, e);
+        }
+        if (code === "EACCES") {
+            throw new AskDbError(`Schema path is not readable (permission denied).\n${formatSchemaPathHint(schemaPath)}`, e);
+        }
+        if (e instanceof SchemaParseError) {
+            throw new AskDbError(`Failed to parse schema.\n${formatSchemaPathHint(schemaPath)}\nDetails: ${e.message}`, e);
+        }
+        throw new AskDbError(`Failed to load schema.\n${formatSchemaPathHint(schemaPath)}\nDetails: ${errorMessage(e)}`, e);
+    }
+}
+//# sourceMappingURL=ask.js.map

package/dist/ask.js.map

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

package/dist/bundle.d.ts

@@ -0,0 +1,10 @@
+import { type CommandSpec } from "./command.js";
+type BundleOptions = {
+    schemaDir?: string;
+    out?: string;
+};
+/** `askdb bundle`: one Schema v2 directory as one JSON file. It never reads askdb.config. */
+export declare function bundleCommand(): CommandSpec<BundleOptions>;
+export declare function runBundleCli(argv: readonly string[]): Promise<number>;
+export {};
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAI5D,KAAK,aAAa,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,6FAA6F;AAC7F,wBAAgB,aAAa,IAAI,WAAW,CAAC,aAAa,CAAC,CAsC1D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE"}

package/dist/bundle.js

@@ -0,0 +1,51 @@
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { errorMessage } from "./cli-error.js";
+import { runCommand } from "./command.js";
+const USAGE = "askdb bundle <schema-dir> --out <bundle.json>";
+/** `askdb bundle`: one Schema v2 directory as one JSON file. It never reads askdb.config. */
+export function bundleCommand() {
+    return {
+        name: "bundle",
+        summary: "Bundle a Schema v2 directory into a single JSON file",
+        usage: [USAGE],
+        flags: [
+            {
+                names: ["--out"],
+                value: "<bundle.json>",
+                help: "Write the bundle here (required).",
+                apply: (opts, value) => (opts.out = value),
+            },
+        ],
+        positional(opts, value, index) {
+            if (index > 0) {
+                throw new Error("Unexpected argument: askdb bundle takes one <schema-dir>. Pass the output path with --out.");
+            }
+            opts.schemaDir = value;
+        },
+        initial: () => ({}),
+        check(opts) {
+            if (!opts.schemaDir || !opts.out)
+                throw new Error(`Usage: ${USAGE}`);
+        },
+        needsConfig: () => false,
+        async run(opts) {
+            const { bundleSchemaDirectory } = await import("@askdb/enrich");
+            const outPath = resolve(opts.out);
+            try {
+                const bundle = bundleSchemaDirectory(resolve(opts.schemaDir));
+                writeFileSync(outPath, `${JSON.stringify(bundle, null, 2)}\n`, "utf8");
+            }
+            catch (error) {
+                process.stderr.write(`askdb bundle: ${errorMessage(error)}\n`);
+                return 1;
+            }
+            process.stdout.write(`Wrote ${outPath}\n`);
+            return 0;
+        },
+    };
+}
+export function runBundleCli(argv) {
+    return runCommand(bundleCommand(), argv);
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAoB,MAAM,cAAc,CAAC;AAE5D,MAAM,KAAK,GAAG,+CAA+C,CAAC;AAI9D,6FAA6F;AAC7F,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,sDAAsD;QAC/D,KAAK,EAAE,CAAC,KAAK,CAAC;QACd,KAAK,EAAE;YACL;gBACE,KAAK,EAAE,CAAC,OAAO,CAAC;gBAChB,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE,mCAAmC;gBACzC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC;aAC3C;SACF;QACD,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK;YAC3B,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAC;YAChH,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI;YACR,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK;QACxB,KAAK,CAAC,GAAG,CAAC,IAAI;YACZ,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;YAChE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAI,CAAC,CAAC;YACnC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC,SAAU,CAAC,CAAC,CAAC;gBAC/D,aAAa,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC/D,OAAO,CAAC,CAAC;YACX,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC;YAC3C,OAAO,CAAC,CAAC;QACX,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,OAAO,UAAU,CAAC,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/cli-error.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A thrown value as one or more lines, never blank. An error with an empty message, such as the
+ * `AggregateError` a driver throws when `localhost` refuses on both ::1 and 127.0.0.1, gives each
+ * inner error's message once (a socket error names the address, not the connection string), else
+ * its `code`, else its name.
+ */
+export declare function errorMessage(error: unknown): string;
+/** The CLI's printer for `askdb ask` and the top-level handler: AskDB errors keep their name. */
+export declare function printCliError(error: unknown): void;
+//# sourceMappingURL=cli-error.d.ts.map

package/dist/cli-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-error.d.ts","sourceRoot":"","sources":["../src/cli-error.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CASnD;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAelD"}

package/dist/cli-error.js

@@ -0,0 +1,39 @@
+import { AskDbError, SqlValidationError } from "@askdb/core";
+import { MissingAskDbConfigError } from "./project-config.js";
+/**
+ * A thrown value as one or more lines, never blank. An error with an empty message, such as the
+ * `AggregateError` a driver throws when `localhost` refuses on both ::1 and 127.0.0.1, gives each
+ * inner error's message once (a socket error names the address, not the connection string), else
+ * its `code`, else its name.
+ */
+export function errorMessage(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    if (error.message)
+        return error.message;
+    if (error instanceof AggregateError && error.errors.length > 0) {
+        const lines = new Set(error.errors.map((inner) => errorMessage(inner)));
+        return [...lines].join("\n");
+    }
+    const code = error.code;
+    return typeof code === "string" && code ? code : error.name;
+}
+/** The CLI's printer for `askdb ask` and the top-level handler: AskDB errors keep their name. */
+export function printCliError(error) {
+    if (error instanceof MissingAskDbConfigError) {
+        process.stderr.write(`${error.message}\n`);
+        return;
+    }
+    if (error instanceof SqlValidationError) {
+        process.stderr.write(`${error.name} [${error.rule}]: ${error.message}\n`);
+        if (error.hint)
+            process.stderr.write(`Hint: ${error.hint}\n`);
+        return;
+    }
+    if (error instanceof AskDbError) {
+        process.stderr.write(`${error.name}: ${errorMessage(error)}\n`);
+        return;
+    }
+    process.stderr.write(`${errorMessage(error)}\n`);
+}
+//# sourceMappingURL=cli-error.js.map

package/dist/cli-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-error.js","sourceRoot":"","sources":["../src/cli-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACxC,IAAI,KAAK,YAAY,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAC1E,IAAI,KAAK,CAAC,IAAI;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC"}