@harness-engineering/cli 1.26.0 → 1.26.1

package/dist/{chunk-VV2PJT4K.js → chunk-2FPUPRCY.js}

@@ -363,13 +363,280 @@ function detectEarsPattern(text) {
   if (/^the\s+\w+\s+shall\b/.test(lower)) return "ubiquitous";
   return void 0;
 }
-function emptyMermaidResult(diagramType = "unknown") {
+function emptyResult2(diagramType = "unknown") {
   return {
     entities: [],
     relationships: [],
     metadata: { format: "mermaid", diagramType }
   };
 }
+function detectDiagramType(content) {
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    if (/^(?:graph|flowchart)\b/i.test(trimmed)) return "flowchart";
+    if (/^sequenceDiagram\b/.test(trimmed)) return "sequence";
+    if (/^classDiagram\b/.test(trimmed)) return "class";
+    if (/^erDiagram\b/.test(trimmed)) return "er";
+    break;
+  }
+  return "unknown";
+}
+function isDecisionNode(content, nodeId) {
+  const decisionRegex = new RegExp(`${nodeId}\\s*\\{`);
+  return decisionRegex.test(content);
+}
+function buildFlowchartEntity(content, match) {
+  const id = match[1] ?? "";
+  const label = (match[2] ?? "").trim();
+  if (!id) return null;
+  const decision = isDecisionNode(content, id);
+  const entity = {
+    id,
+    label,
+    ...decision ? { type: "decision" } : {}
+  };
+  return { id, entity };
+}
+function extractFlowchartNodes(content) {
+  const entities = /* @__PURE__ */ new Map();
+  const nodeRegex = /([A-Za-z0-9_]+)\s*[[({]([^\])}]+)[\])}]/g;
+  let match = nodeRegex.exec(content);
+  while (match !== null) {
+    const parsed = buildFlowchartEntity(content, match);
+    if (parsed && !entities.has(parsed.id)) {
+      entities.set(parsed.id, parsed.entity);
+    }
+    match = nodeRegex.exec(content);
+  }
+  return entities;
+}
+function parseLabeledEdgeMatch(match) {
+  const from = match[1] ?? "";
+  const label = (match[2] ?? "").trim();
+  const to = match[3] ?? "";
+  if (!from || !to) return null;
+  return { key: `${from}->${to}:${label}`, rel: { from, to, label } };
+}
+function extractLabeledEdges(stripped, edgeKeys) {
+  const relationships = [];
+  const labeledEdgeRegex = /([A-Za-z0-9_]+)\s*--+>?\|([^|]+)\|\s*([A-Za-z0-9_]+)/g;
+  let match = labeledEdgeRegex.exec(stripped);
+  while (match !== null) {
+    const parsed = parseLabeledEdgeMatch(match);
+    if (parsed && !edgeKeys.has(parsed.key)) {
+      edgeKeys.add(parsed.key);
+      relationships.push(parsed.rel);
+    }
+    match = labeledEdgeRegex.exec(stripped);
+  }
+  return relationships;
+}
+function hasLabeledEdgeBetween(labeledEdges, from, to) {
+  return labeledEdges.some((r) => r.from === from && r.to === to);
+}
+function extractUnlabeledEdges(stripped, edgeKeys, labeledEdges) {
+  const relationships = [];
+  const unlabeledEdgeRegex = /([A-Za-z0-9_]+)\s*--+>?\s+([A-Za-z0-9_]+)/g;
+  let match = unlabeledEdgeRegex.exec(stripped);
+  while (match !== null) {
+    const from = match[1] ?? "";
+    const to = match[2] ?? "";
+    const key = `${from}->${to}`;
+    if (from && to && !hasLabeledEdgeBetween(labeledEdges, from, to) && !edgeKeys.has(key)) {
+      edgeKeys.add(key);
+      relationships.push({ from, to });
+    }
+    match = unlabeledEdgeRegex.exec(stripped);
+  }
+  return relationships;
+}
+function parseFlowchart(content, diagramType) {
+  const entities = extractFlowchartNodes(content);
+  const stripped = content.replace(/[[({][^\])}]*[\])}]/g, "");
+  const edgeKeys = /* @__PURE__ */ new Set();
+  const labeledEdges = extractLabeledEdges(stripped, edgeKeys);
+  const unlabeledEdges = extractUnlabeledEdges(stripped, edgeKeys, labeledEdges);
+  return {
+    entities: Array.from(entities.values()),
+    relationships: [...labeledEdges, ...unlabeledEdges],
+    metadata: { format: "mermaid", diagramType }
+  };
+}
+function extractParticipants(content) {
+  const entities = [];
+  const seenParticipants = /* @__PURE__ */ new Set();
+  const participantRegex = /participant\s+(\w+)(?:\s+as\s+(.+))?/g;
+  let match = participantRegex.exec(content);
+  while (match !== null) {
+    const id = match[1] ?? "";
+    const label = match[2]?.trim() || id;
+    if (id && !seenParticipants.has(id)) {
+      seenParticipants.add(id);
+      entities.push({ id, label });
+    }
+    match = participantRegex.exec(content);
+  }
+  return entities;
+}
+function relationshipFromMatch(match) {
+  const from = match[1] ?? "";
+  const to = match[2] ?? "";
+  const label = (match[3] ?? "").trim();
+  return from && to ? { from, to, label } : null;
+}
+function collectMessageMatches(content, regex) {
+  const results = [];
+  let match = regex.exec(content);
+  while (match !== null) {
+    const rel = relationshipFromMatch(match);
+    if (rel) results.push(rel);
+    match = regex.exec(content);
+  }
+  return results;
+}
+function extractMessages(content) {
+  const forward = collectMessageMatches(content, /(\w+)\s*->>?\+?\s*(\w+)\s*:\s*(.+)/g);
+  const returns = collectMessageMatches(content, /(\w+)\s*-->>?-?\s*(\w+)\s*:\s*(.+)/g);
+  return [...forward, ...returns];
+}
+function parseSequence(content, diagramType) {
+  return {
+    entities: extractParticipants(content),
+    relationships: extractMessages(content),
+    metadata: { format: "mermaid", diagramType }
+  };
+}
+function emptyResult3() {
+  return {
+    entities: [],
+    relationships: [],
+    metadata: { format: "d2", diagramType: "architecture" }
+  };
+}
+function parseBlockShape(stripped) {
+  const match = stripped.match(/^([a-zA-Z0-9_-]+)\s*:\s*(.+?)\s*\{$/);
+  if (match) {
+    const id = match[1];
+    const label = match[2];
+    if (id && label) return { id, label };
+  }
+  return null;
+}
+function parseConnection(stripped) {
+  const match = stripped.match(/^([a-zA-Z0-9_.-]+)\s*->\s*([a-zA-Z0-9_.-]+)(?:\s*:\s*(.+?))?$/);
+  if (match) {
+    const from = match[1] ?? "";
+    const to = match[2] ?? "";
+    const label = match[3]?.trim();
+    if (from && to) return { from, to, ...label ? { label } : {} };
+  }
+  return null;
+}
+function parseSimpleShape(stripped) {
+  const match = stripped.match(/^([a-zA-Z0-9_-]+)\s*:\s*(.+)$/);
+  if (match) {
+    const id = match[1];
+    const label = (match[2] ?? "").trim();
+    if (id && label) return { id, label };
+  }
+  return null;
+}
+function handleBlockOpen(stripped, state) {
+  if (state.braceDepth === 0) {
+    const shape = parseBlockShape(stripped);
+    if (shape) state.entities.set(shape.id, { id: shape.id, label: shape.label });
+  }
+  state.braceDepth++;
+}
+function processTopLevelLine(stripped, state) {
+  const conn = parseConnection(stripped);
+  if (conn) {
+    state.relationships.push(conn);
+    return;
+  }
+  const shape = parseSimpleShape(stripped);
+  if (shape && !state.entities.has(shape.id)) {
+    state.entities.set(shape.id, { id: shape.id, label: shape.label });
+  }
+}
+function processD2Line(stripped, state) {
+  if (!stripped || stripped.startsWith("#")) return;
+  if (stripped.endsWith("{")) {
+    handleBlockOpen(stripped, state);
+    return;
+  }
+  if (stripped === "}") {
+    state.braceDepth = Math.max(0, state.braceDepth - 1);
+    return;
+  }
+  if (state.braceDepth > 0) return;
+  processTopLevelLine(stripped, state);
+}
+function emptyResult4() {
+  return {
+    entities: [],
+    relationships: [],
+    metadata: { format: "plantuml", diagramType: "unknown" }
+  };
+}
+function detectDiagramType2(content) {
+  if (/class\s+\w+/.test(content)) return "class";
+  if (/\[.+\]/.test(content) || /component\s+/.test(content)) return "component";
+  if (/participant\s+/.test(content) || /actor\s+/.test(content)) return "sequence";
+  return "unknown";
+}
+function stripWrappers(content) {
+  return content.replace(/@startuml\b.*\n?/, "").replace(/@enduml\b.*/, "").trim();
+}
+function extractClasses(body, entities) {
+  const classRegex = /class\s+(\w+)/g;
+  let match = classRegex.exec(body);
+  while (match !== null) {
+    const id = match[1] ?? "";
+    if (id && !entities.has(id)) {
+      entities.set(id, { id, label: id });
+    }
+    match = classRegex.exec(body);
+  }
+}
+function extractComponents(body, entities) {
+  const componentRegex = /\[([^\]]+)\]/g;
+  let match = componentRegex.exec(body);
+  while (match !== null) {
+    const label = (match[1] ?? "").trim();
+    if (label) {
+      const id = label.replace(/\s+/g, "_");
+      if (!entities.has(id)) {
+        entities.set(id, { id, label });
+      }
+    }
+    match = componentRegex.exec(body);
+  }
+}
+function parseRelationshipMatch(match) {
+  const from = match[1] ?? "";
+  const to = match[2] ?? "";
+  if (!from || !to) return null;
+  const label = match[3]?.trim();
+  return { from, to, ...label ? { label } : {} };
+}
+function collectRelationshipMatches(body, regex) {
+  const results = [];
+  let match = regex.exec(body);
+  while (match !== null) {
+    const rel = parseRelationshipMatch(match);
+    if (rel) results.push(rel);
+    match = regex.exec(body);
+  }
+  return results;
+}
+function extractRelationships(body) {
+  return collectRelationshipMatches(
+    body,
+    /(\w+)\s*(?:-->|->|<--|<-|\.\.>|--)\s*(\w+)(?:\s*:\s*(.+))?/g
+  );
+}
 function applyReactionBoost(candidate, nodeType, metadata) {
   if (nodeType !== "conversation" || !metadata.reactions) return;
   const reactions = metadata.reactions;
@@ -421,6 +688,77 @@ function classifyConflict(a, b) {
     return "temporal_conflict";
   return "status_divergence";
 }
+function buildEntry(node, source) {
+  return {
+    nodeId: node.id,
+    source,
+    name: node.name,
+    content: node.content ?? "",
+    lastModified: node.lastModified
+  };
+}
+function groupByName(nodes) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const key = node.name.toLowerCase().trim();
+    const group = byName.get(key) ?? [];
+    group.push(node);
+    byName.set(key, group);
+  }
+  return byName;
+}
+function tryAddContradiction(acc, a, b, similarity) {
+  const sourceA = a.metadata.source ?? "unknown";
+  const sourceB = b.metadata.source ?? "unknown";
+  if (sourceA === sourceB) return;
+  if ((a.hash ?? a.id) === (b.hash ?? b.id)) return;
+  const pairId = [a.id, b.id].sort().join(":");
+  if (acc.seen.has(pairId)) return;
+  acc.seen.add(pairId);
+  const conflictType = classifyConflict(a, b);
+  const pairKey = [sourceA, sourceB].sort().join("\u2194");
+  acc.sourcePairCounts[pairKey] = (acc.sourcePairCounts[pairKey] ?? 0) + 1;
+  acc.contradictions.push({
+    id: `contradiction:${a.id}:${b.id}`,
+    entityA: buildEntry(a, sourceA),
+    entityB: buildEntry(b, sourceB),
+    similarity,
+    conflictType,
+    severity: SEVERITY_MAP[conflictType],
+    description: `"${a.name}" has conflicting definitions from ${sourceA} and ${sourceB}`
+  });
+}
+function collectExactMatches(byName, acc) {
+  for (const [, group] of byName) {
+    if (group.length < 2) continue;
+    for (let i = 0; i < group.length; i++) {
+      for (let j = i + 1; j < group.length; j++) {
+        tryAddContradiction(acc, group[i], group[j], 1);
+      }
+    }
+  }
+}
+function collectFuzzyMatches(byName, acc) {
+  const keys = [...byName.keys()];
+  for (let i = 0; i < keys.length; i++) {
+    for (let j = i + 1; j < keys.length; j++) {
+      const keyA = keys[i];
+      const keyB = keys[j];
+      const maxLen = Math.max(keyA.length, keyB.length);
+      const minLen = Math.min(keyA.length, keyB.length);
+      if (minLen / maxLen < SIMILARITY_THRESHOLD) continue;
+      const ratio = levenshteinRatio(keyA, keyB);
+      if (ratio < SIMILARITY_THRESHOLD) continue;
+      const groupA = byName.get(keyA);
+      const groupB = byName.get(keyB);
+      for (const a of groupA) {
+        for (const b of groupB) {
+          tryAddContradiction(acc, a, b, ratio);
+        }
+      }
+    }
+  }
+}
 function toGrade(score) {
   if (score >= 80) return "A";
   if (score >= 60) return "B";
@@ -428,6 +766,64 @@ function toGrade(score) {
   if (score >= 20) return "D";
   return "F";
 }
+function groupByDomain(nodes, fallback) {
+  const map = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const domain = node.metadata.domain ?? fallback(node);
+    const group = map.get(domain) ?? [];
+    group.push(node);
+    map.set(domain, group);
+  }
+  return map;
+}
+function countLinkedEntities(codeEntries, store) {
+  const linkedIds = /* @__PURE__ */ new Set();
+  for (const codeNode of codeEntries) {
+    if (hasKnowledgeEdge(codeNode.id, store)) {
+      linkedIds.add(codeNode.id);
+    }
+  }
+  return linkedIds;
+}
+function hasKnowledgeEdge(nodeId, store) {
+  for (const edgeType of KNOWLEDGE_EDGE_TYPES) {
+    if (store.getEdges({ to: nodeId, type: edgeType }).length > 0) return true;
+  }
+  return false;
+}
+function computeSourceBreakdown(knEntries) {
+  const breakdown = {};
+  for (const kn of knEntries) {
+    const src = kn.metadata.source ?? "unknown";
+    breakdown[src] = (breakdown[src] ?? 0) + 1;
+  }
+  return breakdown;
+}
+function computeDomainScore(knowledgeEntries, codeEntities, linkedEntities, uniqueSources) {
+  const codeCoverageComponent = codeEntities > 0 ? linkedEntities / codeEntities * 60 : 0;
+  const knowledgeDepthComponent = Math.min(knowledgeEntries / 10, 1) * 20;
+  const sourceDiversityComponent = Math.min(uniqueSources / 3, 1) * 20;
+  return Math.round(codeCoverageComponent + knowledgeDepthComponent + sourceDiversityComponent);
+}
+function scoreDomain(domain, knEntries, codeEntries, store) {
+  const linkedIds = countLinkedEntities(codeEntries, store);
+  const sourceBreakdown = computeSourceBreakdown(knEntries);
+  const codeEntities = codeEntries.length;
+  const linkedEntities = linkedIds.size;
+  const knowledgeEntries = knEntries.length;
+  const uniqueSources = Object.keys(sourceBreakdown).length;
+  const score = computeDomainScore(knowledgeEntries, codeEntities, linkedEntities, uniqueSources);
+  return {
+    domain,
+    score,
+    knowledgeEntries,
+    codeEntities,
+    linkedEntities,
+    unlinkedEntities: codeEntities - linkedEntities,
+    sourceBreakdown,
+    grade: toGrade(score)
+  };
+}
 function withRetry(client, options) {
   const maxRetries = options?.maxRetries ?? 3;
   const baseDelayMs = options?.baseDelayMs ?? 1e3;
@@ -582,7 +978,7 @@ function missingApiKeyResult(envVar, start) {
     durationMs: Date.now() - start
   };
 }
