@sdd-method/sdd-cli 0.10.0 → 0.11.0

package/dist/lib/catalogue/csv-reader.d.ts

@@ -0,0 +1,7 @@
+export interface ParsedCsv {
+    readonly columns: readonly string[];
+    readonly rows: readonly Record<string, string>[];
+}
+export declare function readCatalogueCsv(path: string): Promise<ParsedCsv>;
+export declare function parseCatalogueCsv(text: string): ParsedCsv;
+//# sourceMappingURL=csv-reader.d.ts.map

package/dist/lib/catalogue/csv-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-reader.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/csv-reader.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAClD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAGvE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAezD"}

package/dist/lib/catalogue/csv-reader.js

@@ -0,0 +1,97 @@
+// CSV reader for catalogue files.
+//
+// RFC-4180-aware: handles `"` quoting (including doubled `""` for literal
+// quotes), commas inside quoted cells, and CR/LF/CRLF line breaks. We
+// don't try to be a general CSV library — the canonical writer's output
+// is the input shape we support, plus tolerance for byte-identical
+// catalogues authored by other conforming aggregator implementations.
+//
+// Headers come from the file's first line; column order is preserved
+// for traceability but row access is by column name.
+import { readFile } from "node:fs/promises";
+export async function readCatalogueCsv(path) {
+    const text = await readFile(path, "utf-8");
+    return parseCatalogueCsv(text);
+}
+export function parseCatalogueCsv(text) {
+    const records = parseRecords(text);
+    if (records.length === 0)
+        return { columns: [], rows: [] };
+    const columns = records[0] ?? [];
+    const rows = [];
+    for (let r = 1; r < records.length; r++) {
+        const record = records[r] ?? [];
+        if (record.length === 1 && record[0] === "")
+            continue; // empty trailing line
+        const row = {};
+        for (let c = 0; c < columns.length; c++) {
+            row[columns[c] ?? ""] = record[c] ?? "";
+        }
+        rows.push(row);
+    }
+    return { columns, rows };
+}
+function parseRecords(text) {
+    const records = [];
+    let current = [];
+    let cell = "";
+    let i = 0;
+    let inQuotes = false;
+    while (i < text.length) {
+        const ch = text[i] ?? "";
+        if (inQuotes) {
+            if (ch === '"') {
+                if (text[i + 1] === '"') {
+                    // Escaped double-quote inside a quoted cell.
+                    cell += '"';
+                    i += 2;
+                    continue;
+                }
+                inQuotes = false;
+                i++;
+                continue;
+            }
+            cell += ch;
+            i++;
+            continue;
+        }
+        if (ch === '"') {
+            inQuotes = true;
+            i++;
+            continue;
+        }
+        if (ch === ",") {
+            current.push(cell);
+            cell = "";
+            i++;
+            continue;
+        }
+        if (ch === "\r") {
+            if (text[i + 1] === "\n")
+                i++;
+            current.push(cell);
+            records.push(current);
+            current = [];
+            cell = "";
+            i++;
+            continue;
+        }
+        if (ch === "\n") {
+            current.push(cell);
+            records.push(current);
+            current = [];
+            cell = "";
+            i++;
+            continue;
+        }
+        cell += ch;
+        i++;
+    }
+    // Trailing cell + record.
+    if (cell !== "" || current.length > 0) {
+        current.push(cell);
+        records.push(current);
+    }
+    return records;
+}
+//# sourceMappingURL=csv-reader.js.map

package/dist/lib/catalogue/csv-reader.js.map

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

package/dist/lib/catalogue/csv-writer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Deterministic CSV writer for catalogues.
+ *
+ * Emits headers + sorted rows per ADR 0134 builder contract:
+ *   - column order matches the canonical schema exactly,
+ *   - rows sorted by primary-key value,
+ *   - cells with embedded comma/quote/newline are RFC-4180 quoted,
+ *   - empty trailing newline (POSIX convention).
+ *
+ * Headers-only emission is supported — pass an empty rows array to write
+ * a CSV that downstream consumers can rely on the file existence of.
+ */
+import type { CatalogueDef } from "./schema-loader.js";
+/** A row is a map from column name to cell value. Missing keys become empty cells. */
+export type CatalogueRow = Readonly<Record<string, string | number | boolean | null | undefined>>;
+export interface WriteCatalogueOptions {
+    /** Absolute path to the output directory (typically `<sdd-root>/catalogues/`). */
+    readonly outDir: string;
+    /** Catalogue definition driving column order + primary key. */
+    readonly catalogue: CatalogueDef;
+    /** Rows to emit. Empty array ⇒ headers-only file. */
+    readonly rows: readonly CatalogueRow[];
+}
+export declare function writeCatalogue(opts: WriteCatalogueOptions): Promise<{
+    rowCount: number;
+    path: string;
+}>;
+export declare function renderCatalogueCsv(catalogue: CatalogueDef, rows: readonly CatalogueRow[]): string;
+//# sourceMappingURL=csv-writer.d.ts.map

