domain-knowledge-kit 0.2.11 → 0.2.13

package/dist/features/adr/commands/adr-related.js

@@ -1,147 +0,0 @@
-import { loadDomainModel } from "../../../shared/loader.js";
-import { forEachItem, itemAdrRefs } from "../../../shared/item-visitor.js";
-/** Collect domain item IDs that reference a specific ADR. */
-function domainItemsReferencingAdr(model, adrId) {
-    const refs = [];
-    // Actors
-    for (const actor of model.actors) {
-        if (actor.adr_refs?.includes(adrId)) {
-            refs.push(`actor.${actor.name}`);
-        }
-    }
-    // Context items — use shared item visitor
-    for (const [ctxName, ctx] of model.contexts) {
-        forEachItem(ctx, (_type, name, item) => {
-            if (itemAdrRefs(item)?.includes(adrId)) {
-                refs.push(`${ctxName}.${name}`);
-            }
-        });
-    }
-    return refs.sort();
-}
-/** Collect ADR IDs that reference a specific domain item via domain_refs. */
-function adrsReferencingItem(model, itemId) {
-    const refs = [];
-    for (const [adrId, adr] of model.adrs) {
-        if (adr.domain_refs?.includes(itemId)) {
-            refs.push(adrId);
-        }
-    }
-    return refs.sort();
-}
-/** Collect ADR IDs listed in a domain item's own adr_refs field. */
-function ownAdrRefs(model, itemId) {
-    // Actor
-    if (itemId.startsWith("actor.")) {
-        const name = itemId.slice("actor.".length);
-        const actor = model.actors.find((a) => a.name === name);
-        return (actor?.adr_refs ?? []);
-    }
-    // Context-scoped item — use shared item visitor
-    const dotIdx = itemId.indexOf(".");
-    if (dotIdx > 0) {
-        const ctxName = itemId.slice(0, dotIdx);
-        const itemNameStr = itemId.slice(dotIdx + 1);
-        const ctx = model.contexts.get(ctxName);
-        if (!ctx)
-            return [];
-        let result = [];
-        forEachItem(ctx, (_type, name, item) => {
-            if (name === itemNameStr) {
-                result = (itemAdrRefs(item) ?? []);
-            }
-        });
-        return result;
-    }
-    return [];
-}
-/** Register the `adr related` subcommand on an `adr` parent command. */
-export function registerAdrRelated(adrCmd) {
-    adrCmd
-        .command("related <id>")
-        .description("Show bidirectional domain-ADR links for an ADR or domain item")
-        .option("--json", "Output as JSON")
-        .option("--minify", "Minify JSON output (useful for AI agents)")
-        .option("-r, --root <path>", "Override repository root")
-        .action((id, opts) => {
-        const model = loadDomainModel({ root: opts.root });
-        const isAdr = id.startsWith("adr-");
-        if (isAdr) {
-            // ADR → domain items
-            if (!model.adrs.has(id)) {
-                if (opts.json) {
-                    console.log(JSON.stringify({ error: `ADR "${id}" not found` }, null, opts.minify ? 0 : 2));
-                }
-                else {
-                    console.error(`Error: ADR "${id}" not found.`);
-                }
-                process.exit(1);
-            }
-            const adr = model.adrs.get(id);
-            const domainRefs = (adr.domain_refs ?? []);
-            const itemsReferencing = domainItemsReferencingAdr(model, id);
-            if (opts.json) {
-                console.log(JSON.stringify({
-                    id,
-                    title: adr.title,
-                    domainRefs,
-                    referencedBy: itemsReferencing,
-                }, null, opts.minify ? 0 : 2));
-                return;
-            }
-            console.log(`\n# Related items for ${id} (${adr.title})\n`);
-            if (domainRefs.length > 0) {
-                console.log("  ADR → Domain (domain_refs from ADR frontmatter):");
-                for (const ref of domainRefs) {
-                    console.log(`    - ${ref}`);
-                }
-            }
-            if (itemsReferencing.length > 0) {
-                console.log("  Domain → ADR (items with adr_refs pointing here):");
-                for (const ref of itemsReferencing) {
-                    console.log(`    - ${ref}`);
-                }
-            }
-            if (domainRefs.length === 0 && itemsReferencing.length === 0) {
-                console.log("  No related items found.");
-            }
-        }
-        else {
-            // Domain item → ADRs
-            const own = ownAdrRefs(model, id);
-            const referencing = adrsReferencingItem(model, id);
-            const allAdrs = [...new Set([...own, ...referencing])].sort();
-            if (opts.json) {
-                console.log(JSON.stringify({
-                    id,
-                    ownAdrRefs: own,
-                    referencedByAdrs: referencing,
-                    allAdrs,
-                }, null, opts.minify ? 0 : 2));
-                return;
-            }
-            console.log(`\n# Related ADRs for ${id}\n`);
-            if (own.length > 0) {
-                console.log("  Item → ADR (adr_refs declared on this item):");
-                for (const ref of own) {
-                    const adr = model.adrs.get(ref);
-                    const title = adr ? ` — ${adr.title}` : "";
-                    console.log(`    - ${ref}${title}`);
-                }
-            }
-            if (referencing.length > 0) {
-                console.log("  ADR → Item (ADRs with domain_refs pointing here):");
-                for (const ref of referencing) {
-                    const adr = model.adrs.get(ref);
-                    const title = adr ? ` — ${adr.title}` : "";
-                    console.log(`    - ${ref}${title}`);
-                }
-            }
-            if (allAdrs.length === 0) {
-                console.log("  No related ADRs found.");
-            }
-        }
-        console.log();
-    });
-}
-//# sourceMappingURL=adr-related.js.map

