domain-knowledge-kit 0.1.0

package/tools/domain-pack/schema/policy.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "policy.schema.json",
+  "title": "Policy",
+  "description": "A reactive policy that listens to events and emits commands",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[A-Za-z][A-Za-z0-9]*$",
+      "description": "PascalCase policy name (e.g. SendConfirmationEmail)"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "description": "What this policy does in response to events"
+    },
+    "when": {
+      "type": "object",
+      "description": "Conditions that activate this policy",
+      "properties": {
+        "events": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true,
+          "description": "Event names that trigger this policy"
+        }
+      },
+      "additionalProperties": false
+    },
+    "then": {
+      "type": "object",
+      "description": "Actions taken by this policy",
+      "properties": {
+        "commands": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "uniqueItems": true,
+          "description": "Command names that this policy emits"
+        }
+      },
+      "additionalProperties": false
+    },
+    "adr_refs": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^adr-\\d{4}$" },
+      "uniqueItems": true,
+      "description": "Related ADR identifiers"
+    }
+  },
+  "required": ["name", "description"],
+  "additionalProperties": false
+}

package/tools/domain-pack/schema/read-model.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "read-model.schema.json",
+  "title": "Read Model",
+  "description": "A read model (projection) built from domain events",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[A-Za-z][A-Za-z0-9]*$",
+      "description": "PascalCase read model name (e.g. OrderSummary)"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "description": "What data this read model exposes"
+    },
+    "subscribes_to": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true,
+      "description": "Event names this read model subscribes to"
+    },
+    "used_by": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "uniqueItems": true,
+      "description": "Actor names that consume this read model"
+    },
+    "adr_refs": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^adr-\\d{4}$" },
+      "uniqueItems": true,
+      "description": "Related ADR identifiers"
+    }
+  },
+  "required": ["name", "description"],
+  "additionalProperties": false
+}

package/tools/domain-pack/templates/context.md.hbs

