@sdd-method/sdd-cli 0.9.0

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * SDD path resolution for the local stdio MCP server, per MCP plan
+ * §Discovery and seeding semantics / §Sibling-path resolution.
+ *
+ * Precedence:
+ *   1. SDD_REPO_PATH env var
+ *   2. --sdd-repo CLI flag (passed in by the caller)
+ *   3. Walk up to git root; scan siblings for the .sdd-repo-kind
+ *      marker; fall through to the nested case (cwd IS the SDD)
+ *
+ * Ambiguous and missing cases surface structured errors — no guessing.
+ */
+export declare const SDD_MARKER_FILE = ".sdd-repo-kind";
+export interface ResolveOptions {
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+    readonly flagPath?: string;
+}
+export interface ResolvedSdd {
+    readonly path: string;
+    readonly source: "env" | "flag" | "sibling" | "nested";
+}
+export declare function resolveSddRepo(opts: ResolveOptions): ResolvedSdd;
+export declare function walkUpToGitRoot(startDir: string): string | undefined;
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/lib/mcp/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,eAAO,MAAM,eAAe,mBAAmB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;CACxD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CA8DhE;AAsBD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUpE"}

package/dist/lib/mcp/workspace.js

@@ -0,0 +1,129 @@
+/**
+ * SDD path resolution for the local stdio MCP server, per MCP plan
+ * §Discovery and seeding semantics / §Sibling-path resolution.
+ *
+ * Precedence:
+ *   1. SDD_REPO_PATH env var
+ *   2. --sdd-repo CLI flag (passed in by the caller)
+ *   3. Walk up to git root; scan siblings for the .sdd-repo-kind
+ *      marker; fall through to the nested case (cwd IS the SDD)
+ *
+ * Ambiguous and missing cases surface structured errors — no guessing.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { McpEnvelopeError } from "./errors.js";
+export const SDD_MARKER_FILE = ".sdd-repo-kind";
+export function resolveSddRepo(opts) {
+    const envPath = opts.env["SDD_REPO_PATH"];
+    if (envPath && envPath.trim().length > 0) {
+        const abs = resolve(envPath);
+        assertMarker(abs, "env");
+        return { path: abs, source: "env" };
+    }
+    if (opts.flagPath && opts.flagPath.trim().length > 0) {
+        const abs = resolve(opts.flagPath);
+        assertMarker(abs, "flag");
+        return { path: abs, source: "flag" };
+    }
+    const codeRepoRoot = walkUpToGitRoot(opts.cwd);
+    if (!codeRepoRoot) {
+        throw new McpEnvelopeError({
+            code: "NO_GIT_ROOT",
+            message: `Not inside a git repository (searched upward from ${opts.cwd}).`,
+            remediation: "Run sdd-cli mcp serve from inside a git repository whose sibling is the SDD, or pass --sdd-repo <path> / set SDD_REPO_PATH.",
+            context: { cwd: opts.cwd },
+        });
+    }
+    const candidates = findSiblingCandidates(codeRepoRoot);
+    if (existsSync(join(codeRepoRoot, SDD_MARKER_FILE))) {
+        candidates.push(codeRepoRoot);
+    }
+    if (candidates.length === 0) {
+        throw new McpEnvelopeError({
+            code: "NO_SDD_FOUND",
+            message: `No sibling SDD repository found. Searched siblings of ${codeRepoRoot} for the ${SDD_MARKER_FILE} marker.`,
+            remediation: `Check out the SDD repository as a sibling of this code repo (e.g. /parent/${dirname(codeRepoRoot)}), or pass --sdd-repo <path> / set SDD_REPO_PATH to point at the SDD directly.`,
+            context: { codeRepoRoot, searchedParent: dirname(codeRepoRoot) },
+        });
+    }
+    if (candidates.length > 1) {
+        throw new McpEnvelopeError({
+            code: "MULTIPLE_SDDS_FOUND",
+            message: `Multiple SDD repositories found as candidates; cannot auto-select.`,
+            remediation: "Pass --sdd-repo <path> or set SDD_REPO_PATH to disambiguate. Listing candidate paths in context.candidates.",
+            context: { candidates },
+        });
+    }
+    const only = candidates[0];
+    if (only === undefined) {
+        throw new McpEnvelopeError({
+            code: "NO_SDD_FOUND",
+            message: "SDD resolution produced an empty result unexpectedly.",
+            remediation: "Pass --sdd-repo <path> or set SDD_REPO_PATH to point at the SDD directly.",
+        });
+    }
+    const source = only === codeRepoRoot ? "nested" : "sibling";
+    return { path: only, source };
+}
+function assertMarker(path, sourceLabel) {
+    if (!existsSync(path) || !statSync(path).isDirectory()) {
+        throw new McpEnvelopeError({
+            code: "SDD_PATH_INVALID",
+            message: `SDD path ${path} (source: ${sourceLabel}) does not exist or is not a directory.`,
+            remediation: "Correct the SDD_REPO_PATH / --sdd-repo value to an existing SDD directory.",
+            context: { path, source: sourceLabel },
+        });
+    }
+    if (!existsSync(join(path, SDD_MARKER_FILE))) {
+        throw new McpEnvelopeError({
+            code: "SDD_MARKER_MISSING",
+            message: `SDD path ${path} (source: ${sourceLabel}) is missing the ${SDD_MARKER_FILE} marker file.`,
+            remediation: `Either the path is wrong, or the SDD needs a ${SDD_MARKER_FILE} file at its root containing one of: platform-product, application-product, integration-product, canonical-method.`,
+            context: { path, source: sourceLabel, expected_marker: SDD_MARKER_FILE },
+        });
+    }
+}
+export function walkUpToGitRoot(startDir) {
+    let current = resolve(startDir);
+    // Cap the walk at filesystem root to prevent runaway loops.
+    for (let i = 0; i < 64; i++) {
+        if (existsSync(join(current, ".git")))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+    return undefined;
+}
+function findSiblingCandidates(codeRepoRoot) {
+    const parent = dirname(codeRepoRoot);
+    if (parent === codeRepoRoot)
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(parent);
+    }
+    catch {
+        return [];
+    }
+    const candidates = [];
+    for (const entry of entries) {
+        const abs = join(parent, entry);
+        if (abs === codeRepoRoot)
+            continue;
+        try {
+            if (!statSync(abs).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (existsSync(join(abs, SDD_MARKER_FILE))) {
+            candidates.push(abs);
+        }
+    }
+    return candidates;
+}
+//# sourceMappingURL=workspace.js.map

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

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

package/dist/lib/mcp-seed/entries.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Entry builders — produce the McpServerEntry blocks this plan owns.
+ */
+import type { McpServerEntry } from "./types.js";
+export interface SddMcpEntryOptions {
+    /**
+     * Absolute path to the SDD repo. Written as an env var so sdd-mcp
+     * doesn't fall back to sibling auto-discovery (which would error
+     * with MULTIPLE_SDDS_FOUND in an adopter app/integration repo where
+     * the app itself has a .sdd-repo-kind marker AND a platform
+     * SDD sits alongside).
+     *
+     * Omit for platform profiles where the repo IS the SDD — Phase 1's
+     * workspace resolver handles the nested case.
+     */
+    readonly sddRepoPath?: string;
+}
+export declare function buildSddMcpEntry(opts?: SddMcpEntryOptions): McpServerEntry;
+//# sourceMappingURL=entries.d.ts.map

