domain-knowledge-kit 0.2.8 → 0.2.10

package/README.md

@@ -1,147 +1,42 @@
 # Domain Knowledge Kit
 
-Define, validate, search, and document your domain model — all from YAML.
-
-## What Is This?
-
-Domain Knowledge Kit (DKK) is a CLI tool for teams practicing Domain-Driven Design. Instead of scattering domain knowledge across wikis, diagrams, and tribal memory, you define your **bounded contexts**, **events**, **commands**, **policies**, **aggregates**, **read models**, and **glossary** in structured YAML files. DKK then:
-
-- **Validates** schema conformance and referential integrity across your entire model
-- **Generates** browsable Markdown documentation from your YAML definitions
-- **Builds** a full-text search index (SQLite FTS5) for instant domain queries
-- **Links** Architecture Decision Records (ADRs) bidirectionally to domain items
-- **Integrates** with AI coding agents so they understand your domain, not just your code
-
-## Quick Start
-
-```bash
-# Install
-npm install -g domain-knowledge-kit
-
-# Create a bounded context (per-item directory format)
-mkdir -p .dkk/domain/contexts/ordering/{events,commands,aggregates}
-
-# Context metadata
-cat > .dkk/domain/contexts/ordering/context.yml << 'EOF'
-name: ordering
-description: Handles customer order lifecycle.
-EOF
-
-# One file per domain item
-cat > .dkk/domain/contexts/ordering/events/OrderPlaced.yml << 'EOF'
-name: OrderPlaced
-description: Raised when a customer order is confirmed.
-raised_by: Order
-EOF
-
-cat > .dkk/domain/contexts/ordering/commands/PlaceOrder.yml << 'EOF'
-name: PlaceOrder
-description: Submit a new customer order.
-handled_by: Order
-EOF
-
-cat > .dkk/domain/contexts/ordering/aggregates/Order.yml << 'EOF'
-name: Order
-description: Manages order state and invariants.
-handles:
-  commands:
-    - PlaceOrder
-emits:
-  events:
-    - OrderPlaced
-EOF
-
-# Register it in .dkk/domain/index.yml
-# Add "- name: ordering" to the contexts array
-
-# Validate and render
-dkk validate
-dkk render
-
-# Explore
-dkk search "order"
-dkk show ordering.OrderPlaced
-dkk related ordering.Order
-```
-
-→ **[Full Getting Started Guide](docs/getting-started.md)** — step-by-step walkthrough with examples.
+> *Humans design the domain. AI agents align the codebase.*
+
+## Philosophy
+
+### AI agents love structure
+
+Large language models thrive with well-structured, unambiguous context. A flat codebase gives them syntax; a structured domain model gives them **meaning**. DKK makes your domain a first-class, machine-readable citizen of your repository.
+
+### Humans can define domain events easily
+
+You don't need a diagram tool or a modeling session. Writing `OrderPlaced` in a YAML file — with a one-line description and a reference to the aggregate that emits it — is how humans naturally think in DDD. Defining events, commands, and policies in plain YAML reveals the bigger picture without drowning in implementation details.
+
+### Reading domain models beats reading code
+
+Business logic spread across services, handlers, and database schemas is hard to reason about holistically. A domain model is a curated, intentional view of *what your system does and why* — not *how* it does it. DKK keeps that view always up-to-date and always searchable.
+
+### Keeping ADRs, even deprecated ones, preserves project memory
+
+Architectural decisions aren't born in a vacuum. Understanding *why* a choice was made matters as much as knowing *what* the choice was. Deprecated ADRs aren't noise — they are the institutional memory that prevents teams (and AI agents) from relitigating past decisions.
+
+### Easy-to-reach, detailed, colocated knowledge for AI agents
+
+Knowledge that lives next to the code is knowledge that gets used. DKK colocates your domain model, ADRs, and generated docs inside the repository itself. AI agents can discover, query, and traverse this knowledge without leaving the codebase — making every interaction domain-aware.
+
+---
 
 ## Documentation
 
