domain-knowledge-kit 0.1.0

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

@@ -0,0 +1,96 @@
+import { loadDomainModel } from "../../../shared/loader.js";
+import { stringifyYaml } from "../../../shared/yaml.js";
+/**
+ * Resolve an item by its composite ID and return the raw object
+ * suitable for YAML serialisation.
+ */
+function resolveItem(model, id) {
+    // Actor: "actor.<Name>"
+    if (id.startsWith("actor.")) {
+        const name = id.slice("actor.".length);
+        const actor = model.actors.find((a) => a.name === name);
+        if (actor)
+            return { found: true, data: actor, label: `Actor: ${name}` };
+        return { found: false };
+    }
+    // ADR: "adr-NNNN"
+    if (id.startsWith("adr-")) {
+        const adr = model.adrs.get(id);
+        if (adr)
+            return { found: true, data: adr, label: `ADR: ${adr.title}` };
+        return { found: false };
+    }
+    // Flow: "flow.<Name>"
+    if (id.startsWith("flow.")) {
+        const name = id.slice("flow.".length);
+        const flow = (model.index.flows ?? []).find((f) => f.name === name);
+        if (flow)
+            return { found: true, data: flow, label: `Flow: ${name}` };
+        return { found: false };
+    }
+    // Context: "context.<Name>"
+    if (id.startsWith("context.")) {
+        const name = id.slice("context.".length);
+        const ctx = model.contexts.get(name);
+        if (ctx)
+            return { found: true, data: ctx, label: `Context: ${name}` };
+        return { found: false };
+    }
+    // Context-scoped item: "<context>.<Name>"
+    const dotIdx = id.indexOf(".");
+    if (dotIdx > 0) {
+        const ctxName = id.slice(0, dotIdx);
+        const itemName = id.slice(dotIdx + 1);
+        const ctx = model.contexts.get(ctxName);
+        if (!ctx)
+            return { found: false };
+        // Search across all item types
+        const event = (ctx.events ?? []).find((e) => e.name === itemName);
+        if (event)
+            return { found: true, data: event, label: `Event: ${ctxName}.${itemName}` };
+        const command = (ctx.commands ?? []).find((c) => c.name === itemName);
+        if (command)
+            return { found: true, data: command, label: `Command: ${ctxName}.${itemName}` };
+        const policy = (ctx.policies ?? []).find((p) => p.name === itemName);
+        if (policy)
+            return { found: true, data: policy, label: `Policy: ${ctxName}.${itemName}` };
+        const aggregate = (ctx.aggregates ?? []).find((a) => a.name === itemName);
+        if (aggregate)
+            return { found: true, data: aggregate, label: `Aggregate: ${ctxName}.${itemName}` };
+        const readModel = (ctx.read_models ?? []).find((r) => r.name === itemName);
+        if (readModel)
+            return { found: true, data: readModel, label: `Read Model: ${ctxName}.${itemName}` };
+        const glossary = (ctx.glossary ?? []).find((g) => g.term === itemName);
+        if (glossary)
+            return { found: true, data: glossary, label: `Glossary: ${ctxName}.${itemName}` };
+    }
+    return { found: false };
+}
+/** Register the `show` subcommand. */
+export function registerShow(program) {
+    program
+        .command("show <id>")
+        .description("Show full YAML for a domain item by ID (e.g. ordering.OrderPlaced, actor.Customer, adr-0001)")
+        .option("--json", "Output as JSON")
+        .option("-r, --root <path>", "Override repository root")
+        .action((id, opts) => {
+        const model = loadDomainModel({ root: opts.root });
+        const result = resolveItem(model, id);
+        if (!result.found || !result.data) {
+            if (opts.json) {
+                console.log(JSON.stringify({ error: `Item "${id}" not found` }, null, 2));
+            }
+            else {
+                console.error(`Error: Item "${id}" not found.`);
+            }
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ id, label: result.label, data: result.data }, null, 2));
+            return;
+        }
+        console.log(`\n# ${result.label}\n`);
+        console.log(stringifyYaml(result.data));
+    });
+}
+//# sourceMappingURL=show.js.map

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

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

package/dist/features/query/searcher.d.ts

