@sdd-method/sdd-cli 0.10.0 → 0.11.0

package/dist/lib/catalogue/traceability-loader.js

@@ -0,0 +1,217 @@
+// Traceability manifest loader — walks `docs/domains/**​/*.traceability.yaml`
+// and returns parsed declarations.
+//
+// The traceability manifest is per-capability declarative metadata that
+// the canonical builder reads to populate `capabilities.csv` and the
+// five capability_* edge catalogues (services, adrs, features,
+// contracts, events). One YAML per capability; the canonical layout is
+// `docs/domains/{domain}/product/{capability}.traceability.yaml`.
+//
+// Schema reference: docs/method/methods/capability-traceability-manifest-template.yaml
+// in sdd-method (per ADR 0047 / capability-spec-template.md).
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { parse as parseYaml } from "yaml";
+const DOMAINS_DIR_REL = join("docs", "domains");
+export async function loadTraceabilityManifests(opts) {
+    const root = join(opts.sddPath, DOMAINS_DIR_REL);
+    let yamlPaths;
+    try {
+        yamlPaths = await collectYamlPaths(root, /\.traceability\.yaml$/);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+            // No domains dir → no traceability data; return empty.
+            return [];
+        }
+        throw err;
+    }
+    const manifests = [];
+    for (const path of yamlPaths.sort()) {
+        const text = await readFile(path, "utf-8");
+        let raw;
+        try {
+            raw = parseYaml(text);
+        }
+        catch (err) {
+            opts.findings.add("convention", `failed to parse YAML at ${relative(opts.sddPath, path)}: ${err.message}`);
+            continue;
+        }
+        if (!raw || typeof raw !== "object") {
+            opts.findings.add("convention", `${relative(opts.sddPath, path)}: not an object — skipped`);
+            continue;
+        }
+        const obj = raw;
+        const cap = obj["capability"] ?? {};
+        const capId = String(cap["id"] ?? "").trim();
+        if (capId === "") {
+            opts.findings.add("convention", `${relative(opts.sddPath, path)}: missing capability.id`);
+            continue;
+        }
+        const relPath = relative(opts.sddPath, path);
+        const domainFromPath = inferDomainFromPath(relPath);
+        const declaredDomain = String(cap["domain"] ?? "").trim();
+        if (declaredDomain && domainFromPath && declaredDomain !== domainFromPath) {
+            opts.findings.add("divergence", `${relPath}: capability.domain="${declaredDomain}" disagrees with path domain "${domainFromPath}"`);
+        }
+        const capability = {
+            id: capId,
+            domain: declaredDomain || domainFromPath,
+            ...(typeof cap["capability_spec"] === "string"
+                ? { capability_spec: cap["capability_spec"] }
+                : {}),
+            ...(typeof cap["feature_directory"] === "string"
+                ? { feature_directory: cap["feature_directory"] }
+                : {}),
+            ...(typeof cap["status"] === "string" ? { status: cap["status"] } : {}),
+        };
+        manifests.push({
+            path,
+            relPath,
+            domainFromPath,
+            capability,
+            traceability: extractTraceabilityBlock(obj["traceability"]),
+            data: raw,
+        });
+    }
+    return manifests;
+}
+function extractTraceabilityBlock(raw) {
+    if (!raw || typeof raw !== "object")
+        return {};
+    const t = raw;
+    const runway = t["runway"];
+    const adrs = t["adrs"];
+    const services = t["services"];
+    const contracts = t["contracts"];
+    return {
+        ...(runway && typeof runway === "object" ? { runway: extractRunway(runway) } : {}),
+        ...(Array.isArray(adrs) ? { adrs: extractAdrs(adrs) } : {}),
+        ...(Array.isArray(services) ? { services: extractServices(services) } : {}),
+        ...(contracts && typeof contracts === "object"
+            ? { contracts: extractContracts(contracts) }
+            : {}),
+    };
+}
+function extractRunway(raw) {
+    if (!raw || typeof raw !== "object")
+        return {};
+    const r = raw;
+    const enables = Array.isArray(r["enables"])
+        ? r["enables"].filter((e) => typeof e === "string")
+        : undefined;
+    return {
+        ...(typeof r["classification"] === "string"
+            ? { classification: r["classification"] }
+            : {}),
+        ...(enables ? { enables } : {}),
+    };
+}
+function extractAdrs(raw) {
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const o = item;
+        const id = String(o["id"] ?? "").trim();
+        if (!id)
+            continue;
+        out.push({
+            id,
+            ...(typeof o["path"] === "string" ? { path: o["path"] } : {}),
+            ...(typeof o["relationship"] === "string"
+                ? { relationship: o["relationship"] }
+                : {}),
+            ...(typeof o["notes"] === "string" ? { notes: o["notes"] } : {}),
+        });
+    }
+    return out;
+}
+function extractServices(raw) {
+    const out = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const o = item;
+        const id = String(o["id"] ?? "").trim();
+        if (!id)
+            continue;
+        out.push({
+            id,
+            ...(typeof o["owner_domain"] === "string"
+                ? { owner_domain: o["owner_domain"] }
+                : {}),
+            ...(typeof o["role"] === "string" ? { role: o["role"] } : {}),
+            ...(typeof o["status"] === "string" ? { status: o["status"] } : {}),
+            ...(typeof o["notes"] === "string" ? { notes: o["notes"] } : {}),
+        });
+    }
+    return out;
+}
+function extractContracts(raw) {
+    const o = raw;
+    const arr = (key) => {
+        const v = o[key];
+        if (!Array.isArray(v))
+            return undefined;
+        return v.filter((s) => typeof s === "string");
+    };
+    const openapi = arr("openapi");
+    const proto = arr("proto");
+    const avro = arr("avro");
+    return {
+        ...(openapi ? { openapi } : {}),
+        ...(proto ? { proto } : {}),
+        ...(avro ? { avro } : {}),
+    };
+}
+function inferDomainFromPath(relPath) {
+    const parts = relPath.split(sep);
+    const idx = parts.indexOf("domains");
+    if (idx === -1 || idx + 1 >= parts.length)
+        return "";
+    return parts[idx + 1] ?? "";
+}
+async function collectYamlPaths(dir, pattern) {
+    const out = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return [];
+        throw err;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...(await collectYamlPaths(full, pattern)));
+        }
+        else if (entry.isFile() && pattern.test(entry.name)) {
+            out.push(full);
+        }
+    }
+    return out;
+}
+/** Convenience: read a file's first non-empty line, returning the trimmed value. */
+export async function readFirstNonEmptyLine(path) {
+    try {
+        const s = await stat(path);
+        if (!s.isFile())
+            return "";
+    }
+    catch {
+        return "";
+    }
+    const text = await readFile(path, "utf-8");
+    for (const line of text.split(/\r?\n/)) {
+        const t = line.trim();
+        if (t !== "")
+            return t;
+    }
+    return "";
+}
+//# sourceMappingURL=traceability-loader.js.map

