@harness-engineering/cli 1.25.5 → 1.25.7

package/dist/{chunk-K2SON7TI.js → chunk-NKQEMWGT.js}

@@ -5,6 +5,7 @@ import {
 // ../graph/dist/index.mjs
 import { z } from "zod";
 import { readFile, writeFile, mkdir, access } from "fs/promises";
+import { createWriteStream } from "fs";
 import { join } from "path";
 import * as fs from "fs/promises";
 import * as path from "path";
@@ -18,13 +19,32 @@ import * as fs3 from "fs/promises";
 import * as path4 from "path";
 import * as fs4 from "fs/promises";
 import * as path5 from "path";
-import { minimatch } from "minimatch";
-import { relative as relative2 } from "path";
 import * as fs5 from "fs/promises";
 import * as path6 from "path";
+import { minimatch } from "minimatch";
+import { relative as relative3 } from "path";
+import * as fs6 from "fs/promises";
+import * as path7 from "path";
+function streamGraphJson(filePath, nodes, edges) {
+  return new Promise((resolve, reject) => {
+    const stream = createWriteStream(filePath, { encoding: "utf-8" });
+    stream.on("error", reject);
+    stream.write('{"nodes":[');
+    for (let i = 0; i < nodes.length; i++) {
+      if (i > 0) stream.write(",");
+      stream.write(JSON.stringify(nodes[i]));
+    }
+    stream.write('],"edges":[');
+    for (let i = 0; i < edges.length; i++) {
+      if (i > 0) stream.write(",");
+      stream.write(JSON.stringify(edges[i]));
+    }
+    stream.write("]}");
+    stream.end(resolve);
+  });
+}
 async function saveGraph(dirPath, nodes, edges) {
   await mkdir(dirPath, { recursive: true });
-  const graphData = { nodes, edges };
   const metadata = {
     schemaVersion: CURRENT_SCHEMA_VERSION,
     lastScanTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -32,7 +52,7 @@ async function saveGraph(dirPath, nodes, edges) {
     edgeCount: edges.length
   };
   await Promise.all([
-    writeFile(join(dirPath, "graph.json"), JSON.stringify(graphData, null, 2), "utf-8"),
+    streamGraphJson(join(dirPath, "graph.json"), nodes, edges),
     writeFile(join(dirPath, "metadata.json"), JSON.stringify(metadata, null, 2), "utf-8")
   ]);
 }
@@ -300,6 +320,30 @@ function parseFailureSection(section) {
     }
   };
 }