@@ -0,0 +1,89 @@
+# {{name}}
+
+> Auto-generated — do not edit manually. Run `domain-knowledge-kit render` to regenerate.
+
+{{description}}
+
+## Glossary
+
+{{#if glossary}}
+| Term | Definition | Aliases |
+|------|------------|---------|
+{{#each glossary}}
+| **{{term}}** | {{definition}} | {{#if aliases}}{{join aliases ", "}}{{else}}—{{/if}} |
+{{/each}}
+{{else}}
+_No glossary entries._
+{{/if}}
+
+## Events
+
+{{#if events}}
+| Event | Description | Raised By | Fields |
+|-------|-------------|-----------|--------|
+{{#each events}}
+| [{{name}}]({{name}}.md) | {{description}} | {{#if raised_by}}`{{raised_by}}`{{else}}—{{/if}} | {{#if fields}}{{fieldSummary fields}}{{else}}—{{/if}} |
+{{/each}}
+{{else}}
+_No events._
+{{/if}}
+
+## Commands
+
+{{#if commands}}
+| Command | Description | Actor | Handled By | Fields |
+|---------|-------------|-------|------------|--------|
+{{#each commands}}
+| [{{name}}]({{name}}.md) | {{description}} | {{#if actor}}`{{actor}}`{{else}}—{{/if}} | {{#if handled_by}}`{{handled_by}}`{{else}}—{{/if}} | {{#if fields}}{{fieldSummary fields}}{{else}}—{{/if}} |
+{{/each}}
+{{else}}
+_No commands._
+{{/if}}
+
+## Policies
+
+{{#if policies}}
+| Policy | Description | Triggers | Emits |
+|--------|-------------|----------|-------|
+{{#each policies}}
+| [{{name}}]({{name}}.md) | {{description}} | {{#if when.events}}{{join when.events ", "}}{{else}}—{{/if}} | {{#if then.commands}}{{join then.commands ", "}}{{else}}—{{/if}} |
+{{/each}}
+{{else}}
+_No policies._
+{{/if}}
+
+## Aggregates
+
+{{#if aggregates}}
+| Aggregate | Description | Handles | Emits |
+|-----------|-------------|---------|-------|
+{{#each aggregates}}
+| [{{name}}]({{name}}.md) | {{description}} | {{#if handles.commands}}{{join handles.commands ", "}}{{else}}—{{/if}} | {{#if emits.events}}{{join emits.events ", "}}{{else}}—{{/if}} |
+{{/each}}
+{{else}}
+_No aggregates._
+{{/if}}
+
+## Read Models
+
+{{#if read_models}}
+| Read Model | Description | Subscribes To | Used By |
+|------------|-------------|---------------|---------|
+{{#each read_models}}
+| [{{name}}]({{name}}.md) | {{description}} | {{#if subscribes_to}}{{join subscribes_to ", "}}{{else}}—{{/if}} | {{#if used_by}}{{join used_by ", "}}{{else}}—{{/if}} |
+{{/each}}
+{{else}}
+_No read models._
+{{/if}}
+
+## Linked ADRs
+
+{{#if adrs}}
+| ADR | Title | Status |
+|-----|-------|--------|
+{{#each adrs}}
+| {{id}} | {{title}} | {{status}} |
+{{/each}}
+{{else}}
+_No linked ADRs._
+{{/if}}

package/tools/domain-pack/templates/index.md.hbs

@@ -0,0 +1,60 @@
+# Domain Knowledge Index
+
+> Auto-generated — do not edit manually. Run `domain-knowledge-kit render` to regenerate.
+
+## Bounded Contexts
+
+{{#if contexts}}
+| Context | Description |
+|---------|-------------|
+{{#each contexts}}
+| [{{name}}]({{name}}/index.md) | {{description}} |
+{{/each}}
+{{else}}
+_No bounded contexts registered._
+{{/if}}
+
+## Actors
+
+{{#if actors}}
+| Actor | Type | Description |
+|-------|------|-------------|
+{{#each actors}}
+| {{name}} | {{type}} | {{description}} |
+{{/each}}
+{{else}}
+_No actors defined._
+{{/if}}
+
+## Glossary Index
+
+{{#if glossaryEntries}}
+| Term | Context | Definition |
+|------|---------|------------|
+{{#each glossaryEntries}}
+| {{term}} | [{{context}}]({{context}}/index.md) | {{definition}} |
+{{/each}}
+{{else}}
+_No glossary entries._
+{{/if}}
+
+## Key Flows
+
+{{#if flows}}
+{{#each flows}}
+### {{name}}
+
+{{#if description}}
+{{description}}
+{{/if}}
+
+| # | Step | Type |
+|---|------|------|
+{{#each steps}}
+| {{stepNumber}} | `{{ref}}` | {{type}} |
+{{/each}}
+
+{{/each}}
+{{else}}
+_No cross-context flows defined._
+{{/if}}

package/tools/domain-pack/templates/item.md.hbs

@@ -0,0 +1,85 @@
+# {{name}}
+
+> Auto-generated — do not edit manually. Run `domain-knowledge-kit render` to regenerate.
+
+**Type:** {{itemType}} · **Context:** [{{context}}](index.md)
+
+## Summary
+
+{{description}}
+
+{{#if meaning}}
+## Meaning
+
+{{meaning}}
+{{/if}}
+
+{{#if fields}}
+## Fields
+
+| Name | Type | Description |
+|------|------|-------------|
+{{#each fields}}
+| `{{name}}` | `{{type}}` | {{#if description}}{{description}}{{else}}—{{/if}} |
+{{/each}}
+{{/if}}
+
+{{#if rules}}
+## Rules & Invariants
+
+{{#each rules}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{#if examples}}
+## Examples
+
+{{#each examples}}
+### {{description}}
+
+{{#if given}}
+**Given:**
+{{#each given}}
+- {{this}}
+{{/each}}
+{{/if}}
+{{#if when}}
+**When:**
+{{#each when}}
+- {{this}}
+{{/each}}
+{{/if}}
+{{#if then}}
+**Then:**
+{{#each then}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+{{/if}}
+
+## Relationships
+
+{{#if relationships}}
+| Relationship | Target |
+|-------------|--------|
+{{#each relationships}}
+| {{label}} | `{{target}}` |
+{{/each}}
+{{else}}
+_No relationships._
+{{/if}}
+
+## Linked ADRs
+
+{{#if adr_refs}}
+| ADR |
+|-----|
+{{#each adr_refs}}
+| {{this}} |
+{{/each}}
+{{else}}
+_No linked ADRs._
+{{/if}}