domain-knowledge-kit 0.2.14 → 0.2.16

package/dist/features/federation/commands/peers-status.js

@@ -0,0 +1,78 @@
+import { repoRoot } from "../../../shared/paths.js";
+import { loadFederation, resolvePeerRoot, peerEnvKey, loadPeerModel } from "../loader.js";
+export function registerPeersStatus(parent) {
+    parent
+        .command("status")
+        .description("Show detailed status for each configured federation peer")
+        .option("-r, --root <path>", "Override repository root")
+        .option("--json", "Output as JSON")
+        .option("--minify", "Minify JSON output")
+        .action((opts) => {
+        const root = repoRoot(opts.root);
+        const manifest = loadFederation(opts.root);
+        if (!manifest || manifest.peers.length === 0) {
+            if (opts.json) {
+                console.log(JSON.stringify({ peers: [] }, null, opts.minify ? 0 : 2));
+                return;
+            }
+            console.log("No peers configured.");
+            return;
+        }
+        const rows = [];
+        for (const peer of manifest.peers) {
+            const resolution = resolvePeerRoot(peer, root);
+            const envKey = peerEnvKey(peer.name);
+            const envOverride = process.env[envKey] ?? null;
+            const row = {
+                name: peer.name,
+                kind: peer.source.type,
+                reachable: resolution.reachable,
+                peerRoot: resolution.peerRoot,
+                envOverride,
+                service: null,
+                exports: [],
+                contexts: [],
+                warning: resolution.reason ?? null,
+            };
+            if (resolution.reachable && resolution.peerRoot) {
+                try {
+                    const model = loadPeerModel(resolution.peerRoot);
+                    if (model.service) {
+                        row.service = model.service.name;
+                        row.exports = model.service.exports;
+                    }
+                    row.contexts = Array.from(model.contexts.keys()).sort();
+                }
+                catch (err) {
+                    row.warning = err instanceof Error ? err.message : String(err);
+                }
+            }
+            rows.push(row);
+        }
+        if (opts.json) {
+            const out = {};
+            for (const row of rows) {
+                const { name, ...rest } = row;
+                out[name] = rest;
+            }
+            console.log(JSON.stringify(out, null, opts.minify ? 0 : 2));
+            return;
+        }
+        for (const row of rows) {
+            const status = row.reachable ? "reachable" : "unreachable";
+            console.log(`${row.name}  [${row.kind}]  ${status}`);
+            if (row.peerRoot)
+                console.log(`  path:     ${row.peerRoot}`);
+            if (row.envOverride)
+                console.log(`  env:      ${row.envOverride}`);
+            if (row.service) {
+                console.log(`  service:  ${row.service}`);
+                console.log(`  exports:  ${row.exports.join(", ") || "(none)"}`);
+                console.log(`  contexts: ${row.contexts.join(", ") || "(none)"}`);
+            }
+            if (row.warning)
+                console.log(`  warning:  ${row.warning}`);
+        }
+    });
+}
+//# sourceMappingURL=peers-status.js.map

package/dist/features/federation/commands/peers-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers-status.js","sourceRoot":"","sources":["../../../../src/features/federation/commands/peers-status.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAoB1F,MAAM,UAAU,mBAAmB,CAAC,MAAW;IAC7C,MAAM;SACH,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;SACvD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,UAAU,EAAE,oBAAoB,CAAC;SACxC,MAAM,CAAC,CAAC,IAAgB,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtE,OAAO;YACT,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAoB,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;YAChD,MAAM,GAAG,GAAkB;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;gBACtB,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,WAAW;gBACX,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE;gBACZ,OAAO,EAAE,UAAU,CAAC,MAAM,IAAI,IAAI;aACnC,CAAC;YAEF,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;gBAChD,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;oBACjD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;wBAClB,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;wBACjC,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;oBACtC,CAAC;oBACD,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1D,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,GAAG,CAAC,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,GAAG,GAAgD,EAAE,CAAC;YAC5D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;gBAC9B,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnB,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,MAAM,EAAE,CAAC,CAAC;YACrD,IAAI,GAAG,CAAC,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,WAAW;gBAAE,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACnE,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1C,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;gBACjE,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,GAAG,CAAC,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/features/federation/commands/pull.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `dkk pull [<name>]` — fetch git-source peers into `.dkk/imports/`.
+ *
+ * Behaviour:
+ *  - Local-source peers are silently skipped (always live from disk).
+ *  - For each git-source peer, sparse-checkout `.dkk/` into the cache
+ *    at `.dkk/imports/<service>/`, then record the resolved SHA in
+ *    `.dkk/federation.lock.json`.
+ *  - `--refresh` forces a re-fetch even when the cache already exists.
+ *  - `--offline` skips all git calls; a warning is emitted if the
+ *    cache is missing for any git peer.
+ *
+ * The command exits 0 if every git peer either fetched successfully
+ * or was already up-to-date; exits 1 if any fetch errored.
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerPull(program: Cmd): void;
+//# sourceMappingURL=pull.d.ts.map

