domain-knowledge-kit 0.2.14 → 0.2.16

package/dist/features/federation/loader.js.map

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

package/dist/features/federation/lock.d.ts

@@ -0,0 +1,12 @@
+import type { FederationLock, LockEntry } from "../../shared/types/federation.js";
+/**
+ * Read the lockfile from disk. Returns an empty record when the file
+ * is absent. Malformed JSON throws (the file is committed, so a parse
+ * failure should be loud).
+ */
+export declare function readLock(root?: string): FederationLock;
+/** Write the lockfile to disk with stable formatting. */
+export declare function writeLock(lock: FederationLock, root?: string): void;
+/** Build a fresh lock entry from a fetch result. */
+export declare function makeEntry(source: LockEntry["source"], sha: string | undefined): LockEntry;
+//# sourceMappingURL=lock.d.ts.map

package/dist/features/federation/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/features/federation/lock.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAMtD;AAED,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CASnE;AAED,oDAAoD;AACpD,wBAAgB,SAAS,CACvB,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC3B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,SAAS,CAKX"}

package/dist/features/federation/lock.js

@@ -0,0 +1,48 @@
+/**
+ * Federation lockfile (.dkk/federation.lock.json).
+ *
+ * Records the resolved commit SHA each git-source peer was fetched at,
+ * along with a snapshot of the source spec used. Committing the
+ * lockfile means two developers running `dkk pull` see the same peer
+ * state until someone explicitly re-pulls with `--refresh`.
+ *
+ * Local-source peers have no lockfile entry — they're always live from
+ * disk.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { federationLockFile } from "../../shared/paths.js";
+/**
+ * Read the lockfile from disk. Returns an empty record when the file
+ * is absent. Malformed JSON throws (the file is committed, so a parse
+ * failure should be loud).
+ */
+export function readLock(root) {
+    const path = federationLockFile(root);
+    if (!existsSync(path))
+        return {};
+    const text = readFileSync(path, "utf-8");
+    if (text.trim().length === 0)
+        return {};
+    return JSON.parse(text);
+}
+/** Write the lockfile to disk with stable formatting. */
+export function writeLock(lock, root) {
+    const path = federationLockFile(root);
+    mkdirSync(dirname(path), { recursive: true });
+    // Stable key ordering (sorted by service name) keeps diffs minimal.
+    const sorted = {};
+    for (const key of Object.keys(lock).sort()) {
+        sorted[key] = lock[key];
+    }
+    writeFileSync(path, JSON.stringify(sorted, null, 2) + "\n", "utf-8");
+}
+/** Build a fresh lock entry from a fetch result. */
+export function makeEntry(source, sha) {
+    const entry = { source };
+    if (sha)
+        entry.sha = sha;
+    entry.fetchedAt = new Date().toISOString();
+    return entry;
+}
+//# sourceMappingURL=lock.js.map

package/dist/features/federation/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../../src/features/federation/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;AAC5C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,IAAoB,EAAE,IAAa;IAC3D,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACtC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,oEAAoE;IACpE,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,SAAS,CACvB,MAA2B,EAC3B,GAAuB;IAEvB,MAAM,KAAK,GAAc,EAAE,MAAM,EAAE,CAAC;IACpC,IAAI,GAAG;QAAE,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC;IACzB,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/features/federation/tests/git-fetcher.test.d.ts

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

package/dist/features/federation/tests/git-fetcher.test.d.ts.map

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

package/dist/features/federation/tests/git-fetcher.test.js

