@sdd-method/sdd-cli 0.9.0

package/dist/lib/plan/read-sdd.js

@@ -0,0 +1,102 @@
+import { access, readdir, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { liveReader } from "../mcp/reader.js";
+import { parseRepoConfigFile } from "../sdd-index/repo-config.js";
+/**
+ * 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 async function readSdd(inputs) {
+    const { sddRoot, service, capability, domain } = inputs;
+    const manifestAbsPath = join(sddRoot, "orchestration/repo-config", domain, `${service}.yaml`);
+    const repoConfig = await readRepoConfigFor(sddRoot, manifestAbsPath);
+    const featuresDir = join(sddRoot, "docs/domains", domain, "product/features", capability);
+    const featureSpecs = await listFeatureSpecs(featuresDir);
+    const featureSpecRelativePaths = featureSpecs.map((p) => join("docs/domains", domain, "product/features", capability, p));
+    const capabilitySpecPath = join("docs/domains", domain, "product", `${capability}.md`);
+    const capabilitySpecPresent = await fileExists(join(sddRoot, capabilitySpecPath));
+    const traceabilityManifestPath = join("docs/domains", domain, "product", `${capability}.traceability.yaml`);
+    const traceabilityManifestPresent = await fileExists(join(sddRoot, traceabilityManifestPath));
+    return {
+        sddRoot,
+        service,
+        capability,
+        domain,
+        repoConfig,
+        featureSpecCount: featureSpecs.length,
+        featureSpecRelativePaths,
+        capabilitySpecPresent,
+        capabilitySpecPath,
+        traceabilityManifestPresent,
+        traceabilityManifestPath,
+    };
+}
+async function readRepoConfigFor(sddRoot, manifestAbsPath) {
+    const empty = {
+        path: manifestAbsPath,
+        aggregates: [],
+        internalDependencies: [],
+        contracts: { openapi: [], proto: [], avro: [], spicedb: [] },
+    };
+    if (!(await fileExists(manifestAbsPath)))
+        return empty;
+    const reader = liveReader(sddRoot);
+    const relPath = relative(sddRoot, manifestAbsPath);
+    const warnings = [];
+    const node = parseRepoConfigFile(reader, relPath, warnings);
+    if (!node)
+        return empty;
+    return legacyShape(node, manifestAbsPath);
+}
+function legacyShape(node, sourcePath) {
+    const byKind = {
+        openapi: [],
+        proto: [],
+        avro: [],
+        spicedb: [],
+    };
+    for (const ref of node.contracts)
+        byKind[ref.kind].push(ref.path);
+    return {
+        path: sourcePath,
+        ...(node.description !== undefined ? { description: node.description } : {}),
+        ...(node.serviceType !== undefined ? { serviceType: node.serviceType } : {}),
+        aggregates: Array.from(node.aggregates),
+        internalDependencies: Array.from(node.internalDependencies),
+        contracts: byKind,
+    };
+}
+async function listFeatureSpecs(featuresDir) {
+    if (!(await fileExists(featuresDir)))
+        return [];
+    const entries = await readdir(featuresDir);
+    const specs = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".md"))
+            continue;
+        const full = join(featuresDir, entry);
+        const s = await stat(full);
+        if (s.isFile())
+            specs.push(entry);
+    }
+    specs.sort();
+    return specs;
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=read-sdd.js.map

package/dist/lib/plan/read-sdd.js.map

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

package/dist/lib/plan/render-template.d.ts

@@ -0,0 +1,8 @@
+import type { SddSnapshot } from "./read-sdd.js";
+export interface RenderInputs {
+    snapshot: SddSnapshot;
+    platformCliVersionHint: string;
+    today: string;
+}
+export declare function renderPilotKickoff(inputs: RenderInputs): Promise<string>;
+//# sourceMappingURL=render-template.d.ts.map

package/dist/lib/plan/render-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-template.d.ts","sourceRoot":"","sources":["../../../src/lib/plan/render-template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAKjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E"}

package/dist/lib/plan/render-template.js

@@ -0,0 +1,60 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+const TEMPLATE_REL_PATH = "docs/method/methods/pilot-kickoff-template.md";
+const VAR_PATTERN = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
+export async function renderPilotKickoff(inputs) {
+    const { snapshot } = inputs;
+    const templatePath = join(snapshot.sddRoot, TEMPLATE_REL_PATH);
+    const template = await readFile(templatePath, "utf8");
+    const vars = buildVars(inputs);
+    return template.replace(VAR_PATTERN, (match, name) => {
+        if (!(name in vars)) {
+            // Leave unknown placeholders intact so the human can see what wasn't
+            // prefilled and fill it themselves, rather than silently blanking.
+            return match;
+        }
+        return vars[name] ?? "";
+    });
+}
+function buildVars(inputs) {
+    const { snapshot, platformCliVersionHint, today } = inputs;
+    const { repoConfig } = snapshot;
+    const inlineList = (items, sep = ", ") => items.length === 0 ? "_(none declared — fill in)_" : items.join(sep);
+    const bulletList = (items) => items.length === 0 ? "- _(none declared — fill in)_" : items.map((i) => `- ${i}`).join("\n");
+    return {
+        service_name: snapshot.service,
+        capability: snapshot.capability,
+        capability_display: toTitleCase(snapshot.capability.replace(/-/g, " ")),
+        domain: snapshot.domain,
+        domain_display: toTitleCase(snapshot.domain),
+        service_type: repoConfig.serviceType ?? "_(not declared — fill in)_",
+        today,
+        platform_cli_version_hint: platformCliVersionHint,
+        capability_spec_path: snapshot.capabilitySpecPath,
+        capability_spec_present: snapshot.capabilitySpecPresent ? "present" : "**MISSING — author before kickoff**",
+        capability_spec_state: snapshot.capabilitySpecPresent
+            ? "Exists; run `/validate-intent-quality` before kickoff"
+            : "**MISSING** — author before kickoff",
+        traceability_manifest_path: snapshot.traceabilityManifestPath,
+        traceability_manifest_present: snapshot.traceabilityManifestPresent ? "present" : "**MISSING — author before kickoff**",
+        traceability_manifest_state: snapshot.traceabilityManifestPresent
+            ? "Exists; confirm `status:` before kickoff"
+            : "**MISSING** — author before kickoff",
+        feature_spec_count: String(snapshot.featureSpecCount),
+        feature_spec_paths_inline: inlineList(snapshot.featureSpecRelativePaths),
+        feature_spec_paths_list: bulletList(snapshot.featureSpecRelativePaths),
+        aggregate_count: String(repoConfig.aggregates.length),
+        aggregate_list_inline: inlineList(repoConfig.aggregates),
+        internal_dependencies_inline: repoConfig.internalDependencies.length === 0
+            ? "_(none — zero internal mocking required)_"
+            : repoConfig.internalDependencies.join(", "),
+        openapi_count: String(repoConfig.contracts.openapi.length),
+        proto_count: String(repoConfig.contracts.proto.length),
+        avro_count: String(repoConfig.contracts.avro.length),
+        spicedb_count: String(repoConfig.contracts.spicedb.length),
+    };
+}
+function toTitleCase(s) {
+    return s.replace(/\b\w/g, (c) => c.toUpperCase());
+}
+//# sourceMappingURL=render-template.js.map

package/dist/lib/plan/render-template.js.map

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

package/dist/lib/repo-kind.d.ts

@@ -0,0 +1,20 @@
+export type Profile = "platform" | "application" | "integration";
+export type RepoKind = "platform-product" | "application-product" | "integration-product";
+export type BundleName = "platform-baseline" | "app-baseline" | "integration-baseline";
+export declare const REPO_KIND_FILE = ".sdd-repo-kind";
+/**
+ * Legacy marker filename from the pre-rebrand era. Read-only fallback during
+ * the rebrand transition: `readRepoKind` accepts either filename; `sync`
+ * auto-migrates legacy → canonical. New writes always use `REPO_KIND_FILE`.
+ * Drop after one minor-version overlap.
+ */
+export declare const LEGACY_REPO_KIND_FILE = ".iteraitive-repo-kind";
+export declare function profileFromRepoKind(kind: RepoKind): Profile;
+export declare function repoKindFromProfile(profile: Profile): RepoKind;
+export declare function profileFromBundleName(name: BundleName): Profile;
+export declare function bundleNameFromProfile(profile: Profile): BundleName;
+export declare function isRepoKind(value: string): value is RepoKind;
+export declare function isBundleName(value: string): value is BundleName;
+export declare function readRepoKind(repoRoot: string): Promise<RepoKind | null>;
+export declare function writeRepoKind(repoRoot: string, kind: RepoKind): Promise<void>;
+//# sourceMappingURL=repo-kind.d.ts.map

package/dist/lib/repo-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-kind.d.ts","sourceRoot":"","sources":["../../src/lib/repo-kind.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,UAAU,GAClB,mBAAmB,GACnB,cAAc,GACd,sBAAsB,CAAC;AAE3B,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AA0B7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE3D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAE9D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAE/D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAElE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAoB7E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/lib/repo-kind.js

@@ -0,0 +1,73 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export const REPO_KIND_FILE = ".sdd-repo-kind";
+/**
+ * Legacy marker filename from the pre-rebrand era. Read-only fallback during
+ * the rebrand transition: `readRepoKind` accepts either filename; `sync`
+ * auto-migrates legacy → canonical. New writes always use `REPO_KIND_FILE`.
+ * Drop after one minor-version overlap.
+ */
+export const LEGACY_REPO_KIND_FILE = ".iteraitive-repo-kind";
+const PROFILE_BY_REPO_KIND = {
+    "platform-product": "platform",
+    "application-product": "application",
+    "integration-product": "integration",
+};
+const REPO_KIND_BY_PROFILE = {
+    platform: "platform-product",
+    application: "application-product",
+    integration: "integration-product",
+};
+const PROFILE_BY_BUNDLE_NAME = {
+    "platform-baseline": "platform",
+    "app-baseline": "application",
+    "integration-baseline": "integration",
+};
+const BUNDLE_NAME_BY_PROFILE = {
+    platform: "platform-baseline",
+    application: "app-baseline",
+    integration: "integration-baseline",
+};
+export function profileFromRepoKind(kind) {
+    return PROFILE_BY_REPO_KIND[kind];
+}
+export function repoKindFromProfile(profile) {
+    return REPO_KIND_BY_PROFILE[profile];
+}
+export function profileFromBundleName(name) {
+    return PROFILE_BY_BUNDLE_NAME[name];
+}
+export function bundleNameFromProfile(profile) {
+    return BUNDLE_NAME_BY_PROFILE[profile];
+}
+export function isRepoKind(value) {
+    return value in PROFILE_BY_REPO_KIND;
+}
+export function isBundleName(value) {
+    return value in PROFILE_BY_BUNDLE_NAME;
+}
+export async function readRepoKind(repoRoot) {
+    // Canonical first; fall back to legacy marker during the rebrand transition.
+    for (const filename of [REPO_KIND_FILE, LEGACY_REPO_KIND_FILE]) {
+        const path = join(repoRoot, filename);
+        let raw;
+        try {
+            raw = await readFile(path, "utf8");
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                continue;
+            throw err;
+        }
+        const value = raw.trim();
+        if (!isRepoKind(value)) {
+            throw new Error(`Unrecognised ${filename} value: ${JSON.stringify(value)} at ${path}`);
+        }
+        return value;
+    }
+    return null;
+}
+export async function writeRepoKind(repoRoot, kind) {
+    await writeFile(join(repoRoot, REPO_KIND_FILE), `${kind}\n`, "utf8");
+}
+//# sourceMappingURL=repo-kind.js.map

package/dist/lib/repo-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-kind.js","sourceRoot":"","sources":["../../src/lib/repo-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAcjC,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAC/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D,MAAM,oBAAoB,GAAwC;IAChE,kBAAkB,EAAE,UAAU;IAC9B,qBAAqB,EAAE,aAAa;IACpC,qBAAqB,EAAE,aAAa;CACrC,CAAC;AAEF,MAAM,oBAAoB,GAAwC;IAChE,QAAQ,EAAE,kBAAkB;IAC5B,WAAW,EAAE,qBAAqB;IAClC,WAAW,EAAE,qBAAqB;CACnC,CAAC;AAEF,MAAM,sBAAsB,GAA0C;IACpE,mBAAmB,EAAE,UAAU;IAC/B,cAAc,EAAE,aAAa;IAC7B,sBAAsB,EAAE,aAAa;CACtC,CAAC;AAEF,MAAM,sBAAsB,GAA0C;IACpE,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,cAAc;IAC3B,WAAW,EAAE,sBAAsB;CACpC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAgB;IACpD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,IAAI,oBAAoB,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,IAAI,sBAAsB,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,6EAA6E;IAC7E,KAAK,MAAM,QAAQ,IAAI,CAAC,cAAc,EAAE,qBAAqB,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAC/D,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,gBAAgB,QAAQ,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CACtE,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,IAAc;IAEd,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC;AACvE,CAAC"}

package/dist/lib/scripts.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveBundledScript(name: string): string;
+//# sourceMappingURL=scripts.d.ts.map

package/dist/lib/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/lib/scripts.ts"],"names":[],"mappings":"AAGA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzD"}

package/dist/lib/scripts.js

@@ -0,0 +1,7 @@
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export function resolveBundledScript(name) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return resolve(here, "..", "..", "scripts", name);
+}
+//# sourceMappingURL=scripts.js.map