-| Guide | What You'll Learn |
-|-------|-------------------|
-| **[Getting Started](docs/getting-started.md)** | Install, create your first context, run quality gates, search and explore |
-| **[Domain Modeling](docs/domain-modeling.md)** | All item types, YAML structure, cross-references, naming conventions, ID formats |
-| **[CLI Reference](docs/cli-reference.md)** | Every command and flag: `list`, `show`, `search`, `related`, `validate`, `render`, `init`, `prime`, `adr show`, `adr related` |
-| **[ADR Guide](docs/adr-guide.md)** | Architecture Decision Records: format, bidirectional linking, querying, best practices |
-| **[AI Agent Integration](docs/ai-agent-integration.md)** | `dkk init`, `dkk prime`, Copilot integration, reusable prompts, portable skills |
-
-## Key Commands
-
-```bash
-dkk validate              # Schema + cross-reference validation
-dkk render                # Validate → render docs → rebuild search index
-dkk search "payment"      # Full-text search with ranking
-dkk show ordering.Order   # Display full item definition
-dkk related ordering.Order  # Graph traversal of connected items
-dkk list --type event     # List all events across contexts
-dkk init                  # Set up AI agent onboarding
-dkk prime                 # Output agent context to stdout
-```
-
-→ **[Full CLI Reference](docs/cli-reference.md)**
-
-## AI Agent Integration
-
-DKK has first-class support for AI coding agents. Two commands get you set up:
-
-```bash
-dkk init    # Add a DKK section to AGENTS.md (idempotent)
-dkk prime   # Output full domain context for AI consumption
-```
-
-Agents can then search, show, and traverse your domain model — making domain-aware decisions when writing, reviewing, or refactoring code. DKK also ships with GitHub Copilot instructions, reusable agent prompts, and a portable agent skill.
-
-→ **[AI Agent Integration Guide](docs/ai-agent-integration.md)**
-
-## Directory Layout
-
-```
-.dkk/                           # Domain model + generated + managed
-  domain/                         #   Domain model (YAML)
-    index.yml                     #     Contexts + flows
-    actors.yml                    #     Global actors
-    contexts/                     #     Bounded contexts (one dir each)
-      <name>/                     #       Context directory
-        context.yml               #         Context metadata + glossary
-        events/                   #         One .yml file per event
-        commands/                 #         One .yml file per command
-        aggregates/               #         One .yml file per aggregate
-        policies/                 #         One .yml file per policy
-        read-models/              #         One .yml file per read model
-  adr/                            #   Architecture Decision Records
-  docs/                           #   Generated docs (do not edit)
-src/                            # Source code (vertical slices)
-tools/dkk/                      # Schemas + templates
-  schema/                       #   JSON Schemas for validation
-  templates/                    #   Handlebars templates for rendering
-```
-
-## Contributing / Local Development
-
-```bash
-npm install
-
-# Run directly via tsx (no build step needed)
-npm run dev -- validate
-npm run dev -- render
-
-# Or build first
-npm run build
-npx dkk validate
-```
-
-The source code uses **vertical feature slices** — each feature (`query`, `adr`, `pipeline`, `agent`) owns its commands, logic, and tests. Cross-cutting infrastructure lives in `shared/`.
+All technical details, CLI references, and integration guides live in the [`docs/`](docs/) folder.
+
+| Guide | What It Covers |
+|-------|----------------|
+| **[Getting Started](docs/getting-started.md)** | Installation, first context, quality gates |
+| **[Domain Modeling](docs/domain-modeling.md)** | YAML structure, item types, naming conventions |
+| **[CLI Reference](docs/cli-reference.md)** | Every command and flag |
+| **[ADR Guide](docs/adr-guide.md)** | Writing, linking, and querying ADRs |
+| **[AI Agent Integration](docs/ai-agent-integration.md)** | Onboarding agents, context-efficient retrieval |
 
 ## License
 