package/dist/features/adr/commands/adr-related.js.map

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

package/dist/features/adr/commands/adr-show.d.ts

@@ -1,10 +0,0 @@
-/**
- * `domain adr show <id>` command — print an ADR's frontmatter.
- *
- * Looks up an ADR by its id (e.g. "adr-0001") and prints
- * its frontmatter metadata as YAML, plus location on disk.
- */
-import type { Command as Cmd } from "commander";
-/** Register the `adr show` subcommand on an `adr` parent command. */
-export declare function registerAdrShow(adrCmd: Cmd): void;
-//# sourceMappingURL=adr-show.d.ts.map

package/dist/features/adr/commands/adr-show.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adr-show.d.ts","sourceRoot":"","sources":["../../../../src/features/adr/commands/adr-show.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAIhD,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CA4BjD"}

package/dist/features/adr/commands/adr-show.js

@@ -1,31 +0,0 @@
-import { loadDomainModel } from "../../../shared/loader.js";
-import { stringifyYaml } from "../../../shared/yaml.js";
-/** Register the `adr show` subcommand on an `adr` parent command. */
-export function registerAdrShow(adrCmd) {
-    adrCmd
-        .command("show <id>")
-        .description("Show ADR frontmatter by ID (e.g. adr-0001)")
-        .option("--json", "Output as JSON")
-        .option("--minify", "Minify JSON output (useful for AI agents)")
-        .option("-r, --root <path>", "Override repository root")
-        .action((id, opts) => {
-        const model = loadDomainModel({ root: opts.root });
-        const adr = model.adrs.get(id);
-        if (!adr) {
-            if (opts.json) {
-                console.log(JSON.stringify({ error: `ADR "${id}" not found` }, null, opts.minify ? 0 : 2));
-            }
-            else {
-                console.error(`Error: ADR "${id}" not found.`);
-            }
-            process.exit(1);
-        }
-        if (opts.json) {
-            console.log(JSON.stringify(adr, null, opts.minify ? 0 : 2));
-            return;
-        }
-        console.log(`\n# ${adr.title} (${adr.id})\n`);
-        console.log(stringifyYaml(adr));
-    });
-}
-//# sourceMappingURL=adr-show.js.map

package/dist/features/adr/commands/adr-show.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adr-show.js","sourceRoot":"","sources":["../../../../src/features/adr/commands/adr-show.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,MAAW;IACzC,MAAM;SACH,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,UAAU,EAAE,2CAA2C,CAAC;SAC/D,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;SACvD,MAAM,CAAC,CAAC,EAAU,EAAE,IAAyD,EAAE,EAAE;QAChF,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAE/B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7F,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/features/scaffold/wiring.d.ts

