@sdd-method/sdd-cli 0.17.0 → 0.21.0

package/dist/lib/catalogue/builders/feature-grounding-walker.js

@@ -0,0 +1,254 @@
+/**
+ * Walker for `feature-grounding.md` files per ADR 0143 (schema 2.5.0).
+ *
+ * Reads markdown tables of the canonical shape:
+ *
+ *     | Feature | UI Components | API Routes | Backend Handlers | Data Entities | Evidence |
+ *     |---|---|---|---|---|---|
+ *     | `oauth2-login` | ... | BFF `GET /login` | `AuthHandler.handle...()` | Token | `auth-handler.ts` |
+ *
+ * Path conventions (per ADR 0143 §4.3):
+ *   - platform-profile: `docs/domains/<dom>/design/<capability>/feature-grounding.md`
+ *   - integration-product: `docs/design/integration/feature-grounding.md`
+ *
+ * Tolerant of column re-ordering and missing optional columns. The only
+ * required column is `Feature`. Lines inside ```fenced``` code blocks
+ * are skipped. Recovery is row-local — a malformed row emits a finding
+ * and the walker continues with the next row.
+ */
+import { readdir, readFile } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+const DOMAINS_DIR_REL = join("docs", "domains");
+const PLATFORM_LEAF = "feature-grounding.md";
+/**
+ * Find all `docs/domains/<dom>/design/<capability>/feature-grounding.md`
+ * files under the SDD root. Sorted for deterministic output.
+ */
+export async function findPlatformGroundingFiles(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 designDir = join(domainsDir, d.name, "design");
+        let caps;
+        try {
+            caps = await readdir(designDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const c of caps) {
+            if (!c.isDirectory())
+                continue;
+            const candidate = join(designDir, c.name, PLATFORM_LEAF);
+            try {
+                await readFile(candidate, "utf-8");
+                out.push(candidate);
+            }
+            catch (err) {
+                const code = err.code;
+                if (code === "ENOENT")
+                    continue;
+                throw err;
+            }
+        }
+    }
+    return out.sort();
+}
+/**
+ * Find the single integration-product feature-grounding.md, if any.
+ * Path: `docs/design/integration/feature-grounding.md`.
+ */
+export async function findIntegrationGroundingFile(sddPath) {
+    const candidate = join(sddPath, "docs", "design", "integration", PLATFORM_LEAF);
+    try {
+        await readFile(candidate, "utf-8");
+        return candidate;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+/**
+ * Resolve the capability id from a platform-profile grounding file's
+ * absolute path. Returns the parent folder name. Callers verify the
+ * id resolves against `capabilities.csv` and emit findings on miss.
+ */
+export function capabilityIdFromPath(absPath, sddPath) {
+    const rel = relative(sddPath, absPath);
+    const parts = rel.split(sep);
+    // Expected: ["docs", "domains", "<dom>", "design", "<capability>", "feature-grounding.md"]
+    if (parts.length < 6)
+        return "";
+    return parts[parts.length - 2] ?? "";
+}
+/**
+ * Parse the markdown content of a feature-grounding.md file and return
+ * the rows from its first valid feature table. A "valid table" has a
+ * header row whose first non-empty cell normalises to `feature`.
+ * Returns an empty array if no such table is found (caller logs a
+ * coverage finding).
+ */
+export function parseGroundingTable(text) {
+    const lines = text.split(/\r?\n/);
+    let inFence = false;
+    let i = 0;
+    while (i < lines.length) {
+        const raw = lines[i] ?? "";
+        if (isFenceToggle(raw)) {
+            inFence = !inFence;
+            i++;
+            continue;
+        }
+        if (inFence) {
+            i++;
+            continue;
+        }
+        if (!isTableRowLine(raw)) {
+            i++;
+            continue;
+        }
+        // Candidate header row. Need a separator row right after.
+        const next = lines[i + 1] ?? "";
+        if (!isSeparatorRowLine(next)) {
+            i++;
+            continue;
+        }
+        const headers = splitTableRow(raw).map(normaliseHeader);
+        if (headers.length === 0 || headers[0] !== "feature") {
+            i++;
+            continue;
+        }
+        // Found the table. Walk body rows until non-table line.
+        return parseBodyRows(lines, i + 2, headers);
+    }
+    return [];
+}
+function parseBodyRows(lines, startIdx, headers) {
+    const rows = [];
+    let inFence = false;
+    for (let i = startIdx; i < lines.length; i++) {
+        const raw = lines[i] ?? "";
+        if (isFenceToggle(raw)) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        if (!isTableRowLine(raw)) {
+            // Allow a single blank line inside the table; anything else ends it.
+            if (raw.trim() === "")
+                continue;
+            break;
+        }
+        const cells = splitTableRow(raw);
+        const featureCell = cells[0] ?? "";
+        const slug = extractSlug(featureCell);
+        if (slug === "") {
+            // Skip rows whose first cell isn't a recognisable slug — caller logs.
+            continue;
+        }
+        const cellMap = new Map();
+        for (let c = 1; c < headers.length; c++) {
+            const header = headers[c] ?? "";
+            if (header === "")
+                continue;
+            cellMap.set(header, (cells[c] ?? "").trim());
+        }
+        rows.push({ slug, cells: cellMap, lineNumber: i + 1 });
+    }
+    return rows;
+}
+/** A line is a table row if it has at least one unescaped `|`. */
+function isTableRowLine(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed.startsWith("|") && !trimmed.includes("|"))
+        return false;
+    // Heuristic: a row must contain at least two | characters.
+    return (trimmed.match(/\|/g)?.length ?? 0) >= 2;
+}
+/** Separator row: `|---|---|...|`, possibly with `:` alignment markers. */
+function isSeparatorRowLine(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed.startsWith("|"))
+        return false;
+    return /^\|(\s*:?-+:?\s*\|)+\s*$/.test(trimmed);
+}
+function isFenceToggle(raw) {
+    const trimmed = raw.trimStart();
+    return trimmed.startsWith("```") || trimmed.startsWith("~~~");
+}
+/**
+ * Split a `| a | b | c |` row into cells. Strips leading/trailing
+ * empty cells caused by the bookend pipes. Does NOT split inside
+ * backtick spans — `` `foo|bar` `` stays as one cell.
+ */
+function splitTableRow(raw) {
+    const cells = [];
+    let current = "";
+    let inTick = false;
+    // Skip the opening pipe if present.
+    let trimmed = raw.trim();
+    if (trimmed.startsWith("|"))
+        trimmed = trimmed.slice(1);
+    if (trimmed.endsWith("|"))
+        trimmed = trimmed.slice(0, -1);
+    for (const ch of trimmed) {
+        if (ch === "`") {
+            inTick = !inTick;
+            current += ch;
+            continue;
+        }
+        if (ch === "|" && !inTick) {
+            cells.push(current);
+            current = "";
+            continue;
+        }
+        current += ch;
+    }
+    cells.push(current);
+    return cells;
+}
+/**
+ * Normalise a header cell to a key form: lowercase, trimmed, spaces
+ * and `/` collapsed to `_`. Backticks stripped. e.g. "API Routes" →
+ * "api_routes", "UI / UX" → "ui_ux".
+ */
+function normaliseHeader(cell) {
+    return cell
+        .replace(/`/g, "")
+        .trim()
+        .toLowerCase()
+        .replace(/[\s/]+/g, "_");
+}
+/**
+ * Extract the slug from the first cell. Recognises:
+ *   - `` `slug` ``                     → "slug"
+ *   - `` `slug` (description) ``       → "slug"
+ *   - plain `slug-name`                → "slug-name"
+ * Returns "" if no valid slug pattern matches.
+ */
+function extractSlug(cell) {
+    const trimmed = cell.trim();
+    // Backticked form first — the canonical shape.
+    const tickMatch = trimmed.match(/^`([a-z0-9][a-z0-9-]*)`/i);
+    if (tickMatch)
+        return tickMatch[1] ?? "";
+    // Plain kebab-case fallback.
+    const plainMatch = trimmed.match(/^([a-z][a-z0-9-]*)$/i);
+    if (plainMatch)
+        return plainMatch[1] ?? "";
+    return "";
+}
+//# sourceMappingURL=feature-grounding-walker.js.map

package/dist/lib/catalogue/builders/feature-grounding-walker.js.map

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

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

@@ -0,0 +1,53 @@
+/**
+ * Feature-grounding extractor per ADR 0143 (schema 2.5.0).
+ *
+ * Walks `docs/domains/<dom>/design/<capability>/feature-grounding.md`
+ * (platform-profile) and `docs/design/integration/feature-grounding.md`
+ * (integration-product), parses the canonical markdown table, and
+ * emits four catalogue contributions:
+ *
+ *   - `features.csv` rows with `source: feature-grounding`.
+ *   - `capability_feature.csv` rows (1:1 with each feature row).
+ *   - `feature_repo.csv` rows derived from file-path references in
+ *     the Evidence column.
+ *   - `feature_service.csv` rows derived from class names / file
+ *     basenames / route fragments in API Routes / Backend Handlers
+ *     / Evidence columns, resolved via `services.csv` + the optional
+ *     per-SDD alias map.
+ *
+ * Resolution failures (unresolved capability, service, repo) emit
+ * findings but never break FK validation — only confidently-resolved
+ * rows are emitted.
+ *
+ * Precedence per ADR 0143 §4.4: feature-tree and feature-spec rows
+ * win on id collision; grounding rows are skipped with a divergence
+ * finding.
+ */
+import type { CatalogueRow } from "../csv-writer.js";
+import type { FindingsLog } from "../findings.js";
+import type { LoadedAliases } from "../feature-grounding-aliases-loader.js";
+export interface FeatureGroundingInputs {
+    readonly sddPath: string;
+    readonly findings: FindingsLog;
+    readonly profile: string;
+    /** Product id, used for integration-product capability resolution. */
+    readonly productId: string;
+    /** Set of capability ids known from capabilities.csv (for path resolution). */
+    readonly knownCapabilityIds: ReadonlySet<string>;
+    /** Set of service ids known from services.csv (for service-edge resolution). */
+    readonly knownServiceIds: ReadonlySet<string>;
+    /** Set of canonical_repo_keys known from repositories.csv. */
+    readonly knownRepoKeys: ReadonlySet<string>;
+    /** Already-emitted feature ids from earlier sources — grounding rows lose on collision. */
+    readonly existingFeatureIds: ReadonlySet<string>;
+    /** Optional alias map for display-name → canonical-id translation. */
+    readonly aliases: LoadedAliases | null;
+}
+export interface FeatureGroundingResult {
+    readonly featureRows: CatalogueRow[];
+    readonly capabilityFeatureRows: CatalogueRow[];
+    readonly featureRepoRows: CatalogueRow[];
+    readonly featureServiceRows: CatalogueRow[];
+}
+export declare function buildFeatureGrounding(inputs: FeatureGroundingInputs): Promise<FeatureGroundingResult>;
+//# sourceMappingURL=feature-grounding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feature-grounding.d.ts","sourceRoot":"","sources":["../../../../src/lib/catalogue/builders/feature-grounding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAsB5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD,gFAAgF;IAChF,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,2FAA2F;IAC3F,QAAQ,CAAC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjD,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,YAAY,EAAE,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,YAAY,EAAE,CAAC;CAC7C;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAiIjC"}

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

@@ -0,0 +1,312 @@
+/**
+ * Feature-grounding extractor per ADR 0143 (schema 2.5.0).
+ *
+ * Walks `docs/domains/<dom>/design/<capability>/feature-grounding.md`
+ * (platform-profile) and `docs/design/integration/feature-grounding.md`
+ * (integration-product), parses the canonical markdown table, and
+ * emits four catalogue contributions:
+ *
+ *   - `features.csv` rows with `source: feature-grounding`.
+ *   - `capability_feature.csv` rows (1:1 with each feature row).
+ *   - `feature_repo.csv` rows derived from file-path references in
+ *     the Evidence column.
+ *   - `feature_service.csv` rows derived from class names / file
+ *     basenames / route fragments in API Routes / Backend Handlers
+ *     / Evidence columns, resolved via `services.csv` + the optional
+ *     per-SDD alias map.
+ *
+ * Resolution failures (unresolved capability, service, repo) emit
+ * findings but never break FK validation — only confidently-resolved
+ * rows are emitted.
+ *
+ * Precedence per ADR 0143 §4.4: feature-tree and feature-spec rows
+ * win on id collision; grounding rows are skipped with a divergence
+ * finding.
+ */
+import { readFile } from "node:fs/promises";
+import { relative } from "node:path";
+import { capabilityIdFromPath, findIntegrationGroundingFile, findPlatformGroundingFiles, parseGroundingTable, } from "./feature-grounding-walker.js";
+const DESCRIPTION_MAX = 500;
+/** Columns the service-name resolver scans for class names / route fragments. */
+const SERVICE_RESOLUTION_COLUMNS = [
+    "ui_components",
+    "api_routes",
+    "backend_handlers",
+    "evidence",
+];
+/** Columns the repo-name resolver scans for file-path references. */
+const REPO_RESOLUTION_COLUMNS = ["evidence", "ui_components"];
+export async function buildFeatureGrounding(inputs) {
+    const featureRows = [];
+    const capabilityFeatureRows = [];
+    const featureRepoRows = [];
+    const featureServiceRows = [];
+    const seenFeatureRepo = new Set();
+    const seenFeatureService = new Set();
+    const seenFeatures = new Set(inputs.existingFeatureIds);
+    const files = [];
+    if (inputs.profile === "platform-profile") {
+        for (const absPath of await findPlatformGroundingFiles(inputs.sddPath)) {
+            const capId = capabilityIdFromPath(absPath, inputs.sddPath);
+            files.push({ absPath, capabilityId: capId });
+        }
+    }
+    else if (inputs.profile === "integration-product") {
+        const absPath = await findIntegrationGroundingFile(inputs.sddPath);
+        if (absPath !== null) {
+            // For integration-product, the integration itself is the
+            // capability surface; use the SDD's product id.
+            files.push({ absPath, capabilityId: inputs.productId });
+        }
+    }
+    for (const { absPath, capabilityId } of files) {
+        const relPath = relative(inputs.sddPath, absPath);
+        if (capabilityId === "") {
+            inputs.findings.add("convention", `${relPath}: capability id could not be resolved from file path`);
+            continue;
+        }
+        if (!inputs.knownCapabilityIds.has(capabilityId)) {
+            inputs.findings.add("convention", `${relPath}: capability "${capabilityId}" from file path does not resolve against capabilities.csv`);
+            continue;
+        }
+        const text = await readFile(absPath, "utf-8");
+        const rows = parseGroundingTable(text);
+        if (rows.length === 0) {
+            inputs.findings.add("coverage", `${relPath}: feature-grounding.md found but no recognisable Feature-to-Code Mapping table`);
+            continue;
+        }
+        const slugsInThisFile = new Set();
+        for (const row of rows) {
+            if (slugsInThisFile.has(row.slug)) {
+                inputs.findings.add("divergence", `${relPath}:${row.lineNumber}: duplicate feature slug "${row.slug}" in same file (first occurrence wins)`);
+                continue;
+            }
+            slugsInThisFile.add(row.slug);
+            const featureId = `${capabilityId}-${row.slug}`;
+            if (seenFeatures.has(featureId)) {
+                inputs.findings.add("divergence", `${relPath}:${row.lineNumber}: feature id "${featureId}" already emitted by an earlier source (feature-tree / feature-spec wins)`);
+                continue;
+            }
+            seenFeatures.add(featureId);
+            featureRows.push({
+                id: featureId,
+                name: row.slug,
+                product_id: "",
+                capability_id: capabilityId,
+                parent_group_id: "",
+                parent_feature_id: "",
+                description: deriveDescription(row),
+                maturity: "",
+                status: "active",
+                source: "feature-grounding",
+                runway: "",
+                source_sdd_id: "",
+            });
+            const cfId = `${capabilityId}__${featureId}`;
+            capabilityFeatureRows.push({
+                id: cfId,
+                capability_id: capabilityId,
+                feature_id: featureId,
+            });
+            // feature_service edges
+            const services = resolveServices(row, inputs);
+            for (const serviceId of services) {
+                const edgeId = `${featureId}__${serviceId}`;
+                if (seenFeatureService.has(edgeId))
+                    continue;
+                seenFeatureService.add(edgeId);
+                featureServiceRows.push({
+                    id: edgeId,
+                    feature_id: featureId,
+                    service_id: serviceId,
+                });
+            }
+            // feature_repo edges
+            const repos = resolveRepos(row, inputs);
+            for (const repoKey of repos) {
+                const edgeId = `${featureId}__${repoKey}`;
+                if (seenFeatureRepo.has(edgeId))
+                    continue;
+                seenFeatureRepo.add(edgeId);
+                featureRepoRows.push({
+                    id: edgeId,
+                    feature_id: featureId,
+                    repo_id: repoKey,
+                });
+            }
+        }
+    }
+    return {
+        featureRows,
+        capabilityFeatureRows,
+        featureRepoRows,
+        featureServiceRows,
+    };
+}
+/**
+ * Build the description column by joining non-feature cells, capped at
+ * 500 chars to match the feature-tree bullet convention.
+ */
+function deriveDescription(row) {
+    const parts = [];
+    for (const [key, value] of row.cells) {
+        if (value === "")
+            continue;
+        parts.push(`${prettyHeader(key)}: ${value}`);
+    }
+    const joined = parts.join(" • ");
+    return joined.length > DESCRIPTION_MAX
+        ? joined.slice(0, DESCRIPTION_MAX)
+        : joined;
+}
+function prettyHeader(key) {
+    return key
+        .split("_")
+        .map((p) => (p.length === 0 ? p : p[0].toUpperCase() + p.slice(1)))
+        .join(" ");
+}
+/**
+ * Resolve service ids referenced in a row's cells. Strategy:
+ *  - Tokenize backtick-quoted identifiers + CamelCase / kebab-case tokens.
+ *  - Strip extensions (.ts/.java/.yaml/.kt/.py) and trailing parens.
+ *  - Try exact match against services.id (lowercased).
+ *  - Try alias map (case-sensitive — display names often carry case).
+ */
+function resolveServices(row, inputs) {
+    const out = new Set();
+    for (const col of SERVICE_RESOLUTION_COLUMNS) {
+        const cell = row.cells.get(col) ?? "";
+        if (cell === "")
+            continue;
+        for (const token of tokenize(cell)) {
+            const resolved = resolveServiceToken(token, inputs);
+            if (resolved !== null)
+                out.add(resolved);
+        }
+    }
+    return [...out].sort();
+}
+function resolveServiceToken(rawToken, inputs) {
+    // Try alias first (case-sensitive).
+    if (inputs.aliases !== null) {
+        const aliased = inputs.aliases.serviceAliases.get(rawToken);
+        if (aliased !== undefined && inputs.knownServiceIds.has(aliased)) {
+            return aliased;
+        }
+    }
+    // Normalise + try exact match.
+    const normalised = normaliseToken(rawToken);
+    if (normalised === "")
+        return null;
+    if (inputs.knownServiceIds.has(normalised))
+        return normalised;
+    // Try alias on normalised form too.
+    if (inputs.aliases !== null) {
+        const aliased = inputs.aliases.serviceAliases.get(normalised);
+        if (aliased !== undefined && inputs.knownServiceIds.has(aliased)) {
+            return aliased;
+        }
+    }
+    return null;
+}
+/**
+ * Resolve repo ids from file-path references. Strategy:
+ *  - Tokenize path-like spans (contain `/` or end in known extensions).
+ *  - For each token: try longest-prefix match against
+ *    `canonical_repo_key`s; e.g. `connect-app-shell-api-master@abc/src/...`
+ *    → `connect-app-shell-api` (after stripping branch/sha suffix).
+ *  - Also accept the alias map for display-name → canonical-key.
+ */
+function resolveRepos(row, inputs) {
+    const out = new Set();
+    for (const col of REPO_RESOLUTION_COLUMNS) {
+        const cell = row.cells.get(col) ?? "";
+        if (cell === "")
+            continue;
+        for (const token of tokenize(cell)) {
+            const resolved = resolveRepoToken(token, inputs);
+            if (resolved !== null)
+                out.add(resolved);
+        }
+    }
+    return [...out].sort();
+}
+function resolveRepoToken(rawToken, inputs) {
+    // Try alias first.
+    if (inputs.aliases !== null) {
+        const aliased = inputs.aliases.repoAliases.get(rawToken);
+        if (aliased !== undefined && inputs.knownRepoKeys.has(aliased)) {
+            return aliased;
+        }
+    }
+    // Direct match on the full token (rare).
+    if (inputs.knownRepoKeys.has(rawToken))
+        return rawToken;
+    // Walk every path segment and try to recover a repo key. Each
+    // segment may carry a `-master@<sha>` or `@<sha>` suffix; strip
+    // those before matching.
+    for (const segment of rawToken.split("/")) {
+        const stripped = segment
+            .replace(/-master@.*$/, "")
+            .replace(/@[^/]+$/, "");
+        if (stripped !== "" && inputs.knownRepoKeys.has(stripped)) {
+            return stripped;
+        }
+        // Also try the segment with the `-master` literal removed (no @sha).
+        const trailingMaster = stripped.replace(/-master$/, "");
+        if (trailingMaster !== stripped &&
+            inputs.knownRepoKeys.has(trailingMaster)) {
+            return trailingMaster;
+        }
+    }
+    return null;
+}
+/**
+ * Extract candidate identifier tokens from a markdown cell. Matches:
+ *  - Backticked spans: `` `AuthHandler.handleLoginRequest()` ``
+ *  - Bare identifiers: `MasternauthOauthService`
+ *  - kebab-case identifiers: `connect-app-shell-api`
+ *  - Path-like tokens with at least one `/`.
+ * Strips leading method names (e.g. `AuthHandler.foo()` → `AuthHandler`).
+ */
+function tokenize(cell) {
+    const out = new Set();
+    // Backticked spans.
+    for (const match of cell.matchAll(/`([^`]+)`/g)) {
+        const inner = match[1] ?? "";
+        addCandidatesFromToken(inner, out);
+    }
+    // Bare identifiers outside backticks — strip backtick spans first.
+    const stripped = cell.replace(/`[^`]+`/g, " ");
+    for (const match of stripped.matchAll(/[A-Za-z][A-Za-z0-9._@/-]*[A-Za-z0-9]/g)) {
+        addCandidatesFromToken(match[0], out);
+    }
+    return [...out];
+}
+function addCandidatesFromToken(token, out) {
+    if (token === "")
+        return;
+    // Path token: take first segment as a candidate AND keep the full path.
+    if (token.includes("/")) {
+        out.add(token);
+        const first = token.split("/")[0] ?? "";
+        if (first !== "" && first !== token)
+            out.add(first);
+        return;
+    }
+    // Method/class form: split on `.`, contribute each segment except (), [].
+    const head = token.split(/[(.[]/)[0] ?? "";
+    if (head !== "")
+        out.add(head);
+    // Also keep the full token for alias-map matching on exact display
+    // strings like `AuthHandler.handleLoginRequest`.
+    out.add(token);
+}
+function normaliseToken(token) {
+    return token
+        .toLowerCase()
+        .replace(/\.(ts|tsx|js|jsx|java|kt|kts|py|go|rs|yaml|yml|json|md)$/i, "")
+        .replace(/\(\)$/, "")
+        .trim();
+}
+//# sourceMappingURL=feature-grounding.js.map

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

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

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

@@ -22,6 +22,10 @@ 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 { buildFeatureGrounding } from "./feature-grounding.js";
+export type { FeatureGroundingInputs, FeatureGroundingResult, } from "./feature-grounding.js";
+export { buildCapabilitySpec } from "./capability-spec.js";
+export type { CapabilitySpecInputs, CapabilitySpecResult, } from "./capability-spec.js";
 export { buildContracts } from "./contracts.js";
 export type { ContractsBuildInputs, ContractsBuildResult, } from "./contracts.js";
 export { buildRepoEdges } from "./repo-edges.js";
@@ -32,6 +36,8 @@ 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 { buildServiceContractConsumes } from "./service-contract-consumes.js";
+export type { ServiceContractConsumesInputs } from "./service-contract-consumes.js";
 export { buildGlossaryItems } from "./glossary.js";
 export type { GlossaryItemsBuildInputs, GlossaryItemsResult, } from "./glossary.js";
 export { buildGlossaryXref } from "./glossary-xref.js";