@askdb/core 0.5.0-beta.0

package/dist/schema/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/schema/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAc9E;AAED,kDAAkD;AAClD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,kCAAkC,CAAC,EAAE,OAAO,CAAC;CAC9C,CAAC;AAEF,+HAA+H;AAC/H,MAAM,MAAM,wBAAwB,GAAG;IACrC,kCAAkC,EAAE,OAAO,CAAC;IAC5C,0EAA0E;IAC1E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,uBAAuB,EAAE,MAAM,CAAC;IAChC,4GAA4G;IAC5G,0BAA0B,EAAE,MAAM,CAAC;CACpC,CAAC;AAmBF;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,oBAAyB,GACjC;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,wBAAwB,CAAC;CACjC,CAsDA;AAED,0GAA0G;AAC1G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAEtG"}

package/dist/schema/normalize.js

@@ -0,0 +1,89 @@
+export function normalizeAskDbSchema(parsed) {
+    return {
+        tables: parsed.tables.map((t) => ({
+            name: t.name,
+            ...(t.sensitive === true ? { sensitive: true } : {}),
+            columns: t.columns.map((c) => ({
+                name: c.name,
+                type: c.type,
+                nullable: c.nullable ?? true,
+                primaryKey: c.primaryKey ?? false,
+                ...(c.sensitive === true ? { sensitive: true } : {}),
+            })),
+        })),
+    };
+}
+function columnLine(c, tableSensitive) {
+    const flags = [
+        c.primaryKey ? "PK" : "",
+        c.nullable ? "NULL" : "NOT NULL",
+    ]
+        .filter(Boolean)
+        .join(" ");
+    const base = `  - ${c.name} ${c.type}${flags ? ` (${flags})` : ""}`;
+    const sensitive = Boolean(tableSensitive || c.sensitive);
+    const listedSensitive = sensitive;
+    const line = sensitive ? `${base} (sensitive)` : base;
+    return { line, listedSensitive };
+}
+/**
+ * Format schema for LLM prompts. By default, **includes** sensitive column/table names (tagged) so NL→SQL can
+ * ground identifiers; set {@link FormatNlToSqlOptions.omitSensitiveIdentifiersFromPrompt} to omit them.
+ */
+export function formatSchemaForNlToSql(schema, options = {}) {
+    const omit = options.omitSensitiveIdentifiersFromPrompt === true;
+    let redactedColumnCount = 0;
+    let sensitiveTableStubCount = 0;
+    let listedSensitiveColumnCount = 0;
+    const lines = [];
+    for (const t of schema.tables) {
+        lines.push(`TABLE ${t.name}`);
+        if (omit && t.sensitive) {
+            sensitiveTableStubCount++;
+            redactedColumnCount += t.columns.length;
+            lines.push(`  (sensitive table — column definitions withheld from model context)`);
+            lines.push("");
+            continue;
+        }
+        if (omit) {
+            let visibleColumns = 0;
+            for (const c of t.columns) {
+                if (c.sensitive) {
+                    redactedColumnCount++;
+                    continue;
+                }
+                visibleColumns++;
+                const { line } = columnLine(c, false);
+                lines.push(line);
+            }
+            if (visibleColumns === 0 && t.columns.length > 0) {
+                lines.push(`  (all columns marked sensitive — definitions withheld from model context)`);
+            }
+        }
+        else {
+            for (const c of t.columns) {
+                const { line, listedSensitive } = columnLine(c, Boolean(t.sensitive));
+                if (listedSensitive) {
+                    listedSensitiveColumnCount++;
+                }
+                lines.push(line);
+            }
+        }
+        lines.push("");
+    }
+    const ddl = lines.join("\n").trimEnd();
+    return {
+        ddl,
+        stats: {
+            omitSensitiveIdentifiersFromPrompt: omit,
+            redactedColumnCount,
+            sensitiveTableStubCount,
+            listedSensitiveColumnCount,
+        },
+    };
+}
+/** Same DDL as {@link formatSchemaForNlToSql} with default options (sensitive names included, tagged). */
+export function formatSchemaForPrompt(schema, options) {
+    return formatSchemaForNlToSql(schema, options).ddl;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/schema/normalize.js.map

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

package/dist/schema/parse.d.ts

@@ -0,0 +1,5 @@
+import type { AskDbSchemaFile } from "./types.js";
+import type { NormalizedSchema } from "./types.js";
+export declare function parseAskDbSchemaJson(raw: string): AskDbSchemaFile;
+export declare function loadNormalizedSchemaFromJson(raw: string): NormalizedSchema;
+//# sourceMappingURL=parse.d.ts.map

package/dist/schema/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/schema/parse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CA2BjE;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAE1E"}

package/dist/schema/parse.js

@@ -0,0 +1,37 @@
+import { SchemaParseError } from "../errors.js";
+import { askDbSchemaFileSchema } from "./format.js";
+import { normalizeAskDbSchema } from "./normalize.js";
+export function parseAskDbSchemaJson(raw) {
+    try {
+        const data = JSON.parse(raw);
+        const parsed = askDbSchemaFileSchema.safeParse(data);
+        if (!parsed.success) {
+            throw new SchemaParseError(parsed.error.message, parsed.error);
+        }
+        const seenTables = new Set();
+        for (const table of parsed.data.tables) {
+            if (seenTables.has(table.name)) {
+                throw new SchemaParseError(`Duplicate table name: ${table.name}`);
+            }
+            seenTables.add(table.name);
+            const cols = new Set();
+            for (const col of table.columns) {
+                if (cols.has(col.name)) {
+                    throw new SchemaParseError(`Duplicate column '${col.name}' in table '${table.name}'`);
+                }
+                cols.add(col.name);
+            }
+        }
+        return parsed.data;
+    }
+    catch (e) {
+        if (e instanceof SchemaParseError)
+            throw e;
+        const message = e instanceof Error ? e.message : String(e);
+        throw new SchemaParseError(`Failed to parse schema JSON: ${message}`, e);
+    }
+}
+export function loadNormalizedSchemaFromJson(raw) {
+    return normalizeAskDbSchema(parseAskDbSchemaJson(raw));
+}
+//# sourceMappingURL=parse.js.map

package/dist/schema/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/schema/parse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACvC,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,gBAAgB,CAAC,yBAAyB,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAChC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,MAAM,IAAI,gBAAgB,CAAC,qBAAqB,GAAG,CAAC,IAAI,eAAe,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;gBACxF,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,gBAAgB;YAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,GAAW;IACtD,OAAO,oBAAoB,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/schema/types.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { askDbSchemaFileSchema } from "./format.js";
+import type { NormalizedSchemaV2 } from "./v2/normalized.js";
+export type AskDbSchemaFile = z.infer<typeof askDbSchemaFileSchema>;
+/** Normalized, describable-schema-friendly shape used by prompts and tooling. */
+export type NormalizedSchema = {
+    tables: Array<{
+        name: string;
+        /** Entire table withheld from NL→SQL prompt DDL (optional Phase 2 `sensitive`). */
+        sensitive?: boolean;
+        columns: Array<{
+            name: string;
+            type: string;
+            nullable: boolean;
+            primaryKey: boolean;
+            /** Column omitted from NL→SQL prompt DDL when true. */
+            sensitive?: boolean;
+        }>;
+    }>;
+};
+/** Schema shape accepted by the dialect-agnostic pipeline (covers both v1 and v2 normalized forms). */
+export type AnyNormalizedSchema = NormalizedSchema | NormalizedSchemaV2;
+//# sourceMappingURL=types.d.ts.map

package/dist/schema/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,mFAAmF;QACnF,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,OAAO,CAAC;YAClB,UAAU,EAAE,OAAO,CAAC;YACpB,uDAAuD;YACvD,SAAS,CAAC,EAAE,OAAO,CAAC;SACrB,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ,CAAC;AAEF,uGAAuG;AACvG,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC"}

package/dist/schema/types.js

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

package/dist/schema/types.js.map

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

package/dist/schema/v2/describable.d.ts

@@ -0,0 +1,155 @@
+import { z } from "zod";
+export declare const v2ColumnFrontmatterSchema: z.ZodObject<{
+    id: z.ZodString;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    description: z.ZodOptional<z.ZodString>;
+    sensitive: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    sensitive?: boolean | undefined;
+    aliases?: string[] | undefined;
+    enum?: string[] | undefined;
+    description?: string | undefined;
+}, {
+    id: string;
+    sensitive?: boolean | undefined;
+    aliases?: string[] | undefined;
+    enum?: string[] | undefined;
+    description?: string | undefined;
+}>;
+export declare const v2TableFrontmatterSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    schemaId: z.ZodString;
+    primaryEntity: z.ZodOptional<z.ZodString>;
+    aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sensitive: z.ZodOptional<z.ZodBoolean>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+        sensitive: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        sensitive?: boolean | undefined;
+        aliases?: string[] | undefined;
+        enum?: string[] | undefined;
+        description?: string | undefined;
+    }, {
+        id: string;
+        sensitive?: boolean | undefined;
+        aliases?: string[] | undefined;
+        enum?: string[] | undefined;
+        description?: string | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    schemaId: string;
+    sensitive?: boolean | undefined;
+    columns?: {
+        id: string;
+        sensitive?: boolean | undefined;
+        aliases?: string[] | undefined;
+        enum?: string[] | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+    aliases?: string[] | undefined;
+    primaryEntity?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    name: string;
+    id: string;
+    schemaId: string;
+    sensitive?: boolean | undefined;
+    columns?: {
+        id: string;
+        sensitive?: boolean | undefined;
+        aliases?: string[] | undefined;
+        enum?: string[] | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+    aliases?: string[] | undefined;
+    primaryEntity?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+export type V2TableFrontmatter = z.infer<typeof v2TableFrontmatterSchema>;
+export type V2ColumnFrontmatter = z.infer<typeof v2ColumnFrontmatterSchema>;
+export declare const v2ConceptSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    synonyms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    links: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    label: string;
+    description?: string | undefined;
+    synonyms?: string[] | undefined;
+    links?: string[] | undefined;
+}, {
+    id: string;
+    label: string;
+    description?: string | undefined;
+    synonyms?: string[] | undefined;
+    links?: string[] | undefined;
+}>;
+export declare const v2ConceptsFrontmatterSchema: z.ZodObject<{
+    concepts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        synonyms: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        links: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        label: string;
+        description?: string | undefined;
+        synonyms?: string[] | undefined;
+        links?: string[] | undefined;
+    }, {
+        id: string;
+        label: string;
+        description?: string | undefined;
+        synonyms?: string[] | undefined;
+        links?: string[] | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    concepts: {
+        id: string;
+        label: string;
+        description?: string | undefined;
+        synonyms?: string[] | undefined;
+        links?: string[] | undefined;
+    }[];
+}, {
+    concepts: {
+        id: string;
+        label: string;
+        description?: string | undefined;
+        synonyms?: string[] | undefined;
+        links?: string[] | undefined;
+    }[];
+}>;
+export type V2Concept = z.infer<typeof v2ConceptSchema>;
+export type V2ConceptsFrontmatter = z.infer<typeof v2ConceptsFrontmatterSchema>;
+/** Recognized H2 section headings in table markdown files. */
+export declare const RECOGNIZED_H2_SECTIONS: readonly ["Common query language", "Example questions", "Business context", "Column notes"];
+export type RecognizedH2Section = (typeof RECOGNIZED_H2_SECTIONS)[number];
+/** Parsed representation of a `tables/<table>.md` file. */
+export type ParsedTableMarkdown = {
+    frontmatter: V2TableFrontmatter;
+    /** Verbatim markdown body (everything after the closing `---`). */
+    body: string;
+    /** Recognized H2 section bodies, keyed by heading (case-normalized). */
+    sections: Partial<Record<RecognizedH2Section, string>>;
+};
+/** Parsed representation of `concepts.md`. */
+export type ParsedConceptsMarkdown = {
+    frontmatter: V2ConceptsFrontmatter;
+    body: string;
+};
+//# sourceMappingURL=describable.d.ts.map

package/dist/schema/v2/describable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describable.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/describable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAQ3B,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW1B,CAAC;AAEZ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAQjB,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI7B,CAAC;AAEZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,6FAKzB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,2DAA2D;AAC3D,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,kBAAkB,CAAC;IAChC,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,qBAAqB,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/schema/v2/describable.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export const v2ColumnFrontmatterSchema = z
+    .object({
+    id: z.string().min(1),
+    aliases: z.array(z.string()).optional(),
+    enum: z.array(z.string()).optional(),
+    description: z.string().optional(),
+    sensitive: z.boolean().optional(),
+})
+    .strict();
+export const v2TableFrontmatterSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    schemaId: z.string().min(1),
+    primaryEntity: z.string().optional(),
+    aliases: z.array(z.string()).optional(),
+    tags: z.array(z.string()).optional(),
+    sensitive: z.boolean().optional(),
+    columns: z.array(v2ColumnFrontmatterSchema).optional(),
+})
+    .strict();
+export const v2ConceptSchema = z
+    .object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    synonyms: z.array(z.string()).optional(),
+    links: z.array(z.string()).optional(),
+    description: z.string().optional(),
+})
+    .strict();
+export const v2ConceptsFrontmatterSchema = z
+    .object({
+    concepts: z.array(v2ConceptSchema),
+})
+    .strict();
+/** Recognized H2 section headings in table markdown files. */
+export const RECOGNIZED_H2_SECTIONS = [
+    "Common query language",
+    "Example questions",
+    "Business context",
+    "Column notes",
+];
+//# sourceMappingURL=describable.js.map

