domain-knowledge-kit 0.2.15 → 0.2.16

package/dist/shared/service-id.js

@@ -0,0 +1,64 @@
+/**
+ * Service identity loader.
+ *
+ * Reads `.dkk/service.yml` (if present) and returns the parsed
+ * `ServiceManifest`. Returns `null` for legacy repos that haven't
+ * adopted federation — the rest of the loader/validator stack treats
+ * `model.service === undefined` as "unfederated, behave as before".
+ *
+ * Validates against `tools/dkk/schema/service.schema.json` at load
+ * time so a malformed manifest produces a clean error up front
+ * instead of crashing later in the validator/CLI.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+import { parseYaml } from "./yaml.js";
+import { serviceFile, schemaDir } from "./paths.js";
+// ajv is a CJS package — use createRequire for ESM interop. Matches
+// the pattern used in validator.ts and tests.
+const require = createRequire(import.meta.url);
+const Ajv = require("ajv").default;
+const addFormats = require("ajv-formats").default;
+/** Cached Ajv instance with all DKK schemas loaded. */
+let cachedAjv = null;
+function getAjv() {
+    if (cachedAjv)
+        return cachedAjv;
+    const ajv = new Ajv({ allErrors: true, strict: true });
+    addFormats(ajv);
+    // Load all schemas so cross-refs ($ref) resolve.
+    const dir = schemaDir();
+    const fs = require("node:fs");
+    for (const f of fs.readdirSync(dir).filter((n) => n.endsWith(".schema.json"))) {
+        const schema = JSON.parse(fs.readFileSync(join(dir, f), "utf-8"));
+        ajv.addSchema(schema, schema.$id);
+    }
+    cachedAjv = ajv;
+    return ajv;
+}
+/**
+ * Load `.dkk/service.yml` from the given root (or auto-detected root).
+ * Returns the parsed manifest, or `null` if the file does not exist.
+ *
+ * Throws when the file exists but does not conform to
+ * `service.schema.json` — the message includes Ajv's error list so
+ * the user can fix the manifest directly.
+ */
+export function loadServiceId(root) {
+    const path = serviceFile(root);
+    if (!existsSync(path))
+        return null;
+    const text = readFileSync(path, "utf-8");
+    const parsed = parseYaml(text);
+    const ajv = getAjv();
+    const valid = ajv.validate("service.schema.json", parsed);
+    if (!valid) {
+        const details = (ajv.errors ?? [])
+            .map((e) => `  - ${e.instancePath || "/"}: ${e.message ?? "invalid"}`)
+            .join("\n");
+        throw new Error(`Invalid ${path}:\n${details}\n\nExpected shape: { name: kebab-case, exports: string[], description?: string }`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=service-id.js.map

package/dist/shared/service-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-id.js","sourceRoot":"","sources":["../../src/shared/service-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGpD,oEAAoE;AACpE,8CAA8C;AAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,OAAuC,CAAC;AACnE,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,OAA+C,CAAC;AAE1F,uDAAuD;AACvD,IAAI,SAAS,GAAoC,IAAI,CAAC;AAEtD,SAAS,MAAM;IACb,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,iDAAiD;IACjD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAA6B,CAAC;IAC1D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,SAAS,GAAG,GAAG,CAAC;IAChB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAkB,IAAI,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,YAAY,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC;aACrE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,MAAM,OAAO,mFAAmF,CAChH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shared/tests/paths.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=paths.test.d.ts.map

package/dist/shared/tests/paths.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.test.d.ts","sourceRoot":"","sources":["../../../src/shared/tests/paths.test.ts"],"names":[],"mappings":""}

package/dist/shared/tests/paths.test.js

@@ -0,0 +1,111 @@
+/**
+ * Tests for paths.ts — primarily the walk-up `repoRoot()` behaviour
+ * introduced for monorepo / sub-directory usage.
+ */
+import { mkdirSync, rmSync, realpathSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { repoRoot, findDkkRoot, serviceFile, federationFile, importedServiceDir } from "../paths.js";
+let passed = 0;
+let failed = 0;
+function assert(label, condition, detail) {
+    if (condition) {
+        console.log(`  OK: ${label}`);
+        passed++;
+    }
+    else {
+        console.error(`FAIL: ${label}${detail ? ` — ${detail}` : ""}`);
+        failed++;
+    }
+}
+// Save and restore cwd / env around each scenario.
+const originalCwd = process.cwd();
+const originalDisableWalkup = process.env.DKK_DISABLE_WALKUP;
+function withCwd(dir, fn) {
+    process.chdir(dir);
+    try {
+        return fn();
+    }
+    finally {
+        process.chdir(originalCwd);
+    }
+}
+// ── Setup fixture: nested service repo under a parent ──────────────────
+// Layout:
+//   <TMP>/repo/.dkk/                        ← the real repo root
+//   <TMP>/repo/services/foo/                ← service subdir, no .dkk
+//   <TMP>/repo/services/foo/src/            ← deeper subdir
+//   <TMP>/elsewhere/                        ← unrelated dir, no .dkk anywhere
+const RAW_TMP = join(tmpdir(), `dkk-paths-${Date.now()}`);
+mkdirSync(RAW_TMP, { recursive: true });
+// macOS resolves /tmp -> /private/tmp at chdir; mirror that so string
+// comparisons line up with process.cwd().
+const TMP = realpathSync(RAW_TMP);
+const REPO = join(TMP, "repo");
+const SERVICE = join(REPO, "services", "foo");
+const DEEP = join(SERVICE, "src");
+const ELSEWHERE = join(TMP, "elsewhere");
+mkdirSync(join(REPO, ".dkk"), { recursive: true });
+mkdirSync(DEEP, { recursive: true });
+mkdirSync(ELSEWHERE, { recursive: true });
+try {
+    // ── repoRoot — at the repo with .dkk ──────────────────────────────────
+    console.log("\n=== repoRoot() at repo with .dkk ===");
+    withCwd(REPO, () => {
+        delete process.env.DKK_DISABLE_WALKUP;
+        assert("cwd at root with .dkk returns cwd", repoRoot() === REPO);
+    });
+    // ── repoRoot — walk-up from a sub-directory ───────────────────────────
+    console.log("\n=== repoRoot() walks up from sub-dir ===");
+    withCwd(SERVICE, () => {
+        delete process.env.DKK_DISABLE_WALKUP;
+        assert("from services/foo finds repo .dkk", repoRoot() === REPO);
+    });
+    withCwd(DEEP, () => {
+        delete process.env.DKK_DISABLE_WALKUP;
+        assert("from services/foo/src finds repo .dkk", repoRoot() === REPO);
+    });
+    // ── Explicit --root override skips walk-up ────────────────────────────
+    console.log("\n=== explicit --root override ===");
+    withCwd(DEEP, () => {
+        delete process.env.DKK_DISABLE_WALKUP;
+        assert("explicit override is used verbatim, no walk-up", repoRoot(ELSEWHERE) === ELSEWHERE);
+    });
+    // ── DKK_DISABLE_WALKUP=1 disables walk-up ─────────────────────────────
+    console.log("\n=== DKK_DISABLE_WALKUP=1 ===");
+    withCwd(DEEP, () => {
+        process.env.DKK_DISABLE_WALKUP = "1";
+        assert("walk-up disabled returns cwd as-is", repoRoot() === DEEP);
+        delete process.env.DKK_DISABLE_WALKUP;
+    });
+    // ── No .dkk anywhere — fall back to cwd ───────────────────────────────
+    console.log("\n=== no .dkk anywhere, fallback to cwd ===");
+    withCwd(ELSEWHERE, () => {
+        delete process.env.DKK_DISABLE_WALKUP;
+        assert("fallback to cwd when no .dkk on walk-up path", repoRoot() === ELSEWHERE);
+    });
+    // ── Federation path helpers compose correctly ─────────────────────────
+    console.log("\n=== federation path helpers ===");
+    assert("serviceFile", serviceFile(REPO) === join(REPO, ".dkk", "service.yml"));
+    assert("federationFile", federationFile(REPO) === join(REPO, ".dkk", "federation.yml"));
+    assert("importedServiceDir", importedServiceDir("payments", REPO) === join(REPO, ".dkk", "imports", "payments"));
+    // ── findDkkRoot — direct walk-up search ───────────────────────────────
+    console.log("\n=== findDkkRoot ===");
+    assert("findDkkRoot at repo returns repo", findDkkRoot(REPO) === REPO);
+    assert("findDkkRoot from sub-dir returns repo", findDkkRoot(SERVICE) === REPO);
+    assert("findDkkRoot from deep sub-dir returns repo", findDkkRoot(DEEP) === REPO);
+    assert("findDkkRoot from dir with no .dkk returns null", findDkkRoot(ELSEWHERE) === null);
+}
+finally {
+    rmSync(TMP, { recursive: true, force: true });
+    if (originalDisableWalkup === undefined) {
+        delete process.env.DKK_DISABLE_WALKUP;
+    }
+    else {
+        process.env.DKK_DISABLE_WALKUP = originalDisableWalkup;
+    }
+}
+console.log(`\n${passed} passed, ${failed} failed`);
+if (failed > 0)
+    process.exit(1);
+//# sourceMappingURL=paths.test.js.map

package/dist/shared/tests/paths.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.test.js","sourceRoot":"","sources":["../../../src/shared/tests/paths.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErG,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,IAAI,MAAM,GAAG,CAAC,CAAC;AAEf,SAAS,MAAM,CAAC,KAAa,EAAE,SAAkB,EAAE,MAAe;IAChE,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,CAAC;IACX,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,EAAE,CAAC;IACX,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAClC,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAE7D,SAAS,OAAO,CAAI,GAAW,EAAE,EAAW;IAC1C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QACH,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,UAAU;AACV,iEAAiE;AACjE,sEAAsE;AACtE,4DAA4D;AAC5D,8EAA8E;AAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAC1D,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACxC,sEAAsE;AACtE,0CAA0C;AAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAClC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAEzC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACrC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAE1C,IAAI,CAAC;IACH,yEAAyE;IACzE,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE;QACjB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACtC,MAAM,CAAC,mCAAmC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE;QACpB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACtC,MAAM,CAAC,mCAAmC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE;QACjB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACtC,MAAM,CAAC,uCAAuC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE;QACjB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACtC,MAAM,CACJ,gDAAgD,EAChD,QAAQ,CAAC,SAAS,CAAC,KAAK,SAAS,CAClC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE;QACjB,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC;QACrC,MAAM,CAAC,oCAAoC,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC;QAClE,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC3D,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE;QACtB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACtC,MAAM,CAAC,8CAA8C,EAAE,QAAQ,EAAE,KAAK,SAAS,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,MAAM,CACJ,aAAa,EACb,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CACxD,CAAC;IACF,MAAM,CACJ,gBAAgB,EAChB,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAC9D,CAAC;IACF,MAAM,CACJ,oBAAoB,EACpB,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CACnF,CAAC;IAEF,yEAAyE;IACzE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,MAAM,CAAC,kCAAkC,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IACvE,MAAM,CAAC,uCAAuC,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/E,MAAM,CAAC,4CAA4C,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IACjF,MAAM,CAAC,gDAAgD,EAAE,WAAW,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC;AAC5F,CAAC;QAAS,CAAC;IACT,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,kBAAkB,GAAG,qBAAqB,CAAC;IACzD,CAAC;AACH,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,YAAY,MAAM,SAAS,CAAC,CAAC;AACpD,IAAI,MAAM,GAAG,CAAC;IAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/shared/tests/refs.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=refs.test.d.ts.map

package/dist/shared/tests/refs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.test.d.ts","sourceRoot":"","sources":["../../../src/shared/tests/refs.test.ts"],"names":[],"mappings":""}

package/dist/shared/tests/refs.test.js

@@ -0,0 +1,104 @@
+/**
+ * Tests for the ref-parsing utility.
+ *
+ * Covers all five id shapes (item, adr, actor, flow, context), the
+ * optional service prefix on each, and a range of invalid inputs.
+ */
+import { parseRef, formatRef } from "../refs.js";
+let passed = 0;
+let failed = 0;
+function assert(label, condition, detail) {
+    if (condition) {
+        console.log(`  OK: ${label}`);
+        passed++;
+    }
+    else {
+        console.error(`FAIL: ${label}${detail ? ` — ${detail}` : ""}`);
+        failed++;
+    }
+}
+function assertEqual(label, actual, expected) {
+    const ok = JSON.stringify(actual) === JSON.stringify(expected);
+    assert(label, ok, ok ? undefined : `expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
+}
+// ── Bare refs (no service prefix) ──────────────────────────────────────
+console.log("\n=== bare refs ===");
+assertEqual("item", parseRef("ordering.OrderPlaced"), {
+    kind: "item",
+    context: "ordering",
+    name: "OrderPlaced",
+});
+assertEqual("item with multi-word context", parseRef("order-management.PlaceOrder"), {
+    kind: "item",
+    context: "order-management",
+    name: "PlaceOrder",
+});
+assertEqual("adr", parseRef("adr-0001"), { kind: "adr", id: "adr-0001" });
+assertEqual("actor", parseRef("actor.Customer"), { kind: "actor", name: "Customer" });
+assertEqual("flow", parseRef("flow.OrderFulfillment"), { kind: "flow", name: "OrderFulfillment" });
+assertEqual("context", parseRef("context.ordering"), { kind: "context", name: "ordering" });
+// ── Service-prefixed refs ──────────────────────────────────────────────
+console.log("\n=== service-prefixed refs ===");
+assertEqual("service-prefixed item", parseRef("payments:billing.PaymentCaptured"), {
+    kind: "item",
+    service: "payments",
+    context: "billing",
+    name: "PaymentCaptured",
+});
+assertEqual("service-prefixed adr", parseRef("ordering:adr-0007"), {
+    kind: "adr",
+    service: "ordering",
+    id: "adr-0007",
+});
+assertEqual("service-prefixed actor", parseRef("payments:actor.PaymentGateway"), {
+    kind: "actor",
+    service: "payments",
+    name: "PaymentGateway",
+});
+assertEqual("service-prefixed flow", parseRef("ordering:flow.OrderFulfillment"), {
+    kind: "flow",
+    service: "ordering",
+    name: "OrderFulfillment",
+});
+assertEqual("service-prefixed context", parseRef("ordering:context.ordering"), {
+    kind: "context",
+    service: "ordering",
+    name: "ordering",
+});
+// ── Invalid inputs ─────────────────────────────────────────────────────
+console.log("\n=== invalid inputs ===");
+assert("empty string", parseRef("") === null);
+assert("just a colon", parseRef(":") === null);
+assert("trailing colon", parseRef("payments:") === null);
+assert("PascalCase service prefix", parseRef("Payments:billing.X") === null);
+assert("digits-only context", parseRef("123.PlaceOrder") === null);
+assert("lowercase item name", parseRef("ordering.placeOrder") !== null); // PascalCase pattern allows leading lowercase per existing schemas
+assert("snake_case context", parseRef("order_mgmt.X") === null);
+assert("bad adr format", parseRef("adr-99") === null);
+assert("adr with extra chars", parseRef("adr-0001x") === null);
+assert("actor with bad name", parseRef("actor.bad-name") === null);
+assert("flow with empty name", parseRef("flow.") === null);
+assert("context with PascalCase", parseRef("context.Ordering") === null);
+assert("no dot in item", parseRef("ordering") === null);
+assert("dot at start", parseRef(".Foo") === null);
+// ── formatRef round-trip ───────────────────────────────────────────────
+console.log("\n=== formatRef round-trip ===");
+const samples = [
+    "ordering.OrderPlaced",
+    "payments:billing.PaymentCaptured",
+    "adr-0001",
+    "ordering:adr-0007",
+    "actor.Customer",
+    "payments:actor.PaymentGateway",
+    "flow.OrderFulfillment",
+    "context.ordering",
+];
+for (const s of samples) {
+    const parsed = parseRef(s);
+    assert(`round-trip ${s}`, parsed !== null && formatRef(parsed) === s);
+}
+// ── Summary ────────────────────────────────────────────────────────────
+console.log(`\n${passed} passed, ${failed} failed`);
+if (failed > 0)
+    process.exit(1);
+//# sourceMappingURL=refs.test.js.map

package/dist/shared/tests/refs.test.js.map

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

package/dist/shared/types/domain.d.ts

@@ -246,5 +246,19 @@ export interface DomainModel {
     contexts: Map<string, DomainContext>;
     /** All ADR records keyed by ADR id. */
     adrs: Map<string, AdrRecord>;
+    /**
+     * Service identity for this repo (federation). Present when a
+     * `.dkk/service.yml` was found; otherwise `undefined`. Legacy
+     * unfederated repos keep working unchanged.
+     */
+    service?: import("./federation.js").ServiceManifest;
+    /**
+     * Peer service models loaded from `.dkk/federation.yml`. Keyed by
+     * peer service name. Each value is a fully-loaded `DomainModel`
+     * (one level deep — peer's own peers are not transitively followed).
+     * Present only when federation is configured and at least one peer
+     * was reachable.
+     */
+    peers?: Map<string, DomainModel>;
 }
 //# sourceMappingURL=domain.d.ts.map

package/dist/shared/types/domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/shared/types/domain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/shared/types/domain.ts"],"names":[],"mappings":"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"}

package/dist/shared/types/federation.d.ts

@@ -0,0 +1,60 @@
+/**
+ * TypeScript interfaces for the multi-repo federation layer.
+ *
+ * `service.yml` declares this repo's service identity. `federation.yml`
+ * lists peer services whose `.dkk/` directories should be loaded
+ * alongside the local model (read-only).
+ *
+ * Aligns with JSON schemas under tools/dkk/schema/service.schema.json
+ * and federation.schema.json.
+ */
+/** Service identity file (.dkk/service.yml). */
+export interface ServiceManifest {
+    /** Kebab-case service identifier (e.g. "ordering"). Globally unique within an org. */
+    name: string;
+    /** Bounded-context names this service publishes for cross-repo consumption. */
+    exports: string[];
+    /** Optional human-readable description of the service. */
+    description?: string;
+}
+/** Filesystem-path peer source. */
+export interface LocalPeerSource {
+    type: "local";
+    /** Absolute or repo-root-relative path to the peer's repository root. */
+    path: string;
+}
+/** Git-clone peer source (sparse-checkout of `.dkk/`). */
+export interface GitPeerSource {
+    type: "git";
+    /** Git URL (https / ssh). */
+    url: string;
+    /** Branch to track. */
+    branch: string;
+    /** Optional sub-path inside the peer repo where `.dkk/` lives. Defaults to repo root. */
+    path?: string;
+}
+/** Discriminated union of supported peer source types. */
+export type PeerSource = LocalPeerSource | GitPeerSource;
+/** A single peer entry in the federation manifest. */
+export interface PeerSpec {
+    /** Kebab-case service name (must match the peer's own `service.yml`). */
+    name: string;
+    /** Where to read the peer's `.dkk/` from. */
+    source: PeerSource;
+}
+/** Federation manifest file (.dkk/federation.yml). */
+export interface FederationManifest {
+    peers: PeerSpec[];
+}
+/** A single entry in the federation lockfile (pins git SHAs). */
+export interface LockEntry {
+    /** Mirrors the manifest entry's source for change detection. */
+    source: PeerSource;
+    /** Resolved commit SHA at the time of fetch (git sources only). */
+    sha?: string;
+    /** ISO-8601 timestamp of the fetch. */
+    fetchedAt?: string;
+}
+/** Lockfile shape (.dkk/federation.lock.json). */
+export type FederationLock = Record<string, LockEntry>;
+//# sourceMappingURL=federation.d.ts.map

package/dist/shared/types/federation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../../src/shared/types/federation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,CAAC;IACZ,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,aAAa,CAAC;AAEzD,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACvB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,gEAAgE;IAChE,MAAM,EAAE,UAAU,CAAC;IACnB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/shared/types/federation.js

@@ -0,0 +1,12 @@
+/**
+ * TypeScript interfaces for the multi-repo federation layer.
+ *
+ * `service.yml` declares this repo's service identity. `federation.yml`
+ * lists peer services whose `.dkk/` directories should be loaded
+ * alongside the local model (read-only).
+ *
+ * Aligns with JSON schemas under tools/dkk/schema/service.schema.json
+ * and federation.schema.json.
+ */
+export {};
+//# sourceMappingURL=federation.js.map

package/dist/shared/types/federation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.js","sourceRoot":"","sources":["../../../src/shared/types/federation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domain-knowledge-kit",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "Domain Knowledge Pack — YAML + ADR links + deterministic search + generated docs",
   "type": "module",
   "repository": {
@@ -18,6 +18,7 @@
     "dist/",
     "tools/dkk/schema/",
     "tools/dkk/templates/",
+    "tools/dkk/claude/",
     ".github/skills/",
     "LICENSE",
     "README.md"
@@ -30,7 +31,7 @@
     "lint:fix": "eslint . --fix",
     "check": "npm run typecheck && npm run lint",
     "prepublishOnly": "npm run build",
-    "test": "tsx src/features/pipeline/tests/validate-schemas.test.ts && tsx src/shared/tests/loader.test.ts && tsx src/features/pipeline/tests/validator.test.ts && tsx src/shared/tests/graph.test.ts && tsx src/features/pipeline/tests/indexer.test.ts && tsx src/features/query/tests/searcher.test.ts && tsx src/features/pipeline/tests/renderer.test.ts && tsx src/shared/tests/verify-collision-fix.test.ts && tsx test/cli-integration.ts"
+    "test": "tsx src/features/pipeline/tests/validate-schemas.test.ts && tsx src/shared/tests/loader.test.ts && tsx src/shared/tests/refs.test.ts && tsx src/shared/tests/paths.test.ts && tsx src/features/federation/tests/loader.test.ts && tsx src/features/federation/tests/schema-load.test.ts && tsx src/features/federation/tests/git-fetcher.test.ts && tsx src/features/federation/tests/validator.test.ts && tsx src/features/federation/tests/phase5.test.ts && tsx src/features/pipeline/tests/validator.test.ts && tsx src/shared/tests/graph.test.ts && tsx src/features/pipeline/tests/indexer.test.ts && tsx src/features/query/tests/searcher.test.ts && tsx src/features/pipeline/tests/renderer.test.ts && tsx src/shared/tests/verify-collision-fix.test.ts && tsx test/cli-integration.ts"
   },
   "engines": {
     "node": ">=21.2.0"
@@ -47,12 +48,14 @@
     "vitest": "^4.1.0"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.12.0",
     "ajv-formats": "^3.0.1",
     "better-sqlite3": "^11.0.0",
     "commander": "^12.0.0",
     "fast-glob": "^3.3.2",
     "handlebars": "^4.7.8",
-    "js-yaml": "^4.1.0"
+    "js-yaml": "^4.1.0",
+    "zod": "^4.4.3"
   }
 }

package/tools/dkk/claude/agents/dkk-domain-reviewer.md

@@ -0,0 +1,69 @@
+---
+name: dkk-domain-reviewer
+description: Review a code change, branch, or PR for impact on the local Domain Knowledge Pack. Identifies affected domain items, computes blast radius, flags ADR drift, and returns a single bounded report. Use when the user asks to review a diff, audit a PR, or check whether a change is domain-safe.
+tools: Read, Grep, Glob, Bash, mcp__dkk__search, mcp__dkk__show, mcp__dkk__summary, mcp__dkk__related, mcp__dkk__list, mcp__dkk__locate, mcp__dkk__stats, mcp__dkk__validate, mcp__dkk__story, mcp__dkk__prime
+---
+
+# DKK Domain Reviewer
+
+You review a code change for impact on the project's Domain Knowledge Pack. Your job is to surface domain risk that would be invisible from a syntactic diff review: broken cross-references, blast radius beyond the changed file, drift between code and ADR-recorded decisions.
+
+You return a **single bounded report**. You do not converse — caller invokes you, you investigate, you reply once.
+
+## Inputs
+
+The caller provides one of:
+
+- A list of changed files (relative paths)
+- A git diff range (e.g. `origin/main...HEAD`)
+- A PR number/URL — in which case run `gh pr diff <number>` to retrieve the diff
+
+If no input is provided, default to the working-tree diff: `git diff` and `git status` to enumerate changed files.
+
+## Investigation procedure
+
+1. **Enumerate changed files.** From the diff or file list, separate:
+   - Domain YAML changes under `.dkk/domain/**/*.yml`
+   - ADR changes under `.dkk/adr/*.md`
+   - Code changes that *might* implement a domain command, event, policy, aggregate, or read model
+2. **For each changed domain YAML file**: extract the item id (path → `<context>.<Name>`). Call `mcp__dkk__summary` for orientation, then `mcp__dkk__related` with `depth: 2` for blast radius. Note every neighbour whose definition file was *not* in the diff — those are the items most likely to break invariants.
+3. **For each changed ADR**: call `mcp__dkk__show` on the ADR id. List every item in `domain_refs`. For each, verify (via `mcp__dkk__show`) that the item's `adr_refs` still contains this ADR. Flag missing back-links.
+4. **For each code change**: grep the file for tokens that look like domain identifiers (PascalCase command/event names, `actor.<Name>`, etc.). For each match, call `mcp__dkk__search` with the token. If the token does not resolve to a model item, flag it as a possible drift (code references a name that the model doesn't know about, or vice versa).
+5. **Run `mcp__dkk__validate`** to check schema and cross-reference health on the post-change model. Include any errors or warnings verbatim in the report.
+6. **Spot-check ADR drift.** For each domain item touched by the change, look at its `adr_refs`. Read each referenced ADR via `mcp__dkk__show` and check whether the change is consistent with the ADR's *Decision* and *Consequences* sections. Flag any change that appears to contradict an Accepted ADR.
+
+## Report format
+
+Return one markdown report with these sections (omit a section if empty):
+
+```markdown
+## Domain Review
+
+### Changed domain items
+- `<id>` — <one-line summary> [<context>]
+
+### Blast radius (depth 2)
+- `<changed-id>` → affects <N> items not in this diff:
+  - `<neighbour-id>` (<kind>) — <relationship>
+
+### Cross-reference issues
+- <description>; <path or id>
+
+### ADR drift
+- `<adr-id>: <title>` — <how the change appears to deviate>
+
+### Validation
+- <verbatim errors / warnings, or "clean">
+
+### Recommendations
+- <ordered, actionable items>
+```
+
+If the diff has no domain impact, return: *"No domain-relevant changes detected."*
+
+## Constraints
+
+- Read-only. Do not edit files. Do not call `dkk render`, `dkk add`, `dkk rename`, `dkk rm`, or any write-side `dkk` command.
+- Do not run tests, builds, or arbitrary scripts. The Bash allowance is for `git`, `gh`, and read-only `dkk` queries only.
+- Stay focused on **domain** impact. General code review (style, performance, security) is out of scope — leave those for other reviewers.
+- If you cannot determine impact for some change with confidence, say so explicitly rather than guessing.

package/tools/dkk/claude/commands/dkk-adr.md

@@ -0,0 +1,11 @@
+---
+description: Draft a new Architecture Decision Record using the dkk-adr-author skill.
+argument-hint: <decision-topic>
+---
+
+Invoke the `dkk-adr-author` skill. The decision topic is `$ARGUMENTS`.
+
+- If `$ARGUMENTS` is empty, ask the user to describe the decision in one sentence before proceeding.
+- Otherwise, treat `$ARGUMENTS` as the topic and start the skill workflow at step 1 (search for prior ADRs covering this topic via `mcp__dkk__search` with `type: adr`).
+
+Follow the skill's workflow end to end, including the bidirectional `domain_refs` ↔ `adr_refs` linking and the final `dkk render` quality gate.

package/tools/dkk/claude/commands/dkk-impact.md

@@ -0,0 +1,34 @@
+---
+description: Show blast radius for a DKK item — summary, depth-3 graph neighbours, and linked ADRs.
+argument-hint: <item-id>
+allowed-tools: mcp__dkk__summary, mcp__dkk__related, mcp__dkk__show, mcp__dkk__locate
+---
+
+Compute and present the blast radius of `$ARGUMENTS`.
+
+1. Call `mcp__dkk__summary` with `id: $ARGUMENTS`. Report the item's name, kind, context, and one-line description.
+2. Call `mcp__dkk__related` with `id: $ARGUMENTS` and `depth: 3`. Group results by kind.
+3. From the summary, collect any `adr_refs`. For each, call `mcp__dkk__show` and report the ADR id, title, and status.
+4. Call `mcp__dkk__locate` and report the absolute path(s) where this item is defined.
+
+Format the output as:
+
+```markdown
+## Impact: <id>
+
+**<name>** (<kind>, <context>) — <description>
+
+### Source
+- <absolute path>
+
+### Direct neighbours (depth 1)
+- <kind>: <id>, <id>, ...
+
+### Extended blast radius (depth 2–3)
+- <kind>: <id>, <id>, ...
+
+### Linked ADRs
+- <adr-id>: <title> (<status>)
+```
+
+If the id does not resolve, list the closest candidates from `mcp__dkk__list` or `mcp__dkk__search` and stop.

package/tools/dkk/claude/commands/dkk-implement.md

@@ -0,0 +1,12 @@
+---
+description: Walk through framework-agnostic implementation of a DKK flow using the dkk-flow-implementer skill.
+argument-hint: <flow-id-or-feature-name>
+---
+
+Invoke the `dkk-flow-implementer` skill. The user's target is `$ARGUMENTS`.
+
+- If `$ARGUMENTS` is empty, ask the user which flow to implement, or list available flows via `mcp__dkk__list` (filter `type: flow`).
+- If `$ARGUMENTS` looks like a flow id (`flow.<Name>` or bare `<Name>`), pass it through to `mcp__dkk__story`.
+- Otherwise, run `mcp__dkk__search` with `$ARGUMENTS` first to identify the matching flow or root command, then proceed.
+
+Follow the skill's workflow: retrieve story, ask clarifying questions, present ADR constraints, generate the framework-agnostic checklist, and walk the user through items interactively.

package/tools/dkk/claude/commands/dkk-prime.md

@@ -0,0 +1,6 @@
+---
+description: Re-inject DKK agent context (domain principles, item types, CLI reference, current model summary). Use after compaction or topic drift.
+allowed-tools: mcp__dkk__prime
+---
+
+Call `mcp__dkk__prime` with default arguments and read the response. After loading, briefly confirm the number of contexts, items, and ADRs currently in the model. Do not summarize the prime content itself — the user just needs the agent to be re-primed.