@sdd-method/sdd-cli 0.9.0

package/dist/lib/mcp/pin/read.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pinned-SDD materialisation via `git worktree add --detach`.
+ *
+ * The pinned reader is just a liveReader pointed at a temporary
+ * worktree checked out at the resolved SHA. This lets every existing
+ * filesystem helper keep working unchanged, and it's mandatory for
+ * WS5's cascade_impact which shells out to a bash script that expects
+ * a real working tree.
+ *
+ * Cost: one `git worktree add` per (SDD, SHA) pair per server
+ * lifetime. Cached; cleaned up when releasePinnedWorktrees() is called
+ * on shutdown.
+ */
+/**
+ * Ensure a worktree exists for (sddRoot, sha) and return its absolute
+ * path. Reuses an existing cached worktree if present.
+ */
+export declare function materialisePinnedWorktree(sddRoot: string, sha: string): string;
+/**
+ * Remove every cached worktree. Called on server shutdown; safe to
+ * call multiple times.
+ */
+export declare function releasePinnedWorktrees(): void;
+//# sourceMappingURL=read.d.ts.map

package/dist/lib/mcp/pin/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/pin/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,MAAM,CA0BR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAkB7C"}

package/dist/lib/mcp/pin/read.js

@@ -0,0 +1,64 @@
+/**
+ * Pinned-SDD materialisation via `git worktree add --detach`.
+ *
+ * The pinned reader is just a liveReader pointed at a temporary
+ * worktree checked out at the resolved SHA. This lets every existing
+ * filesystem helper keep working unchanged, and it's mandatory for
+ * WS5's cascade_impact which shells out to a bash script that expects
+ * a real working tree.
+ *
+ * Cost: one `git worktree add` per (SDD, SHA) pair per server
+ * lifetime. Cached; cleaned up when releasePinnedWorktrees() is called
+ * on shutdown.
+ */
+import { spawnSync } from "node:child_process";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const cache = new Map();
+/**
+ * Ensure a worktree exists for (sddRoot, sha) and return its absolute
+ * path. Reuses an existing cached worktree if present.
+ */
+export function materialisePinnedWorktree(sddRoot, sha) {
+    const key = `${sddRoot}|${sha}`;
+    const cached = cache.get(key);
+    if (cached)
+        return cached.path;
+    const wtRoot = mkdtempSync(join(tmpdir(), "sdd-mcp-pin-"));
+    const wtPath = join(wtRoot, "sdd");
+    const r = spawnSync("git", ["-C", sddRoot, "worktree", "add", "--detach", "--quiet", wtPath, sha], { encoding: "utf8" });
+    if (r.status !== 0) {
+        try {
+            rmSync(wtRoot, { recursive: true, force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+        throw new Error(`git worktree add failed for ${sha} in ${sddRoot}: ${r.stderr.trim()}`);
+    }
+    cache.set(key, { path: wtPath, sddRoot });
+    return wtPath;
+}
+/**
+ * Remove every cached worktree. Called on server shutdown; safe to
+ * call multiple times.
+ */
+export function releasePinnedWorktrees() {
+    for (const [key, wt] of cache) {
+        try {
+            spawnSync("git", ["-C", wt.sddRoot, "worktree", "remove", "--force", wt.path], { encoding: "utf8" });
+        }
+        catch {
+            /* best-effort */
+        }
+        try {
+            rmSync(wt.path, { recursive: true, force: true });
+        }
+        catch {
+            /* best-effort */
+        }
+        cache.delete(key);
+    }
+}
+//# sourceMappingURL=read.js.map

package/dist/lib/mcp/pin/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../../../src/lib/mcp/pin/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,GAAW;IAEX,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAE/B,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAEnC,MAAM,CAAC,GAAG,SAAS,CACjB,KAAK,EACL,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EACtE,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;IACF,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,+BAA+B,GAAG,OAAO,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CACvE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,SAAS,CACP,KAAK,EACL,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAC5D,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/lib/mcp/pin/resolve.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve a user-supplied pin_to_commit argument to a validated SHA,
+ * confirming the SDD marker file (.sdd-repo-kind) exists at that
+ * tree. Surfaces the structured errors from ./errors.ts rather than
+ * leaking raw git output.
+ */
+export interface ResolvedPin {
+    /** Full 40-char SHA the caller should echo in responses. */
+    readonly sha: string;
+}
+export declare function resolvePin(sddRoot: string, raw: string): ResolvedPin;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/lib/mcp/pin/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/pin/resolve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CA6BpE"}

package/dist/lib/mcp/pin/resolve.js

@@ -0,0 +1,33 @@
+/**
+ * Resolve a user-supplied pin_to_commit argument to a validated SHA,
+ * confirming the SDD marker file (.sdd-repo-kind) exists at that
+ * tree. Surfaces the structured errors from ./errors.ts rather than
+ * leaking raw git output.
+ */
+import { spawnSync } from "node:child_process";
+import { pinNotFound, pinPreMarker, shallowCloneInsufficient, } from "./errors.js";
+export function resolvePin(sddRoot, raw) {
+    const ref = raw.trim();
+    if (ref.length === 0) {
+        throw pinNotFound(raw, sddRoot);
+    }
+    const resolved = spawnSync("git", ["-C", sddRoot, "rev-parse", "--verify", `${ref}^{commit}`], { encoding: "utf8" });
+    if (resolved.status !== 0) {
+        if (isShallow(sddRoot)) {
+            throw shallowCloneInsufficient(ref, sddRoot);
+        }
+        throw pinNotFound(ref, sddRoot);
+    }
+    const sha = resolved.stdout.trim();
+    // Ensure the marker file exists at this tree.
+    const markerCheck = spawnSync("git", ["-C", sddRoot, "cat-file", "-e", `${sha}:.sdd-repo-kind`], { encoding: "utf8" });
+    if (markerCheck.status !== 0) {
+        throw pinPreMarker(sha, sddRoot);
+    }
+    return { sha };
+}
+function isShallow(sddRoot) {
+    const r = spawnSync("git", ["-C", sddRoot, "rev-parse", "--is-shallow-repository"], { encoding: "utf8" });
+    return r.status === 0 && r.stdout.trim() === "true";
+}
+//# sourceMappingURL=resolve.js.map

package/dist/lib/mcp/pin/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../../src/lib/mcp/pin/resolve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,WAAW,EACX,YAAY,EACZ,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAOrB,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,GAAW;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CACxB,KAAK,EACL,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,GAAG,WAAW,CAAC,EAC3D,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,MAAM,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAEnC,8CAA8C;IAC9C,MAAM,WAAW,GAAG,SAAS,CAC3B,KAAK,EACL,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,GAAG,iBAAiB,CAAC,EAC1D,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;IACF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,CAAC,GAAG,SAAS,CACjB,KAAK,EACL,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,yBAAyB,CAAC,EACvD,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;IACF,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;AACtD,CAAC"}

package/dist/lib/mcp/prompts/evaluate-cascade.d.ts

@@ -0,0 +1,14 @@
+/**
+ * evaluate_cascade — walk the agent through the cascade-update
+ * checklist for a proposed change. Shares its argument shape with the
+ * `cascade_impact` tool (via the exported zod schema) and calls the
+ * same underlying library function.
+ *
+ * Errors from the validator are embedded in the returned message
+ * (open-question resolution (b)) rather than thrown — the agent can
+ * surface the error with context instead of receiving an opaque
+ * transport-level failure.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=evaluate-cascade.d.ts.map

package/dist/lib/mcp/prompts/evaluate-cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-cascade.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/prompts/evaluate-cascade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA+DjE"}

package/dist/lib/mcp/prompts/evaluate-cascade.js

@@ -0,0 +1,147 @@
+/**
+ * evaluate_cascade — walk the agent through the cascade-update
+ * checklist for a proposed change. Shares its argument shape with the
+ * `cascade_impact` tool (via the exported zod schema) and calls the
+ * same underlying library function.
+ *
+ * Errors from the validator are embedded in the returned message
+ * (open-question resolution (b)) rather than thrown — the agent can
+ * surface the error with context instead of receiving an opaque
+ * transport-level failure.
+ */
+import { z } from "zod";
+import { CascadeImpactError, runCascadeImpact, } from "../../sdd-index/cascade.js";
+import { readerFor } from "../pin/index.js";
+export function register(server, sddRoot) {
+    server.registerPrompt("evaluate_cascade", {
+        title: "Evaluate cascade for a proposed change",
+        description: "Dry-run the cascade-update checklist (docs/method/methods/cascade-update-checklist.md) for a proposed change. Reports affected services, capabilities, entities, and contracts, plus any missing cascade destinations. Read-only.",
+        argsSchema: {
+            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."),
+        },
+    }, (args) => {
+        const reader = readerFor(sddRoot, args.pin_to_commit);
+        try {
+            const payload = runCascadeImpact(reader, {
+                change_type: args.change_type,
+                target: args.target,
+            });
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: renderCascadeSummary(payload),
+                        },
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            if (err instanceof CascadeImpactError) {
+                return {
+                    messages: [
+                        {
+                            role: "user",
+                            content: {
+                                type: "text",
+                                text: renderCascadeError(err, reader.sddRoot, reader.pin),
+                            },
+                        },
+                    ],
+                };
+            }
+            throw err;
+        }
+    });
+}
+function renderCascadeSummary(payload) {
+    const { query, affected, missing_cascades, links } = payload;
+    const lines = [];
+    lines.push(`**Cascade dry-run for ${query.change_type} \`${query.target}\`** (pin: ${payload.pin_to_commit})`, "", "## Affected artefacts", "");
+    if (affected.services.length === 0) {
+        lines.push("_No services flagged._");
+    }
+    else {
+        lines.push("### Services");
+        lines.push("");
+        for (const svc of affected.services) {
+            const deps = svc.internal_dependencies.length
+                ? ` — deps: ${svc.internal_dependencies.join(", ")}`
+                : "";
+            const aggs = svc.aggregates.length
+                ? ` — aggregates: ${svc.aggregates.join(", ")}`
+                : "";
+            lines.push(`- \`${svc.service}\` (domain: ${svc.domain ?? "(unknown)"})${aggs}${deps}`);
+        }
+        lines.push("");
+    }
+    if (affected.capabilities.length > 0) {
+        lines.push("### Capabilities");
+        for (const c of affected.capabilities)
+            lines.push(`- \`${c}\``);
+        lines.push("");
+    }
+    if (affected.entities.length > 0) {
+        lines.push("### Entities");
+        for (const e of affected.entities)
+            lines.push(`- \`${e}\``);
+        lines.push("");
+    }
+    if (affected.contracts.length > 0) {
+        lines.push("### Contracts");
+        for (const c of affected.contracts)
+            lines.push(`- \`${c}\``);
+        lines.push("");
+    }
+    const missingKeys = Object.keys(missing_cascades);
+    lines.push("## Missing cascades");
+    lines.push("");
+    if (missingKeys.length === 0) {
+        lines.push("_None reported by the validator._");
+        lines.push("");
+    }
+    else {
+        for (const k of missingKeys) {
+            const v = missing_cascades[k];
+            const list = Array.isArray(v) ? v : [];
+            lines.push(`- **${k}:** ${list.length === 0 ? "(none)" : list.join(", ")}`);
+        }
+        lines.push("");
+    }
+    if (links.length > 0) {
+        lines.push("## Evidence links");
+        lines.push("");
+        for (const l of links)
+            lines.push(`- ${l}`);
+        lines.push("");
+    }
+    lines.push("**Reminder:** this is a dry-run. Run the full cascade validator (`orchestration/scripts/validate-cascade-completeness.sh`) before merging to catch anything the impact report missed.");
+    return lines.join("\n");
+}
+function renderCascadeError(err, sddRoot, pin) {
+    return [
+        `**Cascade evaluation failed** (pin: ${pin})`,
+        "",
+        `- **Error code:** \`${err.code}\``,
+        `- **Message:** ${err.message}`,
+        `- **Remediation:** ${err.remediation}`,
+        `- **SDD root:** \`${sddRoot}\``,
+        "",
+        "The agent should surface this error to the user and suggest the",
+        "remediation above. No dry-run output is available until the",
+        "underlying tool is resolved.",
+    ].join("\n");
+}
+//# sourceMappingURL=evaluate-cascade.js.map

package/dist/lib/mcp/prompts/evaluate-cascade.js.map

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

package/dist/lib/mcp/prompts/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Phase 5 prompt registration entry-point. Mirrors the
+ * resources/index.ts and tools/ registration pattern so server.ts
+ * can call a single `registerAllPrompts(server, sddRoot)`.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAllPrompts(server: McpServer, sddRoot: string): void;
+export { TEMPLATES_DIR } from "./template-loader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/mcp/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAU3E;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lib/mcp/prompts/index.js

@@ -0,0 +1,23 @@
+/**
+ * Phase 5 prompt registration entry-point. Mirrors the
+ * resources/index.ts and tools/ registration pattern so server.ts
+ * can call a single `registerAllPrompts(server, sddRoot)`.
+ */
+import { register as registerProposeAdr } from "./propose-adr.js";
+import { register as registerWriteCapabilitySpec } from "./write-capability-spec.js";
+import { register as registerWriteFeatureSpec } from "./write-feature-spec.js";
+import { register as registerWriteWorkOrder } from "./write-work-order.js";
+import { register as registerReviewDataModelChange } from "./review-data-model-change.js";
+import { register as registerEvaluateCascade } from "./evaluate-cascade.js";
+export function registerAllPrompts(server, sddRoot) {
+    // 5a — authoring prompts (Phase-1-only dependency).
+    registerProposeAdr(server, sddRoot);
+    registerWriteCapabilitySpec(server, sddRoot);
+    registerWriteFeatureSpec(server, sddRoot);
+    registerWriteWorkOrder(server, sddRoot);
+    // 5b — impact prompts (Phase-2-dependent).
+    registerReviewDataModelChange(server, sddRoot);
+    registerEvaluateCascade(server, sddRoot);
+}
+export { TEMPLATES_DIR } from "./template-loader.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/mcp/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/mcp/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,QAAQ,IAAI,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,QAAQ,IAAI,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,QAAQ,IAAI,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,OAAe;IACnE,oDAAoD;IACpD,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,2BAA2B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAExC,2CAA2C;IAC3C,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lib/mcp/prompts/propose-adr.d.ts

@@ -0,0 +1,12 @@
+/**
+ * propose_adr — scaffold a new ADR matching the method's house
+ * frontmatter schema. Binds to docs/method/methods/adr-template.md.
+ *
+ * Arguments become an instruction preamble the agent uses to fill
+ * the template (which is embedded verbatim in the returned message).
+ * The rendered draft is not committed; the agent hands it to the
+ * user, who saves it manually as docs/{scope}/adr/ADR NNNN: Title.md.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=propose-adr.d.ts.map

package/dist/lib/mcp/prompts/propose-adr.d.ts.map

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

package/dist/lib/mcp/prompts/propose-adr.js

@@ -0,0 +1,94 @@
+/**
+ * propose_adr — scaffold a new ADR matching the method's house
+ * frontmatter schema. Binds to docs/method/methods/adr-template.md.
+ *
+ * Arguments become an instruction preamble the agent uses to fill
+ * the template (which is embedded verbatim in the returned message).
+ * The rendered draft is not committed; the agent hands it to the
+ * user, who saves it manually as docs/{scope}/adr/ADR NNNN: Title.md.
+ */
+import { z } from "zod";
+import { liveReader } from "../reader.js";
+import { loadTemplate, renderMissingTemplateMessage, templateAt, } from "./template-loader.js";
+const scopeSchema = z
+    .string()
+    .min(1)
+    .describe("ADR scope: 'method', 'platform', or 'domain:<name>' (e.g. 'domain:party').");
+export function register(server, sddRoot) {
+    server.registerPrompt("propose_adr", {
+        title: "Propose an ADR",
+        description: "Scaffold a new ADR draft matching the method's frontmatter schema (validated by orchestration/scripts/validate-adr-structure.sh). Returns a ready-to-fill template the user can save as docs/{scope}/adr/ADR NNNN: Title.md.",
+        argsSchema: {
+            title: z
+                .string()
+                .min(1)
+                .describe("Decision title (e.g. 'Adopt PostgreSQL for event store')."),
+            scope: scopeSchema,
+            decision_type: z
+                .string()
+                .optional()
+                .describe("Optional: architecture-pattern | process | policy | technology-choice | other."),
+            deciders: z
+                .string()
+                .optional()
+                .describe("Optional: named people or group with authority to accept."),
+        },
+    }, (args) => {
+        const reader = liveReader(sddRoot);
+        const location = templateAt("adr-template.md", "ADR template");
+        const loaded = loadTemplate(reader, location);
+        if (loaded === null) {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: renderMissingTemplateMessage(location, reader.sddRoot, reader.pin),
+                        },
+                    },
+                ],
+            };
+        }
+        const preamble = [
+            "Please scaffold a new ADR using the template below. Fill in the",
+            "frontmatter and sections with the values provided; replace any",
+            "remaining placeholder text with concrete content or leave a clear",
+            "`TODO` where the author still needs to think.",
+            "",
+            "**Inputs:**",
+            `- **Title:** ${args.title}`,
+            `- **Scope:** ${args.scope}`,
+            args.decision_type
+                ? `- **Decision Type:** ${args.decision_type}`
+                : "- **Decision Type:** (not provided — fill from the list in the template)",
+            args.deciders
+                ? `- **Deciders:** ${args.deciders}`
+                : "- **Deciders:** (not provided — must be populated before submission)",
+            "",
+            "**Target path:**",
+            `- \`docs/${args.scope.startsWith("domain:") ? `domains/${args.scope.slice("domain:".length)}/adr` : `${args.scope}/adr`}/ADR NNNN: ${args.title}.md\``,
+            "  (replace `NNNN` with the next free number in that directory).",
+            "",
+            "**House-style requirements** (enforced by `orchestration/scripts/validate-adr-structure.sh`):",
+            "- `**Date:**`, `**Status:**`, and `**Deciders:**` metadata bullets are required.",
+            "- `**Status:**` must be one of: Accepted | Proposed | Superseded | Deprecated | Deferred.",
+            "- If Status is Superseded, include a `Superseded by ADR NNNN` reference in the body.",
+            "",
+            "**Template to fill** (verbatim from the SDD):",
+            "",
+            "```markdown",
+            loaded.body.trimEnd(),
+            "```",
+        ].join("\n");
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: { type: "text", text: preamble },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=propose-adr.js.map

package/dist/lib/mcp/prompts/propose-adr.js.map

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

package/dist/lib/mcp/prompts/review-data-model-change.d.ts

@@ -0,0 +1,10 @@
+/**
+ * review_data_model_change — help the agent reason about a proposed
+ * change to a mermaid data model. Identifies entities in the model,
+ * runs `cascade_impact` for each, and includes consumer lookups from
+ * the SDD index so the agent has structured input to shape its
+ * review around.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, sddRoot: string): void;
+//# sourceMappingURL=review-data-model-change.d.ts.map

package/dist/lib/mcp/prompts/review-data-model-change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-data-model-change.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/prompts/review-data-model-change.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAiFjE"}

package/dist/lib/mcp/prompts/review-data-model-change.js

@@ -0,0 +1,134 @@
+/**
+ * review_data_model_change — help the agent reason about a proposed
+ * change to a mermaid data model. Identifies entities in the model,
+ * runs `cascade_impact` for each, and includes consumer lookups from
+ * the SDD index so the agent has structured input to shape its
+ * review around.
+ */
+import { z } from "zod";
+import { CascadeImpactError, runCascadeImpact, } from "../../sdd-index/cascade.js";
+import { extractEntities } from "../../sdd-index/data-model.js";
+import { getSddIndex } from "../../sdd-index/index.js";
+import { readerFor } from "../pin/index.js";
+export function register(server, sddRoot) {
+    server.registerPrompt("review_data_model_change", {
+        title: "Review a data-model change",
+        description: "Structured review shell for a proposed data-model change. Extracts entities from the mermaid source, runs cascade_impact per entity, and lists consumers with version pins so the agent can reason about breaking-change risk.",
+        argsSchema: {
+            data_model_path: z
+                .string()
+                .min(1)
+                .describe("SDD-relative path to the data model (e.g. 'docs/domains/party/architecture/data-model.mermaid.md')."),
+            change_description: z
+                .string()
+                .min(1)
+                .describe("One or two sentences describing the proposed change (for context in the review shell)."),
+            pin_to_commit: z
+                .string()
+                .optional()
+                .describe("Optional commit SHA (or ref) to pin the SDD to."),
+        },
+    }, (args) => {
+        const reader = readerFor(sddRoot, args.pin_to_commit);
+        const body = reader.readFile(args.data_model_path);
+        if (body === null) {
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: renderMissingModel(args.data_model_path, reader.sddRoot),
+                        },
+                    },
+                ],
+            };
+        }
+        const entities = extractEntities(body);
+        const index = getSddIndex(reader);
+        const perEntity = entities.map((entity) => {
+            const consumers = index.consumers.get(entity) ?? [];
+            const producers = index.producers.get(entity) ?? [];
+            let cascade = null;
+            let cascadeError = null;
+            try {
+                cascade = runCascadeImpact(reader, {
+                    change_type: "entity",
+                    target: entity,
+                });
+            }
+            catch (err) {
+                if (err instanceof CascadeImpactError) {
+                    cascadeError = err;
+                }
+                else {
+                    throw err;
+                }
+            }
+            return { entity, consumers, producers, cascade, cascadeError };
+        });
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: renderReviewShell(args, entities, perEntity, reader.pin),
+                    },
+                },
+            ],
+        };
+    });
+}
+function renderMissingModel(relPath, sddRoot) {
+    return [
+        `**Data model not found:** \`${relPath}\``,
+        "",
+        `The SDD at \`${sddRoot}\` does not have this file. Confirm the path and re-run.`,
+    ].join("\n");
+}
+function renderReviewShell(args, entities, perEntity, pin) {
+    const lines = [];
+    lines.push(`**Data-model change review** (pin: ${pin})`, "", `- **Model:** \`${args.data_model_path}\``, `- **Proposed change:** ${args.change_description}`, "", "## Entities identified", "");
+    if (entities.length === 0) {
+        lines.push("_No entities extracted from the mermaid source._ Check that the", "file uses the standard `EntityName {` block syntax.");
+        lines.push("");
+        return lines.join("\n");
+    }
+    for (const e of entities)
+        lines.push(`- \`${e}\``);
+    lines.push("");
+    for (const item of perEntity) {
+        lines.push(`## ${item.entity}`);
+        lines.push("");
+        if (item.producers.length > 0) {
+            lines.push(`- **Producers:** ${item.producers.map((p) => `\`${p}\``).join(", ")}`);
+        }
+        else {
+            lines.push("- **Producers:** _none identified in the SDD index_");
+        }
+        if (item.consumers.length > 0) {
+            lines.push(`- **Consumers:** ${item.consumers.map((c) => `\`${c}\``).join(", ")}`);
+        }
+        else {
+            lines.push("- **Consumers:** _none identified in the SDD index_");
+        }
+        lines.push("");
+        if (item.cascadeError) {
+            lines.push(`_cascade_impact unavailable: ${item.cascadeError.code} — ${item.cascadeError.message}_`);
+            lines.push("");
+            continue;
+        }
+        if (item.cascade) {
+            const a = item.cascade.affected;
+            lines.push("**Cascade summary:**");
+            lines.push(`- services: ${a.services.length === 0 ? "none" : a.services.map((s) => `\`${s.service}\``).join(", ")}`);
+            lines.push(`- capabilities: ${a.capabilities.length === 0 ? "none" : a.capabilities.map((c) => `\`${c}\``).join(", ")}`);
+            lines.push(`- contracts: ${a.contracts.length === 0 ? "none" : a.contracts.map((c) => `\`${c}\``).join(", ")}`);
+            lines.push("");
+        }
+    }
+    lines.push("## Review checklist", "", "1. Is the change backwards-compatible at the contract boundary (see per-entity contracts above)?", "2. Have all listed consumers been notified / had their specs updated?", "3. Does the cascade summary surface any missing feature-spec, capability-spec, or glossary updates?", "4. Pin this review to a commit (`pin_to_commit`) before citing it in a work order.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=review-data-model-change.js.map