@merittdev/horus 0.8.6 → 0.8.8

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.6" : "dev";
+var HORUS_VERSION = true ? "0.8.8" : "dev";
 var PINNED_SOURCE_VERSION = "1.5.0";
 
 // ../../packages/core/src/evidence.ts
@@ -70614,6 +70614,11 @@ async function loadConfig(configPath, opts) {
     } else {
       const jsPath = (0, import_node_path2.resolve)(cwd, "config/horus.config.js");
       const tsPath = (0, import_node_path2.resolve)(cwd, "config/horus.config.ts");
+      if (!(0, import_node_fs2.existsSync)(jsPath) && !(0, import_node_fs2.existsSync)(tsPath)) {
+        throw new Error(
+          `No Horus config found for ${cwd}. Run \`horus index\` in this repo to set it up, or pass --config <path> / --name <project>.`
+        );
+      }
       target = (0, import_node_fs2.existsSync)(jsPath) ? jsPath : tsPath;
     }
   }
@@ -91925,6 +91930,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 +91959,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 +92287,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;
@@ -92740,16 +92757,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" });
@@ -92933,7 +92967,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 ?? ""
                   });
                 }
               }
@@ -92981,7 +93018,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 {
@@ -93005,13 +93045,14 @@ async function investigate(input, deps) {
             ])
           ].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";
@@ -93054,7 +93095,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
             });
           }
         }
@@ -93643,6 +93686,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;
@@ -93656,17 +93700,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",
@@ -97230,6 +97278,50 @@ async function stitch(client, db, opts = {}) {
   };
 }
 
+// ../../packages/cli/src/lib/ensure-host.ts
+init_cjs_shims();
+function parseHostPort(hostUrl) {
+  try {
+    const port = parseInt(new URL(hostUrl).port, 10);
+    return Number.isNaN(port) ? null : port;
+  } catch {
+    return null;
+  }
+}
+function ensureHostReasonHint(reason) {
+  switch (reason) {
+    case "source-unavailable":
+      return "horus-source is not installed \u2014 install it: pip install horus-source";
+    case "version-mismatch":
+      return "the installed horus-source backend does not match the version Horus is pinned to \u2014 reinstall the pinned version (run `horus status` to see it)";
+    case "not-analyzed":
+      return "this repo has not been indexed yet \u2014 run: horus index";
+    case "bad-url":
+      return "the configured source host URL is not a valid URL";
+    default:
+      return "the host did not become healthy \u2014 run: horus index";
+  }
+}
+async function ensureSourceHost(root, hostUrl, opts = {}) {
+  if (await isHostHealthy(hostUrl)) return { ok: true, hostUrl };
+  if (!await sourceAvailable()) return { ok: false, reason: "source-unavailable" };
+  try {
+    await assertSourceVersionPinned();
+  } catch {
+    return { ok: false, reason: "version-mismatch" };
+  }
+  if (!isAnalyzed(root)) return { ok: false, reason: "not-analyzed" };
+  const port = parseHostPort(hostUrl);
+  if (port === null) return { ok: false, reason: "bad-url" };
+  startHost(root, port);
+  if (await waitForHost(hostUrl, opts.timeoutMs ?? 2e4)) {
+    reconcileSpawnedHostPid(root, port);
+    return { ok: true, hostUrl };
+  }
+  removeSpawnedHostRecord(root);
+  return { ok: false, reason: "unhealthy" };
+}
+
 // ../../packages/cli/src/commands/index-repo.ts
 async function stitchQueueMap(hostUrl, dbUrl, label) {
   const source = new SourceHttpClient({ baseUrl: hostUrl });
@@ -97243,6 +97335,14 @@ async function stitchQueueMap(hostUrl, dbUrl, label) {
     await sql2.end();
   }
 }