package/dist/features/federation/commands/pull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull.d.ts","sourceRoot":"","sources":["../../../../src/features/federation/commands/pull.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AA2BhD,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAoI/C"}

package/dist/features/federation/commands/pull.js

@@ -0,0 +1,153 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { repoRoot, importedServiceDir, importsDir, federationLockFile } from "../../../shared/paths.js";
+import { loadFederation } from "../loader.js";
+import { sparseFetch } from "../git-fetcher.js";
+import { readLock, writeLock, makeEntry } from "../lock.js";
+export function registerPull(program) {
+    program
+        .command("pull [name]")
+        .description("Fetch git-source federation peers into .dkk/imports/")
+        .option("-r, --root <path>", "Override repository root")
+        .option("--refresh", "Re-fetch even if the cache is already populated")
+        .option("--offline", "Use existing cache only; do not contact any remote")
+        .option("--json", "Output as JSON")
+        .option("--minify", "Minify JSON output")
+        .action((name, opts) => {
+        const root = repoRoot(opts.root);
+        const manifest = loadFederation(opts.root);
+        if (!manifest || manifest.peers.length === 0) {
+            if (opts.json) {
+                console.log(JSON.stringify({ peers: [] }, null, opts.minify ? 0 : 2));
+                return;
+            }
+            console.log("No peers configured.");
+            return;
+        }
+        // Optional filter to a single peer name.
+        const targets = name
+            ? manifest.peers.filter((p) => p.name === name)
+            : manifest.peers;
+        if (name && targets.length === 0) {
+            console.error(`Error: no peer named "${name}" in federation.yml.`);
+            process.exit(1);
+        }
+        // Ensure the imports cache directory is gitignored. We write a
+        // self-contained `.gitignore` containing `*` inside .dkk/imports/
+        // so the cache stays local to each developer regardless of what
+        // the project's root .gitignore says. Cheap (~10 bytes) and
+        // protects against accidental commits.
+        ensureImportsGitignore(root);
+        const lock = readLock(opts.root);
+        const reports = [];
+        let anyError = false;
+        for (const peer of targets) {
+            if (peer.source.type === "local") {
+                reports.push({ name: peer.name, outcome: "skipped-local" });
+                continue;
+            }
+            // Git source.
+            const cacheDir = importedServiceDir(peer.name, root);
+            const cacheExists = existsSync(cacheDir + "/.dkk");
+            if (opts.offline) {
+                if (cacheExists) {
+                    reports.push({
+                        name: peer.name,
+                        outcome: "skipped-offline-cached",
+                        sha: lock[peer.name]?.sha,
+                    });
+                }
+                else {
+                    reports.push({
+                        name: peer.name,
+                        outcome: "missing-cache-offline",
+                        message: `cache missing and --offline set; run \`dkk pull ${peer.name}\` without --offline`,
+                    });
+                }
+                continue;
+            }
+            // Re-fetch only when forced, cache empty, or the recorded
+            // source has drifted from the manifest (url/branch/path change).
+            const recorded = lock[peer.name];
+            const sourceChanged = !sourceMatches(recorded?.source, peer.source);
+            const needFetch = opts.refresh || !cacheExists || sourceChanged;
+            if (!needFetch) {
+                reports.push({
+                    name: peer.name,
+                    outcome: "cached",
+                    sha: recorded?.sha,
+                });
+                continue;
+            }
+            try {
+                const result = sparseFetch({
+                    url: peer.source.url,
+                    branch: peer.source.branch,
+                    subpath: peer.source.path ?? "",
+                    dest: cacheDir,
+                });
+                lock[peer.name] = makeEntry(peer.source, result.sha);
+                reports.push({
+                    name: peer.name,
+                    outcome: "fetched",
+                    sha: result.sha,
+                });
+            }
+            catch (err) {
+                anyError = true;
+                const msg = err instanceof Error ? err.message : String(err);
+                reports.push({
+                    name: peer.name,
+                    outcome: "error",
+                    message: msg,
+                });
+            }
+        }
+        // Always re-serialize the lock so order stays stable, even when
+        // nothing changed.
+        writeLock(lock, opts.root);
+        if (opts.json) {
+            console.log(JSON.stringify({ lock: federationLockFile(opts.root), peers: reports }, null, opts.minify ? 0 : 2));
+            if (anyError)
+                process.exit(1);
+            return;
+        }
+        for (const r of reports) {
+            const tag = `[${r.outcome}]`;
+            const sha = r.sha ? `  ${r.sha.slice(0, 12)}` : "";
+            const msg = r.message ? `  ${r.message}` : "";
+            console.log(`${r.name.padEnd(20)} ${tag}${sha}${msg}`);
+        }
+        if (anyError)
+            process.exit(1);
+    });
+}
+/**
+ * Create `.dkk/imports/.gitignore` (containing `*`) if it doesn't
+ * exist. Keeps the cache directory off git regardless of what the
+ * project's root .gitignore says.
+ */
+function ensureImportsGitignore(root) {
+    const dir = importsDir(root);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const gi = `${dir}/.gitignore`;
+    if (!existsSync(gi)) {
+        writeFileSync(gi, "# Auto-generated by `dkk pull`. Keeps the federation peer cache\n# off git regardless of the project's root .gitignore.\n*\n", "utf-8");
+    }
+}
+/** Compare two source specs by value to detect manifest drift. */
+function sourceMatches(a, b) {
+    if (!a)
+        return false;
+    if (a.type !== b.type)
+        return false;
+    if (a.type === "git" && b.type === "git") {
+        return a.url === b.url && a.branch === b.branch && (a.path ?? "") === (b.path ?? "");
+    }
+    if (a.type === "local" && b.type === "local") {
+        return a.path === b.path;
+    }
+    return false;
+}
+//# sourceMappingURL=pull.js.map