package/dist/lib/catalogue/csv-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-writer.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/csv-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,sFAAsF;AACtF,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC;AAElG,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAO7G;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,SAAS,YAAY,EAAE,GAC5B,MAAM,CAcR"}

package/dist/lib/catalogue/csv-writer.js

@@ -0,0 +1,55 @@
+/**
+ * Deterministic CSV writer for catalogues.
+ *
+ * Emits headers + sorted rows per ADR 0134 builder contract:
+ *   - column order matches the canonical schema exactly,
+ *   - rows sorted by primary-key value,
+ *   - cells with embedded comma/quote/newline are RFC-4180 quoted,
+ *   - empty trailing newline (POSIX convention).
+ *
+ * Headers-only emission is supported — pass an empty rows array to write
+ * a CSV that downstream consumers can rely on the file existence of.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export async function writeCatalogue(opts) {
+    await mkdir(opts.outDir, { recursive: true });
+    const filePath = join(opts.outDir, `${opts.catalogue.name}.csv`);
+    const text = renderCatalogueCsv(opts.catalogue, opts.rows);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, text, "utf-8");
+    return { rowCount: opts.rows.length, path: filePath };
+}
+export function renderCatalogueCsv(catalogue, rows) {
+    const columns = catalogue.columns.map((c) => c.name);
+    const lines = [];
+    lines.push(columns.map(escapeCell).join(","));
+    const sorted = [...rows].sort((a, b) => compareCell(a[catalogue.primaryKey], b[catalogue.primaryKey]));
+    for (const row of sorted) {
+        const cells = columns.map((col) => escapeCell(formatCell(row[col])));
+        lines.push(cells.join(","));
+    }
+    // Trailing newline per POSIX convention.
+    return `${lines.join("\n")}\n`;
+}
+function formatCell(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "boolean")
+        return value ? "true" : "false";
+    return String(value);
+}
+function escapeCell(value) {
+    if (value === "")
+        return "";
+    if (/[",\n\r]/.test(value)) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+function compareCell(a, b) {
+    const sa = a === undefined || a === null ? "" : String(a);
+    const sb = b === undefined || b === null ? "" : String(b);
+    return sa < sb ? -1 : sa > sb ? 1 : 0;
+}
+//# sourceMappingURL=csv-writer.js.map

package/dist/lib/catalogue/csv-writer.js.map

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

package/dist/lib/catalogue/findings.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Findings collector for the canonical builder per ADR 0134 / builder-spec
+ * §"Emit findings as it parses".
+ *
+ * Findings are human-readable AND machine-parseable. Format per finding:
+ *   [finding] {category}: {one-line summary}
+ *
+ * Categories are an open set; the canonical catalogue is in the builder
+ * spec. This module hardcodes the well-known ones for type safety; new
+ * categories may be passed as freeform strings if they emerge.
+ */
+export type FindingCategory = "divergence" | "coverage" | "orphan" | "convention" | "inferred" | "external";
+export interface Finding {
+    readonly category: FindingCategory | string;
+    readonly summary: string;
+}
+export declare class FindingsLog {
+    private readonly findings;
+    add(category: FindingCategory | string, summary: string): void;
+    /** Returns a copy of recorded findings, in insertion order. */
+    all(): readonly Finding[];
+    /** Count findings, optionally filtered to a single category. */
+    count(category?: FindingCategory | string): number;
+    /** Render every finding as a stdout line. */
+    render(): string;
+}
+//# sourceMappingURL=findings.d.ts.map

package/dist/lib/catalogue/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/findings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,GAAG,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9D,+DAA+D;IAC/D,GAAG,IAAI,SAAS,OAAO,EAAE;IAIzB,gEAAgE;IAChE,KAAK,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM;IAKlD,6CAA6C;IAC7C,MAAM,IAAI,MAAM;CAKjB"}

package/dist/lib/catalogue/findings.js