package/dist/lib/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../src/lib/scripts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/lib/sdd-index/cascade.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Library-level wrapper around `validate-cascade-completeness.sh --json`.
+ * Extracted from `src/lib/mcp/tools/cascade-impact.ts` so the tool and
+ * the Phase 5 `evaluate_cascade` prompt share one implementation.
+ *
+ * Structured errors are returned via `CascadeImpactError` rather than
+ * thrown at the McpEnvelopeError layer — callers decide whether to
+ * propagate as a tool error or embed in a prompt message.
+ */
+import type { SddReader } from "../mcp/reader.js";
+export declare const VALIDATOR_REL_PATH = "orchestration/scripts/validate-cascade-completeness.sh";
+export type CascadeChangeType = "service" | "capability" | "entity";
+export interface CascadeImpactArgs {
+    readonly change_type: CascadeChangeType;
+    readonly target: string;
+}
+export interface CascadeImpactPayload {
+    readonly query: {
+        readonly change_type: CascadeChangeType;
+        readonly target: string;
+    };
+    readonly affected: {
+        readonly services: ReadonlyArray<{
+            readonly service: string;
+            readonly domain: string | null;
+            readonly aggregates: readonly string[];
+            readonly internal_dependencies: readonly string[];
+        }>;
+        readonly capabilities: readonly string[];
+        readonly entities: readonly string[];
+        readonly contracts: readonly string[];
+    };
+    readonly missing_cascades: Readonly<Record<string, unknown>>;
+    readonly links: readonly string[];
+    readonly pin_to_commit: string;
+    readonly sources: readonly string[];
+}
+export type CascadeErrorCode = "CASCADE_VALIDATOR_UNAVAILABLE" | "CASCADE_VALIDATOR_FAILED" | "CASCADE_VALIDATOR_OUTPUT_INVALID";
+export declare class CascadeImpactError extends Error {
+    readonly code: CascadeErrorCode;
+    readonly remediation: string;
+    readonly context: Record<string, unknown>;
+    constructor(code: CascadeErrorCode, message: string, remediation: string, context?: Record<string, unknown>);
+}
+export declare function runCascadeImpact(reader: SddReader, args: CascadeImpactArgs): CascadeImpactPayload;
+//# sourceMappingURL=cascade.d.ts.map