package/dist/schema/v2/describable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describable.js","sourceRoot":"","sources":["../../../src/schema/v2/describable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC;KACD,MAAM,EAAE,CAAC;AAKZ,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;CACnC,CAAC;KACD,MAAM,EAAE,CAAC;AAKZ,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,uBAAuB;IACvB,mBAAmB;IACnB,kBAAkB;IAClB,cAAc;CACN,CAAC"}

package/dist/schema/v2/format.d.ts

@@ -0,0 +1,15 @@
+import type { NormalizedSchemaV2 } from "./normalized.js";
+import type { FormatNlToSqlOptions, NlToSqlSchemaFormatStats } from "../normalize.js";
+/**
+ * Format a NormalizedSchemaV2 for NL→SQL prompts.
+ *
+ * Interleaves table descriptions, aliases, column descriptions, and
+ * `Common query language` blocks when present in the describable layer.
+ * Sensitive describable-layer fields (descriptions/aliases/enum) are
+ * excluded per the schema-v2 contract.
+ */
+export declare function formatSchemaV2ForNlToSql(schema: NormalizedSchemaV2, options?: FormatNlToSqlOptions): {
+    ddl: string;
+    stats: NlToSqlSchemaFormatStats;
+};
+//# sourceMappingURL=format.d.ts.map

