@sdd-method/sdd-cli 0.9.0

package/dist/lib/mcp/tools/find-dependents.js

@@ -0,0 +1,89 @@
+/**
+ * find_dependents — given a service name, return services downstream
+ * of it: those that name it as an internal dependency, consume a
+ * contract it produces, or have an execution-map edge pointing at it.
+ */
+import { z } from "zod";
+import { McpEnvelopeError } from "../errors.js";
+import { readerFor } from "../pin/index.js";
+import { getSddIndex } from "../../sdd-index/index.js";
+export function register(server, sddRoot) {
+    server.registerTool("find_dependents", {
+        title: "Find dependents",
+        description: "List services downstream of a given service — those that depend on it directly (via repo-config), consume a contract it produces, or point at it in the execution-dependency-map.",
+        inputSchema: {
+            service: z
+                .string()
+                .min(1)
+                .describe("Service id (matches the repo-config `repo` field)."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or ref) to pin the SDD to."),
+        },
+    }, async ({ service, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        const index = getSddIndex(reader);
+        if (!index.services.has(service)) {
+            throw new McpEnvelopeError({
+                code: "SERVICE_NOT_FOUND",
+                message: `No service named '${service}' in the SDD index.`,
+                remediation: `Check spelling. Known services: ${Array.from(index.services.keys()).sort().join(", ") || "(none)"}.`,
+                context: {
+                    service,
+                    known: Array.from(index.services.keys()).sort(),
+                },
+            });
+        }
+        const directDependents = [];
+        for (const [id, other] of index.services) {
+            if (other.internalDependencies.includes(service)) {
+                directDependents.push({
+                    service: id,
+                    domain: other.domain,
+                    via: "internal_dependency",
+                });
+            }
+        }
+        const contractsProduced = Array.from(index.contracts.values()).filter((c) => c.producers.includes(service));
+        const contractDependents = [];
+        for (const node of contractsProduced) {
+            for (const consumer of node.consumers) {
+                const consumerSvc = index.services.get(consumer);
+                const ref = consumerSvc?.contracts.find((c) => c.path === node.path);
+                contractDependents.push({
+                    service: consumer,
+                    contract_path: node.path,
+                    version_pin: ref?.version ?? null,
+                    stability: ref?.stability ?? null,
+                });
+            }
+        }
+        const executionEdges = index.executionEdges
+            .filter((e) => e.to === service)
+            .map((e) => ({
+            from: e.from,
+            kind: e.kind,
+            note: e.note ?? null,
+        }));
+        const payload = {
+            query: { service },
+            dependents: {
+                direct: directDependents,
+                contract_consumers: contractDependents,
+                execution_edges: executionEdges,
+            },
+            pin_to_commit: reader.pin,
+            sources: [
+                `sdd://repo-config/${index.services.get(service)?.domain}/${service}`,
+                ...(contractsProduced.length > 0
+                    ? contractsProduced.map((c) => `sdd://contracts/${c.path}`)
+                    : []),
+            ],
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=find-dependents.js.map

package/dist/lib/mcp/tools/find-dependents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-dependents.js","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/find-dependents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,OAAe;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,mLAAmL;QACrL,WAAW,EAAE;YACX,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,oDAAoD,CAAC;YACjE,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,iDAAiD,CAAC;SAC/D;KACF,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,gBAAgB,CAAC;gBACzB,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,qBAAqB,OAAO,qBAAqB;gBAC1D,WAAW,EAAE,mCAAmC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,GAAG;gBAClH,OAAO,EAAE;oBACP,OAAO;oBACP,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;iBAChD;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,gBAAgB,GAIhB,EAAE,CAAC;QACT,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjD,gBAAgB,CAAC,IAAI,CAAC;oBACpB,OAAO,EAAE,EAAE;oBACX,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,GAAG,EAAE,qBAAqB;iBAC3B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACnE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CACrC,CAAC;QACF,MAAM,kBAAkB,GAKlB,EAAE,CAAC;QACT,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;YACrC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtC,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACjD,MAAM,GAAG,GAAG,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrE,kBAAkB,CAAC,IAAI,CAAC;oBACtB,OAAO,EAAE,QAAQ;oBACjB,aAAa,EAAE,IAAI,CAAC,IAAI;oBACxB,WAAW,EAAE,GAAG,EAAE,OAAO,IAAI,IAAI;oBACjC,SAAS,EAAE,GAAG,EAAE,SAAS,IAAI,IAAI;iBAClC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc;aACxC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;SACrB,CAAC,CAAC,CAAC;QAEN,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,EAAE,OAAO,EAAE;YAClB,UAAU,EAAE;gBACV,MAAM,EAAE,gBAAgB;gBACxB,kBAAkB,EAAE,kBAAkB;gBACtC,eAAe,EAAE,cAAc;aAChC;YACD,aAAa,EAAE,MAAM,CAAC,GAAG;YACzB,OAAO,EAAE;gBACP,qBAAqB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,OAAO,EAAE;gBACrE,GAAG,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;oBAC9B,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC3D,CAAC,CAAC,EAAE,CAAC;aACR;SACF,CAAC;QACF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/lib/mcp/tools/find-producers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * find_producers — given an aggregate name or event name, return the
+ * services that own / publish it. Backed by the SDD index's
+ * `producers` map.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=find-producers.d.ts.map

package/dist/lib/mcp/tools/find-producers.d.ts.map

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

package/dist/lib/mcp/tools/find-producers.js

@@ -0,0 +1,57 @@
+/**
+ * find_producers — given an aggregate name or event name, return the
+ * services that own / publish it. Backed by the SDD index's
+ * `producers` map.
+ */
+import { z } from "zod";
+import { readerFor } from "../pin/index.js";
+import { getSddIndex } from "../../sdd-index/index.js";
+export function register(server, sddRoot) {
+    server.registerTool("find_producers", {
+        title: "Find producers",
+        description: "Given an aggregate name or event name, return the services that publish it. A service is classed as producer when it owns an aggregate the contract describes.",
+        inputSchema: {
+            target: z
+                .string()
+                .min(1)
+                .describe("Aggregate name or event name. Case-sensitive."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or ref) to pin the SDD to."),
+        },
+    }, async ({ target, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        const index = getSddIndex(reader);
+        const producers = index.producers.get(target) ?? [];
+        const matches = producers.map((serviceId) => {
+            const svc = index.services.get(serviceId);
+            const contracts = svc?.contracts ?? [];
+            const refMatching = contracts.find((c) => {
+                const node = index.contracts.get(c.path);
+                return (node?.producedAggregates.includes(target) ||
+                    node?.producedEvents.includes(target));
+            });
+            return {
+                service: serviceId,
+                domain: svc?.domain ?? null,
+                owns_aggregate: svc?.aggregates.includes(target) ?? false,
+                contract_path: refMatching?.path ?? null,
+                version_pin: refMatching?.version ?? null,
+                stability: refMatching?.stability ?? null,
+            };
+        });
+        const payload = {
+            query: { target },
+            matches,
+            total: matches.length,
+            pin_to_commit: reader.pin,
+            sources: Array.from(new Set(matches.map((m) => m.contract_path).filter(Boolean))).map((p) => `sdd://contracts/${p}`),
+            metadata_incomplete: matches.length > 0 && matches.every((m) => !m.contract_path),
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=find-producers.js.map

package/dist/lib/mcp/tools/find-producers.js.map

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

package/dist/lib/mcp/tools/find-related-specs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * find_related_specs — given an entity name (e.g. an aggregate, an
+ * event, a ubiquitous term), return every spec / ADR / glossary that
+ * references it by literal substring match. Case-insensitive; counts
+ * occurrences per document; no tokenisation.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=find-related-specs.d.ts.map

package/dist/lib/mcp/tools/find-related-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-related-specs.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/find-related-specs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgGjE"}

package/dist/lib/mcp/tools/find-related-specs.js

@@ -0,0 +1,92 @@
+/**
+ * find_related_specs — given an entity name (e.g. an aggregate, an
+ * event, a ubiquitous term), return every spec / ADR / glossary that
+ * references it by literal substring match. Case-insensitive; counts
+ * occurrences per document; no tokenisation.
+ */
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+import { discoverAdrs } from "../parse/paths.js";
+import { readerFor } from "../pin/index.js";
+import { discoverCapabilitySpecs, discoverFeatureSpecs } from "../resources/specs.js";
+import { discoverGlossaries } from "../resources/glossary.js";
+export function register(server, sddRoot) {
+    server.registerTool("find_related_specs", {
+        title: "Find related specs",
+        description: "Locate every ADR, spec, or glossary entry that references a given entity by literal substring match.",
+        inputSchema: {
+            entity_name: z
+                .string()
+                .min(1)
+                .describe("Entity name to search for (case-insensitive substring)."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or any ref) to pin the SDD to. When set, the server reads from a git worktree at that commit rather than the working tree."),
+        },
+    }, async ({ entity_name, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        const needle = entity_name.toLowerCase();
+        const docs = [];
+        for (const adr of discoverAdrs(reader.sddRoot)) {
+            docs.push({
+                uri: `sdd://adrs/${adr.scope}/${adr.number}`,
+                path: adr.path,
+                kind: "adr",
+            });
+        }
+        for (const c of discoverCapabilitySpecs(reader.sddRoot)) {
+            docs.push({
+                uri: `sdd://specs/capability/${c.domain}/${c.capability}`,
+                path: c.path,
+                kind: "capability",
+            });
+        }
+        for (const f of discoverFeatureSpecs(reader.sddRoot)) {
+            docs.push({
+                uri: `sdd://specs/feature/${f.domain}/${f.capability}/${f.feature}`,
+                path: f.path,
+                kind: "feature",
+            });
+        }
+        for (const g of discoverGlossaries(reader.sddRoot)) {
+            docs.push({
+                uri: `sdd://glossary/${g.scope}`,
+                path: g.path,
+                kind: "glossary",
+            });
+        }
+        const matches = [];
+        for (const doc of docs) {
+            let body;
+            try {
+                body = readFileSync(doc.path, "utf8");
+            }
+            catch {
+                continue;
+            }
+            const lower = body.toLowerCase();
+            let count = 0;
+            let idx = 0;
+            while ((idx = lower.indexOf(needle, idx)) !== -1) {
+                count++;
+                idx += needle.length;
+            }
+            if (count > 0) {
+                matches.push({ uri: doc.uri, kind: doc.kind, occurrences: count });
+            }
+        }
+        matches.sort((a, b) => b.occurrences - a.occurrences);
+        const payload = {
+            entity_name,
+            total: matches.length,
+            matches,
+            sources: matches.map((m) => m.uri),
+            pin_to_commit: reader.pin,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=find-related-specs.js.map

package/dist/lib/mcp/tools/find-related-specs.js.map

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

package/dist/lib/mcp/tools/list-adrs.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=list-adrs.d.ts.map

package/dist/lib/mcp/tools/list-adrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-adrs.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/list-adrs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA2EjE"}

package/dist/lib/mcp/tools/list-adrs.js

@@ -0,0 +1,73 @@
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+import { parseAdrMetadata } from "../parse/frontmatter.js";
+import { discoverAdrs } from "../parse/paths.js";
+import { readerFor } from "../pin/index.js";
+export function register(server, sddRoot) {
+    server.registerTool("list_adrs", {
+        title: "List ADRs",
+        description: "Enumerate ADRs discovered under docs/method/adr, docs/platform/adr, and docs/domains/{domain}/adr. Optionally filter by scope prefix or status.",
+        inputSchema: {
+            scope: z
+                .string()
+                .optional()
+                .describe("Filter by ADR scope: 'method', 'platform', or 'domain' (matches any domain:*)"),
+            status: z
+                .string()
+                .optional()
+                .describe("Filter by ADR status (Accepted / Proposed / Superseded / Deprecated / Deferred). Case-insensitive."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or any ref) to pin the SDD to. When set, the server reads from a git worktree at that commit rather than the working tree."),
+        },
+    }, async ({ scope, status, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        const wantScope = scope?.toLowerCase();
+        const wantStatus = status?.toLowerCase();
+        const adrs = discoverAdrs(reader.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,
+                uri: `sdd://adrs/${a.scope}/${a.number}`,
+            };
+        })
+            .filter((e) => {
+            if (wantScope) {
+                if (wantScope === "domain") {
+                    if (!e.scope.startsWith("domain:"))
+                        return false;
+                }
+                else if (e.scope !== wantScope) {
+                    return false;
+                }
+            }
+            if (wantStatus && (e.status ?? "").toLowerCase() !== wantStatus) {
+                return false;
+            }
+            return true;
+        });
+        const payload = {
+            sdd_root: sddRoot,
+            filters: {
+                scope: scope ?? null,
+                status: status ?? null,
+            },
+            count: entries.length,
+            adrs: entries,
+            sources: ["sdd://adrs/catalogue"],
+            pin_to_commit: reader.pin,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=list-adrs.js.map

package/dist/lib/mcp/tools/list-adrs.js.map

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

package/dist/lib/mcp/tools/query-gate-status.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=query-gate-status.d.ts.map

package/dist/lib/mcp/tools/query-gate-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-gate-status.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/query-gate-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAoEjE"}

package/dist/lib/mcp/tools/query-gate-status.js

@@ -0,0 +1,82 @@
+import { z } from "zod";
+import { McpEnvelopeError } from "../errors.js";
+import { listGates, readGateRegistry } from "../parse/gate-registry.js";
+import { readerFor } from "../pin/index.js";
+export function register(server, sddRoot) {
+    server.registerTool("query_gate_status", {
+        title: "Query gate status",
+        description: "Read the status of a specific gate from orchestration/gate-registry/{gate}-scores.yaml. Returns summary counts plus scoped entries.",
+        inputSchema: {
+            gate: z
+                .string()
+                .describe("Gate name, e.g. adr-quality, contract-quality, intent-quality, feature-grounding, domain-architecture, c4-diagram, strategic-doc, traceability-manifest, user-story, work-order"),
+            scope: z
+                .string()
+                .optional()
+                .describe("Optional filter applied to entry keys (substring match, case-insensitive). Useful for narrowing e.g. to a specific domain or ADR number."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or any ref) to pin the SDD to. When set, the server reads from a git worktree at that commit rather than the working tree."),
+        },
+    }, async ({ gate, scope, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        const registry = readGateRegistry(reader.sddRoot, gate);
+        if (!registry) {
+            throw new McpEnvelopeError({
+                code: "GATE_NOT_FOUND",
+                message: `No gate registry for ${gate} under SDD root ${reader.sddRoot}.`,
+                remediation: `Check the gate name — available gates in this SDD: ${listGates(reader.sddRoot).join(", ") || "(none)"}.`,
+                context: {
+                    gate,
+                    available: listGates(reader.sddRoot),
+                    sdd_root: reader.sddRoot,
+                },
+            });
+        }
+        const wantScope = scope?.toLowerCase();
+        const entries = wantScope
+            ? Object.fromEntries(Object.entries(registry.entries).filter(([k]) => k.toLowerCase().includes(wantScope)))
+            : registry.entries;
+        const summary = summarise(entries);
+        const payload = {
+            gate,
+            scope_filter: scope ?? null,
+            schema_version: registry.schemaVersion,
+            pass_threshold: registry.passThreshold,
+            summary,
+            entries,
+            sources: [`sdd://gates/${gate}`],
+            pin_to_commit: reader.pin,
+        };
+        return {
+            content: [{ type: "text", 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=query-gate-status.js.map

package/dist/lib/mcp/tools/query-gate-status.js.map

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

package/dist/lib/mcp/tools/search-specs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * search_specs — plain-text search across ADRs, capability specs,
+ * feature specs, and glossaries. Scores by count of query-token
+ * occurrences in each document body; returns top N with a snippet.
+ *
+ * Deliberately simple for Phase 1: no fuzzy matching, no stemming, no
+ * BM25. Upgrade path is to drop in fuse.js or a proper index in a
+ * later phase if precision becomes an issue.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=search-specs.d.ts.map

package/dist/lib/mcp/tools/search-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-specs.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/search-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAyGjE"}

package/dist/lib/mcp/tools/search-specs.js

@@ -0,0 +1,151 @@
+/**
+ * search_specs — plain-text search across ADRs, capability specs,
+ * feature specs, and glossaries. Scores by count of query-token
+ * occurrences in each document body; returns top N with a snippet.
+ *
+ * Deliberately simple for Phase 1: no fuzzy matching, no stemming, no
+ * BM25. Upgrade path is to drop in fuse.js or a proper index in a
+ * later phase if precision becomes an issue.
+ */
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+import { discoverAdrs } from "../parse/paths.js";
+import { readerFor } from "../pin/index.js";
+import { discoverCapabilitySpecs, discoverFeatureSpecs } from "../resources/specs.js";
+import { discoverGlossaries } from "../resources/glossary.js";
+export function register(server, sddRoot) {
+    server.registerTool("search_specs", {
+        title: "Search specs",
+        description: "Plain-text search across ADRs, capability specs, feature specs, and glossaries. Returns ranked matches with URIs and short snippets.",
+        inputSchema: {
+            query: z.string().min(1).describe("Free-text query. Tokenised by whitespace; case-insensitive."),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Maximum number of hits to return. Default 10."),
+            kinds: z
+                .array(z.enum(["adr", "capability", "feature", "glossary"]))
+                .optional()
+                .describe("Restrict the search to specific document kinds."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or any ref) to pin the SDD to. When set, the server reads from a git worktree at that commit rather than the working tree."),
+        },
+    }, async ({ query, limit, kinds, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        const tokens = query
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((t) => t.length > 0);
+        if (tokens.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ query, matches: [], sources: [], pin_to_commit: reader.pin }, null, 2),
+                    },
+                ],
+            };
+        }
+        const activeKinds = new Set(kinds ?? ["adr", "capability", "feature", "glossary"]);
+        const docs = collectDocuments(reader.sddRoot, activeKinds);
+        const cap = limit ?? 10;
+        const hits = [];
+        for (const doc of docs) {
+            let body;
+            try {
+                body = readFileSync(doc.path, "utf8");
+            }
+            catch {
+                continue;
+            }
+            const lower = body.toLowerCase();
+            let score = 0;
+            for (const token of tokens) {
+                let idx = 0;
+                while ((idx = lower.indexOf(token, idx)) !== -1) {
+                    score++;
+                    idx += token.length;
+                }
+            }
+            if (score === 0)
+                continue;
+            hits.push({
+                uri: doc.uri,
+                kind: doc.kind,
+                score,
+                snippet: buildSnippet(body, lower, tokens[0]),
+            });
+        }
+        hits.sort((a, b) => b.score - a.score);
+        const top = hits.slice(0, cap);
+        const payload = {
+            query,
+            kinds: Array.from(activeKinds),
+            limit: cap,
+            total_hits: hits.length,
+            returned: top.length,
+            matches: top,
+            sources: top.map((h) => h.uri),
+            pin_to_commit: reader.pin,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+function collectDocuments(sddRoot, kinds) {
+    const out = [];
+    if (kinds.has("adr")) {
+        for (const adr of discoverAdrs(sddRoot)) {
+            out.push({
+                uri: `sdd://adrs/${adr.scope}/${adr.number}`,
+                path: adr.path,
+                kind: "adr",
+            });
+        }
+    }
+    if (kinds.has("capability")) {
+        for (const c of discoverCapabilitySpecs(sddRoot)) {
+            out.push({
+                uri: `sdd://specs/capability/${c.domain}/${c.capability}`,
+                path: c.path,
+                kind: "capability",
+            });
+        }
+    }
+    if (kinds.has("feature")) {
+        for (const f of discoverFeatureSpecs(sddRoot)) {
+            out.push({
+                uri: `sdd://specs/feature/${f.domain}/${f.capability}/${f.feature}`,
+                path: f.path,
+                kind: "feature",
+            });
+        }
+    }
+    if (kinds.has("glossary")) {
+        for (const g of discoverGlossaries(sddRoot)) {
+            out.push({
+                uri: `sdd://glossary/${g.scope}`,
+                path: g.path,
+                kind: "glossary",
+            });
+        }
+    }
+    return out;
+}
+function buildSnippet(body, bodyLower, firstToken) {
+    const idx = bodyLower.indexOf(firstToken);
+    if (idx === -1)
+        return body.slice(0, 160);
+    const start = Math.max(0, idx - 60);
+    const end = Math.min(body.length, idx + firstToken.length + 60);
+    const prefix = start === 0 ? "" : "…";
+    const suffix = end === body.length ? "" : "…";
+    return prefix + body.slice(start, end).replace(/\s+/g, " ").trim() + suffix;
+}
+//# sourceMappingURL=search-specs.js.map