@sdd-method/sdd-cli 1.43.0 → 1.44.0

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

@@ -1,89 +0,0 @@
-/**
- * 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

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

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

@@ -1,8 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,57 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,9 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,92 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,3 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,73 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,3 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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,CAgFjE"}

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

@@ -1,68 +0,0 @@
-import { z } from "zod";
-import { McpEnvelopeError } from "../errors.js";
-import { listGates, readGateRegistry, summariseGateEntries } 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,
-                },
-            });
-        }
-        // A malformed registry must never read as a clean, empty one. Reported
-        // through the envelope contract like every other failure on this surface
-        // — before the fix it threw a raw YAMLParseError straight through.
-        if (registry.parseError !== null) {
-            throw new McpEnvelopeError({
-                code: "GATE_REGISTRY_UNPARSEABLE",
-                message: `Gate registry ${registry.path} is not parseable YAML: ${registry.parseError}`,
-                remediation: "Repair the registry. Two shapes account for every case seen so far: a container mixing mapping entries with sequence entries, and a duplicate key — the latter silently discards one of two judgments in parsers that tolerate it, so treat a duplicate as two contradictory verdicts, not a typo.",
-                context: { gate, path: registry.path, parse_error: registry.parseError },
-            });
-        }
-        const wantScope = scope?.toLowerCase();
-        const entries = wantScope
-            ? Object.fromEntries(Object.entries(registry.entries).filter(([k]) => k.toLowerCase().includes(wantScope)))
-            : registry.entries;
-        const summary = summariseGateEntries(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) }],
-        };
-    });
-}
-//# sourceMappingURL=query-gate-status.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"query-gate-status.js","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/query-gate-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,OAAe;IACzD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,qIAAqI;QACvI,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,iLAAiL,CAClL;YACH,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,0IAA0I,CAC3I;YACH,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,iJAAiJ,CAClJ;SACJ;KACF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,gBAAgB,CAAC;gBACzB,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,wBAAwB,IAAI,mBAAmB,MAAM,CAAC,OAAO,GAAG;gBACzE,WAAW,EAAE,sDAAsD,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,GAAG;gBACtH,OAAO,EAAE;oBACP,IAAI;oBACJ,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;oBACpC,QAAQ,EAAE,MAAM,CAAC,OAAO;iBACzB;aACF,CAAC,CAAC;QACL,CAAC;QACD,uEAAuE;QACvE,yEAAyE;QACzE,mEAAmE;QACnE,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,gBAAgB,CAAC;gBACzB,IAAI,EAAE,2BAA2B;gBACjC,OAAO,EAAE,iBAAiB,QAAQ,CAAC,IAAI,2BAA2B,QAAQ,CAAC,UAAU,EAAE;gBACvF,WAAW,EACT,oSAAoS;gBACtS,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,UAAU,EAAE;aACzE,CAAC,CAAC;QACL,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,EAAE,WAAW,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,SAAS;YACvB,CAAC,CAAC,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CACpC,CACF;YACH,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QAErB,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAE9C,MAAM,OAAO,GAAG;YACd,IAAI;YACJ,YAAY,EAAE,KAAK,IAAI,IAAI;YAC3B,cAAc,EAAE,QAAQ,CAAC,aAAa;YACtC,cAAc,EAAE,QAAQ,CAAC,aAAa;YACtC,OAAO;YACP,OAAO;YACP,OAAO,EAAE,CAAC,eAAe,IAAI,EAAE,CAAC;YAChC,aAAa,EAAE,MAAM,CAAC,GAAG;SAC1B,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/search-specs.d.ts

@@ -1,12 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,151 +0,0 @@
-/**
- * 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

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

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