domain-knowledge-kit 0.2.15 → 0.2.19

package/dist/features/scaffold/commands/new-domain.d.ts

@@ -8,7 +8,29 @@
  *     context.yml, events/, commands/, aggregates/, policies/, read-models/
  *
  * Errors if `.dkk/domain/` already exists (use `--force` to overwrite).
+ *
+ * The scaffold logic is also exported as `scaffoldDomain()` so `dkk init`
+ * can bootstrap the same structure during project initialization.
  */
 import type { Command as Cmd } from "commander";
+export type ScaffoldDomainStatus = "created" | "skipped" | "replaced";
+export interface ScaffoldDomainResult {
+    status: ScaffoldDomainStatus;
+    path: string;
+}
+/**
+ * Scaffold `.dkk/domain/` with sample content.
+ *
+ * - If the directory does not exist, creates it (`status: "created"`).
+ * - If it exists and `force` is false, leaves it untouched (`status: "skipped"`).
+ * - If it exists and `force` is true, removes it entirely first, then
+ *   creates a fresh scaffold (`status: "replaced"`).
+ */
+export declare function scaffoldDomain(opts?: {
+    root?: string;
+    force?: boolean;
+}): ScaffoldDomainResult;
+/** Files created by a successful scaffold — used by callers that print their own report. */
+export declare const SCAFFOLD_DOMAIN_FILES: readonly string[];
 export declare function registerNewDomain(program: Cmd): void;
 //# sourceMappingURL=new-domain.d.ts.map