package/dist/lib/mcp-seed/entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../../src/lib/mcp-seed/entries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,kBAAuB,GAAG,cAAc,CAS9E"}

package/dist/lib/mcp-seed/entries.js

@@ -0,0 +1,14 @@
+/**
+ * Entry builders — produce the McpServerEntry blocks this plan owns.
+ */
+export function buildSddMcpEntry(opts = {}) {
+    const entry = {
+        command: "sdd-cli",
+        args: ["mcp", "serve"],
+        ...(opts.sddRepoPath !== undefined
+            ? { env: { SDD_REPO_PATH: opts.sddRepoPath } }
+            : {}),
+    };
+    return entry;
+}
+//# sourceMappingURL=entries.js.map

package/dist/lib/mcp-seed/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../../src/lib/mcp-seed/entries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,MAAM,UAAU,gBAAgB,CAAC,OAA2B,EAAE;IAC5D,MAAM,KAAK,GAAmB;QAC5B,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS;YAChC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lib/mcp-seed/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Public facade for the MCP settings-seed library. Consumers:
+ *
+ *   - `sdd-cli init` scaffolds (platform/app/integration) call
+ *     `buildMethodManagedServers()` + `upsertMethodManagedServers()`
+ *     to produce a correctly-seeded `.claude/settings.json`.
+ *   - `sdd-cli sync` routes the same file through the merge path to
+ *     upsert method-owned entries without clobbering adopter content.
+ *
+ * Scope: this module owns `mcpServers.<method-id>`. Hooks and other
+ * top-level keys belong to the enforcement-automation plan; we pass
+ * them through untouched.
+ */
+export type { ClaudeSettings, McpServerEntry, MethodManagedServerId, } from "./types.js";
+export { METHOD_MANAGED_SERVER_IDS } from "./types.js";
+export { buildSddMcpEntry } from "./entries.js";
+export type { SddMcpEntryOptions } from "./entries.js";
+export { detectManagedDrift, upsertMethodManagedServers, } from "./merge.js";
+export type { UpsertResult } from "./merge.js";
+import type { McpServerEntry, MethodManagedServerId } from "./types.js";
+export interface BuildMethodManagedOptions {
+    /**
+     * Explicit SDD repo path for `sdd-mcp`. Usually set at init time to
+     * the absolute path of the repo being scaffolded. Omit to let
+     * sdd-mcp's workspace resolver walk up + auto-discover (works for
+     * platform profiles where the target repo IS the SDD).
+     */
+    readonly sddRepoPath?: string;
+}
+/**
+ * Produce the full owned-servers map. Adding a new method-managed
+ * server id is a one-place change: add it here and to
+ * METHOD_MANAGED_SERVER_IDS.
+ */
+export declare function buildMethodManagedServers(opts?: BuildMethodManagedOptions): Record<MethodManagedServerId, McpServerEntry>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/mcp-seed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/mcp-seed/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY,EACV,cAAc,EACd,cAAc,EACd,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,GAAE,yBAA8B,GACnC,MAAM,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAM/C"}