package/dist/schema/v2/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE,oBAAyB,GACjC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,CAsElD"}

package/dist/schema/v2/format.js

@@ -0,0 +1,97 @@
+/**
+ * Format a NormalizedSchemaV2 for NL→SQL prompts.
+ *
+ * Interleaves table descriptions, aliases, column descriptions, and
+ * `Common query language` blocks when present in the describable layer.
+ * Sensitive describable-layer fields (descriptions/aliases/enum) are
+ * excluded per the schema-v2 contract.
+ */
+export function formatSchemaV2ForNlToSql(schema, options = {}) {
+    const omit = options.omitSensitiveIdentifiersFromPrompt === true;
+    let redactedColumnCount = 0;
+    let sensitiveTableStubCount = 0;
+    let listedSensitiveColumnCount = 0;
+    const lines = [];
+    for (const t of schema.tables) {
+        // Table header — always qualify with database schema name; add alias annotation when present
+        const qualifiedName = `${t.schema}.${t.name}`;
+        const aliasNote = !t.sensitive && t.aliases?.length
+            ? ` -- aliases: ${t.aliases.join(", ")}`
+            : "";
+        lines.push(`TABLE ${qualifiedName}${aliasNote}`);
+        // Table description as a comment line
+        if (!t.sensitive && t.description) {
+            lines.push(`-- ${t.description}`);
+        }
+        if (omit && t.sensitive) {
+            sensitiveTableStubCount++;
+            redactedColumnCount += t.columns.length;
+            lines.push(`  (sensitive table — column definitions withheld from model context)`);
+            lines.push("");
+            continue;
+        }
+        if (omit) {
+            let visibleColumns = 0;
+            for (const c of t.columns) {
+                if (c.sensitive) {
+                    redactedColumnCount++;
+                    continue;
+                }
+                visibleColumns++;
+                lines.push(buildColumnLine(c, false, false));
+            }
+            if (visibleColumns === 0 && t.columns.length > 0) {
+                lines.push(`  (all columns marked sensitive — definitions withheld from model context)`);
+            }
+        }
+        else {
+            for (const c of t.columns) {
+                if (c.sensitive)
+                    listedSensitiveColumnCount++;
+                lines.push(buildColumnLine(c, c.sensitive, t.sensitive));
+            }
+        }
+        // Common query language block
+        if (!t.sensitive && t.commonQueryLanguage) {
+            lines.push(`-- common query language --`);
+            for (const cqlLine of t.commonQueryLanguage.split("\n")) {
+                lines.push(`-- ${cqlLine}`);
+            }
+        }
+        lines.push("");
+    }
+    const ddl = lines.join("\n").trimEnd();
+    return {
+        ddl,
+        stats: {
+            omitSensitiveIdentifiersFromPrompt: omit,
+            redactedColumnCount,
+            sensitiveTableStubCount,
+            listedSensitiveColumnCount,
+        },
+    };
+}
+function buildColumnLine(c, colSensitive, tableSensitive) {
+    const effective = colSensitive || tableSensitive;
+    const flags = [c.primaryKey ? "PK" : "", c.nullable ? "NULL" : "NOT NULL"]
+        .filter(Boolean)
+        .join(" ");
+    let line = `  - ${c.name} ${c.type}${flags ? ` (${flags})` : ""}`;
+    if (effective) {
+        line += " (sensitive)";
+    }
+    else {
+        // Append column description when present (describable-layer enrichment)
+        const extras = [];
+        if (c.aliases?.length)
+            extras.push(`aliases: ${c.aliases.join(", ")}`);
+        if (c.enum?.length)
+            extras.push(`values: ${c.enum.join("|")}`);
+        if (c.description)
+            extras.push(c.description);
+        if (extras.length)
+            line += ` -- ${extras.join("; ")}`;
+    }
+    return line;
+}
+//# sourceMappingURL=format.js.map

