domain-knowledge-kit 0.2.15 → 0.2.16

package/dist/shared/loader.js

@@ -20,6 +20,16 @@ import { join, basename, extname } from "node:path";
 import { parseYaml } from "./yaml.js";
 import { parseAdrFile } from "./adr-parser.js";
 import { actorsFile, contextsDir, indexFile, adrDir, } from "./paths.js";
+import { loadServiceId } from "./service-id.js";
+let federationHook;
+/**
+ * Register a federation hook. Called once at module-init time by the
+ * federation slice. Passing `undefined` clears the hook (intended for
+ * tests).
+ */
+export function setFederationHook(hook) {
+    federationHook = hook;
+}
 // ── Helpers ───────────────────────────────────────────────────────────
 /** Read a YAML file and parse it into `T`. */
 function loadYaml(filePath) {
@@ -156,11 +166,31 @@ export function loadDomainModel(options = {}) {
             adrs.set(record.id, record);
         }
     }
-    return {
+    // 5. Service identity (federation Phase 1 — optional)
+    const service = loadServiceId(root) ?? undefined;
+    const model = {
         index,
         actors: actorsData.actors ?? [],
         contexts,
         adrs,
     };
+    if (service)
+        model.service = service;
+    // 6. Federation peers (Phase 2 — optional, one level deep).
+    // The federation slice registers itself via `setFederationHook` at
+    // module-init time. The hook is suppressed via `followPeers: false`
+    // when this loader is itself invoked from inside the federation
+    // slice (loading a peer's own model). That keeps peer-of-peer
+    // transitivity off without any cycle detection.
+    if (options.followPeers !== false && federationHook) {
+        try {
+            federationHook(root, model);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`dkk: federation load failed: ${msg}`);
+        }
+    }
+    return model;
 }
 //# sourceMappingURL=loader.js.map

package/dist/shared/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/shared/loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/shared/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,UAAU,EACV,WAAW,EACX,SAAS,EACT,MAAM,GACP,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAsBhD,IAAI,cAA0C,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgC;IAChE,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC;AAED,yEAAyE;AAEzE,8CAA8C;AAC9C,SAAS,QAAQ,CAAI,QAAgB;IACnC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,SAAS,CAAI,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC,CAAC;SACD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,WAAW,CAAC;IACrE,CAAC,CAAC;SACD,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,IAAI,GAAG,QAAQ,CAAkB,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAc,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAU,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAS,CAAC,CAAC,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAY,CAAC,CAAC,CAAC,CAAC;IAChG,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAY,CAAC,CAAC,CAAC,CAAC;IAEjG,MAAM,GAAG,GAAkB;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;IACF,IAAI,IAAI,CAAC,QAAQ,EAAE,MAAM;QAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IACxD,IAAI,MAAM,CAAC,MAAM;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACvC,IAAI,QAAQ,CAAC,MAAM;QAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7C,IAAI,QAAQ,CAAC,MAAM;QAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM;QAAE,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;IACnD,IAAI,UAAU,CAAC,MAAM;QAAE,GAAG,CAAC,WAAW,GAAG,UAAU,CAAC;IAEpD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IAEzC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACzC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QAEnC,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,IAAI,GAAG;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAmBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,UAAyB,EAAE;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1B,kBAAkB;IAClB,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAgB,UAAU,CAAC,SAAS,CAAC;QAC9C,CAAC,CAAC,QAAQ,CAAc,SAAS,CAAC;QAClC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAErB,YAAY;IACZ,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,UAAU,GAAe,UAAU,CAAC,UAAU,CAAC;QACnD,CAAC,CAAC,QAAQ,CAAa,UAAU,CAAC;QAClC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAEnB,sBAAsB;IACtB,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpD,UAAU;IACV,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;IAEjD,MAAM,KAAK,GAAgB;QACzB,KAAK;QACL,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;QAC/B,QAAQ;QACR,IAAI;KACL,CAAC;IACF,IAAI,OAAO;QAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAErC,4DAA4D;IAC5D,mEAAmE;IACnE,oEAAoE;IACpE,gEAAgE;IAChE,8DAA8D;IAC9D,gDAAgD;IAChD,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK,IAAI,cAAc,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/shared/paths.d.ts