+async function hostServesRepo(hostUrl, root) {
+  try {
+    const info2 = await new SourceHttpClient({ baseUrl: hostUrl }).hostInfo();
+    return (0, import_node_path10.resolve)(info2.repoPath) === (0, import_node_path10.resolve)(root);
+  } catch {
+    return true;
+  }
+}
 function findConfiguredRepo(config2, root) {
   const target = (0, import_node_path10.resolve)(root);
   for (const p5 of config2.projects) {
@@ -97329,7 +97429,7 @@ async function runIndex(opts) {
     let hostUrl;
     let spawned = false;
     for (const candidate of [configuredHost, readSourceHostUrl(root) ?? void 0]) {
-      if (candidate && await isHostHealthy(candidate)) {
+      if (candidate && await isHostHealthy(candidate) && await hostServesRepo(candidate, root)) {
         hostUrl = candidate;
         break;
       }
@@ -97360,7 +97460,17 @@ async function runIndex(opts) {
       } else {
         console.log(import_picocolors3.default.dim("  already analyzed"));
       }
-      const port = await findFreePort();
+      const priorPort = parseHostPort(configuredHost ?? "") ?? parseHostPort(readSourceHostUrl(root) ?? "");
+      let port;
+      if (priorPort !== null) {
+        try {
+          port = await findFreePort(priorPort, priorPort);
+        } catch {
+          port = await findFreePort();
+        }
+      } else {
+        port = await findFreePort();
+      }
       hostUrl = `http://127.0.0.1:${port}`;
       console.log(import_picocolors3.default.dim(`  starting source-intelligence host on port ${port}\u2026`));
       startHost(root, port);
@@ -97375,7 +97485,8 @@ async function runIndex(opts) {
     }
     await stitchQueueMap(hostUrl, dbUrl, label);
     buildKnowledgeIndex(root, config2, label, configuredProject, opts);
-    if (spawned && !isConfigured) {
+    const hasLocalConfig = discoverLocalConfig(root) !== null;
+    if (!isConfigured && !hasLocalConfig) {
       const file = {
         version: 1,
         project: {
@@ -110296,52 +110407,6 @@ async function maybePromptFeedback(opts) {
 // ../../packages/cli/src/lib/investigation-runner.ts
 init_cjs_shims();
 var import_picocolors9 = __toESM(require_picocolors(), 1);
-
-// ../../packages/cli/src/lib/ensure-host.ts
-init_cjs_shims();
-function parseHostPort(hostUrl) {
-  try {
-    const port = parseInt(new URL(hostUrl).port, 10);
-    return Number.isNaN(port) ? null : port;
-  } catch {
-    return null;
-  }
-}
-function ensureHostReasonHint(reason) {
-  switch (reason) {
-    case "source-unavailable":
-      return "horus-source is not installed \u2014 install it: pip install horus-source";
-    case "version-mismatch":
-      return "the installed horus-source backend does not match the version Horus is pinned to \u2014 reinstall the pinned version (run `horus status` to see it)";
-    case "not-analyzed":
-      return "this repo has not been indexed yet \u2014 run: horus index";
-    case "bad-url":
-      return "the configured source host URL is not a valid URL";
-    default:
-      return "the host did not become healthy \u2014 run: horus index";
-  }
-}
-async function ensureSourceHost(root, hostUrl, opts = {}) {
-  if (await isHostHealthy(hostUrl)) return { ok: true, hostUrl };
-  if (!await sourceAvailable()) return { ok: false, reason: "source-unavailable" };
-  try {
-    await assertSourceVersionPinned();
-  } catch {
-    return { ok: false, reason: "version-mismatch" };
-  }
-  if (!isAnalyzed(root)) return { ok: false, reason: "not-analyzed" };
-  const port = parseHostPort(hostUrl);
-  if (port === null) return { ok: false, reason: "bad-url" };
-  startHost(root, port);
-  if (await waitForHost(hostUrl, opts.timeoutMs ?? 2e4)) {
-    reconcileSpawnedHostPid(root, port);
-    return { ok: true, hostUrl };
-  }
-  removeSpawnedHostRecord(root);
-  return { ok: false, reason: "unhealthy" };
-}
-
-// ../../packages/cli/src/lib/investigation-runner.ts
 async function buildInvestigationContext(renv, opts) {
   const log = opts.log ?? ((l2) => console.error(l2));
   const code = codeForEnv(renv);

package/package.json

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