@sdd-method/sdd-cli 0.9.0 → 0.11.0

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

@@ -0,0 +1,93 @@
+// Domain discoverer — emits `domains.csv` rows from `docs/domains/<slug>/`.
+//
+// Per ADR 0134 and catalogue-builder-specification.md:
+//   - Domains are method-defined: each subdirectory under docs/domains/
+//     is one domain, named by its slug.
+//   - method_profile reflects the SDD's profile (the domain belongs to
+//     this SDD's method profile).
+//   - repo_count is computed by the build orchestrator after repositories
+//     are discovered, since this builder runs first.
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+const DOMAINS_DIR_REL = join("docs", "domains");
+export async function buildDomains(inputs) {
+    const domainsDir = join(inputs.sddPath, DOMAINS_DIR_REL);
+    let entries;
+    try {
+        entries = (await readdir(domainsDir, { withFileTypes: true }))
+            .filter((e) => e.isDirectory())
+            .map((e) => ({ name: e.name }));
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            inputs.findings.add("coverage", `${DOMAINS_DIR_REL}/ not found - emitting empty domains.csv`);
+            return [];
+        }
+        throw err;
+    }
+    const rows = [];
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        const slug = entry.name;
+        const description = await readDomainDescription(join(domainsDir, slug), inputs.findings, slug);
+        rows.push({
+            id: slug,
+            name: titleCase(slug),
+            description,
+            method_profile: inputs.manifest.profile,
+            reference_architecture_equivalent: "",
+            status: "active",
+            repo_count: 0, // populated by orchestrator after repositories build
+            source_sdd_id: "",
+        });
+    }
+    return rows;
+}
+/**
+ * Look for a one-line description in a domain README. Falls back to
+ * empty when no README or no usable first paragraph is present.
+ */
+async function readDomainDescription(domainDir, findings, slug) {
+    const candidates = ["README.md", "README.markdown"];
+    for (const name of candidates) {
+        const path = join(domainDir, name);
+        try {
+            const s = await stat(path);
+            if (!s.isFile())
+                continue;
+            const text = await readFile(path, "utf-8");
+            const firstPara = extractFirstParagraph(text);
+            if (firstPara)
+                return firstPara.slice(0, 500);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== "ENOENT")
+                throw err;
+        }
+    }
+    findings.add("coverage", `domain ${slug} has no README.md — description left empty`);
+    return "";
+}
+function extractFirstParagraph(markdown) {
+    // Strip an optional H1, then return the first non-empty paragraph
+    // (text up to the first blank line).
+    const lines = markdown.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length && (lines[i] === undefined || lines[i].trim() === "" || lines[i].startsWith("#"))) {
+        i++;
+    }
+    const para = [];
+    while (i < lines.length && lines[i].trim() !== "") {
+        para.push(lines[i].trim());
+        i++;
+    }
+    return para.join(" ").trim();
+}
+function titleCase(slug) {
+    return slug
+        .split("-")
+        .map((p) => (p.length === 0 ? p : p[0].toUpperCase() + p.slice(1)))
+        .join(" ");
+}
+//# sourceMappingURL=domains.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { ParsedRepoConfig } from "./repositories.js";
+import type { TraceabilityManifest } from "../traceability-loader.js";
+export interface ServiceEventInputs {
+    readonly findings: FindingsLog;
+    readonly configs: readonly ParsedRepoConfig[];
+    readonly contractIdByPath: ReadonlyMap<string, string>;
+    readonly knownServiceIds: ReadonlySet<string>;
+    readonly knownEventIds: ReadonlySet<string>;
+}
+export interface CapabilityEventInputs {
+    readonly findings: FindingsLog;
+    readonly manifests: readonly TraceabilityManifest[];
+    readonly knownCapabilityIds: ReadonlySet<string>;
+    readonly knownEventIds: ReadonlySet<string>;
+}
+export declare function buildServiceEvent(inputs: ServiceEventInputs): CatalogueRow[];
+export declare function buildCapabilityEvent(inputs: CapabilityEventInputs): CatalogueRow[];
+//# sourceMappingURL=event-edges.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-edges.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/event-edges.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,qBAAqB;IACpC,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;IACjD,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAiC5E;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,qBAAqB,GAC5B,YAAY,EAAE,CAuChB"}

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