package/dist/lib/mcp-seed/index.js

@@ -0,0 +1,28 @@
+/**
+ * Public facade for the MCP settings-seed library. Consumers:
+ *
+ *   - `sdd-cli init` scaffolds (platform/app/integration) call
+ *     `buildMethodManagedServers()` + `upsertMethodManagedServers()`
+ *     to produce a correctly-seeded `.claude/settings.json`.
+ *   - `sdd-cli sync` routes the same file through the merge path to
+ *     upsert method-owned entries without clobbering adopter content.
+ *
+ * Scope: this module owns `mcpServers.<method-id>`. Hooks and other
+ * top-level keys belong to the enforcement-automation plan; we pass
+ * them through untouched.
+ */
+export { METHOD_MANAGED_SERVER_IDS } from "./types.js";
+export { buildSddMcpEntry } from "./entries.js";
+export { detectManagedDrift, upsertMethodManagedServers, } from "./merge.js";
+import { buildSddMcpEntry } from "./entries.js";
+/**
+ * Produce the full owned-servers map. Adding a new method-managed
+ * server id is a one-place change: add it here and to
+ * METHOD_MANAGED_SERVER_IDS.
+ */
+export function buildMethodManagedServers(opts = {}) {
+    return {
+        "sdd-mcp": buildSddMcpEntry(opts.sddRepoPath !== undefined ? { sddRepoPath: opts.sddRepoPath } : {}),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/mcp-seed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/mcp-seed/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAahD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAkC,EAAE;IAEpC,OAAO;QACL,SAAS,EAAE,gBAAgB,CACzB,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CACxE;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/mcp-seed/merge.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Merge logic for the method-managed portion of `.claude/settings.json`.
+ *
+ * Ownership model: the method owns specific server ids (listed in
+ * `METHOD_MANAGED_SERVER_IDS`). On upsert, those ids are rewritten
+ * with the method-supplied entry; any other server ids the adopter
+ * has added under `mcpServers` survive untouched, as do all other
+ * top-level keys (hooks, permissions, env, …).
+ *
+ * The merge is conservative: if a method id exists with a value that
+ * is byte-identical to the method's current seed, we return the
+ * original object unmodified (stable output → no spurious writes).
+ */
+import type { ClaudeSettings, McpServerEntry, MethodManagedServerId } from "./types.js";
+export interface UpsertResult {
+    readonly settings: ClaudeSettings;
+    /** Ids that were newly added. */
+    readonly added: readonly string[];
+    /** Ids whose entry changed. */
+    readonly updated: readonly string[];
+    /** Ids that were already present and byte-equal. */
+    readonly unchanged: readonly string[];
+    /** Whether the returned settings differ from the input. */
+    readonly changed: boolean;
+}
+export declare function upsertMethodManagedServers(existing: ClaudeSettings, owned: Readonly<Record<MethodManagedServerId, McpServerEntry>>): UpsertResult;
+/**
+ * Detect adopter-edited method-managed entries. Returns the ids whose
+ * current value differs from the method-supplied seed — these are the
+ * ones that a refuse-or-overwrite sync should flag unless
+ * `--allow-overwrite` is passed.
+ */
+export declare function detectManagedDrift(existing: ClaudeSettings, owned: Readonly<Record<MethodManagedServerId, McpServerEntry>>): readonly string[];
+//# sourceMappingURL=merge.d.ts.map

package/dist/lib/mcp-seed/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/lib/mcp-seed/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC,GAC7D,YAAY,CA8Cd;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC,GAC7D,SAAS,MAAM,EAAE,CAYnB"}

package/dist/lib/mcp-seed/merge.js

@@ -0,0 +1,99 @@
+/**
+ * Merge logic for the method-managed portion of `.claude/settings.json`.
+ *
+ * Ownership model: the method owns specific server ids (listed in
+ * `METHOD_MANAGED_SERVER_IDS`). On upsert, those ids are rewritten
+ * with the method-supplied entry; any other server ids the adopter
+ * has added under `mcpServers` survive untouched, as do all other
+ * top-level keys (hooks, permissions, env, …).
+ *
+ * The merge is conservative: if a method id exists with a value that
+ * is byte-identical to the method's current seed, we return the
+ * original object unmodified (stable output → no spurious writes).
+ */
+export function upsertMethodManagedServers(existing, owned) {
+    const added = [];
+    const updated = [];
+    const unchanged = [];
+    const currentServers = isPlainObject(existing["mcpServers"])
+        ? existing["mcpServers"]
+        : {};
+    const nextServers = { ...currentServers };
+    for (const [id, entry] of Object.entries(owned)) {
+        const prior = currentServers[id];
+        if (prior === undefined) {
+            nextServers[id] = entry;
+            added.push(id);
+        }
+        else if (!entriesEqual(prior, entry)) {
+            nextServers[id] = entry;
+            updated.push(id);
+        }
+        else {
+            unchanged.push(id);
+        }
+    }
+    const changed = added.length > 0 || updated.length > 0;
+    if (!changed) {
+        return {
+            settings: existing,
+            added,
+            updated,
+            unchanged,
+            changed: false,
+        };
+    }
+    const nextSettings = {
+        ...existing,
+        mcpServers: nextServers,
+    };
+    return {
+        settings: nextSettings,
+        added,
+        updated,
+        unchanged,
+        changed: true,
+    };
+}
+/**
+ * Detect adopter-edited method-managed entries. Returns the ids whose
+ * current value differs from the method-supplied seed — these are the
+ * ones that a refuse-or-overwrite sync should flag unless
+ * `--allow-overwrite` is passed.
+ */
+export function detectManagedDrift(existing, owned) {
+    const currentServers = isPlainObject(existing["mcpServers"])
+        ? existing["mcpServers"]
+        : {};
+    const drifted = [];
+    for (const [id, entry] of Object.entries(owned)) {
+        const prior = currentServers[id];
+        if (prior !== undefined && !entriesEqual(prior, entry)) {
+            drifted.push(id);
+        }
+    }
+    return drifted;
+}
+function entriesEqual(a, b) {
+    // Stable-order JSON comparison. The entry shape is small and flat
+    // enough that stringifying is cheaper than writing a structural
+    // walker.
+    return stableStringify(a) === stableStringify(b);
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return "[" + value.map((v) => stableStringify(v)).join(",") + "]";
+    }
+    const keys = Object.keys(value).sort();
+    return ("{" +
+        keys
+            .map((k) => JSON.stringify(k) + ":" + stableStringify(value[k]))
+            .join(",") +
+        "}");
+}
+function isPlainObject(v) {
+    return v !== null && typeof v === "object" && !Array.isArray(v);
+}
+//# sourceMappingURL=merge.js.map

package/dist/lib/mcp-seed/merge.js.map

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

package/dist/lib/mcp-seed/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Types for the MCP settings-seed library. Mirrors the shape Claude
+ * Code expects at `.claude/settings.json`, restricted to the fields
+ * we read or write.
+ */
+export interface McpServerEntry {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly env?: Readonly<Record<string, string>>;
+    readonly cwd?: string;
+}
+export interface ClaudeSettings {
+    readonly mcpServers?: Readonly<Record<string, McpServerEntry>>;
+    readonly [key: string]: unknown;
+}
+/**
+ * Server ids owned by this method plan. Sync upserts these and leaves
+ * everything else alone. When Phases 3+4 ship adopter servers, extend
+ * the list — or better, let each plan contribute its own list and
+ * combine at merge time.
+ */
+export declare const METHOD_MANAGED_SERVER_IDS: readonly ["sdd-mcp"];
+export type MethodManagedServerId = (typeof METHOD_MANAGED_SERVER_IDS)[number];
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/mcp-seed/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/mcp-seed/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAG/D,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,sBAAuB,CAAC;AAE9D,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/lib/mcp-seed/types.js

@@ -0,0 +1,13 @@
+/**
+ * Types for the MCP settings-seed library. Mirrors the shape Claude
+ * Code expects at `.claude/settings.json`, restricted to the fields
+ * we read or write.
+ */
+/**
+ * Server ids owned by this method plan. Sync upserts these and leaves
+ * everything else alone. When Phases 3+4 ship adopter servers, extend
+ * the list — or better, let each plan contribute its own list and
+ * combine at merge time.
+ */
+export const METHOD_MANAGED_SERVER_IDS = ["sdd-mcp"];
+//# sourceMappingURL=types.js.map

package/dist/lib/mcp-seed/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/mcp-seed/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,SAAS,CAAU,CAAC"}

package/dist/lib/plan/index.d.ts

@@ -0,0 +1,19 @@
+export interface PlanPilotInputs {
+    sddRoot: string;
+    service: string;
+    capability: string;
+    domain: string;
+    outputPath?: string;
+    dryRun?: boolean;
+    today?: string;
+    platformCliVersionHint?: string;
+}
+export interface PlanPilotResult {
+    exitCode: number;
+    outputPath: string;
+    rendered: string;
+    /** True when the run was dry-run and no file was written. */
+    dryRun: boolean;
+}
+export declare function runPlanPilot(inputs: PlanPilotInputs, write: (s: string) => void): Promise<PlanPilotResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/plan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/plan/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,eAAe,CAAC,CAwD1B"}

package/dist/lib/plan/index.js

@@ -0,0 +1,69 @@
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { readSdd } from "./read-sdd.js";
+import { renderPilotKickoff } from "./render-template.js";
+export async function runPlanPilot(inputs, write) {
+    const templatePath = join(inputs.sddRoot, "docs/method/methods/pilot-kickoff-template.md");
+    if (!(await fileExists(templatePath))) {
+        const msg = `[FAIL] pilot-kickoff template not found at ${templatePath}. Sync the method baseline first (bundle v0.2.15+).\n`;
+        write(msg);
+        return {
+            exitCode: 1,
+            outputPath: inputs.outputPath ?? defaultOutputPath(inputs),
+            rendered: "",
+            dryRun: inputs.dryRun === true,
+        };
+    }
+    const snapshot = await readSdd({
+        sddRoot: inputs.sddRoot,
+        service: inputs.service,
+        capability: inputs.capability,
+        domain: inputs.domain,
+    });
+    const rendered = await renderPilotKickoff({
+        snapshot,
+        platformCliVersionHint: inputs.platformCliVersionHint ?? "0.5.0",
+        today: inputs.today ?? new Date().toISOString().slice(0, 10),
+    });
+    const outputPath = inputs.outputPath ?? defaultOutputPath(inputs);
+    const dryRun = inputs.dryRun === true;
+    if (dryRun) {
+        write(rendered);
+        write(`\n[INFO] dry-run: would write to ${outputPath}\n`);
+        return { exitCode: 0, outputPath, rendered, dryRun: true };
+    }
+    const outputAbs = resolveOutputAbs(inputs.sddRoot, outputPath);
+    if (await fileExists(outputAbs)) {
+        write(`[FAIL] refusing to overwrite existing file at ${outputAbs}. Move or rename, or re-run with --dry-run.\n`);
+        return { exitCode: 1, outputPath: outputAbs, rendered, dryRun: false };
+    }
+    await mkdir(dirname(outputAbs), { recursive: true });
+    await writeFile(outputAbs, rendered, "utf8");
+    write(`[PASS] pilot-kickoff scaffolded at ${outputAbs}\n` +
+        `  aggregates: ${snapshot.repoConfig.aggregates.length}\n` +
+        `  feature specs: ${snapshot.featureSpecCount}\n` +
+        `  capability spec: ${snapshot.capabilitySpecPresent ? "present" : "MISSING"}\n` +
+        `  traceability manifest: ${snapshot.traceabilityManifestPresent ? "present" : "MISSING"}\n`);
+    return { exitCode: 0, outputPath: outputAbs, rendered, dryRun: false };
+}
+function defaultOutputPath(inputs) {
+    return join("content/product/plans", `${inputs.service}-pilot-kickoff.md`);
+}
+function resolveOutputAbs(sddRoot, outputPath) {
+    if (outputPath.startsWith("/"))
+        return outputPath;
+    return join(sddRoot, outputPath);
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Keep readFile import in use; some test harness entry points trigger module
+// tree-shake warnings otherwise.
+void readFile;
+//# sourceMappingURL=index.js.map

package/dist/lib/plan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/plan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAqB1D,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAuB,EACvB,KAA0B;IAE1B,MAAM,YAAY,GAAG,IAAI,CACvB,MAAM,CAAC,OAAO,EACd,+CAA+C,CAChD,CAAC;IACF,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,8CAA8C,YAAY,uDAAuD,CAAC;QAC9H,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,iBAAiB,CAAC,MAAM,CAAC;YAC1D,QAAQ,EAAE,EAAE;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,IAAI;SAC/B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;QACxC,QAAQ;QACR,sBAAsB,EAAE,MAAM,CAAC,sBAAsB,IAAI,OAAO;QAChE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KAC7D,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC;IAEtC,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,KAAK,CAAC,oCAAoC,UAAU,IAAI,CAAC,CAAC;QAC1D,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC/D,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,KAAK,CACH,iDAAiD,SAAS,+CAA+C,CAC1G,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,KAAK,CACH,sCAAsC,SAAS,IAAI;QACjD,iBAAiB,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,IAAI;QAC1D,oBAAoB,QAAQ,CAAC,gBAAgB,IAAI;QACjD,sBAAsB,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI;QAChF,4BAA4B,QAAQ,CAAC,2BAA2B,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,CAC/F,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAuB;IAChD,OAAO,IAAI,CACT,uBAAuB,EACvB,GAAG,MAAM,CAAC,OAAO,mBAAmB,CACrC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe,EAAE,UAAkB;IAC3D,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAClD,OAAO,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,iCAAiC;AACjC,KAAK,QAAQ,CAAC"}

package/dist/lib/plan/read-sdd.d.ts

@@ -0,0 +1,46 @@
+export interface RepoConfig {
+    path: string;
+    description?: string;
+    serviceType?: string;
+    aggregates: string[];
+    internalDependencies: string[];
+    contracts: {
+        openapi: string[];
+        proto: string[];
+        avro: string[];
+        spicedb: string[];
+    };
+}
+export interface SddSnapshot {
+    sddRoot: string;
+    service: string;
+    capability: string;
+    domain: string;
+    repoConfig: RepoConfig;
+    featureSpecCount: number;
+    featureSpecRelativePaths: string[];
+    capabilitySpecPresent: boolean;
+    capabilitySpecPath: string;
+    traceabilityManifestPresent: boolean;
+    traceabilityManifestPath: string;
+}
+export interface ReadSddInputs {
+    sddRoot: string;
+    service: string;
+    capability: string;
+    domain: string;
+}
+/**
+ * Read everything `plan --pilot` needs from the SDD filesystem: the service's
+ * repo-config manifest (domain, service_type, aggregates, dependencies,
+ * contracts), the count of feature spec files under the capability, and
+ * presence of the capability spec + traceability manifest.
+ *
+ * Repo-config parsing delegates to the shared sdd-index module so the
+ * `plan --pilot` path and the MCP dependency-graph tools see the same
+ * view. The richer ADR 0110 shape (package/version/stability) is
+ * flattened back to path-strings here to preserve the legacy
+ * `RepoConfig` contract.
+ */
+export declare function readSdd(inputs: ReadSddInputs): Promise<SddSnapshot>;
+//# sourceMappingURL=read-sdd.d.ts.map

package/dist/lib/plan/read-sdd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-sdd.d.ts","sourceRoot":"","sources":["../../../src/lib/plan/read-sdd.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,EAAE;QACT,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B,EAAE,OAAO,CAAC;IACrC,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CA8DzE"}