@@ -0,0 +1,34 @@
+/**
+ * Findings collector for the canonical builder per ADR 0134 / builder-spec
+ * §"Emit findings as it parses".
+ *
+ * Findings are human-readable AND machine-parseable. Format per finding:
+ *   [finding] {category}: {one-line summary}
+ *
+ * Categories are an open set; the canonical catalogue is in the builder
+ * spec. This module hardcodes the well-known ones for type safety; new
+ * categories may be passed as freeform strings if they emerge.
+ */
+export class FindingsLog {
+    findings = [];
+    add(category, summary) {
+        this.findings.push({ category, summary });
+    }
+    /** Returns a copy of recorded findings, in insertion order. */
+    all() {
+        return [...this.findings];
+    }
+    /** Count findings, optionally filtered to a single category. */
+    count(category) {
+        if (category === undefined)
+            return this.findings.length;
+        return this.findings.filter((f) => f.category === category).length;
+    }
+    /** Render every finding as a stdout line. */
+    render() {
+        return this.findings
+            .map((f) => `[finding] ${f.category}: ${f.summary}`)
+            .join("\n");
+    }
+}
+//# sourceMappingURL=findings.js.map

package/dist/lib/catalogue/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../../../src/lib/catalogue/findings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,MAAM,OAAO,WAAW;IACL,QAAQ,GAAc,EAAE,CAAC;IAE1C,GAAG,CAAC,QAAkC,EAAE,OAAe;QACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,+DAA+D;IAC/D,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,QAAmC;QACvC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACxD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IACrE,CAAC;IAED,6CAA6C;IAC7C,MAAM;QACJ,OAAO,IAAI,CAAC,QAAQ;aACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACnD,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;CACF"}

package/dist/lib/catalogue/fk-validator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * FK validator per ADR 0134 builder-spec §"Run internal FK validation
+ * before exiting" + §"External FK handling".
+ *
+ * For each catalogue's foreign keys:
+ *   - Internal FKs (external=false): every non-empty value MUST resolve
+ *     to a primary-key in the referenced catalogue's emitted rows. Missing
+ *     resolution is a hard failure.
+ *   - External FKs (external=true): every non-empty value is logged as a
+ *     `[finding] external` line and skipped from validation. The aggregator
+ *     resolves these post-merge per ADR 0134 §4.5.
+ *
+ * Returns a structured result; the caller decides exit code + reporting.
+ */
+import type { CanonicalSchema } from "./schema-loader.js";
+import type { CatalogueRow } from "./csv-writer.js";
+import type { FindingsLog } from "./findings.js";
+export interface FkValidationResult {
+    readonly internalPass: boolean;
+    readonly internalFailures: readonly FkFailure[];
+    readonly externalFindings: number;
+}
+export interface FkFailure {
+    readonly catalogue: string;
+    readonly column: string;
+    readonly referencingRow: string;
+    readonly value: string;
+    readonly target: string;
+}
+export interface FkValidationOptions {
+    /**
+     * When true, treat FKs declared `external: true` as if they were
+     * internal — validate them against own rows and fail on dangling
+     * references. Used by the aggregator after merge per ADR 0134 §4.5.
+     * Defaults to false.
+     */
+    readonly treatExternalAsInternal?: boolean;
+}
+/**
+ * Build an in-memory map of every catalogue's primary-key set, then walk
+ * every row's FK columns and check resolution.
+ */
+export declare function validateForeignKeys(schema: CanonicalSchema, rowsByCatalogue: ReadonlyMap<string, readonly CatalogueRow[]>, findings: FindingsLog, options?: FkValidationOptions): FkValidationResult;
+//# sourceMappingURL=fk-validator.d.ts.map

package/dist/lib/catalogue/fk-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fk-validator.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/fk-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,SAAS,EAAE,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,eAAe,EACvB,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC,EAC7D,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAoFpB"}

package/dist/lib/catalogue/fk-validator.js