@@ -0,0 +1,112 @@
+// service_event + capability_event edge builders.
+//
+// service_event:
+//   - From repo-config `events.produces[].schema` (role=publishes)
+//     and `events.consumes[].schema` (role=consumes). Each schema is
+//     resolved against the contracts.avro index → event id.
+//   - `contracts.avro` is NOT a fallback for publishes — it's a
+//     build-time list (for code-gen / validation) that consumers
+//     commonly declare too. Only the events block is authoritative.
+//
+// capability_event:
+//   - From traceability `traceability.events[]` when present (forward
+//     method extension; not yet adopted in contextua-platform per the
+//     metamodel's "populated where specs adopt `## Related Events`" note).
+//   - Empty until adopters declare events under their traceability.
+import { sep } from "node:path";
+export function buildServiceEvent(inputs) {
+    const rows = [];
+    const seen = new Set();
+    const emit = (serviceId, eventId, role) => {
+        if (!inputs.knownServiceIds.has(serviceId))
+            return;
+        if (!inputs.knownEventIds.has(eventId))
+            return;
+        const id = `${serviceId}__${eventId}__${role}`;
+        if (seen.has(id))
+            return;
+        seen.add(id);
+        rows.push({ id, service_id: serviceId, event_id: eventId, role });
+    };
+    for (const cfg of inputs.configs) {
+        const events = cfg.data.events;
+        if (!events)
+            continue;
+        for (const entry of events.produces ?? []) {
+            if (!entry.schema)
+                continue;
+            const eid = resolveAvroPath(entry.schema, inputs.contractIdByPath);
+            if (eid !== undefined)
+                emit(cfg.repoId, eid, "publishes");
+        }
+        for (const entry of events.consumes ?? []) {
+            if (!entry.schema)
+                continue;
+            const eid = resolveAvroPath(entry.schema, inputs.contractIdByPath);
+            if (eid !== undefined)
+                emit(cfg.repoId, eid, "consumes");
+        }
+    }
+    return rows;
+}
+export function buildCapabilityEvent(inputs) {
+    const rows = [];
+    const seen = new Set();
+    for (const m of inputs.manifests) {
+        const capId = m.capability.id;
+        if (!inputs.knownCapabilityIds.has(capId))
+            continue;
+        // The traceability.events block is an aspirational forward extension;
+        // not all manifests declare it. When absent, this manifest contributes
+        // nothing to the edge.
+        const events = m.data
+            ?.traceability?.events;
+        if (!Array.isArray(events))
+            continue;
+        for (const entry of events) {
+            if (!entry || typeof entry !== "object")
+                continue;
+            const o = entry;
+            const eid = String(o["id"] ?? "").trim();
+            const role = String(o["role"] ?? "").trim();
+            if (eid === "" || (role !== "publishes" && role !== "consumes"))
+                continue;
+            if (!inputs.knownEventIds.has(eid)) {
+                inputs.findings.add("orphan", `${m.relPath}: capability_event references "${eid}" but no such event exists`);
+                continue;
+            }
+            const edgeId = `${capId}__${eid}__${role}`;
+            if (seen.has(edgeId))
+                continue;
+            seen.add(edgeId);
+            rows.push({
+                id: edgeId,
+                capability_id: capId,
+                event_id: eid,
+                role,
+            });
+        }
+    }
+    return rows;
+}
+function resolveAvroPath(schema, index) {
+    const cleaned = schema.replace(/^\/+/, "");
+    const full = `contracts/avro/${cleaned}`;
+    if (index.has(full))
+        return index.get(full);
+    if (index.has(cleaned))
+        return index.get(cleaned);
+    for (const [path, id] of index) {
+        const parts = path.split(sep);
+        if (parts.length >= 2 && parts.slice(-2).join("/") === cleaned)
+            return id;
+    }
+    const base = cleaned.split("/").slice(-1)[0] ?? cleaned;
+    for (const [path, id] of index) {
+        const parts = path.split(sep);
+        if ((parts[parts.length - 1] ?? "") === base)
+            return id;
+    }
+    return undefined;
+}
+//# sourceMappingURL=event-edges.js.map

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

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

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

