@sdd-method/sdd-cli 0.9.0 → 0.11.0

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.9.0",
-  "description": "Method-layer CLI for SDD repository lifecycle — init, sync, validate, list, plan, generate-claude-md, mcp serve. v0.9.0 ships 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