package/dist/lib/catalogue/traceability-loader.js.map

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

package/dist/lib/catalogue/validate.d.ts

@@ -0,0 +1,16 @@
+export interface ValidateInputs {
+    /** SDD repo root (defaults to cwd). */
+    readonly sddPath?: string;
+    /** Strict mode — non-zero exit on any finding. */
+    readonly strict?: boolean;
+}
+export interface ValidateResult {
+    readonly exitCode: number;
+    readonly schemaVersion: string;
+    readonly internalFkPass: boolean;
+    readonly columnShapeOk: boolean;
+    readonly findingsCount: number;
+}
+export type Writer = (s: string) => void;
+export declare function runCatalogueValidate(inputs: ValidateInputs, write: Writer): Promise<ValidateResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/lib/catalogue/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/validate.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzC,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CA4GzB"}

package/dist/lib/catalogue/validate.js

@@ -0,0 +1,137 @@
+// `sdd-cli catalogue validate` — re-validate an existing catalogues/
+// directory without rebuilding. Two checks per the canonical CLI spec:
+//
+//   1. Column-shape check: every CSV's header row must match the
+//      canonical schema's declared columns (exact set + order).
+//   2. FK validation: full pass over the loaded rows, internal mode
+//      (external FKs treated per their declared flag — same semantics
+//      as `catalogue build`). Adopters who want post-merge validation
+//      run `catalogue aggregate` instead.
+//
+// Outputs the same shape of findings as `build` so consumers can pipe
+// either through the same parser. Exit 0 on PASS; non-zero on shape
+// drift OR internal-FK FAIL.
+import { stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { CLI_VERSION } from "./cli-version.js";
+import { readCatalogueCsv } from "./csv-reader.js";
+import { writeCatalogue } from "./csv-writer.js";
+import { FindingsLog } from "./findings.js";
+import { validateForeignKeys } from "./fk-validator.js";
+import { loadCanonicalSchema } from "./schema-loader.js";
+export async function runCatalogueValidate(inputs, write) {
+    const sddPath = resolve(inputs.sddPath ?? process.cwd());
+    const cataloguesDir = join(sddPath, "catalogues");
+    const schema = await loadCanonicalSchema();
+    write(`sdd-cli catalogue validate (canonical schema ${schema.schemaVersion}, cli ${CLI_VERSION})\n`);
+    // Existence check on catalogues/ — fail fast with a clear message.
+    try {
+        const s = await stat(cataloguesDir);
+        if (!s.isDirectory()) {
+            throw new Error(`catalogues/ at ${cataloguesDir} exists but is not a directory`);
+        }
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error(`catalogues/ not found at ${cataloguesDir}\n` +
+                `  Run \`sdd-cli catalogue build\` before \`validate\`.`);
+        }
+        throw err;
+    }
+    const findings = new FindingsLog();
+    const rowsByCatalogue = new Map();
+    let columnShapeOk = true;
+    for (const cat of schema.catalogues) {
+        const filePath = join(cataloguesDir, `${cat.name}.csv`);
+        let parsed;
+        try {
+            parsed = await readCatalogueCsv(filePath);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                // Missing file is a shape failure — every catalogue declared in
+                // the schema MUST have a CSV (headers-only acceptable).
+                findings.add("convention", `catalogues/${cat.name}.csv missing — every schema catalogue must have a file (headers-only acceptable)`);
+                columnShapeOk = false;
+                rowsByCatalogue.set(cat.name, []);
+                continue;
+            }
+            throw err;
+        }
+        const expected = cat.columns.map((c) => c.name);
+        const drift = compareColumns(expected, parsed.columns);
+        if (drift !== null) {
+            findings.add("convention", `catalogues/${cat.name}.csv: column shape drift — ${drift}`);
+            columnShapeOk = false;
+        }
+        rowsByCatalogue.set(cat.name, parsed.rows);
+    }
+    const fk = validateForeignKeys(schema, rowsByCatalogue, findings);
+    // Report.
+    const findingsText = findings.render();
+    if (findingsText)
+        write(`\n${findingsText}\n`);
+    if (columnShapeOk) {
+        write(`\nColumn-shape check: PASS\n`);
+    }
+    else {
+        write(`\nColumn-shape check: FAIL\n`);
+    }
+    if (fk.internalPass) {
+        write(`FK validation (internal): PASS\n`);
+    }
+    else {
+        write(`FK validation (internal): FAIL (${fk.internalFailures.length} dangling)\n`);
+        for (const f of fk.internalFailures) {
+            write(`  ${f.catalogue}.${f.column}: row pk=${f.referencingRow} → ${f.target}=${f.value || "<empty>"}\n`);
+        }
+    }
+    if (fk.externalFindings > 0) {
+        write(`External findings: ${fk.externalFindings} (validated by aggregator)\n`);
+    }
+    // Force-touch writeCatalogue to keep imports honest if a future
+    // refactor wants to re-emit a cleaned-up file from validate. Today
+    // validate is read-only.
+    void writeCatalogue;
+    const strictFail = inputs.strict === true && findings.count() > 0;
+    const exitCode = !columnShapeOk || !fk.internalPass || strictFail ? 1 : 0;
+    return {
+        exitCode,
+        schemaVersion: schema.schemaVersion,
+        internalFkPass: fk.internalPass,
+        columnShapeOk,
+        findingsCount: findings.count(),
+    };
+}
+/**
+ * Compare a CSV's actual column header against the schema's declared
+ * column order. Returns null if exactly equal (order included), or a
+ * one-line description of the drift otherwise.
+ */
+function compareColumns(expected, actual) {
+    if (expected.length === actual.length) {
+        let equal = true;
+        for (let i = 0; i < expected.length; i++) {
+            if (expected[i] !== actual[i]) {
+                equal = false;
+                break;
+            }
+        }
+        if (equal)
+            return null;
+    }
+    const expectedSet = new Set(expected);
+    const actualSet = new Set(actual);
+    const missing = expected.filter((c) => !actualSet.has(c));
+    const extra = actual.filter((c) => !expectedSet.has(c));
+    if (missing.length === 0 && extra.length === 0) {
+        return `column order differs (expected: ${expected.join(",")} | got: ${actual.join(",")})`;
+    }
+    const parts = [];
+    if (missing.length > 0)
+        parts.push(`missing: ${missing.join(",")}`);
+    if (extra.length > 0)
+        parts.push(`unexpected: ${extra.join(",")}`);
+    return parts.join("; ");
+}
+//# sourceMappingURL=validate.js.map

