domain-knowledge-kit 0.2.15 → 0.2.16

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

@@ -0,0 +1,126 @@
+import { loadDomainModel } from "../../../shared/loader.js";
+import { parseRef } from "../../../shared/refs.js";
+// Side-effect import: registers the peer-hydration hook with the
+// shared loader so `loadDomainModel` populates `model.peers`.
+import "../loader.js";
+export function registerConsumers(program) {
+    program
+        .command("consumers <id>")
+        .description("List peers that reference this local item (reverse lookup across federation)")
+        .option("-r, --root <path>", "Override repository root")
+        .option("--json", "Output as JSON")
+        .option("--minify", "Minify JSON output")
+        .action((id, opts) => {
+        const model = loadDomainModel({ root: opts.root });
+        const localService = model.service?.name;
+        const hits = findConsumers(model, id, localService);
+        if (opts.json) {
+            console.log(JSON.stringify({ item: id, service: localService ?? null, consumers: hits }, null, opts.minify ? 0 : 2));
+            return;
+        }
+        if (hits.length === 0) {
+            console.log(`No peer consumers of "${id}" found in ${model.peers?.size ?? 0} federated peer(s).`);
+            return;
+        }
+        console.log(`${hits.length} reference(s) to "${id}":`);
+        for (const h of hits) {
+            console.log(`  ${h.service}  ${h.source}  [${h.relation}]  → ${h.ref}`);
+        }
+    });
+}
+/**
+ * Walk every loaded peer model and collect references back to the
+ * queried item. Matches both the fully-qualified peer form
+ * (`<localService>:<ctx>.<Name>`) and bare names — the latter handles
+ * the case where a peer references the same item via shorthand
+ * inside its own walk (uncommon, but possible).
+ */
+export function findConsumers(model, rawId, localService) {
+    const hits = [];
+    if (!model.peers || model.peers.size === 0)
+        return hits;
+    const parsed = parseRef(rawId);
+    if (!parsed)
+        return hits;
+    // The forms a peer might use to reference our local item:
+    //  - Full federated: `<localService>:<ctx>.<Name>` (or `:<ItemName>` shorthand)
+    //  - Bare: only valid when peer happens to share our service name (rare)
+    // We pre-compute the candidate strings to match.
+    const matches = new Set();
+    if (parsed.kind === "item") {
+        if (localService) {
+            matches.add(`${localService}:${parsed.context}.${parsed.name}`);
+            matches.add(`${localService}:${parsed.name}`);
+        }
+        matches.add(`${parsed.context}.${parsed.name}`);
+    }
+    else if (parsed.kind === "adr") {
+        if (localService)
+            matches.add(`${localService}:${parsed.id}`);
+        matches.add(parsed.id);
+    }
+    else if (parsed.kind === "actor") {
+        if (localService)
+            matches.add(`${localService}:actor.${parsed.name}`);
+        matches.add(`actor.${parsed.name}`);
+    }
+    for (const [peerName, peerModel] of model.peers) {
+        walkRefs(peerModel, peerName, (relation, source, ref) => {
+            if (matches.has(ref)) {
+                hits.push({ service: peerName, source, relation, ref });
+            }
+        });
+    }
+    return hits;
+}
+/**
+ * Visit every ref-bearing field in a model, invoking `visit` with
+ * (relation, source-path, raw-ref) per occurrence.
+ *
+ * Intentionally narrow — covers the validator's lookup sites so the
+ * reverse view stays consistent with the forward view.
+ */
+function walkRefs(model, modelName, visit) {
+    for (const [ctxName, ctx] of model.contexts) {
+        for (const e of ctx.events ?? []) {
+            if (e.raised_by)
+                visit("raised_by", `${modelName}:${ctxName}.${e.name}`, e.raised_by);
+        }
+        for (const c of ctx.commands ?? []) {
+            if (c.handled_by)
+                visit("handled_by", `${modelName}:${ctxName}.${c.name}`, c.handled_by);
+            if (c.actor)
+                visit("actor", `${modelName}:${ctxName}.${c.name}`, c.actor);
+        }
+        for (const a of ctx.aggregates ?? []) {
+            for (const h of a.handles?.commands ?? [])
+                visit("handles.commands", `${modelName}:${ctxName}.${a.name}`, h);
+            for (const ev of a.emits?.events ?? [])
+                visit("emits.events", `${modelName}:${ctxName}.${a.name}`, ev);
+        }
+        for (const p of ctx.policies ?? []) {
+            for (const t of p.when?.events ?? [])
+                visit("when.events", `${modelName}:${ctxName}.${p.name}`, t);
+            for (const t of p.then?.commands ?? [])
+                visit("then.commands", `${modelName}:${ctxName}.${p.name}`, t);
+        }
+        for (const r of ctx.read_models ?? []) {
+            for (const s of r.subscribes_to ?? [])
+                visit("subscribes_to", `${modelName}:${ctxName}.${r.name}`, s);
+            for (const u of r.used_by ?? [])
+                visit("used_by", `${modelName}:${ctxName}.${r.name}`, u);
+        }
+    }
+    for (const [adrId, adr] of model.adrs) {
+        for (const ref of adr.domain_refs ?? [])
+            visit("domain_refs", `${modelName}:${adrId}`, ref);
+        if (adr.superseded_by)
+            visit("superseded_by", `${modelName}:${adrId}`, adr.superseded_by);
+    }
+    for (const flow of model.index.flows ?? []) {
+        for (const step of flow.steps) {
+            visit("flow.steps.ref", `${modelName}:flow.${flow.name}`, step.ref);
+        }
+    }
+}
+//# sourceMappingURL=consumers.js.map

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

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

