domain-knowledge-kit 0.1.0

package/dist/features/pipeline/validator.js

@@ -0,0 +1,289 @@
+/**
+ * Domain model validator.
+ *
+ * Validates the loaded {@link DomainModel} in two phases:
+ *
+ * 1. **Schema validation** — Each YAML file is checked against its
+ *    corresponding JSON Schema (via ajv).
+ * 2. **Cross-reference validation** — All inter-item references are
+ *    resolved: context names, adr_refs, domain_refs, handles/emits,
+ *    when/then (policy), subscribes_to, used_by, raised_by, handled_by, actor.
+ *
+ * Results are returned as arrays of errors (blocking, should exit 1)
+ * and warnings (non-blocking, informational).
+ */
+import { createRequire } from "node:module";
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { forEachItem, itemAdrRefs } from "../../shared/item-visitor.js";
+// ajv & ajv-formats are CJS packages; use createRequire for clean interop
+// under both tsc (Node16 resolution) and tsx (ESM runtime).
+const require = createRequire(import.meta.url);
+const Ajv = require("ajv").default;
+const addFormats = require("ajv-formats").default;
+// ── Schema bootstrap ──────────────────────────────────────────────────
+/** Load all `*.schema.json` files from a directory into an Ajv instance. */
+function buildAjv(schemaDir) {
+    const ajv = new Ajv({ allErrors: true, strict: true });
+    addFormats(ajv);
+    const files = readdirSync(schemaDir).filter((f) => f.endsWith(".schema.json"));
+    for (const file of files) {
+        const schema = JSON.parse(readFileSync(join(schemaDir, file), "utf-8"));
+        ajv.addSchema(schema, schema.$id);
+    }
+    return ajv;
+}
+// ── Helper: push issue ────────────────────────────────────────────────
+function err(issues, message, path) {
+    issues.push({ severity: "error", message, path });
+}
+function warn(issues, message, path) {
+    issues.push({ severity: "warning", message, path });
+}
+// ── Phase 1: Schema validation ────────────────────────────────────────
+function validateSchemas(model, ajv, issues) {
+    // Helper: validate a single value against a schema id
+    function check(schemaId, data, path) {
+        const validate = ajv.getSchema(schemaId);
+        if (!validate) {
+            err(issues, `Schema "${schemaId}" not found in ajv`, path);
+            return;
+        }
+        if (!validate(data)) {
+            for (const e of validate.errors ?? []) {
+                const loc = e.instancePath ? ` ${e.instancePath}` : "";
+                err(issues, `Schema "${schemaId}"${loc}: ${e.message}`, path);
+            }
+        }
+    }
+    // Index
+    check("index.schema.json", model.index, "index");
+    // Actors
+    check("actors.schema.json", { actors: model.actors }, "actors");
+    // Bounded contexts (validate the full context object)
+    for (const [name, ctx] of model.contexts) {
+        check("context.schema.json", ctx, `context:${name}`);
+    }
+    // ADR frontmatter (strip runtime-only `body` field before validation)
+    for (const [id, adr] of model.adrs) {
+        const { body: _, ...frontmatter } = adr;
+        check("adr-frontmatter.schema.json", frontmatter, `adr:${id}`);
+    }
+}
+// ── Phase 2: Cross-reference validation ───────────────────────────────
+function validateCrossRefs(model, options, issues) {
+    // ─ Build lookup sets ────────────────────────────────────────────────
+    /** All ADR ids (e.g. "adr-0001"). */
+    const adrIds = new Set(model.adrs.keys());
+    /** All context names. */
+    const contextNames = new Set(model.contexts.keys());
+    /** All actor names. */
+    const actorNames = new Set(model.actors.map((a) => a.name));
+    /**
+     * All named domain items keyed as "context.Name".
+     * Used to verify domain_refs from ADRs and flow step refs.
+     */
+    const domainItemIds = new Set();
+    /**
+     * Per-context lookup sets for events, commands, aggregates,
+     * read models, policies, and glossary terms.
+     */
+    const perContext = new Map();
+    for (const [ctxName, ctx] of model.contexts) {
+        const sets = {
+            events: new Set(),
+            commands: new Set(),
+            aggregates: new Set(),
+            readModels: new Set(),
+            policies: new Set(),
+            glossaryTerms: new Set(),
+        };
+        const typeToSet = {
+            event: sets.events,
+            command: sets.commands,
+            aggregate: sets.aggregates,
+            read_model: sets.readModels,
+            policy: sets.policies,
+            glossary: sets.glossaryTerms,
+        };
+        forEachItem(ctx, (type, name) => {
+            typeToSet[type].add(name);
+            domainItemIds.add(`${ctxName}.${name}`);
+        });
+        perContext.set(ctxName, sets);
+    }
+    // ─ 1. Global ID uniqueness ─────────────────────────────────────────
+    // Check for duplicate names within a context (e.g. an event and command
+    // with the same name). Glossary terms share the same ID namespace
+    // (context.Name), so they must also be unique.
+    for (const [ctxName, ctx] of model.contexts) {
+        const seen = new Map(); // name → first-seen kind
+        forEachItem(ctx, (kind, name) => {
+            if (seen.has(name)) {
+                err(issues, `Duplicate name "${name}" in context "${ctxName}" (first seen as ${seen.get(name)}, duplicate as ${kind})`, `context:${ctxName}`);
+            }
+            else {
+                seen.set(name, kind);
+            }
+        });
+    }
+    // ─ 2. Context references in index ──────────────────────────────────
+    for (const entry of model.index.contexts) {
+        if (!contextNames.has(entry.name)) {
+            err(issues, `Index references context "${entry.name}" but no context file was loaded`, "index");
+        }
+    }
+    // ─ 3. ADR ref resolution ───────────────────────────────────────────
+    // Every adr_refs entry on any domain item must resolve to an ADR.
+    function checkAdrRefs(refs, path) {
+        for (const ref of refs ?? []) {
+            if (!adrIds.has(ref)) {
+                err(issues, `adr_ref "${ref}" does not resolve to any ADR`, path);
+            }
+        }
+    }
+    for (const actor of model.actors) {
+        checkAdrRefs(actor.adr_refs, `actor:${actor.name}`);
+    }
+    for (const [ctxName, ctx] of model.contexts) {
+        forEachItem(ctx, (type, name, item) => {
+            checkAdrRefs(itemAdrRefs(item), `context:${ctxName}.${type}:${name}`);
+        });
+    }
+    // ─ 4. ADR domain_refs resolution ───────────────────────────────────
+    for (const [id, adr] of model.adrs) {
+        for (const ref of adr.domain_refs ?? []) {
+            if (!domainItemIds.has(ref)) {
+                err(issues, `ADR domain_ref "${ref}" does not resolve to any domain item`, `adr:${id}`);
+            }
+        }
+        // superseded_by must resolve
+        if (adr.superseded_by && !adrIds.has(adr.superseded_by)) {
+            err(issues, `ADR superseded_by "${adr.superseded_by}" does not resolve to any ADR`, `adr:${id}`);
+        }
+    }
+    // ─ 5. Intra-context reference resolution ───────────────────────────
+    for (const [ctxName, ctx] of model.contexts) {
+        const sets = perContext.get(ctxName);
+        const path = (kind, name) => `context:${ctxName}.${kind}:${name}`;
+        forEachItem(ctx, (type, name, item) => {
+            switch (type) {
+                case "event": {
+                    const e = item;
+                    if (e.raised_by && !sets.aggregates.has(e.raised_by)) {
+                        err(issues, `Event "${e.name}" raised_by "${e.raised_by}" does not match any aggregate in context "${ctxName}"`, path("event", e.name));
+                    }
+                    break;
+                }
+                case "command": {
+                    const c = item;
+                    if (c.handled_by && !sets.aggregates.has(c.handled_by)) {
+                        err(issues, `Command "${c.name}" handled_by "${c.handled_by}" does not match any aggregate in context "${ctxName}"`, path("command", c.name));
+                    }
+                    if (c.actor && !actorNames.has(c.actor)) {
+                        err(issues, `Command "${c.name}" actor "${c.actor}" does not match any actor`, path("command", c.name));
+                    }
+                    break;
+                }
+                case "aggregate": {
+                    const a = item;
+                    for (const h of a.handles?.commands ?? []) {
+                        if (!sets.commands.has(h)) {
+                            err(issues, `Aggregate "${a.name}" handles "${h}" but no such command in context "${ctxName}"`, path("aggregate", a.name));
+                        }
+                    }
+                    for (const e of a.emits?.events ?? []) {
+                        if (!sets.events.has(e)) {
+                            err(issues, `Aggregate "${a.name}" emits "${e}" but no such event in context "${ctxName}"`, path("aggregate", a.name));
+                        }
+                    }
+                    break;
+                }
+                case "policy": {
+                    const p = item;
+                    for (const t of p.when?.events ?? []) {
+                        if (!sets.events.has(t)) {
+                            err(issues, `Policy "${p.name}" when.events "${t}" but no such event in context "${ctxName}"`, path("policy", p.name));
+                        }
+                    }
+                    for (const e of p.then?.commands ?? []) {
+                        if (!sets.commands.has(e)) {
+                            err(issues, `Policy "${p.name}" then.commands "${e}" but no such command in context "${ctxName}"`, path("policy", p.name));
+                        }
+                    }
+                    break;
+                }
+                case "read_model": {
+                    const r = item;
+                    for (const s of r.subscribes_to ?? []) {
+                        if (!sets.events.has(s)) {
+                            err(issues, `ReadModel "${r.name}" subscribes_to "${s}" but no such event in context "${ctxName}"`, path("read_model", r.name));
+                        }
+                    }
+                    for (const u of r.used_by ?? []) {
+                        if (!actorNames.has(u)) {
+                            err(issues, `ReadModel "${r.name}" used_by "${u}" but no such actor`, path("read_model", r.name));
+                        }
+                    }
+                    break;
+                }
+                case "glossary":
+                    // Glossary entries have no intra-context references to validate.
+                    break;
+            }
+        });
+    }
+    // ─ 6. Flow step resolution ─────────────────────────────────────────
+    for (const flow of model.index.flows ?? []) {
+        for (const step of flow.steps) {
+            if (!domainItemIds.has(step.ref)) {
+                err(issues, `Flow "${flow.name}" step ref "${step.ref}" does not resolve to any domain item`, `flow:${flow.name}`);
+            }
+        }
+    }
+    // ─ 7. Configurable warnings ────────────────────────────────────────
+    if (options.warnMissingFields) {
+        for (const [ctxName, ctx] of model.contexts) {
+            forEachItem(ctx, (type, name, item) => {
+                if (type === "event" || type === "command") {
+                    const typed = item;
+                    if (!typed.fields || typed.fields.length === 0) {
+                        warn(issues, `${type === "event" ? "Event" : "Command"} "${name}" has no fields defined`, `context:${ctxName}.${type}:${name}`);
+                    }
+                }
+            });
+        }
+    }
+}
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Default schema directory, resolved relative to this module.
+ * Works both from source (`src/core/`) and compiled (`dist/core/`).
+ */
+function defaultSchemaDir() {
+    return join(import.meta.dirname, "../../../tools/domain-pack/schema");
+}
+/**
+ * Validate a loaded {@link DomainModel}.
+ *
+ * Runs JSON Schema validation followed by cross-reference checks.
+ * Returns a {@link ValidationResult} containing errors and warnings.
+ *
+ * @param model - The domain model to validate (from `loadDomainModel()`).
+ * @param options - Optional validator configuration.
+ */
+export function validateDomainModel(model, options = {}) {
+    const schemaDir = options.schemaDir ?? defaultSchemaDir();
+    const ajv = buildAjv(schemaDir);
+    const issues = [];
+    validateSchemas(model, ajv, issues);
+    validateCrossRefs(model, options, issues);
+    const errors = issues.filter((i) => i.severity === "error");
+    const warnings = issues.filter((i) => i.severity === "warning");
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/features/pipeline/validator.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * `domain list` command — list domain items with optional filters.
+ *
+ * Displays a table of domain items filtered by bounded context
+ * and/or item type.
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `list` subcommand. */
+export declare function registerList(program: Cmd): void;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/features/query/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAqHhD,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA6B/C"}

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

@@ -0,0 +1,123 @@
+import { loadDomainModel } from "../../../shared/loader.js";
+import { forEachItem, itemDescription } from "../../../shared/item-visitor.js";
+/** Collect all domain items into flat rows. */
+function collectRows(root) {
+    const model = loadDomainModel({ root });
+    const rows = [];
+    // Actors
+    for (const actor of model.actors) {
+        rows.push({
+            id: `actor.${actor.name}`,
+            type: "actor",
+            context: "",
+            name: actor.name,
+            description: actor.description,
+        });
+    }
+    // Bounded contexts and their items
+    for (const [ctxName, ctx] of model.contexts) {
+        rows.push({
+            id: `context.${ctxName}`,
+            type: "context",
+            context: ctxName,
+            name: ctxName,
+            description: ctx.description,
+        });
+        forEachItem(ctx, (type, name, item) => {
+            rows.push({
+                id: `${ctxName}.${name}`,
+                type,
+                context: ctxName,
+                name,
+                description: itemDescription(item),
+            });
+        });
+    }
+    // ADRs
+    for (const [id, adr] of model.adrs) {
+        rows.push({
+            id,
+            type: "adr",
+            context: "",
+            name: adr.title,
+            description: `[${adr.status}] ${adr.date}`,
+        });
+    }
+    // Flows
+    for (const flow of model.index.flows ?? []) {
+        rows.push({
+            id: `flow.${flow.name}`,
+            type: "flow",
+            context: "",
+            name: flow.name,
+            description: flow.description ?? `${flow.steps.length} steps`,
+        });
+    }
+    return rows;
+}
+/** Truncate a string to `max` characters, adding "…" if truncated. */
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max - 1) + "…";
+}
+/** Pad a string to exactly `width` characters. */
+function pad(s, width) {
+    return s.padEnd(width);
+}
+/** Print rows as an aligned text table. */
+function printTable(rows) {
+    if (rows.length === 0) {
+        console.log("No items found.");
+        return;
+    }
+    const maxDesc = 60;
+    const header = { id: "ID", type: "TYPE", context: "CONTEXT", name: "NAME", description: "DESCRIPTION" };
+    const allRows = [header, ...rows.map((r) => ({ ...r, description: truncate(r.description, maxDesc) }))];
+    const widths = {
+        id: Math.max(...allRows.map((r) => r.id.length)),
+        type: Math.max(...allRows.map((r) => r.type.length)),
+        context: Math.max(...allRows.map((r) => r.context.length), 7),
+        name: Math.max(...allRows.map((r) => r.name.length)),
+        description: Math.max(...allRows.map((r) => r.description.length)),
+    };
+    for (const row of allRows) {
+        const line = [
+            pad(row.id, widths.id),
+            pad(row.type, widths.type),
+            pad(row.context, widths.context),
+            pad(row.name, widths.name),
+            row.description,
+        ].join("  ");
+        console.log(line);
+    }
+}
+/** Register the `list` subcommand. */
+export function registerList(program) {
+    program
+        .command("list")
+        .description("List domain items with optional filters")
+        .option("-c, --context <name>", "Filter by bounded context")
+        .option("-t, --type <type>", "Filter by item type (event, command, policy, aggregate, read_model, glossary, actor, adr, flow, context)")
+        .option("--json", "Output as JSON")
+        .option("-r, --root <path>", "Override repository root")
+        .action((opts) => {
+        let rows = collectRows(opts.root);
+        if (opts.context) {
+            const ctx = opts.context.toLowerCase();
+            rows = rows.filter((r) => r.context.toLowerCase() === ctx);
+        }
+        if (opts.type) {
+            const t = opts.type.toLowerCase();
+            rows = rows.filter((r) => r.type.toLowerCase() === t);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(rows, null, 2));
+            return;
+        }
+        console.log(`\n${rows.length} item(s) found:\n`);
+        printTable(rows);
+        console.log();
+    });
+}
+//# sourceMappingURL=list.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * `domain related <id>` command — graph traversal to find related items.
+ *
+ * Performs a BFS traversal from a given item ID in the domain graph
+ * and lists all reachable items within the specified depth.
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `related` subcommand. */
+export declare function registerRelated(program: Cmd): void;
+//# sourceMappingURL=related.d.ts.map

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

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

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

