domain-knowledge-kit 0.1.0

package/dist/shared/tests/loader.test.js

@@ -0,0 +1,239 @@
+/**
+ * Tests for the domain model loader and supporting utilities.
+ *
+ * Uses a temporary directory tree that mirrors the real layout:
+ *   tmp/
+ *     domain/
+ *       index.yml
+ *       actors.yml
+ *       contexts/
+ *         ordering.yml          (flat context)
+ *         shipping/
+ *           context.yml         (directory context)
+ *     docs/
+ *       adr/
+ *         0001-use-yaml.md
+ */
+import { mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { loadDomainModel } from "../loader.js";
+import { parseAdrFrontmatter } from "../adr-parser.js";
+import { parseYaml, stringifyYaml } from "../yaml.js";
+// ── Test scaffolding fixtures ─────────────────────────────────────────
+const TMP = join(tmpdir(), `dkk-test-${Date.now()}`);
+const DOMAIN = join(TMP, "domain");
+const CONTEXTS = join(DOMAIN, "contexts");
+const ADR_DIR = join(TMP, "docs", "adr");
+function setup() {
+    // Create directory tree (per-item structure)
+    mkdirSync(join(CONTEXTS, "ordering", "events"), { recursive: true });
+    mkdirSync(join(CONTEXTS, "ordering", "commands"), { recursive: true });
+    mkdirSync(join(CONTEXTS, "ordering", "aggregates"), { recursive: true });
+    mkdirSync(join(CONTEXTS, "shipping", "commands"), { recursive: true });
+    mkdirSync(join(CONTEXTS, "shipping", "read-models"), { recursive: true });
+    mkdirSync(ADR_DIR, { recursive: true });
+    // domain/index.yml
+    writeFileSync(join(DOMAIN, "index.yml"), [
+        "contexts:",
+        "  - name: ordering",
+        '    description: "Order management"',
+        "  - name: shipping",
+        '    description: "Shipping logistics"',
+        "flows:",
+        "  - name: PlaceAndShip",
+        '    description: "Order to shipment"',
+        "    steps:",
+        "      - ref: ordering.PlaceOrder",
+        "        type: command",
+        "      - ref: ordering.OrderPlaced",
+        "        type: event",
+        "      - ref: shipping.ShipOrder",
+        "        type: command",
+    ].join("\n"));
+    // domain/actors.yml
+    writeFileSync(join(DOMAIN, "actors.yml"), [
+        "actors:",
+        "  - name: Customer",
+        "    type: human",
+        '    description: "A paying customer"',
+        "  - name: WarehouseBot",
+        "    type: system",
+        '    description: "Automated warehouse robot"',
+    ].join("\n"));
+    // domain/contexts/ordering/context.yml — identity + glossary
+    writeFileSync(join(CONTEXTS, "ordering", "context.yml"), [
+        "name: ordering",
+        'description: "Handles the order lifecycle"',
+        "glossary:",
+        "  - term: Order",
+        '    definition: "A customer purchase request"',
+    ].join("\n"));
+    // domain/contexts/ordering/events/OrderPlaced.yml
+    writeFileSync(join(CONTEXTS, "ordering", "events", "OrderPlaced.yml"), [
+        "name: OrderPlaced",
+        'description: "Raised when an order is placed"',
+        "fields:",
+        "  - name: orderId",
+        "    type: UUID",
+        "raised_by: Order",
+    ].join("\n"));
+    // domain/contexts/ordering/commands/PlaceOrder.yml
+    writeFileSync(join(CONTEXTS, "ordering", "commands", "PlaceOrder.yml"), [
+        "name: PlaceOrder",
+        'description: "Submit a new order"',
+        "actor: Customer",
+        "handled_by: Order",
+    ].join("\n"));
+    // domain/contexts/ordering/aggregates/Order.yml
+    writeFileSync(join(CONTEXTS, "ordering", "aggregates", "Order.yml"), [
+        "name: Order",
+        'description: "Order aggregate root"',
+        "handles:",
+        "  commands:",
+        "    - PlaceOrder",
+        "emits:",
+        "  events:",
+        "    - OrderPlaced",
+    ].join("\n"));
+    // domain/contexts/shipping/context.yml — identity only
+    writeFileSync(join(CONTEXTS, "shipping", "context.yml"), [
+        "name: shipping",
+        'description: "Handles shipment tracking"',
+    ].join("\n"));
+    // domain/contexts/shipping/commands/ShipOrder.yml
+    writeFileSync(join(CONTEXTS, "shipping", "commands", "ShipOrder.yml"), [
+        "name: ShipOrder",
+        'description: "Initiate shipment for an order"',
+        "handled_by: Shipment",
+    ].join("\n"));
+    // domain/contexts/shipping/read-models/ShipmentStatus.yml
+    writeFileSync(join(CONTEXTS, "shipping", "read-models", "ShipmentStatus.yml"), [
+        "name: ShipmentStatus",
+        'description: "Current status of a shipment"',
+        "subscribes_to:",
+        "  - ShipmentDispatched",
+        "used_by:",
+        "  - Customer",
+    ].join("\n"));
+    // docs/adr/0001-use-yaml.md
+    writeFileSync(join(ADR_DIR, "0001-use-yaml.md"), [
+        "---",
+        "id: adr-0001",
+        "title: Use YAML for domain models",
+        "status: accepted",
+        "date: 2026-01-15",
+        "deciders:",
+        "  - Alice",
+        "  - Bob",
+        "domain_refs:",
+        "  - ordering.Order",
+        "---",
+        "",
+        "# ADR-0001 — Use YAML for domain models",
+        "",
+        "## Context",
+        "We need a format...",
+    ].join("\n"));
+    // docs/adr/README.md — should be skipped
+    writeFileSync(join(ADR_DIR, "README.md"), "# ADRs\n");
+}
+function teardown() {
+    rmSync(TMP, { recursive: true, force: true });
+}
+// ── Assertions ────────────────────────────────────────────────────────
+let passed = 0;
+let failed = 0;
+function assert(label, condition, detail) {
+    if (condition) {
+        console.log(`  OK: ${label}`);
+        passed++;
+    }
+    else {
+        console.error(`FAIL: ${label}${detail ? ` — ${detail}` : ""}`);
+        failed++;
+    }
+}
+// ── Run tests ─────────────────────────────────────────────────────────
+setup();
+try {
+    // yaml.ts
+    console.log("\n=== yaml.ts ===");
+    const parsed = parseYaml("key: value\n");
+    assert("parseYaml parses scalar", parsed.key === "value");
+    const dumped = stringifyYaml({ a: 1, b: [2, 3] });
+    assert("stringifyYaml returns string", typeof dumped === "string" && dumped.includes("a: 1"));
+    // adr-parser.ts
+    console.log("\n=== adr-parser.ts ===");
+    const adr = parseAdrFrontmatter("---\nid: adr-0042\ntitle: Test\nstatus: proposed\ndate: 2026-02-20\n---\n# Hello\n");
+    assert("parseAdrFrontmatter returns record", adr !== null);
+    assert("parseAdrFrontmatter id correct", adr?.id === "adr-0042");
+    assert("parseAdrFrontmatter status correct", adr?.status === "proposed");
+    assert("parseAdrFrontmatter extracts body", adr?.body === "Hello");
+    const adrWithBody = parseAdrFrontmatter("---\nid: adr-0099\ntitle: Rich\nstatus: accepted\ndate: 2026-03-01\n---\n\n## Context\n\nWe need a [search engine](https://example.com) for **full-text** queries.\n\n## Decision\n\nUse `SQLite FTS5` for indexing.\n");
+    assert("parseAdrFrontmatter with rich body returns record", adrWithBody !== null);
+    assert("body strips markdown formatting", adrWithBody?.body !== undefined &&
+        adrWithBody.body.includes("search engine") &&
+        adrWithBody.body.includes("full-text") &&
+        adrWithBody.body.includes("SQLite FTS5") &&
+        !adrWithBody.body.includes("##") &&
+        !adrWithBody.body.includes("**") &&
+        !adrWithBody.body.includes("`"));
+    const adrNoBody = parseAdrFrontmatter("---\nid: adr-0050\ntitle: Empty\nstatus: proposed\ndate: 2026-02-20\n---\n");
+    assert("parseAdrFrontmatter with no body has undefined body", adrNoBody?.body === undefined);
+    const noFront = parseAdrFrontmatter("# No frontmatter here\n");
+    assert("parseAdrFrontmatter returns null for missing frontmatter", noFront === null);
+    const incompleteFront = parseAdrFrontmatter("---\nid: adr-0042\n---\n");
+    assert("parseAdrFrontmatter returns null for incomplete frontmatter", incompleteFront === null);
+    // loader.ts
+    console.log("\n=== loader.ts ===");
+    const model = loadDomainModel({ root: TMP });
+    // Index
+    assert("index.contexts has 2 entries", model.index.contexts.length === 2);
+    assert("index.flows has 1 entry", model.index.flows?.length === 1);
+    assert("flow has 3 steps", model.index.flows?.[0].steps.length === 3);
+    // Actors
+    assert("actors has 2 entries", model.actors.length === 2);
+    assert("first actor is Customer", model.actors[0].name === "Customer");
+    // Contexts
+    assert("contexts map has 2 entries", model.contexts.size === 2);
+    const ordering = model.contexts.get("ordering");
+    assert("ordering context loaded", ordering !== undefined);
+    assert("ordering has 1 event", ordering?.events?.length === 1);
+    assert("ordering event name", ordering?.events?.[0].name === "OrderPlaced");
+    assert("ordering has 1 command", ordering?.commands?.length === 1);
+    assert("ordering has 1 aggregate", ordering?.aggregates?.length === 1);
+    assert("ordering has 1 glossary entry", ordering?.glossary?.length === 1);
+    const shipping = model.contexts.get("shipping");
+    assert("shipping context loaded", shipping !== undefined);
+    assert("shipping has 1 command", shipping?.commands?.length === 1);
+    assert("shipping has 1 read model", shipping?.read_models?.length === 1);
+    // ADRs
+    assert("adrs map has 1 entry", model.adrs.size === 1);
+    const adrRec = model.adrs.get("adr-0001");
+    assert("adr-0001 loaded", adrRec !== undefined);
+    assert("adr-0001 title correct", adrRec?.title === "Use YAML for domain models");
+    assert("adr-0001 status correct", adrRec?.status === "accepted");
+    assert("adr-0001 has deciders", adrRec?.deciders?.length === 2);
+    assert("adr-0001 has domain_refs", adrRec?.domain_refs?.length === 1);
+    // Edge: load with empty domain
+    console.log("\n=== loader.ts (empty domain) ===");
+    const emptyTmp = join(tmpdir(), `dkk-empty-${Date.now()}`);
+    mkdirSync(join(emptyTmp, "domain", "contexts"), { recursive: true });
+    mkdirSync(join(emptyTmp, "docs", "adr"), { recursive: true });
+    writeFileSync(join(emptyTmp, "domain", "index.yml"), "contexts: []\n");
+    writeFileSync(join(emptyTmp, "domain", "actors.yml"), "actors: []\n");
+    const emptyModel = loadDomainModel({ root: emptyTmp });
+    assert("empty: contexts map is empty", emptyModel.contexts.size === 0);
+    assert("empty: actors is empty", emptyModel.actors.length === 0);
+    assert("empty: adrs is empty", emptyModel.adrs.size === 0);
+    rmSync(emptyTmp, { recursive: true, force: true });
+}
+finally {
+    teardown();
+}
+// ── Summary ───────────────────────────────────────────────────────────
+console.log(`\n${passed} passed, ${failed} failed`);
+if (failed > 0)
+    process.exit(1);
+//# sourceMappingURL=loader.test.js.map

package/dist/shared/tests/loader.test.js.map

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

package/dist/shared/tests/verify-collision-fix.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=verify-collision-fix.test.d.ts.map

package/dist/shared/tests/verify-collision-fix.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-collision-fix.test.d.ts","sourceRoot":"","sources":["../../../src/shared/tests/verify-collision-fix.test.ts"],"names":[],"mappings":""}

package/dist/shared/tests/verify-collision-fix.test.js

@@ -0,0 +1,114 @@
+/**
+ * E2E verification: glossary-aggregate namespace collision is resolved
+ * in DomainGraph — structural kinds take precedence over glossary.
+ */
+import { mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { loadDomainModel } from "../loader.js";
+import { DomainGraph } from "../graph.js";
+const TMP = join(tmpdir(), `dkk-collision-fix-${Date.now()}`);
+const DOMAIN = join(TMP, "domain");
+const CONTEXTS = join(DOMAIN, "contexts");
+const ADR_DIR = join(TMP, "docs", "adr");
+let passed = 0;
+let failed = 0;
+function assert(label, condition, detail) {
+    if (condition) {
+        console.log(`  OK: ${label}`);
+        passed++;
+    }
+    else {
+        console.error(`FAIL: ${label}${detail ? ` — ${detail}` : ""}`);
+        failed++;
+    }
+}
+function setup() {
+    mkdirSync(join(CONTEXTS, "ordering", "events"), { recursive: true });
+    mkdirSync(join(CONTEXTS, "ordering", "commands"), { recursive: true });
+    mkdirSync(join(CONTEXTS, "ordering", "aggregates"), { recursive: true });
+    mkdirSync(ADR_DIR, { recursive: true });
+    writeFileSync(join(DOMAIN, "index.yml"), [
+        "contexts:",
+        "  - name: ordering",
+        '    description: "Order management"',
+    ].join("\n"));
+    writeFileSync(join(DOMAIN, "actors.yml"), ["actors:", "  - name: Customer", "    type: human", '    description: "A customer"'].join("\n"));
+    // Context where glossary term "Order" collides with aggregate "Order"
+    writeFileSync(join(CONTEXTS, "ordering", "context.yml"), [
+        "name: ordering",
+        'description: "Handles orders"',
+        "glossary:",
+        "  - term: Order",
+        '    definition: "A customer purchase request"',
+        "  - term: LineItem",
+        '    definition: "An item within an order"',
+    ].join("\n"));
+    writeFileSync(join(CONTEXTS, "ordering", "events", "OrderPlaced.yml"), [
+        "name: OrderPlaced",
+        'description: "Raised when an order is placed"',
+        "raised_by: Order",
+    ].join("\n"));
+    writeFileSync(join(CONTEXTS, "ordering", "commands", "PlaceOrder.yml"), [
+        "name: PlaceOrder",
+        'description: "Submit a new order"',
+        "actor: Customer",
+        "handled_by: Order",
+    ].join("\n"));
+    writeFileSync(join(CONTEXTS, "ordering", "aggregates", "Order.yml"), [
+        "name: Order",
+        'description: "Order aggregate root"',
+        "handles:",
+        "  commands:",
+        "    - PlaceOrder",
+        "emits:",
+        "  events:",
+        "    - OrderPlaced",
+    ].join("\n"));
+    writeFileSync(join(ADR_DIR, "README.md"), "# ADRs\n");
+}
+function teardown() {
+    rmSync(TMP, { recursive: true, force: true });
+}
+// ── Tests ─────────────────────────────────────────────────────────────
+setup();
+try {
+    const model = loadDomainModel({ root: TMP });
+    const graph = DomainGraph.from(model);
+    console.log("\n=== Glossary-aggregate collision fix ===");
+    // The key assertion: ordering.Order should be kind "aggregate", not "glossary"
+    const orderNode = graph.nodes.get("ordering.Order");
+    assert("ordering.Order node exists", orderNode !== undefined);
+    assert("ordering.Order kind is 'aggregate' (not 'glossary')", orderNode?.kind === "aggregate", `got kind="${orderNode?.kind}"`);
+    // Glossary-only terms should retain glossary kind
+    const lineItemNode = graph.nodes.get("ordering.LineItem");
+    assert("ordering.LineItem node exists", lineItemNode !== undefined);
+    assert("ordering.LineItem kind is 'glossary' (no collision)", lineItemNode?.kind === "glossary", `got kind="${lineItemNode?.kind}"`);
+    // Edges from glossary processing should still be wired
+    const orderNeighbours = graph.getNeighbours("ordering.Order");
+    assert("Order aggregate neighbours include PlaceOrder", orderNeighbours.has("ordering.PlaceOrder"));
+    assert("Order aggregate neighbours include OrderPlaced", orderNeighbours.has("ordering.OrderPlaced"));
+    assert("Order neighbours include context.ordering (from both glossary and aggregate contains edges)", orderNeighbours.has("context.ordering"));
+    // The related command should show aggregate kind
+    console.log("\n=== Related command output grouping ===");
+    const related = graph.getRelated("ordering.PlaceOrder", 1);
+    assert("PlaceOrder related includes ordering.Order", related.has("ordering.Order"));
+    // Verify that grouped output would show "aggregate" not "glossary"
+    const grouped = new Map();
+    for (const nId of related) {
+        const node = graph.nodes.get(nId);
+        const kind = node?.kind ?? "unknown";
+        if (!grouped.has(kind))
+            grouped.set(kind, []);
+        grouped.get(kind).push(nId);
+    }
+    assert("related grouping shows 'aggregate' category", grouped.has("aggregate"), `categories: ${[...grouped.keys()].join(", ")}`);
+    assert("related grouping does NOT show 'glossary' for Order", !(grouped.get("glossary") ?? []).includes("ordering.Order"));
+}
+finally {
+    teardown();
+}
+console.log(`\n${passed} passed, ${failed} failed`);
+if (failed > 0)
+    process.exit(1);
+//# sourceMappingURL=verify-collision-fix.test.js.map

package/dist/shared/tests/verify-collision-fix.test.js.map

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

package/dist/shared/types/domain.d.ts

@@ -0,0 +1,244 @@
+/**
+ * TypeScript interfaces for all domain item types.
+ * These align with the JSON Schemas under tools/domain-pack/schema/.
+ */
+/** A typed field carried by events or commands. */
+export interface Field {
+    /** Field name. */
+    name: string;
+    /** Field type (e.g. "string", "UUID", "Money"). */
+    type: string;
+    /** Optional human-readable description. */
+    description?: string;
+}
+/** ADR reference in the form "adr-NNNN". */
+export type AdrRef = `adr-${string}`;
+/** A given/when/then scenario example for an event or command. */
+export interface Example {
+    /** Short human-readable description of the scenario. */
+    description: string;
+    /** Pre-conditions (given). */
+    given?: string[];
+    /** Trigger / action (when). */
+    when?: string[];
+    /** Expected outcomes (then). */
+    then?: string[];
+}
+/** Domain item reference in context.Name format (e.g. "ordering.OrderPlaced"). */
+export type DomainRef = `${string}.${string}`;
+/** A ubiquitous-language term within a bounded context. */
+export interface GlossaryEntry {
+    /** The canonical term name. */
+    term: string;
+    /** Plain-language definition. */
+    definition: string;
+    /** Alternative names for this term. */
+    aliases?: string[];
+    /** Related ADR identifiers. */
+    adr_refs?: AdrRef[];
+}
+/** Whether the actor is a person, internal system, or external system. */
+export type ActorType = "human" | "system" | "external";
+/** A person or system that interacts with the domain. */
+export interface Actor {
+    /** Actor display name (e.g. "Customer", "Payment Gateway"). */
+    name: string;
+    /** Kind of actor. */
+    type: ActorType;
+    /** What role this actor plays in the domain. */
+    description: string;
+    /** Related ADR identifiers. */
+    adr_refs?: AdrRef[];
+}
+/** Top-level actors definition file shape (domain/actors.yml). */
+export interface ActorsFile {
+    actors: Actor[];
+}
+/** A domain event raised within a bounded context. */
+export interface DomainEvent {
+    /** PascalCase event name (e.g. "OrderPlaced"). */
+    name: string;
+    /** What this event signifies in the domain. */
+    description: string;
+    /** Payload fields carried by this event. */
+    fields?: Field[];
+    /** Name of the aggregate that raises this event. */
+    raised_by?: string;
+    /** Given/when/then usage scenarios. */
+    examples?: Example[];
+    /** Business invariants / rules that must hold when this event is raised. */
+    invariants?: string[];
+    /** Related ADR identifiers. */
+    adr_refs?: AdrRef[];
+}
+/** A command handled by an aggregate within a bounded context. */
+export interface Command {
+    /** PascalCase command name (e.g. "PlaceOrder"). */
+    name: string;
+    /** What this command instructs the system to do. */
+    description: string;
+    /** Input fields for this command. */
+    fields?: Field[];
+    /** Name of the actor that initiates this command. */
+    actor?: string;
+    /** Name of the aggregate that handles this command. */
+    handled_by?: string;
+    /** Conditions that must be true before this command can be accepted. */
+    preconditions?: string[];
+    /** Reasons this command may be rejected. */
+    rejections?: string[];
+    /** Business invariants / rules that must hold when this event is raised. */
+    invariants?: string[];
+    /** Given/when/then usage scenarios. */
+    examples?: Example[];
+    /** Related ADR identifiers. */
+    adr_refs?: AdrRef[];
+}
+/** A reactive policy that listens to events and emits commands. */
+export interface Policy {
+    /** PascalCase policy name (e.g. "SendConfirmationEmail"). */
+    name: string;
+    /** What this policy does in response to events. */
+    description: string;
+    /** Conditions that activate this policy (nested: when.events). */
+    when?: {
+        events?: string[];
+    };
+    /** Actions taken by this policy (nested: then.commands). */
+    then?: {
+        commands?: string[];
+    };
+    /** Related ADR identifiers. */
+    adr_refs?: AdrRef[];
+}
+/** A domain aggregate that handles commands and emits events. */
+export interface Aggregate {
+    /** PascalCase aggregate name (e.g. "Order"). */
+    name: string;
+    /** What this aggregate represents in the domain. */
+    description: string;
+    /** Commands handled by this aggregate (nested: handles.commands). */
+    handles?: {
+        commands?: string[];
+    };
+    /** Events emitted by this aggregate (nested: emits.events). */
+    emits?: {
+        events?: string[];
+    };
+    /** Business invariants / rules enforced by this aggregate. */
+    invariants?: string[];
+    /** Related ADR identifiers. */
+    adr_refs?: AdrRef[];
+}
+/** A read model (projection) built from domain events. */
+export interface ReadModel {
+    /** PascalCase read model name (e.g. "OrderSummary"). */
+    name: string;
+    /** What data this read model exposes. */
+    description: string;
+    /** Event names this read model subscribes to. */
+    subscribes_to?: string[];
+    /** Actor names that consume this read model. */
+    used_by?: string[];
+    /** Related ADR identifiers. */
+    adr_refs?: AdrRef[];
+}
+/**
+ * Context metadata file shape (domain/contexts/<name>/context.yml).
+ * Contains only identity and glossary; item arrays live in typed
+ * sub-directories (events/, commands/, policies/, aggregates/, read-models/).
+ */
+export interface ContextMetaFile {
+    /** Kebab-case context identifier (e.g. "ordering"). */
+    name: string;
+    /** What this bounded context is responsible for. */
+    description: string;
+    /** Ubiquitous-language terms scoped to this context. */
+    glossary?: GlossaryEntry[];
+}
+/** A bounded context assembled from per-item YAML files. */
+export interface DomainContext {
+    /** Kebab-case context identifier (e.g. "ordering"). */
+    name: string;
+    /** What this bounded context is responsible for. */
+    description: string;
+    /** Ubiquitous-language terms scoped to this context. */
+    glossary?: GlossaryEntry[];
+    /** Domain events raised within this context. */
+    events?: DomainEvent[];
+    /** Commands handled within this context. */
+    commands?: Command[];
+    /** Reactive policies within this context. */
+    policies?: Policy[];
+    /** Aggregates within this context. */
+    aggregates?: Aggregate[];
+    /** Read models (projections) within this context. */
+    read_models?: ReadModel[];
+}
+/** Lifecycle status of an Architecture Decision Record. */
+export type AdrStatus = "proposed" | "accepted" | "deprecated" | "superseded";
+/** Frontmatter metadata for an Architecture Decision Record. */
+export interface AdrRecord {
+    /** Stable ADR identifier (e.g. "adr-0001"). */
+    id: AdrRef;
+    /** Human-readable title of the decision. */
+    title: string;
+    /** Current lifecycle status. */
+    status: AdrStatus;
+    /** ISO-8601 date when the decision was recorded (YYYY-MM-DD). */
+    date: string;
+    /** People involved in making this decision. */
+    deciders?: string[];
+    /** Domain items related to this decision. */
+    domain_refs?: DomainRef[];
+    /** ID of the ADR that supersedes this one. */
+    superseded_by?: AdrRef;
+    /** Markdown body text (everything after the closing ---), with formatting stripped. */
+    body?: string;
+}
+/** A reference to a registered bounded context in the index. */
+export interface ContextEntry {
+    /** Context identifier matching a file under domain/contexts/. */
+    name: string;
+    /** Short summary of the bounded context. */
+    description?: string;
+}
+/** Step type within a cross-context flow. */
+export type FlowStepType = "command" | "event" | "policy" | "read_model";
+/** A single step in a cross-context flow. */
+export interface FlowStep {
+    /** Domain item reference in context.Name format. */
+    ref: DomainRef;
+    /** Type of the referenced domain item. */
+    type: FlowStepType;
+    /** Optional annotation for this step. */
+    note?: string;
+}
+/** A cross-context flow linking domain items in sequence. */
+export interface Flow {
+    /** Flow name. */
+    name: string;
+    /** What this flow accomplishes. */
+    description?: string;
+    /** Ordered sequence of domain item references forming the flow. */
+    steps: FlowStep[];
+}
+/** Top-level domain index file shape (domain/index.yml). */
+export interface DomainIndex {
+    /** Registered bounded contexts. */
+    contexts: ContextEntry[];
+    /** Cross-context flows linking domain items in sequence. */
+    flows?: Flow[];
+}
+/** Complete domain model loaded from all YAML and ADR files. */
+export interface DomainModel {
+    /** Top-level domain index. */
+    index: DomainIndex;
+    /** All actors. */
+    actors: Actor[];
+    /** All bounded contexts keyed by context name. */
+    contexts: Map<string, DomainContext>;
+    /** All ADR records keyed by ADR id. */
+    adrs: Map<string, AdrRecord>;
+}
+//# sourceMappingURL=domain.d.ts.map

package/dist/shared/types/domain.d.ts.map

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

package/dist/shared/types/domain.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript interfaces for all domain item types.
+ * These align with the JSON Schemas under tools/domain-pack/schema/.
+ */
+export {};
+//# sourceMappingURL=domain.js.map

package/dist/shared/types/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../../src/shared/types/domain.ts"],"names":[],"mappings":"AAAA;;;GAGG"}