package/dist/features/federation/commands/pull.js.map

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

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

@@ -0,0 +1,45 @@
+/**
+ * Options for {@link sparseFetch}.
+ */
+export interface SparseFetchOptions {
+    /** Git URL (https / ssh). */
+    url: string;
+    /** Branch to track. */
+    branch: string;
+    /**
+     * Sub-path inside the peer repo where the service lives (i.e. the
+     * directory whose child is `.dkk/`). Empty string for repos that
+     * have `.dkk/` at the root.
+     */
+    subpath: string;
+    /**
+     * Absolute destination directory. Will be wiped if it exists.
+     * After fetch, the peer's repo content lives at `<dest>` and the
+     * service's `.dkk/` lives at `<dest>/<subpath>/.dkk` (or
+     * `<dest>/.dkk` when subpath is empty).
+     */
+    dest: string;
+}
+/** Result of a successful sparse fetch. */
+export interface SparseFetchResult {
+    /** Resolved commit SHA at HEAD of the fetched branch. */
+    sha: string;
+}
+/**
+ * Clone a peer repository into `dest` using a sparse-checkout of only
+ * the `.dkk/` subtree. The clone is depth-1 + blobless to keep it fast
+ * and small. Returns the resolved commit SHA.
+ *
+ * Steps:
+ *   1. Wipe `dest` if it exists (a stale partial clone is worse than no clone).
+ *   2. `git clone --filter=blob:none --depth 1 --no-checkout --branch <b> <url> <dest>`.
+ *   3. `git sparse-checkout init --no-cone` inside `dest`.
+ *   4. `git sparse-checkout set <subpath>/.dkk` (or `.dkk` when subpath empty).
+ *   5. `git checkout <branch>` to materialise the sparse set on disk.
+ *   6. `git rev-parse HEAD` to capture the SHA.
+ *
+ * Errors from `git` propagate as thrown exceptions with their stderr
+ * attached, so the caller can surface a meaningful message to the user.
+ */
+export declare function sparseFetch(opts: SparseFetchOptions): SparseFetchResult;
+//# sourceMappingURL=git-fetcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-fetcher.d.ts","sourceRoot":"","sources":["../../../src/features/federation/git-fetcher.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;CACb;AAcD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAoCvE"}

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