package/dist/lib/catalogue/validate.js.map

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

package/dist/lib/catalogue/version.d.ts

@@ -0,0 +1,3 @@
+export type Writer = (s: string) => void;
+export declare function runCatalogueVersion(write: Writer): Promise<void>;
+//# sourceMappingURL=version.d.ts.map

package/dist/lib/catalogue/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/version.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzC,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtE"}

package/dist/lib/catalogue/version.js

@@ -0,0 +1,18 @@
+// `sdd-cli catalogue version` — prints the canonical schema version
+// and the sdd-cli version pin so adopters can verify their tooling
+// matches the schema they expect.
+import { CLI_VERSION } from "./cli-version.js";
+import { SCHEMA_COMPAT } from "./schema-compat.js";
+import { loadCanonicalSchema } from "./schema-loader.js";
+export async function runCatalogueVersion(write) {
+    const schema = await loadCanonicalSchema();
+    write([
+        `sdd-cli                    ${CLI_VERSION}`,
+        `catalogue schema           ${schema.schemaVersion}`,
+        `accepted catalogue range   ${SCHEMA_COMPAT.catalogue_schema}`,
+        `accepted sdd_manifest      ${SCHEMA_COMPAT.sdd_manifest}`,
+        `accepted aggregation       ${SCHEMA_COMPAT.aggregation_manifest}`,
+        "",
+    ].join("\n"));
+}
+//# sourceMappingURL=version.js.map

