@sdd-method/sdd-cli 0.9.0

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

@@ -0,0 +1,45 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { DISTRIBUTION, MCP_PROTOCOL_SPEC_VERSION, SERVER_VERSION, } from "../build-info.js";
+export function register(server, sddRoot) {
+    server.registerResource("method-version", "sdd://method/version", {
+        title: "Method version",
+        description: "Method distribution version, server build, SDD commit, and MCP protocol spec version. Clients read this at session start to detect mismatches.",
+        mimeType: "application/json",
+    }, async () => {
+        const payload = {
+            method_version: SERVER_VERSION,
+            distribution: DISTRIBUTION,
+            server_build: new Date().toISOString(),
+            sdd_repo_commit: await readHeadCommit(sddRoot),
+            protocol: {
+                name: "mcp",
+                spec_version: MCP_PROTOCOL_SPEC_VERSION,
+            },
+        };
+        return {
+            contents: [
+                {
+                    uri: "sdd://method/version",
+                    mimeType: "application/json",
+                    text: JSON.stringify(payload, null, 2),
+                },
+            ],
+        };
+    });
+}
+async function readHeadCommit(sddRoot) {
+    try {
+        const headRef = (await readFile(join(sddRoot, ".git", "HEAD"), "utf8")).trim();
+        if (headRef.startsWith("ref: ")) {
+            const refPath = headRef.slice("ref: ".length);
+            const sha = (await readFile(join(sddRoot, ".git", refPath), "utf8")).trim();
+            return sha || null;
+        }
+        return headRef || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=version.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../src/lib/mcp/resources/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,OAAe;IACzD,MAAM,CAAC,gBAAgB,CACrB,gBAAgB,EAChB,sBAAsB,EACtB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,gJAAgJ;QAClJ,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,OAAO,GAAG;YACd,cAAc,EAAE,cAAc;YAC9B,YAAY,EAAE,YAAY;YAC1B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,eAAe,EAAE,MAAM,cAAc,CAAC,OAAO,CAAC;YAC9C,QAAQ,EAAE;gBACR,IAAI,EAAE,KAAK;gBACX,YAAY,EAAE,yBAAyB;aACxC;SACF,CAAC;QACF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,sBAAsB;oBAC3B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,CACd,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CACtD,CAAC,IAAI,EAAE,CAAC;QACT,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,GAAG,GAAG,CACV,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CACvD,CAAC,IAAI,EAAE,CAAC;YACT,OAAO,GAAG,IAAI,IAAI,CAAC;QACrB,CAAC;QACD,OAAO,OAAO,IAAI,IAAI,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/lib/mcp/server.d.ts

@@ -0,0 +1,29 @@
+/**
+ * sdd-mcp server lifecycle: construct the McpServer, register the
+ * minimum Phase 1 surface, wire stdio transport, and wait for the host
+ * to close the connection.
+ *
+ * Logging discipline: NEVER write to stdout in this module or anything
+ * it calls. stdout is the MCP protocol channel; any non-protocol byte
+ * corrupts the wire. Use stderr for diagnostics.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface RunMcpServeOptions {
+    readonly cwd?: string;
+    readonly sddRepo?: string;
+    readonly env?: NodeJS.ProcessEnv;
+    /**
+     * Connect the server and return immediately instead of waiting for
+     * the transport to close. Used by the integration tests, which
+     * attach their own in-memory transports and drive the server
+     * programmatically.
+     */
+    readonly testMode?: boolean;
+}
+export interface RunMcpServeResult {
+    readonly server: McpServer;
+    /** Resolved SDD absolute path. */
+    readonly sddRepoPath: string;
+}
+export declare function runMcpServe(opts?: RunMcpServeOptions): Promise<RunMcpServeResult>;
+//# sourceMappingURL=server.d.ts.map

package/dist/lib/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/lib/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BpE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,WAAW,CAC/B,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAsF5B"}

package/dist/lib/mcp/server.js

@@ -0,0 +1,104 @@
+/**
+ * sdd-mcp server lifecycle: construct the McpServer, register the
+ * minimum Phase 1 surface, wire stdio transport, and wait for the host
+ * to close the connection.
+ *
+ * Logging discipline: NEVER write to stdout in this module or anything
+ * it calls. stdout is the MCP protocol channel; any non-protocol byte
+ * corrupts the wire. Use stderr for diagnostics.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SERVER_VERSION } from "./build-info.js";
+import { envelopeFromUnknown } from "./errors.js";
+import { register as registerAdrs } from "./resources/adrs.js";
+import { register as registerDataModels } from "./resources/data-models.js";
+import { register as registerGates } from "./resources/gates.js";
+import { register as registerGlossary } from "./resources/glossary.js";
+import { register as registerSpecs } from "./resources/specs.js";
+import { register as registerVersion } from "./resources/version.js";
+import { register as registerCascadeImpact } from "./tools/cascade-impact.js";
+import { register as registerFindConsumers } from "./tools/find-consumers.js";
+import { register as registerFindConsumersOfContract } from "./tools/find-consumers-of-contract.js";
+import { register as registerFindDependencies } from "./tools/find-dependencies.js";
+import { register as registerFindDependents } from "./tools/find-dependents.js";
+import { register as registerFindProducers } from "./tools/find-producers.js";
+import { register as registerFindRelatedSpecs } from "./tools/find-related-specs.js";
+import { register as registerListAdrs } from "./tools/list-adrs.js";
+import { register as registerQueryGateStatus } from "./tools/query-gate-status.js";
+import { register as registerSearchSpecs } from "./tools/search-specs.js";
+import { registerAllPrompts } from "./prompts/index.js";
+import { resolveSddRepo } from "./workspace.js";
+import { shutdownPinSubsystem } from "./pin/index.js";
+import { liveReader } from "./reader.js";
+import { startIndexWatcher } from "../sdd-index/watch.js";
+export async function runMcpServe(opts = {}) {
+    const env = opts.env ?? process.env;
+    const cwd = opts.cwd ?? process.cwd();
+    let sddRepoPath;
+    try {
+        const resolved = resolveSddRepo({
+            cwd,
+            env,
+            ...(opts.sddRepo ? { flagPath: opts.sddRepo } : {}),
+        });
+        sddRepoPath = resolved.path;
+        process.stderr.write(`[sdd-mcp] SDD repo resolved via ${resolved.source}: ${resolved.path}\n`);
+    }
+    catch (err) {
+        const envelope = envelopeFromUnknown(err);
+        process.stderr.write(`[sdd-mcp] fatal: ${envelope.code} — ${envelope.message}\n` +
+            `[sdd-mcp] remediation: ${envelope.remediation}\n`);
+        throw err;
+    }
+    const server = new McpServer({
+        name: "sdd-mcp",
+        version: SERVER_VERSION,
+    }, {
+        capabilities: {
+            resources: {},
+            tools: {},
+            prompts: {},
+        },
+    });
+    registerVersion(server, sddRepoPath);
+    registerAdrs(server, sddRepoPath);
+    registerSpecs(server, sddRepoPath);
+    registerDataModels(server, sddRepoPath);
+    registerGates(server, sddRepoPath);
+    registerGlossary(server, sddRepoPath);
+    registerListAdrs(server, sddRepoPath);
+    registerQueryGateStatus(server, sddRepoPath);
+    registerSearchSpecs(server, sddRepoPath);
+    registerFindRelatedSpecs(server, sddRepoPath);
+    registerFindConsumers(server, sddRepoPath);
+    registerFindProducers(server, sddRepoPath);
+    registerFindDependencies(server, sddRepoPath);
+    registerFindDependents(server, sddRepoPath);
+    registerFindConsumersOfContract(server, sddRepoPath);
+    registerCascadeImpact(server, sddRepoPath);
+    registerAllPrompts(server, sddRepoPath);
+    if (opts.testMode) {
+        return { server, sddRepoPath };
+    }
+    const watcher = startIndexWatcher(liveReader(sddRepoPath));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Wait until the host closes stdio. McpServer owns the transport
+    // lifecycle; when the parent exits or closes stdin, the transport
+    // fires onclose and this promise resolves.
+    await new Promise((resolveDone) => {
+        transport.onclose = () => {
+            resolveDone();
+        };
+        const onSignal = () => {
+            void server.close().finally(() => resolveDone());
+        };
+        process.once("SIGTERM", onSignal);
+        process.once("SIGINT", onSignal);
+    });
+    watcher.stop();
+    shutdownPinSubsystem();
+    return { server, sddRepoPath };
+}
+//# sourceMappingURL=server.js.map

package/dist/lib/mcp/server.js.map

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

package/dist/lib/mcp/tools/cascade-impact.d.ts

@@ -0,0 +1,22 @@
+/**
+ * cascade_impact — dry-run the cascade-update checklist for a
+ * proposed change. Thin wrapper around the shared library function
+ * in `src/lib/sdd-index/cascade.ts` so the Phase 5 `evaluate_cascade`
+ * prompt and this tool agree on behaviour.
+ *
+ * Per [ADR 0128] §4.5 this tool *reports* cascade status; it never
+ * enforces — enforcement stays with hooks and CI.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+export declare const cascadeImpactArgsSchema: {
+    change_type: z.ZodEnum<{
+        capability: "capability";
+        service: "service";
+        entity: "entity";
+    }>;
+    target: z.ZodString;
+    pin_to_commit: z.ZodOptional<z.ZodString>;
+};
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=cascade-impact.d.ts.map

package/dist/lib/mcp/tools/cascade-impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-impact.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/cascade-impact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,uBAAuB;;;;;;;;CAkBnC,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA6BjE"}

package/dist/lib/mcp/tools/cascade-impact.js

@@ -0,0 +1,53 @@
+/**
+ * cascade_impact — dry-run the cascade-update checklist for a
+ * proposed change. Thin wrapper around the shared library function
+ * in `src/lib/sdd-index/cascade.ts` so the Phase 5 `evaluate_cascade`
+ * prompt and this tool agree on behaviour.
+ *
+ * Per [ADR 0128] §4.5 this tool *reports* cascade status; it never
+ * enforces — enforcement stays with hooks and CI.
+ */
+import { z } from "zod";
+import { McpEnvelopeError } from "../errors.js";
+import { readerFor } from "../pin/index.js";
+import { CascadeImpactError, runCascadeImpact, } from "../../sdd-index/cascade.js";
+export const cascadeImpactArgsSchema = {
+    change_type: z
+        .enum(["service", "capability", "entity"])
+        .describe("What kind of thing is changing: a service, a capability, or a domain-model entity (aggregate/event)."),
+    target: z
+        .string()
+        .min(1)
+        .describe("Name of the changed artefact (service id, capability slug, or entity name)."),
+    pin_to_commit: z
+        .string()
+        .optional()
+        .describe("Optional commit SHA (or ref) to pin the SDD to. Executes the script against a git worktree at that commit."),
+};
+export function register(server, sddRoot) {
+    server.registerTool("cascade_impact", {
+        title: "Cascade impact dry-run",
+        description: "Wrap the adopter's orchestration/scripts/validate-cascade-completeness.sh to report which artefacts a proposed change would cascade through. Decorates script output with per-service metadata from the SDD index. Read-only.",
+        inputSchema: cascadeImpactArgsSchema,
+    }, async ({ change_type, target, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        try {
+            const payload = runCascadeImpact(reader, { change_type, target });
+            return {
+                content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+            };
+        }
+        catch (err) {
+            if (err instanceof CascadeImpactError) {
+                throw new McpEnvelopeError({
+                    code: err.code,
+                    message: err.message,
+                    remediation: err.remediation,
+                    context: err.context,
+                });
+            }
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=cascade-impact.js.map

package/dist/lib/mcp/tools/cascade-impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-impact.js","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/cascade-impact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;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,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;SACzC,QAAQ,CACP,sGAAsG,CACvG;IACH,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,6EAA6E,CAC9E;IACH,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4GAA4G,CAC7G;CACJ,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB,EAAE,OAAe;IACzD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,+NAA+N;QACjO,WAAW,EAAE,uBAAuB;KACrC,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE;QAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;gBACtC,MAAM,IAAI,gBAAgB,CAAC;oBACzB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,WAAW,EAAE,GAAG,CAAC,WAAW;oBAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/lib/mcp/tools/find-consumers-of-contract.d.ts

@@ -0,0 +1,7 @@
+/**
+ * find_consumers_of_contract — given a contract path (relative to the
+ * SDD root), return every service that pins it in their repo-config.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=find-consumers-of-contract.d.ts.map

package/dist/lib/mcp/tools/find-consumers-of-contract.d.ts.map

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

package/dist/lib/mcp/tools/find-consumers-of-contract.js

@@ -0,0 +1,70 @@
+/**
+ * find_consumers_of_contract — given a contract path (relative to the
+ * SDD root), return every service that pins it in their repo-config.
+ */
+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_consumers_of_contract", {
+        title: "Find consumers of contract",
+        description: "Given a contract path (relative to the SDD root), list every service that pins it, with their version range and stability class.",
+        inputSchema: {
+            contract_path: z
+                .string()
+                .min(1)
+                .describe("Contract path relative to the SDD root (e.g. 'contracts/party/party.events.v1.merged.avsc')."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or ref) to pin the SDD to."),
+        },
+    }, async ({ contract_path, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        const index = getSddIndex(reader);
+        const node = index.contracts.get(contract_path);
+        if (!node) {
+            throw new McpEnvelopeError({
+                code: "CONTRACT_NOT_FOUND",
+                message: `No contract at '${contract_path}' found in the SDD index.`,
+                remediation: `The contract must be declared in at least one orchestration/repo-config/**/*.yaml file. Known contracts: ${Array.from(index.contracts.keys()).sort().join(", ") || "(none)"}.`,
+                context: {
+                    contract_path,
+                    known: Array.from(index.contracts.keys()).sort(),
+                },
+            });
+        }
+        const pinsForContract = index.pins.get(contract_path);
+        const consumers = node.consumers.map((id) => {
+            const svc = index.services.get(id);
+            const ref = svc?.contracts.find((c) => c.path === contract_path);
+            return {
+                service: id,
+                domain: svc?.domain ?? null,
+                version_pin: pinsForContract?.get(id) ?? ref?.version ?? null,
+                stability: ref?.stability ?? null,
+                package: ref?.package ?? null,
+            };
+        });
+        const payload = {
+            query: { contract_path },
+            contract: {
+                path: node.path,
+                kind: node.kind,
+                producers: node.producers,
+                produced_aggregates: node.producedAggregates,
+                produced_events: node.producedEvents,
+            },
+            consumers,
+            total: consumers.length,
+            pin_to_commit: reader.pin,
+            sources: [`sdd://contracts/${node.path}`],
+            metadata_incomplete: node.metadataIncomplete,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=find-consumers-of-contract.js.map

package/dist/lib/mcp/tools/find-consumers-of-contract.js.map

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

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

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

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * find_consumers — given an aggregate name or event name, return the
+ * services that consume it. Backed by the SDD index's `consumers` 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_consumers", {
+        title: "Find consumers",
+        description: "Given an aggregate name or event name, return the services that consume it (via contract subscriptions declared in orchestration/repo-config/).",
+        inputSchema: {
+            target: z
+                .string()
+                .min(1)
+                .describe("Aggregate name (e.g. 'Party') or event name (e.g. 'PartyMerged' / 'party.mergedInto'). Case-sensitive."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or ref) to pin the SDD to. Reads from a git worktree at that commit rather than the working tree."),
+        },
+    }, async ({ target, pin_to_commit }) => {
+        const reader = readerFor(sddRoot, pin_to_commit);
+        const index = getSddIndex(reader);
+        const consumers = index.consumers.get(target) ?? [];
+        const matches = consumers.map((serviceId) => {
+            const svc = index.services.get(serviceId);
+            const contracts = svc?.contracts ?? [];
+            const refMatching = contracts.find((c) => index.contracts.get(c.path)?.producedAggregates.includes(target) ||
+                index.contracts.get(c.path)?.producedEvents.includes(target));
+            return {
+                service: serviceId,
+                domain: svc?.domain ?? null,
+                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.some((m) => m.contract_path && !m.version_pin),
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=find-consumers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find-consumers.js","sourceRoot":"","sources":["../../../../src/lib/mcp/tools/find-consumers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,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,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,iJAAiJ;QACnJ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,wGAAwG,CACzG;YACH,aAAa,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,wHAAwH,CACzH;SACJ;KACF,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEpD,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;YAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC;YACvC,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAChE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC/D,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,GAAG,EAAE,MAAM,IAAI,IAAI;gBAC3B,aAAa,EAAE,WAAW,EAAE,IAAI,IAAI,IAAI;gBACxC,WAAW,EAAE,WAAW,EAAE,OAAO,IAAI,IAAI;gBACzC,SAAS,EAAE,WAAW,EAAE,SAAS,IAAI,IAAI;aAC1C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,EAAE,MAAM,EAAE;YACjB,OAAO;YACP,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,aAAa,EAAE,MAAM,CAAC,GAAG;YACzB,OAAO,EAAE,KAAK,CAAC,IAAI,CACjB,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAC7D,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACpC,mBAAmB,EAAE,OAAO,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,WAAW,CACzC;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-dependencies.d.ts

@@ -0,0 +1,8 @@
+/**
+ * find_dependencies — given a service name, return the upstream
+ * services, contracts, and execution-map dependency edges that this
+ * service relies on.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=find-dependencies.d.ts.map

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

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

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

@@ -0,0 +1,89 @@
+/**
+ * find_dependencies — given a service name, return the upstream
+ * services, contracts, and execution-map dependency edges that this
+ * service relies on.
+ */
+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_dependencies", {
+        title: "Find dependencies",
+        description: "List the upstream services, contracts, and execution-map edges a given service depends on (from orchestration/repo-config and docs/platform/execution-dependency-map.md).",
+        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);
+        const svc = index.services.get(service);
+        if (!svc) {
+            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 serviceDeps = svc.internalDependencies.map((id) => {
+            const dep = index.services.get(id);
+            return {
+                service: id,
+                domain: dep?.domain ?? null,
+                kind: "internal",
+            };
+        });
+        const contractDeps = svc.contracts.map((ref) => {
+            const node = index.contracts.get(ref.path);
+            const isOwnProduction = node?.producers.includes(service) ?? false;
+            return {
+                path: ref.path,
+                kind: ref.kind,
+                role: isOwnProduction ? "produces" : "consumes",
+                package: ref.package ?? null,
+                version_pin: ref.version ?? null,
+                stability: ref.stability ?? null,
+                producer: node?.producers[0] ?? null,
+            };
+        });
+        const executionEdges = index.executionEdges
+            .filter((e) => e.from === service)
+            .map((e) => ({
+            to: e.to,
+            kind: e.kind,
+            note: e.note ?? null,
+        }));
+        const payload = {
+            query: { service },
+            service_domain: svc.domain,
+            dependencies: {
+                services: serviceDeps,
+                contracts: contractDeps,
+                execution_edges: executionEdges,
+            },
+            pin_to_commit: reader.pin,
+            sources: [
+                `sdd://repo-config/${svc.domain}/${service}`,
+                ...(index.executionEdges.length > 0
+                    ? ["sdd://execution-dependency-map"]
+                    : []),
+            ],
+            metadata_incomplete: contractDeps.some((c) => c.role === "consumes" && !c.producer),
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=find-dependencies.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * 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 type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=find-dependents.d.ts.map

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

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