@@ -0,0 +1,70 @@
+/**
+ * Sparse-checkout fetcher for git-source peers.
+ *
+ * Clones a peer repository into a local cache, pulling only the
+ * subdirectory containing `.dkk/` to keep disk cost minimal — a
+ * typical peer is well under a megabyte.
+ *
+ * The user's existing git credential helper / SSH agent is what
+ * authenticates the clone. DKK never handles tokens directly.
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, rmSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * Run `git` with the given args inside `cwd`. Throws on non-zero exit.
+ * Captures stdout for callers that need it (e.g. `rev-parse`).
+ */
+function git(args, cwd) {
+    return execFileSync("git", args, {
+        cwd,
+        stdio: ["ignore", "pipe", "pipe"],
+        encoding: "utf-8",
+    }).trim();
+}
+/**
+ * Clone a peer repository into `dest` using a sparse-checkout of only
+ * the `.dkk/` subtree. The clone is depth-1 + blobless to keep it fast
+ * and small. Returns the resolved commit SHA.
+ *
+ * Steps:
+ *   1. Wipe `dest` if it exists (a stale partial clone is worse than no clone).
+ *   2. `git clone --filter=blob:none --depth 1 --no-checkout --branch <b> <url> <dest>`.
+ *   3. `git sparse-checkout init --no-cone` inside `dest`.
+ *   4. `git sparse-checkout set <subpath>/.dkk` (or `.dkk` when subpath empty).
+ *   5. `git checkout <branch>` to materialise the sparse set on disk.
+ *   6. `git rev-parse HEAD` to capture the SHA.
+ *
+ * Errors from `git` propagate as thrown exceptions with their stderr
+ * attached, so the caller can surface a meaningful message to the user.
+ */
+export function sparseFetch(opts) {
+    if (existsSync(opts.dest)) {
+        rmSync(opts.dest, { recursive: true, force: true });
+    }
+    mkdirSync(dirname(opts.dest), { recursive: true });
+    // Step 2: blobless, depth-1, no checkout yet.
+    git([
+        "clone",
+        "--filter=blob:none",
+        "--depth",
+        "1",
+        "--no-checkout",
+        "--branch",
+        opts.branch,
+        opts.url,
+        opts.dest,
+    ], process.cwd());
+    // Steps 3-4: enable sparse-checkout, restrict to the .dkk/ subtree.
+    git(["sparse-checkout", "init", "--no-cone"], opts.dest);
+    const sparsePattern = opts.subpath
+        ? `${opts.subpath.replace(/\/$/, "")}/.dkk/*`
+        : ".dkk/*";
+    git(["sparse-checkout", "set", sparsePattern], opts.dest);
+    // Step 5: materialise.
+    git(["checkout", opts.branch], opts.dest);
+    // Step 6: capture HEAD SHA.
+    const sha = git(["rev-parse", "HEAD"], opts.dest);
+    return { sha };
+}
+//# sourceMappingURL=git-fetcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-fetcher.js","sourceRoot":"","sources":["../../../src/features/federation/git-fetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC;;;GAGG;AACH,SAAS,GAAG,CAAC,IAAc,EAAE,GAAW;IACtC,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;QAC/B,GAAG;QACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnD,8CAA8C;IAC9C,GAAG,CACD;QACE,OAAO;QACP,oBAAoB;QACpB,SAAS;QACT,GAAG;QACH,eAAe;QACf,UAAU;QACV,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,GAAG;QACR,IAAI,CAAC,IAAI;KACV,EACD,OAAO,CAAC,GAAG,EAAE,CACd,CAAC;IAEF,oEAAoE;IACpE,GAAG,CAAC,CAAC,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO;QAChC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS;QAC7C,CAAC,CAAC,QAAQ,CAAC;IACb,GAAG,CAAC,CAAC,iBAAiB,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1D,uBAAuB;IACvB,GAAG,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1C,4BAA4B;IAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAElD,OAAO,EAAE,GAAG,EAAE,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,60 @@
+import type { DomainModel } from "../../shared/types/domain.js";
+import type { FederationManifest, PeerSpec } from "../../shared/types/federation.js";
+/** Per-peer resolution outcome surfaced to the loader/caller. */
+export interface PeerResolution {
+    /** The peer's repo root on disk (where its `.dkk/` lives), if reachable. */
+    peerRoot: string | null;
+    /** True when the peer's `.dkk/` directory exists on disk. */
+    reachable: boolean;
+    /** A short reason string used for warnings (e.g. "git cache empty"). */
+    reason?: string;
+}
+/**
+ * Read `.dkk/federation.yml` (if present), validate it against
+ * `federation.schema.json`, and return the parsed manifest. Returns
+ * `null` for unfederated repos.
+ *
+ * Throws when the file exists but does not conform to the schema —
+ * the message includes Ajv's error list so the user can fix the
+ * manifest directly.
+ */
+export declare function loadFederation(root?: string): FederationManifest | null;
+/**
+ * Resolve a single peer spec into an absolute repo-root path on disk.
+ *
+ * - `local` sources resolve relative to the local repo root (so
+ *   `../order-svc` in `billing-svc/.dkk/federation.yml` points at the
+ *   sibling directory regardless of `cwd`). Env-var override
+ *   `DKK_PEER_<SERVICE_NAME_UPPER>` (uppercase, hyphens → underscores)
+ *   takes precedence over the manifest's `source.path`.
+ * - `git` sources resolve to the cache directory
+ *   `.dkk/imports/<service>/` populated by `dkk pull`.
+ *
+ * The returned `peerRoot` points at the peer's repository root (so
+ * `<peerRoot>/.dkk/` is where the peer's domain lives).
+ */
+export declare function resolvePeerRoot(spec: PeerSpec, localRepoRoot: string): PeerResolution;
+/**
+ * Load a peer's domain model in "peer mode": one level deep (peer's
+ * own `federation.yml` is skipped) and resilient to minor schema
+ * drift. The peer's model is structurally identical to a local model
+ * so the same `loadDomainModel` is reused; the federation pass is
+ * suppressed via the `followPeers: false` option.
+ */
+export declare function loadPeerModel(peerRoot: string): DomainModel;
+/**
+ * Resolve and load every peer declared in the manifest. Unreachable
+ * peers are reported via `warnings` (each line is one peer) but never
+ * abort the load — the caller (typically the main loader) attaches
+ * the resulting map to `model.peers`.
+ */
+export declare function loadAllPeers(localRepoRoot: string, manifest: FederationManifest): {
+    peers: Map<string, DomainModel>;
+    warnings: string[];
+};
+/**
+ * Build the env-var key used to override a peer's source path.
+ * Exposed for tests and for the `peers status` command.
+ */
+export declare function peerEnvKey(serviceName: string): string;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/features/federation/loader.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EACV,kBAAkB,EAClB,QAAQ,EACT,MAAM,kCAAkC,CAAC;AAuB1C,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAkBvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,cAAc,CAoDrF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,kBAAkB,GAC3B;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAoBzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/features/federation/loader.js

