@merittdev/horus 0.1.11 → 0.1.12

package/dist/index.cjs

@@ -50314,7 +50314,7 @@ init_cjs_shims();
 
 // ../../packages/core/src/version.ts
 init_cjs_shims();
-var HORUS_VERSION = true ? "0.1.11" : "dev";
+var HORUS_VERSION = true ? "0.1.12" : "dev";
 var PINNED_AXON_VERSION = "1.0.7";
 var PINNED_SOURCE_VERSION = PINNED_AXON_VERSION;
 
@@ -70237,8 +70237,10 @@ async function investigate(input, deps) {
   const latencyMetricEvIds = [];
   const queueMetricEvIds = [];
   const queueMetricEvIdsByQueue = /* @__PURE__ */ new Map();
+  const nominalMetricEvIds = [];
   let metricsCollected = false;
   let metricsFailureReason;
+  let metricSeriesChecked = 0;
   if (deps.metrics) {
     const ac = new AbortController();
     let metricsTimerId;
@@ -70298,6 +70300,19 @@ async function investigate(input, deps) {
           }
         }
       }
+      metricSeriesChecked = mFindings.length;
+      if (metricEvIds.length === 0 && mFindings.length > 0) {
+        const panels = [...new Set(mFindings.map((f) => f.panelTitle))];
+        const ev = mkEv(
+          "metric",
+          `Metrics checked \u2014 ${mFindings.length} series across ${panels.length} panel(s), no anomalies in window`,
+          { seriesChecked: mFindings.length, panelCount: panels.length, panels: panels.slice(0, 10), anomalies: 0, stance: "neutral" },
+          {},
+          collectedAt2,
+          0.2
+        );
+        nominalMetricEvIds.push(ev.id);
+      }
       metricsCollected = true;
     } catch (metricsErr) {
       metricsFailureReason = metricsErr?.message?.slice(0, 120) ?? "unknown error";
@@ -70495,6 +70510,13 @@ async function investigate(input, deps) {
       confidence: 0.7,
       evidenceIds: metricEvIds
     });
+  } else if (nominalMetricEvIds.length > 0) {
+    findings2.push({
+      kind: "observation",
+      title: `Metrics nominal \u2014 ${metricSeriesChecked} series checked, no anomalies in window`,
+      confidence: 0.5,
+      evidenceIds: nominalMetricEvIds
+    });
   }
   const causeInputs = [];
   const blastRadius = impact.affected;
@@ -72551,6 +72573,167 @@ function refinedToJSON(r, v) {
   );
 }
 
