@merittdev/horus 0.21.2 → 0.21.4

package/dist/index.cjs

@@ -3057,7 +3057,7 @@ var init_version = __esm({
   "../../packages/core/src/version.ts"() {
     "use strict";
     init_cjs_shims();
-    HORUS_VERSION = true ? "0.21.2" : "dev";
+    HORUS_VERSION = true ? "0.21.4" : "dev";
     PINNED_SOURCE_VERSION = HORUS_VERSION;
     SOURCE_PIN_ENFORCED = HORUS_VERSION !== "dev";
   }
@@ -72160,12 +72160,17 @@ function readSourceMeta(root) {
     return {
       storeBackend: typeof j3["store_backend"] === "string" ? j3["store_backend"].toLowerCase() : void 0,
       embeddingsComplete: typeof j3["embeddings_complete"] === "boolean" ? j3["embeddings_complete"] : void 0,
+      structuralComplete: typeof j3["structural_complete"] === "boolean" ? j3["structural_complete"] : void 0,
       stats: stats ? { symbols: stats["symbols"], embeddings: stats["embeddings"] } : void 0
     };
   } catch {
     return null;
   }
 }
+function indexEmbeddingsPending(root) {
+  const meta = readSourceMeta(root);
+  return meta?.structuralComplete === true && meta?.embeddingsComplete === false;
+}
 function metaHasEmbeddings(meta) {
   if (meta.embeddingsComplete === false) return false;
   const embeddings = meta.stats?.embeddings ?? 0;
@@ -72183,25 +72188,88 @@ function indexNeedsReanalyze(root) {
     return `store backend changed (${meta.storeBackend} -> ${CURRENT_STORE_BACKEND})`;
   }
   if (!metaHasEmbeddings(meta)) {
+    if (meta.structuralComplete === true) return null;
     return "index has no semantic embeddings (symbols present but 0 vectors)";
   }
   return null;
 }
+var BASE_ANALYZE_TIMEOUT_MS = 9e5;
+var MAX_ANALYZE_TIMEOUT_MS = 36e5;
+var ANALYZE_BASELINE_FILES = 5e3;
+var ANALYZE_TIMEOUT_PER_FILE_MS = 15;
+var ANALYZE_COUNT_SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".horus",
+  "dist",
+  "build",
+  "out",
+  "target",
+  "vendor",
+  ".venv",
+  "venv",
+  "__pycache__",
+  ".next",
+  ".turbo",
+  "coverage",
+  ".cache"
+]);
+function countRepoFiles(root, limit = 2e5) {
+  let count = 0;
+  const stack = [root];
+  while (stack.length > 0) {
+    const dir = stack.pop();
+    let entries;
+    try {
+      entries = (0, import_node_fs4.readdirSync)(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const e of entries) {
+      if (e.isDirectory()) {
+        if (ANALYZE_COUNT_SKIP_DIRS.has(e.name) || e.name.startsWith(".")) continue;
+        stack.push((0, import_node_path4.join)(dir, e.name));
+      } else if (e.isFile()) {
+        count++;
+        if (count >= limit) return count;
+      }
+    }
+  }
+  return count;
+}
+function resolveAnalyzeTimeoutMs(root) {
+  const override = process.env["HORUS_ANALYZE_TIMEOUT_MS"];
+  if (override !== void 0 && override.trim() !== "") {
+    const n4 = Number(override);
+    if (Number.isFinite(n4) && n4 > 0) return Math.floor(n4);
+  }
+  let files = 0;
+  try {
+    files = countRepoFiles(root);
+  } catch {
+    return BASE_ANALYZE_TIMEOUT_MS;
+  }
+  if (files <= ANALYZE_BASELINE_FILES) return BASE_ANALYZE_TIMEOUT_MS;
+  const scaled = BASE_ANALYZE_TIMEOUT_MS + (files - ANALYZE_BASELINE_FILES) * ANALYZE_TIMEOUT_PER_FILE_MS;
+  return Math.min(scaled, MAX_ANALYZE_TIMEOUT_MS);
+}
 async function analyzeRepo(root) {
   const bin = await resolveSourceBin();
   if (!bin) throw new Error("horus-source not found on PATH. Install it: curl -fsSL https://horus.sh/install.sh | bash");
+  const timeoutMs = resolveAnalyzeTimeoutMs(root);
   try {
-    await exec(bin, ["analyze", "."], {
+    await exec(bin, ["analyze", ".", "--defer-embeddings"], {
       cwd: root,
-      timeout: 9e5,
+      timeout: timeoutMs,
       maxBuffer: 64 * 1024 * 1024
     });
   } catch (err2) {
     const e = err2;
     const tail = redactSecrets((e.stderr ?? "").trim()).slice(-800);
     if (e.killed || e.signal === "SIGTERM" || e.code === "ETIMEDOUT") {
+      const secs = Math.round(timeoutMs / 1e3);
       throw new Error(
-        `horus-source analyze timed out after 900s (large repo / slow embeddings phase)` + (tail ? ` \u2014 last output: ${tail}` : "")
+        `horus-source analyze timed out after ${secs}s while building the structural index (large repo). Raise the cap with HORUS_ANALYZE_TIMEOUT_MS.` + (tail ? ` \u2014 last output: ${tail}` : "")
       );
     }
     throw new Error(tail ? `horus-source analyze failed: ${tail}` : redactSecrets(e.message ?? "horus-source analyze failed"));
@@ -72396,7 +72464,7 @@ var SourceCodeProvider = class {
   kind = "code";
   // --- helpers -------------------------------------------------------------
   nodeToSymbol(n4) {
-    return {
+    const sym = {
       id: n4.id,
       name: n4.name,
       filePath: n4.filePath,
@@ -72406,6 +72474,8 @@ var SourceCodeProvider = class {
       language: n4.language,
       className: n4.className
     };
+    if (n4.aliasOf) sym.aliasOf = n4.aliasOf;
+    return sym;
   }
   /** Map a serialized graph node to a `Symbol`, coercing the host's `0` line sentinel to undefined. */
   serializedToSymbol(n4) {
@@ -72419,6 +72489,7 @@ var SourceCodeProvider = class {
     if (n4.className) sym.className = n4.className;
     if (n4.signature) sym.signature = n4.signature;
     if (n4.language) sym.language = n4.language;
+    if (n4.aliasOf) sym.aliasOf = n4.aliasOf;
     return sym;
   }
   /**
@@ -97554,6 +97625,16 @@ function parseSymbolQuery(query) {
   if (container.length < 2 || m5[2].length < 2) return null;
   return { symbol: m5[2], container, isPath: false };
 }
+function redirectExportAlias(candidates) {
+  const head = candidates[0];
+  if (head === void 0 || head.aliasOf === void 0 || head.aliasOf === "") return candidates;
+  const implName = head.aliasOf.toLowerCase();
+  const impl = candidates.find(
+    (s5) => s5.id !== head.id && s5.name.toLowerCase() === implName && s5.filePath === head.filePath
+  ) ?? candidates.find((s5) => s5.id !== head.id && s5.name.toLowerCase() === implName);
+  if (impl === void 0) return candidates;
+  return [impl, ...candidates.filter((s5) => s5.id !== impl.id)];
+}
 function resolveSymbolQuery(query, symbols, opts) {
   const includeTests = opts?.includeTests === true;
   const qualifier = parseSymbolQuery(query);
@@ -97577,7 +97658,10 @@ function resolveSymbolQuery(query, symbols, opts) {
   const ambiguous = kind !== "fuzzy" && kind !== "none" && first !== void 0 && second !== void 0 && first.score === second.score && first.symbol.filePath !== second.symbol.filePath;
   return {
     kind,
-    candidates: [...scoredTier.map((s5) => s5.symbol), ...rest],
+    // B2: redirect a public export-alias hit (`Component` → `BaseComponent`) to the
+    // implementation so explain/blast-radius/search land on real product code, not the
+    // empty alias stub. No-op unless the head candidate carries `aliasOf`.
+    candidates: redirectExportAlias([...scoredTier.map((s5) => s5.symbol), ...rest]),
     ambiguous,
     qualifier
   };
@@ -97591,7 +97675,16 @@ async function resolveSeedSymbol(code, query, opts) {
     const seen = new Set(pool.map((s5) => s5.id));
     for (const s5 of extra) if (!seen.has(s5.id)) pool.push(s5);
   }
-  return resolveSymbolQuery(query, pool, { includeTests: opts?.includeTests ?? false });
+  const includeTests = opts?.includeTests ?? false;
+  let resolution = resolveSymbolQuery(query, pool, { includeTests });
+  const head = resolution.candidates[0];
+  if (head?.aliasOf !== void 0 && head.aliasOf !== "" && !pool.some((s5) => s5.id !== head.id && s5.name.toLowerCase() === head.aliasOf.toLowerCase())) {
+    const implHits = await code.searchSymbols(head.aliasOf, Math.max(limit, 20));
+    const seen = new Set(pool.map((s5) => s5.id));
+    for (const s5 of implHits) if (!seen.has(s5.id)) pool.push(s5);
+    resolution = resolveSymbolQuery(query, pool, { includeTests });
+  }
+  return resolution;
 }
 function rankSeeds(seeds, hintTokens, changedFiles, hintHasCode, qualifier, preferNamed) {
   const scored = seeds.map((symbol, i3) => ({
@@ -124755,7 +124848,7 @@ async function runIndex(opts) {
         if (incomplete) {
           console.error(
             import_picocolors41.default.red(
-              `  source analysis did not finish (${incomplete}) \u2014 the index has symbols but no embeddings. Re-run \`horus init\` to resume (the embedding cache is warm).`
+              `  source analysis did not finish (${incomplete}) \u2014 the structural index is missing or broken. Re-run \`horus init\` to rebuild it.`
             )
           );
           return 1;
@@ -124810,6 +124903,9 @@ async function runIndex(opts) {
       );
       return 1;
     }
+    if (indexEmbeddingsPending(root)) {
+      console.log(import_picocolors41.default.dim("  index ready (semantic search warming up)"));
+    }
     try {
       await stitchQueueMap(hostUrl, label);
     } catch (err2) {

package/package.json

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