domain-knowledge-kit 0.1.0

package/LICENSE

@@ -0,0 +1,94 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+## Definitions
+
+The licensor is the entity offering these terms, and the software is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+"you" refers to the individual or entity agreeing to these terms.
+
+"your company" is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+
+"control" means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+"your licenses" are all the licenses granted to you for the software under
+these terms.
+
+"use" means anything you do with the software requiring one of your licenses.
+
+"trademark" means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,266 @@
+# Domain Knowledge Kit
+
+A structured, YAML-based domain model with Architecture Decision Records (ADRs), full-text search, and generated Markdown documentation.
+
+Domain Knowledge Kit lets you define bounded contexts, events, commands, policies, aggregates, read models, and glossary terms in YAML — then validate, render, and search them from the CLI.
+
+## Quick Start
+
+```bash
+# Install globally from npm
+npm install -g domain-knowledge-kit
+
+# Or run without installing
+npx dkk --help
+
+# Validate the domain model
+dkk validate
+
+# Render generated documentation
+dkk render
+
+# Search domain items
+dkk search "order"
+```
+
+### 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 and use the compiled binary
+npm run build
+npx dkk validate
+```
+
+## Directory Layout
+
+```
+domain/
+  index.yml              # Registered contexts + cross-context flows
+  actors.yml             # Global actors (human | system | external)
+  contexts/
+    <name>.yml           # Bounded context definition
+
+docs/
+  adr/                   # Architecture Decision Records (Markdown + YAML frontmatter)
+  domain/                # Generated documentation (do not edit by hand)
+
+src/
+  cli.ts                 # Slim CLI entry point (registers commands)
+  features/              # Vertical feature slices
+    query/               # List, show, search, related commands
+      commands/          #   CLI command handlers
+      searcher.ts        #   FTS5 search logic
+      tests/             #   Co-located unit tests
+    adr/                 # ADR show & related commands
+      commands/          #   CLI command handlers
+    pipeline/            # Validate, render, index pipeline
+      commands/          #   CLI command handlers
+      validator.ts       #   Schema + cross-ref validation
+      renderer.ts        #   Handlebars doc generation
+      indexer.ts          #   Search index builder
+      tests/             #   Co-located unit tests
+  shared/                # Cross-cutting infrastructure
+    types/               #   DomainModel, SearchIndexRecord, etc.
+    loader.ts            #   YAML model loading
+    graph.ts             #   BFS graph traversal
+    item-visitor.ts      #   Generic item iteration utility
+    adr-parser.ts        #   ADR frontmatter parsing
+    paths.ts             #   Path resolution helpers
+    errors.ts            #   Error formatting
+    yaml.ts              #   YAML I/O helpers
+    tests/               #   Co-located unit tests
+
+tools/
+  domain-pack/
+    schema/              # JSON Schemas for domain YAML validation
+    templates/           # Handlebars templates for doc generation
+
+test/
+  cli-integration.ts     # End-to-end CLI integration tests
+
+.github/
+  copilot-instructions.md  # Copilot integration instructions
+```
+
+### Architecture: Vertical Feature Slices
+
+The source code is organized into **vertical feature slices** rather than horizontal layers. Each feature slice (`query`, `adr`, `pipeline`) owns its commands, core logic, and tests. The `shared/` module contains cross-cutting infrastructure used by all slices (loader, graph traversal, type definitions, etc.).
+
+This structure ensures that adding a new domain item type or feature requires changes localized to one slice, reducing coupling and making the codebase easier to navigate.
+
+## Adding a Bounded Context
+
+1. Create a new file `domain/contexts/<name>.yml`:
+
+   ```yaml
+   name: <name>
+   description: A short description of this bounded context.
+   events: []
+   commands: []
+   policies: []
+   aggregates: []
+   read_models: []
+   glossary: []
+   ```
+
+2. Register it in `domain/index.yml`:
+
+   ```yaml
+   contexts:
+     - name: <name>
+   ```
+
+3. Run quality gates:
+
+   ```bash
+   dkk validate
+   dkk render
+   ```
+
+## Adding an ADR and Linking It
+
+1. Create a Markdown file in `docs/adr/` following the naming convention `adr-NNNN.md` (e.g. `adr-0002.md`):
+
+   ```markdown
+   ---
+   id: adr-NNNN
+   title: Short Title
+   status: proposed
+   date: YYYY-MM-DD
+   domain_refs:
+     - <context>.<ItemName>
+   ---
+
+   ## Context
+   ...
+
+   ## Decision
+   ...
+
+   ## Consequences
+   ...
+   ```
+
+2. Link back from domain items by adding the ADR id to their `adr_refs`:
+
+   ```yaml
+   # In domain/contexts/<name>.yml, on the relevant item:
+   adr_refs:
+     - adr-NNNN
+   ```
+
+3. Run quality gates:
+
+   ```bash
+   dkk validate
+   dkk render
+   ```
+
+## CLI Command Reference
+
+All commands below use `dkk` (the installed CLI). During local development, substitute `npm run dev --` or `npx tsx src/cli.ts` for `dkk`.
+
+### `list`
+
+List all domain items.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-c, --context <name>` | — | Filter by bounded context |
+| `-t, --type <type>` | — | Filter by item type (`event`, `command`, `policy`, `aggregate`, `read_model`, `glossary`, `actor`, `adr`, `flow`, `context`) |
+| `--json` | — | Output as JSON |
+| `-r, --root <path>` | repo root | Override repository root |
+
+### `show <id>`
+
+Display the full YAML of a single domain item.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--json` | — | Output as JSON |
+| `-r, --root <path>` | repo root | Override repository root |
+
+### `search <query>`
+
+FTS5 full-text search with ranking. Requires a pre-built index — run `render` first.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-c, --context <name>` | — | Filter results to a bounded context |
+| `-t, --type <type>` | — | Filter by item type |
+| `--tag <tag>` | — | Filter by tag/keyword |
+| `--limit <n>` | `20` | Maximum number of results |
+| `--expand` | — | Expand top results with graph neighbours |
+| `--json` | — | Output as JSON |
+| `-r, --root <path>` | repo root | Override repository root |
+
+### `related <id>`
+
+BFS graph traversal of related items.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-d, --depth <n>` | `1` | Maximum BFS traversal depth |
+| `--json` | — | Output as JSON |
+| `-r, --root <path>` | repo root | Override repository root |
+
+### `validate`
+
+Schema + cross-reference validation.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--warn-missing-fields` | — | Warn about events/commands with no `fields` defined |
+| `--json` | — | Output as JSON |
+| `-r, --root <path>` | repo root | Override repository root |
+
+### `render`
+
+Validate → render Handlebars Markdown docs → rebuild FTS5 SQLite search index.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--skip-validation` | — | Skip the schema + cross-ref validation step |
+| `--json` | — | Output as JSON |
+| `-r, --root <path>` | repo root | Override repository root |
+
+### `adr show <id>`
+
+Display ADR frontmatter as YAML.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--json` | — | Output as JSON |
+| `-r, --root <path>` | repo root | Override repository root |
+
+### `adr related <id>`
+
+Show bidirectional ADR ↔ domain links. Given an ADR id, lists domain items that reference it; given a domain item id, lists ADRs that reference it.
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-r, --root <path>` | repo root | Override repository root |
+
+## ID Conventions
+
+| Item Type    | Format                     | Example                  |
+|--------------|----------------------------|--------------------------|
+| Context item | `<context>.<ItemName>`     | `ordering.OrderPlaced`   |
+| Actor        | `actor.<Name>`             | `actor.Customer`         |
+| ADR          | `adr-NNNN`                 | `adr-0001`               |
+| Flow         | `flow.<Name>`              | `flow.OrderFulfillment`  |
+| Context      | `context.<name>`           | `context.ordering`       |
+
+## Copilot Integration
+
+[.github/copilot-instructions.md](.github/copilot-instructions.md) configures GitHub Copilot to understand the domain model structure and use domain-first retrieval (search → show → related → adr related).
+
+## License
+
+Elastic-2.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerList } from "./features/query/commands/list.js";
+import { registerShow } from "./features/query/commands/show.js";
+import { registerSearch } from "./features/query/commands/search.js";
+import { registerRelated } from "./features/query/commands/related.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";
+import { registerAdrRelated } from "./features/adr/commands/adr-related.js";
+import { formatCliError } from "./shared/errors.js";
+/** Whether to show full stack traces (set DEBUG=1 in env). */
+const DEBUG = Boolean(process.env.DEBUG);
+// ── CLI setup ─────────────────────────────────────────────────────────
+const program = new Command();
+program
+    .name("dkk")
+    .description("Domain Knowledge Pack CLI")
+    .version("0.1.0");
+// Top-level commands
+registerList(program);
+registerShow(program);
+registerSearch(program);
+registerRelated(program);
+registerValidate(program);
+registerRender(program);
+// ADR sub-command group
+const adrCmd = program
+    .command("adr")
+    .description("ADR-related commands");
+registerAdrShow(adrCmd);
+registerAdrRelated(adrCmd);
+program.parseAsync().catch((err) => {
+    console.error(`Error: ${formatCliError(err)}`);
+    if (DEBUG && err instanceof Error && err.stack) {
+        console.error(`\nStack trace:\n${err.stack}`);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +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,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;AAExB,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,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"}

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

@@ -0,0 +1,14 @@
+/**
+ * `domain adr related <id>` command — bidirectional domain-ADR links.
+ *
+ * For a given ADR or domain item, finds all linked items in the
+ * opposite direction:
+ *
+ * - ADR → domain items that reference it (via adr_refs)
+ * - Domain item → ADRs that reference it (via domain_refs) + ADRs
+ *   listed in its own adr_refs
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `adr related` subcommand on an `adr` parent command. */
+export declare function registerAdrRelated(adrCmd: Cmd): void;
+//# sourceMappingURL=adr-related.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adr-related.d.ts","sourceRoot":"","sources":["../../../../src/features/adr/commands/adr-related.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAoEhD,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAkGpD"}

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

@@ -0,0 +1,146 @@
+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("-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, 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, 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, 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,10 @@
+/**
+ * `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

@@ -0,0 +1 @@
+{"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,CA2BjD"}

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

@@ -0,0 +1,30 @@
+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("-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, 2));
+            }
+            else {
+                console.error(`Error: ADR "${id}" not found.`);
+            }
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(adr, null, 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

@@ -0,0 +1 @@
+{"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,mBAAmB,EAAE,0BAA0B,CAAC;SACvD,MAAM,CAAC,CAAC,EAAU,EAAE,IAAuC,EAAE,EAAE;QAC9D,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,CAAC,CAAC,CAAC,CAAC;YAC3E,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,CAAC,CAAC,CAAC,CAAC;YAC1C,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/pipeline/commands/render.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `domain render` command — validate + render + build search index.
+ *
+ * Validates the domain model, renders Markdown documentation via
+ * Handlebars templates, and rebuilds the FTS5 search index.
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `render` subcommand. */
+export declare function registerRender(program: Cmd): void;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../src/features/pipeline/commands/render.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAMhD,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA8DjD"}