@@ -0,0 +1,193 @@
+/**
+ * Federation loader — resolves peer services declared in
+ * `.dkk/federation.yml` and loads each peer's `.dkk/` as a read-only
+ * sub-model attached at `model.peers.get(serviceName)`.
+ *
+ * Peer loading is exactly one level deep: a peer's own `federation.yml`
+ * is intentionally NOT followed. Peers are loaded in lenient mode so
+ * that DKK schema drift across services (peer YAML using fields the
+ * local DKK version doesn't understand) degrades to a warning rather
+ * than failing the consumer's load.
+ *
+ * Two source types are supported:
+ *  - `local`: a filesystem path (absolute or relative to repo root).
+ *  - `git`:   resolved against the cache at `.dkk/imports/<service>/`
+ *             populated by `dkk pull` (Phase 3).
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { isAbsolute, resolve, join } from "node:path";
+import { createRequire } from "node:module";
+import { parseYaml } from "../../shared/yaml.js";
+import { federationFile, importedServiceDir, schemaDir, repoRoot } from "../../shared/paths.js";
+import { loadDomainModel, setFederationHook } from "../../shared/loader.js";
+// ajv is a CJS package — use createRequire for ESM interop.
+const require = createRequire(import.meta.url);
+const Ajv = require("ajv").default;
+const addFormats = require("ajv-formats").default;
+/** Cached Ajv instance for federation.yml validation. */
+let cachedAjv = null;
+function getAjv() {
+    if (cachedAjv)
+        return cachedAjv;
+    const ajv = new Ajv({ allErrors: true, strict: true });
+    addFormats(ajv);
+    const dir = schemaDir();
+    for (const f of readdirSync(dir).filter((n) => n.endsWith(".schema.json"))) {
+        const schema = JSON.parse(readFileSync(join(dir, f), "utf-8"));
+        ajv.addSchema(schema, schema.$id);
+    }
+    cachedAjv = ajv;
+    return ajv;
+}
+/**
+ * Read `.dkk/federation.yml` (if present), validate it against
+ * `federation.schema.json`, and return the parsed manifest. Returns
+ * `null` for unfederated repos.
+ *
+ * Throws when the file exists but does not conform to the schema —
+ * the message includes Ajv's error list so the user can fix the
+ * manifest directly.
+ */
+export function loadFederation(root) {
+    const path = federationFile(root);
+    if (!existsSync(path))
+        return null;
+    const text = readFileSync(path, "utf-8");
+    const parsed = parseYaml(text);
+    const ajv = getAjv();
+    const valid = ajv.validate("federation.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: { peers: [{ name, source: { type: "local" | "git", ... } }] }`);
+    }
+    return parsed;
+}
+/**
+ * Resolve a single peer spec into an absolute repo-root path on disk.
+ *
+ * - `local` sources resolve relative to the local repo root (so
+ *   `../order-svc` in `billing-svc/.dkk/federation.yml` points at the
+ *   sibling directory regardless of `cwd`). Env-var override
+ *   `DKK_PEER_<SERVICE_NAME_UPPER>` (uppercase, hyphens → underscores)
+ *   takes precedence over the manifest's `source.path`.
+ * - `git` sources resolve to the cache directory
+ *   `.dkk/imports/<service>/` populated by `dkk pull`.
+ *
+ * The returned `peerRoot` points at the peer's repository root (so
+ * `<peerRoot>/.dkk/` is where the peer's domain lives).
+ */
+export function resolvePeerRoot(spec, localRepoRoot) {
+    const source = spec.source;
+    // Env-var override: applies to any source type for the convenience of
+    // developers who want to point at a local checkout regardless of
+    // what the committed manifest says.
+    const envKey = `DKK_PEER_${spec.name.toUpperCase().replace(/-/g, "_")}`;
+    const envOverride = process.env[envKey];
+    if (envOverride && envOverride.length > 0) {
+        const peerRoot = isAbsolute(envOverride)
+            ? envOverride
+            : resolve(localRepoRoot, envOverride);
+        const reachable = existsSync(peerRoot + "/.dkk");
+        return {
+            peerRoot,
+            reachable,
+            reason: reachable ? undefined : `env override ${envKey} points at ${peerRoot} but it has no .dkk/`,
+        };
+    }
+    if (source.type === "local") {
+        const peerRoot = isAbsolute(source.path)
+            ? source.path
+            : resolve(localRepoRoot, source.path);
+        const reachable = existsSync(peerRoot + "/.dkk");
+        return {
+            peerRoot,
+            reachable,
+            reason: reachable ? undefined : `local path ${peerRoot} has no .dkk/`,
+        };
+    }
+    if (source.type === "git") {
+        const cacheRoot = importedServiceDir(spec.name, localRepoRoot);
+        // When the peer's `.dkk/` lives in a sub-directory of its repo
+        // (monorepo case), the manifest's `source.path` names that
+        // sub-directory; the sparse-checkout pulls it into the cache at
+        // the same relative location.
+        const peerRoot = source.path
+            ? `${cacheRoot}/${source.path.replace(/\/$/, "")}`
+            : cacheRoot;
+        const reachable = existsSync(peerRoot + "/.dkk");
+        return {
+            peerRoot,
+            reachable,
+            reason: reachable ? undefined : `git cache empty for "${spec.name}" — run \`dkk pull ${spec.name}\``,
+        };
+    }
+    // Exhaustiveness check — future source types should be added here.
+    const exhaustive = source;
+    return { peerRoot: null, reachable: false, reason: `unknown source type: ${JSON.stringify(exhaustive)}` };
+}
+/**
+ * Load a peer's domain model in "peer mode": one level deep (peer's
+ * own `federation.yml` is skipped) and resilient to minor schema
+ * drift. The peer's model is structurally identical to a local model
+ * so the same `loadDomainModel` is reused; the federation pass is
+ * suppressed via the `followPeers: false` option.
+ */
+export function loadPeerModel(peerRoot) {
+    return loadDomainModel({ root: peerRoot, followPeers: false });
+}
+/**
+ * Resolve and load every peer declared in the manifest. Unreachable
+ * peers are reported via `warnings` (each line is one peer) but never
+ * abort the load — the caller (typically the main loader) attaches
+ * the resulting map to `model.peers`.
+ */
+export function loadAllPeers(localRepoRoot, manifest) {
+    const peers = new Map();
+    const warnings = [];
+    for (const spec of manifest.peers ?? []) {
+        const resolution = resolvePeerRoot(spec, localRepoRoot);
+        if (!resolution.reachable || !resolution.peerRoot) {
+            warnings.push(`peer "${spec.name}" unreachable: ${resolution.reason ?? "unknown"}`);
+            continue;
+        }
+        try {
+            const model = loadPeerModel(resolution.peerRoot);
+            peers.set(spec.name, model);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            warnings.push(`peer "${spec.name}" failed to load: ${msg}`);
+        }
+    }
+    return { peers, warnings };
+}
+/**
+ * Build the env-var key used to override a peer's source path.
+ * Exposed for tests and for the `peers status` command.
+ */
+export function peerEnvKey(serviceName) {
+    return `DKK_PEER_${serviceName.toUpperCase().replace(/-/g, "_")}`;
+}
+// ── Hook registration ────────────────────────────────────────────────
+//
+// Register the peer-hydration hook with the shared loader at module
+// initialisation. Any CLI command that imports this slice (directly or
+// transitively via the federation commands wired in cli.ts) will cause
+// `loadDomainModel` to start populating `model.peers`. Scripts that
+// import the shared loader without the federation slice get plain
+// unfederated behaviour — no surprises, no cycles.
+setFederationHook((root, model) => {
+    const manifest = loadFederation(root);
+    if (!manifest)
+        return;
+    const resolvedRoot = repoRoot(root);
+    const { peers, warnings } = loadAllPeers(resolvedRoot, manifest);
+    if (peers.size > 0)
+        model.peers = peers;
+    for (const w of warnings) {
+        console.warn(`dkk: ${w}`);
+    }
+});
+//# sourceMappingURL=loader.js.map