@sdd-method/sdd-cli 0.9.0

package/dist/lib/mcp/resources/adrs.js

@@ -0,0 +1,97 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpEnvelopeError } from "../errors.js";
+import { parseAdrMetadata } from "../parse/frontmatter.js";
+import { discoverAdrs, findAdr, safeIsFile } from "../parse/paths.js";
+export function register(server, sddRoot) {
+    server.registerResource("adr-catalogue", "sdd://adrs/catalogue", {
+        title: "ADR catalogue",
+        description: "Machine-readable summary of every ADR discovered under docs/method/adr, docs/platform/adr, and docs/domains/{domain}/adr.",
+        mimeType: "application/json",
+    }, async () => {
+        const adrs = discoverAdrs(sddRoot);
+        const entries = adrs.map((a) => {
+            const metadata = parseAdrMetadata(readFileSync(a.path, "utf8"));
+            return {
+                number: a.number,
+                scope: a.scope,
+                title: metadata.title || a.title,
+                status: metadata.status ?? null,
+                date: metadata.date ?? null,
+                decision_type: metadata.decisionType ?? null,
+                path: a.path,
+                uri: `sdd://adrs/${a.scope}/${a.number}`,
+            };
+        });
+        const catalogueRelPath = join("docs", "method", "architecture-decisions.md");
+        const cataloguePath = join(sddRoot, catalogueRelPath);
+        const payload = {
+            sdd_root: sddRoot,
+            catalogue_doc: safeIsFile(cataloguePath)
+                ? catalogueRelPath
+                : null,
+            total: entries.length,
+            adrs: entries,
+        };
+        return {
+            contents: [
+                {
+                    uri: "sdd://adrs/catalogue",
+                    mimeType: "application/json",
+                    text: JSON.stringify(payload, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerResource("adr", new ResourceTemplate("sdd://adrs/{scope}/{number}", {
+        list: async () => {
+            const adrs = discoverAdrs(sddRoot);
+            return {
+                resources: adrs.map((a) => ({
+                    uri: `sdd://adrs/${a.scope}/${a.number}`,
+                    name: `ADR ${a.number} — ${a.title}`,
+                    mimeType: "text/markdown",
+                })),
+            };
+        },
+    }), {
+        title: "ADR",
+        description: "Full markdown body of an ADR identified by scope (method / platform / domain:<name>) and four-digit number.",
+        mimeType: "text/markdown",
+    }, async (uri, { scope, number }) => {
+        if (typeof scope !== "string" || typeof number !== "string") {
+            throw new McpEnvelopeError({
+                code: "ADR_URI_INVALID",
+                message: `ADR URI ${uri.href} is missing required {scope} or {number} parameters.`,
+                remediation: "Use the shape sdd://adrs/{scope}/{number} where scope is one of: method, platform, domain:<name>.",
+                context: { uri: uri.href },
+            });
+        }
+        const adr = findAdr(sddRoot, scope, number);
+        if (!adr) {
+            throw new McpEnvelopeError({
+                code: "ADR_NOT_FOUND",
+                message: `No ADR found for scope=${scope} number=${number} under SDD root ${sddRoot}.`,
+                remediation: "Verify the ADR number is zero-padded to 4 digits (e.g. 0128) and the scope matches where the ADR lives. Call sdd://adrs/catalogue to see every ADR the server can find.",
+                context: {
+                    scope,
+                    number,
+                    sdd_root: sddRoot,
+                    hint: "sdd://adrs/catalogue",
+                },
+            });
+        }
+        const body = readFileSync(adr.path, "utf8");
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: body,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=adrs.js.map

package/dist/lib/mcp/resources/adrs.js.map

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

package/dist/lib/mcp/resources/data-models.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Domain data-model artefacts. In the method's conventions a data
+ * model lives at docs/domains/{domain}/architecture/data-model.mermaid.md.
+ * Absent in the canonical method repo; populated in adopter SDDs.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+interface DiscoveredDataModel {
+    readonly domain: string;
+    readonly path: string;
+}
+export declare function discoverDataModels(sddRoot: string): DiscoveredDataModel[];
+export {};
+//# sourceMappingURL=data-models.d.ts.map

package/dist/lib/mcp/resources/data-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-models.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/resources/data-models.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AAIjD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAoDjE;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAkBzE"}

package/dist/lib/mcp/resources/data-models.js

@@ -0,0 +1,81 @@
+/**
+ * Domain data-model artefacts. In the method's conventions a data
+ * model lives at docs/domains/{domain}/architecture/data-model.mermaid.md.
+ * Absent in the canonical method repo; populated in adopter SDDs.
+ */
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpEnvelopeError } from "../errors.js";
+import { safeIsDir, safeIsFile } from "../parse/paths.js";
+export function register(server, sddRoot) {
+    server.registerResource("data-model", new ResourceTemplate("sdd://data-models/domain/{domain}", {
+        list: async () => {
+            const models = discoverDataModels(sddRoot);
+            return {
+                resources: models.map((m) => ({
+                    uri: `sdd://data-models/domain/${m.domain}`,
+                    name: `Data model: ${m.domain}`,
+                    mimeType: "text/markdown",
+                })),
+            };
+        },
+    }), {
+        title: "Domain data model",
+        description: "Mermaid data model for a given domain, from docs/domains/{domain}/architecture/data-model.mermaid.md.",
+        mimeType: "text/markdown",
+    }, async (uri, { domain }) => {
+        if (typeof domain !== "string") {
+            throw new McpEnvelopeError({
+                code: "DATA_MODEL_URI_INVALID",
+                message: `Data-model URI ${uri.href} is missing the {domain} parameter.`,
+                remediation: "Use the shape sdd://data-models/domain/{domain}. List available domains via resources/list.",
+                context: { uri: uri.href },
+            });
+        }
+        const path = dataModelPath(sddRoot, domain);
+        if (!safeIsFile(path)) {
+            throw new McpEnvelopeError({
+                code: "DATA_MODEL_NOT_FOUND",
+                message: `No data model for domain ${domain} under SDD root ${sddRoot}.`,
+                remediation: "Domain data models are adopter-instantiated (ADR 0112) and may be absent in the canonical method repo. Query resources/list to see which data models this SDD exposes.",
+                context: { domain, expected_path: path, sdd_root: sddRoot },
+            });
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: readFileSync(path, "utf8"),
+                },
+            ],
+        };
+    });
+}
+export function discoverDataModels(sddRoot) {
+    const out = [];
+    const domainsRoot = join(sddRoot, "docs", "domains");
+    if (!safeIsDir(domainsRoot))
+        return out;
+    let domains;
+    try {
+        domains = readdirSync(domainsRoot);
+    }
+    catch {
+        return out;
+    }
+    for (const domain of domains) {
+        if (domain.startsWith("_"))
+            continue;
+        const path = dataModelPath(sddRoot, domain);
+        if (safeIsFile(path)) {
+            out.push({ domain, path });
+        }
+    }
+    return out;
+}
+function dataModelPath(sddRoot, domain) {
+    return join(sddRoot, "docs", "domains", domain, "architecture", "data-model.mermaid.md");
+}
+//# sourceMappingURL=data-models.js.map

package/dist/lib/mcp/resources/data-models.js.map

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

package/dist/lib/mcp/resources/gates.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Gate-registry resource. Each gate's YAML file is exposed under
+ * sdd://gates/{gate-name}. The payload includes schema metadata, the
+ * pass threshold, and all scored entries. Summary counts are computed
+ * on the fly for callers that want a quick overview.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=gates.d.ts.map

package/dist/lib/mcp/resources/gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/resources/gates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA8DjE"}

package/dist/lib/mcp/resources/gates.js

@@ -0,0 +1,90 @@
+/**
+ * Gate-registry resource. Each gate's YAML file is exposed under
+ * sdd://gates/{gate-name}. The payload includes schema metadata, the
+ * pass threshold, and all scored entries. Summary counts are computed
+ * on the fly for callers that want a quick overview.
+ */
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpEnvelopeError } from "../errors.js";
+import { listGates, readGateRegistry } from "../parse/gate-registry.js";
+export function register(server, sddRoot) {
+    server.registerResource("gate", new ResourceTemplate("sdd://gates/{gate}", {
+        list: async () => {
+            const gates = listGates(sddRoot);
+            return {
+                resources: gates.map((gate) => ({
+                    uri: `sdd://gates/${gate}`,
+                    name: `Gate registry: ${gate}`,
+                    mimeType: "application/json",
+                })),
+            };
+        },
+    }), {
+        title: "Gate registry",
+        description: "Structured view of orchestration/gate-registry/{gate}-scores.yaml. Includes schema version, pass threshold, per-artefact entries, and a small summary count.",
+        mimeType: "application/json",
+    }, async (uri, { gate }) => {
+        if (typeof gate !== "string") {
+            throw new McpEnvelopeError({
+                code: "GATE_URI_INVALID",
+                message: `Gate URI ${uri.href} is missing the {gate} parameter.`,
+                remediation: "Use the shape sdd://gates/{gate}. Call resources/list to see the gates this SDD exposes.",
+                context: { uri: uri.href },
+            });
+        }
+        const registry = readGateRegistry(sddRoot, gate);
+        if (!registry) {
+            throw new McpEnvelopeError({
+                code: "GATE_NOT_FOUND",
+                message: `No gate registry for ${gate} under SDD root ${sddRoot}.`,
+                remediation: "Check the spelling (e.g. adr-quality, contract-quality, intent-quality). resources/list lists the available gates.",
+                context: { gate, sdd_root: sddRoot },
+            });
+        }
+        const summary = summarise(registry.entries);
+        const payload = {
+            gate,
+            schema_version: registry.schemaVersion,
+            description: registry.description,
+            pass_threshold: registry.passThreshold,
+            summary,
+            entries: registry.entries,
+            path: registry.path,
+        };
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(payload, null, 2),
+                },
+            ],
+        };
+    });
+}
+function summarise(entries) {
+    let total = 0;
+    let pass = 0;
+    let conditional = 0;
+    let fail = 0;
+    let unscored = 0;
+    for (const value of Object.values(entries)) {
+        total++;
+        if (value && typeof value === "object") {
+            const gateVal = value["gate"];
+            if (gateVal === "pass")
+                pass++;
+            else if (gateVal === "conditional")
+                conditional++;
+            else if (gateVal === "fail")
+                fail++;
+            else
+                unscored++;
+        }
+        else {
+            unscored++;
+        }
+    }
+    return { total, pass, conditional, fail, unscored };
+}
+//# sourceMappingURL=gates.js.map

package/dist/lib/mcp/resources/gates.js.map

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

package/dist/lib/mcp/resources/glossary.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Glossary resource. In adopter SDDs the platform glossary lives at
+ * docs/platform/reference/platform-glossary.md and per-domain
+ * glossaries at docs/domains/{domain}/reference/{domain}-glossary.md.
+ * Canonical method repo has no populated glossary; this server returns
+ * a structured NOT_FOUND when queried against such a repo.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+interface DiscoveredGlossary {
+    readonly scope: string;
+    readonly path: string;
+}
+export declare function discoverGlossaries(sddRoot: string): DiscoveredGlossary[];
+export {};
+//# sourceMappingURL=glossary.d.ts.map

package/dist/lib/mcp/resources/glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/resources/glossary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AAIjD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAoDjE;AAED,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAkCxE"}

package/dist/lib/mcp/resources/glossary.js

@@ -0,0 +1,87 @@
+/**
+ * Glossary resource. In adopter SDDs the platform glossary lives at
+ * docs/platform/reference/platform-glossary.md and per-domain
+ * glossaries at docs/domains/{domain}/reference/{domain}-glossary.md.
+ * Canonical method repo has no populated glossary; this server returns
+ * a structured NOT_FOUND when queried against such a repo.
+ */
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpEnvelopeError } from "../errors.js";
+import { safeIsDir, safeIsFile } from "../parse/paths.js";
+export function register(server, sddRoot) {
+    server.registerResource("glossary", new ResourceTemplate("sdd://glossary/{scope}", {
+        list: async () => {
+            const entries = discoverGlossaries(sddRoot);
+            return {
+                resources: entries.map((e) => ({
+                    uri: `sdd://glossary/${e.scope}`,
+                    name: `Glossary: ${e.scope}`,
+                    mimeType: "text/markdown",
+                })),
+            };
+        },
+    }), {
+        title: "Glossary",
+        description: "Glossary for the requested scope. Scope is `platform` or `<domain>` (e.g. `party`).",
+        mimeType: "text/markdown",
+    }, async (uri, { scope }) => {
+        if (typeof scope !== "string") {
+            throw new McpEnvelopeError({
+                code: "GLOSSARY_URI_INVALID",
+                message: `Glossary URI ${uri.href} is missing the {scope} parameter.`,
+                remediation: "Use the shape sdd://glossary/{scope}. Call resources/list to see the glossaries this SDD exposes.",
+                context: { uri: uri.href },
+            });
+        }
+        const path = glossaryPath(sddRoot, scope);
+        if (!path) {
+            throw new McpEnvelopeError({
+                code: "GLOSSARY_NOT_FOUND",
+                message: `No glossary for scope ${scope} under SDD root ${sddRoot}.`,
+                remediation: "Glossaries are adopter-instantiated. The canonical method repo does not ship a populated glossary; resources/list shows what this SDD exposes.",
+                context: { scope, sdd_root: sddRoot },
+            });
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: readFileSync(path, "utf8"),
+                },
+            ],
+        };
+    });
+}
+export function discoverGlossaries(sddRoot) {
+    const out = [];
+    const platformPath = join(sddRoot, "docs", "platform", "reference", "platform-glossary.md");
+    if (safeIsFile(platformPath)) {
+        out.push({ scope: "platform", path: platformPath });
+    }
+    const domainsRoot = join(sddRoot, "docs", "domains");
+    if (safeIsDir(domainsRoot)) {
+        let domains = [];
+        try {
+            domains = readdirSync(domainsRoot);
+        }
+        catch {
+            // ignore
+        }
+        for (const domain of domains) {
+            if (domain.startsWith("_"))
+                continue;
+            const domainGlossary = join(domainsRoot, domain, "reference", `${domain}-glossary.md`);
+            if (safeIsFile(domainGlossary)) {
+                out.push({ scope: domain, path: domainGlossary });
+            }
+        }
+    }
+    return out;
+}
+function glossaryPath(sddRoot, scope) {
+    return discoverGlossaries(sddRoot).find((g) => g.scope === scope)?.path;
+}
+//# sourceMappingURL=glossary.js.map