@@ -0,0 +1,58 @@
+import type { DomainGraph } from "../../shared/graph.js";
+/** A single search result. */
+export interface SearchResult {
+    /** Unique identifier (e.g. "ordering.OrderPlaced"). */
+    id: string;
+    /** Item kind. */
+    type: string;
+    /** Bounded-context name (empty for top-level items). */
+    context: string;
+    /** Human-readable display name. */
+    name: string;
+    /** Short excerpt with matching text. */
+    excerpt: string;
+    /** Computed relevance score (higher = more relevant). */
+    score: number;
+    /** Related item ids (direct relations from the index). */
+    relatedIds: string[];
+    /** ADR references attached to this item. */
+    adrIds: string[];
+}
+/** Filters that narrow search results. */
+export interface SearchFilters {
+    /** Only include items in this bounded context. */
+    context?: string;
+    /** Only include items of this type. */
+    type?: string;
+    /** Only include items whose tags contain this value. */
+    tag?: string;
+}
+/** Options for the searcher. */
+export interface SearcherOptions {
+    /** Override repository root. */
+    root?: string;
+    /** Override database path. */
+    dbPath?: string;
+    /** Maximum number of results to return (default: 20). */
+    limit?: number;
+    /** When provided, expand top results with graph neighbours. */
+    graph?: DomainGraph;
+    /** Number of top results to expand with graph neighbours (default: 5). */
+    expandTopN?: number;
+    /** BFS depth for graph expansion (default: 1). */
+    expandDepth?: number;
+}
+/**
+ * Search the FTS5 index for domain items matching `query`.
+ *
+ * Steps:
+ * 1. Run FTS5 MATCH query to get candidate rows + BM25 scores.
+ * 2. Apply boost scoring (exact-id, name, tag, glossary).
+ * 3. Apply post-FTS filters (context, type, tag).
+ * 4. Sort by final score descending.
+ * 5. If a {@link DomainGraph} is provided, expand top-N results with
+ *    graph neighbours and include linked ADRs.
+ * 6. Return the capped result list.
+ */
+export declare function search(query: string, filters?: SearchFilters, options?: SearcherOptions): SearchResult[];
+//# sourceMappingURL=searcher.d.ts.map

package/dist/features/query/searcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searcher.d.ts","sourceRoot":"","sources":["../../../src/features/query/searcher.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASzD,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8CD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CACpB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,EAC3B,OAAO,GAAE,eAAoB,GAC5B,YAAY,EAAE,CA8IhB"}

package/dist/features/query/searcher.js