@@ -1,29 +0,0 @@
-export interface WireNewItemOpts {
-    type: string;
-    name: string;
-    context: string;
-    raisedBy?: string;
-    handledBy?: string;
-    handles?: string[];
-    emits?: string[];
-    root?: string;
-}
-export interface WireResult {
-    wired: string[];
-    skipped: string[];
-}
-/**
- * Wire bidirectional relationships after creating a new domain item.
- *
- * Covered relationship pairs:
- *   - event.raised_by   ↔  aggregate.emits.events
- *   - command.handled_by ↔  aggregate.handles.commands
- */
-export declare function wireNewItem(opts: WireNewItemOpts): WireResult;
-/**
- * Wire ADR refs: after creating an ADR, add the ADR id to each referenced
- * domain item's `adr_refs` array. `domainRefs` entries must be in the
- * "context.ItemName" format (e.g. "ordering.OrderPlaced").
- */
-export declare function wireAdrRefs(adrId: string, domainRefs: string[], root?: string): WireResult;
-//# sourceMappingURL=wiring.d.ts.map

package/dist/features/scaffold/wiring.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wiring.d.ts","sourceRoot":"","sources":["../../../src/features/scaffold/wiring.ts"],"names":[],"mappings":"AAyEA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CAmE7D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,UAAU,CAqCZ"}

package/dist/features/scaffold/wiring.js

