@sdd-method/sdd-cli 0.9.0 → 0.11.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/integrations.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAWD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,YAAY,EAAE,CAAC,CA4DzB"}

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

@@ -0,0 +1,85 @@
+// Integrations discoverer — emits a single `integrations.csv` row per
+// integration-product SDD, sourced from `integration-manifest.yaml` at
+// the SDD root.
+//
+// Per ADR 0134 federation: each integration-provider SDD owns one row
+// in the granular integrations.csv. The aggregator merges siblings.
+//
+// Profile gating: only integration-product profile SDDs emit. Other
+// profiles are no-ops.
+//
+// id    = integrationId from the manifest (or sdd_id as fallback).
+// name  = providerName (or title-cased id).
+// category = profileType (open enum per schema description; ecosystems
+//        extend with values like saas-platform, oem, device, ...).
+// parent_product_id = empty (umbrella integration-products are not yet
+//        modelled in the federation; this is a hook for future use).
+// domain_id = empty (integration providers are federation nodes, not
+//        capability-domain members — per ADR 0136).
+// doc_path = "." (SDD root).
+// repo_count = supplied by the orchestrator from discovered repos.
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+const REL_PATH = "integration-manifest.yaml";
+const ManifestSchema = z.object({
+    integrationId: z.string().optional(),
+    providerName: z.string().optional(),
+    profileType: z.string().optional(),
+    parentIntegrationProductId: z.string().optional(),
+});
+export async function buildIntegrations(inputs) {
+    if (inputs.profile !== "integration-product")
+        return [];
+    const path = join(inputs.sddPath, REL_PATH);
+    let text;
+    try {
+        text = await readFile(path, "utf-8");
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+        inputs.findings.add("coverage", `${REL_PATH} not found — emitting empty integrations.csv (integration-product SDD without a manifest)`);
+        return [];
+    }
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (err) {
+        inputs.findings.add("convention", `${REL_PATH}: failed to parse YAML — ${err.message}`);
+        return [];
+    }
+    const parsed = ManifestSchema.safeParse(raw);
+    if (!parsed.success) {
+        inputs.findings.add("convention", `${REL_PATH}: shape violation — ${parsed.error.issues.map((i) => i.path.join(".") + ": " + i.message).join("; ")}`);
+        return [];
+    }
+    const id = (parsed.data.integrationId ?? "").trim() || inputs.sddId;
+    const name = (parsed.data.providerName ?? "").trim() || titleCase(id);
+    const category = (parsed.data.profileType ?? "").trim();
+    const parentProductId = (parsed.data.parentIntegrationProductId ?? "").trim();
+    if (category === "") {
+        inputs.findings.add("convention", `${REL_PATH}: missing required \`profileType\` (used as integrations.category)`);
+    }
+    return [
+        {
+            id,
+            name,
+            domain_id: "",
+            parent_product_id: parentProductId,
+            category,
+            doc_path: ".",
+            repo_count: inputs.repoCount,
+            source_sdd_id: "",
+        },
+    ];
+}
+function titleCase(slug) {
+    return slug
+        .split("-")
+        .map((p) => (p.length === 0 ? p : p[0].toUpperCase() + p.slice(1)))
+        .join(" ");
+}
+//# sourceMappingURL=integrations.js.map

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

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

package/dist/lib/catalogue/builders/persona-journey-edges.d.ts

@@ -0,0 +1,26 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+export interface PersonaJourneyEdgeInputs {
+    readonly findings: FindingsLog;
+    readonly personaIdByName: ReadonlyMap<string, string>;
+    readonly personaIdBySlug: ReadonlyMap<string, string>;
+    readonly journeyPrimaryPersonaById: ReadonlyMap<string, string>;
+    readonly journeySupportingPersonasById: ReadonlyMap<string, readonly string[]>;
+}
+export interface PersonaFeatureEdgeInputs {
+    readonly findings: FindingsLog;
+    readonly relatedFeaturesById: ReadonlyMap<string, readonly string[]>;
+    readonly featureIdByPath: ReadonlyMap<string, string>;
+    readonly featureIdBySlug: ReadonlyMap<string, string>;
+}
+export interface JourneyFeatureEdgeInputs {
+    readonly findings: FindingsLog;
+    readonly journeyFeaturePathsById: ReadonlyMap<string, readonly string[]>;
+    readonly journeyRelatedFeatureSlugsById: ReadonlyMap<string, readonly string[]>;
+    readonly featureIdByPath: ReadonlyMap<string, string>;
+    readonly featureIdBySlug: ReadonlyMap<string, string>;
+}
+export declare function buildPersonaJourney(inputs: PersonaJourneyEdgeInputs): CatalogueRow[];
+export declare function buildPersonaFeature(inputs: PersonaFeatureEdgeInputs): CatalogueRow[];
+export declare function buildJourneyFeature(inputs: JourneyFeatureEdgeInputs): CatalogueRow[];
+//# sourceMappingURL=persona-journey-edges.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persona-journey-edges.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/persona-journey-edges.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,yBAAyB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChE,QAAQ,CAAC,6BAA6B,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACrE,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IACzE,QAAQ,CAAC,8BAA8B,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAChF,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,wBAAwB,GAC/B,YAAY,EAAE,CAgChB;AAyDD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,wBAAwB,GAC/B,YAAY,EAAE,CAUhB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,wBAAwB,GAC/B,YAAY,EAAE,CAUhB"}

