@merittdev/horus 0.8.5 → 0.8.7

package/dist/index.cjs

@@ -65880,7 +65880,7 @@ init_cjs_shims();
 
 // ../../packages/core/src/version.ts
 init_cjs_shims();
-var HORUS_VERSION = true ? "0.8.5" : "dev";
+var HORUS_VERSION = true ? "0.8.7" : "dev";
 var PINNED_SOURCE_VERSION = "1.5.0";
 
 // ../../packages/core/src/evidence.ts
@@ -91925,6 +91925,8 @@ function correlate(evidence2) {
 init_cjs_shims();
 var PREFER = /resolver|controller|\bservice\b|route|router|handler|gateway|processor|worker|consumer|repository|usecase|use-case|endpoint/i;
 var DEMOTE = /\butil|helper|\bscript|backfill|legacy|migration|seeder|fixture|\bmock\b|\btest\b|\bspec\b/i;
+var PRESENTATION_NAME = /^(build|format|render|compose|serialize)[A-Z].*(Message|Markup|Html|Text|Label|Summary|Notification|String)$/;
+var PREDICATE_NAME = /^(is|has|can|should|was|were|are|does|did|needs|allows?|must)[A-Z]/;
 var TYPE_SUFFIX = /(Result|Input|Response|Payload|Args|Dto|Props|Edge|Connection)$/;
 var INTERFACE_PREFIX = /^I(?=[A-Z][a-z])/;
 var TYPE_LIKE_NAME = new RegExp(`(?:${TYPE_SUFFIX.source})|(?:${INTERFACE_PREFIX.source})`);
@@ -91952,8 +91954,9 @@ function scoreSeed(s5, index2, hintTokens, changedFiles, hintHasCode) {
   let score = 0;
   if (PREFER.test(hay)) score += hintHasCode ? 0 : 3;
   if (DEMOTE.test(hay)) score -= 3;
+  if (PRESENTATION_NAME.test(s5.name)) score -= 3;
   if (isTypeLikeName(s5.name)) score -= 4;
-  if (s5.startLine !== void 0 && s5.endLine !== void 0 && s5.endLine - s5.startLine <= 3) {
+  if (s5.startLine !== void 0 && s5.endLine !== void 0 && s5.endLine - s5.startLine <= 3 && !PREDICATE_NAME.test(s5.name)) {
     score -= 3;
   }
   if (changedFiles !== void 0 && changedFiles.has(s5.filePath)) score += 5;
@@ -92279,6 +92282,15 @@ function clamp015(n4) {
 var SEV_ERROR = 2;
 var SEV_WARN = 1;
 var SEV_INFO = 0;
+var GENERIC_SYMBOL_NAMES = /* @__PURE__ */ new Set([
+  "",
+  "constructor",
+  "unknown",
+  "unknown-producer",
+  "unknown-worker",
+  "anonymous",
+  "default"
+]);
 function seedEmittedSeverityTier(level, code, message) {
   const lv = level?.toLowerCase();
   if (lv === "error" || lv === "fatal" || lv === "critical") return SEV_ERROR;
@@ -92471,10 +92483,21 @@ function looksDiffable(since) {
 function looksExplanatory(hint) {
   const h3 = hint.trim();
   if (h3.length === 0) return false;
+  if (/^\s*(explain|describe|walk\s+me\s+through|tell\s+me\s+(?:about|how))\b/i.test(h3)) {
+    return true;
+  }
+  if (/\b(recently\s+changed|what\s+changed|changed\s+recently|regress|regression)\b/i.test(h3)) {
+    return false;
+  }
   if (/\b(how|what|why|when|where)\b.*\b(work|works|working|do|does|done|happen|happens|flow|flows|behave|called|invoked|triggered|used)\b/i.test(h3)) {
     return true;
   }
-  if (/^\s*(how|what|why|when|where|explain|describe|walk\s+me\s+through|tell\s+me\s+(?:about|how))\b/i.test(h3)) {
+  if (/\b(fail|fails|failed|failing|failure|break|breaks|breaking|broke|broken|crash|crashes|crashing|down|slow|stuck|hang|hangs|hung|timeout|timing\s*out|wrong|exception|error|errors|leak|leaking|stopped|throwing|throws|reject|rejected|denied|not\s+work|doesn'?t\s+work|isn'?t\s+work|can'?t|cannot|caus(?:e|es|ing)|misbehav)/i.test(
+    h3
+  )) {
+    return false;
+  }
+  if (/^\s*(how|what|why|when|where)\b/i.test(h3)) {
     return true;
   }
   return false;
@@ -92729,16 +92752,33 @@ async function investigate(input, deps) {
     } catch {
       edges = [];
     }
-    const symbolNames = /* @__PURE__ */ new Set([
-      top.name,
-      ...ctx.callers.map((s5) => s5.name),
-      ...ctx.callees.map((s5) => s5.name)
-    ]);
+    const symbolNames = new Set(
+      [top.name, ...ctx.callers.map((s5) => s5.name), ...ctx.callees.map((s5) => s5.name)].filter(
+        (n4) => n4 && !GENERIC_SYMBOL_NAMES.has(n4)
+      )
+    );
     queueHits = edges.filter((e) => {
       const bySymbol = e.producerSymbol !== null && symbolNames.has(e.producerSymbol) || e.workerSymbol !== null && symbolNames.has(e.workerSymbol);
       const byFile = e.producerFile === top.filePath || e.workerFile === top.filePath;
       return bySymbol || byFile;
     });
+    if (queueHits.length > 0 && typeof code.searchSymbols === "function") {
+      const resolvesInRepo = async (name2) => {
+        if (!name2 || GENERIC_SYMBOL_NAMES.has(name2)) return false;
+        try {
+          return (await code.searchSymbols(name2, 3)).some((s5) => s5.name === name2);
+        } catch {
+          return true;
+        }
+      };
+      const validated2 = [];
+      for (const e of queueHits) {
+        if (await resolvesInRepo(e.producerSymbol) || await resolvesInRepo(e.workerSymbol)) {
+          validated2.push(e);
+        }
+      }
+      queueHits = validated2;
+    }
     if (input.since !== void 0 && looksDiffable(input.since)) {
       try {
         changes = await code.detectChanges({ base: input.since, compare: "HEAD" });
@@ -92922,7 +92962,10 @@ async function investigate(input, deps) {
                     message: sig.sampleMessage ?? "",
                     evId: existingEvId,
                     isNew: sig.isNew ?? false,
-                    level: sig.level ?? null
+                    level: sig.level ?? null,
+                    raisedBySeed: true,
+                    // literal is in the seed's own body
+                    raiserName: top?.name ?? ""
                   });
                 }
               }
@@ -92970,7 +93013,10 @@ async function investigate(input, deps) {
                 message: sig.sampleMessage ?? "",
                 evId: ev.id,
                 isNew: sig.isNew ?? false,
-                level: sig.level ?? null
+                level: sig.level ?? null,
+                raisedBySeed: true,
+                // literal is in the seed's own body
+                raiserName: top?.name ?? ""
               });
             }
           } catch {
@@ -92980,17 +93026,28 @@ async function investigate(input, deps) {
           const GAP_D_MAX_RESOLVE = 12;
           const seedScope = /* @__PURE__ */ new Set([top.id, ...(ctx?.callees ?? []).map((c4) => c4.id)]);
           const alreadyEmitted = new Set(seedEmittedJoins.map((j3) => j3.code));
-          const candidates = analysis.signatures.filter(
+          const eligible = analysis.signatures.filter(
             (s5) => s5.key !== "" && s5.key !== "(none)" && s5.count > 0 && !alreadyEmitted.has(s5.key)
-          ).sort((a2, b5) => b5.count - a2.count).slice(0, GAP_D_MAX_RESOLVE);
+          );
+          const meaningful = meaningfulHintTokens.filter((t2) => t2.length >= 4);
+          const hintRelevant = (s5) => meaningful.some(
+            (t2) => s5.key.toLowerCase().includes(t2) || (s5.sampleMessage ?? "").toLowerCase().includes(t2)
+          );
+          const candidates = [
+            .../* @__PURE__ */ new Set([
+              ...[...eligible].sort((a2, b5) => b5.count - a2.count).slice(0, GAP_D_MAX_RESOLVE),
+              ...eligible.filter(hintRelevant).slice(0, GAP_D_MAX_RESOLVE)
+            ])
+          ].slice(0, GAP_D_MAX_RESOLVE * 2);
           for (const sig of candidates) {
-            let raiser;
+            let raisers = [];
             try {
-              raiser = (await deps.code.searchSymbols(sig.key, 1))[0];
+              raisers = await deps.code.searchSymbols(sig.key, 3);
             } catch {
               continue;
             }
-            if (raiser === void 0 || !seedScope.has(raiser.id)) continue;
+            const raiser = raisers.find((r) => r.id === top.id) ?? raisers.find((r) => seedScope.has(r.id));
+            if (raiser === void 0) continue;
             let evId = directEvIdByKey.get(sig.key);
             if (evId === void 0) {
               const where = raiser.id === top.id ? "the seed" : "a callee of the seed";
@@ -93033,7 +93090,9 @@ async function investigate(input, deps) {
               message: sig.sampleMessage ?? "",
               evId,
               isNew: sig.isNew ?? false,
-              level: sig.level ?? null
+              level: sig.level ?? null,
+              raisedBySeed: raiser.id === top.id,
+              raiserName: raiser.name
             });
           }
         }
@@ -93622,6 +93681,7 @@ async function investigate(input, deps) {
   }
   if (seedEmittedJoins.length > 0 && top && seedEv) {
     const ordered = [...seedEmittedJoins].sort((a2, b5) => {
+      if (a2.raisedBySeed !== b5.raisedBySeed) return a2.raisedBySeed ? -1 : 1;
       const ta = seedEmittedSeverityTier(a2.level, a2.code, a2.message);
       const tb = seedEmittedSeverityTier(b5.level, b5.code, b5.message);
       if (ta !== tb) return tb - ta;
@@ -93635,17 +93695,21 @@ async function investigate(input, deps) {
       const tier = seedEmittedSeverityTier(lead.level, lead.code, lead.message);
       const volumeBoost = Math.min(0.1, Math.log10(Math.max(1, lead.count)) * 0.025);
       const msgClause = lead.message ? ` \u2014 "${lead.message.replace(/\s+/g, " ").trim().slice(0, 90)}"` : "";
+      const bySeed = lead.raisedBySeed;
+      const raiser = bySeed ? top.name : lead.raiserName || top.name;
+      const depClause = bySeed ? "" : `, a dependency of ${top.name}`;
+      const calleePenalty = bySeed ? 0 : 0.18;
       let title;
       let baseScore;
       if (tier === SEV_ERROR) {
-        title = `Runtime error ${lead.code} (${lead.count}x in Elasticsearch) is raised by ${top.name} \u2014 the likely failure${msgClause}`;
-        baseScore = clamp015(0.6 + volumeBoost);
+        title = bySeed ? `Runtime error ${lead.code} (${lead.count}x in Elasticsearch) is raised by ${raiser} \u2014 the likely failure${msgClause}` : `Runtime error ${lead.code} (${lead.count}x in Elasticsearch) surfaces on ${raiser}${depClause}${msgClause}`;
+        baseScore = clamp015(0.6 + volumeBoost - calleePenalty);
       } else if (tier === SEV_WARN) {
-        title = `Warning ${lead.code} (${lead.count}x in Elasticsearch) is raised by ${top.name}${msgClause}`;
-        baseScore = clamp015(0.42 + volumeBoost);
+        title = `Warning ${lead.code} (${lead.count}x in Elasticsearch) ${bySeed ? "is raised by" : "surfaces on"} ${raiser}${depClause}${msgClause}`;
+        baseScore = clamp015(0.42 + volumeBoost - calleePenalty);
       } else {
-        title = `Diagnostic signal ${lead.code} (${lead.count}x in Elasticsearch) is logged by ${top.name} \u2014 informational, not an error${msgClause}`;
-        baseScore = clamp015(0.3 + volumeBoost);
+        title = `Diagnostic signal ${lead.code} (${lead.count}x in Elasticsearch) is logged by ${raiser}${depClause} \u2014 informational, not an error${msgClause}`;
+        baseScore = clamp015(0.3 + volumeBoost - calleePenalty);
       }
       causeInputs.push({
         id: "cause:seed-emitted-error",
@@ -93785,7 +93849,7 @@ async function investigate(input, deps) {
   const seedDisclaimer = seedIsLowConfidence && top ? `\u26A0 No symbol closely matched "${hint}" \u2014 "${top.name}" is a low-confidence closest match (semantic). Refine with an exact symbol or error code to target precisely. ` : "";
   let summary = headlineCause ? headlineLinked ? `${seedDisclaimer}${banner2}Investigation of "${hint}" ${scope}. Top suspected cause: ${headlineCause.title}.` : `${seedDisclaimer}${banner2}Investigation of "${hint}" ${scope}. No cause is structurally linked to the seed; the strongest co-occurring signal (a lead to verify, not a diagnosis) is: ${headlineCause.title}.` : `${seedDisclaimer}${banner2}Investigation of "${hint}" ${scope}. No dominant suspected cause emerged from the available ${degradedNoSource ? "runtime" : "structural"} evidence.`;
   const hasIncidentSignal = directLogEvIds.length > 0 || latencyMetricEvIds.length > 0 || queueMetricEvIds.length > 0 || dataAnomalyEvIds.length > 0 || queueFailureSignals.length > 0 || findings2.some((f5) => f5.kind === "anomaly") || headlineCause !== void 0;
-  const explanatoryHint = looksExplanatory(hint);
+  const explanatoryHint = looksExplanatory(hint) && input.since === void 0;
   let behavioral;
   if (explanatoryHint) {
     let flowPool = flows;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@merittdev/horus",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "Local-first, source-aware production-incident investigation engine",
   "type": "module",
   "bin": {