@@ -1,180 +0,0 @@
-/**
- * Bidirectional relationship wiring for domain item scaffolding.
- *
- * After creating a new item or ADR, these helpers mutate the referenced
- * counterpart YAML files so that relationships stay consistent in both
- * directions. All operations are idempotent — they will never insert a
- * duplicate entry, and they are a no-op when the target file does not
- * exist (a skip is recorded in the result instead).
- */
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { parseYaml, stringifyYaml } from "../../shared/yaml.js";
-import { contextsDir } from "../../shared/paths.js";
-// ── Internals ─────────────────────────────────────────────────────────
-const TYPE_DIR_MAP = {
-    event: "events",
-    command: "commands",
-    aggregate: "aggregates",
-    policy: "policies",
-    "read-model": "read-models",
-};
-function readYamlObj(filePath) {
-    if (!existsSync(filePath))
-        return null;
-    return parseYaml(readFileSync(filePath, "utf-8"));
-}
-function writeYamlObj(filePath, obj) {
-    writeFileSync(filePath, stringifyYaml(obj), "utf-8");
-}
-/** Add `value` to `obj[outerKey][innerKey]` (string array), idempotently. Returns true if modified. */
-function addToNestedArray(obj, outerKey, innerKey, value) {
-    if (!obj[outerKey] || typeof obj[outerKey] !== "object" || Array.isArray(obj[outerKey])) {
-        obj[outerKey] = {};
-    }
-    const outer = obj[outerKey];
-    if (!Array.isArray(outer[innerKey])) {
-        outer[innerKey] = [];
-    }
-    const arr = outer[innerKey];
-    if (arr.includes(value))
-        return false;
-    arr.push(value);
-    return true;
-}
-/** Add `value` to `obj[key]` (string array), idempotently. Returns true if modified. */
-function addToArray(obj, key, value) {
-    if (!Array.isArray(obj[key])) {
-        obj[key] = [];
-    }
-    const arr = obj[key];
-    if (arr.includes(value))
-        return false;
-    arr.push(value);
-    return true;
-}
-/** Set `obj[key] = value` only if the key is not already present. Returns true if modified. */
-function setIfAbsent(obj, key, value) {
-    if (obj[key] !== undefined)
-        return false;
-    obj[key] = value;
-    return true;
-}
-/**
- * Wire bidirectional relationships after creating a new domain item.
- *
- * Covered relationship pairs:
- *   - event.raised_by   ↔  aggregate.emits.events
- *   - command.handled_by ↔  aggregate.handles.commands
- */
-export function wireNewItem(opts) {
-    const result = { wired: [], skipped: [] };
-    const ctxDir = join(contextsDir(opts.root), opts.context);
-    if (opts.type === "event" && opts.raisedBy) {
-        const aggPath = join(ctxDir, "aggregates", `${opts.raisedBy}.yml`);
-        const agg = readYamlObj(aggPath);
-        if (agg) {
-            if (addToNestedArray(agg, "emits", "events", opts.name)) {
-                writeYamlObj(aggPath, agg);
-                result.wired.push(`${opts.raisedBy}.emits.events ← ${opts.name}`);
-            }
-            else {
-                result.skipped.push(`${opts.raisedBy}.emits.events already contains ${opts.name}`);
-            }
-        }
-        else {
-            result.skipped.push(`aggregate ${opts.raisedBy} not found — skipping emits wiring`);
-        }
-    }
-    if (opts.type === "command" && opts.handledBy) {
-        const aggPath = join(ctxDir, "aggregates", `${opts.handledBy}.yml`);
-        const agg = readYamlObj(aggPath);
-        if (agg) {
-            if (addToNestedArray(agg, "handles", "commands", opts.name)) {
-                writeYamlObj(aggPath, agg);
-                result.wired.push(`${opts.handledBy}.handles.commands ← ${opts.name}`);
-            }
-            else {
-                result.skipped.push(`${opts.handledBy}.handles.commands already contains ${opts.name}`);
-            }
-        }
-        else {
-            result.skipped.push(`aggregate ${opts.handledBy} not found — skipping handles wiring`);
-        }
-    }
-    if (opts.type === "aggregate") {
-        for (const eventName of opts.emits ?? []) {
-            const evtPath = join(ctxDir, "events", `${eventName}.yml`);
-            const evt = readYamlObj(evtPath);
-            if (evt) {
-                if (setIfAbsent(evt, "raised_by", opts.name)) {
-                    writeYamlObj(evtPath, evt);
-                    result.wired.push(`${eventName}.raised_by ← ${opts.name}`);
-                }
-                else {
-                    result.skipped.push(`${eventName}.raised_by already set to "${evt.raised_by}"`);
-                }
-            }
-            else {
-                result.skipped.push(`event ${eventName} not found — skipping raised_by wiring`);
-            }
-        }
-        for (const cmdName of opts.handles ?? []) {
-            const cmdPath = join(ctxDir, "commands", `${cmdName}.yml`);
-            const cmd = readYamlObj(cmdPath);
-            if (cmd) {
-                if (setIfAbsent(cmd, "handled_by", opts.name)) {
-                    writeYamlObj(cmdPath, cmd);
-                    result.wired.push(`${cmdName}.handled_by ← ${opts.name}`);
-                }
-                else {
-                    result.skipped.push(`${cmdName}.handled_by already set to "${cmd.handled_by}"`);
-                }
-            }
-            else {
-                result.skipped.push(`command ${cmdName} not found — skipping handled_by wiring`);
-            }
-        }
-    }
-    return result;
-}
-/**
- * Wire ADR refs: after creating an ADR, add the ADR id to each referenced
- * domain item's `adr_refs` array. `domainRefs` entries must be in the
- * "context.ItemName" format (e.g. "ordering.OrderPlaced").
- */
-export function wireAdrRefs(adrId, domainRefs, root) {
-    const result = { wired: [], skipped: [] };
-    const ctxBase = contextsDir(root);
-    for (const ref of domainRefs) {
-        const dotIdx = ref.indexOf(".");
-        if (dotIdx < 0) {
-            result.skipped.push(`invalid domain ref "${ref}" — expected context.Name format`);
-            continue;
-        }
-        const ctx = ref.slice(0, dotIdx);
-        const itemName = ref.slice(dotIdx + 1);
-        const ctxDir = join(ctxBase, ctx);
-        let found = false;
-        for (const dir of Object.values(TYPE_DIR_MAP)) {
-            const itemPath = join(ctxDir, dir, `${itemName}.yml`);
-            const item = readYamlObj(itemPath);
-            if (item) {
-                if (addToArray(item, "adr_refs", adrId)) {
-                    writeYamlObj(itemPath, item);
-                    result.wired.push(`${ref}.adr_refs ← ${adrId}`);
-                }
-                else {
-                    result.skipped.push(`${ref}.adr_refs already contains ${adrId}`);
-                }
-                found = true;
-                break;
-            }
-        }
-        if (!found) {
-            result.skipped.push(`domain item "${ref}" not found — skipping adr_refs wiring`);
-        }
-    }
-    return result;
-}
-//# sourceMappingURL=wiring.js.map

package/dist/features/scaffold/wiring.js.map

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