package/dist/features/federation/commands/peers-add.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `dkk peers add <name>` — append a peer to .dkk/federation.yml.
+ *
+ * Two source forms (Phase 2 ships local; --git lands in Phase 3 but
+ * is parsed here so the CLI surface is forward-compatible):
+ *   dkk peers add <name> --local <path>
+ *   dkk peers add <name> --git <url> --branch <branch> [--git-path <subpath>]
+ *
+ * Idempotent: re-adding an existing peer with the same source is a
+ * no-op; replacing requires --force.
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerPeersAdd(parent: Cmd): void;
+//# sourceMappingURL=peers-add.d.ts.map

package/dist/features/federation/commands/peers-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers-add.d.ts","sourceRoot":"","sources":["../../../../src/features/federation/commands/peers-add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AA0BhD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAgFlD"}

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

@@ -0,0 +1,79 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { federationFile } from "../../../shared/paths.js";
+import { parseYaml, stringifyYaml } from "../../../shared/yaml.js";
+function isValidKebab(name) {
+    return /^[a-z][a-z0-9-]*$/.test(name);
+}
+export function registerPeersAdd(parent) {
+    parent
+        .command("add <name>")
+        .description("Register a peer service in .dkk/federation.yml")
+        .option("--local <path>", "Local filesystem path to the peer's repository root")
+        .option("--git <url>", "Git URL of the peer repository")
+        .option("--branch <branch>", "Branch to track for git sources", "main")
+        .option("--git-path <subpath>", "Sub-path inside the peer repo where .dkk/ lives")
+        .option("-r, --root <path>", "Override repository root")
+        .option("--force", "Replace an existing entry for this peer")
+        .option("--json", "Output as JSON")
+        .option("--minify", "Minify JSON output")
+        .action((name, opts) => {
+        if (!isValidKebab(name)) {
+            console.error(`Error: Peer name "${name}" must be kebab-case.`);
+            process.exit(1);
+        }
+        if (!opts.local && !opts.git) {
+            console.error("Error: must specify either --local <path> or --git <url>.");
+            process.exit(1);
+        }
+        if (opts.local && opts.git) {
+            console.error("Error: --local and --git are mutually exclusive.");
+            process.exit(1);
+        }
+        let source;
+        if (opts.local) {
+            source = { type: "local", path: opts.local };
+        }
+        else {
+            const branch = opts.branch ?? "main";
+            source = { type: "git", url: opts.git, branch };
+            if (opts.gitPath)
+                source.path = opts.gitPath;
+        }
+        const path = federationFile(opts.root);
+        let manifest;
+        if (existsSync(path)) {
+            manifest = parseYaml(readFileSync(path, "utf-8"));
+            if (!Array.isArray(manifest.peers))
+                manifest.peers = [];
+        }
+        else {
+            manifest = { peers: [] };
+            mkdirSync(dirname(path), { recursive: true });
+        }
+        const existingIdx = manifest.peers.findIndex((p) => p.name === name);
+        if (existingIdx >= 0 && !opts.force) {
+            console.error(`Error: peer "${name}" already exists. Use --force to replace.`);
+            process.exit(1);
+        }
+        const entry = { name, source };
+        if (existingIdx >= 0) {
+            manifest.peers[existingIdx] = entry;
+        }
+        else {
+            manifest.peers.push(entry);
+        }
+        const header = "# Federation manifest — peer services to load alongside this repo.\n";
+        writeFileSync(path, header + stringifyYaml(manifest), "utf-8");
+        if (opts.json) {
+            console.log(JSON.stringify({ path, peer: entry, replaced: existingIdx >= 0 }, null, opts.minify ? 0 : 2));
+            return;
+        }
+        const action = existingIdx >= 0 ? "Replaced" : "Added";
+        const summary = source.type === "local"
+            ? `local: ${source.path}`
+            : `git: ${source.url} @ ${source.branch}`;
+        console.log(`${action} peer "${name}" (${summary}) in ${path}`);
+    });
+}
+//# sourceMappingURL=peers-add.js.map

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

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