package/dist/lib/sdd-index/cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../../../src/lib/sdd-index/cascade.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD,eAAO,MAAM,kBAAkB,2DAC2B,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrF,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;YAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;YAC/B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;YACvC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;SACnD,CAAC,CAAC;QACH,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;QACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;KACvC,CAAC;IACF,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,MAAM,gBAAgB,GACxB,+BAA+B,GAC/B,0BAA0B,GAC1B,kCAAkC,CAAC;AAEvC,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGxC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAQxC;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,iBAAiB,GACtB,oBAAoB,CAuFtB"}

package/dist/lib/sdd-index/cascade.js

@@ -0,0 +1,91 @@
+/**
+ * Library-level wrapper around `validate-cascade-completeness.sh --json`.
+ * Extracted from `src/lib/mcp/tools/cascade-impact.ts` so the tool and
+ * the Phase 5 `evaluate_cascade` prompt share one implementation.
+ *
+ * Structured errors are returned via `CascadeImpactError` rather than
+ * thrown at the McpEnvelopeError layer — callers decide whether to
+ * propagate as a tool error or embed in a prompt message.
+ */
+import { spawnSync } from "node:child_process";
+import { join } from "node:path";
+import { getSddIndex } from "./index.js";
+export const VALIDATOR_REL_PATH = "orchestration/scripts/validate-cascade-completeness.sh";
+export class CascadeImpactError extends Error {
+    code;
+    remediation;
+    context;
+    constructor(code, message, remediation, context = {}) {
+        super(message);
+        this.name = "CascadeImpactError";
+        this.code = code;
+        this.remediation = remediation;
+        this.context = context;
+    }
+}
+export function runCascadeImpact(reader, args) {
+    const validator = join(reader.sddRoot, VALIDATOR_REL_PATH);
+    if (!reader.isFile(VALIDATOR_REL_PATH)) {
+        throw new CascadeImpactError("CASCADE_VALIDATOR_UNAVAILABLE", `Cascade validator script not found at ${VALIDATOR_REL_PATH}.`, "The adopter SDD must ship orchestration/scripts/validate-cascade-completeness.sh (distributed by the method baseline). Run `sdd-cli sync` to refresh the orchestration tree, or hand-install the script from the canonical method repo.", { expected_path: VALIDATOR_REL_PATH, sdd_root: reader.sddRoot });
+    }
+    const mode = args.change_type === "entity"
+        ? "entities"
+        : args.change_type === "capability"
+            ? "capabilities"
+            : "services";
+    const result = spawnSync(validator, ["--json", mode, args.target], { cwd: reader.sddRoot, encoding: "utf8", timeout: 30_000 });
+    if (result.status !== 0) {
+        throw new CascadeImpactError("CASCADE_VALIDATOR_FAILED", `Cascade validator exited with code ${result.status ?? "(killed)"}.`, "Run the script directly to reproduce and inspect stderr. The MCP tool does not interpret non-zero exits.", {
+            exit_code: result.status,
+            stderr: result.stderr.slice(0, 2000),
+            command: [validator, "--json", mode, args.target],
+        });
+    }
+    let scriptOutput;
+    try {
+        scriptOutput = JSON.parse(result.stdout);
+    }
+    catch (err) {
+        throw new CascadeImpactError("CASCADE_VALIDATOR_OUTPUT_INVALID", `Cascade validator stdout was not valid JSON (${err.message}).`, "The script should emit a JSON object when called with --json. If the installed script does not yet support --json, upgrade the adopter orchestration tree or open an upstream PR against sdd-method.", { stdout_prefix: result.stdout.slice(0, 500) });
+    }
+    const index = getSddIndex(reader);
+    const affected = scriptOutput["affected"] ?? {};
+    const affectedServices = asStringArray(affected["services"]);
+    const servicesWithMetadata = affectedServices.map((id) => {
+        const svc = index.services.get(id);
+        return {
+            service: id,
+            domain: svc?.domain ?? null,
+            aggregates: svc ? Array.from(svc.aggregates) : [],
+            internal_dependencies: svc ? Array.from(svc.internalDependencies) : [],
+        };
+    });
+    const links = [];
+    for (const contractPath of asStringArray(affected["contracts"])) {
+        links.push(`sdd://contracts/${contractPath}`);
+    }
+    for (const id of affectedServices) {
+        const svc = index.services.get(id);
+        if (svc)
+            links.push(`sdd://repo-config/${svc.domain}/${id}`);
+    }
+    return {
+        query: { change_type: args.change_type, target: args.target },
+        affected: {
+            services: servicesWithMetadata,
+            capabilities: asStringArray(affected["capabilities"]),
+            entities: asStringArray(affected["entities"]),
+            contracts: asStringArray(affected["contracts"]),
+        },
+        missing_cascades: scriptOutput["missing_cascades"] ?? {},
+        links,
+        pin_to_commit: reader.pin,
+        sources: [`sdd://${VALIDATOR_REL_PATH}`],
+    };
+}
+function asStringArray(v) {
+    if (!Array.isArray(v))
+        return [];
+    return v.filter((x) => typeof x === "string");
+}
+//# sourceMappingURL=cascade.js.map