@@ -0,0 +1,167 @@
+/**
+ * Tests for the sparse-checkout git fetcher.
+ *
+ * Uses a local bare repository as the "remote" so the test runs
+ * fully offline. Verifies that:
+ *  - sparseFetch clones with a `.dkk/` sparse pattern.
+ *  - Only `.dkk/` content is materialised; other top-level files are
+ *    excluded by the sparse rule.
+ *  - The returned SHA matches `HEAD` of the configured branch.
+ *  - `dkk pull` populates the cache and writes a lockfile entry.
+ *  - A subsequent `dkk pull` is a no-op (the SHA in the lock matches).
+ *  - `dkk pull --refresh` re-fetches.
+ *
+ * If `git` is not available on PATH, the test is skipped (we don't
+ * fail CI on environments without git).
+ */
+import { execFileSync, spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, realpathSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { sparseFetch } from "../git-fetcher.js";
+let passed = 0;
+let failed = 0;
+let skipped = false;
+function assert(label, condition, detail) {
+    if (condition) {
+        console.log(`  OK: ${label}`);
+        passed++;
+    }
+    else {
+        console.error(`FAIL: ${label}${detail ? ` — ${detail}` : ""}`);
+        failed++;
+    }
+}
+function gitAvailable() {
+    try {
+        execFileSync("git", ["--version"], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+if (!gitAvailable()) {
+    console.log("git not available on PATH — skipping git-fetcher tests");
+    skipped = true;
+}
+if (!skipped) {
+    const RAW_TMP = join(tmpdir(), `dkk-git-${Date.now()}`);
+    mkdirSync(RAW_TMP, { recursive: true });
+    const TMP = realpathSync(RAW_TMP);
+    // Layout:
+    //   <TMP>/remote/         — a bare git repo (the "remote")
+    //   <TMP>/source/         — a regular repo we'll push from
+    //     .dkk/               — the only content sparseFetch should pull
+    //       service.yml
+    //       domain/.../OrderPlaced.yml
+    //     README.md           — should NOT appear in the cache
+    //   <TMP>/local/.dkk/imports/ordering/  — destination cache
+    const REMOTE = join(TMP, "remote");
+    const SOURCE = join(TMP, "source");
+    const LOCAL = join(TMP, "local");
+    const CACHE_DIR = join(LOCAL, ".dkk", "imports", "ordering");
+    function run(args, cwd) {
+        const result = spawnSync("git", args, { cwd, stdio: ["ignore", "pipe", "pipe"], encoding: "utf-8" });
+        if (result.status !== 0) {
+            throw new Error(`git ${args.join(" ")} failed in ${cwd}\nstderr: ${result.stderr}`);
+        }
+        return result.stdout.trim();
+    }
+    try {
+        // Create the bare remote.
+        mkdirSync(REMOTE, { recursive: true });
+        run(["init", "--bare", "--initial-branch=main"], REMOTE);
+        // Create the source repo with .dkk/ content + a noise file.
+        mkdirSync(join(SOURCE, ".dkk", "domain", "contexts", "ordering", "events"), {
+            recursive: true,
+        });
+        writeFileSync(join(SOURCE, ".dkk", "service.yml"), "name: ordering\nexports:\n  - ordering\n");
+        writeFileSync(join(SOURCE, ".dkk", "domain", "index.yml"), "contexts:\n  - name: ordering\n    description: Ordering context\nflows: []\n");
+        writeFileSync(join(SOURCE, ".dkk", "domain", "actors.yml"), "actors: []\n");
+        writeFileSync(join(SOURCE, ".dkk", "domain", "contexts", "ordering", "context.yml"), "name: ordering\ndescription: Ordering bounded context\n");
+        writeFileSync(join(SOURCE, ".dkk", "domain", "contexts", "ordering", "events", "OrderPlaced.yml"), "name: OrderPlaced\ndescription: Raised when an order is placed.\n");
+        writeFileSync(join(SOURCE, "README.md"), "# Should NOT be in the sparse checkout\n");
+        run(["init", "--initial-branch=main"], SOURCE);
+        run(["config", "user.email", "test@example.com"], SOURCE);
+        run(["config", "user.name", "Test"], SOURCE);
+        run(["config", "commit.gpgsign", "false"], SOURCE);
+        run(["add", "."], SOURCE);
+        run(["commit", "-m", "initial"], SOURCE);
+        run(["remote", "add", "origin", REMOTE], SOURCE);
+        run(["push", "-u", "origin", "main"], SOURCE);
+        const sourceHead = run(["rev-parse", "HEAD"], SOURCE);
+        // ── sparseFetch pulls only .dkk/ ──────────────────────────────────
+        console.log("\n=== sparseFetch ===");
+        const result = sparseFetch({
+            url: REMOTE,
+            branch: "main",
+            subpath: "",
+            dest: CACHE_DIR,
+        });
+        assert("returned SHA matches source HEAD", result.sha === sourceHead);
+        assert(".dkk/ exists in cache", existsSync(join(CACHE_DIR, ".dkk")));
+        assert("service.yml present", existsSync(join(CACHE_DIR, ".dkk", "service.yml")));
+        assert("OrderPlaced.yml present", existsSync(join(CACHE_DIR, ".dkk", "domain", "contexts", "ordering", "events", "OrderPlaced.yml")));
+        assert("README.md NOT in cache (sparse rule excluded it)", !existsSync(join(CACHE_DIR, "README.md")));
+        // ── dkk pull integrates the fetcher + lockfile ────────────────────
+        console.log("\n=== dkk pull (CLI integration) ===");
+        // Set up a `local` repo with a federation manifest pointing at the
+        // bare remote. Wipe the cache from the previous step so `pull` has
+        // to re-fetch.
+        rmSync(join(LOCAL, ".dkk"), { recursive: true, force: true });
+        mkdirSync(join(LOCAL, ".dkk", "domain"), { recursive: true });
+        writeFileSync(join(LOCAL, ".dkk", "service.yml"), "name: billing\nexports:\n  - billing\n");
+        writeFileSync(join(LOCAL, ".dkk", "federation.yml"), [
+            "peers:",
+            "  - name: ordering",
+            "    source:",
+            "      type: git",
+            `      url: ${REMOTE}`,
+            "      branch: main",
+        ].join("\n") + "\n");
+        const cliEntry = join(process.cwd(), "src", "cli.ts");
+        const pullResult = spawnSync("npx", ["tsx", cliEntry, "pull", "--root", LOCAL, "--json"], { encoding: "utf-8" });
+        if (pullResult.status !== 0) {
+            throw new Error(`dkk pull failed: ${pullResult.stderr}\n${pullResult.stdout}`);
+        }
+        const pullReport = JSON.parse(pullResult.stdout);
+        assert("pull report has one peer", pullReport.peers.length === 1);
+        assert("ordering peer fetched", pullReport.peers[0].name === "ordering" && pullReport.peers[0].outcome === "fetched");
+        assert("lockfile sha matches source HEAD", pullReport.peers[0].sha === sourceHead);
+        assert("lockfile written to disk", existsSync(join(LOCAL, ".dkk", "federation.lock.json")));
+        // Subsequent pull is a no-op.
+        const pullAgain = spawnSync("npx", ["tsx", cliEntry, "pull", "--root", LOCAL, "--json"], { encoding: "utf-8" });
+        const pullAgainReport = JSON.parse(pullAgain.stdout);
+        assert("second pull is cached (no-op)", pullAgainReport.peers[0].outcome === "cached");
+        // --refresh forces re-fetch even when cached.
+        const pullRefresh = spawnSync("npx", ["tsx", cliEntry, "pull", "--root", LOCAL, "--refresh", "--json"], { encoding: "utf-8" });
+        const pullRefreshReport = JSON.parse(pullRefresh.stdout);
+        assert("--refresh re-fetches even when cached", pullRefreshReport.peers[0].outcome === "fetched");
+        // --offline with cache present is a no-op.
+        const pullOffline = spawnSync("npx", ["tsx", cliEntry, "pull", "--root", LOCAL, "--offline", "--json"], { encoding: "utf-8" });
+        const pullOfflineReport = JSON.parse(pullOffline.stdout);
+        assert("--offline with cache returns skipped-offline-cached", pullOfflineReport.peers[0].outcome === "skipped-offline-cached");
+        // Verify lockfile contents.
+        const lock = JSON.parse(readFileSync(join(LOCAL, ".dkk", "federation.lock.json"), "utf-8"));
+        assert("lockfile has ordering entry", lock.ordering !== undefined);
+        assert("lockfile entry has git source", lock.ordering.source.type === "git");
+        assert("lockfile entry has sha", typeof lock.ordering.sha === "string" && lock.ordering.sha.length > 0);
+        // ── Federation loader sees the cached peer ────────────────────────
+        console.log("\n=== loader sees cached peer ===");
+        const showResult = spawnSync("npx", ["tsx", cliEntry, "show", "ordering:OrderPlaced", "--root", LOCAL, "--json"], { encoding: "utf-8" });
+        if (showResult.status !== 0) {
+            throw new Error(`dkk show failed: ${showResult.stderr}\n${showResult.stdout}`);
+        }
+        const shown = JSON.parse(showResult.stdout);
+        assert("peer item resolved via cache", shown.data?.name === "OrderPlaced");
+        assert("peer label includes [peer: ordering]", shown.label.includes("peer: ordering"));
+    }
+    finally {
+        rmSync(RAW_TMP, { recursive: true, force: true });
+    }
+}
+console.log(`\n${passed} passed, ${failed} failed${skipped ? " (test suite skipped)" : ""}`);
+if (failed > 0)
+    process.exit(1);
+//# sourceMappingURL=git-fetcher.test.js.map

package/dist/features/federation/tests/git-fetcher.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-fetcher.test.js","sourceRoot":"","sources":["../../../../src/features/federation/tests/git-fetcher.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,IAAI,MAAM,GAAG,CAAC,CAAC;AACf,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB,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,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;IACpB,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;IACtE,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAED,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxD,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAElC,UAAU;IACV,2DAA2D;IAC3D,2DAA2D;IAC3D,qEAAqE;IACrE,oBAAoB;IACpB,mCAAmC;IACnC,2DAA2D;IAC3D,4DAA4D;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAE7D,SAAS,GAAG,CAAC,IAAc,EAAE,GAAW;QACtC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACrG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC;QACH,0BAA0B;QAC1B,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;QAEzD,4DAA4D;QAC5D,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE;YAC1E,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EACnC,0CAA0C,CAC3C,CAAC;QACF,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,EAC3C,+EAA+E,CAChF,CAAC;QACF,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,EAC5C,cAAc,CACf,CAAC;QACF,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,EACrE,yDAAyD,CAC1D,CAAC;QACF,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,EACnF,mEAAmE,CACpE,CAAC;QACF,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,0CAA0C,CAAC,CAAC;QAErF,GAAG,CAAC,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/C,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1D,GAAG,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7C,GAAG,CAAC,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QACnD,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1B,GAAG,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QACzC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QACjD,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAEtD,qEAAqE;QACrE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,WAAW,CAAC;YACzB,GAAG,EAAE,MAAM;YACX,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;QAEH,MAAM,CAAC,kCAAkC,EAAE,MAAM,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,uBAAuB,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,CACJ,qBAAqB,EACrB,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CACnD,CAAC;QACF,MAAM,CACJ,yBAAyB,EACzB,UAAU,CACR,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CACvF,CACF,CAAC;QACF,MAAM,CACJ,kDAAkD,EAClD,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAC1C,CAAC;QAEF,qEAAqE;QACrE,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QAEpD,mEAAmE;QACnE,mEAAmE;QACnE,eAAe;QACf,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,aAAa,CACX,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAClC,wCAAwC,CACzC,CAAC;QACF,aAAa,CACX,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,CAAC,EACrC;YACE,QAAQ;YACR,oBAAoB;YACpB,aAAa;YACb,iBAAiB;YACjB,cAAc,MAAM,EAAE;YACtB,oBAAoB;SACrB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CACpB,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,SAAS,CAC1B,KAAK,EACL,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EACpD,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAE9C,CAAC;QACF,MAAM,CAAC,0BAA0B,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;QAClE,MAAM,CACJ,uBAAuB,EACvB,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CACrF,CAAC;QACF,MAAM,CACJ,kCAAkC,EAClC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,CACvC,CAAC;QACF,MAAM,CACJ,0BAA0B,EAC1B,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC,CACxD,CAAC;QAEF,8BAA8B;QAC9B,MAAM,SAAS,GAAG,SAAS,CACzB,KAAK,EACL,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EACpD,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;QACF,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAElD,CAAC;QACF,MAAM,CACJ,+BAA+B,EAC/B,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAC9C,CAAC;QAEF,8CAA8C;QAC9C,MAAM,WAAW,GAAG,SAAS,CAC3B,KAAK,EACL,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EACjE,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;QACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAEtD,CAAC;QACF,MAAM,CACJ,uCAAuC,EACvC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CACjD,CAAC;QAEF,2CAA2C;QAC3C,MAAM,WAAW,GAAG,SAAS,CAC3B,KAAK,EACL,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EACjE,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;QACF,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAEtD,CAAC;QACF,MAAM,CACJ,qDAAqD,EACrD,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,wBAAwB,CAChE,CAAC;QAEF,4BAA4B;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACrB,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,sBAAsB,CAAC,EAAE,OAAO,CAAC,CACL,CAAC;QAChE,MAAM,CAAC,6BAA6B,EAAE,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;QACnE,MAAM,CAAC,+BAA+B,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;QAC7E,MAAM,CAAC,wBAAwB,EAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAExG,qEAAqE;QACrE,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,SAAS,CAC1B,KAAK,EACL,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,EAC5E,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAA8C,CAAC;QACzF,MAAM,CAAC,8BAA8B,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,aAAa,CAAC,CAAC;QAC3E,MAAM,CAAC,sCAAsC,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzF,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,YAAY,MAAM,UAAU,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7F,IAAI,MAAM,GAAG,CAAC;IAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/features/federation/tests/loader.test.d.ts

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

package/dist/features/federation/tests/loader.test.d.ts.map

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

package/dist/features/federation/tests/loader.test.js

@@ -0,0 +1,144 @@
+/**
+ * Tests for the federation loader.
+ *
+ * Verifies two-repo local-path federation:
+ *  - Local peer is reachable, its items are loaded into model.peers
+ *  - Unreachable peer becomes a warning, not an error
+ *  - DKK_PEER_<NAME> env override redirects a peer to a different path
+ *  - Peer loading is one level deep (a peer's own federation.yml is ignored)
+ */
+import { mkdirSync, writeFileSync, rmSync, realpathSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { loadDomainModel } from "../../../shared/loader.js";
+import { loadFederation, resolvePeerRoot, peerEnvKey } from "../loader.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++;
+    }
+}
+const RAW_TMP = join(tmpdir(), `dkk-fed-${Date.now()}`);
+mkdirSync(RAW_TMP, { recursive: true });
+const TMP = realpathSync(RAW_TMP);
+// Two-repo fixture layout:
+//   <TMP>/order-svc/.dkk/        — peer service "ordering" with one event
+//   <TMP>/billing-svc/.dkk/      — local service "billing" with federation.yml pointing at order-svc
+const ORDER = join(TMP, "order-svc");
+const BILLING = join(TMP, "billing-svc");
+const ALT_ORDER = join(TMP, "alt-order-svc"); // for env override test
+function writeServiceRepo(root, opts) {
+    const dkk = join(root, ".dkk");
+    const domain = join(dkk, "domain");
+    const ctx = join(domain, "contexts", opts.contextName);
+    mkdirSync(join(ctx, "events"), { recursive: true });
+    mkdirSync(join(dkk, "adr"), { recursive: true });
+    // service.yml
+    writeFileSync(join(dkk, "service.yml"), [`name: ${opts.serviceName}`, `exports:`, `  - ${opts.exportName}`].join("\n"));
+    // domain/index.yml
+    writeFileSync(join(domain, "index.yml"), [`contexts:`, `  - name: ${opts.contextName}`, `    description: ${opts.contextName} context`].join("\n"));
+    // domain/actors.yml
+    writeFileSync(join(domain, "actors.yml"), "actors: []\n");
+    // contexts/<name>/context.yml
+    writeFileSync(join(ctx, "context.yml"), [`name: ${opts.contextName}`, `description: ${opts.contextName} bounded context`].join("\n"));
+    if (opts.eventName) {
+        writeFileSync(join(ctx, "events", `${opts.eventName}.yml`), [`name: ${opts.eventName}`, `description: Raised when ${opts.eventName.toLowerCase()}.`].join("\n"));
+    }
+    if (opts.federationYml) {
+        writeFileSync(join(dkk, "federation.yml"), opts.federationYml);
+    }
+}
+writeServiceRepo(ORDER, {
+    serviceName: "ordering",
+    exportName: "ordering",
+    contextName: "ordering",
+    eventName: "OrderPlaced",
+});
+writeServiceRepo(BILLING, {
+    serviceName: "billing",
+    exportName: "billing",
+    contextName: "billing",
+    federationYml: [
+        "peers:",
+        "  - name: ordering",
+        "    source:",
+        "      type: local",
+        "      path: ../order-svc",
+    ].join("\n"),
+});
+// Alt peer for env override
+writeServiceRepo(ALT_ORDER, {
+    serviceName: "ordering",
+    exportName: "ordering",
+    contextName: "ordering",
+    eventName: "OrderShipped",
+});
+try {
+    // ── loadFederation reads the manifest ─────────────────────────────────
+    console.log("\n=== loadFederation ===");
+    const manifest = loadFederation(BILLING);
+    assert("federation manifest loaded", manifest !== null);
+    assert("manifest has one peer", manifest?.peers.length === 1);
+    assert("peer name is ordering", manifest?.peers[0].name === "ordering");
+    assert("peer source type is local", manifest?.peers[0].source.type === "local");
+    // unfederated repo returns null
+    const noFed = loadFederation(ORDER);
+    assert("unfederated repo returns null", noFed === null);
+    // ── resolvePeerRoot for local source ──────────────────────────────────
+    console.log("\n=== resolvePeerRoot (local) ===");
+    const resolved = resolvePeerRoot(manifest.peers[0], BILLING);
+    assert("local peer is reachable", resolved.reachable);
+    assert("peerRoot resolves to order-svc", resolved.peerRoot === ORDER);
+    // ── resolvePeerRoot for unreachable local source ─────────────────────
+    console.log("\n=== resolvePeerRoot (unreachable local) ===");
+    const unreachable = resolvePeerRoot({
+        name: "missing",
+        source: { type: "local", path: "../does-not-exist" },
+    }, BILLING);
+    assert("unreachable peer not reachable", !unreachable.reachable);
+    assert("unreachable peer has reason", typeof unreachable.reason === "string");
+    // ── End-to-end: loadDomainModel from billing hydrates ordering peer ──
+    console.log("\n=== loadDomainModel with federation ===");
+    const model = loadDomainModel({ root: BILLING });
+    assert("model.service is billing", model.service?.name === "billing");
+    assert("model.peers exists", model.peers !== undefined);
+    assert("model.peers has ordering", model.peers?.has("ordering") === true);
+    const peer = model.peers?.get("ordering");
+    assert("peer has service identity", peer?.service?.name === "ordering");
+    assert("peer has ordering context", peer?.contexts.has("ordering") === true);
+    assert("peer has OrderPlaced event", (peer?.contexts.get("ordering")?.events ?? []).some((e) => e.name === "OrderPlaced"));
+    // ── One level deep: peer.peers stays undefined ────────────────────────
+    console.log("\n=== peer-of-peer not followed ===");
+    assert("peer.peers is undefined (no transitive)", peer?.peers === undefined);
+    // ── Env override redirects peer to a different path ──────────────────
+    console.log("\n=== env override ===");
+    const envKey = peerEnvKey("ordering");
+    assert("env key formatted correctly", envKey === "DKK_PEER_ORDERING");
+    const originalEnv = process.env[envKey];
+    process.env[envKey] = ALT_ORDER;
+    try {
+        const altModel = loadDomainModel({ root: BILLING });
+        const altPeer = altModel.peers?.get("ordering");
+        assert("env override points peer at alt-order-svc", (altPeer?.contexts.get("ordering")?.events ?? []).some((e) => e.name === "OrderShipped"));
+        assert("env override drops OrderPlaced (different repo)", !(altPeer?.contexts.get("ordering")?.events ?? []).some((e) => e.name === "OrderPlaced"));
+    }
+    finally {
+        if (originalEnv === undefined)
+            delete process.env[envKey];
+        else
+            process.env[envKey] = originalEnv;
+    }
+}
+finally {
+    rmSync(RAW_TMP, { recursive: true, force: true });
+}
+console.log(`\n${passed} passed, ${failed} failed`);
+if (failed > 0)
+    process.exit(1);
+//# sourceMappingURL=loader.test.js.map

package/dist/features/federation/tests/loader.test.js.map

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

package/dist/features/federation/tests/phase5.test.d.ts

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

package/dist/features/federation/tests/phase5.test.d.ts.map

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

package/dist/features/federation/tests/phase5.test.js

@@ -0,0 +1,137 @@
+/**
+ * Phase 5 integration tests — federated indexer, searcher, graph, and
+ * `dkk consumers`.
+ *
+ * Builds a two-repo fixture, then verifies:
+ *  - Indexer namespaces peer rows with `<service>:` prefix.
+ *  - Search returns peer hits with the `service` field populated.
+ *  - Search `service` filter narrows correctly.
+ *  - Graph contains both local and peer nodes, with peer node ids
+ *    prefixed.
+ *  - Local policy with `when.events: ['ordering:ordering.OrderPlaced']`
+ *    produces a cross-service edge that BFS can traverse.
+ *  - `findConsumers` walks peers correctly.
+ */
+import { mkdirSync, writeFileSync, rmSync, realpathSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { loadDomainModel } from "../../../shared/loader.js";
+import { DomainGraph } from "../../../shared/graph.js";
+import { buildIndex } from "../../pipeline/indexer.js";
+import { search } from "../../query/searcher.js";
+// Importing from consumers.js transitively registers the federation
+// peer-hydration hook (via its side-effect import of ../loader.js).
+import { findConsumers } from "../commands/consumers.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++;
+    }
+}
+const RAW_TMP = join(tmpdir(), `dkk-p5-${Date.now()}`);
+mkdirSync(RAW_TMP, { recursive: true });
+const TMP = realpathSync(RAW_TMP);
+const ORDER = join(TMP, "order-svc");
+const BILLING = join(TMP, "billing-svc");
+// ── Fixture: order-svc (peer) ───────────────────────────────────────────
+mkdirSync(join(ORDER, ".dkk", "domain", "contexts", "ordering", "events"), { recursive: true });
+mkdirSync(join(ORDER, ".dkk", "domain", "contexts", "ordering", "aggregates"), { recursive: true });
+mkdirSync(join(ORDER, ".dkk", "adr"), { recursive: true });
+writeFileSync(join(ORDER, ".dkk", "service.yml"), "name: ordering\nexports:\n  - ordering\n");
+writeFileSync(join(ORDER, ".dkk", "domain", "index.yml"), "contexts:\n  - name: ordering\n    description: Orders\nflows: []\n");
+writeFileSync(join(ORDER, ".dkk", "domain", "actors.yml"), "actors: []\n");
+writeFileSync(join(ORDER, ".dkk", "domain", "contexts", "ordering", "context.yml"), "name: ordering\ndescription: Ordering context\n");
+writeFileSync(join(ORDER, ".dkk", "domain", "contexts", "ordering", "events", "OrderPlaced.yml"), "name: OrderPlaced\ndescription: Order is placed for processing.\nraised_by: Order\n");
+writeFileSync(join(ORDER, ".dkk", "domain", "contexts", "ordering", "aggregates", "Order.yml"), "name: Order\ndescription: Order aggregate.\nemits:\n  events:\n    - OrderPlaced\n");
+// ── Fixture: billing-svc (local) with a policy that subscribes to peer event ───
+mkdirSync(join(BILLING, ".dkk", "domain", "contexts", "billing", "policies"), { recursive: true });
+mkdirSync(join(BILLING, ".dkk", "domain", "contexts", "billing", "commands"), { recursive: true });
+mkdirSync(join(BILLING, ".dkk", "domain", "contexts", "billing", "aggregates"), { recursive: true });
+mkdirSync(join(BILLING, ".dkk", "adr"), { recursive: true });
+writeFileSync(join(BILLING, ".dkk", "service.yml"), "name: billing\nexports:\n  - billing\n");
+writeFileSync(join(BILLING, ".dkk", "domain", "index.yml"), "contexts:\n  - name: billing\n    description: Billing\nflows: []\n");
+writeFileSync(join(BILLING, ".dkk", "domain", "actors.yml"), "actors: []\n");
+writeFileSync(join(BILLING, ".dkk", "domain", "contexts", "billing", "context.yml"), "name: billing\ndescription: Billing context\n");
+writeFileSync(join(BILLING, ".dkk", "domain", "contexts", "billing", "commands", "IssueInvoice.yml"), "name: IssueInvoice\ndescription: Issue an invoice.\nhandled_by: Invoice\n");
+writeFileSync(join(BILLING, ".dkk", "domain", "contexts", "billing", "aggregates", "Invoice.yml"), "name: Invoice\ndescription: Invoice aggregate.\nhandles:\n  commands:\n    - IssueInvoice\n");
+writeFileSync(join(BILLING, ".dkk", "domain", "contexts", "billing", "policies", "InitiateInvoice.yml"), [
+    "name: InitiateInvoice",
+    "description: Issue an invoice when an order is placed.",
+    "when:",
+    "  events:",
+    "    - ordering:ordering.OrderPlaced",
+    "then:",
+    "  commands:",
+    "    - IssueInvoice",
+].join("\n"));
+writeFileSync(join(BILLING, ".dkk", "federation.yml"), [
+    "peers:",
+    "  - name: ordering",
+    "    source:",
+    "      type: local",
+    "      path: ../order-svc",
+].join("\n") + "\n");
+try {
+    const model = loadDomainModel({ root: BILLING });
+    // ── Indexer namespaces peer rows ─────────────────────────────────────
+    console.log("\n=== indexer namespaces peer rows ===");
+    const dbPath = buildIndex(model, { root: BILLING });
+    assert("index.db built", typeof dbPath === "string" && dbPath.length > 0);
+    const local = search("OrderPlaced", {}, { root: BILLING });
+    assert("search finds OrderPlaced", local.length > 0);
+    const peerHit = local.find((r) => r.id === "ordering:ordering.OrderPlaced");
+    assert("peer row has service-prefixed id", peerHit !== undefined);
+    assert("peer row carries service field", peerHit?.service === "ordering");
+    assert("peer row has ordering context", peerHit?.context === "ordering");
+    const localHit = local.find((r) => r.id === "billing.InitiateInvoice");
+    // (May or may not match depending on FTS tokenization of "OrderPlaced".)
+    // What matters is that the peer-prefixed and local rows don't collide.
+    assert("local + peer ids are disjoint", !local.some((r, i) => local.findIndex((other) => other.id === r.id && local.indexOf(r) !== i) >= 0));
+    void localHit;
+    // ── service filter narrows correctly ─────────────────────────────────
+    console.log("\n=== search service filter ===");
+    const onlyOrdering = search("OrderPlaced", { service: "ordering" }, { root: BILLING });
+    assert("service: ordering filter narrows to ordering rows", onlyOrdering.every((r) => r.service === "ordering"));
+    assert("service filter returns at least one row", onlyOrdering.length > 0);
+    const onlyBilling = search("Invoice", { service: "billing" }, { root: BILLING });
+    assert("service: billing filter narrows to billing rows", onlyBilling.every((r) => r.service === "billing"));
+    // ── graph contains both namespaces with cross-service edge ───────────
+    console.log("\n=== graph cross-service edge ===");
+    const graph = DomainGraph.from(model);
+    const localPolicyId = "billing.InitiateInvoice";
+    const peerEventId = "ordering:ordering.OrderPlaced";
+    assert("local policy node exists", graph.nodes.has(localPolicyId));
+    assert("peer event node exists with prefix", graph.nodes.has(peerEventId));
+    const fromPolicy = graph.getRelated(localPolicyId, 1);
+    assert("BFS from local policy reaches peer event in one hop", fromPolicy.has(peerEventId));
+    // ── findConsumers — reverse lookup from order-svc's perspective ──────
+    console.log("\n=== consumers reverse lookup ===");
+    // Build a federation manifest in order-svc that points back at
+    // billing-svc, so order-svc can ask "who consumes my OrderPlaced?".
+    writeFileSync(join(ORDER, ".dkk", "federation.yml"), [
+        "peers:",
+        "  - name: billing",
+        "    source:",
+        "      type: local",
+        "      path: ../billing-svc",
+    ].join("\n") + "\n");
+    const orderModel = loadDomainModel({ root: ORDER });
+    const consumers = findConsumers(orderModel, "ordering.OrderPlaced", orderModel.service?.name);
+    assert("at least one consumer found", consumers.length > 0);
+    assert("consumer is billing.InitiateInvoice via when.events", consumers.some((c) => c.service === "billing" &&
+        c.relation === "when.events" &&
+        c.source === "billing:billing.InitiateInvoice"));
+}
+finally {
+    rmSync(RAW_TMP, { recursive: true, force: true });
+}
+console.log(`\n${passed} passed, ${failed} failed`);
+if (failed > 0)
+    process.exit(1);
+//# sourceMappingURL=phase5.test.js.map

package/dist/features/federation/tests/phase5.test.js.map

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

package/dist/features/federation/tests/schema-load.test.d.ts

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

package/dist/features/federation/tests/schema-load.test.d.ts.map

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