@askdb/core 0.5.0-beta.0

package/dist/schema/v2/loader.js

@@ -0,0 +1,230 @@
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { SchemaParseError } from "../../errors.js";
+import { parseConceptsMarkdown, parseTableMarkdown } from "./parser.js";
+import { v2SchemaJsonSchema } from "./physical.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 function loadSchemaFromJson(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new SchemaParseError("Failed to parse schema JSON string");
+    }
+    if (typeof parsed === "object" && parsed !== null && "bundled" in parsed) {
+        return loadFromBundle(parsed, "<inline JSON>");
+    }
+    const physical = parsePhysicalLayer(parsed, "<inline JSON>");
+    return buildNormalized(physical, {}, undefined, []);
+}
+/**
+ * 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 function loadSchema(path) {
+    const resolved = resolve(path);
+    const stat = statSync(resolved);
+    if (stat.isDirectory()) {
+        return loadFromDirectory(resolved);
+    }
+    const raw = readFileSync(resolved, "utf8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new SchemaParseError(`Failed to parse JSON at ${resolved}`);
+    }
+    // Could be a bundled JSON or a bare schema.json
+    if (typeof parsed === "object" && parsed !== null && "bundled" in parsed) {
+        return loadFromBundle(parsed, resolved);
+    }
+    // Bare schema.json — treat enclosing directory as the schema directory
+    const physical = parsePhysicalLayer(parsed, resolved);
+    return buildNormalized(physical, {}, undefined, []);
+}
+function loadFromDirectory(dir) {
+    const schemaJsonPath = join(dir, "schema.json");
+    let raw;
+    try {
+        raw = readFileSync(schemaJsonPath, "utf8");
+    }
+    catch {
+        throw new SchemaParseError(`No schema.json found in directory: ${dir}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new SchemaParseError(`Failed to parse schema.json in ${dir}`);
+    }
+    const physical = parsePhysicalLayer(parsed, schemaJsonPath);
+    // Load tables/*.md
+    const tableDir = join(dir, "tables");
+    const tableMarkdowns = {};
+    try {
+        const entries = readdirSync(tableDir);
+        for (const entry of entries) {
+            if (!entry.endsWith(".md"))
+                continue;
+            const filePath = join(tableDir, entry);
+            const content = readFileSync(filePath, "utf8");
+            const parsed = parseTableMarkdown(content, filePath);
+            tableMarkdowns[parsed.frontmatter.id] = parsed;
+        }
+    }
+    catch (e) {
+        // tables/ directory is optional; only rethrow SchemaParseError
+        if (e instanceof SchemaParseError)
+            throw e;
+    }
+    // Load optional concepts.md
+    let concepts;
+    try {
+        const conceptsPath = join(dir, "concepts.md");
+        const content = readFileSync(conceptsPath, "utf8");
+        concepts = parseConceptsMarkdown(content, conceptsPath).frontmatter;
+    }
+    catch {
+        // optional
+    }
+    return buildNormalized(physical, tableMarkdowns, concepts, []);
+}
+function loadFromBundle(bundle, filePath) {
+    const physical = parsePhysicalLayer(bundle.physical, filePath);
+    const tableMarkdowns = {};
+    for (const [filename, content] of Object.entries(bundle.tables)) {
+        const parsed = parseTableMarkdown(content, filename);
+        tableMarkdowns[parsed.frontmatter.id] = parsed;
+    }
+    let concepts;
+    if (bundle.concepts) {
+        concepts = parseConceptsMarkdown(bundle.concepts, "concepts.md").frontmatter;
+    }
+    return buildNormalized(physical, tableMarkdowns, concepts, []);
+}
+function parsePhysicalLayer(data, filePath) {
+    // Detect and reject pre-v2 format
+    if (typeof data === "object" &&
+        data !== null &&
+        "version" in data &&
+        data.version === 1) {
+        throw new SchemaParseError(`AskDB schema format \`version: 1\` is not supported as of \`@askdb/core@0.2.0\`. ` +
+            `Migrate to Schema v2 format. See \`docs/contracts/schema-v2.md\` for the format contract.`);
+    }
+    const result = v2SchemaJsonSchema.safeParse(data);
+    if (!result.success) {
+        throw new SchemaParseError(`Invalid schema.json at ${filePath}: ${result.error.message}`, result.error);
+    }
+    return result.data;
+}
+function buildNormalized(physical, tableMarkdowns, concepts, extraWarnings) {
+    const warnings = [...extraWarnings];
+    // Build a map of all physical table ids and column ids for ID validation
+    const physicalTableIds = new Set(physical.tables.map((t) => t.id));
+    const physicalColumnIds = new Set(physical.tables.flatMap((t) => t.columns.map((c) => c.id)));
+    // Validate all table markdown IDs against physical layer
+    for (const [id, parsed] of Object.entries(tableMarkdowns)) {
+        if (!physicalTableIds.has(id)) {
+            warnings.push({ kind: "orphaned_table_id", tableFile: `tables/${parsed.frontmatter.name}.md`, id });
+        }
+        for (const col of parsed.frontmatter.columns ?? []) {
+            if (!physicalColumnIds.has(col.id)) {
+                warnings.push({ kind: "orphaned_column_id", tableFile: `tables/${parsed.frontmatter.name}.md`, id: col.id });
+            }
+        }
+    }
+    const tables = physical.tables.map((physTable) => {
+        const md = tableMarkdowns[physTable.id];
+        const tableSensitive = physTable.sensitive === true;
+        const columns = physTable.columns.map((physCol) => {
+            const colSensitive = physCol.sensitive === true || tableSensitive;
+            const mdCol = md?.frontmatter.columns?.find((c) => c.id === physCol.id);
+            const normalized = {
+                id: physCol.id,
+                name: physCol.name,
+                type: physCol.type,
+                nullable: physCol.nullable,
+                primaryKey: physCol.primaryKey ?? false,
+                sensitive: colSensitive,
+            };
+            // Describable-layer fields excluded when sensitive
+            if (!colSensitive && mdCol) {
+                if (mdCol.description !== undefined)
+                    normalized.description = mdCol.description;
+                if (mdCol.aliases?.length)
+                    normalized.aliases = mdCol.aliases;
+                if (mdCol.enum?.length)
+                    normalized.enum = mdCol.enum;
+            }
+            return normalized;
+        });
+        const normalized = {
+            id: physTable.id,
+            name: physTable.name,
+            schema: physTable.schema,
+            sensitive: tableSensitive,
+            columns,
+            relationships: physTable.relationships,
+        };
+        // Table-level describable fields excluded when sensitive
+        if (!tableSensitive && md) {
+            const fm = md.frontmatter;
+            if (fm.aliases?.length)
+                normalized.aliases = fm.aliases;
+            if (fm.primaryEntity)
+                normalized.primaryEntity = fm.primaryEntity;
+            // First paragraph of body is the table description
+            const firstParagraph = extractFirstParagraph(md.body);
+            if (firstParagraph)
+                normalized.description = firstParagraph;
+            const cql = md.sections["Common query language"];
+            if (cql?.trim())
+                normalized.commonQueryLanguage = cql.trim();
+        }
+        return normalized;
+    });
+    return {
+        schemaId: physical.schemaId,
+        tables,
+        concepts: concepts?.concepts,
+        warnings,
+    };
+}
+/** Extract the first non-heading, non-empty paragraph from a markdown body. */
+function extractFirstParagraph(body) {
+    const lines = body.split("\n");
+    const paragraphLines = [];
+    let inParagraph = false;
+    let seenHeading = false;
+    for (const line of lines) {
+        if (line.startsWith("#")) {
+            // Skip the leading H1 (table title), but stop at any subsequent heading
+            // so we don't leak content from the next section into the description.
+            if (seenHeading)
+                break;
+            seenHeading = true;
+            continue;
+        }
+        if (line.trim() === "") {
+            if (inParagraph)
+                break;
+            continue;
+        }
+        inParagraph = true;
+        paragraphLines.push(line.trim());
+    }
+    return paragraphLines.length > 0 ? paragraphLines.join(" ") : undefined;
+}
+//# sourceMappingURL=loader.js.map

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

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

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