package/dist/features/federation/commands/peers-list.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `dkk peers list` — display the configured peer services and their
+ * reachability state. Reads `.dkk/federation.yml` and resolves each
+ * peer source without actually loading peer models.
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerPeersList(parent: Cmd): void;
+//# sourceMappingURL=peers-list.d.ts.map

package/dist/features/federation/commands/peers-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers-list.d.ts","sourceRoot":"","sources":["../../../../src/features/federation/commands/peers-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAUhD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAoDnD"}

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

@@ -0,0 +1,51 @@
+import { repoRoot } from "../../../shared/paths.js";
+import { loadFederation, resolvePeerRoot, peerEnvKey } from "../loader.js";
+export function registerPeersList(parent) {
+    parent
+        .command("list")
+        .description("List configured federation peers and reachability state")
+        .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. Add one with `dkk peers add <name> --local <path>`.");
+            return;
+        }
+        const rows = manifest.peers.map((peer) => {
+            const resolution = resolvePeerRoot(peer, root);
+            const envKey = peerEnvKey(peer.name);
+            const envOverride = process.env[envKey];
+            return {
+                name: peer.name,
+                source: peer.source,
+                peerRoot: resolution.peerRoot,
+                reachable: resolution.reachable,
+                envOverride: envOverride ?? null,
+                reason: resolution.reason ?? null,
+            };
+        });
+        if (opts.json) {
+            console.log(JSON.stringify({ peers: rows }, null, opts.minify ? 0 : 2));
+            return;
+        }
+        for (const row of rows) {
+            const label = row.source.type === "local"
+                ? `local: ${row.source.path}`
+                : `git: ${row.source.url} @ ${row.source.branch}`;
+            const status = row.reachable ? "reachable" : "unreachable";
+            const overrideTag = row.envOverride ? `  (env: ${row.envOverride})` : "";
+            console.log(`${row.name}  ${label}  [${status}]${overrideTag}`);
+            if (!row.reachable && row.reason) {
+                console.log(`  ${row.reason}`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=peers-list.js.map

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

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

package/dist/features/federation/commands/peers-status.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `dkk peers status` — diagnostic view of each configured peer:
+ * source, env override, reachability, loaded service identity, exports,
+ * and a peer-load warning count. More detailed than `peers list`.
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerPeersStatus(parent: Cmd): void;
+//# sourceMappingURL=peers-status.d.ts.map

package/dist/features/federation/commands/peers-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers-status.d.ts","sourceRoot":"","sources":["../../../../src/features/federation/commands/peers-status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAsBhD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CA4ErD"}

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":"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"}

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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"}