@@ -1,22 +1,52 @@
 /**
  * Resolve the DKK package installation root.
  *
- * When running from source (`tsx src/cli.ts`) `import.meta.dirname`
- * points at `src/shared/`, so we go up two levels.  When running from
- * the compiled output (`dist/shared/`) we also go up two levels.
+ * Computed from `import.meta.url` via `fileURLToPath` instead of
+ * `import.meta.dirname` because the latter is undefined under tsx
+ * when this module is loaded transitively via `createRequire` (used
+ * by the loader's federation hydration). `fileURLToPath(import.meta.url)`
+ * works in all loading paths.
+ *
+ * Running from source (`tsx src/cli.ts`) → resolves to `src/shared`.
+ * Running from the compiled output (`dist/shared/`) → `dist/shared`.
+ * Both cases go up two levels to reach the package root.
  *
  * Used exclusively for locating package-bundled assets (schemas,
  * templates).
  */
 export declare function packageRoot(): string;
+/**
+ * Walk up the directory tree from `from`, returning the first ancestor
+ * that contains a `.dkk/` directory. Returns `null` when none is found.
+ *
+ * Capped at 64 iterations as a defensive measure against pathological
+ * filesystems; normal trees terminate at `/` well before that. The
+ * `from` path is resolved to an absolute path before searching.
+ *
+ * Exposed separately from {@link repoRoot} so other tools (e.g. a
+ * future `dkk doctor`) can reuse the search without inheriting
+ * `repoRoot`'s override/fallback semantics.
+ */
+export declare function findDkkRoot(from: string): string | null;
 /**
  * Resolve the project root (where `.dkk/` lives).
  *
- * Defaults to `process.cwd()` so that DKK works correctly whether it
- * is run from source, from a global install, or as a project dependency.
+ * Resolution order:
+ *   1. Explicit `override` (the `--root` CLI flag) — used verbatim,
+ *      no walk-up. This preserves the contract for callers that pass
+ *      an absolute root and expect it to be used as-is (including
+ *      pointing at a fresh directory that has no `.dkk/` yet).
+ *   2. Walk-up search via {@link findDkkRoot}: if `cwd/.dkk/` exists,
+ *      return `cwd`. Otherwise walk up the directory tree to the
+ *      first ancestor containing a `.dkk/`. This makes DKK usable
+ *      from any sub-directory of a service repo (including monorepos
+ *      where services live under `services/<name>/`).
+ *   3. Fallback: if no `.dkk/` is found on the walk-up path, return
+ *      `process.cwd()` (matches the historical behaviour, so that
+ *      scaffold commands which create `.dkk/` in cwd still work).
  *
- * Callers can override by passing an explicit root path (the `--root`
- * CLI flag).
+ * The walk-up can be disabled with `DKK_DISABLE_WALKUP=1` for callers
+ * who want the strict legacy behaviour.
  */
 export declare function repoRoot(override?: string): string;
 /** Absolute path to the `.dkk/domain/` directory. */
@@ -52,9 +82,31 @@ export declare function schemaDir(): string;
  * Used by `dkk init --skills` to copy skill files into a user's project.
  */
 export declare function packageSkillsDir(): string;
+/**
+ * Absolute path to the `tools/dkk/claude/` directory bundled inside the
+ * DKK package installation.
+ *
+ * Holds the Claude Code config template (`settings.json` + hook scripts)
+ * used by `dkk init --claude` to scaffold AI-assistant integration in
+ * a consumer's repo.
+ */
+export declare function packageClaudeDir(): string;
 /**
  * Turn an absolute path into a repo-relative POSIX path
  * (forward slashes, no leading `./`).
  */
 export declare function repoRelative(absPath: string, root?: string): string;