@@ -0,0 +1,90 @@
+/**
+ * FK validator per ADR 0134 builder-spec §"Run internal FK validation
+ * before exiting" + §"External FK handling".
+ *
+ * For each catalogue's foreign keys:
+ *   - Internal FKs (external=false): every non-empty value MUST resolve
+ *     to a primary-key in the referenced catalogue's emitted rows. Missing
+ *     resolution is a hard failure.
+ *   - External FKs (external=true): every non-empty value is logged as a
+ *     `[finding] external` line and skipped from validation. The aggregator
+ *     resolves these post-merge per ADR 0134 §4.5.
+ *
+ * Returns a structured result; the caller decides exit code + reporting.
+ */
+/**
+ * Build an in-memory map of every catalogue's primary-key set, then walk
+ * every row's FK columns and check resolution.
+ */
+export function validateForeignKeys(schema, rowsByCatalogue, findings, options = {}) {
+    // Index primary keys per catalogue.
+    const pkIndex = new Map();
+    for (const cat of schema.catalogues) {
+        const rows = rowsByCatalogue.get(cat.name) ?? [];
+        const pks = new Set();
+        for (const row of rows) {
+            const pk = row[cat.primaryKey];
+            if (pk !== undefined && pk !== null && pk !== "") {
+                pks.add(String(pk));
+            }
+        }
+        pkIndex.set(cat.name, pks);
+    }
+    const failures = [];
+    let externalCount = 0;
+    for (const cat of schema.catalogues) {
+        const rows = rowsByCatalogue.get(cat.name) ?? [];
+        for (const fk of cat.foreignKeys) {
+            const [targetCat, targetCol] = fk.references.split(".");
+            if (!targetCat || !targetCol) {
+                throw new Error(`malformed FK reference "${fk.references}" on ${cat.name}.${fk.column}`);
+            }
+            const targetPks = pkIndex.get(targetCat);
+            if (!targetPks) {
+                throw new Error(`FK ${cat.name}.${fk.column} references unknown catalogue "${targetCat}"`);
+            }
+            for (const row of rows) {
+                const raw = row[fk.column];
+                if (raw === undefined || raw === null || raw === "") {
+                    if (!fk.nullable && !fk.external) {
+                        // Required FK with no value — internal violation regardless of external flag.
+                        failures.push({
+                            catalogue: cat.name,
+                            column: fk.column,
+                            referencingRow: String(row[cat.primaryKey] ?? ""),
+                            value: "",
+                            target: fk.references,
+                        });
+                    }
+                    continue;
+                }
+                const value = String(raw);
+                const resolved = targetPks.has(value);
+                if (fk.external && !options.treatExternalAsInternal) {
+                    if (!resolved) {
+                        // Per spec: optimistically resolve against own rows; only log when unresolved.
+                        externalCount++;
+                        findings.add("external", `${cat.name}.${fk.column} → ${fk.references}=${value} ` +
+                            `(referencing row pk=${row[cat.primaryKey] ?? "?"}; resolves at aggregation)`);
+                    }
+                    continue;
+                }
+                if (!resolved) {
+                    failures.push({
+                        catalogue: cat.name,
+                        column: fk.column,
+                        referencingRow: String(row[cat.primaryKey] ?? ""),
+                        value,
+                        target: fk.references,
+                    });
+                }
+            }
+        }
+    }
+    return {
+        internalPass: failures.length === 0,
+        internalFailures: failures,
+        externalFindings: externalCount,
+    };
+}
+//# sourceMappingURL=fk-validator.js.map

package/dist/lib/catalogue/fk-validator.js.map

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

package/dist/lib/catalogue/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Re-exports for the catalogue builder library.
+ *
+ * Per ADR 0134 §4.6 the canonical builder is a sdd-cli subcommand; this
+ * module is its entry point. The verb file at src/verbs/catalogue.ts
+ * imports `runCatalogueBuild` from here.
+ */
+export { runCatalogueBuild } from "./build.js";
+export type { BuildInputs, BuildResult } from "./build.js";
+export { runCatalogueAggregate } from "./aggregate.js";
+export type { AggregateInputs, AggregateResult } from "./aggregate.js";
+export { runCatalogueValidate } from "./validate.js";
+export type { ValidateInputs, ValidateResult } from "./validate.js";
+export { runCatalogueVersion } from "./version.js";
+export { SCHEMA_COMPAT, formatSchemaVersionMismatch } from "./schema-compat.js";
+export type { SchemaName } from "./schema-compat.js";
+export { loadCanonicalSchema, VENDORED_SCHEMA_PATH, findCatalogue, runtimeServiceTypes, } from "./schema-loader.js";
+export type { CanonicalSchema, CatalogueDef, ColumnDef, ForeignKeyDef, EnumDef, EnumValueDef, } from "./schema-loader.js";
+export { loadSddManifest, isInRange, MANIFEST_REL_PATH, PROFILES, CATEGORIES, } from "./manifest-loader.js";
+export type { SddManifest, Profile, Category } from "./manifest-loader.js";
+export { renderCatalogueCsv, writeCatalogue } from "./csv-writer.js";
+export type { CatalogueRow } from "./csv-writer.js";
+export { validateForeignKeys } from "./fk-validator.js";
+export type { FkValidationResult, FkFailure } from "./fk-validator.js";
+export { FindingsLog } from "./findings.js";
+export type { Finding, FindingCategory } from "./findings.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/catalogue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,YAAY,EACZ,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/lib/catalogue/index.js