package/dist/lib/catalogue/builders/persona-journey-edges.js

@@ -0,0 +1,133 @@
+// Persona/journey edge builders — emit:
+//   - persona_journey  (persona ↔ journey, role: primary | handoff | supporting)
+//   - persona_feature  (persona ↔ feature, from `## Related Features` in persona files)
+//   - journey_feature  (journey ↔ feature, from `**Feature:**` link or
+//                       `## Related Features` in journey files)
+//
+// Resolution rules:
+//   - Persona references in journeys are free-text (e.g. "Fleet Manager")
+//     because the persona convention doesn't enforce slug references. We
+//     resolve by name match (case-insensitive) against the personas index;
+//     unresolved entries log `[finding] orphan` and are skipped.
+//   - Feature references resolve via the path index from the features
+//     builder when the journey/persona uses a markdown link, OR via slug
+//     match against the feature id namespace ({capability_id}-{slug}).
+//   - "X → Y (handoff)" in primary_persona triggers a handoff role for Y
+//     against the same journey. The "primary" role goes to X.
+export function buildPersonaJourney(inputs) {
+    const rows = [];
+    const seen = new Set();
+    for (const [journeyId, primaryRaw] of inputs.journeyPrimaryPersonaById) {
+        const { primary, handoff } = splitHandoff(primaryRaw);
+        if (primary !== "") {
+            addEdge(inputs, rows, seen, journeyId, primary, "primary");
+        }
+        if (handoff !== "") {
+            addEdge(inputs, rows, seen, journeyId, handoff, "handoff");
+        }
+        const supporting = inputs.journeySupportingPersonasById.get(journeyId) ?? [];
+        for (const name of supporting) {
+            addEdge(inputs, rows, seen, journeyId, name, "supporting");
+        }
+    }
+    return rows;
+}
+function addEdge(inputs, rows, seen, journeyId, personaName, role) {
+    const personaId = resolvePersona(inputs.personaIdByName, inputs.personaIdBySlug, personaName);
+    if (personaId === undefined) {
+        inputs.findings.add("orphan", `persona_journey: journey ${journeyId} references persona "${personaName}" — no matching personas/<slug>.md`);
+        return;
+    }
+    const id = `${personaId}__${journeyId}__${role}`;
+    if (seen.has(id))
+        return;
+    seen.add(id);
+    rows.push({
+        id,
+        persona_id: personaId,
+        journey_id: journeyId,
+        role,
+    });
+}
+function resolvePersona(byName, bySlug, raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "")
+        return undefined;
+    const byNameHit = byName.get(trimmed.toLowerCase());
+    if (byNameHit !== undefined)
+        return byNameHit;
+    // Try slugified form: "Fleet Manager" → "fleet-manager".
+    const slug = trimmed
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return bySlug.get(slug);
+}
+function splitHandoff(raw) {
+    // Pattern: `X → Y (handoff)` or `X -> Y (handoff)`.
+    const m = /^(.+?)\s*(?:→|->)\s*(.+?)\s*\(handoff\)\s*$/i.exec(raw.trim());
+    if (m)
+        return { primary: (m[1] ?? "").trim(), handoff: (m[2] ?? "").trim() };
+    return { primary: raw.trim(), handoff: "" };
+}
+export function buildPersonaFeature(inputs) {
+    return buildEdgesByFeatureRef({
+        findings: inputs.findings,
+        leftKey: "persona_id",
+        leftIdToRefs: inputs.relatedFeaturesById,
+        leftIdToPaths: new Map(),
+        featureIdByPath: inputs.featureIdByPath,
+        featureIdBySlug: inputs.featureIdBySlug,
+        edgeName: "persona_feature",
+    });
+}
+export function buildJourneyFeature(inputs) {
+    return buildEdgesByFeatureRef({
+        findings: inputs.findings,
+        leftKey: "journey_id",
+        leftIdToRefs: inputs.journeyRelatedFeatureSlugsById,
+        leftIdToPaths: inputs.journeyFeaturePathsById,
+        featureIdByPath: inputs.featureIdByPath,
+        featureIdBySlug: inputs.featureIdBySlug,
+        edgeName: "journey_feature",
+    });
+}
+function buildEdgesByFeatureRef(inputs) {
+    const rows = [];
+    const seen = new Set();
+    const addRow = (leftId, featureId) => {
+        const id = `${leftId}__${featureId}`;
+        if (seen.has(id))
+            return;
+        seen.add(id);
+        rows.push({
+            id,
+            [inputs.leftKey]: leftId,
+            feature_id: featureId,
+        });
+    };
+    // Path-based references (markdown links to feature spec files).
+    for (const [leftId, paths] of inputs.leftIdToPaths) {
+        for (const path of paths) {
+            const featureId = inputs.featureIdByPath.get(path);
+            if (featureId === undefined) {
+                inputs.findings.add("orphan", `${inputs.edgeName}: ${leftId} links to "${path}" — no matching features.csv row`);
+                continue;
+            }
+            addRow(leftId, featureId);
+        }
+    }
+    // Slug-based references (bare bullets in `## Related Features`).
+    for (const [leftId, slugs] of inputs.leftIdToRefs) {
+        for (const slug of slugs) {
+            const featureId = inputs.featureIdBySlug.get(slug);
+            if (featureId === undefined) {
+                inputs.findings.add("orphan", `${inputs.edgeName}: ${leftId} references feature slug "${slug}" — no feature with this slug in features.csv`);
+                continue;
+            }
+            addRow(leftId, featureId);
+        }
+    }
+    return rows;
+}
+//# sourceMappingURL=persona-journey-edges.js.map