+// ../../packages/engine/src/qa.ts
+init_cjs_shims();
+var CONTRADICTS_RE = /\b(contradict|contradicts|argues?\s+against|evidence\s+against|rule\s+out|disprove|refute|weaken)\b/i;
+var MISSING_RE = /\b(missing|absent|gaps?|don'?t\s+have|do\s+not\s+have|lack(?:ing)?|what\s+else)\b/i;
+var CONFIDENCE_RE = /\b(confidence|confident|certainty|sure|why\s+(?:is\s+)?(?:it\s+)?not\s+higher)\b/i;
+function detectQuestion(text2) {
+  const t = text2.toLowerCase();
+  if (CONFIDENCE_RE.test(t)) return "confidence";
+  if (CONTRADICTS_RE.test(t)) return "contradicts";
+  if (MISSING_RE.test(t)) return "missing-evidence";
+  return null;
+}
+function categoriesForTopic(text2) {
+  const t = text2.toLowerCase();
+  for (const [topic, entry2] of Object.entries(TOPIC_MAP)) {
+    if (topic === t.trim()) return { topic, categories: entry2.categories };
+    if (entry2.keywords.some((kw) => new RegExp(`\\b${kw}\\b`).test(t))) {
+      return { topic, categories: entry2.categories };
+    }
+  }
+  return null;
+}
+function evidenceById(report) {
+  return new Map(report.evidence.map((e) => [e.id, e]));
+}
+function answerContradicts(report, question) {
+  const matched = categoriesForTopic(question);
+  const byId = evidenceById(report);
+  const hyps = matched ? report.hypotheses.filter((h) => matched.categories.includes(h.category)) : [];
+  if (matched && hyps.length === 0) {
+    const evaluated = [...new Set(report.hypotheses.map((h) => h.category))];
+    return {
+      question,
+      kind: "contradicts",
+      headline: `"${matched.topic}" was not among the evaluated hypotheses \u2014 no evidence supports it.`,
+      details: evaluated.length > 0 ? [`Hypotheses evaluated: ${evaluated.join(", ")}.`] : ["No hypotheses were formed for this investigation."],
+      evidence: []
+    };
+  }
+  if (hyps.length === 0) {
+    const ids3 = [...new Set(report.hypotheses.flatMap((h) => h.contradictingEvidenceIds))];
+    const ev2 = ids3.map((id) => byId.get(id)).filter((e) => e !== void 0);
+    return {
+      question,
+      kind: "contradicts",
+      headline: ev2.length > 0 ? `${ev2.length} item(s) contradict the leading hypotheses.` : "No contradicting evidence was recorded for any hypothesis.",
+      details: ev2.length > 0 ? [] : ["Evidence either supports or is neutral to the hypotheses."],
+      evidence: ev2
+    };
+  }
+  const ids2 = [...new Set(hyps.flatMap((h) => h.contradictingEvidenceIds))];
+  const ev = ids2.map((id) => byId.get(id)).filter((e) => e !== void 0);
+  const verdicts = [...new Set(hyps.map((h) => h.verdict))].join(", ");
+  if (ev.length === 0) {
+    return {
+      question,
+      kind: "contradicts",
+      headline: `No evidence contradicts "${matched?.topic ?? "this"}" (verdict: ${verdicts}).`,
+      details: hyps.map((h) => `${h.category}: ${h.rationale ?? h.statement}`),
+      evidence: []
+    };
+  }
+  return {
+    question,
+    kind: "contradicts",
+    headline: `${ev.length} item(s) contradict "${matched?.topic ?? "this"}" (verdict: ${verdicts}).`,
+    details: hyps.map((h) => `${h.category}: ${h.rationale ?? h.statement}`),
+    evidence: ev
+  };
+}
+function answerMissing(report, question) {
+  const { gaps, blindSpots } = report.gapAnalysis;
+  const hypMissing = [...new Set(report.hypotheses.flatMap((h) => h.missingEvidence))];
+  if (gaps.length === 0 && hypMissing.length === 0) {
+    return {
+      question,
+      kind: "missing-evidence",
+      headline: "No evidence gaps \u2014 all expected dimensions were collected.",
+      details: [],
+      evidence: []
+    };
+  }
+  const details = gaps.map(
+    (g) => `${g.dimension}: ${g.why} \u2192 ${g.nextSource} (\u2212${(g.confidenceImpact * 100).toFixed(0)}% ceiling)`
+  );
+  if (hypMissing.length > 0) {
+    details.push(`To confirm hypotheses: ${hypMissing.join("; ")}.`);
+  }
+  for (const bs of blindSpots) details.push(`Blind spot: ${bs}`);
+  return {
+    question,
+    kind: "missing-evidence",
+    headline: `${gaps.length} evidence gap(s) limit this investigation.`,
+    details,
+    evidence: []
+  };
+}
+function answerConfidence(report, question) {
+  const { gaps, confidenceCeiling } = report.gapAnalysis;
+  const ceilingPct = Math.round(confidenceCeiling * 100);
+  const actualPct = Math.round(report.confidence * 100);
+  const limiting = [...gaps].sort((a, b2) => b2.confidenceImpact - a.confidenceImpact);
+  const details = [];
+  if (limiting.length > 0) {
+    details.push(`Confidence is capped at ${ceilingPct}% by missing evidence:`);
+    for (const g of limiting) {
+      details.push(`  \u2022 ${g.dimension} (\u2212${(g.confidenceImpact * 100).toFixed(0)}%): ${g.why}`);
+    }
+  } else {
+    details.push("No evidence gaps cap the ceiling.");
+  }
+  const weak = report.hypotheses.filter((h) => h.verdict === "weakened" || h.verdict === "unconfirmed");
+  if (weak.length > 0) {
+    details.push(
+      `Unconfirmed/weakened hypotheses: ${weak.map((h) => `${h.category} (${h.verdict})`).join(", ")}.`
+    );
+  }
+  return {
+    question,
+    kind: "confidence",
+    headline: `Confidence is ${actualPct}% (ceiling ${ceilingPct}%). ${limiting.length > 0 ? "Missing evidence is the main limiter." : "Limited by hypothesis support, not gaps."}`,
+    details,
+    evidence: []
+  };
+}
+function answerQuestion(report, question) {
+  const kind = detectQuestion(question);
+  if (kind === null) return null;
+  if (kind === "contradicts") return answerContradicts(report, question);
+  if (kind === "missing-evidence") return answerMissing(report, question);
+  return answerConfidence(report, question);
+}
+function renderQAAnswer(a) {
+  const lines = [];
+  lines.push(`Q: ${a.question}`);
+  lines.push("");
+  lines.push(a.headline);
+  for (const d of a.details) lines.push(d.startsWith("  ") ? d : `  ${d}`);
+  if (a.evidence.length > 0) {
+    lines.push("");
+    lines.push("Evidence:");
+    for (const e of a.evidence) {
+      lines.push(`  [${e.id.slice(0, 8)}] (${e.kind}) ${e.title}`);
+    }
+  }
+  return lines.join("\n");
+}
+function qaToJSON(a) {
+  return JSON.stringify(
+    {
+      question: a.question,
+      kind: a.kind,
+      headline: a.headline,
+      details: a.details,
+      evidence: a.evidence.map((e) => ({ id: e.id, kind: e.kind, title: e.title }))
+    },
+    null,
+    2
+  );
+}
+
 // ../../packages/engine/src/onboard.ts
 init_cjs_shims();
 function tokenize2(text2) {
@@ -73714,6 +73897,12 @@ async function runChanges(base2, compare, opts) {
 // ../../packages/cli/src/commands/timeline.ts
 init_cjs_shims();
 var import_picocolors7 = __toESM(require_picocolors(), 1);
+var DEFAULT_SINCE = "7 days ago";
+function resolveTimelineWindow(opts) {
+  const usingDefault = !opts.all && opts.since === void 0;
+  const since = opts.all ? void 0 : opts.since ?? DEFAULT_SINCE;
+  return { since, usingDefault };
+}
 async function runTimeline(service, opts) {
   try {
     const config = await loadConfig(opts.config);
@@ -73725,11 +73914,24 @@ async function runTimeline(service, opts) {
       return 1;
     }
     const { code } = createConnectors(config);
+    const { since, usingDefault: usingDefaultWindow } = resolveTimelineWindow(opts);
     const t = await reconstructChangeTimeline(
-      { repoPath: renv.path, since: opts.since, until: opts.until, service },
+      { repoPath: renv.path, since, until: opts.until, service },
       { code }
     );
-    console.log(opts.json ? changeTimelineToJSON(t) : renderChangeTimeline(t));
+    if (opts.json) {
+      console.log(changeTimelineToJSON(t));
+    } else {
+      console.log(renderChangeTimeline(t));
+      if (usingDefaultWindow) {
+        console.log(
+          import_picocolors7.default.dim(
+            `
+  Showing the last 7 days (default). Widen with ${import_picocolors7.default.bold('--since "30 days ago"')}, pin a range with ${import_picocolors7.default.bold("--since <when> --until <when>")}, or see everything with ${import_picocolors7.default.bold("--all")}.`
+          )
+        );
+      }
+    }
     return 0;
   } catch (err) {
     console.error(import_picocolors7.default.red(err.message));
@@ -73740,7 +73942,7 @@ async function runTimeline(service, opts) {
 // ../../packages/cli/src/commands/what-changed.ts
 init_cjs_shims();
 var import_picocolors8 = __toESM(require_picocolors(), 1);
-var DEFAULT_SINCE = "7 days ago";
+var DEFAULT_SINCE2 = "7 days ago";
 async function runWhatChanged(service, opts) {
   try {
     const config = await loadConfig(opts.config);
@@ -73752,7 +73954,7 @@ async function runWhatChanged(service, opts) {
       return 1;
     }
     const { code } = createConnectors(config);
-    const since = opts.since ?? DEFAULT_SINCE;
+    const since = opts.since ?? DEFAULT_SINCE2;
     const r = await whatChanged(
       { repoPath: renv.path, since, until: opts.until, service },
       { code }
@@ -74213,6 +74415,11 @@ async function runAsk(id, directive, opts) {
       return 1;
     }
     const report = migrateReport(row.report);
+    const answer = answerQuestion(report, directive);
+    if (answer) {
+      console.log(opts.json ? qaToJSON(answer) : renderQAAnswer(answer));
+      return 0;
+    }
     const v = refineInvestigation(report, directive);
     console.log(opts.json ? refinedToJSON(report, v) : renderRefined(report, v));
     if (!opts.json && report.aiJudgment) {
@@ -76677,13 +76884,14 @@ Examples:
   });
   program2.command("timeline [service]").description(
     "Reconstruct what changed in a time window (git + change-impact) \u2014 evidence, not conclusions"
-  ).option("-c, --config <path>", "path to horus.config.ts").option("--repo <name>", "repository name from config").option("--since <when>", 'git --since (e.g. "7 days ago", a date)').option("--until <when>", "git --until").option("--json", "output JSON").action(
+  ).option("-c, --config <path>", "path to horus.config.ts").option("--repo <name>", "repository name from config").option("--since <when>", 'git --since (default "7 days ago"; e.g. "30 days ago", a date)').option("--until <when>", "git --until").option("--all", "include all history instead of the default recent window").option("--json", "output JSON").action(
     async (service, opts) => {
       process.exitCode = await runTimeline(service, {
         config: opts.config,
         repo: opts.repo,
         since: opts.since,
         until: opts.until,
+        all: opts.all,
         json: opts.json
       });
     }
@@ -76781,7 +76989,7 @@ Examples:
     process.exitCode = await runScore(id, { config: opts.config, json: opts.json });
   });
   program2.command("ask <id> <directive>").description(
-    'Refine a saved investigation with a follow-up directive (e.g. "focus on queue behavior", "ignore deployment changes") \u2014 reuses evidence, no re-query'
+    'Ask about or refine a saved investigation \u2014 reuses evidence, no re-query.\n  Questions (direct answers):\n    "what evidence contradicts <topic>?"  \xB7 "what evidence is missing?"\n    "why is confidence not higher?"\n  Topic filters (deterministic scoping):\n    "focus on queue behavior" \xB7 "ignore deployment changes" \xB7 "retry"'
   ).option("-c, --config <path>", "path to horus.config.ts").option("--json", "output JSON").action(async (id, directive, opts) => {
     process.exitCode = await runAsk(id, directive, { config: opts.config, json: opts.json });
   });

package/package.json

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