package/dist/lib/catalogue/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/lib/catalogue/version.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,mEAAmE;AACnE,kCAAkC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIzD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAa;IACrD,MAAM,MAAM,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC3C,KAAK,CACH;QACE,8BAA8B,WAAW,EAAE;QAC3C,8BAA8B,MAAM,CAAC,aAAa,EAAE;QACpD,8BAA8B,aAAa,CAAC,gBAAgB,EAAE;QAC9D,8BAA8B,aAAa,CAAC,YAAY,EAAE;QAC1D,8BAA8B,aAAa,CAAC,oBAAoB,EAAE;QAClE,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC"}

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

@@ -3,7 +3,7 @@
  * released; Phase 6 of the MCP plan may swap this for a generated file
  * populated by `npm version`.
  */
-export declare const SERVER_VERSION = "0.10.0";
+export declare const SERVER_VERSION = "0.11.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.js

@@ -4,7 +4,7 @@
  * populated by `npm version`.
  */
 // Mirror of package.json version — bump in lockstep on release.
-export const SERVER_VERSION = "0.10.0";
+export const SERVER_VERSION = "0.11.0";
 export const DISTRIBUTION = "sdd-method";
 export const MCP_PROTOCOL_SPEC_VERSION = "2025-06-18";
 //# sourceMappingURL=build-info.js.map

package/dist/verbs/catalogue.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerCatalogue(program: Command): void;
+//# sourceMappingURL=catalogue.d.ts.map

package/dist/verbs/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../src/verbs/catalogue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BzC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4FxD"}