@@ -0,0 +1,26 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { ParsedRepoConfig } from "./repositories.js";
+export interface EventsBuildInputs {
+    readonly findings: FindingsLog;
+    /** Contract rows where kind=event (avro). */
+    readonly avroContracts: readonly CatalogueRow[];
+    /** Map of contract spec_path → contract id, for repo-config schema-path resolution. */
+    readonly contractIdByPath: ReadonlyMap<string, string>;
+    /** Repo-config configs from the repositories builder. */
+    readonly configs: readonly ParsedRepoConfig[];
+    /** Service ids known to this build (so publisher_service_id only resolves to runtime services). */
+    readonly knownServiceIds: ReadonlySet<string>;
+    /** Domain ids known to this build (for domain_id fallback). */
+    readonly knownDomainIds: ReadonlySet<string>;
+}
+export interface PublisherIndex {
+    /** Map of contract id → repo (== service) id that publishes it, when one is declared. */
+    readonly publisherByContractId: ReadonlyMap<string, string>;
+}
+export interface EventsBuildResult {
+    readonly rows: CatalogueRow[];
+    readonly publisherIndex: PublisherIndex;
+}
+export declare function buildEvents(inputs: EventsBuildInputs): EventsBuildResult;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/events.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;IAChD,uFAAuF;IACvF,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,mGAAmG;IACnG,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,yFAAyF;IACzF,QAAQ,CAAC,qBAAqB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAkDxE"}

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

@@ -0,0 +1,99 @@
+// Events discoverer — emits `events.csv` from avro contracts (kind=event).
+//
+// In the forward method, every avro `*.avsc` schema declares one event;
+// the canonical builder treats events as 1:1 with avro contracts and
+// reuses the contract's id as the event id.
+//
+// publisher_service_id derivation: ONLY events.produces is authoritative.
+// `contracts.avro` is a build-time list (for code-gen / validation) and
+// MUST NOT be inferred as a publish declaration — services that consume
+// avro schemas commonly list them under contracts.avro too. If no
+// service declares events.produces for a given schema, the event row
+// emits with empty publisher_service_id.
+//
+// transport defaults to `nats` per ADR 0068 (Scaleway MnQ NATS for
+// platform messaging). The schema's enum doesn't include "nats" today;
+// the column is nullable string so any value is accepted.
+import { sep } from "node:path";
+export function buildEvents(inputs) {
+    // Build the publisher index from repo-config events.produces only.
+    // Earlier-encountered service wins on ties (deterministic per sorted
+    // config order from the repositories builder).
+    const publisherByContractId = new Map();
+    for (const cfg of inputs.configs) {
+        if (!inputs.knownServiceIds.has(cfg.repoId))
+            continue;
+        const events = cfg.data.events;
+        const produces = events?.produces ?? [];
+        for (const entry of produces) {
+            const schema = entry.schema;
+            if (!schema)
+                continue;
+            const id = resolveContractByPath(schema, "avro", inputs.contractIdByPath);
+            if (id === undefined)
+                continue;
+            if (!publisherByContractId.has(id)) {
+                publisherByContractId.set(id, cfg.repoId);
+            }
+        }
+    }
+    const rows = [];
+    for (const c of inputs.avroContracts) {
+        const id = String(c["id"]);
+        const specPath = String(c["spec_path"] ?? "");
+        const rawDomain = inferDomainFromAvroPath(specPath);
+        let domain = rawDomain;
+        if (rawDomain.startsWith("_")) {
+            // `_common`, `_shared`, etc. — cross-domain envelope schemas.
+            // Emit empty domain_id (events.domain_id is nullable per schema 1.4.0).
+            domain = "";
+        }
+        else if (rawDomain !== "" && !inputs.knownDomainIds.has(rawDomain)) {
+            inputs.findings.add("orphan", `event ${id}: schema is at ${specPath} but no docs/domains/${rawDomain}/ exists — emitting with empty domain_id`);
+            domain = "";
+        }
+        rows.push({
+            id,
+            name: String(c["name"] ?? id),
+            publisher_service_id: publisherByContractId.get(id) ?? "",
+            domain_id: domain,
+            transport: "nats",
+            schema_path: specPath,
+            version: String(c["version"] ?? ""),
+            source_sdd_id: "",
+        });
+    }
+    return { rows, publisherIndex: { publisherByContractId } };
+}
+function inferDomainFromAvroPath(relPath) {
+    // Layout: contracts/avro/<domain>/<file>.avsc
+    const parts = relPath.split(sep);
+    if (parts.length < 4)
+        return "";
+    return parts[2] ?? "";
+}
+function resolveContractByPath(schema, kind, index) {
+    const cleaned = schema.replace(/^\/+/, "");
+    // Repo-config event paths are relative to contracts/<kind>/.
+    const fullCandidate = `contracts/${kind}/${cleaned}`;
+    if (index.has(fullCandidate))
+        return index.get(fullCandidate);
+    if (index.has(cleaned))
+        return index.get(cleaned);
+    // Suffix fallback (last two segments).
+    for (const [path, id] of index) {
+        const parts = path.split(sep);
+        const last2 = parts.length >= 2 ? parts.slice(-2).join("/") : "";
+        if (last2 === cleaned)
+            return id;
+    }
+    // Basename fallback.
+    const base = cleaned.split("/").slice(-1)[0] ?? cleaned;
+    for (const [path, id] of index) {
+        const parts = path.split(sep);
+        if ((parts[parts.length - 1] ?? "") === base)
+            return id;
+    }
+    return undefined;
+}
+//# sourceMappingURL=events.js.map

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

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