package/dist/schema/v2/format.js.map

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

package/dist/schema/v2/index.d.ts

@@ -0,0 +1,10 @@
+export { loadSchema, loadSchemaFromJson } from "./loader.js";
+export { parseTableMarkdown, parseConceptsMarkdown } from "./parser.js";
+export { writeTableMarkdown, writeConceptsMarkdown } from "./writer.js";
+export { formatSchemaV2ForNlToSql } from "./format.js";
+export { v2SchemaJsonSchema, v2TableSchema, v2ColumnSchema } from "./physical.js";
+export type { V2SchemaJson, V2Table, V2Column } from "./physical.js";
+export { v2TableFrontmatterSchema, v2ColumnFrontmatterSchema, v2ConceptsFrontmatterSchema, v2ConceptSchema, RECOGNIZED_H2_SECTIONS, } from "./describable.js";
+export type { V2TableFrontmatter, V2ColumnFrontmatter, V2ConceptsFrontmatter, V2Concept, ParsedTableMarkdown, ParsedConceptsMarkdown, RecognizedH2Section, } from "./describable.js";
+export type { NormalizedSchemaV2, NormalizedV2Table, NormalizedV2Column, SchemaV2Warning, } from "./normalized.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/v2/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,EACT,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/schema/v2/index.js