package/dist/lib/catalogue/builders/persona-journey-edges.js.map

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

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

@@ -0,0 +1,22 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { Profile } from "../manifest-loader.js";
+export interface PersonasBuildInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    readonly profile: Profile;
+    readonly productId: string;
+}
+export interface PersonasBuildResult {
+    readonly rows: CatalogueRow[];
+    /** Map of `relPath` → persona id, for downstream edge builders. */
+    readonly idByPath: ReadonlyMap<string, string>;
+    /** Map of slug (filename stem) → persona id, for in-content reference resolution. */
+    readonly idBySlug: ReadonlyMap<string, string>;
+    /** Map of normalised persona name → persona id, for in-content reference resolution. */
+    readonly idByName: ReadonlyMap<string, string>;
+    /** Map of persona id → list of feature slugs declared in `## Related Features`. */
+    readonly relatedFeaturesById: ReadonlyMap<string, readonly string[]>;
+}
+export declare function buildPersonas(inputs: PersonasBuildInputs): Promise<PersonasBuildResult>;
+//# sourceMappingURL=personas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/personas.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,mFAAmF;IACnF,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CACtE;AAID,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAwD9B"}

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

@@ -0,0 +1,150 @@
+// Personas discoverer — emits `personas.csv` rows from `personas/*.md`
+// at the SDD root.
+//
+// Source convention (per docs/method/methods/persona-template.md):
+//   personas/<slug>.md
+//   ---
+//   # Persona: {Name}
+//   **App:** {app-name}
+//   ## Summary
+//   {1-2 sentences}
+//
+// Profile gating: personas are an application-product profile concept.
+// Other profiles emit zero rows and skip the directory walk silently.
+//
+// id = `{product_id}-{slug}`, slug from filename stem.
+// name = H1 (with the optional `Persona:` prefix stripped).
+// description = first non-empty paragraph under `## Summary`.
+// role = empty (template doesn't carry a single-token role today; the
+//        column stays available for ecosystems that want to populate it).
+import { readdir, readFile } from "node:fs/promises";
+import { basename, join, relative } from "node:path";
+const PERSONAS_DIR_REL = "personas";
+export async function buildPersonas(inputs) {
+    const idByPath = new Map();
+    const idBySlug = new Map();
+    const idByName = new Map();
+    const relatedFeaturesById = new Map();
+    if (inputs.profile !== "application-product") {
+        return { rows: [], idByPath, idBySlug, idByName, relatedFeaturesById };
+    }
+    const dir = join(inputs.sddPath, PERSONAS_DIR_REL);
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+        inputs.findings.add("coverage", `${PERSONAS_DIR_REL}/ not found — emitting empty personas.csv`);
+        return { rows: [], idByPath, idBySlug, idByName, relatedFeaturesById };
+    }
+    const files = entries
+        .filter((e) => e.isFile() && e.name.endsWith(".md") && !isTemplate(e.name))
+        .map((e) => e.name)
+        .sort();
+    const rows = [];
+    for (const filename of files) {
+        const slug = basename(filename).replace(/\.md$/i, "");
+        const id = `${inputs.productId}-${slug}`;
+        const absPath = join(dir, filename);
+        const relPath = relative(inputs.sddPath, absPath);
+        const text = await readFile(absPath, "utf-8");
+        const name = extractName(text) || titleCase(slug);
+        const description = extractSummary(text);
+        const relatedFeatures = extractRelatedFeatures(text);
+        rows.push({
+            id,
+            name,
+            product_id: inputs.productId,
+            role: "",
+            description,
+            source_sdd_id: "",
+        });
+        idByPath.set(relPath, id);
+        idBySlug.set(slug, id);
+        idByName.set(normaliseName(name), id);
+        relatedFeaturesById.set(id, relatedFeatures);
+    }
+    return { rows, idByPath, idBySlug, idByName, relatedFeaturesById };
+}
+function isTemplate(name) {
+    return /[{}]/.test(name) || name.toLowerCase().endsWith("-template.md");
+}
+function extractName(text) {
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (line === "")
+            continue;
+        // Only the top-level H1 counts as a name. Skip non-heading lines and
+        // sub-headings (## ...).
+        const m = /^#\s+(.+)$/.exec(line);
+        if (!m)
+            return "";
+        const stripped = (m[1] ?? "").trim();
+        const personaPrefix = /^Persona:\s*(.+)$/i.exec(stripped);
+        return personaPrefix ? (personaPrefix[1] ?? "").trim() : stripped;
+    }
+    return "";
+}
+function extractSummary(text) {
+    const lines = text.split(/\r?\n/);
+    let i = 0;
+    // Find `## Summary` heading.
+    while (i < lines.length) {
+        if (/^##\s+summary\b/i.test(lines[i] ?? ""))
+            break;
+        i++;
+    }
+    if (i === lines.length)
+        return "";
+    i++;
+    // Skip blank lines.
+    while (i < lines.length && (lines[i] ?? "").trim() === "")
+        i++;
+    // Capture first non-empty paragraph until blank line.
+    const para = [];
+    while (i < lines.length) {
+        const line = lines[i] ?? "";
+        if (line.trim() === "")
+            break;
+        if (line.startsWith("#") || line.startsWith("---"))
+            break;
+        para.push(line.trim());
+        i++;
+    }
+    return para.join(" ").trim().slice(0, 500);
+}
+function extractRelatedFeatures(text) {
+    const lines = text.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        if (/^##\s+related\s+features\b/i.test(lines[i] ?? ""))
+            break;
+        i++;
+    }
+    if (i === lines.length)
+        return [];
+    i++;
+    const out = [];
+    while (i < lines.length) {
+        const line = lines[i] ?? "";
+        if (line.startsWith("#") || line.startsWith("---"))
+            break;
+        const m = /^[-*]\s+`?([a-z0-9][a-z0-9-]*)`?(?:\s|$)/i.exec(line.trim());
+        if (m && m[1])
+            out.push(m[1].toLowerCase());
+        i++;
+    }
+    return out;
+}
+function normaliseName(name) {
+    return name.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function titleCase(slug) {
+    return slug
+        .split("-")
+        .map((p) => (p.length === 0 ? p : p[0].toUpperCase() + p.slice(1)))
+        .join(" ");
+}
+//# sourceMappingURL=personas.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { Profile } from "../manifest-loader.js";
+export interface ProductEdgesInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    readonly profile: Profile;
+    readonly productId: string;
+}
+export interface ProductEdgesResult {
+    readonly productCapability: CatalogueRow[];
+    readonly productService: CatalogueRow[];
+}
+export declare function buildProductEdges(inputs: ProductEdgesInputs): Promise<ProductEdgesResult>;
+//# sourceMappingURL=product-edges.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"product-edges.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/product-edges.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,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,iBAAiB,EAAE,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,YAAY,EAAE,CAAC;CACzC;AAgBD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAuF7B"}

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

@@ -0,0 +1,97 @@
+// Product-edge builders — emit:
+//   - product_capability  (product depends on / consumes capability)
+//   - product_service     (product depends on / consumes service)
+//
+// Source: `app-platform-dependencies.yaml` at the SDD root for
+// application-product profile SDDs. Per the schema, both edges'
+// referenced columns are external FKs (capability_id and service_id
+// are owned by the platform-root SDD, not by the consuming app SDD).
+// The per-SDD builder logs `[finding] external` for each unresolved
+// reference; the aggregator validates after merge per ADR 0134 §4.3.
+//
+// Profile gating: only application-product SDDs read this file. Other
+// profiles emit zero rows (no convention defined).
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+const REL_PATH = "app-platform-dependencies.yaml";
+const DependencyEntrySchema = z.object({
+    capability_id: z.string().optional(),
+    service_id: z.string().optional(),
+    required_stability: z.string().optional(),
+    notes: z.string().optional(),
+});
+const FileSchema = z.object({
+    app_id: z.string().optional(),
+    platform_dependencies: z.array(DependencyEntrySchema).optional(),
+});
+export async function buildProductEdges(inputs) {
+    if (inputs.profile !== "application-product") {
+        return { productCapability: [], productService: [] };
+    }
+    const path = join(inputs.sddPath, REL_PATH);
+    let text;
+    try {
+        text = await readFile(path, "utf-8");
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+        inputs.findings.add("coverage", `${REL_PATH} not found — emitting empty product_capability + product_service`);
+        return { productCapability: [], productService: [] };
+    }
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (err) {
+        inputs.findings.add("convention", `${REL_PATH}: failed to parse YAML — ${err.message}`);
+        return { productCapability: [], productService: [] };
+    }
+    const parsed = FileSchema.safeParse(raw);
+    if (!parsed.success) {
+        inputs.findings.add("convention", `${REL_PATH}: shape violation — ${parsed.error.issues.map((i) => i.path.join(".") + ": " + i.message).join("; ")}`);
+        return { productCapability: [], productService: [] };
+    }
+    const productCapability = [];
+    const productService = [];
+    const seenCap = new Set();
+    const seenSvc = new Set();
+    for (const dep of parsed.data.platform_dependencies ?? []) {
+        const capabilityId = (dep.capability_id ?? "").trim();
+        const serviceId = (dep.service_id ?? "").trim();
+        const requiredStability = (dep.required_stability ?? "").trim();
+        const notes = (dep.notes ?? "").trim();
+        if (capabilityId !== "") {
+            const id = `${inputs.productId}__${capabilityId}`;
+            if (!seenCap.has(id)) {
+                seenCap.add(id);
+                productCapability.push({
+                    id,
+                    product_id: inputs.productId,
+                    capability_id: capabilityId,
+                    role: "consumes",
+                    notes,
+                });
+                inputs.findings.add("external", `product_capability: ${id} → capability_id="${capabilityId}" (external FK; aggregator validates)`);
+            }
+        }
+        if (serviceId !== "") {
+            const id = `${inputs.productId}__${serviceId}`;
+            if (!seenSvc.has(id)) {
+                seenSvc.add(id);
+                productService.push({
+                    id,
+                    product_id: inputs.productId,
+                    service_id: serviceId,
+                    role: "consumes",
+                    required_stability: requiredStability,
+                });
+                inputs.findings.add("external", `product_service: ${id} → service_id="${serviceId}" (external FK; aggregator validates)`);
+            }
+        }
+    }
+    return { productCapability, productService };
+}
+//# sourceMappingURL=product-edges.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Products discoverer — emits the SDD-as-Product row from the manifest.
+ *
+ * Per ADR 0134 + catalogue-metamodel.md: every SDD is one Product. The
+ * canonical builder emits ONE products.csv row per SDD — the SDD itself.
+ * Sibling SDDs (apps, integrations) get their own products.csv rows in
+ * their own builds; the aggregator merges by primary key.
+ *
+ * domain_id selection (per ADR 0136):
+ *   - manifest.domainId when declared,
+ *   - else a sensible default for platform-profile categories (where a
+ *     real `platform` domain exists locally),
+ *   - else empty (app and integration products do not have a primary
+ *     domain — they are federation nodes that consume capabilities
+ *     across multiple domains via product_capability).
+ */
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { SddManifest } from "../manifest-loader.js";
+export interface ProductsBuildInputs {
+    readonly manifest: SddManifest;
+    readonly repoCount: number;
+    readonly findings: FindingsLog;
+}
+export declare function buildProducts(inputs: ProductsBuildInputs): CatalogueRow[];
+//# sourceMappingURL=products.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/products.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC;AAYD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,mBAAmB,GAC1B,YAAY,EAAE,CA6BhB"}