@@ -0,0 +1,61 @@
+import { loadDomainModel } from "../../../shared/loader.js";
+import { DomainGraph } from "../../../shared/graph.js";
+/** Register the `related` subcommand. */
+export function registerRelated(program) {
+    program
+        .command("related <id>")
+        .description("Show items related to a domain item via graph traversal (BFS)")
+        .option("-d, --depth <n>", "Maximum traversal depth", "1")
+        .option("--json", "Output as JSON")
+        .option("-r, --root <path>", "Override repository root")
+        .action((id, opts) => {
+        const depth = parseInt(opts.depth ?? "1", 10);
+        const model = loadDomainModel({ root: opts.root });
+        const graph = DomainGraph.from(model);
+        if (!graph.hasNode(id)) {
+            if (opts.json) {
+                console.log(JSON.stringify({ error: `Node "${id}" not found in the domain graph` }, null, 2));
+            }
+            else {
+                console.error(`Error: Node "${id}" not found in the domain graph.`);
+            }
+            process.exit(1);
+        }
+        const related = graph.getRelated(id, depth);
+        // Group by kind for readability
+        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({
+                id: nId,
+                name: node?.name ?? nId,
+                ...(node?.context ? { context: node.context } : {}),
+            });
+        }
+        if (opts.json) {
+            const result = {};
+            for (const [kind, items] of [...grouped.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+                result[kind] = items.sort((a, b) => a.id.localeCompare(b.id));
+            }
+            console.log(JSON.stringify({ id, depth, related: result }, null, 2));
+            return;
+        }
+        if (related.size === 0) {
+            console.log(`\nNo related items found for "${id}" within depth ${depth}.\n`);
+            return;
+        }
+        console.log(`\n${related.size} item(s) related to "${id}" (depth=${depth}):\n`);
+        for (const [kind, items] of [...grouped.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+            console.log(`  ${kind}:`);
+            for (const item of items.sort((a, b) => a.id.localeCompare(b.id))) {
+                const label = `${item.name}${item.context ? ` [${item.context}]` : ""}`;
+                console.log(`    - ${item.id}  (${label})`);
+            }
+        }
+        console.log();
+    });
+}
+//# sourceMappingURL=related.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * `domain search <query>` command — FTS5 keyword search over domain items.
+ *
+ * Runs a full-text search against the SQLite FTS5 index and displays
+ * ranked results with optional context/type/tag filters.
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `search` subcommand. */
+export declare function registerSearch(program: Cmd): void;
+//# sourceMappingURL=search.d.ts.map

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

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

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

@@ -0,0 +1,55 @@
+import { search } from "../searcher.js";
+import { DomainGraph } from "../../../shared/graph.js";
+import { loadDomainModel } from "../../../shared/loader.js";
+/** Register the `search` subcommand. */
+export function registerSearch(program) {
+    program
+        .command("search <query>")
+        .description("Full-text search across domain items (requires index; run 'domain-knowledge-kit render' first)")
+        .option("-c, --context <name>", "Filter results to a bounded context")
+        .option("-t, --type <type>", "Filter results by item type")
+        .option("--tag <tag>", "Filter results by tag/keyword")
+        .option("--limit <n>", "Maximum results to return", "20")
+        .option("--expand", "Expand top results with graph neighbours")
+        .option("--json", "Output as JSON")
+        .option("-r, --root <path>", "Override repository root")
+        .action((query, opts) => {
+        const filters = {
+            context: opts.context,
+            type: opts.type,
+            tag: opts.tag,
+        };
+        let graph;
+        if (opts.expand) {
+            const model = loadDomainModel({ root: opts.root });
+            graph = DomainGraph.from(model);
+        }
+        const results = search(query, filters, {
+            root: opts.root,
+            limit: parseInt(opts.limit ?? "20", 10),
+            graph,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        if (results.length === 0) {
+            console.log(`\nNo results for "${query}".\n`);
+            return;
+        }
+        console.log(`\n${results.length} result(s) for "${query}":\n`);
+        for (const r of results) {
+            const ctx = r.context ? ` [${r.context}]` : "";
+            console.log(`  ${r.id}  (${r.type})${ctx}  score=${r.score}`);
+            console.log(`    ${r.excerpt}`);
+            if (r.adrIds.length > 0) {
+                console.log(`    ADRs: ${r.adrIds.join(", ")}`);
+            }
+            if (r.relatedIds.length > 0) {
+                console.log(`    Related: ${r.relatedIds.join(", ")}`);
+            }
+            console.log();
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * `domain show <id>` command — display the full YAML for a domain item.
+ *
+ * Looks up an item by its composite ID (e.g. "ordering.OrderPlaced",
+ * "actor.Customer", "adr-0001") and prints its full YAML representation.
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `show` subcommand. */
+export declare function registerShow(program: Cmd): void;
+//# sourceMappingURL=show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../../src/features/query/commands/show.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AAwEhD,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CA2B/C"}