package/dist/cli.js

@@ -2,8 +2,10 @@
 import { Command } from "commander";
 import { registerList } from "./features/query/commands/list.js";
 import { registerShow } from "./features/query/commands/show.js";
+import { registerSummary } from "./features/query/commands/summary.js";
 import { registerSearch } from "./features/query/commands/search.js";
 import { registerRelated } from "./features/query/commands/related.js";
+import { registerGraph } from "./features/query/commands/graph.js";
 import { registerValidate } from "./features/pipeline/commands/validate.js";
 import { registerRender } from "./features/pipeline/commands/render.js";
 import { registerAdrShow } from "./features/adr/commands/adr-show.js";
@@ -14,6 +16,9 @@ import { registerNewDomain } from "./features/scaffold/commands/new-domain.js";
 import { registerNewContext } from "./features/scaffold/commands/new-context.js";
 import { registerNewAdr } from "./features/scaffold/commands/new-adr.js";
 import { registerAddItem } from "./features/scaffold/commands/add-item.js";
+import { registerRename } from "./features/refactor/commands/rename.js";
+import { registerRm } from "./features/refactor/commands/rm.js";
+import { registerStats } from "./features/audit/commands/stats.js";
 import { formatCliError } from "./shared/errors.js";
 /** Whether to show full stack traces (set DEBUG=1 in env). */
 const DEBUG = Boolean(process.env.DEBUG);
@@ -26,12 +31,17 @@ program
 // Top-level commands
 registerList(program);
 registerShow(program);
+registerSummary(program);
 registerSearch(program);
 registerRelated(program);
+registerGraph(program);
 registerValidate(program);
 registerRender(program);
 registerInit(program);
 registerPrime(program);
+registerRename(program);
+registerRm(program);
+registerStats(program);
 // ADR sub-command group
 const adrCmd = program
     .command("adr")

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,8DAA8D;AAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAEzC,yEAAyE;AAEzE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,2BAA2B,CAAC;KACxC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,qBAAqB;AACrB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,aAAa,CAAC,OAAO,CAAC,CAAC;AAEvB,wBAAwB;AACxB,MAAM,MAAM,GAAG,OAAO;KACnB,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAEvC,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAE3B,0BAA0B;AAC1B,MAAM,MAAM,GAAG,OAAO;KACnB,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,gCAAgC,CAAC,CAAC;AAEjD,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,cAAc,CAAC,MAAM,CAAC,CAAC;AAEvB,sDAAsD;AACtD,eAAe,CAAC,OAAO,CAAC,CAAC;AAEzB,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,UAAU,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/features/audit/commands/stats.d.ts

@@ -0,0 +1,3 @@
+import type { Command as Cmd } from "commander";
+export declare function registerStats(program: Cmd): void;
+//# sourceMappingURL=stats.d.ts.map

package/dist/features/audit/commands/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../../src/features/audit/commands/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAIhD,wBAAgB,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA4EhD"}

package/dist/features/audit/commands/stats.js