package/dist/verbs/catalogue.js

@@ -0,0 +1,60 @@
+import { runCatalogueBuild, runCatalogueAggregate, runCatalogueValidate, runCatalogueVersion, } from "../lib/catalogue/index.js";
+export function registerCatalogue(program) {
+    const catalogue = program
+        .command("catalogue")
+        .description("Build, aggregate, and validate per-SDD catalogues per ADR 0134");
+    catalogue
+        .command("build")
+        .description("Build catalogues for the current SDD repo from method-defined sources")
+        .option("--sdd-path <path>", "Path to the SDD repo root (defaults to cwd)")
+        .option("--out <path>", "Output directory for catalogues/ (defaults to <sdd-path>/catalogues)")
+        .option("--strict", "Treat findings as failures (default: only internal FK FAIL exits non-zero)")
+        .action(async (opts) => {
+        const result = await runCatalogueBuild({
+            ...(opts.sddPath !== undefined ? { sddPath: opts.sddPath } : {}),
+            ...(opts.out !== undefined ? { outDir: opts.out } : {}),
+            ...(opts.strict !== undefined ? { strict: opts.strict } : {}),
+        }, (s) => process.stdout.write(s));
+        if (result.exitCode !== 0)
+            process.exit(result.exitCode);
+    });
+    catalogue
+        .command("aggregate")
+        .description("Aggregate sibling SDD catalogues into a single ecosystem catalogue")
+        .option("--sdd-path <path>", "Path to the ecosystem-root SDD repo (defaults to cwd)")
+        .option("--manifest <path>", "Path to the aggregation manifest (defaults to orchestration/aggregation-manifest.yaml)")
+        .option("--out <path>", "Output directory for aggregated catalogues/ (defaults to <sdd-path>/catalogues-aggregated)")
+        .option("--strict", "Treat findings as failures")
+        .action(async (opts) => {
+        const result = await runCatalogueAggregate({
+            ...(opts.sddPath !== undefined ? { sddPath: opts.sddPath } : {}),
+            ...(opts.manifest !== undefined
+                ? { manifestPath: opts.manifest }
+                : {}),
+            ...(opts.out !== undefined ? { outDir: opts.out } : {}),
+            ...(opts.strict !== undefined ? { strict: opts.strict } : {}),
+        }, (s) => process.stdout.write(s));
+        if (result.exitCode !== 0)
+            process.exit(result.exitCode);
+    });
+    catalogue
+        .command("validate")
+        .description("Re-run column-shape + FK validation against existing catalogues/ (no rebuild)")
+        .option("--sdd-path <path>", "Path to the SDD repo root (defaults to cwd)")
+        .option("--strict", "Treat findings as failures")
+        .action(async (opts) => {
+        const result = await runCatalogueValidate({
+            ...(opts.sddPath !== undefined ? { sddPath: opts.sddPath } : {}),
+            ...(opts.strict !== undefined ? { strict: opts.strict } : {}),
+        }, (s) => process.stdout.write(s));
+        if (result.exitCode !== 0)
+            process.exit(result.exitCode);
+    });
+    catalogue
+        .command("version")
+        .description("Print the catalogue schema version + sdd-cli version pin")
+        .action(async () => {
+        await runCatalogueVersion((s) => process.stdout.write(s));
+    });
+}
+//# sourceMappingURL=catalogue.js.map