@@ -0,0 +1,7 @@
+export { loadSchema, loadSchemaFromJson } from "./loader.js";
+export { parseTableMarkdown, parseConceptsMarkdown } from "./parser.js";
+export { writeTableMarkdown, writeConceptsMarkdown } from "./writer.js";
+export { formatSchemaV2ForNlToSql } from "./format.js";
+export { v2SchemaJsonSchema, v2TableSchema, v2ColumnSchema } from "./physical.js";
+export { v2TableFrontmatterSchema, v2ColumnFrontmatterSchema, v2ConceptsFrontmatterSchema, v2ConceptSchema, RECOGNIZED_H2_SECTIONS, } from "./describable.js";
+//# sourceMappingURL=index.js.map

package/dist/schema/v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/v2/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAElF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/schema/v2/loader.d.ts

@@ -0,0 +1,18 @@
+import type { NormalizedSchemaV2 } from "./normalized.js";
+/**
+ * Load a Schema v2 artifact from a raw JSON string.
+ *
+ * Accepts a bundled JSON (has `bundled: true`) or a bare `schema.json` blob.
+ * Rejects the pre-v2 format with a clear error.
+ */
+export declare function loadSchemaFromJson(raw: string): NormalizedSchemaV2;
+/**
+ * Load a Schema v2 artifact from disk.
+ *
+ * Autodetects between:
+ *  - A v2 directory (`<schemaId>.schema/`) containing `schema.json`
+ *  - A bundled JSON file (`*.bundle.json` or any JSON with `bundled: true`)
+ *  - A direct path to a `schema.json` inside a directory
+ */
+export declare function loadSchema(path: string): NormalizedSchemaV2;
+//# sourceMappingURL=loader.d.ts.map

package/dist/schema/v2/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,iBAAiB,CAAC;AAWzB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAYlE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAwB3D"}