package/dist/features/scaffold/commands/new-domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new-domain.d.ts","sourceRoot":"","sources":["../../../../src/features/scaffold/commands/new-domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AA0DhD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA6DpD"}
+{"version":3,"file":"new-domain.d.ts","sourceRoot":"","sources":["../../../../src/features/scaffold/commands/new-domain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AA0DhD,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,oBAAoB,CA0BlG;AAED,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAOlD,CAAC;AAIF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAmCpD"}

package/dist/features/scaffold/commands/new-domain.js

@@ -45,6 +45,45 @@ emits:
   events:
     - SampleCreated
 `;
+/**
+ * Scaffold `.dkk/domain/` with sample content.
+ *
+ * - If the directory does not exist, creates it (`status: "created"`).
+ * - If it exists and `force` is false, leaves it untouched (`status: "skipped"`).
+ * - If it exists and `force` is true, removes it entirely first, then
+ *   creates a fresh scaffold (`status: "replaced"`).
+ */
+export function scaffoldDomain(opts = {}) {
+    const dir = domainDir(opts.root);
+    if (existsSync(dir) && !opts.force) {
+        return { status: "skipped", path: dir };
+    }
+    const replaced = existsSync(dir) && (opts.force ?? false);
+    if (replaced) {
+        rmSync(dir, { recursive: true, force: true });
+    }
+    const contextsBase = join(dir, "contexts", "sample");
+    const subDirs = ["events", "commands", "aggregates", "policies", "read-models"];
+    for (const sub of subDirs) {
+        mkdirSync(join(contextsBase, sub), { recursive: true });
+    }
+    writeFileSync(join(dir, "index.yml"), INDEX_YML, "utf-8");
+    writeFileSync(join(dir, "actors.yml"), ACTORS_YML, "utf-8");
+    writeFileSync(join(contextsBase, "context.yml"), CONTEXT_YML, "utf-8");
+    writeFileSync(join(contextsBase, "events", "SampleCreated.yml"), SAMPLE_EVENT, "utf-8");
+    writeFileSync(join(contextsBase, "commands", "CreateSample.yml"), SAMPLE_COMMAND, "utf-8");
+    writeFileSync(join(contextsBase, "aggregates", "Sample.yml"), SAMPLE_AGGREGATE, "utf-8");
+    return { status: replaced ? "replaced" : "created", path: dir };
+}
+/** Files created by a successful scaffold — used by callers that print their own report. */
+export const SCAFFOLD_DOMAIN_FILES = [
+    "index.yml",
+    "actors.yml",
+    "contexts/sample/context.yml",
+    "contexts/sample/events/SampleCreated.yml",
+    "contexts/sample/commands/CreateSample.yml",
+    "contexts/sample/aggregates/Sample.yml",
+];
 // ── Registration ──────────────────────────────────────────────────────
 export function registerNewDomain(program) {
     program
@@ -56,44 +95,21 @@ export function registerNewDomain(program) {
         .option("--minify", "Minify JSON")
         .action((opts) => {
         const dir = domainDir(opts.root);
-        // Guard: refuse to overwrite unless --force
         if (existsSync(dir) && !opts.force) {
             console.error(`Error: ${dir} already exists. Use --force to replace it entirely.`);
             process.exit(1);
         }
-        // --force: remove the entire domain directory so the scaffold is applied
-        // to a clean slate (no silent merging of pre-existing content).
-        if (existsSync(dir) && opts.force) {
-            rmSync(dir, { recursive: true, force: true });
-        }
-        // Create directory structure
-        const contextsBase = join(dir, "contexts", "sample");
-        const subDirs = ["events", "commands", "aggregates", "policies", "read-models"];
-        for (const sub of subDirs) {
-            mkdirSync(join(contextsBase, sub), { recursive: true });
-        }
-        // Write files
-        writeFileSync(join(dir, "index.yml"), INDEX_YML, "utf-8");
-        writeFileSync(join(dir, "actors.yml"), ACTORS_YML, "utf-8");
-        writeFileSync(join(contextsBase, "context.yml"), CONTEXT_YML, "utf-8");
-        writeFileSync(join(contextsBase, "events", "SampleCreated.yml"), SAMPLE_EVENT, "utf-8");
-        writeFileSync(join(contextsBase, "commands", "CreateSample.yml"), SAMPLE_COMMAND, "utf-8");
-        writeFileSync(join(contextsBase, "aggregates", "Sample.yml"), SAMPLE_AGGREGATE, "utf-8");
+        const result = scaffoldDomain({ root: opts.root, force: opts.force });
         if (opts.json) {
             console.log(JSON.stringify({
-                path: dir,
-                success: true
+                path: result.path,
+                success: true,
             }, null, opts.minify ? 0 : 2));
             return;
         }
         console.log("Created .dkk/domain/ with sample content:");
-        console.log("  index.yml");
-        console.log("  actors.yml");
-        console.log("  contexts/sample/");
-        console.log("    context.yml");
-        console.log("    events/SampleCreated.yml");
-        console.log("    commands/CreateSample.yml");
-        console.log("    aggregates/Sample.yml");
+        for (const f of SCAFFOLD_DOMAIN_FILES)
+            console.log(`  ${f}`);
         console.log("\nRun `dkk render` to validate and generate documentation.");
     });
 }

package/dist/features/scaffold/commands/new-domain.js.map

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

package/dist/features/scaffold/commands/service-init.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `dkk service init` command — declare this repo as a federated service.
+ *
+ * Writes `.dkk/service.yml` with the given name and exported contexts.
+ * This is the foundation for cross-repo references: peer repos can
+ * now address items in this service as `<name>:<context>.<Item>`.
+ *
+ * Errors if `.dkk/service.yml` already exists (use `--force` to replace).
+ */
+import type { Command as Cmd } from "commander";
+export declare function registerServiceInit(program: Cmd): void;
+//# sourceMappingURL=service-init.d.ts.map

package/dist/features/scaffold/commands/service-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-init.d.ts","sourceRoot":"","sources":["../../../../src/features/scaffold/commands/service-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAYhD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA+EtD"}

package/dist/features/scaffold/commands/service-init.js

@@ -0,0 +1,69 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { serviceFile } from "../../../shared/paths.js";
+import { stringifyYaml } from "../../../shared/yaml.js";
+/** Validate name is kebab-case per schema: ^[a-z][a-z0-9-]*$ */
+function isValidKebab(name) {
+    return /^[a-z][a-z0-9-]*$/.test(name);
+}
+export function registerServiceInit(program) {
+    const service = program
+        .command("service")
+        .description("Service identity and federation commands");
+    service
+        .command("init")
+        .description("Declare this repo as a federated service (writes .dkk/service.yml)")
+        .requiredOption("--name <name>", "Kebab-case service name (e.g. ordering)")
+        .option("--export <context...>", "Bounded-context names to export for federation (repeat or comma-separate)")
+        .option("--description <text>", "Optional human-readable description")
+        .option("-r, --root <path>", "Override repository root")
+        .option("--force", "Overwrite an existing service.yml")
+        .option("--json", "Output as JSON")
+        .option("--minify", "Minify JSON output")
+        .action((opts) => {
+        // Validate name
+        if (!isValidKebab(opts.name)) {
+            console.error(`Error: Service name "${opts.name}" is invalid. Use kebab-case (e.g. "ordering" or "order-management").`);
+            process.exit(1);
+        }
+        // Normalize --export: commander gives an array, but each entry may
+        // also be a comma-separated list (user-friendly: --export a,b,c).
+        const rawExports = opts.export ?? [];
+        const exports = [];
+        for (const entry of rawExports) {
+            for (const ctx of entry.split(",")) {
+                const trimmed = ctx.trim();
+                if (trimmed.length === 0)
+                    continue;
+                if (!isValidKebab(trimmed)) {
+                    console.error(`Error: Export "${trimmed}" is not kebab-case.`);
+                    process.exit(1);
+                }
+                if (!exports.includes(trimmed))
+                    exports.push(trimmed);
+            }
+        }
+        const path = serviceFile(opts.root);
+        if (existsSync(path) && !opts.force) {
+            console.error(`Error: ${path} already exists. Use --force to overwrite.`);
+            process.exit(1);
+        }
+        const manifest = {
+            name: opts.name,
+            exports,
+        };
+        if (opts.description)
+            manifest.description = opts.description;
+        mkdirSync(dirname(path), { recursive: true });
+        const header = "# Service identity for federation. See `dkk service --help`.\n";
+        writeFileSync(path, header + stringifyYaml(manifest), "utf-8");
+        if (opts.json) {
+            console.log(JSON.stringify({ path, name: opts.name, exports }, null, opts.minify ? 0 : 2));
+            return;
+        }
+        console.log(`Created ${path}`);
+        console.log(`  name: ${opts.name}`);
+        console.log(`  exports: [${exports.join(", ")}]`);
+    });
+}
+//# sourceMappingURL=service-init.js.map

package/dist/features/scaffold/commands/service-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-init.js","sourceRoot":"","sources":["../../../../src/features/scaffold/commands/service-init.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,gEAAgE;AAChE,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAY;IAC9C,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,0CAA0C,CAAC,CAAC;IAE3D,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oEAAoE,CAAC;SACjF,cAAc,CAAC,eAAe,EAAE,yCAAyC,CAAC;SAC1E,MAAM,CAAC,uBAAuB,EAAE,2EAA2E,CAAC;SAC5G,MAAM,CAAC,sBAAsB,EAAE,qCAAqC,CAAC;SACrE,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,mCAAmC,CAAC;SACtD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,UAAU,EAAE,oBAAoB,CAAC;SACxC,MAAM,CAAC,CAAC,IAQR,EAAE,EAAE;QACH,gBAAgB;QAChB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CACX,wBAAwB,IAAI,CAAC,IAAI,uEAAuE,CACzG,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,mEAAmE;QACnE,kEAAkE;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBACnC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,OAAO,CAAC,KAAK,CAAC,kBAAkB,OAAO,sBAAsB,CAAC,CAAC;oBAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,4CAA4C,CAAC,CAAC;YAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAoB;YAChC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO;SACR,CAAC;QACF,IAAI,IAAI,CAAC,WAAW;YAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAE9D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,gEAAgE,CAAC;QAChF,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAE/D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,EAClC,IAAI,EACJ,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACpB,CACF,CAAC;YACF,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/shared/graph.d.ts

@@ -47,6 +47,14 @@ export declare class DomainGraph {
     private constructor();
     /**
      * Build a domain graph from a loaded {@link DomainModel}.
+     *
+     * Federation-aware: the local model is walked first, then each peer
+     * model in `model.peers` is walked with its service name as a prefix.
+     * Local node ids keep the bare grammar (`<ctx>.<Name>`, `actor.X`,
+     * `adr-NNNN`, `flow.X`, `context.X`); peer node ids are prefixed
+     * with `<peerService>:` so a local policy referencing
+     * `ordering:ordering.OrderCancelled` connects through to the peer's
+     * node by name.
      */
     static from(model: DomainModel): DomainGraph;
     /**

package/dist/shared/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/shared/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAsD,MAAM,mBAAmB,CAAC;AAMzG,iDAAiD;AACjD,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,OAAO,GACP,KAAK,GACL,UAAU,GACV,MAAM,CAAC;AAEX,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAqBD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAErC,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;IAE/C,OAAO;IAYP;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAsL5C;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,GAAG,CAAC,MAAM,CAAC;IAwB3D;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAI1C;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG7B"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/shared/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAsD,MAAM,mBAAmB,CAAC;AAOzG,iDAAiD;AACjD,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,OAAO,GACP,KAAK,GACL,UAAU,GACV,MAAM,CAAC;AAEX,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACxB,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAqBD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAErC,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;IAE/C,OAAO;IAYP;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW;IAyO5C;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,GAAG,CAAC,MAAM,CAAC;IAwB3D;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAI1C;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG7B"}

package/dist/shared/graph.js

@@ -10,6 +10,7 @@
  * performs a breadth-first traversal up to a specified depth.
  */
 import { forEachItem, itemAdrRefs } from "./item-visitor.js";
+import { parseRef, qualifyItemRef, qualifyActorRef } from "./refs.js";
 // ── Helpers ───────────────────────────────────────────────────────────
 /** Build scoped id for a context-local item. */
 function scopedId(context, name) {
@@ -44,6 +45,14 @@ export class DomainGraph {
     // ── Factory ───────────────────────────────────────────────────────
     /**
      * Build a domain graph from a loaded {@link DomainModel}.
+     *
+     * Federation-aware: the local model is walked first, then each peer
+     * model in `model.peers` is walked with its service name as a prefix.
+     * Local node ids keep the bare grammar (`<ctx>.<Name>`, `actor.X`,
+     * `adr-NNNN`, `flow.X`, `context.X`); peer node ids are prefixed
+     * with `<peerService>:` so a local policy referencing
+     * `ordering:ordering.OrderCancelled` connects through to the peer's
+     * node by name.
      */
     static from(model) {
         const nodes = new Map();
@@ -74,136 +83,195 @@ export class DomainGraph {
             adj.get(from)?.add(to);
             adj.get(to)?.add(from);
         }
-        /** Wire adr_refs for any item. */
-        function wireAdrRefs(itemId, adrRefs) {
+        /** Wire adr_refs for any item. Adds the peer prefix when refs are bare. */
+        function wireAdrRefs(itemId, adrRefs, prefix) {
             if (!adrRefs)
                 return;
             for (const ref of adrRefs) {
-                // ADR node might not exist yet if the ADR file wasn't present;
-                // we still create a placeholder node so the edge is recorded.
-                ensureNode(ref, "adr", ref);
-                addEdge(itemId, ref, "adr_ref");
+                // Author-qualified refs (already contain `:`) stay as-is; bare
+                // refs are prefixed with this walk's service prefix.
+                const nodeRefId = ref.includes(":") || !prefix ? ref : `${prefix}${ref}`;
+                ensureNode(nodeRefId, "adr", nodeRefId);
+                addEdge(itemId, nodeRefId, "adr_ref");
             }
         }
-        // ── Actors ────────────────────────────────────────────────────
-        for (const actor of model.actors) {
-            const id = ensureNode(actorId(actor.name), "actor", actor.name);
-            wireAdrRefs(id, actor.adr_refs);
-        }
-        // ── Bounded contexts & their items ────────────────────────────
-        for (const [ctxName, ctx] of model.contexts) {
-            const ctxId = ensureNode(`context.${ctxName}`, "context", ctxName);
-            wireAdrRefs(ctxId, undefined); // contexts don't have adr_refs currently
-            // Visit all item types: create node, add contains edge, wire ADR refs,
-            // then apply type-specific relationship wiring.
-            forEachItem(ctx, (type, name, item) => {
-                const nodeKind = type;
-                const id = ensureNode(scopedId(ctxName, name), nodeKind, name, ctxName);
-                addEdge(ctxId, id, "contains");
-                wireAdrRefs(id, itemAdrRefs(item));
-                // Type-specific relationship wiring
-                switch (type) {
-                    case "event": {
-                        const evt = item;
-                        if (evt.raised_by) {
-                            const aggId = ensureNode(scopedId(ctxName, evt.raised_by), "aggregate", evt.raised_by, ctxName);
-                            addEdge(aggId, id, "emits");
+        /**
+         * Walk one model (local or peer). When `walkPrefix` is set to
+         * `"<peerName>:"`, every node id created inside this walk is
+         * prefixed accordingly, so local + peer namespaces stay disjoint.
+         */
+        function walkOne(m, walkPrefix) {
+            // ── Actors ────────────────────────────────────────────────────
+            for (const actor of m.actors) {
+                const id = ensureNode(`${walkPrefix}${actorId(actor.name)}`, "actor", actor.name);
+                wireAdrRefs(id, actor.adr_refs, walkPrefix);
+            }
+            // ── Bounded contexts & their items ────────────────────────────
+            for (const [ctxName, ctx] of m.contexts) {
+                const ctxId = ensureNode(`${walkPrefix}context.${ctxName}`, "context", ctxName);
+                wireAdrRefs(ctxId, undefined, walkPrefix);
+                forEachItem(ctx, (type, name, item) => {
+                    const nodeKind = type;
+                    const id = ensureNode(`${walkPrefix}${scopedId(ctxName, name)}`, nodeKind, name, ctxName);
+                    addEdge(ctxId, id, "contains");
+                    wireAdrRefs(id, itemAdrRefs(item), walkPrefix);
+                    switch (type) {
+                        case "event": {
+                            const evt = item;
+                            if (evt.raised_by) {
+                                const res = qualifyItemRef(evt.raised_by, walkPrefix, ctxName);
+                                const aggId = ensureNode(res.id, "aggregate", res.name, res.context);
+                                addEdge(aggId, id, "emits");
+                            }
+                            break;
                         }
-                        break;
-                    }
-                    case "command": {
-                        const cmd = item;
-                        if (cmd.handled_by) {
-                            const aggId = ensureNode(scopedId(ctxName, cmd.handled_by), "aggregate", cmd.handled_by, ctxName);
-                            addEdge(aggId, id, "handles");
+                        case "command": {
+                            const cmd = item;
+                            if (cmd.handled_by) {
+                                const res = qualifyItemRef(cmd.handled_by, walkPrefix, ctxName);
+                                const aggId = ensureNode(res.id, "aggregate", res.name, res.context);
+                                addEdge(aggId, id, "handles");
+                            }
+                            if (cmd.actor) {
+                                const a = qualifyActorRef(cmd.actor, walkPrefix);
+                                const aId = ensureNode(a.id, "actor", a.name);
+                                addEdge(aId, id, "initiates");
+                            }
+                            break;
                         }
-                        if (cmd.actor) {
-                            const aId = ensureNode(actorId(cmd.actor), "actor", cmd.actor);
-                            addEdge(aId, id, "initiates");
+                        case "policy": {
+                            const pol = item;
+                            for (const trigger of pol.when?.events ?? []) {
+                                const res = qualifyItemRef(trigger, walkPrefix, ctxName);
+                                const evtId = ensureNode(res.id, "event", res.name, res.context);
+                                addEdge(evtId, id, "triggers");
+                            }
+                            for (const emitted of pol.then?.commands ?? []) {
+                                const res = qualifyItemRef(emitted, walkPrefix, ctxName);
+                                const cmdId = ensureNode(res.id, "command", res.name, res.context);
+                                addEdge(id, cmdId, "emits");
+                            }
+                            break;
                         }
-                        break;
-                    }
-                    case "policy": {
-                        const pol = item;
-                        for (const trigger of pol.when?.events ?? []) {
-                            const evtId = ensureNode(scopedId(ctxName, trigger), "event", trigger, ctxName);
-                            addEdge(evtId, id, "triggers");
+                        case "aggregate": {
+                            const agg = item;
+                            for (const h of agg.handles?.commands ?? []) {
+                                const res = qualifyItemRef(h, walkPrefix, ctxName);
+                                const cmdId = ensureNode(res.id, "command", res.name, res.context);
+                                addEdge(id, cmdId, "handles");
+                            }
+                            for (const e of agg.emits?.events ?? []) {
+                                const res = qualifyItemRef(e, walkPrefix, ctxName);
+                                const evtId = ensureNode(res.id, "event", res.name, res.context);
+                                addEdge(id, evtId, "emits");
+                            }
+                            break;
                         }
-                        for (const emitted of pol.then?.commands ?? []) {
-                            const cmdId = ensureNode(scopedId(ctxName, emitted), "command", emitted, ctxName);
-                            addEdge(id, cmdId, "emits");
+                        case "read_model": {
+                            const rm = item;
+                            for (const sub of rm.subscribes_to ?? []) {
+                                const res = qualifyItemRef(sub, walkPrefix, ctxName);
+                                const evtId = ensureNode(res.id, "event", res.name, res.context);
+                                addEdge(id, evtId, "subscribes_to");
+                            }
+                            for (const user of rm.used_by ?? []) {
+                                const a = qualifyActorRef(user, walkPrefix);
+                                const aId = ensureNode(a.id, "actor", a.name);
+                                addEdge(id, aId, "used_by");
+                            }
+                            break;
                         }
-                        break;
+                        case "glossary":
+                            // Glossary items have no type-specific relationship wiring.
+                            break;
                     }
-                    case "aggregate": {
-                        const agg = item;
-                        for (const h of agg.handles?.commands ?? []) {
-                            const cmdId = ensureNode(scopedId(ctxName, h), "command", h, ctxName);
-                            addEdge(id, cmdId, "handles");
-                        }
-                        for (const e of agg.emits?.events ?? []) {
-                            const evtId = ensureNode(scopedId(ctxName, e), "event", e, ctxName);
-                            addEdge(id, evtId, "emits");
-                        }
-                        break;
+                });
+            }
+            // ── ADRs ──────────────────────────────────────────────────────
+            for (const [adrIdRaw, adr] of m.adrs) {
+                const adrNodeId = `${walkPrefix}${adrIdRaw}`;
+                ensureNode(adrNodeId, "adr", adr.title);
+                // domain_refs → domain items. Use parseRef to split correctly
+                // for both bare and service-prefixed forms.
+                for (const ref of adr.domain_refs ?? []) {
+                    const parsed = parseRef(ref);
+                    if (parsed?.kind === "item" && parsed.service) {
+                        // Explicit peer ref — keep as-is.
+                        const id = `${parsed.service}:${parsed.context}.${parsed.name}`;
+                        ensureNode(id, "aggregate", parsed.name, parsed.context);
+                        addEdge(adrNodeId, id, "domain_ref");
                     }
-                    case "read_model": {
-                        const rm = item;
-                        for (const sub of rm.subscribes_to ?? []) {
-                            const evtId = ensureNode(scopedId(ctxName, sub), "event", sub, ctxName);
-                            addEdge(id, evtId, "subscribes_to");
-                        }
-                        for (const user of rm.used_by ?? []) {
-                            const aId = ensureNode(actorId(user), "actor", user);
-                            addEdge(id, aId, "used_by");
-                        }
-                        break;
+                    else if (parsed?.kind === "item") {
+                        // Bare ref — prefix with this walk's service.
+                        const id = `${walkPrefix}${parsed.context}.${parsed.name}`;
+                        ensureNode(id, "aggregate", parsed.name, parsed.context);
+                        addEdge(adrNodeId, id, "domain_ref");
+                    }
+                    else {
+                        // Unparseable — record edge against the raw form so
+                        // visibility is preserved even though the node is dangling.
+                        ensureNode(ref, "aggregate", ref);
+                        addEdge(adrNodeId, ref, "domain_ref");
                     }
-                    case "glossary":
-                        // Glossary items have no type-specific relationship wiring.
-                        break;
                 }
-            });
-        }
-        // ── ADRs ──────────────────────────────────────────────────────
-        for (const [adrId, adr] of model.adrs) {
-            ensureNode(adrId, "adr", adr.title);
-            // domain_refs → domain items
-            for (const ref of adr.domain_refs ?? []) {
-                // ref is in "context.Name" format — ensure node exists
-                const dotIdx = ref.indexOf(".");
-                if (dotIdx > 0) {
-                    const ctx = ref.slice(0, dotIdx);
-                    const name = ref.slice(dotIdx + 1);
-                    // We don't know the item kind from the ref alone; default to
-                    // a generic node that will be reconciled if it was already created.
-                    ensureNode(ref, "aggregate", name, ctx);
+                // superseded_by → another ADR
+                if (adr.superseded_by) {
+                    const parsed = parseRef(adr.superseded_by);
+                    const targetId = parsed?.kind === "adr"
+                        ? parsed.service
+                            ? `${parsed.service}:${parsed.id}`
+                            : `${walkPrefix}${parsed.id}`
+                        : adr.superseded_by;
+                    ensureNode(targetId, "adr", targetId);
+                    addEdge(adrNodeId, targetId, "superseded_by");
                 }
-                addEdge(adrId, ref, "domain_ref");
             }
-            // superseded_by → another ADR
-            if (adr.superseded_by) {
-                ensureNode(adr.superseded_by, "adr", adr.superseded_by);
-                addEdge(adrId, adr.superseded_by, "superseded_by");
+            // ── Flows ─────────────────────────────────────────────────────
+            for (const flow of m.index.flows ?? []) {
+                const fId = ensureNode(`${walkPrefix}${flowId(flow.name)}`, "flow", flow.name);
+                let prevStepId;
+                for (const step of flow.steps) {
+                    const raw = step.ref;
+                    const parsed = parseRef(raw);
+                    let stepId;
+                    let ctx;
+                    let name;
+                    if (parsed?.kind === "item" && parsed.service) {
+                        stepId = `${parsed.service}:${parsed.context}.${parsed.name}`;
+                        ctx = parsed.context;
+                        name = parsed.name;
+                    }
+                    else if (parsed?.kind === "item") {
+                        stepId = `${walkPrefix}${parsed.context}.${parsed.name}`;
+                        ctx = parsed.context;
+                        name = parsed.name;
+                    }
+                    else {
+                        stepId = raw;
+                        const dot = raw.indexOf(".");
+                        ctx = dot > 0 ? raw.slice(0, dot) : undefined;
+                        name = dot > 0 ? raw.slice(dot + 1) : raw;
+                    }
+                    const kind = step.type === "read_model" ? "read_model" : step.type;
+                    ensureNode(stepId, kind, name, ctx);
+                    addEdge(fId, stepId, "flow_step");
+                    if (prevStepId) {
+                        addEdge(prevStepId, stepId, "flow_next");
+                    }
+                    prevStepId = stepId;
+                }
             }
         }
-        // ── Flows ─────────────────────────────────────────────────────
-        for (const flow of model.index.flows ?? []) {
-            const fId = ensureNode(flowId(flow.name), "flow", flow.name);
-            let prevStepId;
-            for (const step of flow.steps) {
-                const ref = step.ref;
-                const dotIdx = ref.indexOf(".");
-                const ctx = dotIdx > 0 ? ref.slice(0, dotIdx) : undefined;
-                const name = dotIdx > 0 ? ref.slice(dotIdx + 1) : ref;
-                const kind = step.type === "read_model" ? "read_model" : step.type;
-                ensureNode(ref, kind, name, ctx);
-                addEdge(fId, ref, "flow_step");
-                // Link consecutive flow steps
-                if (prevStepId) {
-                    addEdge(prevStepId, ref, "flow_next");
-                }
-                prevStepId = ref;
+        // Local walk (no prefix).
+        walkOne(model, "");
+        // Peer walks, one prefix per peer.
+        for (const [peerName, peerModel] of model.peers ?? []) {
+            try {
+                walkOne(peerModel, `${peerName}:`);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(`dkk: skipped graphing peer "${peerName}": ${msg}`);
             }
         }
         return new DomainGraph(nodes, edges, adj);