@merittdev/horus 0.2.1 → 0.2.3

package/dist/index.cjs

@@ -57239,7 +57239,7 @@ init_cjs_shims();
 
 // ../../packages/core/src/version.ts
 init_cjs_shims();
-var HORUS_VERSION = true ? "0.2.1" : "dev";
+var HORUS_VERSION = true ? "0.2.3" : "dev";
 var PINNED_AXON_VERSION = "1.0.7";
 var PINNED_SOURCE_VERSION = PINNED_AXON_VERSION;
 
@@ -77014,6 +77014,8 @@ function detectEntityFields(context, limit = 2) {
 }
 async function reseedFromLogs(hint, input, deps) {
   if (!deps.logs || typeof deps.logs.searchLogs !== "function") return null;
+  if (!deps.code) return null;
+  const code = deps.code;
   try {
     const from = logWindowFrom(input.since);
     const records = await deps.logs.searchLogs({
@@ -77026,7 +77028,7 @@ async function reseedFromLogs(hint, input, deps) {
     if (records.length === 0) return null;
     const candidates = [...new Set(records.map((r) => r.component).filter((c) => !!c))];
     for (const name of candidates) {
-      const syms = await deps.code.searchSymbols(name, 5);
+      const syms = await code.searchSymbols(name, 5);
       if (syms.length > 0) {
         const rankedSeeds = rankSeeds(syms, [...new Set(tokenize(name))]);
         const first = records[0];
@@ -77077,20 +77079,21 @@ async function investigate(input, deps) {
     evidence2.push(ev);
     return ev;
   }
-  const rawSeeds = await code.searchSymbols(hint, 5);
+  const degradedNoSource = !code;
+  const rawSeeds = code ? await code.searchSymbols(hint, 5) : [];
   const hintTokens = [...new Set(tokenize(hint))];
   const ranked = rankSeeds(rawSeeds, hintTokens);
   let seeds = ranked.map((r) => r.symbol);
   let top = seeds[0];
   let logReseed = null;
-  if (!top) {
+  if (!top && !degradedNoSource) {
     logReseed = await reseedFromLogs(hint, input, deps);
     if (logReseed !== null) {
       seeds = logReseed.seeds;
       top = seeds[0];
     }
   }
-  if (!top) {
+  if (!top && !degradedNoSource) {
     const report2 = {
       id: globalThis.crypto.randomUUID(),
       input,
@@ -77114,31 +77117,6 @@ async function investigate(input, deps) {
     if (persistedId2) report2.id = persistedId2;
     return report2;
   }
-  const label = top.name === "constructor" ? `${(top.id.split(":").pop() ?? "").replace(/\.constructor$/, "") || top.name} (constructor)` : top.name;
-  const [ctx, impact, flows] = await Promise.all([
-    code.context(top.id),
-    code.impact(top.id, 2),
-    code.flowsFor(top.id)
-  ]);
-  const edges = await listQueueEdges(db, { project: input.repo });
-  const symbolNames = /* @__PURE__ */ new Set([
-    top.name,
-    ...ctx.callers.map((s) => s.name),
-    ...ctx.callees.map((s) => s.name)
-  ]);
-  const 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;
-  });
-  let changes = null;
-  if (input.since !== void 0 && looksDiffable(input.since)) {
-    try {
-      changes = await code.detectChanges({ base: input.since, compare: "HEAD" });
-    } catch {
-      changes = null;
-    }
-  }
   let recentChanges;
   if (deps.repoPath && input.since) {
     try {
@@ -77146,62 +77124,97 @@ async function investigate(input, deps) {
     } catch {
     }
   }
-  const seedLoc = formatSymbolLocation(top.filePath, top.startLine, top.endLine);
-  const seedEv = mkEv(
-    "symbol",
-    `Seed symbol ${top.name} (${seedLoc})`,
-    { symbol: top, snippet: ctx.snippet ?? null },
-    top.startLine !== void 0 && top.startLine > 0 ? { symbolId: top.id, file: top.filePath, line: top.startLine } : { symbolId: top.id, file: top.filePath }
-  );
+  let label = input.service ?? hint;
+  let seedLoc = "";
+  let ctx = null;
+  let impact = null;
+  let flows = [];
+  let seedEv = null;
+  let impactEv = null;
   const flowEvIds = [];
-  for (const flow of flows) {
-    const ev = mkEv(
-      "flow",
-      `Flow "${flow.name}" (${flow.steps.length} step(s))`,
-      { flowId: flow.id, name: flow.name, steps: flow.steps.map((s) => s.name) },
-      { symbolId: top.id, file: top.filePath }
-    );
-    flowEvIds.push(ev.id);
-  }
-  const impactEv = mkEv(
-    "impact",
-    `Impact of ${top.name}: ${impact.affected} affected symbol(s)`,
-    { affected: impact.affected },
-    { symbolId: top.id, file: top.filePath }
-  );
+  let queueHits = [];
   const queueEvByName = /* @__PURE__ */ new Map();
-  for (const edge of queueHits) {
-    const producer = edge.producerSymbol ?? "unknown-producer";
-    const worker = edge.workerSymbol ?? "unknown-worker";
-    const ev = mkEv(
-      "queue-edge",
-      `Queue "${edge.queueName}": ${producer} -> ${worker}`,
-      {
-        queueName: edge.queueName,
-        producerSymbol: edge.producerSymbol,
-        producerFile: edge.producerFile,
-        workerSymbol: edge.workerSymbol,
-        workerFile: edge.workerFile,
-        source: edge.source
-      },
-      { queueName: edge.queueName }
-    );
-    const list = queueEvByName.get(edge.queueName) ?? [];
-    list.push(ev.id);
-    queueEvByName.set(edge.queueName, list);
-  }
+  let changes = null;
   let changeEvId = null;
-  if (changes) {
-    const addedN = changes.added.length;
-    const removedN = changes.removed.length;
-    const modifiedN = changes.modified.length;
-    const ev = mkEv(
-      "commit",
-      `Change range ${input.since}..HEAD: +${addedN} -${removedN} ~${modifiedN} symbol(s)`,
-      { added: addedN, removed: removedN, modified: modifiedN },
-      {}
+  if (top && code) {
+    label = top.name === "constructor" ? `${(top.id.split(":").pop() ?? "").replace(/\.constructor$/, "") || top.name} (constructor)` : top.name;
+    [ctx, impact, flows] = await Promise.all([
+      code.context(top.id),
+      code.impact(top.id, 2),
+      code.flowsFor(top.id)
+    ]);
+    const edges = await listQueueEdges(db, { project: input.repo });
+    const symbolNames = /* @__PURE__ */ new Set([
+      top.name,
+      ...ctx.callers.map((s) => s.name),
+      ...ctx.callees.map((s) => s.name)
+    ]);
+    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 (input.since !== void 0 && looksDiffable(input.since)) {
+      try {
+        changes = await code.detectChanges({ base: input.since, compare: "HEAD" });
+      } catch {
+        changes = null;
+      }
+    }
+    seedLoc = formatSymbolLocation(top.filePath, top.startLine, top.endLine);
+    seedEv = mkEv(
+      "symbol",
+      `Seed symbol ${top.name} (${seedLoc})`,
+      { symbol: top, snippet: ctx.snippet ?? null },
+      top.startLine !== void 0 && top.startLine > 0 ? { symbolId: top.id, file: top.filePath, line: top.startLine } : { symbolId: top.id, file: top.filePath }
     );
-    changeEvId = ev.id;
+    for (const flow of flows) {
+      const ev = mkEv(
+        "flow",
+        `Flow "${flow.name}" (${flow.steps.length} step(s))`,
+        { flowId: flow.id, name: flow.name, steps: flow.steps.map((s) => s.name) },
+        { symbolId: top.id, file: top.filePath }
+      );
+      flowEvIds.push(ev.id);
+    }
+    impactEv = mkEv(
+      "impact",
+      `Impact of ${top.name}: ${impact.affected} affected symbol(s)`,
+      { affected: impact.affected },
+      { symbolId: top.id, file: top.filePath }
+    );
+    for (const edge of queueHits) {
+      const producer = edge.producerSymbol ?? "unknown-producer";
+      const worker = edge.workerSymbol ?? "unknown-worker";
+      const ev = mkEv(
+        "queue-edge",
+        `Queue "${edge.queueName}": ${producer} -> ${worker}`,
+        {
+          queueName: edge.queueName,
+          producerSymbol: edge.producerSymbol,
+          producerFile: edge.producerFile,
+          workerSymbol: edge.workerSymbol,
+          workerFile: edge.workerFile,
+          source: edge.source
+        },
+        { queueName: edge.queueName }
+      );
+      const list = queueEvByName.get(edge.queueName) ?? [];
+      list.push(ev.id);
+      queueEvByName.set(edge.queueName, list);
+    }
+    if (changes) {
+      const addedN = changes.added.length;
+      const removedN = changes.removed.length;
+      const modifiedN = changes.modified.length;
+      const ev = mkEv(
+        "commit",
+        `Change range ${input.since}..HEAD: +${addedN} -${removedN} ~${modifiedN} symbol(s)`,
+        { added: addedN, removed: removedN, modified: modifiedN },
+        {}
+      );
+      changeEvId = ev.id;
+    }
   }
   if (changes === null && recentChanges !== void 0 && recentChanges.commits.length > 0) {
     const { commits, changedFiles, totalInsertions, totalDeletions } = recentChanges;
@@ -77235,10 +77248,8 @@ async function investigate(input, deps) {
         const from = logWindowFrom(input.since);
         analysis = await deps.logs.analyzeErrors({ service: input.service, from });
         logsCollected = true;
-        const seedBase = top.filePath.split("/").pop() ?? "";
-        const logSeedTerms = [
-          .../* @__PURE__ */ new Set([...tokenize(hint), ...tokenize(top.name), ...tokenize(seedBase)])
-        ];
+        const seedBase = top ? top.filePath.split("/").pop() ?? "" : "";
+        const logSeedTerms = top ? [.../* @__PURE__ */ new Set([...tokenize(hint), ...tokenize(top.name), ...tokenize(seedBase)])] : [...new Set(tokenize(hint))];
         for (const s of analysis.signatures.slice(0, 15)) {
           const { relevanceClass, relevanceReason } = classifyLogRelevance(
             s.key,
@@ -77486,10 +77497,10 @@ async function investigate(input, deps) {
     }
   }
   let ownershipEstimate = null;
-  if (deps.repoPath) {
+  if (deps.repoPath && top && code) {
     try {
       ownershipEstimate = await estimateOwnership(top.name, {
-        code: deps.code,
+        code,
         repoPath: deps.repoPath,
         symbol: top
       });
@@ -77515,14 +77526,16 @@ async function investigate(input, deps) {
   const validated = validateHypotheses(hyps, evidence2);
   const causeChains = buildCauseChains(validated, evidence2, graph, label);
   const findings2 = [];
-  findings2.push({
-    kind: "observation",
-    title: `Seed resolves to ${label} at ${seedLoc}`,
-    detail: top.signature ?? void 0,
-    confidence: 1,
-    evidenceIds: [seedEv.id]
-  });
-  if (logReseed !== null) {
+  if (top && seedEv) {
+    findings2.push({
+      kind: "observation",
+      title: `Seed resolves to ${label} at ${seedLoc}`,
+      detail: top.signature ?? void 0,
+      confidence: 1,
+      evidenceIds: [seedEv.id]
+    });
+  }
+  if (logReseed !== null && seedEv) {
     findings2.push({
       kind: "observation",
       title: logReseed.note,
@@ -77531,7 +77544,7 @@ async function investigate(input, deps) {
       evidenceIds: [seedEv.id]
     });
   }
-  if (ranked.length > 1) {
+  if (ranked.length > 1 && seedEv) {
     const candidates = ranked.slice(0, 4).map((r) => `${r.symbol.name} [${r.role}]`).join(", ");
     findings2.push({
       kind: "observation",
@@ -77550,7 +77563,7 @@ async function investigate(input, deps) {
       evidenceIds: flowEvIds
     });
   }
-  if (impact.affected > 0) {
+  if (top && impactEv && impact && impact.affected > 0) {
     findings2.push({
       kind: "observation",
       title: `Changing ${top.name} impacts ${impact.affected} symbol(s) (blast radius)`,
@@ -77701,7 +77714,7 @@ async function investigate(input, deps) {
     });
   }
   const causeInputs = [];
-  const blastRadius = impact.affected;
+  const blastRadius = impact?.affected ?? 0;
   if (queueRuntimeState !== null) {
     for (const q of queueRuntimeState.queues) {
       const isStarved = q.waiting >= 10 && q.active === 0;
@@ -77730,26 +77743,25 @@ async function investigate(input, deps) {
       id: `cause:queue-path:${queueName}`,
       title: `The ${queueName} processing path (${producer} -> ${worker}) is implicated`,
       category: "queue-path",
-      sourceEvidenceIds: [...evIds, impactEv.id],
+      sourceEvidenceIds: [...evIds, ...impactEv ? [impactEv.id] : []],
       baseScore: 0.35,
       metadata: { blastRadius }
     });
   }
   if (changeEvId) {
     const gitChangedFiles = recentChanges?.changedFiles ?? [];
-    const seedInChanges = gitChangedFiles.length > 0 && gitChangedFiles.some(
-      (f) => f === top.filePath || top.filePath.endsWith(f) || f.endsWith(top.filePath)
-    );
+    const seedFile = top?.filePath;
+    const seedInChanges = seedFile !== void 0 && gitChangedFiles.length > 0 && gitChangedFiles.some((f) => f === seedFile || seedFile.endsWith(f) || f.endsWith(seedFile));
     causeInputs.push({
       id: "cause:deployment-regression",
-      title: `Recent change to ${top.name} in ${input.since}..HEAD may have introduced the regression`,
+      title: top ? `Recent change to ${top.name} in ${input.since}..HEAD may have introduced the regression` : `Recent changes in ${input.since}..HEAD may have introduced the regression`,
       category: "deployment-regression",
-      sourceEvidenceIds: [changeEvId, seedEv.id],
+      sourceEvidenceIds: [changeEvId, ...seedEv ? [seedEv.id] : []],
       baseScore: clamp015((seedInChanges ? 0.45 : 0.25) + (queueHits.length > 0 ? 0.05 : 0)),
       metadata: { blastRadius }
     });
   }
-  if (impact.affected > 0) {
+  if (top && impactEv && seedEv && impact && impact.affected > 0) {
     causeInputs.push({
       id: "cause:blast-radius",
       title: `${top.name} sits on a high-fan-out path (${impact.affected} affected) and may propagate the fault`,
@@ -77812,13 +77824,20 @@ async function investigate(input, deps) {
   );
   const seedResolved = seeds.length > 0 ? 1 : 0;
   const confidence = clamp015(0.5 * evidenceConfidence + 0.5 * seedResolved);
-  const area = ctx.community?.name ?? top.filePath;
+  const area = ctx?.community?.name ?? top?.filePath ?? (input.service ?? "runtime evidence");
   const topCause = rankedCauses[0];
-  const summary = topCause ? `Investigation of "${hint}" resolved to ${label} (${area}). Top suspected cause: ${topCause.title}.` : `Investigation of "${hint}" resolved to ${label} (${area}). No dominant suspected cause emerged from the available structural evidence.`;
+  const banner = degradedNoSource ? "Runtime-only (source intelligence unavailable). " : "";
+  const scope = top ? `resolved to ${label} (${area})` : `over runtime evidence (${area})`;
+  const summary = topCause ? `${banner}Investigation of "${hint}" ${scope}. Top suspected cause: ${topCause.title}.` : `${banner}Investigation of "${hint}" ${scope}. No dominant suspected cause emerged from the available ${degradedNoSource ? "runtime" : "structural"} evidence.`;
   const nextActions = buildNextActions(top, ctx, impact, queueHits, changes, input);
+  if (degradedNoSource) {
+    nextActions.unshift(
+      "Source intelligence was unavailable \u2014 run `horus index` to enable code-aware analysis, then re-run for a full investigation."
+    );
+  }
   if (ownershipEstimate?.likelyMaintainer) {
     nextActions.unshift(
-      `Route to likely maintainer: ${ownershipEstimate.likelyMaintainer} (${Math.round(ownershipEstimate.maintainerShare * 100)}% of commits to ${ownershipEstimate.file ?? top.filePath})`
+      `Route to likely maintainer: ${ownershipEstimate.likelyMaintainer} (${Math.round(ownershipEstimate.maintainerShare * 100)}% of commits to ${ownershipEstimate.file ?? top?.filePath ?? "the implicated file"})`
     );
   }
   const report = {
@@ -77839,7 +77858,8 @@ async function investigate(input, deps) {
     nextActions,
     ownership: ownershipEstimate,
     causeChains: causeChains.length > 0 ? causeChains : void 0,
-    ...recentChanges !== void 0 ? { recentChanges } : {}
+    ...recentChanges !== void 0 ? { recentChanges } : {},
+    ...degradedNoSource ? { degraded: { sourceIntelligence: false, reason: "source-intelligence host unreachable" } } : {}
   };
   const connectorFlags = deps.connectors ? {
     ...deps.connectors,
@@ -77892,16 +77912,20 @@ function buildNextActions(top, _ctx, impact, queueHits, changes, input) {
     actions.push(`Inspect logs for worker ${worker} on queue ${edge.queueName}`);
     actions.push(`Check depth/failures of queue ${edge.queueName}`);
   }
-  if (impact.affected > 0) {
+  if (top && impact && impact.affected > 0) {
     actions.push(`Review impact set of ${top.name} (${impact.affected} affected symbol(s))`);
   }
-  if (changes && input.since !== void 0) {
-    actions.push(`Diff recent commits touching ${top.filePath} in ${input.since}..HEAD`);
-  } else {
-    actions.push(`Diff recent commits touching ${top.filePath}`);
+  if (top) {
+    if (changes && input.since !== void 0) {
+      actions.push(`Diff recent commits touching ${top.filePath} in ${input.since}..HEAD`);
+    } else {
+      actions.push(`Diff recent commits touching ${top.filePath}`);
+    }
   }
   if (actions.length === 0) {
-    actions.push(`Inspect the source of ${top.name} at ${top.filePath}`);
+    actions.push(
+      top ? `Inspect the source of ${top.name} at ${top.filePath}` : input.service ? `Inspect runtime logs and metrics for service "${input.service}"` : "Inspect runtime logs and metrics for the affected service"
+    );
   }
   return actions;
 }
@@ -93758,7 +93782,7 @@ async function uploadInvestigationToCloud(client, cfg, report) {
   await client.createAgentRun(projectId, investigation.id, {
     repositoryId: cfg.repository?.id,
     status: "completed",
-    cliVersion: process.env.npm_package_version ?? "0.0.0",
+    cliVersion: HORUS_VERSION,
     summary: report.summary,
     idempotencyKey: idempotencyKey(report.id, "run")
   });
@@ -93796,6 +93820,40 @@ async function listCloudInvestigations(client, cfg) {
   return result.investigations;
 }
 
+// ../../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 "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" };
+  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)) return { ok: true, hostUrl };
+  removeSpawnedHostRecord(root);
+  return { ok: false, reason: "unhealthy" };
+}
+
 // ../../packages/cli/src/commands/investigate.ts
 function extractEvidenceExcerpt(e) {
   if (!e.payload || typeof e.payload !== "object") return void 0;
@@ -93933,15 +93991,27 @@ async function runInvestigate(hint, opts) {
       );
       return 1;
     }
-    const health = await code.health();
-    if (!health.ok) {
-      const sourceUrl = renv.repositories[0]?.sourceHostUrl ?? renv.repositories[0]?.axonHostUrl;
+    const sourceUrl = renv.repositories[0]?.sourceHostUrl ?? renv.repositories[0]?.axonHostUrl;
+    let health = await code.health();
+    if (!health.ok && sourceUrl) {
       console.error(
-        import_picocolors8.default.red(
-          `Source-intelligence host unreachable for ${renv.project}/${renv.env}` + (sourceUrl ? ` (${sourceUrl}) \u2014 run: horus index` : " \u2014 run: horus index")
+        import_picocolors8.default.yellow(`Source-intelligence host unreachable (${sourceUrl}) \u2014 attempting to start it\u2026`)
+      );
+      const healed = await ensureSourceHost(renv.path, sourceUrl);
+      if (healed.ok) {
+        console.error(import_picocolors8.default.green(`Source-intelligence host is up at ${healed.hostUrl}.`));
+        health = await code.health();
+      } else {
+        console.error(import_picocolors8.default.dim(`  ${ensureHostReasonHint(healed.reason)}`));
+      }
+    }
+    const runtimeOnly = !health.ok;
+    if (runtimeOnly) {
+      console.error(
+        import_picocolors8.default.yellow(
+          `Proceeding in runtime-only mode \u2014 no source intelligence. Run ${import_picocolors8.default.bold("horus index")} for a full (code-aware) investigation.`
         )
       );
-      return 1;
     }
     const logs = logsForEnv(renv);
     const mongo = mongoForEnv(renv);
@@ -93954,7 +94024,9 @@ async function runInvestigate(hint, opts) {
       const report = await investigate(
         { hint, repo: renv.project, since: opts.since, service },
         {
-          code,
+          // Runtime-only degrade (HOR-319 layer-2): pass no source provider so the engine
+          // skips seed resolution + structural evidence and builds from runtime evidence.
+          code: runtimeOnly ? null : code,
           db,
           logs,
           mongo,
@@ -94026,6 +94098,10 @@ async function runInvestigate(hint, opts) {
           return reportCloudError(err);
         }
       }
+      if (format !== "json") {
+        console.log(import_picocolors8.default.dim(`
+Ask a follow-up:  horus ask ${report.id} "<question>"`));
+      }
     } finally {
       await sql2.end();
       if (mongo) await mongo.close();
@@ -94874,10 +94950,27 @@ function renderAnswer(report, directive, opts) {
   }
   return 0;
 }
+async function lookupLocalInvestigation(id, configPath) {
+  const { db, sql: sql2 } = createDb(await resolveDbUrl(configPath));
+  try {
+    const row = await getInvestigation(db, id);
+    if (!row) return { kind: "not-found" };
+    if (!row.report) return { kind: "no-report" };
+    return { kind: "found", report: migrateReport(row.report) };
+  } catch (err) {
+    const code = typeof err === "object" && err !== null && "code" in err ? String(err.code) : void 0;
+    if (code === "22P02") return { kind: "not-found" };
+    return { kind: "error", message: err instanceof Error ? err.message : String(err) };
+  } finally {
+    await sql2.end();
+  }
+}
 async function runAsk(id, directive, opts) {
   const repoRoot = repoRootOrCwd();
   const cloudCfg = readCloudConfig(repoRoot);
   if (isCloudActive(cloudCfg)) {
+    const local2 = await lookupLocalInvestigation(id, opts.config);
+    if (local2.kind === "found") return renderAnswer(local2.report, directive, opts);
     const session = authedClient();
     if (!session) {
       console.error(
@@ -94888,47 +94981,40 @@ async function runAsk(id, directive, opts) {
       return 1;
     }
     try {
-      const report = await fetchInvestigationReportFromCloud(
-        session.client,
-        cloudCfg,
-        id
+      const report = await fetchInvestigationReportFromCloud(session.client, cloudCfg, id);
+      if (report) return renderAnswer(report, directive, opts);
+      console.error(
+        import_picocolors21.default.red(
+          `Investigation ${id} has no saved report locally or in Horus Cloud. Run ${import_picocolors21.default.bold("horus investigate")} first.`
+        )
       );
-      if (!report) {
+      return 1;
+    } catch (err) {
+      if (err instanceof CloudError && err.status === 404) {
         console.error(
           import_picocolors21.default.red(
-            `Cloud investigation ${id} has no saved report. Run this investigation with ${import_picocolors21.default.bold("horus investigate")} first.`
+            `No investigation found for "${id}" locally or in Horus Cloud. Use the id printed at the top of \`horus investigate\` output.`
           )
         );
         return 1;
       }
-      return renderAnswer(report, directive, opts);
-    } catch (err) {
       return reportCloudError(err);
     }
   }
-  const { db, sql: sql2 } = createDb(await resolveDbUrl(opts.config));
-  try {
-    const row = await getInvestigation(db, id);
-    if (!row) {
-      console.error(import_picocolors21.default.red("No investigation found: " + id));
-      return 1;
-    }
-    if (!row.report) {
+  const local = await lookupLocalInvestigation(id, opts.config);
+  switch (local.kind) {
+    case "found":
+      return renderAnswer(local.report, directive, opts);
+    case "no-report":
       console.error(import_picocolors21.default.red("Investigation " + id + " has no stored report."));
       return 1;
-    }
-    const report = migrateReport(row.report);
-    return renderAnswer(report, directive, opts);
-  } catch (err) {
-    const code = typeof err === "object" && err !== null && "code" in err ? String(err.code) : void 0;
-    if (code === "22P02") {
+    case "error":
+      console.error(import_picocolors21.default.red(local.message));
+      return 1;
+    case "not-found":
+    default:
       console.error(import_picocolors21.default.red("No investigation found: " + id));
       return 1;
-    }
-    console.error(import_picocolors21.default.red(err instanceof Error ? err.message : String(err)));
-    return 1;
-  } finally {
-    await sql2.end();
   }
 }
 
@@ -95102,6 +95188,14 @@ function levelColor(level, text2) {
   if (level === "warn") return import_picocolors24.default.yellow(text2);
   return import_picocolors24.default.dim(text2);
 }
+function matchServiceLabel(requested, candidates) {
+  if (candidates.includes(requested)) return { kind: "unique", matched: requested };
+  const needle = requested.toLowerCase();
+  const subs = candidates.filter((c) => c.toLowerCase().includes(needle));
+  if (subs.length === 1 && subs[0] !== void 0) return { kind: "unique", matched: subs[0] };
+  if (subs.length > 1) return { kind: "ambiguous", candidates: subs };
+  return { kind: "none" };
+}
 async function runLogs(service, opts) {
   try {
     const config2 = await loadConfig(opts.config, { name: opts.name });
@@ -95279,9 +95373,32 @@ async function runLogs(service, opts) {
     if (analysis.signatures.length === 0 && resolvedService !== void 0) {
       const broader = await logs.analyzeErrors({ from, text: opts.grep, broadText: opts.grep !== void 0 });
       if (broader.signatures.length > 0) {
-        analysis = broader;
-        broadeningNote = `No errors found for service "${resolvedService}" \u2014 showing all services`;
-        scopeService = void 0;
+        const match = matchServiceLabel(resolvedService, broader.affectedServices);
+        if (match.kind === "unique" && match.matched !== void 0 && match.matched !== resolvedService) {
+          const scoped = await logs.analyzeErrors({
+            service: match.matched,
+            from,
+            text: opts.grep,
+            broadText: opts.grep !== void 0
+          });
+          if (scoped.signatures.length > 0) {
+            analysis = scoped;
+            scopeService = match.matched;
+            broadeningNote = `No exact match for service "${resolvedService}" \u2014 matched "${match.matched}"`;
+          } else {
+            analysis = broader;
+            scopeService = void 0;
+            broadeningNote = `No errors found for service "${resolvedService}" \u2014 showing all services`;
+          }
+        } else if (match.kind === "ambiguous" && match.candidates !== void 0) {
+          analysis = broader;
+          scopeService = void 0;
+          broadeningNote = `"${resolvedService}" matches multiple services: ${match.candidates.join(", ")} \u2014 showing all; re-run with a full label`;
+        } else {
+          analysis = broader;
+          scopeService = void 0;
+          broadeningNote = `No errors found for service "${resolvedService}" \u2014 showing all services`;
+        }
       }
     }
     if (opts.json) {

package/package.json

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