@sdd-method/sdd-cli 0.10.0 → 0.11.0

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

@@ -0,0 +1,173 @@
+// Capability discoverer — emits `capabilities.csv` rows from
+// traceability YAMLs (authoritative) plus capability spec files
+// (fallback for specs not covered by a traceability).
+//
+// Per ADR 0134 and the catalogue-builder-specification §"Inputs":
+//   - Authoritative source: docs/domains/<domain>/product/<cap>.traceability.yaml
+//     declares capability.id (canonical), domain, capability_spec, runway.
+//   - Fallback: capability spec markdown files at
+//     docs/domains/<domain>/product/<cap>.md without an accompanying
+//     traceability YAML. Filename stem is used as the capability id.
+//   - When a traceability's capability.id differs from the spec file's
+//     stem, the canonical id wins; the divergence is logged as a finding.
+import { readFile, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { readdir } from "node:fs/promises";
+const DOMAINS_DIR_REL = join("docs", "domains");
+export async function buildCapabilities(inputs) {
+    const rows = [];
+    const seen = new Set();
+    const usedSpecPaths = new Set();
+    // Pass 1 — traceability-declared capabilities (authoritative).
+    for (const m of inputs.manifests) {
+        const cap = m.capability;
+        if (seen.has(cap.id)) {
+            inputs.findings.add("divergence", `${m.relPath}: capability.id="${cap.id}" already emitted by an earlier manifest`);
+            continue;
+        }
+        if (!inputs.knownDomainIds.has(cap.domain)) {
+            inputs.findings.add("orphan", `${m.relPath}: capability.domain="${cap.domain}" has no docs/domains/${cap.domain}/`);
+        }
+        const specRel = cap.capability_spec ?? "";
+        let name = titleCase(cap.id);
+        if (specRel) {
+            usedSpecPaths.add(specRel);
+            const specAbs = join(inputs.sddPath, specRel);
+            const headingName = await readSpecH1Name(specAbs);
+            if (headingName !== "") {
+                name = headingName;
+            }
+            // Log id ↔ spec stem divergence (informational).
+            const stem = stemOf(specRel);
+            if (stem !== "" && stem !== cap.id) {
+                inputs.findings.add("divergence", `${m.relPath}: capability.id="${cap.id}" differs from spec stem "${stem}"`);
+            }
+        }
+        seen.add(cap.id);
+        rows.push({
+            id: cap.id,
+            name,
+            domain_id: cap.domain,
+            tree_category: "",
+            parent_capability_id: "",
+            description: "",
+            status: cap.status ?? "active",
+            spec_path: specRel,
+            source: "capability-spec",
+            runway_classification: m.traceability.runway?.classification ?? "",
+            source_sdd_id: "",
+        });
+    }
+    // Pass 2 — capability spec files not covered by any traceability.
+    const specFiles = await collectCapabilitySpecs(inputs.sddPath);
+    for (const spec of specFiles) {
+        const relPath = relative(inputs.sddPath, spec);
+        if (usedSpecPaths.has(relPath))
+            continue;
+        if (rows.some((r) => r["spec_path"] === relPath))
+            continue;
+        const stem = stemOf(relPath);
+        if (seen.has(stem))
+            continue;
+        const domain = inferDomainFromSpec(relPath);
+        if (domain === "") {
+            inputs.findings.add("orphan", `${relPath}: cannot infer domain from path`);
+            continue;
+        }
+        if (!inputs.knownDomainIds.has(domain)) {
+            inputs.findings.add("orphan", `${relPath}: domain "${domain}" has no docs/domains/${domain}/`);
+        }
+        const heading = await readSpecH1Name(spec);
+        seen.add(stem);
+        rows.push({
+            id: stem,
+            name: heading !== "" ? heading : titleCase(stem),
+            domain_id: domain,
+            tree_category: "",
+            parent_capability_id: "",
+            description: "",
+            status: "active",
+            spec_path: relPath,
+            source: "capability-spec",
+            runway_classification: "",
+            source_sdd_id: "",
+        });
+    }
+    return rows;
+}
+async function readSpecH1Name(specAbs) {
+    try {
+        const s = await stat(specAbs);
+        if (!s.isFile())
+            return "";
+    }
+    catch {
+        return "";
+    }
+    const text = await readFile(specAbs, "utf-8");
+    for (const line of text.split(/\r?\n/)) {
+        const t = line.trim();
+        if (t === "")
+            continue;
+        if (!t.startsWith("#"))
+            return "";
+        const stripped = t
+            .replace(/^#+\s*/, "")
+            .replace(/^(Capability Specification|Spec):\s*/i, "")
+            .trim();
+        return stripped;
+    }
+    return "";
+}
+async function collectCapabilitySpecs(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 productDir = join(domainsDir, d.name, "product");
+        let entries;
+        try {
+            entries = await readdir(productDir, { 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(productDir, e.name));
+        }
+    }
+    return out;
+}
+function inferDomainFromSpec(relPath) {
+    const parts = relPath.split(sep);
+    const i = parts.indexOf("domains");
+    if (i === -1 || i + 1 >= parts.length)
+        return "";
+    return parts[i + 1] ?? "";
+}
+function stemOf(relPath) {
+    const base = relPath.split(sep).slice(-1)[0] ?? "";
+    return base.replace(/\.md$/i, "").replace(/\.traceability\.yaml$/i, "");
+}
+function titleCase(slug) {
+    return slug
+        .split("-")
+        .map((p) => (p.length === 0 ? p : p[0].toUpperCase() + p.slice(1)))
+        .join(" ");
+}
+//# sourceMappingURL=capabilities.js.map

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

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

package/dist/lib/catalogue/builders/capability-edges.d.ts

@@ -0,0 +1,27 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { TraceabilityManifest } from "../traceability-loader.js";
+export interface CapabilityEdgeInputs {
+    readonly findings: FindingsLog;
+    readonly manifests: readonly TraceabilityManifest[];
+    readonly knownCapabilityIds: ReadonlySet<string>;
+}
+export interface CapabilityServiceInputs extends CapabilityEdgeInputs {
+    readonly knownServiceIds: ReadonlySet<string>;
+}
+export interface CapabilityAdrInputs extends CapabilityEdgeInputs {
+    readonly knownAdrIds: ReadonlySet<string>;
+}
+export interface CapabilityFeatureInputs extends CapabilityEdgeInputs {
+    /** Map of feature spec relative path → feature id, for resolving runway.enables entries. */
+    readonly featureIdByPath: ReadonlyMap<string, string>;
+}
+export interface CapabilityContractInputs extends CapabilityEdgeInputs {
+    /** Map of contract spec relative path → contract id. Also accepts paths matched by suffix and basename. */
+    readonly contractIdByPath: ReadonlyMap<string, string>;
+}
+export declare function buildCapabilityService(inputs: CapabilityServiceInputs): CatalogueRow[];
+export declare function buildCapabilityAdr(inputs: CapabilityAdrInputs): CatalogueRow[];
+export declare function buildCapabilityFeature(inputs: CapabilityFeatureInputs): CatalogueRow[];
+export declare function buildCapabilityContract(inputs: CapabilityContractInputs): CatalogueRow[];
+//# sourceMappingURL=capability-edges.d.ts.map

package/dist/lib/catalogue/builders/capability-edges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-edges.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/capability-edges.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACpD,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,4FAA4F;IAC5F,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,2GAA2G;IAC3G,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,uBAAuB,GAC9B,YAAY,EAAE,CAsBhB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,mBAAmB,GAC1B,YAAY,EAAE,CAsBhB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,uBAAuB,GAC9B,YAAY,EAAE,CAoBhB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,wBAAwB,GAC/B,YAAY,EAAE,CA2BhB"}

package/dist/lib/catalogue/builders/capability-edges.js

@@ -0,0 +1,166 @@
+// Edge builders for capability_* catalogues — capability_service,
+// capability_adr, capability_feature, capability_contract.
+//
+// All four read traceability YAMLs as the authoritative source. The
+// canonical schema declares capability_id and the target column as
+// required, internal FKs — so each builder skips entries whose target
+// doesn't resolve in the known-target set passed in.
+//
+// capability_event is intentionally not built here: its source per the
+// metamodel is `## Related Events` markdown tables in capability specs,
+// which depends on a spec-formatting convention that's only partial in
+// the field. Defer to a later phase.
+import { basename, sep } from "node:path";
+export function buildCapabilityService(inputs) {
+    const rows = [];
+    const seen = new Set();
+    for (const m of inputs.manifests) {
+        const capId = m.capability.id;
+        if (!inputs.knownCapabilityIds.has(capId))
+            continue;
+        for (const entry of m.traceability.services ?? []) {
+            const sid = entry.id;
+            if (!inputs.knownServiceIds.has(sid))
+                continue;
+            const role = entry.role ?? "";
+            const id = `${capId}__${sid}__${role !== "" ? role : "related"}`;
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            rows.push({
+                id,
+                capability_id: capId,
+                service_id: sid,
+                role,
+            });
+        }
+    }
+    return rows;
+}
+export function buildCapabilityAdr(inputs) {
+    const rows = [];
+    const seen = new Set();
+    for (const m of inputs.manifests) {
+        const capId = m.capability.id;
+        if (!inputs.knownCapabilityIds.has(capId))
+            continue;
+        for (const entry of m.traceability.adrs ?? []) {
+            const adrId = canonicaliseAdrId(entry.id);
+            if (adrId === "")
+                continue;
+            if (!inputs.knownAdrIds.has(adrId))
+                continue;
+            const id = `${capId}__${adrId}`;
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            rows.push({
+                id,
+                capability_id: capId,
+                adr_id: adrId,
+                confidence: "spec",
+            });
+        }
+    }
+    return rows;
+}
+export function buildCapabilityFeature(inputs) {
+    const rows = [];
+    const seen = new Set();
+    for (const m of inputs.manifests) {
+        const capId = m.capability.id;
+        if (!inputs.knownCapabilityIds.has(capId))
+            continue;
+        for (const path of m.traceability.runway?.enables ?? []) {
+            const featureId = resolveFeaturePath(path, inputs.featureIdByPath);
+            if (featureId === "")
+                continue;
+            const id = `${capId}__${featureId}`;
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            rows.push({
+                id,
+                capability_id: capId,
+                feature_id: featureId,
+            });
+        }
+    }
+    return rows;
+}
+export function buildCapabilityContract(inputs) {
+    const rows = [];
+    const seen = new Set();
+    for (const m of inputs.manifests) {
+        const capId = m.capability.id;
+        if (!inputs.knownCapabilityIds.has(capId))
+            continue;
+        const block = m.traceability.contracts;
+        if (!block)
+            continue;
+        const all = [];
+        for (const list of [block.openapi, block.proto, block.avro]) {
+            if (Array.isArray(list))
+                all.push(...list);
+        }
+        for (const path of all) {
+            const contractId = resolveContractPath(path, inputs.contractIdByPath);
+            if (contractId === "")
+                continue;
+            const id = `${capId}__${contractId}`;
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            rows.push({
+                id,
+                capability_id: capId,
+                contract_id: contractId,
+                source: "declared",
+            });
+        }
+    }
+    return rows;
+}
+// ─── helpers ────────────────────────────────────────────────────────────
+/**
+ * Normalise an ADR ID from a traceability entry. Accepts bare numerics
+ * (`"0037"`, `"0058"`) and full forms (`"ADR-0037"`, `"ADR 0037"`); emits
+ * `ADR-XXXX` (4-digit zero-padded) which is the canonical adrs.id form.
+ */
+function canonicaliseAdrId(raw) {
+    const m = /^(?:ADR[-\s]+)?(\d+)/i.exec(raw);
+    if (!m || m[1] === undefined)
+        return "";
+    const num = parseInt(m[1], 10);
+    if (!Number.isFinite(num))
+        return "";
+    return `ADR-${String(num).padStart(4, "0")}`;
+}
+function resolveFeaturePath(path, index) {
+    const cleaned = path.replace(/^\/+/, "");
+    return index.get(cleaned) ?? "";
+}
+function resolveContractPath(path, index) {
+    const cleaned = path.replace(/^\/+/, "");
+    // Try exact path, then suffix matches.
+    const direct = index.get(cleaned);
+    if (direct !== undefined)
+        return direct;
+    // Suffix: last two parts (e.g. "asset/asset-twin.yaml")
+    const parts = cleaned.split(sep);
+    if (parts.length >= 2) {
+        const suffix = parts.slice(-2).join("/");
+        for (const [k, v] of index) {
+            if (k.endsWith(suffix))
+                return v;
+        }
+    }
+    // Basename fallback
+    const base = basename(cleaned);
+    for (const [k, v] of index) {
+        if (basename(k) === base)
+            return v;
+    }
+    return "";
+}
+//# sourceMappingURL=capability-edges.js.map

package/dist/lib/catalogue/builders/capability-edges.js.map

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

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

@@ -0,0 +1,15 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+export interface ContractsBuildInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    /** repository ids known to this build, for source_repo_id resolution. */
+    readonly knownRepositoryIds: ReadonlySet<string>;
+}
+export interface ContractsBuildResult {
+    readonly rows: CatalogueRow[];
+    /** Map of contract spec relative path → contract id, for capability_contract resolution. */
+    readonly idByPath: ReadonlyMap<string, string>;
+}
+export declare function buildContracts(inputs: ContractsBuildInputs): Promise<ContractsBuildResult>;
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/contracts.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAgBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAyD/B"}

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

@@ -0,0 +1,153 @@
+// Contracts discoverer — emits `contracts.csv` rows from
+// `contracts/{openapi,proto,avro}/<domain>/<name>.<ext>`.
+//
+// Per the canonical schema (catalogue-schema.yaml):
+//   - kind enum: rest | graphql | rpc | event
+//     - openapi/*.yaml → rest
+//     - proto/*.proto  → rpc
+//     - avro/*.avsc    → event
+//   - service_id and source_repo_id are nullable; per ADR 0110 the real
+//     contract sources may live in sibling contracts-* repos. The
+//     canonical builder leaves these empty by default; an OpenAPI
+//     `x-source-repo` extension is honoured as a hint when present
+//     (resolved against the known repository set).
+//   - For OpenAPI files only, `info.title` becomes `description`,
+//     `info.version` becomes `version`. Other formats keep these empty.
+import { readdir, readFile } from "node:fs/promises";
+import { extname, join, relative, sep } from "node:path";
+import { parse as parseYaml } from "yaml";
+const CONTRACTS_DIR_REL = "contracts";
+const KIND_SPECS = [
+    { subdir: "openapi", extensions: [".yaml", ".yml"], kind: "rest" },
+    { subdir: "proto", extensions: [".proto"], kind: "rpc" },
+    { subdir: "avro", extensions: [".avsc"], kind: "event" },
+];
+export async function buildContracts(inputs) {
+    const rows = [];
+    const idByPath = new Map();
+    const seen = new Set();
+    for (const spec of KIND_SPECS) {
+        const dir = join(inputs.sddPath, CONTRACTS_DIR_REL, spec.subdir);
+        const files = await collectFiles(dir, spec.extensions);
+        for (const path of files.sort()) {
+            const filename = basenameOf(path);
+            // Skip schema/config files at any depth.
+            if (filename === "schema.yaml" || filename === "schema.yml")
+                continue;
+            const rel = relative(inputs.sddPath, path);
+            const stem = stemOf(filename);
+            const domain = domainSegment(rel);
+            const slug = domain !== ""
+                ? slugify(`${domain}-${stem}`)
+                : slugify(stem);
+            if (seen.has(slug)) {
+                inputs.findings.add("divergence", `${rel}: contract id "${slug}" already emitted by an earlier file`);
+                continue;
+            }
+            seen.add(slug);
+            let description = "";
+            let version = "";
+            let sourceRepoId = "";
+            if (spec.kind === "rest") {
+                const meta = await tryReadOpenapiInfo(path);
+                description = meta.description;
+                version = meta.version;
+                if (meta.xSourceRepo !== "" && inputs.knownRepositoryIds.has(meta.xSourceRepo)) {
+                    sourceRepoId = meta.xSourceRepo;
+                }
+            }
+            rows.push({
+                id: slug,
+                name: stem,
+                service_id: "",
+                source_repo_id: sourceRepoId,
+                kind: spec.kind,
+                version,
+                status: "active",
+                spec_path: rel,
+                visibility: "internal",
+                description,
+                source_sdd_id: "",
+            });
+            idByPath.set(rel, slug);
+        }
+    }
+    return { rows, idByPath };
+}
+async function tryReadOpenapiInfo(path) {
+    try {
+        const text = await readFile(path, "utf-8");
+        const raw = parseYaml(text);
+        if (!raw || typeof raw !== "object") {
+            return { description: "", version: "", xSourceRepo: "" };
+        }
+        const info = raw["info"];
+        const xSourceRepo = String(raw["x-source-repo"] ?? "").trim();
+        const versionRaw = info?.["version"];
+        const descRaw = info?.["description"];
+        const description = typeof descRaw === "string"
+            ? firstSentence(descRaw)
+            : "";
+        const version = typeof versionRaw === "string"
+            ? versionRaw
+            : versionRaw !== undefined
+                ? String(versionRaw)
+                : "";
+        return { description, version, xSourceRepo };
+    }
+    catch {
+        // Not all *.yaml files in contracts/openapi/ are full specs (some are
+        // shared component fragments). Failing to parse is not an error here.
+        return { description: "", version: "", xSourceRepo: "" };
+    }
+}
+function firstSentence(s) {
+    // Take up to the first paragraph break, capped at 500 chars.
+    const para = s.split(/\r?\n\r?\n/)[0] ?? "";
+    return para.replace(/\s+/g, " ").trim().slice(0, 500);
+}
+async function collectFiles(dir, extensions) {
+    const out = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return [];
+        throw err;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...(await collectFiles(full, extensions)));
+        }
+        else if (entry.isFile() && extensions.includes(extname(entry.name).toLowerCase())) {
+            out.push(full);
+        }
+    }
+    return out;
+}
+function basenameOf(absPath) {
+    return absPath.split(sep).slice(-1)[0] ?? "";
+}
+function stemOf(filename) {
+    return filename.replace(/\.[^.]+$/, "");
+}
+function domainSegment(relPath) {
+    // Layout: contracts/<subdir>/<domain>/<file>.<ext>
+    // → parts = ["contracts", subdir, domain, file]
+    const parts = relPath.split(sep);
+    if (parts.length < 4)
+        return "";
+    return parts[2] ?? "";
+}
+function slugify(s) {
+    return s
+        .toLowerCase()
+        .replace(/^_+/, "") // turn _common into common
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+//# sourceMappingURL=contracts.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { SddManifest } from "../manifest-loader.js";
+export interface DomainsBuildInputs {
+    readonly sddPath: string;
+    readonly manifest: SddManifest;
+    readonly findings: FindingsLog;
+}
+export declare function buildDomains(inputs: DomainsBuildInputs): Promise<CatalogueRow[]>;
+//# sourceMappingURL=domains.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/domains.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC;AAID,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAwCzB"}