+function parseFrontmatter(raw) {
+  const match = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!match) return null;
+  const yamlBlock = match[1];
+  const body = match[2];
+  const frontmatter = {};
+  for (const line of yamlBlock.split("\n")) {
+    const kvMatch = line.match(/^(\w+):\s*(.+)$/);
+    if (!kvMatch) continue;
+    const key = kvMatch[1];
+    const value = kvMatch[2].trim();
+    if (value.startsWith("[") && value.endsWith("]")) {
+      frontmatter[key] = value.slice(1, -1).split(",").map((s) => s.trim());
+    } else {
+      frontmatter[key] = value;
+    }
+  }
+  if (!frontmatter.type || typeof frontmatter.type !== "string") return null;
+  if (!frontmatter.domain || typeof frontmatter.domain !== "string") return null;
+  return {
+    frontmatter,
+    body
+  };
+}
 function detectEarsPattern(text) {
   const lower = text.toLowerCase();
   if (/^if\b.+\bthen\b.+\bshall not\b/.test(lower)) return "unwanted";
@@ -321,7 +365,7 @@ function sanitizeExternalText(text, maxLength = 2e3) {
 }
 function linkToCode(store, content, sourceNodeId, edgeType, options) {
   let edgesCreated = 0;
-  for (const type of CODE_NODE_TYPES3) {
+  for (const type of CODE_NODE_TYPES4) {
     const nodes = store.findNodes({ type });
     for (const node of nodes) {
       if (node.name.length < 3) continue;
@@ -656,7 +700,7 @@ function isDTCGToken(obj) {
 }
 async function readFileOrNull(filePath) {
   try {
-    return await fs5.readFile(filePath, "utf-8");
+    return await fs6.readFile(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -738,7 +782,7 @@ function parseAntiPatterns(content) {
   }
   return patterns;
 }
-var NODE_TYPES, EDGE_TYPES, OBSERVABILITY_TYPES, CURRENT_SCHEMA_VERSION, NODE_STABILITY, GraphNodeSchema, GraphEdgeSchema, POISONED_KEYS, GraphStore, VectorStore, DEFAULT_TTL_MS, PackedSummaryCache, ContextQL, TEST_TYPES, DOC_TYPES, CODE_TYPES, SKIP_METHOD_NAMES, FUNCTION_PATTERNS, CLASS_PATTERNS, INTERFACE_PATTERNS, METHOD_PATTERNS, GO_METHOD_PATTERN, VARIABLE_PATTERNS, SUPPORTED_EXTENSIONS, SKIP_EXTENSIONS, CodeIngestor, execFileAsync, GitIngestor, TopologicalLinker, CODE_NODE_TYPES, KnowledgeIngestor, REQUIREMENT_SECTIONS, SECTION_HEADING_RE, NUMBERED_ITEM_RE, CODE_NODE_TYPES2, RequirementIngestor, CODE_NODE_TYPES3, SANITIZE_RULES, SyncManager, JiraConnector, SlackConnector, ConfluenceConnector, CIConnector, STOP_WORDS, FusionLayer, CODE_NODE_TYPES4, GraphEntropyAdapter, GraphComplexityAdapter, GraphCouplingAdapter, DEFAULT_THRESHOLD, DEFAULT_METRICS, RECOGNIZED_METRICS, GraphAnomalyAdapter, INTENTS, SIGNAL_WEIGHTS, INTENT_SIGNALS, IntentClassifier, INTENT_KEYWORDS, STOP_WORDS2, PASCAL_OR_CAMEL_RE, FILE_PATH_RE, QUOTED_RE, EntityExtractor, EntityResolver, ResponseFormatter, CompositeProbabilityStrategy, DEFAULT_PROBABILITY_FLOOR, DEFAULT_MAX_DEPTH, CascadeSimulator, ENTITY_REQUIRED_INTENTS, classifier, extractor, formatter, PHASE_NODE_TYPES, CODE_NODE_TYPES5, Assembler, GraphConstraintAdapter, DesignIngestor, DesignConstraintAdapter, GraphFeedbackAdapter, DEFAULT_EDGE_TYPES, TaskIndependenceAnalyzer, ConflictPredictor, VERSION;
+var NODE_TYPES, EDGE_TYPES, OBSERVABILITY_TYPES, CURRENT_SCHEMA_VERSION, NODE_STABILITY, GraphNodeSchema, GraphEdgeSchema, POISONED_KEYS, GraphStore, VectorStore, DEFAULT_TTL_MS, PackedSummaryCache, ContextQL, TEST_TYPES, DOC_TYPES, CODE_TYPES, SKIP_METHOD_NAMES, FUNCTION_PATTERNS, CLASS_PATTERNS, INTERFACE_PATTERNS, METHOD_PATTERNS, GO_METHOD_PATTERN, VARIABLE_PATTERNS, SUPPORTED_EXTENSIONS, SKIP_EXTENSIONS, CodeIngestor, execFileAsync, GitIngestor, TopologicalLinker, CODE_NODE_TYPES, KnowledgeIngestor, BUSINESS_KNOWLEDGE_TYPES, GOVERNS_SOURCE_TYPES, CODE_NODE_TYPES2, MEASURABLE_TYPES, BusinessKnowledgeIngestor, REQUIREMENT_SECTIONS, SECTION_HEADING_RE, NUMBERED_ITEM_RE, CODE_NODE_TYPES3, RequirementIngestor, CODE_NODE_TYPES4, SANITIZE_RULES, SyncManager, JiraConnector, SlackConnector, ConfluenceConnector, CIConnector, STOP_WORDS, FusionLayer, CODE_NODE_TYPES5, GraphEntropyAdapter, GraphComplexityAdapter, GraphCouplingAdapter, DEFAULT_THRESHOLD, DEFAULT_METRICS, RECOGNIZED_METRICS, GraphAnomalyAdapter, INTENTS, SIGNAL_WEIGHTS, INTENT_SIGNALS, IntentClassifier, INTENT_KEYWORDS, STOP_WORDS2, PASCAL_OR_CAMEL_RE, FILE_PATH_RE, QUOTED_RE, EntityExtractor, EntityResolver, ResponseFormatter, CompositeProbabilityStrategy, DEFAULT_PROBABILITY_FLOOR, DEFAULT_MAX_DEPTH, CascadeSimulator, ENTITY_REQUIRED_INTENTS, classifier, extractor, formatter, PHASE_NODE_TYPES, CODE_NODE_TYPES6, Assembler, GraphConstraintAdapter, DesignIngestor, DesignConstraintAdapter, GraphFeedbackAdapter, DEFAULT_EDGE_TYPES, TaskIndependenceAnalyzer, ConflictPredictor, VERSION;
 var init_dist = __esm({
   "../graph/dist/index.mjs"() {
     NODE_TYPES = [
@@ -780,6 +824,12 @@ var init_dist = __esm({
       "design_constraint",
       // Traceability
       "requirement",
+      // Business Knowledge
+      "business_rule",
+      "business_process",
+      "business_concept",
+      "business_term",
+      "business_metric",
       // Cache
       "packed_summary"
     ];
@@ -816,6 +866,9 @@ var init_dist = __esm({
       "requires",
       "verified_by",
       "tested_by",
+      // Business Knowledge relationships
+      "governs",
+      "measures",
       // Cache relationships
       "caches"
     ];
@@ -986,8 +1039,8 @@ var init_dist = __esm({
       }
       // --- Persistence ---
       async save(dirPath) {
-        const allNodes = Array.from(this.nodeMap.values()).map((n) => ({ ...n }));
-        const allEdges = Array.from(this.edgeMap.values()).map((e) => ({ ...e }));
+        const allNodes = Array.from(this.nodeMap.values());
+        const allEdges = Array.from(this.edgeMap.values());
         await saveGraph(dirPath, allNodes, allEdges);
       }
       async load(dirPath) {
@@ -1281,7 +1334,17 @@ var init_dist = __esm({
       typescript: /(?:export\s+)?(?:const|let|var)\s+(\w+)/,
       javascript: /(?:export\s+)?(?:const|let|var)\s+(\w+)/
     };
-    SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".rs", ".java"]);
+    SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
+      ".ts",
+      ".tsx",
+      ".js",
+      ".jsx",
+      ".py",
+      ".go",
+      ".rs",
+      ".java",
+      ".groovy"
+    ]);
     SKIP_EXTENSIONS = /* @__PURE__ */ new Set([".d.ts"]);
     CodeIngestor = class {
       constructor(store) {
@@ -1295,22 +1358,34 @@ var init_dist = __esm({
         let edgesAdded = 0;
         const files = await this.findSourceFiles(rootDir);
         const nameToFiles = /* @__PURE__ */ new Map();
-        const fileContents = /* @__PURE__ */ new Map();
         for (const filePath of files) {
           try {
-            const result = await this.processFile(filePath, rootDir, nameToFiles, fileContents);
+            const result = await this.processFile(filePath, rootDir, nameToFiles);
             nodesAdded += result.nodesAdded;
             edgesAdded += result.edgesAdded;
           } catch (err) {
             errors.push(`${filePath}: ${err instanceof Error ? err.message : String(err)}`);
           }
         }
-        const callsEdges = this.extractCallsEdges(nameToFiles, fileContents);
-        for (const edge of callsEdges) {
-          this.store.addEdge(edge);
-          edgesAdded++;
+        for (const filePath of files) {
+          try {
+            const relativePath = path.relative(rootDir, filePath).replace(/\\/g, "/");
+            const content = await fs.readFile(filePath, "utf-8");
+            const callsEdges = this.extractCallsEdgesForFile(relativePath, content, nameToFiles);
+            for (const edge of callsEdges) {
+              this.store.addEdge(edge);
+              edgesAdded++;
+            }
+          } catch {
+          }
+        }
+        for (const filePath of files) {
+          try {
+            const content = await fs.readFile(filePath, "utf-8");
+            edgesAdded += this.extractReqAnnotationsForFile(filePath, content, rootDir);
+          } catch {
+          }
         }
-        edgesAdded += this.extractReqAnnotations(fileContents, rootDir);
         return {
           nodesAdded,
           nodesUpdated: 0,
@@ -1320,14 +1395,13 @@ var init_dist = __esm({
           durationMs: Date.now() - start
         };
       }
-      async processFile(filePath, rootDir, nameToFiles, fileContents) {
+      async processFile(filePath, rootDir, nameToFiles) {
         let nodesAdded = 0;
         let edgesAdded = 0;
         const relativePath = path.relative(rootDir, filePath).replace(/\\/g, "/");
         const content = await fs.readFile(filePath, "utf-8");
         const stat2 = await fs.stat(filePath);
         const fileId = `file:${relativePath}`;
-        fileContents.set(relativePath, content);
         const fileNode = {
           id: fileId,
           type: "file",
@@ -1367,7 +1441,7 @@ var init_dist = __esm({
         const entries = await fs.readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
           const fullPath = path.join(dir, entry.name);
-          if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== "dist") {
+          if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== "dist" && entry.name !== "target" && entry.name !== "build" && entry.name !== ".git" && entry.name !== "__pycache__" && entry.name !== ".venv" && entry.name !== ".turbo" && entry.name !== ".harness" && entry.name !== ".next" && entry.name !== ".vscode" && entry.name !== ".idea" && entry.name !== "vendor" && entry.name !== "out" && entry.name !== ".gradle" && entry.name !== ".gradle-home" && entry.name !== "bin" && entry.name !== "obj" && entry.name !== "venv" && entry.name !== "_build" && entry.name !== "deps" && entry.name !== "coverage" && entry.name !== ".nyc_output") {
             results.push(...await this.findSourceFiles(fullPath));
           } else if (entry.isFile() && isSupportedSourceFile(entry.name)) {
             results.push(fullPath);
@@ -1382,22 +1456,23 @@ var init_dist = __esm({
         const ctx = { className: null, classId: null, insideClass: false, braceDepth: 0 };
         for (let i = 0; i < lines.length; i++) {
           const line = lines[i];
-          if (lang === "python") {
-            this.updatePythonClassContext(lines, i, ctx);
-          }
-          if (this.tryExtractFunction(line, lines, i, fileId, relativePath, ctx, results, lang))
-            continue;
-          if (this.tryExtractClass(line, lines, i, fileId, relativePath, ctx, results, lang)) continue;
-          if (this.tryExtractInterface(line, lines, i, fileId, relativePath, ctx, results, lang))
-            continue;
-          if (this.tryEnterImplBlock(line, lang, relativePath, ctx)) continue;
-          if (lang !== "python" && this.updateClassContext(line, ctx)) continue;
-          if (this.tryExtractMethod(line, lines, i, fileId, relativePath, ctx, results, lang)) continue;
-          if (ctx.insideClass) continue;
-          this.tryExtractVariable(line, i, fileId, relativePath, results, lang);
+          this.processSymbolLine(line, lines, i, fileId, relativePath, ctx, results, lang);
         }
         return results;
       }
+      processSymbolLine(line, lines, i, fileId, relativePath, ctx, results, lang) {
+        if (lang === "python") {
+          this.updatePythonClassContext(lines, i, ctx);
+        }
+        if (this.tryExtractFunction(line, lines, i, fileId, relativePath, ctx, results, lang)) return;
+        if (this.tryExtractClass(line, lines, i, fileId, relativePath, ctx, results, lang)) return;
+        if (this.tryExtractInterface(line, lines, i, fileId, relativePath, ctx, results, lang)) return;
+        if (this.tryEnterImplBlock(line, lang, relativePath, ctx)) return;
+        if (lang !== "python" && this.updateClassContext(line, ctx)) return;
+        if (this.tryExtractMethod(line, lines, i, fileId, relativePath, ctx, results, lang)) return;
+        if (ctx.insideClass) return;
+        this.tryExtractVariable(line, i, fileId, relativePath, results, lang);
+      }
       matchFunction(line, lang) {
         if (lang === "java") return null;
         const pattern = FUNCTION_PATTERNS[lang];
@@ -1645,33 +1720,31 @@ var init_dist = __esm({
         return false;
       }
       /**
-       * Second pass: scan each file for identifiers matching known callable names,
+       * Scan a file for identifiers matching known callable names,
        * then create file-to-file "calls" edges. Uses regex heuristic (not AST).
        */
-      extractCallsEdges(nameToFiles, fileContents) {
+      extractCallsEdgesForFile(relativePath, content, nameToFiles) {
         const edges = [];
         const seen = /* @__PURE__ */ new Set();
-        for (const [filePath, content] of fileContents) {
-          const callerFileId = `file:${filePath}`;
-          const callPattern = /\b([a-zA-Z_$][\w$]*)\s*\(/g;
-          let match;
-          while ((match = callPattern.exec(content)) !== null) {
-            const name = match[1];
-            const targetFiles = nameToFiles.get(name);
-            if (!targetFiles) continue;
-            for (const targetFile of targetFiles) {
-              if (targetFile === filePath) continue;
-              const targetFileId = `file:${targetFile}`;
-              const key = `${callerFileId}|${targetFileId}`;
-              if (seen.has(key)) continue;
-              seen.add(key);
-              edges.push({
-                from: callerFileId,
-                to: targetFileId,
-                type: "calls",
-                metadata: { confidence: "regex" }
-              });
-            }
+        const callerFileId = `file:${relativePath}`;
+        const callPattern = /\b([a-zA-Z_$][\w$]*)\s*\(/g;
+        let match;
+        while ((match = callPattern.exec(content)) !== null) {
+          const name = match[1];
+          const targetFiles = nameToFiles.get(name);
+          if (!targetFiles) continue;
+          for (const targetFile of targetFiles) {
+            if (targetFile === relativePath) continue;
+            const targetFileId = `file:${targetFile}`;
+            const key = `${callerFileId}|${targetFileId}`;
+            if (seen.has(key)) continue;
+            seen.add(key);
+            edges.push({
+              from: callerFileId,
+              to: targetFileId,
+              type: "calls",
+              metadata: { confidence: "regex" }
+            });
           }
         }
         return edges;
@@ -1816,6 +1889,7 @@ var init_dist = __esm({
         if (/\.go$/.test(filePath)) return "go";
         if (/\.rs$/.test(filePath)) return "rust";
         if (/\.java$/.test(filePath)) return "java";
+        if (/\.groovy$/.test(filePath)) return "java";
         return "unknown";
       }
       /**
@@ -1823,40 +1897,38 @@ var init_dist = __esm({
        * linking requirement nodes to the annotated files.
        * Format: // @req <feature-name>#<index>
        */
-      extractReqAnnotations(fileContents, rootDir) {
+      extractReqAnnotationsForFile(filePath, content, rootDir) {
         const REQ_TAG = /(?:\/\/|#|\/\*)\s*@req\s+([\w-]+)#(\d+)/g;
         const reqNodes = this.store.findNodes({ type: "requirement" });
         let edgesAdded = 0;
-        for (const [filePath, content] of fileContents) {
-          let match;
-          REQ_TAG.lastIndex = 0;
-          while ((match = REQ_TAG.exec(content)) !== null) {
-            const featureName = match[1];
-            const reqIndex = parseInt(match[2], 10);
-            const reqNode = reqNodes.find(
-              (n) => n.metadata.featureName === featureName && n.metadata.index === reqIndex
+        let match;
+        REQ_TAG.lastIndex = 0;
+        while ((match = REQ_TAG.exec(content)) !== null) {
+          const featureName = match[1];
+          const reqIndex = parseInt(match[2], 10);
+          const reqNode = reqNodes.find(
+            (n) => n.metadata.featureName === featureName && n.metadata.index === reqIndex
+          );
+          if (!reqNode) {
+            console.warn(
+              `@req annotation references non-existent requirement: ${featureName}#${reqIndex} in ${filePath}`
             );
-            if (!reqNode) {
-              console.warn(
-                `@req annotation references non-existent requirement: ${featureName}#${reqIndex} in ${filePath}`
-              );
-              continue;
-            }
-            const relPath = path.relative(rootDir, filePath).replace(/\\/g, "/");
-            const fileNodeId = `file:${relPath}`;
-            this.store.addEdge({
-              from: reqNode.id,
-              to: fileNodeId,
-              type: "verified_by",
-              confidence: 1,
-              metadata: {
-                method: "annotation",
-                tag: `@req ${featureName}#${reqIndex}`,
-                confidence: 1
-              }
-            });
-            edgesAdded++;
+            continue;
           }
+          const relPath = path.relative(rootDir, filePath).replace(/\\/g, "/");
+          const fileNodeId = `file:${relPath}`;
+          this.store.addEdge({
+            from: reqNode.id,
+            to: fileNodeId,
+            type: "verified_by",
+            confidence: 1,
+            metadata: {
+              method: "annotation",
+              tag: `@req ${featureName}#${reqIndex}`,
+              confidence: 1
+            }
+          });
+          edgesAdded++;
         }
         return edgesAdded;
       }
@@ -2217,7 +2289,146 @@ var init_dist = __esm({
         const entries = await fs2.readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
           const fullPath = path3.join(dir, entry.name);
-          if (entry.isDirectory()) {
+          if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== "dist" && entry.name !== "target" && entry.name !== "build" && entry.name !== ".git" && entry.name !== ".gradle" && entry.name !== ".harness" && entry.name !== "vendor" && entry.name !== "bin" && entry.name !== "obj" && entry.name !== "venv" && entry.name !== "_build" && entry.name !== "deps" && entry.name !== "coverage") {
+            results.push(...await this.findMarkdownFiles(fullPath));
+          } else if (entry.isFile() && entry.name.endsWith(".md")) {
+            results.push(fullPath);
+          }
+        }
+        return results;
+      }
+    };
+    BUSINESS_KNOWLEDGE_TYPES = /* @__PURE__ */ new Set([
+      "business_rule",
+      "business_process",
+      "business_concept",
+      "business_term",
+      "business_metric"
+    ]);
+    GOVERNS_SOURCE_TYPES = /* @__PURE__ */ new Set(["business_rule", "business_process"]);
+    CODE_NODE_TYPES2 = [
+      "file",
+      "function",
+      "class",
+      "method",
+      "interface",
+      "variable"
+    ];
+    MEASURABLE_TYPES = /* @__PURE__ */ new Set(["business_process", "business_concept"]);
+    BusinessKnowledgeIngestor = class {
+      constructor(store) {
+        this.store = store;
+      }
+      store;
+      async ingest(knowledgeDir) {
+        const start = Date.now();
+        const errors = [];
+        let files;
+        try {
+          files = await this.findMarkdownFiles(knowledgeDir);
+        } catch {
+          return emptyResult(Date.now() - start);
+        }
+        const nodeEntries = await this.createNodes(files, knowledgeDir, errors);
+        const edgesAdded = this.createEdges(nodeEntries);
+        return {
+          nodesAdded: nodeEntries.length,
+          nodesUpdated: 0,
+          edgesAdded,
+          edgesUpdated: 0,
+          errors,
+          durationMs: Date.now() - start
+        };
+      }
+      async createNodes(files, knowledgeDir, errors) {
+        const entries = [];
+        for (const filePath of files) {
+          try {
+            const entry = await this.parseAndAddNode(filePath, knowledgeDir);
+            if (entry) entries.push(entry);
+          } catch (err) {
+            errors.push(`${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+          }
+        }
+        return entries;
+      }
+      async parseAndAddNode(filePath, knowledgeDir) {
+        const raw = await fs3.readFile(filePath, "utf-8");
+        const parsed = parseFrontmatter(raw);
+        if (!parsed) return null;
+        const { frontmatter, body } = parsed;
+        if (!BUSINESS_KNOWLEDGE_TYPES.has(frontmatter.type)) return null;
+        const relPath = path4.relative(knowledgeDir, filePath).replaceAll("\\", "/");
+        const domain = frontmatter.domain ?? relPath.split("/")[0] ?? "unknown";
+        const filename = path4.basename(filePath, ".md");
+        const nodeId = `bk:${domain}:${filename}`;
+        const titleMatch = body.match(/^#\s+(.+)$/m);
+        const name = titleMatch ? titleMatch[1].trim() : filename;
+        const node = {
+          id: nodeId,
+          type: frontmatter.type,
+          name,
+          path: relPath,
+          content: body.trim(),
+          metadata: {
+            domain,
+            ...frontmatter.tags && { tags: frontmatter.tags },
+            ...frontmatter.related && { related: frontmatter.related }
+          }
+        };
+        this.store.addNode(node);
+        return { nodeId, node, content: body };
+      }
+      createEdges(nodeEntries) {
+        let edgesAdded = 0;
+        for (const { nodeId, node, content } of nodeEntries) {
+          if (GOVERNS_SOURCE_TYPES.has(node.type)) {
+            edgesAdded += this.linkToNodes(content, nodeId, "governs", CODE_NODE_TYPES2);
+          } else {
+            edgesAdded += this.linkToNodes(content, nodeId, "documents", CODE_NODE_TYPES2);
+          }
+          if (node.type === "business_metric") {
+            edgesAdded += this.linkToBusinessNodes(content, nodeId, "measures", MEASURABLE_TYPES);
+          }
+        }
+        return edgesAdded;
+      }
+      linkToNodes(content, sourceNodeId, edgeType, targetTypes) {
+        let count = 0;
+        for (const nodeType of targetTypes) {
+          const nodes = this.store.findNodes({ type: nodeType });
+          for (const node of nodes) {
+            if (node.name.length < 3) continue;
+            const escaped = node.name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            const namePattern = new RegExp(`\\b${escaped}\\b`, "i");
+            if (namePattern.test(content)) {
+              this.store.addEdge({ from: sourceNodeId, to: node.id, type: edgeType });
+              count++;
+            }
+          }
+        }
+        return count;
+      }
+      linkToBusinessNodes(content, sourceNodeId, edgeType, targetTypes) {
+        let count = 0;
+        for (const node of this.store.findNodes({})) {
+          if (!targetTypes.has(node.type)) continue;
+          if (node.name.length < 3) continue;
+          const escaped = node.name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+          const namePattern = new RegExp(`\\b${escaped}\\b`, "i");
+          if (namePattern.test(content)) {
+            this.store.addEdge({ from: sourceNodeId, to: node.id, type: edgeType });
+            count++;
+          }
+        }
+        return count;
+      }
+      async findMarkdownFiles(dir) {
+        const results = [];
+        const entries = await fs3.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+          const fullPath = path4.join(dir, entry.name);
+          if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== "dist" && entry.name !== "target" && entry.name !== "build" && entry.name !== ".git" && entry.name !== ".gradle" && entry.name !== ".harness" && entry.name !== "vendor" && entry.name !== "bin" && entry.name !== "obj" && entry.name !== "venv" && entry.name !== "_build" && entry.name !== "deps" && entry.name !== "coverage") {
             results.push(...await this.findMarkdownFiles(fullPath));
           } else if (entry.isFile() && entry.name.endsWith(".md")) {
             results.push(fullPath);
@@ -2233,7 +2444,7 @@ var init_dist = __esm({
     ];
     SECTION_HEADING_RE = /^#{2,3}\s+(.+)$/;
     NUMBERED_ITEM_RE = /^\s*(\d+)\.\s+(.+)$/;
-    CODE_NODE_TYPES2 = ["file", "function", "class", "method", "interface", "variable"];
+    CODE_NODE_TYPES3 = ["file", "function", "class", "method", "interface", "variable"];
     RequirementIngestor = class {
       constructor(store) {
         this.store = store;
@@ -2251,8 +2462,8 @@ var init_dist = __esm({
         let edgesAdded = 0;
         let featureDirs;
         try {
-          const entries = await fs3.readdir(specsDir, { withFileTypes: true });
-          featureDirs = entries.filter((e) => e.isDirectory()).map((e) => path4.join(specsDir, e.name));
+          const entries = await fs4.readdir(specsDir, { withFileTypes: true });
+          featureDirs = entries.filter((e) => e.isDirectory()).map((e) => path5.join(specsDir, e.name));
         } catch {
           return emptyResult(Date.now() - start);
         }
@@ -2271,11 +2482,11 @@ var init_dist = __esm({
         };
       }
       async ingestFeatureDir(featureDir, errors) {
-        const featureName = path4.basename(featureDir);
-        const specPath = path4.join(featureDir, "proposal.md").replaceAll("\\", "/");
+        const featureName = path5.basename(featureDir);
+        const specPath = path5.join(featureDir, "proposal.md").replaceAll("\\", "/");
         let content;
         try {
-          content = await fs3.readFile(specPath, "utf-8");
+          content = await fs4.readFile(specPath, "utf-8");
         } catch {
           return { nodesAdded: 0, edgesAdded: 0 };
         }
@@ -2292,7 +2503,7 @@ var init_dist = __esm({
         this.store.addNode({
           id: specNodeId,
           type: "document",
-          name: path4.basename(specPath),
+          name: path5.basename(specPath),
           path: specPath,
           metadata: { featureName }
         });
@@ -2407,9 +2618,9 @@ var init_dist = __esm({
         for (const node of fileNodes) {
           if (!node.path) continue;
           const normalizedPath = node.path.replace(/\\/g, "/");
-          const isCodeMatch = normalizedPath.includes("packages/") && path4.basename(normalizedPath).includes(featureName);
+          const isCodeMatch = normalizedPath.includes("packages/") && path5.basename(normalizedPath).includes(featureName);
           const isTestMatch = normalizedPath.includes("/tests/") && // platform-safe
-          path4.basename(normalizedPath).includes(featureName);
+          path5.basename(normalizedPath).includes(featureName);
           if (isCodeMatch && !isTestMatch) {
             this.store.addEdge({
               from: reqId,
@@ -2438,7 +2649,7 @@ var init_dist = __esm({
        */
       linkByKeywordOverlap(reqId, reqText) {
         let count = 0;
-        for (const nodeType of CODE_NODE_TYPES2) {
+        for (const nodeType of CODE_NODE_TYPES3) {
           const codeNodes = this.store.findNodes({ type: nodeType });
           for (const node of codeNodes) {
             if (node.name.length < 3) continue;
@@ -2460,7 +2671,7 @@ var init_dist = __esm({
         return count;
       }
     };
-    CODE_NODE_TYPES3 = ["file", "function", "class", "method", "interface", "variable"];
+    CODE_NODE_TYPES4 = ["file", "function", "class", "method", "interface", "variable"];
     SANITIZE_RULES = [
       // Strip XML/HTML-like instruction tags that could be interpreted as system prompts
       {
@@ -2486,7 +2697,7 @@ var init_dist = __esm({
     SyncManager = class {
       constructor(store, graphDir) {
         this.store = store;
-        this.metadataPath = path5.join(graphDir, "sync-metadata.json");
+        this.metadataPath = path6.join(graphDir, "sync-metadata.json");
       }
       store;
       registrations = /* @__PURE__ */ new Map();
@@ -2541,15 +2752,15 @@ var init_dist = __esm({
       }
       async loadMetadata() {
         try {
-          const raw = await fs4.readFile(this.metadataPath, "utf-8");
+          const raw = await fs5.readFile(this.metadataPath, "utf-8");
           return JSON.parse(raw);
         } catch {
           return { connectors: {} };
         }
       }
       async saveMetadata(metadata) {
-        await fs4.mkdir(path5.dirname(this.metadataPath), { recursive: true });
-        await fs4.writeFile(this.metadataPath, JSON.stringify(metadata, null, 2), "utf-8");
+        await fs5.mkdir(path6.dirname(this.metadataPath), { recursive: true });
+        await fs5.writeFile(this.metadataPath, JSON.stringify(metadata, null, 2), "utf-8");
       }
     };
     JiraConnector = class {
@@ -3002,7 +3213,7 @@ var init_dist = __esm({
         return 0;
       }
     };
-    CODE_NODE_TYPES4 = ["file", "function", "class", "method", "interface", "variable"];
+    CODE_NODE_TYPES5 = ["file", "function", "class", "method", "interface", "variable"];
     GraphEntropyAdapter = class {
       constructor(store) {
         this.store = store;
@@ -3082,7 +3293,7 @@ var init_dist = __esm({
       }
       findEntryPoints() {
         const entryPoints = [];
-        for (const nodeType of CODE_NODE_TYPES4) {
+        for (const nodeType of CODE_NODE_TYPES5) {
           const nodes = this.store.findNodes({ type: nodeType });
           for (const node of nodes) {
             const isIndexFile = nodeType === "file" && node.name === "index.ts";
@@ -3118,7 +3329,7 @@ var init_dist = __esm({
       }
       collectUnreachableNodes(visited) {
         const unreachableNodes = [];
-        for (const nodeType of CODE_NODE_TYPES4) {
+        for (const nodeType of CODE_NODE_TYPES5) {
           const nodes = this.store.findNodes({ type: nodeType });
           for (const node of nodes) {
             if (!visited.has(node.id)) {
@@ -3935,9 +4146,9 @@ var init_dist = __esm({
       extractPaths(trimmed, add) {
         const consumed = /* @__PURE__ */ new Set();
         for (const match of trimmed.matchAll(FILE_PATH_RE)) {
-          const path7 = match[0];
-          add(path7);
-          consumed.add(path7);
+          const path8 = match[0];
+          add(path8);
+          consumed.add(path8);
         }
         return consumed;
       }
@@ -4007,8 +4218,8 @@ var init_dist = __esm({
           if (isPathLike && node.path.includes(raw)) {
             return { raw, nodeId: node.id, node, confidence: 0.6, method: "path" };
           }
-          const basename5 = node.path.split("/").pop() ?? "";
-          if (basename5.includes(raw)) {
+          const basename6 = node.path.split("/").pop() ?? "";
+          if (basename6.includes(raw)) {
             return { raw, nodeId: node.id, node, confidence: 0.6, method: "path" };
           }
           if (raw.length >= 4 && node.path.includes(raw)) {
@@ -4085,13 +4296,13 @@ var init_dist = __esm({
         const context = Array.isArray(d?.context) ? d.context : [];
         const firstEntity = entities[0];
         const nodeType = firstEntity?.node.type ?? "node";
-        const path7 = firstEntity?.node.path ?? "unknown";
+        const path8 = firstEntity?.node.path ?? "unknown";
         let neighborCount = 0;
         const firstContext = context[0];
         if (firstContext && Array.isArray(firstContext.nodes)) {
           neighborCount = firstContext.nodes.length;
         }
-        return `**${entityName}** is a ${nodeType} at \`${path7}\`. Connected to ${neighborCount} nodes.`;
+        return `**${entityName}** is a ${nodeType} at \`${path8}\`. Connected to ${neighborCount} nodes.`;
       }
       formatAnomaly(data) {
         const d = data;
@@ -4361,7 +4572,7 @@ var init_dist = __esm({
       debug: ["failure", "learning", "function", "method"],
       plan: ["adr", "document", "module", "layer"]
     };
-    CODE_NODE_TYPES5 = /* @__PURE__ */ new Set([
+    CODE_NODE_TYPES6 = /* @__PURE__ */ new Set([
       "file",
       "function",
       "class",
@@ -4571,7 +4782,7 @@ var init_dist = __esm({
        */
       checkCoverage() {
         const codeNodes = [];
-        for (const type of CODE_NODE_TYPES5) {
+        for (const type of CODE_NODE_TYPES6) {
           codeNodes.push(...this.store.findNodes({ type }));
         }
         const documented = [];
@@ -4622,8 +4833,8 @@ var init_dist = __esm({
         const { edges } = this.computeDependencyGraph();
         const violations = [];
         for (const edge of edges) {
-          const fromRelative = relative2(rootDir, edge.from).replaceAll("\\", "/");
-          const toRelative = relative2(rootDir, edge.to).replaceAll("\\", "/");
+          const fromRelative = relative3(rootDir, edge.from).replaceAll("\\", "/");
+          const toRelative = relative3(rootDir, edge.to).replaceAll("\\", "/");
           const fromLayer = this.resolveLayer(fromRelative, layers);
           const toLayer = this.resolveLayer(toRelative, layers);
           if (!fromLayer || !toLayer) continue;
@@ -4716,8 +4927,8 @@ var init_dist = __esm({
       async ingestAll(designDir) {
         const start = Date.now();
         const [tokensResult, intentResult] = await Promise.all([
-          this.ingestTokens(path6.join(designDir, "tokens.json")),
-          this.ingestDesignIntent(path6.join(designDir, "DESIGN.md"))
+          this.ingestTokens(path7.join(designDir, "tokens.json")),
+          this.ingestDesignIntent(path7.join(designDir, "DESIGN.md"))
         ]);
         const merged = mergeResults(tokensResult, intentResult);
         return { ...merged, durationMs: Date.now() - start };
@@ -4947,10 +5158,10 @@ var init_dist = __esm({
             includeTypes: ["file"]
           });
           for (const n of queryResult.nodes) {
-            const path7 = n.path ?? n.id.replace(/^file:/, "");
-            if (!fileSet.has(path7)) {
-              if (!result.has(path7)) {
-                result.set(path7, file);
+            const path8 = n.path ?? n.id.replace(/^file:/, "");
+            if (!fileSet.has(path8)) {
+              if (!result.has(path8)) {
+                result.set(path8, file);
               }
             }
           }
@@ -5349,6 +5560,7 @@ export {
   GitIngestor,
   TopologicalLinker,
   KnowledgeIngestor,
+  BusinessKnowledgeIngestor,
   RequirementIngestor,
   linkToCode,
   SyncManager,