@@ -0,0 +1,58 @@
+import type { V2Concept } from "./describable.js";
+/** Normalized column with optional v2 describable-layer fields. */
+export type NormalizedV2Column = {
+    id: string;
+    name: string;
+    type: string;
+    nullable: boolean;
+    primaryKey: boolean;
+    sensitive: boolean;
+    /** Describable-layer fields. Absent when sensitive=true (excluded from prompts). */
+    description?: string;
+    aliases?: string[];
+    enum?: string[];
+};
+/** Normalized table with optional v2 describable-layer fields. */
+export type NormalizedV2Table = {
+    id: string;
+    name: string;
+    /** Database schema (namespace) this table belongs to, e.g. `"public"`, `"app"`. */
+    schema: string;
+    sensitive: boolean;
+    columns: NormalizedV2Column[];
+    relationships?: Array<{
+        from: string;
+        to: string;
+    }>;
+    /** Describable-layer fields. */
+    description?: string;
+    aliases?: string[];
+    primaryEntity?: string;
+    /** Verbatim content of the `Common query language` H2 section. */
+    commonQueryLanguage?: string;
+};
+/** Fully normalized Schema v2 artifact — physical + describable layers merged. */
+export type NormalizedSchemaV2 = {
+    schemaId: string;
+    tables: NormalizedV2Table[];
+    concepts?: V2Concept[];
+    /** Structured warnings from ID validation (orphaned/missing ids). */
+    warnings: SchemaV2Warning[];
+};
+export type SchemaV2Warning = {
+    kind: "orphaned_table_id";
+    tableFile: string;
+    id: string;
+} | {
+    kind: "orphaned_column_id";
+    tableFile: string;
+    id: string;
+} | {
+    kind: "missing_table_md";
+    tableId: string;
+} | {
+    kind: "missing_column_md";
+    tableId: string;
+    columnId: string;
+};
+//# sourceMappingURL=normalized.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalized.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/normalized.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,kFAAkF;AAClF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,qEAAqE;IACrE,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/schema/v2/normalized.js

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

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

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

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