package/dist/lib/mcp/resources/glossary.js.map

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

package/dist/lib/mcp/resources/specs.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Capability and feature specs. The MCP plan references the URIs
+ * sdd://specs/capability/{domain}/{capability} and
+ * sdd://specs/feature/{domain}/{capability}/{feature}; the on-disk
+ * layout is adopter-driven (docs/domains/{d}/product/{capability}.md
+ * and similar). Phase 1 does a best-effort discovery under
+ * docs/domains/{d}/product/ and exposes found specs; absent specs
+ * surface as a structured NOT_FOUND with a pointer to the catalogue.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+interface CapabilitySpec {
+    readonly domain: string;
+    readonly capability: string;
+    readonly path: string;
+}
+export declare function discoverCapabilitySpecs(sddRoot: string): CapabilitySpec[];
+interface FeatureSpec extends CapabilitySpec {
+    readonly feature: string;
+}
+export declare function discoverFeatureSpecs(sddRoot: string): FeatureSpec[];
+export {};
+//# sourceMappingURL=specs.d.ts.map

package/dist/lib/mcp/resources/specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/resources/specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AAKjD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA+EjE;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAiBzE;AAED,UAAU,WAAY,SAAQ,cAAc;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAsBnE"}

package/dist/lib/mcp/resources/specs.js

