@sdd-method/sdd-cli 0.10.0 → 0.11.0

package/dist/lib/catalogue/builders/features.js

@@ -0,0 +1,206 @@
+// Features discoverer — emits `features.csv` rows from feature spec files
+// under `docs/domains/<domain>/product/features/<folder>/*.md`.
+//
+// Folder→capability mapping uses two sources, in order:
+//   1. Traceability manifest's `capability.feature_directory` field —
+//      authoritative when a capability spec uses a folder name that
+//      differs from the canonical capability_id (e.g. capability_id
+//      "alerts-rules-engine" with feature_directory pointing at
+//      "features/alerts-rules/").
+//   2. Folder name itself, when it equals a known capability_id.
+//
+// id format: `{capability_id}-{feature-slug}` (matching the python
+// builder convention).
+//
+// name: feature slug; description: feature spec H1 title.
+import { readdir, readFile } from "node:fs/promises";
+import { basename, join, relative, sep } from "node:path";
+const DOMAINS_DIR_REL = join("docs", "domains");
+export async function buildFeatures(inputs) {
+    // Build folder→capability_id map from traceability feature_directory.
+    const folderToCap = new Map();
+    for (const m of inputs.manifests) {
+        const featDir = m.capability.feature_directory;
+        if (!featDir)
+            continue;
+        if (!inputs.knownCapabilityIds.has(m.capability.id))
+            continue;
+        const folder = basename(featDir.replace(/\/+$/, ""));
+        folderToCap.set(folder, m.capability.id);
+    }
+    const featurePaths = await collectFeatureSpecs(inputs.sddPath);
+    const rows = [];
+    const idByPath = new Map();
+    const idBySlug = new Map();
+    const seen = new Set();
+    for (const path of featurePaths) {
+        const relPath = relative(inputs.sddPath, path);
+        const folder = parentFolder(relPath);
+        const capId = folderToCap.get(folder)
+            ?? (inputs.knownCapabilityIds.has(folder) ? folder : "");
+        if (capId === "") {
+            inputs.findings.add("orphan", `${relPath}: feature folder "${folder}" has no matching capability (no traceability feature_directory + folder is not a capability id)`);
+            continue;
+        }
+        const stem = basename(relPath).replace(/\.md$/i, "");
+        const id = `${capId}-${stem}`;
+        if (seen.has(id)) {
+            inputs.findings.add("divergence", `${relPath}: feature id "${id}" already emitted by an earlier file`);
+            continue;
+        }
+        seen.add(id);
+        const text = await readFile(path, "utf-8");
+        const description = extractH1Title(text);
+        rows.push({
+            id,
+            name: stem,
+            product_id: "",
+            capability_id: capId,
+            parent_group_id: "",
+            parent_feature_id: "",
+            description,
+            maturity: "",
+            status: "active",
+            source: "feature-spec",
+            source_sdd_id: "",
+        });
+        idByPath.set(relPath, id);
+        if (!idBySlug.has(stem))
+            idBySlug.set(stem, id);
+    }
+    // App-product profile: also walk `features/<group>/<file>.md` at SDD root.
+    // These features are owned by the SDD's product (not by a capability) —
+    // capability_id is left empty; product_id carries the link.
+    if (inputs.profile === "application-product") {
+        const appFeatures = await collectAppFeatureSpecs(inputs.sddPath);
+        for (const path of appFeatures) {
+            const relPath = relative(inputs.sddPath, path);
+            const stem = basename(relPath).replace(/\.md$/i, "");
+            const id = `${inputs.productId}-${stem}`;
+            if (seen.has(id)) {
+                inputs.findings.add("divergence", `${relPath}: feature id "${id}" already emitted by an earlier file`);
+                continue;
+            }
+            seen.add(id);
+            const text = await readFile(path, "utf-8");
+            const description = extractH1Title(text);
+            rows.push({
+                id,
+                name: stem,
+                product_id: inputs.productId,
+                capability_id: "",
+                parent_group_id: "",
+                parent_feature_id: "",
+                description,
+                maturity: "",
+                status: "active",
+                source: "feature-spec",
+                source_sdd_id: "",
+            });
+            idByPath.set(relPath, id);
+            if (!idBySlug.has(stem))
+                idBySlug.set(stem, id);
+        }
+    }
+    return { rows, idByPath, idBySlug };
+}
+const FEATURES_DIR_REL = "features";
+async function collectAppFeatureSpecs(sddPath) {
+    const out = [];
+    const featuresDir = join(sddPath, FEATURES_DIR_REL);
+    let groups;
+    try {
+        groups = await readdir(featuresDir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const g of groups) {
+        if (!g.isDirectory())
+            continue;
+        const groupDir = join(featuresDir, g.name);
+        let entries;
+        try {
+            entries = await readdir(groupDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            if (!e.isFile())
+                continue;
+            if (!e.name.endsWith(".md"))
+                continue;
+            const lower = e.name.toLowerCase();
+            if (lower === "readme.md" || lower === "index.md")
+                continue;
+            out.push(join(groupDir, e.name));
+        }
+    }
+    return out.sort();
+}
+async function collectFeatureSpecs(sddPath) {
+    const out = [];
+    const domainsDir = join(sddPath, DOMAINS_DIR_REL);
+    let domains;
+    try {
+        domains = await readdir(domainsDir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const d of domains) {
+        if (!d.isDirectory())
+            continue;
+        const featuresDir = join(domainsDir, d.name, "product", "features");
+        let folders;
+        try {
+            folders = await readdir(featuresDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const f of folders) {
+            if (!f.isDirectory())
+                continue;
+            const folderPath = join(featuresDir, f.name);
+            let entries;
+            try {
+                entries = await readdir(folderPath, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const e of entries) {
+                if (!e.isFile())
+                    continue;
+                if (!e.name.endsWith(".md"))
+                    continue;
+                const lower = e.name.toLowerCase();
+                if (lower === "readme.md" || lower === "index.md")
+                    continue;
+                out.push(join(folderPath, e.name));
+            }
+        }
+    }
+    return out.sort();
+}
+function parentFolder(relPath) {
+    const parts = relPath.split(sep);
+    return parts[parts.length - 2] ?? "";
+}
+function extractH1Title(text) {
+    for (const line of text.split(/\r?\n/)) {
+        const t = line.trim();
+        if (t === "")
+            continue;
+        if (!t.startsWith("#"))
+            return "";
+        return t
+            .replace(/^#+\s*/, "")
+            .replace(/^(Feature Specification|Spec):\s*/i, "")
+            .trim();
+    }
+    return "";
+}
+//# sourceMappingURL=features.js.map

package/dist/lib/catalogue/builders/features.js.map

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

package/dist/lib/catalogue/builders/glossary-xref.d.ts

@@ -0,0 +1,11 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+export interface GlossaryXrefInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    /** From the glossary builder: `<domain>:<term>` (lower-case term) → glossary_items.id. */
+    readonly idByDomainTerm: ReadonlyMap<string, string>;
+    readonly knownGlossaryIds: ReadonlySet<string>;
+}
+export declare function buildGlossaryXref(inputs: GlossaryXrefInputs): Promise<CatalogueRow[]>;
+//# sourceMappingURL=glossary-xref.d.ts.map

package/dist/lib/catalogue/builders/glossary-xref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary-xref.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/glossary-xref.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,0FAA0F;IAC1F,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAChD;AASD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAqEzB"}

package/dist/lib/catalogue/builders/glossary-xref.js

@@ -0,0 +1,107 @@
+// glossary_xref edge builder — emits cross-domain glossary
+// relationships from `docs/platform/reference/glossary-alignment-manifest.yaml`.
+//
+// Expected manifest shape (canonical):
+//
+//   aliases:
+//     - source: <source-domain>:<term>
+//       target: <target-domain>:<term>
+//   conflicts:
+//     - source: <source-domain>:<term>
+//       target: <target-domain>:<term>
+//
+// Or the per-entry shape with `source_id`/`target_id` fields directly.
+//
+// Adopters whose alignment manifest is in a different shape (e.g.
+// data-dictionary alignment rather than cross-domain term aliasing)
+// will simply produce zero rows. This builder logs a `convention`
+// finding when a manifest exists but no expected blocks are present.
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+const MANIFEST_REL_PATH = join("docs", "platform", "reference", "glossary-alignment-manifest.yaml");
+export async function buildGlossaryXref(inputs) {
+    const path = join(inputs.sddPath, MANIFEST_REL_PATH);
+    let text;
+    try {
+        text = await readFile(path, "utf-8");
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return [];
+        throw err;
+    }
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (err) {
+        inputs.findings.add("convention", `${MANIFEST_REL_PATH}: failed to parse YAML — ${err.message}`);
+        return [];
+    }
+    if (!raw || typeof raw !== "object")
+        return [];
+    const obj = raw;
+    const aliases = collectPairs(obj["aliases"]);
+    const conflicts = collectPairs(obj["conflicts_with"] ?? obj["conflicts"]);
+    if (aliases.length === 0 && conflicts.length === 0) {
+        inputs.findings.add("convention", `${MANIFEST_REL_PATH}: present but no aliases/conflicts blocks recognised — emitting 0 xref rows`);
+        return [];
+    }
+    const rows = [];
+    const seen = new Set();
+    const emit = (rawSource, rawTarget, relation) => {
+        const sourceId = resolveTerm(rawSource, inputs);
+        const targetId = resolveTerm(rawTarget, inputs);
+        if (sourceId === undefined) {
+            inputs.findings.add("orphan", `${MANIFEST_REL_PATH}: ${relation} source "${rawSource}" doesn't resolve to a known glossary item`);
+            return;
+        }
+        if (targetId === undefined) {
+            inputs.findings.add("orphan", `${MANIFEST_REL_PATH}: ${relation} target "${rawTarget}" doesn't resolve to a known glossary item`);
+            return;
+        }
+        if (sourceId === targetId)
+            return; // self-reference is meaningless
+        const id = `${sourceId}__${relation}__${targetId}`;
+        if (seen.has(id))
+            return;
+        seen.add(id);
+        rows.push({ id, source_id: sourceId, target_id: targetId, relation });
+    };
+    for (const { source, target } of aliases)
+        emit(source, target, "alias-of");
+    for (const { source, target } of conflicts)
+        emit(source, target, "conflicts-with");
+    return rows;
+}
+function collectPairs(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const o = item;
+        const source = String(o["source"] ?? o["source_id"] ?? "").trim();
+        const target = String(o["target"] ?? o["target_id"] ?? "").trim();
+        if (source !== "" && target !== "")
+            out.push({ source, target });
+    }
+    return out;
+}
+function resolveTerm(raw, inputs) {
+    // Direct id (e.g. "asset-vehicle")
+    if (inputs.knownGlossaryIds.has(raw))
+        return raw;
+    // domain:term lookup
+    const colonIdx = raw.indexOf(":");
+    if (colonIdx > 0) {
+        const domain = raw.slice(0, colonIdx).trim().toLowerCase();
+        const term = raw.slice(colonIdx + 1).trim().toLowerCase();
+        return inputs.idByDomainTerm.get(`${domain}:${term}`);
+    }
+    return undefined;
+}
+//# sourceMappingURL=glossary-xref.js.map

package/dist/lib/catalogue/builders/glossary-xref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary-xref.js","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/glossary-xref.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,iFAAiF;AACjF,EAAE;AACF,uCAAuC;AACvC,EAAE;AACF,aAAa;AACb,uCAAuC;AACvC,uCAAuC;AACvC,eAAe;AACf,uCAAuC;AACvC,uCAAuC;AACvC,EAAE;AACF,uEAAuE;AACvE,EAAE;AACF,kEAAkE;AAClE,oEAAoE;AACpE,kEAAkE;AAClE,qEAAqE;AAErE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAY1C,MAAM,iBAAiB,GAAG,IAAI,CAC5B,MAAM,EACN,UAAU,EACV,WAAW,EACX,kCAAkC,CACnC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACrD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACjC,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,QAAQ,CAAC,GAAG,CACjB,YAAY,EACZ,GAAG,iBAAiB,4BAA6B,GAAa,CAAC,OAAO,EAAE,CACzE,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,GAAG,CACjB,YAAY,EACZ,GAAG,iBAAiB,6EAA6E,CAClG,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,IAAI,GAAG,CACX,SAAiB,EACjB,SAAiB,EACjB,QAAuC,EACjC,EAAE;QACR,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,QAAQ,CAAC,GAAG,CACjB,QAAQ,EACR,GAAG,iBAAiB,KAAK,QAAQ,YAAY,SAAS,4CAA4C,CACnG,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,QAAQ,CAAC,GAAG,CACjB,QAAQ,EACR,GAAG,iBAAiB,KAAK,QAAQ,YAAY,SAAS,4CAA4C,CACnG,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,KAAK,QAAQ;YAAE,OAAO,CAAC,gCAAgC;QACnE,MAAM,EAAE,GAAG,GAAG,QAAQ,KAAK,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACnD,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO;QACzB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC;IAEF,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,OAAO;QAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3E,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAS;QAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAEnF,OAAO,IAAI,CAAC;AACd,CAAC;AAOD,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QAChD,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,MAA0B;IAC1D,mCAAmC;IACnC,IAAI,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACjD,qBAAqB;IACrB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/catalogue/builders/glossary.d.ts

@@ -0,0 +1,14 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+export interface GlossaryItemsBuildInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    readonly knownDomainIds: ReadonlySet<string>;
+}
+export interface GlossaryItemsResult {
+    readonly rows: CatalogueRow[];
+    /** Map of `<domain>:<term>` (case-insensitive) → item id, used by xref resolution. */
+    readonly idByDomainTerm: ReadonlyMap<string, string>;
+}
+export declare function buildGlossaryItems(inputs: GlossaryItemsBuildInputs): Promise<GlossaryItemsResult>;
+//# sourceMappingURL=glossary.d.ts.map

package/dist/lib/catalogue/builders/glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/glossary.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtD;AAKD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CA+C9B"}

package/dist/lib/catalogue/builders/glossary.js

@@ -0,0 +1,150 @@
+// Glossary discoverer — emits `glossary_items.csv` rows from
+// `docs/domains/<domain>/architecture/glossary.md` "## Owned Terms"
+// tables.
+//
+// Convention (per the catalogue-metamodel.md + contextua-platform's
+// existing layout):
+//   ## Owned Terms
+//
+//   | Term | Definition | Notes |
+//   |------|------------|-------|
+//   | <term> | <definition> | <optional notes> |
+//
+// Borrowed terms and deprecated-terms tables are intentionally NOT
+// emitted — borrowed terms reference a canonical entry in another
+// domain (which is already captured by that domain's Owned Terms),
+// and deprecated terms are migration noise.
+//
+// Item id: `<domain>-<slug>` so terms in different domains can reuse
+// the same word without collision.
+import { readdir, readFile } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+const DOMAINS_DIR_REL = join("docs", "domains");
+const SECTION_HEADING_RE = /^##\s+(Owned|Borrowed|Deprecated)\s+Terms?\s*$/i;
+export async function buildGlossaryItems(inputs) {
+    const rows = [];
+    const idByDomainTerm = new Map();
+    const seen = new Set();
+    const glossaryFiles = await collectGlossaryFiles(inputs.sddPath);
+    for (const path of glossaryFiles) {
+        const relPath = relative(inputs.sddPath, path);
+        const domain = inferDomainFromPath(relPath);
+        if (domain === "")
+            continue;
+        if (!inputs.knownDomainIds.has(domain)) {
+            inputs.findings.add("orphan", `${relPath}: glossary path implies domain "${domain}" but no docs/domains/${domain}/ exists`);
+            continue;
+        }
+        const text = await readFile(path, "utf-8");
+        const ownedTerms = extractOwnedTerms(text);
+        for (const { term, definition, notes } of ownedTerms) {
+            const slug = slugify(term);
+            if (slug === "")
+                continue;
+            const id = `${domain}-${slug}`;
+            if (seen.has(id)) {
+                inputs.findings.add("divergence", `${relPath}: glossary item "${id}" already emitted (term="${term}")`);
+                continue;
+            }
+            seen.add(id);
+            rows.push({
+                id,
+                term,
+                definition,
+                owning_domain_id: domain,
+                canonical_term_id: "",
+                aliases: "",
+                evidence: "",
+                notes,
+                source_sdd_id: "",
+            });
+            idByDomainTerm.set(`${domain}:${term.toLowerCase()}`, id);
+        }
+    }
+    return { rows, idByDomainTerm };
+}
+function extractOwnedTerms(text) {
+    const out = [];
+    let inOwnedSection = false;
+    let sawHeader = false;
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trimEnd();
+        const heading = SECTION_HEADING_RE.exec(line.trim());
+        if (heading) {
+            inOwnedSection = (heading[1] ?? "").toLowerCase() === "owned";
+            sawHeader = false;
+            continue;
+        }
+        if (!inOwnedSection)
+            continue;
+        // Header row: `| Term | Definition | ... |`
+        if (/^\s*\|\s*Term\b/i.test(line)) {
+            sawHeader = true;
+            continue;
+        }
+        // Separator row: `|---|---|...`
+        if (/^\s*\|[\s-:|]+\|\s*$/.test(line))
+            continue;
+        if (!sawHeader)
+            continue;
+        if (!line.trim().startsWith("|"))
+            continue;
+        const cells = splitTableRow(line);
+        if (cells.length < 2 || cells[0] === "")
+            continue;
+        out.push({
+            term: cells[0] ?? "",
+            definition: cells[1] ?? "",
+            notes: cells[2] ?? "",
+        });
+    }
+    return out;
+}
+function splitTableRow(line) {
+    // Trim outer pipes, split on |, strip cells. Doesn't try to handle
+    // escaped pipes — adopter convention says: avoid raw | in cells, use
+    // "or" instead. We honour that.
+    const trimmed = line.trim().replace(/^\|/, "").replace(/\|$/, "");
+    return trimmed.split("|").map((c) => c.trim());
+}
+async function collectGlossaryFiles(sddPath) {
+    const out = [];
+    const domainsDir = join(sddPath, DOMAINS_DIR_REL);
+    let domains;
+    try {
+        domains = await readdir(domainsDir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const d of domains) {
+        if (!d.isDirectory())
+            continue;
+        const path = join(domainsDir, d.name, "architecture", "glossary.md");
+        try {
+            await readFile(path, "utf-8");
+            out.push(path);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== "ENOENT")
+                throw err;
+        }
+    }
+    return out.sort();
+}
+function inferDomainFromPath(relPath) {
+    const parts = relPath.split(sep);
+    const idx = parts.indexOf("domains");
+    if (idx === -1 || idx + 1 >= parts.length)
+        return "";
+    return parts[idx + 1] ?? "";
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/&/g, " and ")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=glossary.js.map

package/dist/lib/catalogue/builders/glossary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/glossary.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,oEAAoE;AACpE,UAAU;AACV,EAAE;AACF,oEAAoE;AACpE,oBAAoB;AACpB,mBAAmB;AACnB,EAAE;AACF,kCAAkC;AAClC,kCAAkC;AAClC,iDAAiD;AACjD,EAAE;AACF,mEAAmE;AACnE,kEAAkE;AAClE,mEAAmE;AACnE,4CAA4C;AAC5C,EAAE;AACF,qEAAqE;AACrE,mCAAmC;AAEnC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAgBhD,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAChD,MAAM,kBAAkB,GAAG,iDAAiD,CAAC;AAE7E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAgC;IAEhC,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,EAAE;YAAE,SAAS;QAC5B,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,QAAQ,CAAC,GAAG,CACjB,QAAQ,EACR,GAAG,OAAO,mCAAmC,MAAM,yBAAyB,MAAM,UAAU,CAC7F,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,IAAI,KAAK,EAAE;gBAAE,SAAS;YAC1B,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,MAAM,CAAC,QAAQ,CAAC,GAAG,CACjB,YAAY,EACZ,GAAG,OAAO,oBAAoB,EAAE,4BAA4B,IAAI,IAAI,CACrE,CAAC;gBACF,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,IAAI,CAAC;gBACR,EAAE;gBACF,IAAI;gBACJ,UAAU;gBACV,gBAAgB,EAAE,MAAM;gBACxB,iBAAiB,EAAE,EAAE;gBACrB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE;gBACZ,KAAK;gBACL,aAAa,EAAE,EAAE;aAClB,CAAC,CAAC;YACH,cAAc,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;AAClC,CAAC;AAQD,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,OAAO,EAAE,CAAC;YACZ,cAAc,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC;YAC9D,SAAS,GAAG,KAAK,CAAC;YAClB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,cAAc;YAAE,SAAS;QAC9B,4CAA4C;QAC5C,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS;QACX,CAAC;QACD,gCAAgC;QAChC,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAChD,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE;YAAE,SAAS;QAClD,GAAG,CAAC,IAAI,CAAC;YACP,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YACpB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;YAC1B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,mEAAmE;IACnE,qEAAqE;IACrE,gCAAgC;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAClE,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,OAAe;IACjD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,SAAS;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;YACjD,IAAI,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACrD,OAAO,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,57 @@
+/**
+ * Re-exports for the per-source row discoverers used by the canonical
+ * `sdd-cli catalogue build` orchestrator.
+ *
+ * Each builder is responsible for exactly one node catalogue (or a small
+ * tightly-coupled group when reading the same source). The orchestrator
+ * in build.ts composes them with a deterministic order.
+ */
+export { buildDomains } from "./domains.js";
+export type { DomainsBuildInputs } from "./domains.js";
+export { buildProducts } from "./products.js";
+export type { ProductsBuildInputs } from "./products.js";
+export { buildRepositories } from "./repositories.js";
+export type { RepositoriesBuildInputs, RepositoriesBuildResult, ParsedRepoConfig, } from "./repositories.js";
+export { buildServices } from "./services.js";
+export type { ServicesBuildInputs } from "./services.js";
+export { buildAdrs } from "./adrs.js";
+export type { AdrsBuildInputs, ParsedAdr } from "./adrs.js";
+export { buildAdrSupersedes } from "./adr-supersedes.js";
+export type { AdrSupersedesInputs, AdrSupersedesResult, } from "./adr-supersedes.js";
+export { buildFeatures } from "./features.js";
+export type { FeaturesBuildInputs, FeaturesBuildResult, } from "./features.js";
+export { buildFeatureGroups } from "./feature-groups.js";
+export type { FeatureGroupsBuildInputs } from "./feature-groups.js";
+export { buildContracts } from "./contracts.js";
+export type { ContractsBuildInputs, ContractsBuildResult, } from "./contracts.js";
+export { buildRepoEdges } from "./repo-edges.js";
+export type { RepoEdgesInputs, RepoEdgesResult, } from "./repo-edges.js";
+export { buildEvents } from "./events.js";
+export type { EventsBuildInputs, EventsBuildResult, PublisherIndex, } from "./events.js";
+export { buildServiceEvent, buildCapabilityEvent } from "./event-edges.js";
+export type { ServiceEventInputs, CapabilityEventInputs, } from "./event-edges.js";
+export { buildServiceContract } from "./service-contract.js";
+export type { ServiceContractInputs } from "./service-contract.js";
+export { buildGlossaryItems } from "./glossary.js";
+export type { GlossaryItemsBuildInputs, GlossaryItemsResult, } from "./glossary.js";
+export { buildGlossaryXref } from "./glossary-xref.js";
+export type { GlossaryXrefInputs } from "./glossary-xref.js";
+export { buildCapabilities } from "./capabilities.js";
+export type { CapabilitiesBuildInputs } from "./capabilities.js";
+export { buildC4Systems } from "./c4-systems.js";
+export type { C4SystemsBuildInputs } from "./c4-systems.js";
+export { buildC4Containers } from "./c4-containers.js";
+export type { C4ContainersBuildInputs } from "./c4-containers.js";
+export { buildPersonas } from "./personas.js";
+export type { PersonasBuildInputs, PersonasBuildResult, } from "./personas.js";
+export { buildUserJourneys } from "./user-journeys.js";
+export type { UserJourneysBuildInputs, UserJourneysBuildResult, } from "./user-journeys.js";
+export { buildPersonaJourney, buildPersonaFeature, buildJourneyFeature, } from "./persona-journey-edges.js";
+export type { PersonaJourneyEdgeInputs, PersonaFeatureEdgeInputs, JourneyFeatureEdgeInputs, } from "./persona-journey-edges.js";
+export { buildProductEdges } from "./product-edges.js";
+export type { ProductEdgesInputs, ProductEdgesResult, } from "./product-edges.js";
+export { buildIntegrations } from "./integrations.js";
+export type { IntegrationsBuildInputs } from "./integrations.js";
+export { buildCapabilityService, buildCapabilityAdr, buildCapabilityFeature, buildCapabilityContract, } from "./capability-edges.js";
+export type { CapabilityServiceInputs, CapabilityAdrInputs, CapabilityFeatureInputs, CapabilityContractInputs, } from "./capability-edges.js";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * Re-exports for the per-source row discoverers used by the canonical
+ * `sdd-cli catalogue build` orchestrator.
+ *
+ * Each builder is responsible for exactly one node catalogue (or a small
+ * tightly-coupled group when reading the same source). The orchestrator
+ * in build.ts composes them with a deterministic order.
+ */
+export { buildDomains } from "./domains.js";
+export { buildProducts } from "./products.js";
+export { buildRepositories } from "./repositories.js";
+export { buildServices } from "./services.js";
+export { buildAdrs } from "./adrs.js";
+export { buildAdrSupersedes } from "./adr-supersedes.js";
+export { buildFeatures } from "./features.js";
+export { buildFeatureGroups } from "./feature-groups.js";
+export { buildContracts } from "./contracts.js";
+export { buildRepoEdges } from "./repo-edges.js";
+export { buildEvents } from "./events.js";
+export { buildServiceEvent, buildCapabilityEvent } from "./event-edges.js";
+export { buildServiceContract } from "./service-contract.js";
+export { buildGlossaryItems } from "./glossary.js";
+export { buildGlossaryXref } from "./glossary-xref.js";
+export { buildCapabilities } from "./capabilities.js";
+export { buildC4Systems } from "./c4-systems.js";
+export { buildC4Containers } from "./c4-containers.js";
+export { buildPersonas } from "./personas.js";
+export { buildUserJourneys } from "./user-journeys.js";
+export { buildPersonaJourney, buildPersonaFeature, buildJourneyFeature, } from "./persona-journey-edges.js";
+export { buildProductEdges } from "./product-edges.js";
+export { buildIntegrations } from "./integrations.js";
+export { buildCapabilityService, buildCapabilityAdr, buildCapabilityFeature, buildCapabilityContract, } from "./capability-edges.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAMtD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAKzD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKhD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKjD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM1C,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAK3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAKnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAKvD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAKvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC"}

package/dist/lib/catalogue/builders/integrations.d.ts

@@ -0,0 +1,12 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { Profile } from "../manifest-loader.js";
+export interface IntegrationsBuildInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    readonly profile: Profile;
+    readonly sddId: string;
+    readonly repoCount: number;
+}
+export declare function buildIntegrations(inputs: IntegrationsBuildInputs): Promise<CatalogueRow[]>;
+//# sourceMappingURL=integrations.d.ts.map