@@ -0,0 +1,18 @@
+/**
+ * Re-exports for the catalogue builder library.
+ *
+ * Per ADR 0134 §4.6 the canonical builder is a sdd-cli subcommand; this
+ * module is its entry point. The verb file at src/verbs/catalogue.ts
+ * imports `runCatalogueBuild` from here.
+ */
+export { runCatalogueBuild } from "./build.js";
+export { runCatalogueAggregate } from "./aggregate.js";
+export { runCatalogueValidate } from "./validate.js";
+export { runCatalogueVersion } from "./version.js";
+export { SCHEMA_COMPAT, formatSchemaVersionMismatch } from "./schema-compat.js";
+export { loadCanonicalSchema, VENDORED_SCHEMA_PATH, findCatalogue, runtimeServiceTypes, } from "./schema-loader.js";
+export { loadSddManifest, isInRange, MANIFEST_REL_PATH, PROFILES, CATEGORIES, } from "./manifest-loader.js";
+export { renderCatalogueCsv, writeCatalogue } from "./csv-writer.js";
+export { validateForeignKeys } from "./fk-validator.js";
+export { FindingsLog } from "./findings.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/catalogue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/catalogue/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EACL,eAAe,EACf,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,UAAU,GACX,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/lib/catalogue/manifest-loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Loader for the per-SDD `.sdd/sdd-manifest.yaml` per the schema at
+ * docs/method/methods/sdd-manifest-schema.yaml in sdd-method.
+ *
+ * Validates schema_version against SCHEMA_COMPAT and the
+ * profile↔category invariant from product-category-taxonomy.md.
+ */
+export declare const MANIFEST_REL_PATH = ".sdd/sdd-manifest.yaml";
+export declare const PROFILES: readonly ["platform-profile", "application-product", "integration-product", "support-repo"];
+export type Profile = (typeof PROFILES)[number];
+export declare const CATEGORIES: readonly ["platform-root", "platform-subsystem", "application-product", "integration-provider", "integration-umbrella", "support-repo"];
+export type Category = (typeof CATEGORIES)[number];
+export interface SddManifest {
+    readonly schemaVersion: string;
+    readonly sddId: string;
+    readonly profile: Profile;
+    readonly category: Category;
+    readonly domainId?: string;
+    readonly ecosystemRoot?: string;
+    readonly aggregationManifestPath?: string;
+    readonly description?: string;
+    /** Absolute path the manifest was read from (for error messages). */
+    readonly sourcePath: string;
+}
+export interface LoadManifestOptions {
+    /** sdd-cli version, used in compat-mismatch error formatting. */
+    readonly cliVersion: string;
+}
+/**
+ * Read and validate the `.sdd/sdd-manifest.yaml` at the given SDD repo root.
+ *
+ * Throws on:
+ *   - file missing
+ *   - YAML parse error
+ *   - shape violation (missing fields, bad enum value, bad slug pattern)
+ *   - profile↔category invariant violation
+ *   - schema_version outside SCHEMA_COMPAT.sdd_manifest range
+ */
+export declare function loadSddManifest(sddPath: string, options: LoadManifestOptions): Promise<SddManifest>;
+/**
+ * Caret-prefixed semver range check. Accepts X in `^1.2.3` if X.major === 1
+ * and X >= 1.2.3.
+ *
+ * Restricted to the `^X.Y.Z` shape — that's the only form SCHEMA_COMPAT uses.
+ */
+export declare function isInRange(version: string, range: string): boolean;
+//# sourceMappingURL=manifest-loader.d.ts.map

package/dist/lib/catalogue/manifest-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/manifest-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,eAAO,MAAM,iBAAiB,2BAA2B,CAAC;AAE1D,eAAO,MAAM,QAAQ,6FAKX,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,eAAO,MAAM,UAAU,yIAOb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAyBnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CA2EtB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAejE"}