-function emptyResult2(errors, start) {
+function emptyResult5(errors, start) {
   return {
     nodesAdded: 0,
     nodesUpdated: 0,
@@ -641,6 +1037,14 @@ function hasConstraintKeyword(text) {
   const lower = text.toLowerCase();
   return CONSTRAINT_KEYWORDS.some((kw) => lower.includes(kw));
 }
+function buildNodeMetadata(condensed, base) {
+  const metadata = { ...base };
+  if (condensed.method !== "passthrough") {
+    metadata.condensed = condensed.method;
+    metadata.originalLength = condensed.originalLength;
+  }
+  return metadata;
+}
 function buildIngestResult2(nodesAdded, edgesAdded, errors, start) {
   return {
     nodesAdded,
@@ -651,6 +1055,24 @@ function buildIngestResult2(nodesAdded, edgesAdded, errors, start) {
     durationMs: Date.now() - start
   };
 }
+function validateFigmaConfig(config) {
+  const apiKeyEnv = config.apiKeyEnv ?? "FIGMA_API_KEY";
+  const apiKey = process.env[apiKeyEnv];
+  if (!apiKey) return { error: `Missing API key: environment variable "${apiKeyEnv}" is not set` };
+  const baseUrlEnv = config.baseUrlEnv ?? "FIGMA_BASE_URL";
+  const baseUrl = process.env[baseUrlEnv] ?? "https://api.figma.com";
+  try {
+    const parsed = new URL(baseUrl);
+    if (parsed.protocol !== "https:" || !parsed.hostname.endsWith("api.figma.com")) {
+      return { error: `Invalid ${baseUrlEnv}: must be an HTTPS URL on api.figma.com` };
+    }
+  } catch {
+    return { error: `Invalid ${baseUrlEnv}: not a valid URL` };
+  }
+  const fileIds = config.fileIds;
+  if (!fileIds || fileIds.length === 0) return { error: "No fileIds provided in connector config" };
+  return { apiKey, baseUrl, fileIds };
+}
 function stripHtml(html) {
   return html.replace(/<[^>]*>/g, "");
 }
@@ -664,6 +1086,46 @@ function buildIngestResult3(nodesAdded, edgesAdded, errors, start) {
     durationMs: Date.now() - start
   };
 }
+function validateBaseUrl(baseUrl, baseUrlEnv) {
+  try {
+    const parsed = new URL(baseUrl);
+    if (parsed.protocol !== "https:" || parsed.hostname !== "api.miro.com") {
+      return `Invalid ${baseUrlEnv}: must be an HTTPS URL on api.miro.com`;
+    }
+  } catch {
+    return `Invalid ${baseUrlEnv}: not a valid URL`;
+  }
+  return null;
+}
+function resolveConfig(config, start) {
+  const apiKeyEnv = config.apiKeyEnv ?? "MIRO_API_KEY";
+  const apiKey = process.env[apiKeyEnv];
+  if (!apiKey) {
+    return {
+      ok: false,
+      result: buildIngestResult3(
+        0,
+        0,
+        [`Missing API key: environment variable "${apiKeyEnv}" is not set`],
+        start
+      )
+    };
+  }
+  const baseUrlEnv = config.baseUrlEnv ?? "MIRO_BASE_URL";
+  const baseUrl = process.env[baseUrlEnv] ?? "https://api.miro.com";
+  const urlError = validateBaseUrl(baseUrl, baseUrlEnv);
+  if (urlError) {
+    return { ok: false, result: buildIngestResult3(0, 0, [urlError], start) };
+  }
+  const boardIds = config.boardIds;
+  if (!boardIds || boardIds.length === 0) {
+    return {
+      ok: false,
+      result: buildIngestResult3(0, 0, ["No boardIds provided in config"], start)
+    };
+  }
+  return { ok: true, apiKey, baseUrl, boardIds, headers: { Authorization: `Bearer ${apiKey}` } };
+}
 function isSkippableWord(cleaned, allConsumed) {
   if (allConsumed.has(cleaned)) return true;
   const lower = cleaned.toLowerCase();
@@ -973,7 +1435,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, BUSINESS_KNOWLEDGE_TYPES, GOVERNS_SOURCE_TYPES, CODE_NODE_TYPES2, MEASURABLE_TYPES, BusinessKnowledgeIngestor, REQUIREMENT_SECTIONS, SECTION_HEADING_RE, NUMBERED_ITEM_RE, CODE_NODE_TYPES3, RequirementIngestor, MermaidParser, D2Parser, PlantUmlParser, DIAGRAM_EXTENSIONS, DiagramParser, HEURISTIC_PATTERNS, SCANNABLE_TYPES, KnowledgeLinker, StructuralDriftDetector, KnowledgeStagingAggregator, SKIP_DIRS, EXT_TO_LANGUAGE, SKIP_EXTENSIONS2, EXTRACTOR_EDGE_TYPE, ExtractionRunner, PATTERNS, TestDescriptionExtractor, EnumConstantExtractor, ValidationRuleExtractor, ApiPathExtractor, ALL_EXTRACTORS, ImageAnalysisExtractor, KNOWLEDGE_NODE_TYPES, SIMILARITY_THRESHOLD, ContradictionDetector, KNOWLEDGE_TYPES, CODE_TYPES2, KNOWLEDGE_EDGE_TYPES, CoverageScorer, BUSINESS_NODE_TYPES, SNAPSHOT_NODE_TYPES, KnowledgePipelineRunner, CODE_NODE_TYPES4, RETRYABLE_STATUSES, SANITIZE_RULES, SyncManager, SUMMARIZE_PROMPT, JiraConnector, SlackConnector, ConfluenceConnector, CIConnector, CONSTRAINT_KEYWORDS, FigmaConnector, MIN_CONTENT_LENGTH, CONCEPT_ITEM_TYPES, MiroConnector, 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 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, MermaidParser, D2Parser, PlantUmlParser, DIAGRAM_EXTENSIONS, SKIP_DIRS, DiagramParser, HEURISTIC_PATTERNS, SCANNABLE_TYPES, KnowledgeLinker, StructuralDriftDetector, KnowledgeStagingAggregator, SKIP_DIRS2, EXT_TO_LANGUAGE, SKIP_EXTENSIONS2, EXTRACTOR_EDGE_TYPE, ExtractionRunner, PATTERNS, TestDescriptionExtractor, EnumConstantExtractor, ValidationRuleExtractor, ApiPathExtractor, ALL_EXTRACTORS, ImageAnalysisExtractor, KNOWLEDGE_NODE_TYPES, SIMILARITY_THRESHOLD, SEVERITY_MAP, ContradictionDetector, KNOWLEDGE_TYPES, CODE_TYPES2, KNOWLEDGE_EDGE_TYPES, CoverageScorer, BUSINESS_NODE_TYPES, SNAPSHOT_NODE_TYPES, KnowledgePipelineRunner, CODE_NODE_TYPES4, RETRYABLE_STATUSES, SANITIZE_RULES, SyncManager, SUMMARIZE_PROMPT, JiraConnector, SlackConnector, ConfluenceConnector, CIConnector, CONSTRAINT_KEYWORDS, FigmaConnector, MIN_CONTENT_LENGTH, CONCEPT_ITEM_TYPES, MiroConnector, 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 = [
@@ -2872,137 +3334,17 @@ var init_dist = __esm({
       parse(content, _filePath) {
         const trimmed = content.trim();
         if (!trimmed) {
-          return emptyMermaidResult();
+          return emptyResult2();
         }
-        const diagramType = this.detectDiagramType(trimmed);
+        const diagramType = detectDiagramType(trimmed);
         switch (diagramType) {
           case "flowchart":
-            return this.parseFlowchart(trimmed, diagramType);
+            return parseFlowchart(trimmed, diagramType);
           case "sequence":
-            return this.parseSequence(trimmed, diagramType);
+            return parseSequence(trimmed, diagramType);
           default:
-            return emptyMermaidResult(diagramType);
-        }
-      }
-      detectDiagramType(content) {
-        const lines = content.split("\n");
-        for (const line of lines) {
-          const trimmedLine = line.trim();
-          if (!trimmedLine) continue;
-          if (/^(?:graph|flowchart)\b/i.test(trimmedLine)) return "flowchart";
-          if (/^sequenceDiagram\b/.test(trimmedLine)) return "sequence";
-          if (/^classDiagram\b/.test(trimmedLine)) return "class";
-          if (/^erDiagram\b/.test(trimmedLine)) return "er";
-          break;
-        }
-        return "unknown";
-      }
-      parseFlowchart(content, diagramType) {
-        const entities = /* @__PURE__ */ new Map();
-        const relationships = [];
-        const nodeRegex = /([A-Za-z0-9_]+)\s*[[({]([^\])}]+)[\])}]/g;
-        let match;
-        match = nodeRegex.exec(content);
-        while (match !== null) {
-          const id = match[1] ?? "";
-          const label = (match[2] ?? "").trim();
-          if (id && !entities.has(id)) {
-            const isDecision = this.isDecisionNode(content, id);
-            entities.set(id, {
-              id,
-              label,
-              ...isDecision ? { type: "decision" } : {}
-            });
-          }
-          match = nodeRegex.exec(content);
-        }
-        const stripped = content.replace(/[[({][^\])}]*[\])}]/g, "");
-        const labeledEdgeRegex = /([A-Za-z0-9_]+)\s*--+>?\|([^|]+)\|\s*([A-Za-z0-9_]+)/g;
-        const unlabeledEdgeRegex = /([A-Za-z0-9_]+)\s*--+>?\s+([A-Za-z0-9_]+)/g;
-        const edgeKeys = /* @__PURE__ */ new Set();
-        match = labeledEdgeRegex.exec(stripped);
-        while (match !== null) {
-          const from = match[1] ?? "";
-          const label = (match[2] ?? "").trim();
-          const to = match[3] ?? "";
-          if (from && to) {
-            const key = `${from}->${to}:${label}`;
-            if (!edgeKeys.has(key)) {
-              edgeKeys.add(key);
-              relationships.push({ from, to, label });
-            }
-          }
-          match = labeledEdgeRegex.exec(stripped);
-        }
-        match = unlabeledEdgeRegex.exec(stripped);
-        while (match !== null) {
-          const from = match[1] ?? "";
-          const to = match[2] ?? "";
-          if (from && to) {
-            const hasLabeled = relationships.some((r) => r.from === from && r.to === to);
-            if (!hasLabeled) {
-              const key = `${from}->${to}`;
-              if (!edgeKeys.has(key)) {
-                edgeKeys.add(key);
-                relationships.push({ from, to });
-              }
-            }
-          }
-          match = unlabeledEdgeRegex.exec(stripped);
-        }
-        return {
-          entities: Array.from(entities.values()),
-          relationships,
-          metadata: { format: "mermaid", diagramType }
-        };
-      }
-      isDecisionNode(content, nodeId) {
-        const decisionRegex = new RegExp(`${nodeId}\\s*\\{`);
-        return decisionRegex.test(content);
-      }
-      parseSequence(content, diagramType) {
-        const entities = [];
-        const relationships = [];
-        const seenParticipants = /* @__PURE__ */ new Set();
-        const participantRegex = /participant\s+(\w+)(?:\s+as\s+(.+))?/g;
-        let match;
-        match = participantRegex.exec(content);
-        while (match !== null) {
-          const id = match[1] ?? "";
-          const label = match[2]?.trim() || id;
-          if (id && !seenParticipants.has(id)) {
-            seenParticipants.add(id);
-            entities.push({ id, label });
-          }
-          match = participantRegex.exec(content);
-        }
-        const forwardMsgRegex = /(\w+)\s*->>?\+?\s*(\w+)\s*:\s*(.+)/g;
-        match = forwardMsgRegex.exec(content);
-        while (match !== null) {
-          const from = match[1] ?? "";
-          const to = match[2] ?? "";
-          const label = (match[3] ?? "").trim();
-          if (from && to) {
-            relationships.push({ from, to, label });
-          }
-          match = forwardMsgRegex.exec(content);
-        }
-        const returnMsgRegex = /(\w+)\s*-->>?-?\s*(\w+)\s*:\s*(.+)/g;
-        match = returnMsgRegex.exec(content);
-        while (match !== null) {
-          const from = match[1] ?? "";
-          const to = match[2] ?? "";
-          const label = (match[3] ?? "").trim();
-          if (from && to) {
-            relationships.push({ from, to, label });
-          }
-          match = returnMsgRegex.exec(content);
+            return emptyResult2(diagramType);
         }
-        return {
-          entities,
-          relationships,
-          metadata: { format: "mermaid", diagramType }
-        };
       }
     };
     D2Parser = class {
@@ -3011,62 +3353,18 @@ var init_dist = __esm({
       }
       parse(content, _filePath) {
         const trimmed = content.trim();
-        if (!trimmed) {
-          return {
-            entities: [],
-            relationships: [],
-            metadata: { format: "d2", diagramType: "architecture" }
-          };
-        }
-        const entities = /* @__PURE__ */ new Map();
-        const relationships = [];
-        let braceDepth = 0;
+        if (!trimmed) return emptyResult3();
+        const state = {
+          entities: /* @__PURE__ */ new Map(),
+          relationships: [],
+          braceDepth: 0
+        };
         for (const line of trimmed.split("\n")) {
-          const stripped = line.trim();
-          if (!stripped || stripped.startsWith("#")) continue;
-          if (stripped.endsWith("{")) {
-            if (braceDepth === 0) {
-              const shapeMatch = stripped.match(/^([a-zA-Z0-9_-]+)\s*:\s*(.+?)\s*\{$/);
-              if (shapeMatch) {
-                const id = shapeMatch[1];
-                const label = shapeMatch[2];
-                if (id && label) {
-                  entities.set(id, { id, label });
-                }
-              }
-            }
-            braceDepth++;
-            continue;
-          }
-          if (stripped === "}") {
-            braceDepth = Math.max(0, braceDepth - 1);
-            continue;
-          }
-          if (braceDepth > 0) continue;
-          const connMatch = stripped.match(
-            /^([a-zA-Z0-9_.-]+)\s*->\s*([a-zA-Z0-9_.-]+)(?:\s*:\s*(.+?))?$/
-          );
-          if (connMatch) {
-            const from = connMatch[1] ?? "";
-            const to = connMatch[2] ?? "";
-            const label = connMatch[3]?.trim();
-            if (from && to) {
-              relationships.push({ from, to, ...label ? { label } : {} });
-            }
-            continue;
-          }
-          const simpleMatch = stripped.match(/^([a-zA-Z0-9_-]+)\s*:\s*(.+)$/);
-          if (simpleMatch) {
-            const id = simpleMatch[1];
-            const label = (simpleMatch[2] ?? "").trim();
-            if (id && label && !entities.has(id)) {
-              entities.set(id, { id, label });
-            }
-          }
+          processD2Line(line.trim(), state);
         }
         return {
-          entities: Array.from(entities.values()),
-          relationships,
+          entities: Array.from(state.entities.values()),
+          relationships: state.relationships,
           metadata: { format: "d2", diagramType: "architecture" }
         };
       }
@@ -3077,64 +3375,22 @@ var init_dist = __esm({
       }
       parse(content, _filePath) {
         const trimmed = content.trim();
-        if (!trimmed) {
-          return {
-            entities: [],
-            relationships: [],
-            metadata: { format: "plantuml", diagramType: "unknown" }
-          };
-        }
-        const diagramType = this.detectDiagramType(trimmed);
+        if (!trimmed) return emptyResult4();
+        const diagramType = detectDiagramType2(trimmed);
         const entities = /* @__PURE__ */ new Map();
-        const relationships = [];
-        const body = trimmed.replace(/@startuml\b.*\n?/, "").replace(/@enduml\b.*/, "").trim();
-        const classRegex = /class\s+(\w+)/g;
-        let match;
-        match = classRegex.exec(body);
-        while (match !== null) {
-          const id = match[1] ?? "";
-          if (id && !entities.has(id)) {
-            entities.set(id, { id, label: id });
-          }
-          match = classRegex.exec(body);
-        }
-        const componentRegex1 = /\[([^\]]+)\]/g;
-        match = componentRegex1.exec(body);
-        while (match !== null) {
-          const label = (match[1] ?? "").trim();
-          if (label) {
-            const id = label.replace(/\s+/g, "_");
-            if (!entities.has(id)) {
-              entities.set(id, { id, label });
-            }
-          }
-          match = componentRegex1.exec(body);
-        }
-        const relRegex = /(\w+)\s*(?:-->|->|<--|<-|\.\.>|--)\s*(\w+)(?:\s*:\s*(.+))?/g;
-        match = relRegex.exec(body);
-        while (match !== null) {
-          const from = match[1] ?? "";
-          const to = match[2] ?? "";
-          const label = match[3]?.trim();
-          if (from && to) {
-            relationships.push({ from, to, ...label ? { label } : {} });
-          }
-          match = relRegex.exec(body);
-        }
+        const body = stripWrappers(trimmed);
+        extractClasses(body, entities);
+        extractComponents(body, entities);
+        const relationships = extractRelationships(body);
         return {
           entities: Array.from(entities.values()),
           relationships,
           metadata: { format: "plantuml", diagramType }
         };
       }
-      detectDiagramType(content) {
-        if (/class\s+\w+/.test(content)) return "class";
-        if (/\[.+\]/.test(content) || /component\s+/.test(content)) return "component";
-        if (/participant\s+/.test(content) || /actor\s+/.test(content)) return "sequence";
-        return "unknown";
-      }
     };
     DIAGRAM_EXTENSIONS = /* @__PURE__ */ new Set([".mmd", ".mermaid", ".d2", ".puml", ".plantuml"]);
+    SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", ".harness"]);
     DiagramParser = class {
       constructor(store) {
         this.store = store;
@@ -3171,36 +3427,8 @@ var init_dist = __esm({
             const result = this.parse(content, filePath);
             if (result.entities.length === 0) continue;
             const pathHash = hash(relPath);
-            for (const entity of result.entities) {
-              const nodeId = `diagram:${pathHash}:${entity.id}`;
-              this.store.addNode({
-                id: nodeId,
-                type: "business_concept",
-                name: entity.label,
-                path: relPath,
-                metadata: {
-                  source: "diagram",
-                  format: result.metadata.format,
-                  diagramType: result.metadata.diagramType,
-                  confidence: 0.85,
-                  ...entity.type ? { entityType: entity.type } : {}
-                }
-              });
-              nodesAdded++;
-            }
-            for (const rel of result.relationships) {
-              const fromId = `diagram:${pathHash}:${rel.from}`;
-              const toId = `diagram:${pathHash}:${rel.to}`;
-              this.store.addEdge({
-                from: fromId,
-                to: toId,
-                type: "references",
-                metadata: {
-                  ...rel.label ? { label: rel.label } : {}
-                }
-              });
-              edgesAdded++;
-            }
+            nodesAdded += this.addEntityNodes(result, relPath, pathHash);
+            edgesAdded += this.addRelationshipEdges(result, pathHash);
           } catch (err) {
             errors.push(
               `Failed to parse ${filePath}: ${err instanceof Error ? err.message : String(err)}`
@@ -3216,9 +3444,48 @@ var init_dist = __esm({
           durationMs: Date.now() - start
         };
       }
+      /** Map diagram entities to business_concept graph nodes. */
+      addEntityNodes(result, relPath, pathHash) {
+        let count = 0;
+        for (const entity of result.entities) {
+          const nodeId = `diagram:${pathHash}:${entity.id}`;
+          this.store.addNode({
+            id: nodeId,
+            type: "business_concept",
+            name: entity.label,
+            path: relPath,
+            metadata: {
+              source: "diagram",
+              format: result.metadata.format,
+              diagramType: result.metadata.diagramType,
+              confidence: 0.85,
+              ...entity.type ? { entityType: entity.type } : {}
+            }
+          });
+          count++;
+        }
+        return count;
+      }
+      /** Map diagram relationships to references graph edges. */
+      addRelationshipEdges(result, pathHash) {
+        let count = 0;
+        for (const rel of result.relationships) {
+          const fromId = `diagram:${pathHash}:${rel.from}`;
+          const toId = `diagram:${pathHash}:${rel.to}`;
+          this.store.addEdge({
+            from: fromId,
+            to: toId,
+            type: "references",
+            metadata: {
+              ...rel.label ? { label: rel.label } : {}
+            }
+          });
+          count++;
+        }
+        return count;
+      }
       async findDiagramFiles(dir) {
         const files = [];
-        const SKIP_DIRS2 = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", ".harness"]);
         const walk = async (currentDir) => {
           let entries;
           try {
@@ -3228,7 +3495,7 @@ var init_dist = __esm({
           }
           for (const entry of entries) {
             if (entry.isDirectory()) {
-              if (!SKIP_DIRS2.has(entry.name)) {
+              if (!SKIP_DIRS.has(entry.name)) {
                 await walk(path6.join(currentDir, entry.name));
               }
             } else if (entry.isFile()) {
@@ -3620,7 +3887,7 @@ var init_dist = __esm({
         await fs7.writeFile(path8.join(gapsDir, "gaps.md"), lines.join("\n"), "utf-8");
       }
     };
-    SKIP_DIRS = /* @__PURE__ */ new Set([
+    SKIP_DIRS2 = /* @__PURE__ */ new Set([
       "node_modules",
       "dist",
       "target",
@@ -3815,7 +4082,7 @@ var init_dist = __esm({
         }
         for (const entry of entries) {
           const fullPath = path9.join(dir, entry.name);
-          if (entry.isDirectory() && !SKIP_DIRS.has(entry.name)) {
+          if (entry.isDirectory() && !SKIP_DIRS2.has(entry.name)) {
             results.push(...await this.findSourceFiles(fullPath));
           } else if (entry.isFile() && detectLanguage(fullPath) !== void 0) {
             results.push(fullPath);
@@ -4926,57 +5193,9 @@ var init_dist = __esm({
         const errors = [];
         for (const imagePath of imagePaths) {
           try {
-            const response = await this.provider.analyze({
-              prompt: "Analyze this image and provide a structured description of its visual contents.",
-              systemPrompt: "You are an image analysis assistant. Describe the image contents, detect UI elements, extract visible text, identify design patterns, and note accessibility concerns.",
-              responseSchema: {},
-              // Schema handled by provider
-              maxTokens: 1e3
-            });
-            const result = response.result;
-            const pathHash = hash(imagePath);
-            const annotationId = `img:${pathHash}`;
-            store.addNode({
-              id: annotationId,
-              type: "image_annotation",
-              name: result.description.slice(0, 200),
-              path: imagePath,
-              content: result.description,
-              hash: hash(result.description),
-              metadata: {
-                source: "image-analysis",
-                detectedElements: result.detectedElements,
-                extractedText: result.extractedText,
-                designPatterns: result.designPatterns,
-                accessibilityNotes: result.accessibilityNotes,
-                model: response.model
-              }
-            });
-            nodesAdded++;
-            const fileNodes = store.findNodes({ type: "file" });
-            const fileNode = fileNodes.find((n) => n.path === imagePath);
-            if (fileNode) {
-              store.addEdge({ from: annotationId, to: fileNode.id, type: "annotates" });
-              edgesAdded++;
-            }
-            for (const pattern of result.designPatterns) {
-              const conceptId = `img:concept:${hash(pattern + imagePath)}`;
-              store.addNode({
-                id: conceptId,
-                type: "business_concept",
-                name: pattern,
-                content: `Design pattern detected in ${imagePath}: ${pattern}`,
-                hash: hash(pattern),
-                metadata: {
-                  source: "image-analysis",
-                  sourceImage: imagePath,
-                  domain: "design"
-                }
-              });
-              nodesAdded++;
-              store.addEdge({ from: annotationId, to: conceptId, type: "contains" });
-              edgesAdded++;
-            }
+            const counts = await this.processImage(store, imagePath);
+            nodesAdded += counts.nodes;
+            edgesAdded += counts.edges;
           } catch (err) {
             errors.push(
               `Image analysis failed for ${imagePath}: ${err instanceof Error ? err.message : String(err)}`
@@ -4992,6 +5211,68 @@ var init_dist = __esm({
           durationMs: Date.now() - start
         };
       }
+      /** Analyze a single image and add annotation + concept nodes to the store. */
+      async processImage(store, imagePath) {
+        const response = await this.provider.analyze({
+          prompt: "Analyze this image and provide a structured description of its visual contents.",
+          systemPrompt: "You are an image analysis assistant. Describe the image contents, detect UI elements, extract visible text, identify design patterns, and note accessibility concerns.",
+          responseSchema: {},
+          // Schema handled by provider
+          maxTokens: 1e3
+        });
+        const result = response.result;
+        const annotationId = `img:${hash(imagePath)}`;
+        let nodes = 0;
+        let edges = 0;
+        store.addNode({
+          id: annotationId,
+          type: "image_annotation",
+          name: result.description.slice(0, 200),
+          path: imagePath,
+          content: result.description,
+          hash: hash(result.description),
+          metadata: {
+            source: "image-analysis",
+            detectedElements: result.detectedElements,
+            extractedText: result.extractedText,
+            designPatterns: result.designPatterns,
+            accessibilityNotes: result.accessibilityNotes,
+            model: response.model
+          }
+        });
+        nodes++;
+        edges += this.linkToFileNode(store, annotationId, imagePath);
+        for (const pattern of result.designPatterns) {
+          edges += this.addDesignPatternConcept(store, annotationId, imagePath, pattern);
+          nodes++;
+        }
+        return { nodes, edges };
+      }
+      /** Link annotation to its source file node if it exists. Returns 1 if linked, 0 otherwise. */
+      linkToFileNode(store, annotationId, imagePath) {
+        const fileNode = store.findNodes({ type: "file" }).find((n) => n.path === imagePath);
+        if (!fileNode) return 0;
+        store.addEdge({ from: annotationId, to: fileNode.id, type: "annotates" });
+        return 1;
+      }
+      /** Create a business_concept node for a design pattern and link it. Returns edges added. */
+      addDesignPatternConcept(store, annotationId, imagePath, pattern) {
+        const conceptId = `img:concept:${hash(pattern + imagePath)}`;
+        store.addNode({
+          id: conceptId,
+          type: "business_concept",
+          name: pattern,
+          content: `Design pattern detected in ${imagePath}: ${pattern}`,
+          hash: hash(pattern),
+          metadata: {
+            source: "image-analysis",
+            sourceImage: imagePath,
+            domain: "design"
+          }
+        });
+        store.addEdge({ from: annotationId, to: conceptId, type: "contains" });
+        return 1;
+      }
     };
     KNOWLEDGE_NODE_TYPES = [
       "business_fact",
@@ -5006,83 +5287,28 @@ var init_dist = __esm({
       "image_annotation"
     ];
     SIMILARITY_THRESHOLD = 0.8;
+    SEVERITY_MAP = {
+      value_mismatch: "critical",
+      definition_conflict: "high",
+      status_divergence: "medium",
+      temporal_conflict: "medium"
+    };
     ContradictionDetector = class {
       detect(store) {
         const nodes = KNOWLEDGE_NODE_TYPES.flatMap((t) => store.findNodes({ type: t }));
-        const byName = /* @__PURE__ */ new Map();
-        for (const node of nodes) {
-          const key = node.name.toLowerCase().trim();
-          const group = byName.get(key) ?? [];
-          group.push(node);
-          byName.set(key, group);
-        }
-        const contradictions = [];
-        const sourcePairCounts = {};
-        const seen = /* @__PURE__ */ new Set();
-        const addContradiction = (a, b, similarity) => {
-          const sourceA = a.metadata.source ?? "unknown";
-          const sourceB = b.metadata.source ?? "unknown";
-          if (sourceA === sourceB) return;
-          const hashA = a.hash ?? a.id;
-          const hashB = b.hash ?? b.id;
-          if (hashA === hashB) return;
-          const pairId = [a.id, b.id].sort().join(":");
-          if (seen.has(pairId)) return;
-          seen.add(pairId);
-          const conflictType = classifyConflict(a, b);
-          const severity = conflictType === "value_mismatch" ? "critical" : conflictType === "definition_conflict" ? "high" : "medium";
-          const pairKey = [sourceA, sourceB].sort().join("\u2194");
-          sourcePairCounts[pairKey] = (sourcePairCounts[pairKey] ?? 0) + 1;
-          contradictions.push({
-            id: `contradiction:${a.id}:${b.id}`,
-            entityA: {
-              nodeId: a.id,
-              source: sourceA,
-              name: a.name,
-              content: a.content ?? "",
-              lastModified: a.lastModified
-            },
-            entityB: {
-              nodeId: b.id,
-              source: sourceB,
-              name: b.name,
-              content: b.content ?? "",
-              lastModified: b.lastModified
-            },
-            similarity,
-            conflictType,
-            severity,
-            description: `"${a.name}" has conflicting definitions from ${sourceA} and ${sourceB}`
-          });
+        const byName = groupByName(nodes);
+        const acc = {
+          contradictions: [],
+          sourcePairCounts: {},
+          seen: /* @__PURE__ */ new Set()
+        };
+        collectExactMatches(byName, acc);
+        collectFuzzyMatches(byName, acc);
+        return {
+          contradictions: acc.contradictions,
+          sourcePairCounts: acc.sourcePairCounts,
+          totalChecked: nodes.length
         };
-        for (const [, group] of byName) {
-          if (group.length < 2) continue;
-          for (let i = 0; i < group.length; i++) {
-            for (let j = i + 1; j < group.length; j++) {
-              addContradiction(group[i], group[j], 1);
-            }
-          }
-        }
-        const keys = [...byName.keys()];
-        for (let i = 0; i < keys.length; i++) {
-          for (let j = i + 1; j < keys.length; j++) {
-            const keyA = keys[i];
-            const keyB = keys[j];
-            const maxLen = Math.max(keyA.length, keyB.length);
-            const minLen = Math.min(keyA.length, keyB.length);
-            if (minLen / maxLen < SIMILARITY_THRESHOLD) continue;
-            const ratio = levenshteinRatio(keyA, keyB);
-            if (ratio < SIMILARITY_THRESHOLD) continue;
-            const groupA = byName.get(keyA);
-            const groupB = byName.get(keyB);
-            for (const a of groupA) {
-              for (const b of groupB) {
-                addContradiction(a, b, ratio);
-              }
-            }
-          }
-        }
-        return { contradictions, sourcePairCounts, totalChecked: nodes.length };
       }
     };
     KNOWLEDGE_TYPES = KNOWLEDGE_NODE_TYPES;
@@ -5107,61 +5333,15 @@ var init_dist = __esm({
     CoverageScorer = class {
       score(store) {
         const knowledgeNodes = KNOWLEDGE_TYPES.flatMap((t) => store.findNodes({ type: t }));
-        const domainMap = /* @__PURE__ */ new Map();
-        for (const node of knowledgeNodes) {
-          const domain = node.metadata.domain ?? "unclassified";
-          const group = domainMap.get(domain) ?? [];
-          group.push(node);
-          domainMap.set(domain, group);
-        }
+        const domainMap = groupByDomain(knowledgeNodes, () => "unclassified");
         const codeNodes = CODE_TYPES2.flatMap((t) => store.findNodes({ type: t }));
-        const codeDomains = /* @__PURE__ */ new Map();
-        for (const node of codeNodes) {
-          const domain = node.metadata.domain ?? this.domainFromPath(node.path);
-          const group = codeDomains.get(domain) ?? [];
-          group.push(node);
-          codeDomains.set(domain, group);
-        }
+        const codeDomains = groupByDomain(codeNodes, (n) => this.domainFromPath(n.path));
         const allDomains = /* @__PURE__ */ new Set([...domainMap.keys(), ...codeDomains.keys()]);
         const domains = [];
         for (const domain of allDomains) {
-          const knEntries = domainMap.get(domain) ?? [];
-          const codeEntries = codeDomains.get(domain) ?? [];
-          const linkedIds = /* @__PURE__ */ new Set();
-          for (const codeNode of codeEntries) {
-            for (const edgeType of KNOWLEDGE_EDGE_TYPES) {
-              const edges = store.getEdges({ to: codeNode.id, type: edgeType });
-              if (edges.length > 0) {
-                linkedIds.add(codeNode.id);
-                break;
-              }
-            }
-          }
-          const sourceBreakdown = {};
-          for (const kn of knEntries) {
-            const src = kn.metadata.source ?? "unknown";
-            sourceBreakdown[src] = (sourceBreakdown[src] ?? 0) + 1;
-          }
-          const codeEntities = codeEntries.length;
-          const linkedEntities = linkedIds.size;
-          const knowledgeEntries = knEntries.length;
-          const uniqueSources = Object.keys(sourceBreakdown).length;
-          const codeCoverageComponent = codeEntities > 0 ? linkedEntities / codeEntities * 60 : 0;
-          const knowledgeDepthComponent = Math.min(knowledgeEntries / 10, 1) * 20;
-          const sourceDiversityComponent = Math.min(uniqueSources / 3, 1) * 20;
-          const score = Math.round(
-            codeCoverageComponent + knowledgeDepthComponent + sourceDiversityComponent
+          domains.push(
+            scoreDomain(domain, domainMap.get(domain) ?? [], codeDomains.get(domain) ?? [], store)
           );
-          domains.push({
-            domain,
-            score,
-            knowledgeEntries,
-            codeEntities,
-            linkedEntities,
-            unlinkedEntities: codeEntities - linkedEntities,
-            sourceBreakdown,
-            grade: toGrade(score)
-          });
         }
         const overallScore = domains.length > 0 ? Math.round(domains.reduce((sum, d) => sum + d.score, 0) / domains.length) : 0;
         return {
@@ -5202,42 +5382,61 @@ var init_dist = __esm({
       }
       store;
       async run(options) {
-        const maxIterations = options.maxIterations ?? 5;
         const remediations = [];
-        const preSnapshot = this.buildSnapshot(options.domain);
         const extraction = await this.extract(options);
-        const postSnapshot = this.buildSnapshot(options.domain);
-        let driftResult = this.reconcile(preSnapshot, postSnapshot);
-        const contradictionDetector = new ContradictionDetector();
-        const contradictions = contradictionDetector.detect(this.store);
+        let driftResult = this.runReconciliation(options);
+        const contradictions = new ContradictionDetector().detect(this.store);
         let gapReport = await this.detect(options);
-        const coverageScorer = new CoverageScorer();
-        const coverage = coverageScorer.score(this.store);
-        let iterations = 1;
-        if (options.fix) {
-          let previousFindingCount = driftResult.findings.length;
-          while (iterations < maxIterations) {
-            if (driftResult.findings.length === 0) break;
-            this.remediate(driftResult, remediations, options);
-            const rePreSnapshot = this.buildSnapshot(options.domain);
-            await this.extract(options);
-            const rePostSnapshot = this.buildSnapshot(options.domain);
-            driftResult = this.reconcile(rePreSnapshot, rePostSnapshot);
-            gapReport = await this.detect(options);
-            iterations++;
-            const newFindingCount = driftResult.findings.length;
-            if (newFindingCount >= previousFindingCount) break;
-            previousFindingCount = newFindingCount;
-          }
+        const coverage = new CoverageScorer().score(this.store);
+        const iterations = options.fix ? await this.runRemediationLoop(options, driftResult, gapReport, remediations) : 1;
+        if (options.fix && iterations > 1) {
+          driftResult = this.runReconciliation(options);
+          gapReport = await this.detect(options);
         }
         await this.stageNewFindings(driftResult, options);
+        return this.buildResult(
+          driftResult,
+          iterations,
+          extraction,
+          gapReport,
+          remediations,
+          contradictions,
+          coverage
+        );
+      }
+      /** Run phases 1-2 (extract snapshot, reconcile) and return drift result. */
+      runReconciliation(options) {
+        const preSnapshot = this.buildSnapshot(options.domain);
+        const postSnapshot = this.buildSnapshot(options.domain);
+        return this.reconcile(preSnapshot, postSnapshot);
+      }
+      /** Run the remediation convergence loop; returns total iteration count. */
+      async runRemediationLoop(options, driftResult, _gapReport, remediations) {
+        const maxIterations = options.maxIterations ?? 5;
+        let iterations = 1;
+        let currentDrift = driftResult;
+        let previousFindingCount = currentDrift.findings.length;
+        while (iterations < maxIterations) {
+          if (currentDrift.findings.length === 0) break;
+          this.remediate(currentDrift, remediations, options);
+          await this.extract(options);
+          currentDrift = this.runReconciliation(options);
+          await this.detect(options);
+          iterations++;
+          if (currentDrift.findings.length >= previousFindingCount) break;
+          previousFindingCount = currentDrift.findings.length;
+        }
+        return iterations;
+      }
+      /** Assemble the final pipeline result. */
+      buildResult(driftResult, iterations, extraction, gaps, remediations, contradictions, coverage) {
         return {
           verdict: this.computeVerdict(driftResult),
           driftScore: driftResult.driftScore,
           iterations,
           findings: driftResult.summary,
           extraction,
-          gaps: gapReport,
+          gaps,
           remediations,
           contradictions,
           coverage
@@ -5860,7 +6059,7 @@ ${replyLines.join("\n")}`;
         const apiKeyEnv = config.apiKeyEnv ?? "GITHUB_TOKEN";
         const apiKey = process.env[apiKeyEnv];
         if (!apiKey) {
-          return emptyResult2(
+          return emptyResult5(
             [`Missing API key: environment variable "${apiKeyEnv}" is not set`],
             start
           );
@@ -5927,35 +6126,9 @@ ${replyLines.join("\n")}`;
       }
       async ingest(store, config) {
         const start = Date.now();
-        const apiKeyEnv = config.apiKeyEnv ?? "FIGMA_API_KEY";
-        const apiKey = process.env[apiKeyEnv];
-        if (!apiKey) {
-          return buildIngestResult2(
-            0,
-            0,
-            [`Missing API key: environment variable "${apiKeyEnv}" is not set`],
-            start
-          );
-        }
-        const baseUrlEnv = config.baseUrlEnv ?? "FIGMA_BASE_URL";
-        const baseUrl = process.env[baseUrlEnv] ?? "https://api.figma.com";
-        try {
-          const parsed = new URL(baseUrl);
-          if (parsed.protocol !== "https:" || !parsed.hostname.endsWith("api.figma.com")) {
-            return buildIngestResult2(
-              0,
-              0,
-              [`Invalid ${baseUrlEnv}: must be an HTTPS URL on api.figma.com`],
-              start
-            );
-          }
-        } catch {
-          return buildIngestResult2(0, 0, [`Invalid ${baseUrlEnv}: not a valid URL`], start);
-        }
-        const fileIds = config.fileIds;
-        if (!fileIds || fileIds.length === 0) {
-          return buildIngestResult2(0, 0, ["No fileIds provided in connector config"], start);
-        }
+        const validated = validateFigmaConfig(config);
+        if ("error" in validated) return buildIngestResult2(0, 0, [validated.error], start);
+        const { apiKey, baseUrl, fileIds } = validated;
         const headers = { "X-FIGMA-TOKEN": apiKey };
         const maxLen = config.maxContentLength ?? 4e3;
         let nodesAdded = 0;
@@ -5975,6 +6148,17 @@ ${replyLines.join("\n")}`;
         return buildIngestResult2(nodesAdded, edgesAdded, errors, start);
       }
       async processFile(store, baseUrl, fileId, headers, maxLen) {
+        let nodesAdded = 0;
+        let edgesAdded = 0;
+        const styleCounts = await this.ingestStyles(store, baseUrl, fileId, headers, maxLen);
+        nodesAdded += styleCounts.nodesAdded;
+        edgesAdded += styleCounts.edgesAdded;
+        const componentCounts = await this.ingestComponents(store, baseUrl, fileId, headers, maxLen);
+        nodesAdded += componentCounts.nodesAdded;
+        edgesAdded += componentCounts.edgesAdded;
+        return { nodesAdded, edgesAdded };
+      }
+      async ingestStyles(store, baseUrl, fileId, headers, maxLen) {
         let nodesAdded = 0;
         let edgesAdded = 0;
         const stylesUrl = `${baseUrl}/v1/files/${fileId}/styles`;
@@ -5982,90 +6166,112 @@ ${replyLines.join("\n")}`;
         if (!stylesResponse.ok) throw new Error(`Styles request failed for file ${fileId}`);
         const stylesData = await stylesResponse.json();
         for (const style of stylesData.meta.styles) {
-          const nodeId = `figma:token:${style.key}`;
-          const condensed = await condenseContent(sanitizeExternalText(style.description || "", 2e3), {
-            maxLength: maxLen
-          });
-          const metadata = {
-            source: "figma",
-            key: style.key,
-            styleType: style.style_type,
-            fileId
-          };
-          if (condensed.method !== "passthrough") {
-            metadata.condensed = condensed.method;
-            metadata.originalLength = condensed.originalLength;
-          }
-          store.addNode({
-            id: nodeId,
-            type: "design_token",
-            name: sanitizeExternalText(style.name, 500),
-            content: condensed.content,
-            metadata
-          });
-          nodesAdded++;
-          const searchText = sanitizeExternalText([style.name, style.description].join(" "));
-          edgesAdded += linkToCode(store, searchText, nodeId, "references");
+          const counts = await this.processStyle(store, style, fileId, maxLen);
+          nodesAdded += counts.nodesAdded;
+          edgesAdded += counts.edgesAdded;
         }
+        return { nodesAdded, edgesAdded };
+      }
+      async processStyle(store, style, fileId, maxLen) {
+        const nodeId = `figma:token:${style.key}`;
+        const condensed = await condenseContent(sanitizeExternalText(style.description || "", 2e3), {
+          maxLength: maxLen
+        });
+        const metadata = buildNodeMetadata(condensed, {
+          source: "figma",
+          key: style.key,
+          styleType: style.style_type,
+          fileId
+        });
+        store.addNode({
+          id: nodeId,
+          type: "design_token",
+          name: sanitizeExternalText(style.name, 500),
+          content: condensed.content,
+          metadata
+        });
+        const searchText = sanitizeExternalText([style.name, style.description].join(" "));
+        const edgesAdded = linkToCode(store, searchText, nodeId, "references");
+        return { nodesAdded: 1, edgesAdded };
+      }
+      async ingestComponents(store, baseUrl, fileId, headers, maxLen) {
+        let nodesAdded = 0;
+        let edgesAdded = 0;
         const componentsUrl = `${baseUrl}/v1/files/${fileId}/components`;
         const componentsResponse = await this.httpClient(componentsUrl, { headers });
         if (!componentsResponse.ok) throw new Error(`Components request failed for file ${fileId}`);
         const componentsData = await componentsResponse.json();
         for (const component of componentsData.meta.components) {
-          const description = component.description || "";
-          if (description) {
-            const intentId = `figma:intent:${component.key}`;
-            const condensed = await condenseContent(sanitizeExternalText(description, 2e3), {
-              maxLength: maxLen
-            });
-            const metadata = {
-              source: "figma",
-              key: component.key,
-              fileId
-            };
-            if (condensed.method !== "passthrough") {
-              metadata.condensed = condensed.method;
-              metadata.originalLength = condensed.originalLength;
-            }
-            store.addNode({
-              id: intentId,
-              type: "aesthetic_intent",
-              name: sanitizeExternalText(component.name, 500),
-              content: condensed.content,
-              metadata
-            });
-            nodesAdded++;
-            const searchText = sanitizeExternalText([component.name, description].join(" "));
-            edgesAdded += linkToCode(store, searchText, intentId, "references");
-          }
-          if (description && hasConstraintKeyword(description)) {
-            const constraintId = `figma:constraint:${component.key}`;
-            const condensed = await condenseContent(sanitizeExternalText(description, 2e3), {
-              maxLength: maxLen
-            });
-            const metadata = {
-              source: "figma",
-              key: component.key,
-              fileId
-            };
-            if (condensed.method !== "passthrough") {
-              metadata.condensed = condensed.method;
-              metadata.originalLength = condensed.originalLength;
-            }
-            store.addNode({
-              id: constraintId,
-              type: "design_constraint",
-              name: sanitizeExternalText(component.name, 500),
-              content: condensed.content,
-              metadata
-            });
-            nodesAdded++;
-            const searchText = sanitizeExternalText([component.name, description].join(" "));
-            edgesAdded += linkToCode(store, searchText, constraintId, "references");
-          }
+          const counts = await this.processComponent(store, component, fileId, maxLen);
+          nodesAdded += counts.nodesAdded;
+          edgesAdded += counts.edgesAdded;
         }
         return { nodesAdded, edgesAdded };
       }
+      async processComponent(store, component, fileId, maxLen) {
+        let nodesAdded = 0;
+        let edgesAdded = 0;
+        const description = component.description || "";
+        if (description) {
+          const counts = await this.addComponentIntent(store, component, description, fileId, maxLen);
+          nodesAdded += counts.nodesAdded;
+          edgesAdded += counts.edgesAdded;
+        }
+        if (description && hasConstraintKeyword(description)) {
+          const counts = await this.addComponentConstraint(
+            store,
+            component,
+            description,
+            fileId,
+            maxLen
+          );
+          nodesAdded += counts.nodesAdded;
+          edgesAdded += counts.edgesAdded;
+        }
+        return { nodesAdded, edgesAdded };
+      }
+      async addComponentIntent(store, component, description, fileId, maxLen) {
+        const intentId = `figma:intent:${component.key}`;
+        const condensed = await condenseContent(sanitizeExternalText(description, 2e3), {
+          maxLength: maxLen
+        });
+        const metadata = buildNodeMetadata(condensed, {
+          source: "figma",
+          key: component.key,
+          fileId
+        });
+        store.addNode({
+          id: intentId,
+          type: "aesthetic_intent",
+          name: sanitizeExternalText(component.name, 500),
+          content: condensed.content,
+          metadata
+        });
+        const searchText = sanitizeExternalText([component.name, description].join(" "));
+        const edgesAdded = linkToCode(store, searchText, intentId, "references");
+        return { nodesAdded: 1, edgesAdded };
+      }
+      async addComponentConstraint(store, component, description, fileId, maxLen) {
+        const constraintId = `figma:constraint:${component.key}`;
+        const condensed = await condenseContent(sanitizeExternalText(description, 2e3), {
+          maxLength: maxLen
+        });
+        const metadata = buildNodeMetadata(condensed, {
+          source: "figma",
+          key: component.key,
+          fileId
+        });
+        store.addNode({
+          id: constraintId,
+          type: "design_constraint",
+          name: sanitizeExternalText(component.name, 500),
+          content: condensed.content,
+          metadata
+        });
+        const searchText = sanitizeExternalText([component.name, description].join(" "));
+        const edgesAdded = linkToCode(store, searchText, constraintId, "references");
+        return { nodesAdded: 1, edgesAdded };
+      }
     };
     MIN_CONTENT_LENGTH = 10;
     CONCEPT_ITEM_TYPES = /* @__PURE__ */ new Set(["sticky_note", "text"]);
@@ -6078,36 +6284,9 @@ ${replyLines.join("\n")}`;
       }
       async ingest(store, config) {
         const start = Date.now();
-        const apiKeyEnv = config.apiKeyEnv ?? "MIRO_API_KEY";
-        const apiKey = process.env[apiKeyEnv];
-        if (!apiKey) {
-          return buildIngestResult3(
-            0,
-            0,
-            [`Missing API key: environment variable "${apiKeyEnv}" is not set`],
-            start
-          );
-        }
-        const baseUrlEnv = config.baseUrlEnv ?? "MIRO_BASE_URL";
-        const baseUrl = process.env[baseUrlEnv] ?? "https://api.miro.com";
-        try {
-          const parsed = new URL(baseUrl);
-          if (parsed.protocol !== "https:" || parsed.hostname !== "api.miro.com") {
-            return buildIngestResult3(
-              0,
-              0,
-              [`Invalid ${baseUrlEnv}: must be an HTTPS URL on api.miro.com`],
-              start
-            );
-          }
-        } catch {
-          return buildIngestResult3(0, 0, [`Invalid ${baseUrlEnv}: not a valid URL`], start);
-        }
-        const boardIds = config.boardIds;
-        if (!boardIds || boardIds.length === 0) {
-          return buildIngestResult3(0, 0, ["No boardIds provided in config"], start);
-        }
-        const headers = { Authorization: `Bearer ${apiKey}` };
+        const resolved = resolveConfig(config, start);
+        if (!resolved.ok) return resolved.result;
+        const { baseUrl, boardIds, headers } = resolved;
         let totalNodesAdded = 0;
         let totalEdgesAdded = 0;
         const errors = [];