@@ -0,0 +1,90 @@
+import { loadDomainModel } from "../../../shared/loader.js";
+import { DomainGraph } from "../../../shared/graph.js";
+export function registerStats(program) {
+    program
+        .command("stats")
+        .description("Print domain model statistics and potential orphaned items")
+        .option("-r, --root <path>", "Override repository root")
+        .action((opts) => {
+        const model = loadDomainModel({ root: opts.root });
+        const graph = DomainGraph.from(model);
+        const stats = {
+            contexts: 0,
+            events: 0,
+            commands: 0,
+            aggregates: 0,
+            policies: 0,
+            readModels: 0,
+            actors: 0,
+            adrs: 0,
+            flows: 0,
+            orphaned: []
+        };
+        for (const [id, node] of graph.nodes) {
+            switch (node.kind) {
+                case "context":
+                    stats.contexts++;
+                    break;
+                case "event":
+                    stats.events++;
+                    break;
+                case "command":
+                    stats.commands++;
+                    break;
+                case "aggregate":
+                    stats.aggregates++;
+                    break;
+                case "policy":
+                    stats.policies++;
+                    break;
+                case "read_model":
+                    stats.readModels++;
+                    break;
+                case "actor":
+                    stats.actors++;
+                    break;
+                case "adr":
+                    stats.adrs++;
+                    break;
+                case "flow":
+                    stats.flows++;
+                    break;
+            }
+            // Check for orphaned items (items with only 1 edge = "contains" from context,
+            // meaning they don't participate in handles/emits/triggers/etc with other items)
+            if (node.kind !== "context" && node.kind !== "actor" && node.kind !== "adr" && node.kind !== "flow" && node.kind !== "glossary") {
+                let connectionCount = 0;
+                for (const edge of graph.edges) {
+                    if ((edge.from === id || edge.to === id) && edge.label !== "contains") {
+                        connectionCount++;
+                    }
+                }
+                if (connectionCount === 0) {
+                    stats.orphaned.push(id);
+                }
+            }
+        }
+        console.log(`\n📊 Domain Model Statistics\n`);
+        console.log(`  Contexts:    ${stats.contexts}`);
+        console.log(`  Events:      ${stats.events}`);
+        console.log(`  Commands:    ${stats.commands}`);
+        console.log(`  Aggregates:  ${stats.aggregates}`);
+        console.log(`  Policies:    ${stats.policies}`);
+        console.log(`  Read Models: ${stats.readModels}`);
+        console.log(`  Actors:      ${stats.actors}`);
+        console.log(`  Flows:       ${stats.flows}`);
+        console.log(`  ADRs:        ${stats.adrs}`);
+        console.log(`\n🔍 Health Check`);
+        if (stats.orphaned.length > 0) {
+            console.log(`  Found ${stats.orphaned.length} potentially orphaned items (no relationships):`);
+            for (const orphan of stats.orphaned) {
+                console.log(`    - ${orphan}`);
+            }
+        }
+        else {
+            console.log(`  No orphaned items found! All clear.`);
+        }
+        console.log("");
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/features/audit/commands/stats.js.map

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

package/dist/features/pipeline/commands/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/features/pipeline/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAIhD,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA8CnD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/features/pipeline/commands/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAIhD,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAiEnD"}

package/dist/features/pipeline/commands/validate.js

@@ -3,40 +3,59 @@ import { validateDomainModel } from "../validator.js";
 /** Register the `validate` subcommand. */
 export function registerValidate(program) {
     program
-        .command("validate")
+        .command("validate [id]")
         .description("Validate domain YAML against schemas and cross-references")
         .option("--warn-missing-fields", "Warn about events/commands with no fields")
         .option("--json", "Output as JSON")
+        .option("--minify", "Minify JSON output (useful for AI agents)")
         .option("-r, --root <path>", "Override repository root")
-        .action((opts) => {
+        .action((id, opts) => {
         const model = loadDomainModel({ root: opts.root });
         const result = validateDomainModel(model, {
             warnMissingFields: opts.warnMissingFields,
         });
+        let { valid, errors, warnings } = result;
+        if (id) {
+            const isMatch = (p) => {
+                if (!p)
+                    return false;
+                if (p === `actor:${id}` || p === `adr:${id}` || p === `context:${id}`)
+                    return true;
+                const [ctx, name] = id.split(".");
+                if (ctx && name) {
+                    return p.startsWith(`context:${ctx}.`) && p.endsWith(`:${name}`);
+                }
+                return false;
+            };
+            errors = errors.filter((e) => isMatch(e.path));
+            warnings = warnings.filter((w) => isMatch(w.path));
+            valid = errors.length === 0;
+        }
         if (opts.json) {
-            console.log(JSON.stringify({
-                valid: result.valid,
-                errors: result.errors.map((e) => ({ message: e.message, path: e.path ?? null })),
-                warnings: result.warnings.map((w) => ({ message: w.message, path: w.path ?? null })),
-            }, null, 2));
-            if (!result.valid)
+            const payload = {
+                valid,
+                errors: errors.map((e) => ({ message: e.message, path: e.path ?? null })),
+                warnings: warnings.map((w) => ({ message: w.message, path: w.path ?? null })),
+            };
+            console.log(JSON.stringify(payload, null, opts.minify ? 0 : 2));
+            if (!valid)
                 process.exit(1);
             return;
         }
         // Print warnings
-        for (const w of result.warnings) {
+        for (const w of warnings) {
             const loc = w.path ? ` (${w.path})` : "";
             console.warn(`\u26a0  ${w.message}${loc}`);
         }
         // Print errors
-        for (const e of result.errors) {
+        for (const e of errors) {
             const loc = e.path ? ` (${e.path})` : "";
             console.error(`\u2717  ${e.message}${loc}`);
         }
         // Summary
-        const warnCount = result.warnings.length;
-        const errCount = result.errors.length;
-        if (result.valid) {
+        const warnCount = warnings.length;
+        const errCount = errors.length;
+        if (valid) {
             console.log(`\n\u2713 Validation passed.${warnCount > 0 ? ` (${warnCount} warning(s))` : ""}\n`);
         }
         else {

package/dist/features/pipeline/commands/validate.js.map

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

package/dist/features/query/commands/graph.d.ts

@@ -0,0 +1,3 @@
+import type { Command as Cmd } from "commander";
+export declare function registerGraph(program: Cmd): void;
+//# sourceMappingURL=graph.d.ts.map

package/dist/features/query/commands/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../src/features/query/commands/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAUhD,wBAAgB,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA6EhD"}

package/dist/features/query/commands/graph.js

@@ -0,0 +1,86 @@
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { loadDomainModel } from "../../../shared/loader.js";
+import { DomainGraph } from "../../../shared/graph.js";
+function escapeMermaidId(id) {
+    return id.replace(/[\.\-]/g, "_");
+}
+export function registerGraph(program) {
+    program
+        .command("graph")
+        .description("Generate a Mermaid.js flowchart of the domain model")
+        .option("-o, --output <file>", "Output file path (default: .dkk/docs/graph.md)")
+        .option("-d, --depth <n>", "Maximum traversal depth for large graphs", parseInt, 3)
+        .option("-r, --root <path>", "Override repository root")
+        .action((opts) => {
+        const model = loadDomainModel({ root: opts.root });
+        const graph = DomainGraph.from(model);
+        const outPath = opts.output || (opts.root ? join(opts.root, ".dkk", "docs", "graph.md") : join(process.cwd(), ".dkk", "docs", "graph.md"));
+        const lines = ["```mermaid", "flowchart TD"];
+        // Write nodes
+        const writtenNodes = new Set();
+        for (const [id, node] of graph.nodes) {
+            const mId = escapeMermaidId(id);
+            writtenNodes.add(mId);
+            const label = node.name;
+            let shape = `[${label}]`;
+            switch (node.kind) {
+                case "event":
+                    shape = `> ${label} ]`;
+                    break;
+                case "command":
+                    shape = `([${label}])`;
+                    break;
+                case "aggregate":
+                    shape = `[[${label}]]`;
+                    break;
+                case "policy":
+                    shape = `{{${label}}}`;
+                    break;
+                case "read_model":
+                    shape = `[(${label})]`;
+                    break;
+                case "actor":
+                    shape = `(( ${label} ))`;
+                    break;
+                case "flow":
+                    shape = `[[${label}]]`;
+                    break;
+                case "adr":
+                    shape = `[\\${label}\\]`;
+                    break;
+            }
+            lines.push(`    ${mId}${shape}`);
+        }
+        lines.push("\n    %% Relationships");
+        // Write edges
+        for (const edge of graph.edges) {
+            // Filter out internal structural edges
+            if (edge.label === "contains" || edge.label === "flow_next" || edge.label === "adr_ref") {
+                continue;
+            }
+            const from = escapeMermaidId(edge.from);
+            const to = escapeMermaidId(edge.to);
+            let link = `-->`;
+            if (edge.label === "subscribes_to" || edge.label === "used_by") {
+                link = `-.->`;
+            }
+            else if (edge.label === "handles") {
+                link = `==>`;
+            }
+            lines.push(`    ${from} ${link}|${edge.label}| ${to}`);
+        }
+        lines.push("```\n");
+        const content = lines.join("\n");
+        try {
+            writeFileSync(outPath, content, "utf-8");
+            console.log(`Generated Mermaid graph at ${outPath}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`Failed to write graph to ${outPath}:`, msg);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=graph.js.map

package/dist/features/query/commands/graph.js.map

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

package/dist/features/query/commands/summary.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `domain summary <id>` command — concise overview of an item.
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `summary` subcommand. */
+export declare function registerSummary(program: Cmd): void;
+//# sourceMappingURL=summary.d.ts.map

package/dist/features/query/commands/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../../src/features/query/commands/summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAIhD,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAwClD"}

package/dist/features/query/commands/summary.js

@@ -0,0 +1,43 @@
+import { loadDomainModel } from "../../../shared/loader.js";
+import { DomainGraph } from "../../../shared/graph.js";
+/** Register the `summary` subcommand. */
+export function registerSummary(program) {
+    program
+        .command("summary <id>")
+        .description("Show a concise summary of a domain item (useful for AI context)")
+        .option("--json", "Output as JSON")
+        .option("--minify", "Minify JSON output")
+        .option("-r, --root <path>", "Override repository root")
+        .action((id, opts) => {
+        const model = loadDomainModel({ root: opts.root });
+        const graph = DomainGraph.from(model);
+        const node = graph.nodes.get(id);
+        if (!node) {
+            if (opts.json) {
+                console.log(JSON.stringify({ error: `Item "${id}" not found` }, null, opts.minify ? 0 : 2));
+            }
+            else {
+                console.error(`Error: Item "${id}" not found.`);
+            }
+            process.exit(1);
+        }
+        const related = Array.from(graph.getRelated(id, 1));
+        if (opts.json) {
+            const payload = {
+                id: node.id,
+                name: node.name,
+                kind: node.kind,
+                context: node.context,
+                related,
+            };
+            console.log(JSON.stringify(payload, null, opts.minify ? 0 : 2));
+            return;
+        }
+        console.log(`\n# [${node.kind}] ${node.name}${node.context ? ` (Context: ${node.context})` : ""}\n`);
+        console.log(`Related (${related.length}):`);
+        for (const r of related)
+            console.log(`  - ${r}`);
+        console.log();
+    });
+}
+//# sourceMappingURL=summary.js.map

package/dist/features/query/commands/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../../../src/features/query/commands/summary.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,yCAAyC;AACzC,MAAM,UAAU,eAAe,CAAC,OAAY;IAC1C,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,iEAAiE,CAAC;SAC9E,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,UAAU,EAAE,oBAAoB,CAAC;SACxC,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,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEtC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9F,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAEpD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,OAAO,GAAG;gBACd,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO;aACR,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACrG,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/features/refactor/commands/rename.d.ts

@@ -0,0 +1,3 @@
+import type { Command as Cmd } from "commander";
+export declare function registerRename(program: Cmd): void;
+//# sourceMappingURL=rename.d.ts.map

package/dist/features/refactor/commands/rename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../../../src/features/refactor/commands/rename.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAkChD,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAyIjD"}