package/dist/lib/sdd-index/cascade.js.map

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

package/dist/lib/sdd-index/contracts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Extract producer metadata from contract artefacts.
+ *
+ * Each adopter uses different conventions inside the raw artefact
+ * format (OpenAPI `x-*` extensions, proto options, Avro doc fields,
+ * SpiceDB comments). We try a few best-effort patterns and fall back
+ * to marking the node as metadata-incomplete — it's better to return
+ * a partial graph than to fail hard.
+ *
+ * The shape we care about:
+ *   - `producedAggregates` — aggregate names this contract describes
+ *   - `producedEvents` — event names this contract publishes
+ *
+ * Producer / consumer *service* linkage is derived later in graph.ts
+ * from repo-config declarations, not from the artefact itself.
+ */
+import type { SddReader } from "../mcp/reader.js";
+import type { ContractKind, ContractNode } from "./types.js";
+export interface ContractParseResult {
+    readonly aggregates: readonly string[];
+    readonly events: readonly string[];
+    readonly metadataIncomplete: boolean;
+}
+/**
+ * Parse a single contract artefact and return its producer metadata.
+ * `relPath` is relative to the SDD root.
+ */
+export declare function readContract(reader: SddReader, relPath: string, kind: ContractKind): ContractNode;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/lib/sdd-index/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/lib/sdd-index/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GACjB,YAAY,CAuBd"}