@@ -0,0 +1,151 @@
+/**
+ * Capability and feature specs. The MCP plan references the URIs
+ * sdd://specs/capability/{domain}/{capability} and
+ * sdd://specs/feature/{domain}/{capability}/{feature}; the on-disk
+ * layout is adopter-driven (docs/domains/{d}/product/{capability}.md
+ * and similar). Phase 1 does a best-effort discovery under
+ * docs/domains/{d}/product/ and exposes found specs; absent specs
+ * surface as a structured NOT_FOUND with a pointer to the catalogue.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpEnvelopeError } from "../errors.js";
+import { safeIsDir, safeIsFile } from "../parse/paths.js";
+import { readdirSync } from "node:fs";
+export function register(server, sddRoot) {
+    server.registerResource("capability-spec", new ResourceTemplate("sdd://specs/capability/{domain}/{capability}", {
+        list: async () => {
+            const specs = discoverCapabilitySpecs(sddRoot);
+            return {
+                resources: specs.map((s) => ({
+                    uri: `sdd://specs/capability/${s.domain}/${s.capability}`,
+                    name: `Capability spec: ${s.domain} / ${s.capability}`,
+                    mimeType: "text/markdown",
+                })),
+            };
+        },
+    }), {
+        title: "Capability spec",
+        description: "Capability-level specification for a given domain. Read from the first matching docs/domains/{domain}/product/{capability}*.md file.",
+        mimeType: "text/markdown",
+    }, async (uri, { domain, capability }) => {
+        if (typeof domain !== "string" || typeof capability !== "string") {
+            throw invalidArgs(uri.href);
+        }
+        const path = findCapabilitySpec(sddRoot, domain, capability);
+        if (!path) {
+            throw notFound("CAPABILITY_SPEC_NOT_FOUND", `No capability spec found for ${domain}/${capability}.`, { domain, capability, sdd_root: sddRoot });
+        }
+        return readMarkdown(uri.href, path);
+    });
+    server.registerResource("feature-spec", new ResourceTemplate("sdd://specs/feature/{domain}/{capability}/{feature}", {
+        list: async () => {
+            const specs = discoverFeatureSpecs(sddRoot);
+            return {
+                resources: specs.map((s) => ({
+                    uri: `sdd://specs/feature/${s.domain}/${s.capability}/${s.feature}`,
+                    name: `Feature spec: ${s.domain} / ${s.capability} / ${s.feature}`,
+                    mimeType: "text/markdown",
+                })),
+            };
+        },
+    }), {
+        title: "Feature spec",
+        description: "Feature-level specification nested under a capability. Read from docs/domains/{domain}/product/{capability}/{feature}*.md.",
+        mimeType: "text/markdown",
+    }, async (uri, { domain, capability, feature }) => {
+        if (typeof domain !== "string" ||
+            typeof capability !== "string" ||
+            typeof feature !== "string") {
+            throw invalidArgs(uri.href);
+        }
+        const path = findFeatureSpec(sddRoot, domain, capability, feature);
+        if (!path) {
+            throw notFound("FEATURE_SPEC_NOT_FOUND", `No feature spec found for ${domain}/${capability}/${feature}.`, { domain, capability, feature, sdd_root: sddRoot });
+        }
+        return readMarkdown(uri.href, path);
+    });
+}
+export function discoverCapabilitySpecs(sddRoot) {
+    const out = [];
+    const domainsRoot = join(sddRoot, "docs", "domains");
+    if (!safeIsDir(domainsRoot))
+        return out;
+    for (const domain of safeReaddir(domainsRoot)) {
+        if (domain.startsWith("_"))
+            continue;
+        const productDir = join(domainsRoot, domain, "product");
+        if (!safeIsDir(productDir))
+            continue;
+        for (const entry of safeReaddir(productDir)) {
+            const full = join(productDir, entry);
+            if (entry.endsWith(".md") && safeIsFile(full)) {
+                const slug = entry.replace(/\.md$/, "");
+                out.push({ domain, capability: slug, path: full });
+            }
+        }
+    }
+    return out;
+}
+export function discoverFeatureSpecs(sddRoot) {
+    const out = [];
+    const caps = discoverCapabilitySpecs(sddRoot);
+    for (const cap of caps) {
+        const nestedDir = join(sddRoot, "docs", "domains", cap.domain, "product", cap.capability);
+        if (!safeIsDir(nestedDir))
+            continue;
+        for (const entry of safeReaddir(nestedDir)) {
+            const full = join(nestedDir, entry);
+            if (entry.endsWith(".md") && safeIsFile(full)) {
+                const feature = entry.replace(/\.md$/, "");
+                out.push({ ...cap, feature, path: full });
+            }
+        }
+    }
+    return out;
+}
+function findCapabilitySpec(sddRoot, domain, capability) {
+    return discoverCapabilitySpecs(sddRoot).find((s) => s.domain === domain && s.capability === capability)?.path;
+}
+function findFeatureSpec(sddRoot, domain, capability, feature) {
+    return discoverFeatureSpecs(sddRoot).find((s) => s.domain === domain &&
+        s.capability === capability &&
+        s.feature === feature)?.path;
+}
+function readMarkdown(uri, path) {
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "text/markdown",
+                text: readFileSync(path, "utf8"),
+            },
+        ],
+    };
+}
+function invalidArgs(uri) {
+    return new McpEnvelopeError({
+        code: "SPEC_URI_INVALID",
+        message: `Spec URI ${uri} is missing required template parameters.`,
+        remediation: "Check the URI shape: sdd://specs/capability/{domain}/{capability} or sdd://specs/feature/{domain}/{capability}/{feature}.",
+        context: { uri },
+    });
+}
+function notFound(code, message, ctx) {
+    return new McpEnvelopeError({
+        code,
+        message,
+        remediation: "Spec files are adopter-instantiated and may be absent in the canonical method repo. Query the discovered list via the MCP resources/list operation to see which specs this SDD exposes.",
+        context: ctx,
+    });
+}
+function safeReaddir(dir) {
+    try {
+        return readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=specs.js.map

package/dist/lib/mcp/resources/specs.js.map

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

package/dist/lib/mcp/resources/version.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=version.d.ts.map

package/dist/lib/mcp/resources/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/resources/version.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgCjE"}