@sdd-method/sdd-cli 0.9.0

package/dist/lib/list/index.js

@@ -0,0 +1,15 @@
+import { discoverSddRepos } from "./discover.js";
+import { format } from "./format.js";
+export async function runList(inputs, write) {
+    const roots = inputs.workspaceRoots.length > 0
+        ? inputs.workspaceRoots
+        : [process.cwd()];
+    const repos = await discoverSddRepos(roots);
+    const output = format(repos, {
+        format: inputs.format,
+        ...(inputs.profileFilter ? { profileFilter: inputs.profileFilter } : {}),
+    });
+    write(output);
+    return { exitCode: 0 };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/list/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AAYxD,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAkB,EAClB,KAA0B;IAE1B,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;QAC5C,CAAC,CAAC,MAAM,CAAC,cAAc;QACvB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEpB,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzE,CAAC,CAAC;IACH,KAAK,CAAC,MAAM,CAAC,CAAC;IACd,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AACzB,CAAC"}

package/dist/lib/lock-file.d.ts

@@ -0,0 +1,14 @@
+export declare const LOCK_FILE = "method-baseline.lock";
+export interface LockFile {
+    methodRepo: string;
+    bundleVersion: string;
+    sourceCommit: string;
+    bundleSha256: string;
+    syncedAtUtc: string;
+    managedPaths: string[];
+}
+export declare function readLockFile(repoRoot: string): Promise<LockFile | null>;
+export declare function writeLockFile(repoRoot: string, lock: LockFile): Promise<void>;
+export declare function parseLockFile(raw: string): LockFile;
+export declare function serialiseLockFile(lock: LockFile): string;
+//# sourceMappingURL=lock-file.d.ts.map

package/dist/lib/lock-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-file.d.ts","sourceRoot":"","sources":["../../src/lib/lock-file.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,SAAS,yBAAyB,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAS7E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CA6CnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAWxD"}

package/dist/lib/lock-file.js

@@ -0,0 +1,80 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export const LOCK_FILE = "method-baseline.lock";
+export async function readLockFile(repoRoot) {
+    let raw;
+    try {
+        raw = await readFile(join(repoRoot, LOCK_FILE), "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+    return parseLockFile(raw);
+}
+export async function writeLockFile(repoRoot, lock) {
+    await writeFile(join(repoRoot, LOCK_FILE), serialiseLockFile(lock), "utf8");
+}
+export function parseLockFile(raw) {
+    const scalars = new Map();
+    const managedPaths = [];
+    let inManagedList = false;
+    for (const line of raw.split("\n")) {
+        if (inManagedList) {
+            if (line.startsWith("  - ")) {
+                managedPaths.push(line.slice(4));
+                continue;
+            }
+            inManagedList = false;
+        }
+        if (line === "managed_paths:") {
+            inManagedList = true;
+            continue;
+        }
+        const match = /^([a-z_][a-z0-9_]*): (.*)$/.exec(line);
+        if (match) {
+            const [, key, rawValue] = match;
+            scalars.set(key, stripQuotes(rawValue));
+        }
+    }
+    const required = [
+        "method_repo",
+        "bundle_version",
+        "source_commit",
+        "bundle_sha256",
+        "synced_at_utc",
+    ];
+    for (const key of required) {
+        if (!scalars.has(key)) {
+            throw new Error(`method-baseline.lock is missing required key: ${key}`);
+        }
+    }
+    return {
+        methodRepo: scalars.get("method_repo"),
+        bundleVersion: scalars.get("bundle_version"),
+        sourceCommit: scalars.get("source_commit"),
+        bundleSha256: scalars.get("bundle_sha256"),
+        syncedAtUtc: scalars.get("synced_at_utc"),
+        managedPaths,
+    };
+}
+export function serialiseLockFile(lock) {
+    const lines = [
+        `method_repo: ${lock.methodRepo}`,
+        `bundle_version: "${lock.bundleVersion}"`,
+        `source_commit: "${lock.sourceCommit}"`,
+        `bundle_sha256: "${lock.bundleSha256}"`,
+        `synced_at_utc: "${lock.syncedAtUtc}"`,
+        "managed_paths:",
+        ...lock.managedPaths.map((p) => `  - ${p}`),
+    ];
+    return lines.join("\n") + "\n";
+}
+function stripQuotes(value) {
+    if (value.length >= 2 && value.startsWith('"') && value.endsWith('"')) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+//# sourceMappingURL=lock-file.js.map

package/dist/lib/lock-file.js.map

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

package/dist/lib/mcp/build-info.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Build-time constants for the MCP server. Updated when sdd-cli is
+ * released; Phase 6 of the MCP plan may swap this for a generated file
+ * populated by `npm version`.
+ */
+export declare const SERVER_VERSION = "0.9.0";
+export declare const DISTRIBUTION = "sdd-method";
+export declare const MCP_PROTOCOL_SPEC_VERSION = "2025-06-18";
+//# sourceMappingURL=build-info.d.ts.map

package/dist/lib/mcp/build-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.d.ts","sourceRoot":"","sources":["../../../src/lib/mcp/build-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,eAAO,MAAM,YAAY,eAAe,CAAC;AAEzC,eAAO,MAAM,yBAAyB,eAAe,CAAC"}

package/dist/lib/mcp/build-info.js

@@ -0,0 +1,10 @@
+/**
+ * Build-time constants for the MCP server. Updated when sdd-cli is
+ * released; Phase 6 of the MCP plan may swap this for a generated file
+ * populated by `npm version`.
+ */
+// Mirror of package.json version — bump in lockstep on release.
+export const SERVER_VERSION = "0.9.0";
+export const DISTRIBUTION = "sdd-method";
+export const MCP_PROTOCOL_SPEC_VERSION = "2025-06-18";
+//# sourceMappingURL=build-info.js.map

package/dist/lib/mcp/build-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../../../src/lib/mcp/build-info.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Structured error envelope per the MCP context extension plan
+ * §Error and response schema. Every handler throws an McpEnvelopeError;
+ * the server adapter converts it to an MCP JSON-RPC error with a
+ * human-actionable remediation field.
+ */
+export interface McpErrorLink {
+    readonly title: string;
+    readonly url: string;
+}
+export interface McpErrorEnvelope {
+    readonly code: string;
+    readonly message: string;
+    readonly remediation: string;
+    readonly context?: Record<string, unknown>;
+    readonly links?: readonly McpErrorLink[];
+}
+export declare class McpEnvelopeError extends Error {
+    readonly envelope: McpErrorEnvelope;
+    constructor(envelope: McpErrorEnvelope);
+}
+export declare function envelopeFromUnknown(err: unknown): McpErrorEnvelope;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/lib/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;gBAExB,QAAQ,EAAE,gBAAgB;CAKvC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CASlE"}

package/dist/lib/mcp/errors.js

@@ -0,0 +1,25 @@
+/**
+ * Structured error envelope per the MCP context extension plan
+ * §Error and response schema. Every handler throws an McpEnvelopeError;
+ * the server adapter converts it to an MCP JSON-RPC error with a
+ * human-actionable remediation field.
+ */
+export class McpEnvelopeError extends Error {
+    envelope;
+    constructor(envelope) {
+        super(envelope.message);
+        this.name = "McpEnvelopeError";
+        this.envelope = envelope;
+    }
+}
+export function envelopeFromUnknown(err) {
+    if (err instanceof McpEnvelopeError)
+        return err.envelope;
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        code: "INTERNAL_ERROR",
+        message,
+        remediation: "This is an unexpected internal error. Re-run with stderr captured and file an issue against sdd-cli including the server_build value from sdd://method/version.",
+    };
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/lib/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,QAAQ,CAAmB;IAEpC,YAAY,QAA0B;QACpC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,GAAG,YAAY,gBAAgB;QAAE,OAAO,GAAG,CAAC,QAAQ,CAAC;IACzD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO;QACP,WAAW,EACT,iKAAiK;KACpK,CAAC;AACJ,CAAC"}

package/dist/lib/mcp/parse/frontmatter.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Small parser for the method's ADR metadata block — the `* **Key:**
+ * Value` bullet list enforced by
+ * orchestration/scripts/validate-adr-structure.sh.
+ *
+ * This is not YAML frontmatter; it's a convention-enforced bullet
+ * list at the top of every ADR file. Parsing it ourselves keeps the
+ * dependency footprint small (no gray-matter / front-matter libs).
+ */
+export interface AdrMetadata {
+    readonly title: string;
+    readonly date?: string;
+    readonly status?: string;
+    readonly deciders?: string;
+    readonly decisionType?: string;
+    readonly scope?: string;
+    readonly supersedes?: string;
+    readonly supersededBy?: string;
+    readonly raw: Record<string, string>;
+}
+export declare function parseAdrMetadata(markdown: string): AdrMetadata;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/lib/mcp/parse/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/parse/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAiC9D"}

package/dist/lib/mcp/parse/frontmatter.js

@@ -0,0 +1,49 @@
+/**
+ * Small parser for the method's ADR metadata block — the `* **Key:**
+ * Value` bullet list enforced by
+ * orchestration/scripts/validate-adr-structure.sh.
+ *
+ * This is not YAML frontmatter; it's a convention-enforced bullet
+ * list at the top of every ADR file. Parsing it ourselves keeps the
+ * dependency footprint small (no gray-matter / front-matter libs).
+ */
+export function parseAdrMetadata(markdown) {
+    const lines = markdown.split(/\r?\n/);
+    const titleLine = lines.find((l) => l.startsWith("# "));
+    const title = titleLine ? titleLine.replace(/^#\s+/, "").trim() : "";
+    const raw = {};
+    const bulletMetadata = /^\s*[*\-]\s*\*\*([A-Za-z][A-Za-z0-9 _/-]*):\*\*\s*(.+?)\s*$/;
+    for (const line of lines) {
+        const m = line.match(bulletMetadata);
+        if (!m)
+            continue;
+        const [, key, value] = m;
+        if (key && value) {
+            raw[key.trim()] = value.trim();
+        }
+    }
+    const result = { title, raw };
+    const date = raw["Date"];
+    if (date)
+        result.date = date;
+    const status = raw["Status"];
+    if (status)
+        result.status = status;
+    const deciders = raw["Deciders"];
+    if (deciders)
+        result.deciders = deciders;
+    const decisionType = raw["Decision Type"];
+    if (decisionType)
+        result.decisionType = decisionType;
+    const scope = raw["Scope"];
+    if (scope)
+        result.scope = scope;
+    const supersedes = raw["Supersedes"];
+    if (supersedes)
+        result.supersedes = supersedes;
+    const supersededBy = raw["Superseded By"];
+    if (supersededBy)
+        result.supersededBy = supersededBy;
+    return result;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/lib/mcp/parse/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../../src/lib/mcp/parse/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAcH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAErE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,MAAM,cAAc,GAClB,6DAA6D,CAAC;IAChE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YACjB,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAyB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,IAAI,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,IAAI,MAAM;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACzC,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,YAAY;QAAE,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;IACrD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,IAAI,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,UAAU;QAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/C,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,YAAY;QAAE,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/mcp/parse/gate-registry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * YAML reader for orchestration/gate-registry/<gate>-scores.yaml.
+ * Schema is conventional (schema_version, description, pass_threshold,
+ * plus per-entry records keyed by artefact ID). We treat the file as a
+ * generic YAML document and extract the artefact entries after
+ * excluding the known header fields.
+ */
+export interface GateRegistry {
+    readonly gate: string;
+    readonly path: string;
+    readonly schemaVersion: string | null;
+    readonly description: string | null;
+    readonly passThreshold: unknown;
+    readonly entries: Record<string, unknown>;
+}
+export declare function gateRegistryPath(sddRoot: string, gate: string): string;
+export declare function listGates(sddRoot: string): string[];
+export declare function readGateRegistry(sddRoot: string, gate: string): GateRegistry | undefined;
+//# sourceMappingURL=gate-registry.d.ts.map

package/dist/lib/mcp/parse/gate-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-registry.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/parse/gate-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAcnD;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,YAAY,GAAG,SAAS,CA2B1B"}

package/dist/lib/mcp/parse/gate-registry.js

@@ -0,0 +1,68 @@
+/**
+ * YAML reader for orchestration/gate-registry/<gate>-scores.yaml.
+ * Schema is conventional (schema_version, description, pass_threshold,
+ * plus per-entry records keyed by artefact ID). We treat the file as a
+ * generic YAML document and extract the artefact entries after
+ * excluding the known header fields.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { safeIsFile } from "./paths.js";
+const HEADER_KEYS = new Set([
+    "schema_version",
+    "description",
+    "pass_threshold",
+]);
+export function gateRegistryPath(sddRoot, gate) {
+    return join(sddRoot, "orchestration", "gate-registry", `${gate}-scores.yaml`);
+}
+export function listGates(sddRoot) {
+    const candidates = [
+        "adr-quality",
+        "c4-diagram",
+        "contract-quality",
+        "domain-architecture",
+        "feature-grounding",
+        "intent-quality",
+        "strategic-doc",
+        "traceability-manifest",
+        "user-story",
+        "work-order",
+    ];
+    return candidates.filter((g) => safeIsFile(gateRegistryPath(sddRoot, g)));
+}
+export function readGateRegistry(sddRoot, gate) {
+    const path = gateRegistryPath(sddRoot, gate);
+    if (!safeIsFile(path))
+        return undefined;
+    const raw = readFileSync(path, "utf8");
+    const parsed = parseYaml(raw);
+    if (!parsed || typeof parsed !== "object") {
+        return {
+            gate,
+            path,
+            schemaVersion: null,
+            description: null,
+            passThreshold: null,
+            entries: {},
+        };
+    }
+    const entries = {};
+    for (const [k, v] of Object.entries(parsed)) {
+        if (!HEADER_KEYS.has(k))
+            entries[k] = v;
+    }
+    return {
+        gate,
+        path,
+        schemaVersion: typeOrNull(parsed["schema_version"]),
+        description: typeOrNull(parsed["description"]),
+        passThreshold: parsed["pass_threshold"] ?? null,
+        entries,
+    };
+}
+function typeOrNull(v) {
+    return typeof v === "string" ? v : null;
+}
+//# sourceMappingURL=gate-registry.js.map

package/dist/lib/mcp/parse/gate-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-registry.js","sourceRoot":"","sources":["../../../../src/lib/mcp/parse/gate-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,gBAAgB;IAChB,aAAa;IACb,gBAAgB;CACjB,CAAC,CAAC;AAWH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,IAAY;IAC5D,OAAO,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,IAAI,cAAc,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,UAAU,GAAG;QACjB,aAAa;QACb,YAAY;QACZ,kBAAkB;QAClB,qBAAqB;QACrB,mBAAmB;QACnB,gBAAgB;QAChB,eAAe;QACf,uBAAuB;QACvB,YAAY;QACZ,YAAY;KACb,CAAC;IACF,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,IAAY;IAEZ,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAmC,CAAC;IAChE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO;YACL,IAAI;YACJ,IAAI;YACJ,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,IAAI;YACnB,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,aAAa,EAAE,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACnD,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC9C,aAAa,EAAE,MAAM,CAAC,gBAAgB,CAAC,IAAI,IAAI;QAC/C,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAU;IAC5B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC"}

package/dist/lib/mcp/parse/paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Filesystem path helpers used by the MCP resource handlers to map
+ * between `sdd://` URIs and files on disk. All paths returned are
+ * absolute; callers pass the resolved SDD root as the base.
+ */
+export declare function adrScopeDirs(sddRoot: string): Record<string, string>;
+export interface DiscoveredAdr {
+    readonly scope: string;
+    readonly number: string;
+    readonly title: string;
+    readonly path: string;
+}
+/**
+ * Discover every ADR file under docs/{method,platform}/adr plus
+ * docs/domains/{d}/adr in the given SDD.
+ */
+export declare function discoverAdrs(sddRoot: string): DiscoveredAdr[];
+export declare function findAdr(sddRoot: string, scope: string, number: string): DiscoveredAdr | undefined;
+export declare function safeIsFile(path: string): boolean;
+export declare function safeIsDir(path: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/lib/mcp/parse/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/parse/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKpE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAe7D;AAoBD,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,SAAS,CAK3B;AAUD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAM/C"}

package/dist/lib/mcp/parse/paths.js

@@ -0,0 +1,83 @@
+/**
+ * Filesystem path helpers used by the MCP resource handlers to map
+ * between `sdd://` URIs and files on disk. All paths returned are
+ * absolute; callers pass the resolved SDD root as the base.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+export function adrScopeDirs(sddRoot) {
+    return {
+        method: join(sddRoot, "docs", "method", "adr"),
+        platform: join(sddRoot, "docs", "platform", "adr"),
+    };
+}
+/**
+ * Discover every ADR file under docs/{method,platform}/adr plus
+ * docs/domains/{d}/adr in the given SDD.
+ */
+export function discoverAdrs(sddRoot) {
+    const out = [];
+    const scopes = adrScopeDirs(sddRoot);
+    for (const [scope, dir] of Object.entries(scopes)) {
+        out.push(...readAdrsFromDir(scope, dir));
+    }
+    const domainsRoot = join(sddRoot, "docs", "domains");
+    if (existsSync(domainsRoot)) {
+        for (const entry of safeReaddir(domainsRoot)) {
+            if (entry.startsWith("_"))
+                continue;
+            const adrDir = join(domainsRoot, entry, "adr");
+            out.push(...readAdrsFromDir(`domain:${entry}`, adrDir));
+        }
+    }
+    return out.sort((a, b) => a.number.localeCompare(b.number));
+}
+function readAdrsFromDir(scope, dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const entry of safeReaddir(dir)) {
+        const match = entry.match(/^ADR\s+(\d{3,4})\s*:\s*(.+)\.md$/);
+        if (!match)
+            continue;
+        const [, num, title] = match;
+        if (!num || !title)
+            continue;
+        out.push({
+            scope,
+            number: num.padStart(4, "0"),
+            title,
+            path: join(dir, entry),
+        });
+    }
+    return out;
+}
+export function findAdr(sddRoot, scope, number) {
+    const padded = number.padStart(4, "0");
+    return discoverAdrs(sddRoot).find((a) => a.scope === scope && a.number === padded);
+}
+function safeReaddir(dir) {
+    try {
+        return readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+export function safeIsFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export function safeIsDir(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/lib/mcp/parse/paths.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * Structured error envelopes for pin_to_commit failure modes per the
+ * scope doc §Risks — "pinning to a non-existent SHA, a pre-marker
+ * commit, or a shallow clone should surface structured errors with
+ * actionable remediation, not opaque git errors."
+ */
+import { McpEnvelopeError } from "../errors.js";
+export declare function pinNotFound(sha: string, sddRoot: string): McpEnvelopeError;
+export declare function pinPreMarker(sha: string, sddRoot: string): McpEnvelopeError;
+export declare function shallowCloneInsufficient(sha: string, sddRoot: string): McpEnvelopeError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/pin/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAQ1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAQ3E;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,gBAAgB,CAQlB"}

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

@@ -0,0 +1,32 @@
+/**
+ * Structured error envelopes for pin_to_commit failure modes per the
+ * scope doc §Risks — "pinning to a non-existent SHA, a pre-marker
+ * commit, or a shallow clone should surface structured errors with
+ * actionable remediation, not opaque git errors."
+ */
+import { McpEnvelopeError } from "../errors.js";
+export function pinNotFound(sha, sddRoot) {
+    return new McpEnvelopeError({
+        code: "PIN_NOT_FOUND",
+        message: `Commit ${sha} is not present in the git object database of ${sddRoot}.`,
+        remediation: "Fetch the ref (git fetch origin <branch>) or check the SHA spelling. For shallow clones, run git fetch --unshallow.",
+        context: { sha, sddRoot },
+    });
+}
+export function pinPreMarker(sha, sddRoot) {
+    return new McpEnvelopeError({
+        code: "PIN_PRE_MARKER",
+        message: `Commit ${sha} predates the .sdd-repo-kind marker; cannot treat this tree as an SDD.`,
+        remediation: "Pin to a commit after the SDD repo was initialised (the first commit containing .sdd-repo-kind), or omit pin_to_commit for a live read.",
+        context: { sha, sddRoot, expected_marker: ".sdd-repo-kind" },
+    });
+}
+export function shallowCloneInsufficient(sha, sddRoot) {
+    return new McpEnvelopeError({
+        code: "SHALLOW_CLONE_INSUFFICIENT",
+        message: `SDD ${sddRoot} is a shallow clone; history for ${sha} is not available.`,
+        remediation: "Run `git fetch --unshallow` in the SDD repo, or re-clone without --depth.",
+        context: { sha, sddRoot },
+    });
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/lib/mcp/pin/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,OAAe;IACtD,OAAO,IAAI,gBAAgB,CAAC;QAC1B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,UAAU,GAAG,iDAAiD,OAAO,GAAG;QACjF,WAAW,EACT,qHAAqH;QACvH,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,OAAe;IACvD,OAAO,IAAI,gBAAgB,CAAC;QAC1B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,UAAU,GAAG,wEAAwE;QAC9F,WAAW,EACT,yIAAyI;QAC3I,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE;KAC7D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,GAAW,EACX,OAAe;IAEf,OAAO,IAAI,gBAAgB,CAAC;QAC1B,IAAI,EAAE,4BAA4B;QAClC,OAAO,EAAE,OAAO,OAAO,oCAAoC,GAAG,oBAAoB;QAClF,WAAW,EACT,2EAA2E;QAC7E,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;KAC1B,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Public entry point for pin_to_commit handling. Tools call
+ * `readerFor(sddRoot, pin_to_commit)` and get an SddReader they can
+ * query without branching on live vs. pinned.
+ *
+ * A pinned reader materialises a temporary git worktree at the
+ * resolved SHA and returns a liveReader pointed at it. Every existing
+ * filesystem helper keeps working; responses echo the resolved SHA
+ * via `reader.pin`.
+ */
+import type { SddReader } from "../reader.js";
+export { resolvePin } from "./resolve.js";
+export { materialisePinnedWorktree, releasePinnedWorktrees } from "./read.js";
+export * from "./errors.js";
+export declare function readerFor(sddRoot: string, pinToCommit: string | undefined): SddReader;
+/** Shutdown hook — idempotent. */
+export declare function shutdownPinSubsystem(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/mcp/pin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC9E,cAAc,aAAa,CAAC;AAE5B,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,SAAS,GAC9B,SAAS,CAOX;AAED,kCAAkC;AAClC,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

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

@@ -0,0 +1,29 @@
+/**
+ * Public entry point for pin_to_commit handling. Tools call
+ * `readerFor(sddRoot, pin_to_commit)` and get an SddReader they can
+ * query without branching on live vs. pinned.
+ *
+ * A pinned reader materialises a temporary git worktree at the
+ * resolved SHA and returns a liveReader pointed at it. Every existing
+ * filesystem helper keeps working; responses echo the resolved SHA
+ * via `reader.pin`.
+ */
+import { liveReader } from "../reader.js";
+import { materialisePinnedWorktree, releasePinnedWorktrees } from "./read.js";
+import { resolvePin } from "./resolve.js";
+export { resolvePin } from "./resolve.js";
+export { materialisePinnedWorktree, releasePinnedWorktrees } from "./read.js";
+export * from "./errors.js";
+export function readerFor(sddRoot, pinToCommit) {
+    if (!pinToCommit || pinToCommit.trim().length === 0) {
+        return liveReader(sddRoot);
+    }
+    const { sha } = resolvePin(sddRoot, pinToCommit);
+    const wtPath = materialisePinnedWorktree(sddRoot, sha);
+    return liveReader(wtPath, sha);
+}
+/** Shutdown hook — idempotent. */
+export function shutdownPinSubsystem() {
+    releasePinnedWorktrees();
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/mcp/pin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAC9E,cAAc,aAAa,CAAC;AAE5B,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,WAA+B;IAE/B,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,oBAAoB;IAClC,sBAAsB,EAAE,CAAC;AAC3B,CAAC"}