package/dist/verbs/catalogue.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sdd-method/sdd-cli",
-  "version": "0.10.0",
-  "description": "Method-layer CLI for SDD repository lifecycle — init, sync, validate, list, plan, generate-claude-md, mcp serve. v0.10.0 adds reverse profile + reverse-baseline support (the fourth distribution baseline), enabling sync against brownfield reverse-SDD corpora alongside platform/app/integration profiles. v0.9.0 shipped method enforcement automation Phases 0+1+2 per ADR 0129: GitHub Actions CI baseline seeded by init/sync (Layer 1 authoritative) and opt-in Claude Code hooks via --agent-harness claude-code (Layer 2 accelerator), both delegating to sdd-cli validate with per-entry ownership.",
+  "version": "0.11.0",
+  "description": "Method-layer CLI for SDD repository lifecycle — init, sync, validate, list, plan, generate-claude-md, mcp serve, catalogue {build,aggregate,validate,version}. v0.11.0 ships the canonical catalogue surface per ADR 0134 + schema 2.1.0 (ADR 0136): per-SDD catalogue build covering all four profiles, federation aggregator, validate + version subcommands, and the C4 + persona/journey/product-edge builders that complete Phase 2. v0.10.0 added reverse profile + reverse-baseline support (the fourth distribution baseline), enabling sync against brownfield reverse-SDD corpora alongside platform/app/integration profiles.",
   "keywords": [
     "sdd-method",
     "sdd",
@@ -35,7 +35,7 @@
     "NOTICE"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/copy-yaml-assets.mjs",
     "typecheck": "tsc --noEmit",
     "test": "npm run build && vitest run",
     "test:watch": "vitest",

package/scripts/copy-yaml-assets.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// Copy YAML asset files from src/ to dist/ preserving relative paths.
+// Run as a postbuild step (tsc doesn't copy non-TS files).
+//
+// Currently the only such asset is src/lib/catalogue/canonical-schema.yaml,
+// vendored from sdd-method per the SCHEMA_COMPAT contract in
+// src/lib/catalogue/schema-compat.ts. Add more YAML assets here as the
+// canonical builder grows.
+
+import { mkdir, readdir, copyFile, stat } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { dirname, join, relative } from "node:path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const SRC = join(__dirname, "..", "src");
+const DEST = join(__dirname, "..", "dist");
+
+async function* walk(dir) {
+  for (const entry of await readdir(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      yield* walk(full);
+    } else if (entry.name.endsWith(".yaml") || entry.name.endsWith(".yml")) {
+      yield full;
+    }
+  }
+}
+
+let copied = 0;
+for await (const srcFile of walk(SRC)) {
+  const rel = relative(SRC, srcFile);
+  const destFile = join(DEST, rel);
+  await mkdir(dirname(destFile), { recursive: true });
+  await copyFile(srcFile, destFile);
+  copied++;
+}
+console.log(`copy-yaml-assets: ${copied} file(s) copied to dist/`);

package/scripts/sync-canonical-schema.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Sync the canonical catalogue-schema.yaml from sdd-method into sdd-cli's
+# vendored copy. Run when sdd-method publishes a new schema_version that
+# sdd-cli should adopt (per SCHEMA_COMPAT range in src/lib/catalogue/schema-compat.ts).
+#
+# Usage:
+#   scripts/sync-canonical-schema.sh                     # sync from default ~/Projects/sdd-method
+#   scripts/sync-canonical-schema.sh /path/to/sdd-method # sync from explicit path
+#
+# After syncing, run:
+#   npm run build && npm test
+# to verify nothing in the canonical changed in a way SCHEMA_COMPAT can't accept.
+
+set -euo pipefail
+
+SDD_METHOD_PATH="${1:-$HOME/Projects/sdd-method}"
+SOURCE="$SDD_METHOD_PATH/docs/method/methods/catalogue-schema.yaml"
+DEST="$(dirname "$0")/../src/lib/catalogue/canonical-schema.yaml"
+
+if [[ ! -f "$SOURCE" ]]; then
+  echo "ERROR: canonical schema not found at $SOURCE" >&2
+  echo "       Pass the sdd-method repo path as the first argument." >&2
+  exit 1
+fi
+
+OLD_VERSION=""
+if [[ -f "$DEST" ]]; then
+  OLD_VERSION=$(grep -E '^schema_version:' "$DEST" | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
+fi
+NEW_VERSION=$(grep -E '^schema_version:' "$SOURCE" | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
+
+cp "$SOURCE" "$DEST"
+
+if [[ -n "$OLD_VERSION" && "$OLD_VERSION" != "$NEW_VERSION" ]]; then
+  echo "Synced canonical-schema.yaml: $OLD_VERSION -> $NEW_VERSION"
+  echo "Check src/lib/catalogue/schema-compat.ts catalogue_schema range covers $NEW_VERSION."
+else
+  echo "Synced canonical-schema.yaml @ $NEW_VERSION (unchanged)"
+fi