@@ -0,0 +1,185 @@
+/**
+ * FTS5 searcher for domain items.
+ *
+ * Accepts a query string and optional filters (context, type, tag),
+ * performs an FTS5 MATCH query against the index built by the indexer,
+ * applies boost scoring, post-FTS filters, and graph expansion for
+ * top-N results. Returns a ranked list of search results.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { createRequire } from "node:module";
+import { repoRoot } from "../../shared/paths.js";
+// better-sqlite3 CJS interop
+const require = createRequire(import.meta.url);
+const Database = require("better-sqlite3");
+// ── Score boosts ──────────────────────────────────────────────────────
+/** Boost multipliers for different match locations. */
+const BOOST = {
+    /** Query matches item id exactly. */
+    exactId: 10,
+    /** Query appears in item name. */
+    name: 5,
+    /** Query appears in tags. */
+    tag: 3,
+    /** Query appears in text body. */
+    text: 1,
+};
+// ── Helpers ───────────────────────────────────────────────────────────
+/**
+ * Sanitise a user query for FTS5.
+ *
+ * FTS5 treats certain chars as operators. We escape double-quotes and
+ * wrap each token in quotes so special chars are treated literally.
+ * Empty queries are returned as-is (the caller should handle that).
+ */
+function sanitiseQuery(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return "";
+    // Split on whitespace, wrap each token in double-quotes, join with spaces.
+    // This produces an implicit AND query.
+    const tokens = trimmed.split(/\s+/).map((t) => `"${t.replace(/"/g, '""')}"`);
+    return tokens.join(" ");
+}
+/**
+ * Build snippet text from matching row fields.
+ * We take the first 200 characters of the text column as an excerpt.
+ */
+function makeExcerpt(text, maxLen = 200) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen).trimEnd() + "…";
+}
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Search the FTS5 index for domain items matching `query`.
+ *
+ * Steps:
+ * 1. Run FTS5 MATCH query to get candidate rows + BM25 scores.
+ * 2. Apply boost scoring (exact-id, name, tag, glossary).
+ * 3. Apply post-FTS filters (context, type, tag).
+ * 4. Sort by final score descending.
+ * 5. If a {@link DomainGraph} is provided, expand top-N results with
+ *    graph neighbours and include linked ADRs.
+ * 6. Return the capped result list.
+ */
+export function search(query, filters = {}, options = {}) {
+    const root = options.root ?? repoRoot();
+    const dbPath = options.dbPath ?? join(root, ".domain-pack", "index.db");
+    const limit = options.limit ?? 20;
+    const expandTopN = options.expandTopN ?? 5;
+    const expandDepth = options.expandDepth ?? 1;
+    if (!existsSync(dbPath)) {
+        throw new Error(`Search index not found at ${dbPath}. Run 'render' first.`);
+    }
+    const ftsQuery = sanitiseQuery(query);
+    if (!ftsQuery)
+        return [];
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        // ── Step 1: FTS5 MATCH ────────────────────────────────────────
+        const stmt = db.prepare(`
+      SELECT
+        id,
+        type,
+        context,
+        name,
+        tags,
+        text,
+        relations,
+        adrRefs,
+        rank
+      FROM domain_fts
+      WHERE domain_fts MATCH ?
+      ORDER BY rank
+      LIMIT 200
+    `);
+        const rows = stmt.all(ftsQuery);
+        // ── Step 2: Boost scoring ─────────────────────────────────────
+        const queryLower = query.toLowerCase();
+        const scored = rows.map((row) => {
+            // BM25 rank is negative (closer to 0 = better); invert to positive.
+            let score = -row.rank;
+            // Exact ID match
+            if (row.id.toLowerCase() === queryLower) {
+                score += BOOST.exactId;
+            }
+            // Name match
+            if (row.name.toLowerCase().includes(queryLower)) {
+                score += BOOST.name;
+            }
+            // Tag match
+            if (row.tags.toLowerCase().includes(queryLower)) {
+                score += BOOST.tag;
+            }
+            return { row, score };
+        });
+        // ── Step 3: Post-FTS filters ──────────────────────────────────
+        let filtered = scored;
+        if (filters.context) {
+            const ctx = filters.context.toLowerCase();
+            filtered = filtered.filter((s) => s.row.context.toLowerCase() === ctx);
+        }
+        if (filters.type) {
+            const t = filters.type.toLowerCase();
+            filtered = filtered.filter((s) => s.row.type.toLowerCase() === t);
+        }
+        if (filters.tag) {
+            const tag = filters.tag.toLowerCase();
+            filtered = filtered.filter((s) => s.row.tags.toLowerCase().includes(tag));
+        }
+        // ── Step 4: Sort ──────────────────────────────────────────────
+        filtered.sort((a, b) => b.score - a.score);
+        // ── Step 5: Graph expansion ───────────────────────────────────
+        const results = [];
+        const seenIds = new Set();
+        for (const { row, score } of filtered.slice(0, limit)) {
+            seenIds.add(row.id);
+            const relatedIds = safeParse(row.relations);
+            const adrIds = safeParse(row.adrRefs);
+            // Graph expansion for top-N items
+            if (options.graph && results.length < expandTopN) {
+                const expanded = options.graph.getRelated(row.id, expandDepth);
+                for (const nId of expanded) {
+                    relatedIds.push(nId);
+                }
+                // Collect ADR ids from graph neighbours
+                for (const nId of expanded) {
+                    if (nId.startsWith("adr-") && !adrIds.includes(nId)) {
+                        adrIds.push(nId);
+                    }
+                }
+            }
+            // Deduplicate
+            const uniqueRelated = [...new Set(relatedIds)];
+            const uniqueAdrs = [...new Set(adrIds)];
+            results.push({
+                id: row.id,
+                type: row.type,
+                context: row.context,
+                name: row.name,
+                excerpt: makeExcerpt(row.text),
+                score: Math.round(score * 1000) / 1000,
+                relatedIds: uniqueRelated,
+                adrIds: uniqueAdrs,
+            });
+        }
+        return results;
+    }
+    finally {
+        db.close();
+    }
+}
+// ── Internal ──────────────────────────────────────────────────────────
+/** Safely parse a JSON array, returning [] on failure. */
+function safeParse(json) {
+    try {
+        const parsed = JSON.parse(json);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=searcher.js.map

package/dist/features/query/searcher.js.map

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

package/dist/features/query/tests/searcher.test.d.ts

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

package/dist/features/query/tests/searcher.test.d.ts.map

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