package/dist/lib/catalogue/builders/feature-groups.d.ts

@@ -0,0 +1,10 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+export interface FeatureGroupsBuildInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    /** Used to scope group ids when product-bound (typically the SDD's own product id). */
+    readonly productId: string;
+}
+export declare function buildFeatureGroups(inputs: FeatureGroupsBuildInputs): Promise<CatalogueRow[]>;
+//# sourceMappingURL=feature-groups.d.ts.map

package/dist/lib/catalogue/builders/feature-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-groups.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/feature-groups.ts"],"names":[],"mappings":"AAoBA,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,uFAAuF;IACvF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAOD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,YAAY,EAAE,CAAC,CAkDzB"}

package/dist/lib/catalogue/builders/feature-groups.js

@@ -0,0 +1,118 @@
+// FeatureGroups discoverer — emits `feature_groups.csv` rows from
+// hierarchical `feature-tree.md` files.
+//
+// Per Q7.2 resolution (adopt-canonical-catalogue-builder.md §7.2),
+// FeatureGroups are first-class entities. This builder parses pure
+// markdown H2/H3 headings as the hierarchical structure:
+//   - H2 heading → top-level FeatureGroup (parent_group_id = "")
+//   - H3 heading → child FeatureGroup (parent_group_id = enclosing H2's id)
+//
+// ASCII-tree representations inside fenced code blocks are NOT parsed
+// — those are an adopter authoring style that doesn't map cleanly to
+// catalogue entities. Adopters wanting first-class groups format their
+// feature trees with proper H2/H3 headings.
+//
+// Source paths checked (in order, first match wins):
+//   - <sddRoot>/feature-tree.md            (typical for app-product SDDs)
+//   - <sddRoot>/docs/platform/feature-tree.md  (typical for platform SDDs)
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+const CANDIDATE_PATHS_REL = [
+    "feature-tree.md",
+    join("docs", "platform", "feature-tree.md"),
+];
+export async function buildFeatureGroups(inputs) {
+    const featureTreePath = await firstExisting(inputs.sddPath, CANDIDATE_PATHS_REL);
+    if (!featureTreePath) {
+        return [];
+    }
+    const text = await readFile(featureTreePath, "utf-8");
+    const headings = extractHeadingsOutsideCodeFences(text);
+    const rows = [];
+    let currentH2Id = "";
+    for (const h of headings) {
+        if (h.level === 2) {
+            const id = `${inputs.productId}-group-${slugify(h.text)}`;
+            currentH2Id = id;
+            rows.push({
+                id,
+                name: h.text,
+                product_id: inputs.productId,
+                capability_id: "",
+                parent_group_id: "",
+                description: "",
+                source: "feature-tree-h2",
+                source_sdd_id: "",
+            });
+        }
+        else if (h.level === 3) {
+            if (currentH2Id === "") {
+                // H3 with no enclosing H2 — orphan; surface as finding but emit anyway.
+                inputs.findings.add("convention", `${relative(inputs.sddPath, featureTreePath)}: H3 "${h.text}" has no enclosing H2`);
+            }
+            const id = currentH2Id !== ""
+                ? `${currentH2Id}-${slugify(h.text)}`
+                : `${inputs.productId}-group-${slugify(h.text)}`;
+            rows.push({
+                id,
+                name: h.text,
+                product_id: inputs.productId,
+                capability_id: "",
+                parent_group_id: currentH2Id,
+                description: "",
+                source: "feature-tree-h3",
+                source_sdd_id: "",
+            });
+        }
+    }
+    return rows;
+}
+function extractHeadingsOutsideCodeFences(text) {
+    const out = [];
+    let inFence = false;
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trimEnd();
+        if (line.startsWith("```")) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const m = /^(#{2,3})\s+(.+?)\s*$/.exec(line);
+        if (!m || m[1] === undefined || m[2] === undefined)
+            continue;
+        const level = m[1].length === 2 ? 2 : 3;
+        const headingText = m[2]
+            .replace(/^[\d.]+\s*/, "") // strip leading "1.", "1.1", etc.
+            .replace(/\s*\[.+?\]\s*$/, "") // strip trailing "[Business]" / "[Enabler-Runway]" tags
+            .trim();
+        if (headingText === "")
+            continue;
+        out.push({ level, text: headingText });
+    }
+    return out;
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/&/g, " and ")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+async function firstExisting(sddPath, candidates) {
+    for (const rel of candidates) {
+        const full = join(sddPath, rel);
+        try {
+            await readFile(full, "utf-8");
+            return full;
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === "ENOENT")
+                continue;
+            throw err;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=feature-groups.js.map

package/dist/lib/catalogue/builders/feature-groups.js.map

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

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

@@ -0,0 +1,35 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { TraceabilityManifest } from "../traceability-loader.js";
+export interface FeaturesBuildInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    readonly manifests: readonly TraceabilityManifest[];
+    readonly knownCapabilityIds: ReadonlySet<string>;
+    /**
+     * SDD profile, used to opt in to app-product feature discovery at
+     * `features/<group>/<file>.md` (alongside the platform/domain
+     * convention). Per Step 4 of the canonical-builder Phase 2 plan.
+     */
+    readonly profile: string;
+    /**
+     * Product id for the SDD itself — used as the feature id prefix and
+     * `product_id` value when reading app-product features. Ignored for
+     * platform-profile SDDs.
+     */
+    readonly productId: string;
+}
+export interface FeaturesBuildResult {
+    readonly rows: CatalogueRow[];
+    /** Map of feature spec relative path → feature id (for capability_feature edge resolution). */
+    readonly idByPath: ReadonlyMap<string, string>;
+    /**
+     * Map of feature slug (filename stem) → feature id, for resolving
+     * bare-slug references in personas/journeys content. First-seen wins
+     * when the same slug appears under multiple capabilities; the orphan
+     * finding from the consumer side surfaces the (rare) collision.
+     */
+    readonly idBySlug: ReadonlyMap<string, string>;
+}
+export declare function buildFeatures(inputs: FeaturesBuildInputs): Promise<FeaturesBuildResult>;
+//# sourceMappingURL=features.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/features.ts"],"names":[],"mappings":"AAkBA,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,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,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;IACjD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChD;AAID,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAkG9B"}