+/** Absolute path to `.dkk/service.yml` (service identity manifest). */
+export declare function serviceFile(root?: string): string;
+/** Absolute path to `.dkk/federation.yml` (peer manifest). */
+export declare function federationFile(root?: string): string;
+/** Absolute path to `.dkk/federation.lock.json` (pinned peer SHAs). */
+export declare function federationLockFile(root?: string): string;
+/** Absolute path to `.dkk/imports/` (gitignored peer cache root). */
+export declare function importsDir(root?: string): string;
+/**
+ * Absolute path to a single peer's cached repo root under `.dkk/imports/<service>/`.
+ * The peer's `.dkk/` lives at `<importedServiceDir>/.dkk/`.
+ */
+export declare function importedServiceDir(service: string, root?: string): string;
 //# sourceMappingURL=paths.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAeA;;;;;;;;;GASG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAUlD;AAED,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,oCAAoC;AACpC,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnE;AAID,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/shared/paths.js

@@ -11,34 +11,81 @@
  *    resolve from `import.meta.dirname` relative to the DKK package
  *    install.  Schemas and Handlebars templates ship with the package.
  */
-import { resolve, join, relative } from "node:path";
+import { resolve, join, relative, dirname } from "node:path";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 /**
  * Resolve the DKK package installation root.
  *
- * When running from source (`tsx src/cli.ts`) `import.meta.dirname`
- * points at `src/shared/`, so we go up two levels.  When running from
- * the compiled output (`dist/shared/`) we also go up two levels.
+ * Computed from `import.meta.url` via `fileURLToPath` instead of
+ * `import.meta.dirname` because the latter is undefined under tsx
+ * when this module is loaded transitively via `createRequire` (used
+ * by the loader's federation hydration). `fileURLToPath(import.meta.url)`
+ * works in all loading paths.
+ *
+ * Running from source (`tsx src/cli.ts`) → resolves to `src/shared`.
+ * Running from the compiled output (`dist/shared/`) → `dist/shared`.
+ * Both cases go up two levels to reach the package root.
  *
  * Used exclusively for locating package-bundled assets (schemas,
  * templates).
  */
 export function packageRoot() {
-    // import.meta.dirname is src/shared  or dist/shared
-    return resolve(import.meta.dirname, "../..");
+    return resolve(dirname(fileURLToPath(import.meta.url)), "../..");
+}
+/**
+ * Walk up the directory tree from `from`, returning the first ancestor
+ * that contains a `.dkk/` directory. Returns `null` when none is found.
+ *
+ * Capped at 64 iterations as a defensive measure against pathological
+ * filesystems; normal trees terminate at `/` well before that. The
+ * `from` path is resolved to an absolute path before searching.
+ *
+ * Exposed separately from {@link repoRoot} so other tools (e.g. a
+ * future `dkk doctor`) can reuse the search without inheriting
+ * `repoRoot`'s override/fallback semantics.
+ */
+export function findDkkRoot(from) {
+    let current = resolve(from);
+    for (let i = 0; i < 64; i++) {
+        if (existsSync(join(current, ".dkk"))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+    return null;
 }
 /**
  * Resolve the project root (where `.dkk/` lives).
  *
- * Defaults to `process.cwd()` so that DKK works correctly whether it
- * is run from source, from a global install, or as a project dependency.
+ * Resolution order:
+ *   1. Explicit `override` (the `--root` CLI flag) — used verbatim,
+ *      no walk-up. This preserves the contract for callers that pass
+ *      an absolute root and expect it to be used as-is (including
+ *      pointing at a fresh directory that has no `.dkk/` yet).
+ *   2. Walk-up search via {@link findDkkRoot}: if `cwd/.dkk/` exists,
+ *      return `cwd`. Otherwise walk up the directory tree to the
+ *      first ancestor containing a `.dkk/`. This makes DKK usable
+ *      from any sub-directory of a service repo (including monorepos
+ *      where services live under `services/<name>/`).
+ *   3. Fallback: if no `.dkk/` is found on the walk-up path, return
+ *      `process.cwd()` (matches the historical behaviour, so that
+ *      scaffold commands which create `.dkk/` in cwd still work).
  *
- * Callers can override by passing an explicit root path (the `--root`
- * CLI flag).
+ * The walk-up can be disabled with `DKK_DISABLE_WALKUP=1` for callers
+ * who want the strict legacy behaviour.
  */
 export function repoRoot(override) {
     if (override)
         return resolve(override);
-    return resolve(process.cwd());
+    const cwd = resolve(process.cwd());
+    if (process.env.DKK_DISABLE_WALKUP === "1") {
+        return cwd;
+    }
+    return findDkkRoot(cwd) ?? cwd;
 }
 /** Absolute path to the `.dkk/domain/` directory. */
 export function domainDir(root) {
@@ -91,6 +138,17 @@ export function schemaDir() {
 export function packageSkillsDir() {
     return join(packageRoot(), ".github", "skills");
 }
+/**
+ * Absolute path to the `tools/dkk/claude/` directory bundled inside the
+ * DKK package installation.
+ *
+ * Holds the Claude Code config template (`settings.json` + hook scripts)
+ * used by `dkk init --claude` to scaffold AI-assistant integration in
+ * a consumer's repo.
+ */
+export function packageClaudeDir() {
+    return join(packageRoot(), "tools", "dkk", "claude");
+}
 /**
  * Turn an absolute path into a repo-relative POSIX path
  * (forward slashes, no leading `./`).
@@ -98,4 +156,28 @@ export function packageSkillsDir() {
 export function repoRelative(absPath, root) {
     return relative(repoRoot(root), absPath).replace(/\\/g, "/");
 }
+// ── Federation paths ─────────────────────────────────────────────────
+/** Absolute path to `.dkk/service.yml` (service identity manifest). */
+export function serviceFile(root) {
+    return join(repoRoot(root), ".dkk", "service.yml");
+}
+/** Absolute path to `.dkk/federation.yml` (peer manifest). */
+export function federationFile(root) {
+    return join(repoRoot(root), ".dkk", "federation.yml");
+}
+/** Absolute path to `.dkk/federation.lock.json` (pinned peer SHAs). */
+export function federationLockFile(root) {
+    return join(repoRoot(root), ".dkk", "federation.lock.json");
+}
+/** Absolute path to `.dkk/imports/` (gitignored peer cache root). */
+export function importsDir(root) {
+    return join(repoRoot(root), ".dkk", "imports");
+}
+/**
+ * Absolute path to a single peer's cached repo root under `.dkk/imports/<service>/`.
+ * The peer's `.dkk/` lives at `<importedServiceDir>/.dkk/`.
+ */
+export function importedServiceDir(service, root) {
+    return join(importsDir(root), service);
+}
 //# sourceMappingURL=paths.js.map

package/dist/shared/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW;IACzB,oDAAoD;IACpD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAiB;IACxC,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAChD,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,MAAM,CAAC,IAAa;IAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,OAAO,CAAC,IAAa;IACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,IAAa;IACzD,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/shared/paths.ts"],"names":[],"mappings":"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"}

package/dist/shared/refs.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Reference parsing — single source of truth for DKK item-id grammar.
+ *
+ * IDs identify domain items, actors, ADRs, flows, and contexts. The
+ * grammar is additive: an optional `<service>:` prefix may be attached
+ * to any id to federate it across repos. Bare refs stay local-only.
+ *
+ * Forms:
+ *   <ctx>.<Name>             →  context-scoped item
+ *   actor.<Name>             →  actor
+ *   adr-NNNN                 →  ADR
+ *   flow.<Name>              →  cross-context flow
+ *   context.<name>           →  bounded context itself
+ *   <service>:<any of above> →  federated form
+ */
+/** Discriminated union over the five id shapes. */
+export type ParsedRef = {
+    kind: "item";
+    service?: string;
+    context: string;
+    name: string;
+} | {
+    kind: "adr";
+    service?: string;
+    id: string;
+} | {
+    kind: "actor";
+    service?: string;
+    name: string;
+} | {
+    kind: "flow";
+    service?: string;
+    name: string;
+} | {
+    kind: "context";
+    service?: string;
+    name: string;
+};
+/**
+ * Parse a ref string into its structured form. Returns `null` for
+ * inputs that do not match any of the five shapes.
+ *
+ * @example
+ * parseRef("ordering.OrderPlaced")
+ * // → { kind: "item", context: "ordering", name: "OrderPlaced" }
+ *
+ * parseRef("payments:billing.PaymentCaptured")
+ * // → { kind: "item", service: "payments", context: "billing", name: "PaymentCaptured" }
+ *
+ * parseRef("adr-0001")
+ * // → { kind: "adr", id: "adr-0001" }
+ *
+ * parseRef("ordering:adr-0007")
+ * // → { kind: "adr", service: "ordering", id: "adr-0007" }
+ */
+export declare function parseRef(s: string): ParsedRef | null;
+/**
+ * Result of qualifying a name-only or partial ref into its canonical
+ * graph/index id form. Used by the indexer and graph builders to
+ * produce service-prefixed ids consistently.
+ */
+export interface QualifiedRef {
+    /** Canonical id (e.g. `ordering.OrderPlaced` or `payments:billing.PaymentCaptured`). */
+    id: string;
+    /** Bounded-context name, when the ref names a context-scoped item. */
+    context?: string;
+    /** Item / actor / flow / context name as written. */
+    name: string;
+    /** True when the ref points at a service different from the walk prefix. */
+    isForeign: boolean;
+}
+/**
+ * Qualify a bare-or-federated item ref into a canonical id form.
+ *
+ * Three input shapes are handled:
+ *  - Author-qualified federated form (`<svc>:<ctx>.<Name>`) → kept as-is,
+ *    marked foreign whenever it differs from `walkPrefix`.
+ *  - Author-qualified context form (`<ctx>.<Name>`, no service) →
+ *    gets `walkPrefix` applied so peer walks namespace it correctly.
+ *  - Bare PascalCase name (`Name`) → resolved as a name in
+ *    `currentContext`, then prefixed with `walkPrefix`.
+ *
+ * `walkPrefix` is `""` for local walks and `"<peerName>:"` for peer
+ * walks. The function leaves any already-prefixed ref untouched so
+ * a peer's own author-written federated refs survive the prefix pass.
+ */
+export declare function qualifyItemRef(raw: string, walkPrefix: string, currentContext: string): QualifiedRef;
+/**
+ * Qualify a bare-or-federated actor ref. Actor ids use the
+ * `actor.<Name>` form (no context). Federated form is
+ * `<service>:actor.<Name>`. Bare YAML form is just `<Name>`.
+ */
+export declare function qualifyActorRef(raw: string, walkPrefix: string): QualifiedRef;
+/** Serialize a {@link ParsedRef} back into its canonical string form. */
+export declare function formatRef(r: ParsedRef): string;
+//# sourceMappingURL=refs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/shared/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,mDAAmD;AACnD,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgDpD;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,YAAY,CAqCd;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAuB7E;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAc9C"}

package/dist/shared/refs.js

@@ -0,0 +1,182 @@
+/**
+ * Reference parsing — single source of truth for DKK item-id grammar.
+ *
+ * IDs identify domain items, actors, ADRs, flows, and contexts. The
+ * grammar is additive: an optional `<service>:` prefix may be attached
+ * to any id to federate it across repos. Bare refs stay local-only.
+ *
+ * Forms:
+ *   <ctx>.<Name>             →  context-scoped item
+ *   actor.<Name>             →  actor
+ *   adr-NNNN                 →  ADR
+ *   flow.<Name>              →  cross-context flow
+ *   context.<name>           →  bounded context itself
+ *   <service>:<any of above> →  federated form
+ */
+/** Kebab-case service / context identifier. */
+const KEBAB = /^[a-z][a-z0-9-]*$/;
+/** PascalCase item name (events, commands, etc.). */
+const PASCAL = /^[A-Za-z][A-Za-z0-9]*$/;
+/** ADR id pattern (`adr-NNNN`). */
+const ADR_ID = /^adr-\d{4}$/;
+/**
+ * Parse a ref string into its structured form. Returns `null` for
+ * inputs that do not match any of the five shapes.
+ *
+ * @example
+ * parseRef("ordering.OrderPlaced")
+ * // → { kind: "item", context: "ordering", name: "OrderPlaced" }
+ *
+ * parseRef("payments:billing.PaymentCaptured")
+ * // → { kind: "item", service: "payments", context: "billing", name: "PaymentCaptured" }
+ *
+ * parseRef("adr-0001")
+ * // → { kind: "adr", id: "adr-0001" }
+ *
+ * parseRef("ordering:adr-0007")
+ * // → { kind: "adr", service: "ordering", id: "adr-0007" }
+ */
+export function parseRef(s) {
+    if (typeof s !== "string" || s.length === 0)
+        return null;
+    // Peel off optional service prefix.
+    let service;
+    let body = s;
+    const colon = s.indexOf(":");
+    if (colon > 0) {
+        const svc = s.slice(0, colon);
+        if (!KEBAB.test(svc))
+            return null;
+        service = svc;
+        body = s.slice(colon + 1);
+        if (body.length === 0)
+            return null;
+    }
+    // ADR: "adr-NNNN"
+    if (ADR_ID.test(body)) {
+        return { kind: "adr", service, id: body };
+    }
+    // Special-prefix forms: "actor.X", "flow.X", "context.X"
+    if (body.startsWith("actor.")) {
+        const name = body.slice("actor.".length);
+        if (!PASCAL.test(name))
+            return null;
+        return { kind: "actor", service, name };
+    }
+    if (body.startsWith("flow.")) {
+        const name = body.slice("flow.".length);
+        if (name.length === 0)
+            return null;
+        return { kind: "flow", service, name };
+    }
+    if (body.startsWith("context.")) {
+        const name = body.slice("context.".length);
+        if (!KEBAB.test(name))
+            return null;
+        return { kind: "context", service, name };
+    }
+    // Generic context-scoped item: "<ctx>.<Name>"
+    const dot = body.indexOf(".");
+    if (dot > 0) {
+        const ctx = body.slice(0, dot);
+        const name = body.slice(dot + 1);
+        if (KEBAB.test(ctx) && PASCAL.test(name)) {
+            return { kind: "item", service, context: ctx, name };
+        }
+    }
+    return null;
+}
+/**
+ * Qualify a bare-or-federated item ref into a canonical id form.
+ *
+ * Three input shapes are handled:
+ *  - Author-qualified federated form (`<svc>:<ctx>.<Name>`) → kept as-is,
+ *    marked foreign whenever it differs from `walkPrefix`.
+ *  - Author-qualified context form (`<ctx>.<Name>`, no service) →
+ *    gets `walkPrefix` applied so peer walks namespace it correctly.
+ *  - Bare PascalCase name (`Name`) → resolved as a name in
+ *    `currentContext`, then prefixed with `walkPrefix`.
+ *
+ * `walkPrefix` is `""` for local walks and `"<peerName>:"` for peer
+ * walks. The function leaves any already-prefixed ref untouched so
+ * a peer's own author-written federated refs survive the prefix pass.
+ */
+export function qualifyItemRef(raw, walkPrefix, currentContext) {
+    const parsed = parseRef(raw);
+    if (parsed?.kind === "item" && parsed.service) {
+        // Author-qualified federated form: `<svc>:<ctx>.<Name>`.
+        return {
+            id: `${parsed.service}:${parsed.context}.${parsed.name}`,
+            context: parsed.context,
+            name: parsed.name,
+            isForeign: walkPrefix !== `${parsed.service}:`,
+        };
+    }
+    if (parsed?.kind === "item") {
+        // Author-qualified context form (`<ctx>.<Name>`, no service).
+        return {
+            id: `${walkPrefix}${parsed.context}.${parsed.name}`,
+            context: parsed.context,
+            name: parsed.name,
+            isForeign: false,
+        };
+    }
+    // Bare name fallback (`OrderPlaced` in YAML inter-item refs such as
+    // raised_by, handles.commands, when.events, …).
+    if (raw.includes(":")) {
+        // Author wrote a colon but it didn't parse as `<svc>:<ctx>.<Name>`.
+        // Leave as-is so the caller can surface a clear "malformed" error
+        // elsewhere; treat as foreign so the prefix isn't applied.
+        return { id: raw, name: raw, isForeign: true };
+    }
+    return {
+        id: `${walkPrefix}${currentContext}.${raw}`,
+        context: currentContext,
+        name: raw,
+        isForeign: false,
+    };
+}
+/**
+ * Qualify a bare-or-federated actor ref. Actor ids use the
+ * `actor.<Name>` form (no context). Federated form is
+ * `<service>:actor.<Name>`. Bare YAML form is just `<Name>`.
+ */
+export function qualifyActorRef(raw, walkPrefix) {
+    const parsed = parseRef(raw);
+    if (parsed?.kind === "actor" && parsed.service) {
+        return {
+            id: `${parsed.service}:actor.${parsed.name}`,
+            name: parsed.name,
+            isForeign: walkPrefix !== `${parsed.service}:`,
+        };
+    }
+    if (parsed?.kind === "actor") {
+        return {
+            id: `${walkPrefix}actor.${parsed.name}`,
+            name: parsed.name,
+            isForeign: false,
+        };
+    }
+    // Bare PascalCase actor name (the dominant case in YAML).
+    if (raw.includes(":")) {
+        return { id: raw, name: raw, isForeign: true };
+    }
+    return { id: `${walkPrefix}actor.${raw}`, name: raw, isForeign: false };
+}
+/** Serialize a {@link ParsedRef} back into its canonical string form. */
+export function formatRef(r) {
+    const prefix = r.service ? `${r.service}:` : "";
+    switch (r.kind) {
+        case "item":
+            return `${prefix}${r.context}.${r.name}`;
+        case "adr":
+            return `${prefix}${r.id}`;
+        case "actor":
+            return `${prefix}actor.${r.name}`;
+        case "flow":
+            return `${prefix}flow.${r.name}`;
+        case "context":
+            return `${prefix}context.${r.name}`;
+    }
+}
+//# sourceMappingURL=refs.js.map

package/dist/shared/refs.js.map

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

package/dist/shared/service-id.d.ts

@@ -0,0 +1,11 @@
+import type { ServiceManifest } from "./types/federation.js";
+/**
+ * Load `.dkk/service.yml` from the given root (or auto-detected root).
+ * Returns the parsed manifest, or `null` if the file does not exist.
+ *
+ * Throws when the file exists but does not conform to
+ * `service.schema.json` — the message includes Ajv's error list so
+ * the user can fix the manifest directly.
+ */
+export declare function loadServiceId(root?: string): ServiceManifest | null;
+//# sourceMappingURL=service-id.d.ts.map

package/dist/shared/service-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-id.d.ts","sourceRoot":"","sources":["../../src/shared/service-id.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA0B7D;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAkBnE"}