@@ -0,0 +1,12 @@
+import { type ParsedConceptsMarkdown, type ParsedTableMarkdown } from "./describable.js";
+/**
+ * Parse a `tables/<table>.md` file.
+ * Front-matter is validated by zod (strict — unknown keys are errors).
+ * Recognized H2 sections are extracted; the rest of the body is preserved verbatim.
+ */
+export declare function parseTableMarkdown(content: string, filePath?: string): ParsedTableMarkdown;
+/**
+ * Parse `concepts.md`.
+ */
+export declare function parseConceptsMarkdown(content: string, filePath?: string): ParsedConceptsMarkdown;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAEzB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAe1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAWhG"}

package/dist/schema/v2/parser.js

@@ -0,0 +1,48 @@
+import matter from "gray-matter";
+import { SchemaParseError } from "../../errors.js";
+import { RECOGNIZED_H2_SECTIONS, v2ConceptsFrontmatterSchema, v2TableFrontmatterSchema, } from "./describable.js";
+/**
+ * Parse a `tables/<table>.md` file.
+ * Front-matter is validated by zod (strict — unknown keys are errors).
+ * Recognized H2 sections are extracted; the rest of the body is preserved verbatim.
+ */
+export function parseTableMarkdown(content, filePath) {
+    const file = matter(content);
+    const result = v2TableFrontmatterSchema.safeParse(file.data);
+    if (!result.success) {
+        const loc = filePath ? ` in ${filePath}` : "";
+        throw new SchemaParseError(`Invalid table front-matter${loc}: ${result.error.message}`, result.error);
+    }
+    const body = file.content;
+    const sections = extractH2Sections(body);
+    return { frontmatter: result.data, body, sections };
+}
+/**
+ * Parse `concepts.md`.
+ */
+export function parseConceptsMarkdown(content, filePath) {
+    const file = matter(content);
+    const result = v2ConceptsFrontmatterSchema.safeParse(file.data);
+    if (!result.success) {
+        const loc = filePath ? ` in ${filePath}` : "";
+        throw new SchemaParseError(`Invalid concepts front-matter${loc}: ${result.error.message}`, result.error);
+    }
+    return { frontmatter: result.data, body: file.content };
+}
+/** Extract recognized H2 sections from a markdown body string. */
+function extractH2Sections(body) {
+    const sections = {};
+    // Split on H2 headings
+    const parts = body.split(/^## /m);
+    for (const part of parts.slice(1)) {
+        const newline = part.indexOf("\n");
+        const heading = (newline === -1 ? part : part.slice(0, newline)).trim();
+        const sectionBody = newline === -1 ? "" : part.slice(newline + 1);
+        const matched = RECOGNIZED_H2_SECTIONS.find((s) => s.toLowerCase() === heading.toLowerCase());
+        if (matched) {
+            sections[matched] = sectionBody;
+        }
+    }
+    return sections;
+}
+//# sourceMappingURL=parser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/schema/v2/parser.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,wBAAwB,GAIzB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAiB;IACnE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,gBAAgB,CACxB,6BAA6B,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAC3D,MAAM,CAAC,KAAK,CACb,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC;IAC1B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,QAAiB;IACtE,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,gBAAgB,CACxB,gCAAgC,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAC9D,MAAM,CAAC,KAAK,CACb,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED,kEAAkE;AAClE,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,QAAQ,GAAiD,EAAE,CAAC;IAClE,uBAAuB;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxE,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CACjD,CAAC;QACF,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,229 @@
+import { z } from "zod";
+export declare const v2ColumnSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    type: z.ZodString;
+    nullable: z.ZodBoolean;
+    primaryKey: z.ZodOptional<z.ZodBoolean>;
+    sensitive: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: string;
+    nullable: boolean;
+    id: string;
+    primaryKey?: boolean | undefined;
+    sensitive?: boolean | undefined;
+}, {
+    name: string;
+    type: string;
+    nullable: boolean;
+    id: string;
+    primaryKey?: boolean | undefined;
+    sensitive?: boolean | undefined;
+}>;
+export declare const v2RelationshipSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    from: string;
+    to: string;
+}, {
+    from: string;
+    to: string;
+}>;
+export declare const v2TableSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    /** Database schema (namespace) this table belongs to, e.g. `"public"`, `"app"`. Required. */
+    schema: z.ZodString;
+    sensitive: z.ZodOptional<z.ZodBoolean>;
+    columns: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        type: z.ZodString;
+        nullable: z.ZodBoolean;
+        primaryKey: z.ZodOptional<z.ZodBoolean>;
+        sensitive: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: string;
+        nullable: boolean;
+        id: string;
+        primaryKey?: boolean | undefined;
+        sensitive?: boolean | undefined;
+    }, {
+        name: string;
+        type: string;
+        nullable: boolean;
+        id: string;
+        primaryKey?: boolean | undefined;
+        sensitive?: boolean | undefined;
+    }>, "many">;
+    relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        from: string;
+        to: string;
+    }, {
+        from: string;
+        to: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    columns: {
+        name: string;
+        type: string;
+        nullable: boolean;
+        id: string;
+        primaryKey?: boolean | undefined;
+        sensitive?: boolean | undefined;
+    }[];
+    id: string;
+    schema: string;
+    sensitive?: boolean | undefined;
+    relationships?: {
+        from: string;
+        to: string;
+    }[] | undefined;
+}, {
+    name: string;
+    columns: {
+        name: string;
+        type: string;
+        nullable: boolean;
+        id: string;
+        primaryKey?: boolean | undefined;
+        sensitive?: boolean | undefined;
+    }[];
+    id: string;
+    schema: string;
+    sensitive?: boolean | undefined;
+    relationships?: {
+        from: string;
+        to: string;
+    }[] | undefined;
+}>;
+export declare const v2SchemaJsonSchema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    schemaId: z.ZodString;
+    tables: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        /** Database schema (namespace) this table belongs to, e.g. `"public"`, `"app"`. Required. */
+        schema: z.ZodString;
+        sensitive: z.ZodOptional<z.ZodBoolean>;
+        columns: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodString;
+            nullable: z.ZodBoolean;
+            primaryKey: z.ZodOptional<z.ZodBoolean>;
+            sensitive: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type: string;
+            nullable: boolean;
+            id: string;
+            primaryKey?: boolean | undefined;
+            sensitive?: boolean | undefined;
+        }, {
+            name: string;
+            type: string;
+            nullable: boolean;
+            id: string;
+            primaryKey?: boolean | undefined;
+            sensitive?: boolean | undefined;
+        }>, "many">;
+        relationships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+        }, {
+            from: string;
+            to: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        columns: {
+            name: string;
+            type: string;
+            nullable: boolean;
+            id: string;
+            primaryKey?: boolean | undefined;
+            sensitive?: boolean | undefined;
+        }[];
+        id: string;
+        schema: string;
+        sensitive?: boolean | undefined;
+        relationships?: {
+            from: string;
+            to: string;
+        }[] | undefined;
+    }, {
+        name: string;
+        columns: {
+            name: string;
+            type: string;
+            nullable: boolean;
+            id: string;
+            primaryKey?: boolean | undefined;
+            sensitive?: boolean | undefined;
+        }[];
+        id: string;
+        schema: string;
+        sensitive?: boolean | undefined;
+        relationships?: {
+            from: string;
+            to: string;
+        }[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    version: 2;
+    tables: {
+        name: string;
+        columns: {
+            name: string;
+            type: string;
+            nullable: boolean;
+            id: string;
+            primaryKey?: boolean | undefined;
+            sensitive?: boolean | undefined;
+        }[];
+        id: string;
+        schema: string;
+        sensitive?: boolean | undefined;
+        relationships?: {
+            from: string;
+            to: string;
+        }[] | undefined;
+    }[];
+    schemaId: string;
+}, {
+    version: 2;
+    tables: {
+        name: string;
+        columns: {
+            name: string;
+            type: string;
+            nullable: boolean;
+            id: string;
+            primaryKey?: boolean | undefined;
+            sensitive?: boolean | undefined;
+        }[];
+        id: string;
+        schema: string;
+        sensitive?: boolean | undefined;
+        relationships?: {
+            from: string;
+            to: string;
+        }[] | undefined;
+    }[];
+    schemaId: string;
+}>;
+export type V2SchemaJson = z.infer<typeof v2SchemaJsonSchema>;
+export type V2Table = z.infer<typeof v2TableSchema>;
+export type V2Column = z.infer<typeof v2ColumnSchema>;
+//# sourceMappingURL=physical.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"physical.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/physical.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,aAAa;;;IAGxB,6FAA6F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7F,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;QAP7B,6FAA6F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW7F,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/dist/schema/v2/physical.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export const v2ColumnSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    type: z.string().min(1),
+    nullable: z.boolean(),
+    primaryKey: z.boolean().optional(),
+    sensitive: z.boolean().optional(),
+});
+export const v2RelationshipSchema = z.object({
+    from: z.string().min(1),
+    to: z.string().min(1),
+});
+export const v2TableSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    /** Database schema (namespace) this table belongs to, e.g. `"public"`, `"app"`. Required. */
+    schema: z.string().min(1),
+    sensitive: z.boolean().optional(),
+    columns: z.array(v2ColumnSchema).min(1),
+    relationships: z.array(v2RelationshipSchema).optional(),
+});
+export const v2SchemaJsonSchema = z.object({
+    version: z.literal(2),
+    schemaId: z.string().min(1),
+    tables: z.array(v2TableSchema).min(1),
+});
+//# sourceMappingURL=physical.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"physical.js","sourceRoot":"","sources":["../../../src/schema/v2/physical.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,6FAA6F;IAC7F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACtC,CAAC,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { V2TableFrontmatter, V2ConceptsFrontmatter } from "./describable.js";
+/**
+ * Serialize a table front-matter model back to markdown.
+ *
+ * - Front-matter keys are emitted in a stable order.
+ * - The markdown body is preserved verbatim from the parsed input.
+ * - Round-trip property: `parse(write(parse(file)))` equals `parse(file)` for structured fields.
+ */
+export declare function writeTableMarkdown(frontmatter: V2TableFrontmatter, body: string): string;
+/**
+ * Serialize `concepts.md` front-matter + body back to markdown.
+ */
+export declare function writeConceptsMarkdown(frontmatter: V2ConceptsFrontmatter, body: string): string;
+//# sourceMappingURL=writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/schema/v2/writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAElF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9F"}