@merittdev/horus 0.1.11 → 0.1.13

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.13" : "dev";
 var PINNED_AXON_VERSION = "1.0.7";
 var PINNED_SOURCE_VERSION = PINNED_AXON_VERSION;
 
@@ -54699,6 +54699,19 @@ var modelsSchema = external_exports.object({
   reasoning: external_exports.string().default("claude-opus-4-8"),
   extraction: external_exports.string().default("claude-haiku-4-5")
 });
+var AI_PROVIDERS = ["anthropic", "claude", "codex", "gemini", "kimi", "cursor"];
+var aiSchema = external_exports.object({
+  /** Preferred provider for AI narrative. */
+  provider: external_exports.enum(AI_PROVIDERS).optional(),
+  anthropic: external_exports.object({
+    /** Direct API key (takes priority over apiKeyEnv). Stored redacted in display. */
+    apiKey: external_exports.string().optional(),
+    /** Env var holding the key. Defaults to ANTHROPIC_API_KEY. */
+    apiKeyEnv: external_exports.string().optional(),
+    /** Default model for narrative generation. */
+    model: external_exports.string().optional()
+  }).optional()
+}).optional();
 var horusConfigSchema = external_exports.object({
   projects: external_exports.array(projectSchema).default([]),
   axon: external_exports.object({
@@ -54706,8 +54719,19 @@ var horusConfigSchema = external_exports.object({
     pinnedVersion: external_exports.string().default("1.0.7")
   }).default({}),
   database: databaseSchema,
-  models: modelsSchema.default({})
+  models: modelsSchema.default({}),
+  ai: aiSchema
 });
+function resolveAiSettings(config) {
+  const ai = config.ai;
+  const fromConfig = ai?.anthropic?.apiKey;
+  const key = fromConfig ?? process.env[ai?.anthropic?.apiKeyEnv ?? "ANTHROPIC_API_KEY"];
+  const out = { anthropicKeyFromConfig: fromConfig !== void 0 };
+  if (ai?.provider !== void 0) out.provider = ai.provider;
+  if (key !== void 0) out.anthropicApiKey = key;
+  if (ai?.anthropic?.model !== void 0) out.model = ai.anthropic.model;
+  return out;
+}
 function listEnvironments(config) {
   const out = [];
   for (const p of config.projects) {
@@ -54892,7 +54916,8 @@ async function loadConfigFile(target) {
       projects: file.project ? [file.project] : [],
       database: file.database ?? {
         url: process.env["DATABASE_URL"] ?? DEFAULT_DB_URL
-      }
+      },
+      ...file.ai !== void 0 ? { ai: file.ai } : {}
     };
     return parseConfig(raw, target);
   }
@@ -55307,7 +55332,7 @@ var AxonCodeProvider = class {
   }
   async searchSymbols(query, limit = 10) {
     const E = this.escapeId(query);
-    const exactQuery = `MATCH (n) WHERE toLower(n.name) = toLower("${E}") AND NOT n:File RETURN n.id, n.name, n.file_path LIMIT ${limit}`;
+    const exactQuery = `MATCH (n) WHERE toLower(n.name) = toLower("${E}") AND label(n) <> "File" RETURN n.id, n.name, n.file_path LIMIT ${limit}`;
     const [exactRows, semanticRes] = await Promise.all([
       this.rows(exactQuery).catch(() => []),
       this.client.search(query, limit)
@@ -67396,9 +67421,14 @@ async function runExplain(query, opts) {
 }
 async function isQueueBoundary(config, query) {
   try {
+    let project;
+    try {
+      project = resolveEnvironment(config).project;
+    } catch {
+    }
     const { db, sql: sql2 } = createDb(config.database.url);
     try {
-      const edges = await listQueueEdges(db, { queueName: query });
+      const edges = await listQueueEdges(db, { queueName: query, project });
       return edges.length > 0;
     } finally {
       await sql2.end().catch(() => {
@@ -67508,22 +67538,22 @@ function extractQueueGraph(input) {
     }
   }
   const producers = [];
-  for (const pc34 of input.producerClasses) {
-    for (const m of pc34.content.matchAll(INJECT_QUEUE_RE)) {
+  for (const pc35 of input.producerClasses) {
+    for (const m of pc35.content.matchAll(INJECT_QUEUE_RE)) {
       const queue = m[1] ?? "";
-      if (queue) producers.push({ queue, symbol: pc34.name, file: pc34.filePath });
+      if (queue) producers.push({ queue, symbol: pc35.name, file: pc35.filePath });
     }
-    for (const m of pc34.content.matchAll(NEW_BULL_RE)) {
+    for (const m of pc35.content.matchAll(NEW_BULL_RE)) {
       if (m[2] !== "Queue") continue;
       const queue = resolveArg(m[3] ?? "", constMap);
       if (queue) {
-        producers.push({ queue, symbol: (m[1] ?? pc34.name) || baseName(pc34.filePath), file: pc34.filePath });
+        producers.push({ queue, symbol: (m[1] ?? pc35.name) || baseName(pc35.filePath), file: pc35.filePath });
       }
     }
-    for (const m of pc34.content.matchAll(QUEUE_NAME_CONST_RE)) {
+    for (const m of pc35.content.matchAll(QUEUE_NAME_CONST_RE)) {
       const ident = m[1] ?? "";
       const queue = m[2] ?? "";
-      if (queue) producers.push({ queue, symbol: ident || baseName(pc34.filePath), file: pc34.filePath });
+      if (queue) producers.push({ queue, symbol: ident || baseName(pc35.filePath), file: pc35.filePath });
     }
   }
   const workers = [];
@@ -67796,6 +67826,13 @@ async function runQueues(name, opts) {
         }
       }
       const rows = await listQueueEdges(db, { project, queueName: name });
+      if (opts.json) {
+        const topology = topologyToJson(buildQueueMap(rows));
+        const out = { project: project ?? null, topology };
+        if (opts.live) out["live"] = await gatherLiveState(config, rows, name);
+        console.log(JSON.stringify(out, null, 2));
+        return 0;
+      }
       console.log(
         import_picocolors4.default.bold("Queue topology") + import_picocolors4.default.dim("  \xB7  source: code / source intelligence  \xB7  static (run horus index to refresh)")
       );
@@ -67837,6 +67874,55 @@ function buildQueueMap(rows) {
   }
   return byQueue;
 }
+function endpoints(edges, symKey, fileKey) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const e of edges) {
+    const symbol = e[symKey];
+    if (!symbol) continue;
+    if (!seen.has(symbol)) seen.set(symbol, { symbol, file: e[fileKey] ?? null });
+  }
+  return [...seen.values()];
+}
+function topologyToJson(byQueue) {
+  return [...byQueue.entries()].map(([queueName, edges]) => ({
+    queueName,
+    producers: endpoints(edges, "producerSymbol", "producerFile"),
+    workers: endpoints(edges, "workerSymbol", "workerFile")
+  }));
+}
+async function gatherLiveState(config, rows, nameFilter) {
+  let renv;
+  try {
+    renv = resolveEnvironment(config);
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+  const queueProvider = queueForEnv(renv);
+  if (!queueProvider) return { ok: false, error: "Redis not configured" };
+  try {
+    const health = await queueProvider.health();
+    if (!health.ok) return { ok: false, error: health.detail };
+    const staticNames = new Set(buildQueueMap(rows).keys());
+    let queueNames;
+    if (nameFilter !== void 0) {
+      queueNames = [nameFilter];
+    } else {
+      const discovered = await queueProvider.discoverQueues().catch(() => []);
+      const union2 = /* @__PURE__ */ new Set([...staticNames, ...discovered]);
+      queueNames = union2.size > 0 ? [...union2] : void 0;
+    }
+    const state = await queueProvider.analyzeQueues({ queueNames });
+    return {
+      ok: true,
+      prefix: state.prefix,
+      collectedAt: state.collectedAt,
+      queues: state.queues.map((q) => ({ ...q, runtimeOnly: !staticNames.has(q.queueName) }))
+    };
+  } finally {
+    await queueProvider.close().catch(() => {
+    });
+  }
+}
 function printTopology(byQueue) {
   for (const [queueName, edges] of byQueue) {
     console.log(import_picocolors4.default.bold(queueName));
@@ -70237,8 +70323,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 +70386,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 +70596,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;
@@ -71546,7 +71654,7 @@ async function discoverArchitecture(deps) {
   })();
   const asyncBoundaries = await (async () => {
     try {
-      const edges = await listQueueEdges(deps.db);
+      const edges = await listQueueEdges(deps.db, { project: deps.project });
       const byQueue = /* @__PURE__ */ new Map();
       for (const edge of edges) {
         const key = edge.queueName;
@@ -71710,7 +71818,7 @@ async function analyzeBlastRadius(query, deps, depth = 3) {
   ]);
   const upstream = ctx.callees;
   const downstream = impact.byDepth;
-  const edges = await listQueueEdges(deps.db);
+  const edges = await listQueueEdges(deps.db, { project: deps.project });
   const asyncDownstreamMap = /* @__PURE__ */ new Map();
   for (const edge of edges) {
     if (edge.producerFile === top.filePath || edge.producerSymbol === top.name) {
@@ -72551,6 +72659,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) {
@@ -72667,7 +72936,11 @@ function filterArchitecture(architecture, tokens) {
   };
 }
 async function buildOnboarding(input, deps) {
-  const architecture = await discoverArchitecture({ code: deps.code, db: deps.db });
+  const architecture = await discoverArchitecture({
+    code: deps.code,
+    db: deps.db,
+    project: deps.project
+  });
   const area = input.area?.trim();
   let filteredArchitecture = architecture;
   let pastIncidents = [];
@@ -73394,18 +73667,76 @@ Hard rules:
 - only include services from: ${input.knownServices.join(", ")}
 - hypothesisJudgments must only reference hypothesis IDs from the hypotheses list above
 - verdict must be exactly one of: supported, weakened, eliminated, unconfirmed
-- uncertainty must be exactly one of: low, medium, high`;
+- uncertainty must be exactly one of: low, medium, high
+- output raw JSON only: no markdown code fences, no text before or after the JSON`;
 }
-function parseOutput(raw, input, ceiling) {
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    const jsonMatch = raw.match(/\{[\s\S]*\}/);
-    if (!jsonMatch) {
-      throw new Error("Anthropic response did not contain a JSON object");
+function sliceBalancedObjects(s) {
+  const out = [];
+  let depth = 0;
+  let start = -1;
+  let inStr = false;
+  let escaped = false;
+  for (let i = 0; i < s.length; i++) {
+    const ch = s[i];
+    if (inStr) {
+      if (escaped) escaped = false;
+      else if (ch === "\\") escaped = true;
+      else if (ch === '"') inStr = false;
+      continue;
+    }
+    if (ch === '"') inStr = true;
+    else if (ch === "{") {
+      if (depth === 0) start = i;
+      depth++;
+    } else if (ch === "}") {
+      if (depth > 0) {
+        depth--;
+        if (depth === 0 && start !== -1) out.push(s.slice(start, i + 1));
+      }
     }
-    parsed = JSON.parse(jsonMatch[0]);
+  }
+  return out.sort((a, b2) => b2.length - a.length);
+}
+function stripTrailingCommas(s) {
+  return s.replace(/,(\s*[}\]])/g, "$1");
+}
+function extractJson(raw) {
+  const candidates = [];
+  const trimmed = raw.trim();
+  candidates.push(trimmed);
+  const fence = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/i);
+  if (fence?.[1]) candidates.push(fence[1].trim());
+  candidates.push(...sliceBalancedObjects(trimmed));
+  for (const c of candidates) {
+    for (const variant of [c, stripTrailingCommas(c)]) {
+      try {
+        const parsed = JSON.parse(variant);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+          return parsed;
+        }
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+function rawNarrativeFallback(raw, input, ceiling) {
+  const cleaned = raw.replace(/```(?:json)?/gi, "").trim();
+  return {
+    what: input.deterministicSummary || "AI returned an unstructured response.",
+    why: cleaned.slice(0, 4e3),
+    whereNext: [],
+    citations: [],
+    confidence: Math.min(input.reportConfidence, ceiling)
+  };
+}
+function parseOutput(raw, input, ceiling) {
+  const parsed = extractJson(raw);
+  if (parsed === null) {
+    console.error(
+      `[ai] structured JSON parse failed (response length ${raw.length}); preserving raw narrative fallback`
+    );
+    return rawNarrativeFallback(raw, input, ceiling);
   }
   const confidence = Math.min(
     typeof parsed["confidence"] === "number" ? parsed["confidence"] : input.reportConfidence,
@@ -73460,6 +73791,13 @@ init_cjs_shims();
 
 // ../../packages/ai/src/local-providers.ts
 init_cjs_shims();
+var LOCAL_PROVIDER_IDS = [
+  "codex",
+  "claude",
+  "kimi",
+  "gemini",
+  "cursor"
+];
 var DEFAULT_DESCRIPTORS = [
   { id: "codex", displayName: "OpenAI Codex CLI" },
   { id: "claude", displayName: "Anthropic Claude" },
@@ -73658,8 +73996,12 @@ async function runInvestigate(hint, opts) {
       const rendered = format === "json" ? reportToJSON(report) : format === "markdown" || format === "md" ? reportToMarkdown(report) : renderReport2(report);
       console.log(rendered);
       if (opts.ai && format !== "json") {
-        const model = opts.aiModel ?? "claude-opus-4-8";
-        const provider = opts._aiProvider ?? new AnthropicNarrativeProvider({ model });
+        const ai = resolveAiSettings(config);
+        const model = opts.aiModel ?? ai.model ?? "claude-opus-4-8";
+        const provider = opts._aiProvider ?? new AnthropicNarrativeProvider({
+          model,
+          ...ai.anthropicApiKey !== void 0 ? { apiKey: ai.anthropicApiKey } : {}
+        });
         console.log(import_picocolors5.default.dim(`[ai] model: ${model}`));
         const narrativeInput = buildNarrativeInput(report);
         const { output, fromProvider, validationErrors } = await renderNarrative(narrativeInput, { provider });
@@ -73714,6 +74056,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 +74073,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 +74101,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 +74113,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 }
@@ -73779,9 +74140,14 @@ async function runArchitecture(opts) {
       );
       return 1;
     }
+    let project;
+    try {
+      project = resolveEnvironment(config, { project: opts.repo }).project;
+    } catch {
+    }
     const { db, sql: sql2 } = createDb(config.database.url);
     try {
-      const m = await discoverArchitecture({ code, db });
+      const m = await discoverArchitecture({ code, db, project });
       console.log(opts.json ? architectureToJSON(m) : renderArchitecture(m));
     } finally {
       await sql2.end();
@@ -73805,9 +74171,14 @@ async function runBlastRadius(query, opts) {
       console.error(import_picocolors10.default.red("Source-intelligence host unreachable \u2014 run: horus index"));
       return 1;
     }
+    let project;
+    try {
+      project = resolveEnvironment(config, { project: opts.repo }).project;
+    } catch {
+    }
     const { db, sql: sql2 } = createDb(config.database.url);
     try {
-      const r = await analyzeBlastRadius(query, { code, db }, opts.depth ?? 3);
+      const r = await analyzeBlastRadius(query, { code, db, project }, opts.depth ?? 3);
       if (!r) {
         console.log(`No symbol found for: ${query}`);
         console.log(import_picocolors10.default.dim(`  Tip: use an exact class or function name, e.g. "MyService"`));
@@ -74213,6 +74584,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) {
@@ -74265,7 +74641,10 @@ async function runOnboard(area, opts) {
     }
     const { db, sql: sql2 } = createDb(config.database.url);
     try {
-      const g = await buildOnboarding({ area }, { code, db, repoPath: repo.path });
+      const g = await buildOnboarding(
+        { area },
+        { code, db, repoPath: repo.path, project: renv.project }
+      );
       console.log(opts.json ? onboardingToJSON(g) : renderOnboarding(g));
     } finally {
       await sql2.end();
@@ -74341,6 +74720,10 @@ function sinceToIso(since) {
   const msMap = { m: 6e4, h: 36e5, d: 864e5 };
   return new Date(Date.now() - (msMap[unit] ?? 6e4) * amount).toISOString();
 }
+function resolveRawLevel(opts) {
+  if (opts.allLevels) return void 0;
+  return opts.level ?? "error";
+}
 function levelColor(level, text2) {
   if (level === "error" || level === "fatal") return import_picocolors20.default.red(text2);
   if (level === "warn") return import_picocolors20.default.yellow(text2);
@@ -74400,13 +74783,45 @@ async function runLogs(service, opts) {
     const from = sinceToIso(opts.since) ?? new Date(Date.now() - 7 * 864e5).toISOString();
     const fromDisplay = from.slice(0, 16).replace("T", " ");
     if (opts.raw === true) {
+      const rawLevel = resolveRawLevel(opts);
+      const limit = opts.limit !== void 0 ? Math.min(Number(opts.limit), 1e3) : 20;
       const records = await logs.searchLogs({
         service: resolvedService,
         from,
-        level: opts.level,
+        level: rawLevel,
         text: opts.grep,
-        limit: opts.limit !== void 0 ? Number(opts.limit) : 20
+        limit
       });
+      if (opts.json) {
+        console.log(
+          JSON.stringify(
+            {
+              scope: {
+                project: renv.project,
+                env: renv.env,
+                service: resolvedService ?? null,
+                index: indexPattern,
+                from,
+                level: rawLevel ?? "all",
+                grep: opts.grep ?? null
+              },
+              records: records.map((r) => ({
+                timestamp: r.timestamp,
+                level: r.level,
+                service: r.service ?? null,
+                component: r.component ?? null,
+                eventCode: r.eventCode ?? null,
+                message: r.message,
+                traceId: r.traceId ?? null,
+                requestId: r.requestId ?? null
+              }))
+            },
+            null,
+            2
+          )
+        );
+        return 0;
+      }
       if (records.length === 0) {
         console.log(import_picocolors20.default.dim("No logs matched."));
         return 0;
@@ -74435,6 +74850,30 @@ async function runLogs(service, opts) {
         scopeService = void 0;
       }
     }
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            scope: {
+              project: renv.project,
+              env: renv.env,
+              service: scopeService ?? null,
+              index: indexPattern,
+              from,
+              severity: "error+",
+              grep: opts.grep ?? null
+            },
+            totalErrors: analysis.totalErrors,
+            signatures: analysis.signatures,
+            newSignatures: analysis.newSignatures,
+            affectedServices: analysis.affectedServices
+          },
+          null,
+          2
+        )
+      );
+      return 0;
+    }
     console.log(
       import_picocolors20.default.bold(`Error analysis`) + import_picocolors20.default.dim(
         ` \u2014 ${renv.project}/${renv.env}` + (scopeService ? ` \xB7 service ${scopeService}` : "") + (opts.grep ? ` \xB7 grep "${opts.grep}"` : "")
@@ -74559,6 +74998,25 @@ async function runMetrics(hint, opts) {
     const from = to - dur;
     if (opts.query !== void 0 && opts.query !== "") {
       const series = await metrics.rawRange(opts.query, from, to, stepNum);
+      if (opts.json === true) {
+        console.log(
+          JSON.stringify(
+            {
+              query: opts.query,
+              from,
+              to,
+              step: stepNum,
+              series: series.map((s) => {
+                const summary = summarize(s);
+                return { labels: s.labels, last: summary.last, avg: summary.avg };
+              })
+            },
+            null,
+            2
+          )
+        );
+        return 0;
+      }
       if (series.length === 0) {
         console.log(import_picocolors21.default.dim("No series returned."));
         return 0;
@@ -74669,6 +75127,23 @@ async function runState(opts) {
       const analysis = await mongo.analyzeState(
         staleHours !== void 0 ? { staleHours } : {}
       );
+      if (opts.json) {
+        const staleSignals = analysis.collections.filter((c) => c.isStale === true).length;
+        const anomalousSignals = analysis.collections.reduce((n, c) => n + c.anomalies.length, 0);
+        console.log(
+          JSON.stringify(
+            {
+              scope: { project: renv.project, env: renv.env, database: analysis.database },
+              autoDiscovered: analysis.autoDiscovered,
+              signals: { stale: staleSignals, anomalous: anomalousSignals },
+              collections: analysis.collections
+            },
+            null,
+            2
+          )
+        );
+        return 0;
+      }
       const discoveryNote = analysis.autoDiscovered ? import_picocolors22.default.dim(` (${analysis.collections.length} collections, auto-discovered)`) : "";
       console.log(
         import_picocolors22.default.bold("State analysis") + import_picocolors22.default.dim(` \u2014 ${renv.project}/${renv.env} \xB7 db ${analysis.database}`) + discoveryNote
@@ -74914,8 +75389,8 @@ async function runSetup(opts) {
 // ../../packages/cli/src/commands/connect.ts
 init_cjs_shims();
 var import_node_readline = require("readline");
-var import_node_child_process5 = require("child_process");
-var import_picocolors27 = __toESM(require_picocolors(), 1);
+var import_node_child_process6 = require("child_process");
+var import_picocolors28 = __toESM(require_picocolors(), 1);
 
 // ../../packages/cli/src/lib/tty-selector.ts
 init_cjs_shims();
@@ -75095,6 +75570,122 @@ async function checkboxSearch(opts) {
   });
 }
 
+// ../../packages/cli/src/commands/connect-ai.ts
+init_cjs_shims();
+var import_node_child_process5 = require("child_process");
+var import_picocolors27 = __toESM(require_picocolors(), 1);
+function cliInstalled(id) {
+  const r = (0, import_node_child_process5.spawnSync)(id, ["--version"], { stdio: "ignore", timeout: 2e3 });
+  return !r.error;
+}
+async function probeAnthropic(apiKey) {
+  try {
+    const res = await fetch("https://api.anthropic.com/v1/models?limit=1", {
+      headers: { "x-api-key": apiKey, "anthropic-version": "2023-06-01" },
+      signal: AbortSignal.timeout(8e3)
+    });
+    if (res.ok) return { ok: true, detail: "API key valid" };
+    if (res.status === 401) return { ok: false, detail: "invalid API key (401)" };
+    return { ok: false, detail: `HTTP ${res.status}` };
+  } catch (err) {
+    return { ok: false, detail: err.message };
+  }
+}
+function redactKey(key) {
+  if (key.length <= 12) return "***";
+  return `${key.slice(0, 7)}\u2026${key.slice(-4)}`;
+}
+async function runConnectAi(opts) {
+  try {
+    const cwd = process.cwd();
+    const root = findRepoRoot(cwd) ?? cwd;
+    const configPath = discoverLocalConfig(cwd) ?? localConfigPath(root);
+    const installed = LOCAL_PROVIDER_IDS.filter((id) => cliInstalled(id));
+    console.log(import_picocolors27.default.bold("\nAI providers"));
+    console.log(
+      import_picocolors27.default.dim(
+        `  Local CLIs on PATH: ${installed.length > 0 ? installed.join(", ") : "none detected"}`
+      )
+    );
+    console.log(import_picocolors27.default.dim("  Cloud: anthropic (Anthropic Claude API \u2014 used by `investigate --ai`)\n"));
+    let provider = opts.provider;
+    if (provider === void 0) {
+      if (isInteractive()) {
+        const answer = (await ask("Provider", "anthropic", false)).trim().toLowerCase();
+        provider = answer || "anthropic";
+      } else {
+        provider = "anthropic";
+      }
+    }
+    if (!AI_PROVIDERS.includes(provider)) {
+      console.error(import_picocolors27.default.red(`Unknown AI provider: ${provider}`) + import_picocolors27.default.dim(`
+  supported: ${AI_PROVIDERS.join(", ")}`));
+      return 1;
+    }
+    const aiBlock = { provider };
+    let storedKey;
+    if (provider === "anthropic") {
+      let apiKey = opts.apiKey;
+      if (!apiKey && isInteractive()) {
+        apiKey = await askPassword("Anthropic API key") || void 0;
+      }
+      if (!apiKey) {
+        console.error(
+          import_picocolors27.default.red("No API key provided.") + import_picocolors27.default.dim("\n  Pass --api-key sk-ant-\u2026 or set ANTHROPIC_API_KEY and re-run.")
+        );
+        return 1;
+      }
+      if (!opts.noTest) {
+        const probe2 = await probeAnthropic(apiKey);
+        if (!probe2.ok) {
+          console.error(`
+${import_picocolors27.default.red("\u2717 Anthropic key check failed:")} ${probe2.detail}`);
+          console.error(import_picocolors27.default.dim("  Fix the key and retry, or pass --no-test to skip."));
+          return 1;
+        }
+        console.log(`
+${import_picocolors27.default.green("\u2713")} anthropic ${import_picocolors27.default.dim(`(${probe2.detail})`)}`);
+      }
+      const anthropic = { apiKey };
+      if (opts.model) anthropic["model"] = opts.model;
+      aiBlock["anthropic"] = anthropic;
+      storedKey = apiKey;
+    } else {
+      if (!installed.includes(provider)) {
+        console.error(
+          import_picocolors27.default.red(`${provider} CLI not found on PATH.`) + import_picocolors27.default.dim(`
+  Install it first, or choose anthropic.`)
+        );
+        return 1;
+      }
+      const desc2 = DEFAULT_LOCAL_PROVIDER_REGISTRY.get(provider);
+      console.log(`
+${import_picocolors27.default.green("\u2713")} ${desc2?.displayName ?? provider} ${import_picocolors27.default.dim("detected on PATH")}`);
+      console.log(
+        import_picocolors27.default.dim(
+          "  Note: `investigate --ai` currently uses the Anthropic API for narrative.\n  Local-CLI narrative generation is recorded as your preference for future use."
+        )
+      );
+    }
+    const file = discoverLocalConfig(cwd) ? readLocalConfig(configPath) : { version: 1, project: { name: root.split("/").pop() ?? "project", repositories: [{ name: root.split("/").pop() ?? "project", path: root }], environments: [{ name: "production", readOnly: true, connectors: {} }] } };
+    file.ai = aiBlock;
+    writeLocalConfig(root, file);
+    if (storedKey !== void 0) {
+      ensureCredentialGitignore(root);
+      ensureProjectGitignore(root);
+    }
+    console.log(`
+${import_picocolors27.default.green("\u2713")} ${import_picocolors27.default.bold("ai")} provider saved \u2192 ${import_picocolors27.default.dim(configPath)}`);
+    console.log(import_picocolors27.default.dim(`  provider: ${provider}`));
+    if (storedKey) console.log(import_picocolors27.default.dim(`  anthropic key: ${redactKey(storedKey)}`));
+    console.log(import_picocolors27.default.dim('  run: horus investigate "<hint>" --ai'));
+    return 0;
+  } catch (err) {
+    console.error(import_picocolors27.default.red(err instanceof Error ? err.message : String(err)));
+    return 1;
+  }
+}
+
 // ../../packages/cli/src/commands/connect.ts
 function parseDbSpec(spec) {
   const [dbPart, rolesPart] = spec.split(":");
@@ -75112,10 +75703,18 @@ function parseDbSpec(spec) {
 }
 var SUPPORTED = ["elasticsearch", "mongodb", "grafana", "redis"];
 async function runConnect(type, opts) {
+  if (type === "ai") {
+    return runConnectAi({
+      provider: opts.provider,
+      apiKey: opts.apiKey,
+      model: opts.aiModel,
+      noTest: opts.noTest
+    });
+  }
   if (!SUPPORTED.includes(type)) {
     console.error(
-      import_picocolors27.default.red(`Unknown connector type: ${type}`) + import_picocolors27.default.dim(`
-  supported: ${SUPPORTED.join(", ")}`)
+      import_picocolors28.default.red(`Unknown connector type: ${type}`) + import_picocolors28.default.dim(`
+  supported: ${SUPPORTED.join(", ")}, ai`)
     );
     return 1;
   }
@@ -75145,20 +75744,20 @@ async function runConnect(type, opts) {
       if (!probeResult.ok) {
         console.error(
           `
-${import_picocolors27.default.red(`\u2717 Could not reach ${connectorType}:`)} ${probeResult.detail}` + import_picocolors27.default.dim("\n  Fix the connection and retry, or pass --no-test to skip.")
+${import_picocolors28.default.red(`\u2717 Could not reach ${connectorType}:`)} ${probeResult.detail}` + import_picocolors28.default.dim("\n  Fix the connection and retry, or pass --no-test to skip.")
         );
         return 1;
       }
       console.log(
         `
-${import_picocolors27.default.green("\u2713")} ${connectorType} reachable ${import_picocolors27.default.dim(`(${probeResult.detail})`)}`
+${import_picocolors28.default.green("\u2713")} ${connectorType} reachable ${import_picocolors28.default.dim(`(${probeResult.detail})`)}`
       );
     }
     const hasLiteralCredentials = filled.url !== void 0 || filled.password !== void 0 || filled.username !== void 0;
     if (hasLiteralCredentials) {
       if (isGitTracked(configPath, root)) {
         console.error(
-          import_picocolors27.default.red(".horus/config.json is already tracked by Git.") + "\nStoring credentials here would expose them in the repository.\n" + import_picocolors27.default.dim(
+          import_picocolors28.default.red(".horus/config.json is already tracked by Git.") + "\nStoring credentials here would expose them in the repository.\n" + import_picocolors28.default.dim(
             "  Option A \u2014 remove from Git index then re-run:\n    git rm --cached .horus/config.json\n    horus connect " + type + " ...\n\n  Option B \u2014 keep credentials in the environment and reference them:\n    export ES_URL=https://...\n    export ES_USERNAME=...\n    export ES_PASSWORD=...\n  Then edit .horus/config.json manually to use urlEnv/usernameEnv/passwordEnv."
           )
         );
@@ -75168,18 +75767,18 @@ ${import_picocolors27.default.green("\u2713")} ${connectorType} reachable ${impo
     }
     patchLocalConnector(configPath, connectorType, patch, filled.env);
     console.log(
-      `${import_picocolors27.default.green("\u2713")} ${import_picocolors27.default.bold(connectorType)} connector saved \u2192 ${import_picocolors27.default.dim(configPath)}`
+      `${import_picocolors28.default.green("\u2713")} ${import_picocolors28.default.bold(connectorType)} connector saved \u2192 ${import_picocolors28.default.dim(configPath)}`
     );
     printSummary(connectorType, filled);
-    console.log(import_picocolors27.default.dim(`
+    console.log(import_picocolors28.default.dim(`
   run: horus investigate "<hint>"`));
     return 0;
   } catch (err) {
     if (err instanceof ExitPromptError) {
-      console.error(import_picocolors27.default.red("Cancelled."));
+      console.error(import_picocolors28.default.red("Cancelled."));
       return 1;
     }
-    console.error(import_picocolors27.default.red(err.message));
+    console.error(import_picocolors28.default.red(err.message));
     return 1;
   }
 }
@@ -75188,7 +75787,7 @@ async function fillInteractive(type, opts) {
   if (!needsInteraction) return opts;
   console.log(
     `
-${import_picocolors27.default.bold(`Connect ${type}`)} ${import_picocolors27.default.dim("(press Enter to skip optional fields)")}
+${import_picocolors28.default.bold(`Connect ${type}`)} ${import_picocolors28.default.dim("(press Enter to skip optional fields)")}
 `
   );
   const filled = { ...opts };
@@ -75243,7 +75842,7 @@ ${import_picocolors27.default.bold(`Connect ${type}`)} ${import_picocolors27.def
       break;
     case "redis": {
       console.log(
-        import_picocolors27.default.dim(
+        import_picocolors28.default.dim(
           "  Tip: embed credentials directly in the URL \u2014 redis://:password@host:6379\n       or enter the URL and password separately below."
         )
       );
@@ -75281,8 +75880,8 @@ function missingRequired(type, opts) {
 }
 function ask(label, placeholder = "", required = true) {
   return new Promise((resolve8) => {
-    const hint = placeholder ? import_picocolors27.default.dim(` (${placeholder})`) : "";
-    const suffix = required ? "" : import_picocolors27.default.dim(" [optional]");
+    const hint = placeholder ? import_picocolors28.default.dim(` (${placeholder})`) : "";
+    const suffix = required ? "" : import_picocolors28.default.dim(" [optional]");
     process.stdout.write(`  ${label}${suffix}${hint}: `);
     const rl = (0, import_node_readline.createInterface)({
       input: process.stdin,
@@ -75299,7 +75898,7 @@ function askPassword(label) {
   return new Promise((resolve8) => {
     const stdin = process.stdin;
     if (typeof stdin.setRawMode === "function") {
-      process.stdout.write(`  ${label}${import_picocolors27.default.dim(" [optional]")}: `);
+      process.stdout.write(`  ${label}${import_picocolors28.default.dim(" [optional]")}: `);
       stdin.setRawMode(true);
       stdin.resume();
       let value = "";
@@ -75399,15 +75998,15 @@ function describeProbe(p) {
   return `${p.keyCount} keys \xB7 ${p.suggestedRoles.join("/")}${examples ? ` \xB7 ${examples}` : ""}`;
 }
 async function discoverAndSelectDbs(url, bullmqPrefix) {
-  console.log(import_picocolors27.default.dim("\n  Scanning DBs 0-15 (read-only, sampled)\u2026"));
+  console.log(import_picocolors28.default.dim("\n  Scanning DBs 0-15 (read-only, sampled)\u2026"));
   const probes = await probeRedisDatabases(url, { bullmqPrefix });
   const nonEmpty = probes.filter((p) => p.reachable && p.keyCount > 0);
   if (nonEmpty.length === 0) {
-    console.log(import_picocolors27.default.dim("  No populated DBs found."));
+    console.log(import_picocolors28.default.dim("  No populated DBs found."));
     return [];
   }
   for (const p of nonEmpty) {
-    console.log(`  ${import_picocolors27.default.bold(`DB ${p.db}`)} ${import_picocolors27.default.dim("\xB7 " + describeProbe(p))}`);
+    console.log(`  ${import_picocolors28.default.bold(`DB ${p.db}`)} ${import_picocolors28.default.dim("\xB7 " + describeProbe(p))}`);
   }
   const byLabel = /* @__PURE__ */ new Map();
   const choices = nonEmpty.map((p) => {
@@ -75518,11 +76117,11 @@ function printSummary(type, opts) {
   } else if (opts.dashboard) {
     lines.push(`  dashboard:      ${opts.dashboard}`);
   }
-  if (lines.length > 0) console.log(import_picocolors27.default.dim(lines.join("\n")));
+  if (lines.length > 0) console.log(import_picocolors28.default.dim(lines.join("\n")));
 }
 function isGitTracked(filePath, cwd) {
   try {
-    (0, import_node_child_process5.execFileSync)("git", ["ls-files", "--error-unmatch", filePath], {
+    (0, import_node_child_process6.execFileSync)("git", ["ls-files", "--error-unmatch", filePath], {
       cwd,
       stdio: "pipe"
     });
@@ -75557,11 +76156,11 @@ async function askIndexSelection(indices) {
   const shown = indices.slice(0, MAX_DISPLAY);
   console.log("\n  Available Elasticsearch indexes/data streams:");
   shown.forEach((name, i) => {
-    console.log(`  ${import_picocolors27.default.dim(`[${i + 1}]`)} ${name}`);
+    console.log(`  ${import_picocolors28.default.dim(`[${i + 1}]`)} ${name}`);
   });
   if (indices.length > MAX_DISPLAY) {
     console.log(
-      import_picocolors27.default.dim(
+      import_picocolors28.default.dim(
         `  \u2026 and ${indices.length - MAX_DISPLAY} more (type a pattern manually to match all)`
       )
     );
@@ -75605,11 +76204,11 @@ async function askDashboardSelection(dashboards) {
   const shown = dashboards.slice(0, MAX_DISPLAY);
   console.log("\n  Available Grafana dashboards:");
   shown.forEach((d, i) => {
-    const folder = d.folderTitle ? import_picocolors27.default.dim(` (${d.folderTitle})`) : "";
-    console.log(`  ${import_picocolors27.default.dim(`[${i + 1}]`)} ${d.title}${folder}`);
+    const folder = d.folderTitle ? import_picocolors28.default.dim(` (${d.folderTitle})`) : "";
+    console.log(`  ${import_picocolors28.default.dim(`[${i + 1}]`)} ${d.title}${folder}`);
   });
   if (dashboards.length > MAX_DISPLAY) {
-    console.log(import_picocolors27.default.dim(`  \u2026 and ${dashboards.length - MAX_DISPLAY} more`));
+    console.log(import_picocolors28.default.dim(`  \u2026 and ${dashboards.length - MAX_DISPLAY} more`));
   }
   const input = (await ask(
     `  Select dashboards to use (e.g. 1,2 or Enter to type uid manually)`,
@@ -75659,12 +76258,12 @@ function redactUrl(raw) {
 
 // ../../packages/cli/src/commands/stop.ts
 init_cjs_shims();
-var import_node_child_process6 = require("child_process");
+var import_node_child_process7 = require("child_process");
 var import_node_fs7 = require("fs");
 var import_node_util4 = require("util");
 var import_node_path9 = require("path");
-var import_picocolors28 = __toESM(require_picocolors(), 1);
-var execFileAsync = (0, import_node_util4.promisify)(import_node_child_process6.execFile);
+var import_picocolors29 = __toESM(require_picocolors(), 1);
+var execFileAsync = (0, import_node_util4.promisify)(import_node_child_process7.execFile);
 var unlinkAsync = (0, import_node_util4.promisify)(import_node_fs7.unlink);
 var SPAWNED_HOST_FILE2 = "spawned-host.json";
 var START_TIME_TOLERANCE_S = 60;
@@ -75680,30 +76279,30 @@ async function runStop(opts) {
     const root = findRepoRoot(cwd) ?? cwd;
     const hostUrl = readSourceHostUrl(root);
     if (!hostUrl) {
-      console.log(import_picocolors28.default.dim("No source-intelligence host found for this repo (.horus/source/host.json absent)."));
+      console.log(import_picocolors29.default.dim("No source-intelligence host found for this repo (.horus/source/host.json absent)."));
       return 0;
     }
     return await stopHost(root, hostUrl);
   } catch (err) {
-    console.error(import_picocolors28.default.red(err.message));
+    console.error(import_picocolors29.default.red(err.message));
     return 1;
   }
 }
 async function stopHost(root, hostUrl) {
   const alive = await isHostHealthy(hostUrl);
   if (!alive) {
-    console.log(import_picocolors28.default.dim(`Host ${hostUrl} is already stopped.`));
+    console.log(import_picocolors29.default.dim(`Host ${hostUrl} is already stopped.`));
     return 0;
   }
   const port = extractPort(hostUrl);
   if (port === null) {
-    console.error(import_picocolors28.default.red(`Cannot determine port from host URL: ${hostUrl}`));
+    console.error(import_picocolors29.default.red(`Cannot determine port from host URL: ${hostUrl}`));
     return 1;
   }
   const spawned = readSpawnedHost(root);
   if (spawned === null) {
     console.error(
-      import_picocolors28.default.red(
+      import_picocolors29.default.red(
         `No ownership record found (.horus/${SPAWNED_HOST_FILE2} absent). Horus will not stop a host it did not spawn.`
       )
     );
@@ -75711,12 +76310,12 @@ async function stopHost(root, hostUrl) {
   }
   const recordError = validateSpawnedRecord(spawned);
   if (recordError !== null) {
-    console.error(import_picocolors28.default.red(`Ownership record is malformed: ${recordError}. Aborting for safety.`));
+    console.error(import_picocolors29.default.red(`Ownership record is malformed: ${recordError}. Aborting for safety.`));
     return 1;
   }
   if (spawned.port !== port) {
     console.error(
-      import_picocolors28.default.red(
+      import_picocolors29.default.red(
         `Ownership record port (${spawned.port}) does not match host URL port (${port}). Record may be stale.`
       )
     );
@@ -75724,7 +76323,7 @@ async function stopHost(root, hostUrl) {
   }
   if (spawned.root !== root) {
     console.error(
-      import_picocolors28.default.red(
+      import_picocolors29.default.red(
         `Ownership record root (${spawned.root}) does not match resolved root (${root}). Record may be stale.`
       )
     );
@@ -75732,7 +76331,7 @@ async function stopHost(root, hostUrl) {
   }
   const info = await getProcessInfo(spawned.pid);
   if (info === null) {
-    console.log(import_picocolors28.default.dim(`Process pid ${spawned.pid} is no longer running \u2014 already stopped.`));
+    console.log(import_picocolors29.default.dim(`Process pid ${spawned.pid} is no longer running \u2014 already stopped.`));
     try {
       await unlinkAsync((0, import_node_path9.join)(root, HORUS_DIR, SPAWNED_HOST_FILE2));
     } catch {
@@ -75745,7 +76344,7 @@ async function stopHost(root, hostUrl) {
   );
   if (!hostPortRe.test(info.args)) {
     console.error(
-      import_picocolors28.default.red(
+      import_picocolors29.default.red(
         `Pid ${spawned.pid} args do not match "horus-source host --port ${portStr}". Got: "${info.args.slice(0, 120)}". Aborting for safety.`
       )
     );
@@ -75754,12 +76353,12 @@ async function stopHost(root, hostUrl) {
   const startTs = new Date(spawned.startedAt).getTime();
   const recordedAgeS = Math.round((Date.now() - startTs) / 1e3);
   if (!Number.isFinite(info.etimeSeconds)) {
-    console.error(import_picocolors28.default.red(`Could not read elapsed time for pid ${spawned.pid}. Aborting for safety.`));
+    console.error(import_picocolors29.default.red(`Could not read elapsed time for pid ${spawned.pid}. Aborting for safety.`));
     return 1;
   }
   if (Math.abs(info.etimeSeconds - recordedAgeS) > START_TIME_TOLERANCE_S) {
     console.error(
-      import_picocolors28.default.red(
+      import_picocolors29.default.red(
         `Pid ${spawned.pid} age mismatch: record says ~${recordedAgeS}s, process reports ${info.etimeSeconds}s elapsed. Possible PID reuse \u2014 aborting for safety.`
       )
     );
@@ -75771,9 +76370,9 @@ async function stopHost(root, hostUrl) {
     signaled = true;
   } catch (err) {
     if (err.code === "ESRCH") {
-      console.log(import_picocolors28.default.dim(`Process pid ${spawned.pid} exited before signal \u2014 already stopped.`));
+      console.log(import_picocolors29.default.dim(`Process pid ${spawned.pid} exited before signal \u2014 already stopped.`));
     } else {
-      console.error(import_picocolors28.default.red(`Failed to signal pid ${spawned.pid}: ${err.message}`));
+      console.error(import_picocolors29.default.red(`Failed to signal pid ${spawned.pid}: ${err.message}`));
       return 1;
     }
   }
@@ -75789,14 +76388,14 @@ async function stopHost(root, hostUrl) {
     }
     if (!exited) {
       console.error(
-        import_picocolors28.default.red(
+        import_picocolors29.default.red(
           `Host pid ${spawned.pid} did not exit within ${STOP_WAIT_MS / 1e3}s after SIGTERM.`
         )
       );
       return 1;
     }
     console.log(
-      `${import_picocolors28.default.green("\u2713")} Stopped source-intelligence host ` + import_picocolors28.default.dim(`(pid ${spawned.pid}, port ${port})`) + ` for ${root}`
+      `${import_picocolors29.default.green("\u2713")} Stopped source-intelligence host ` + import_picocolors29.default.dim(`(pid ${spawned.pid}, port ${port})`) + ` for ${root}`
     );
   }
   try {
@@ -75809,7 +76408,7 @@ async function stopAll() {
   const registry = readRegistry();
   const projects2 = Object.entries(registry.projects);
   if (projects2.length === 0) {
-    console.log(import_picocolors28.default.dim("No registered projects."));
+    console.log(import_picocolors29.default.dim("No registered projects."));
     return 0;
   }
   let stopped = 0;
@@ -75819,17 +76418,17 @@ async function stopAll() {
     if (!hostUrl) continue;
     const alive = await isHostHealthy(hostUrl);
     if (!alive) continue;
-    console.log(`  Stopping ${import_picocolors28.default.bold(name)} ${import_picocolors28.default.dim(`(${hostUrl})`)}`);
+    console.log(`  Stopping ${import_picocolors29.default.bold(name)} ${import_picocolors29.default.dim(`(${hostUrl})`)}`);
     const code = await stopHost(entry2.root, hostUrl);
     if (code === 0) stopped++;
     else failed++;
   }
   if (stopped === 0 && failed === 0) {
-    console.log(import_picocolors28.default.dim("No running source-intelligence hosts found."));
+    console.log(import_picocolors29.default.dim("No running source-intelligence hosts found."));
   } else {
     console.log(
       `
-Stopped ${stopped} host(s)${failed > 0 ? import_picocolors28.default.red(`, ${failed} failed`) : ""}.`
+Stopped ${stopped} host(s)${failed > 0 ? import_picocolors29.default.red(`, ${failed} failed`) : ""}.`
     );
   }
   return failed > 0 ? 1 : 0;
@@ -75881,12 +76480,12 @@ function extractPort(hostUrl) {
 
 // ../../packages/cli/src/commands/hosts.ts
 init_cjs_shims();
-var import_picocolors29 = __toESM(require_picocolors(), 1);
+var import_picocolors30 = __toESM(require_picocolors(), 1);
 async function runHosts() {
   const registry = readRegistry();
   const projects2 = Object.entries(registry.projects);
   if (projects2.length === 0) {
-    console.log(import_picocolors29.default.dim("No registered projects. Run `horus index` in a repo first."));
+    console.log(import_picocolors30.default.dim("No registered projects. Run `horus index` in a repo first."));
     return 0;
   }
   const rows = [];
@@ -75903,29 +76502,29 @@ async function runHosts() {
   });
   const anyHost = rows.some((r) => r.hostUrl !== null);
   if (!anyHost) {
-    console.log(import_picocolors29.default.dim("No source-intelligence hosts found. Run `horus index` to start one."));
+    console.log(import_picocolors30.default.dim("No source-intelligence hosts found. Run `horus index` to start one."));
     return 0;
   }
   console.log("");
   for (const row of rows) {
     if (row.hostUrl === null) continue;
-    const status = row.healthy ? import_picocolors29.default.green("\u25CF running") : import_picocolors29.default.red("\u25CF stopped");
+    const status = row.healthy ? import_picocolors30.default.green("\u25CF running") : import_picocolors30.default.red("\u25CF stopped");
     const port = extractPort2(row.hostUrl) ?? "?";
     console.log(
-      `  ${status}  ${import_picocolors29.default.bold(row.name.padEnd(24))} port ${String(port).padEnd(6)} ${import_picocolors29.default.dim(row.root)}`
+      `  ${status}  ${import_picocolors30.default.bold(row.name.padEnd(24))} port ${String(port).padEnd(6)} ${import_picocolors30.default.dim(row.root)}`
     );
   }
   console.log("");
   const noHost = rows.filter((r) => r.hostUrl === null);
   if (noHost.length > 0) {
     for (const row of noHost) {
-      console.log(`  ${import_picocolors29.default.dim("\u25CB no host")}   ${import_picocolors29.default.dim(row.name)}`);
+      console.log(`  ${import_picocolors30.default.dim("\u25CB no host")}   ${import_picocolors30.default.dim(row.name)}`);
     }
     console.log("");
   }
   const running = rows.filter((r) => r.healthy).length;
   console.log(
-    import_picocolors29.default.dim(
+    import_picocolors30.default.dim(
       `${running} running \xB7 horus stop to reap \xB7 horus stop --all to stop everything`
     )
   );
@@ -75942,12 +76541,12 @@ function extractPort2(hostUrl) {
 
 // ../../packages/cli/src/commands/doctor.ts
 init_cjs_shims();
-var import_picocolors30 = __toESM(require_picocolors(), 1);
+var import_picocolors31 = __toESM(require_picocolors(), 1);
 var DEFAULT_DB_URL4 = "postgresql://horus:horus@localhost:5433/horus";
 function mark2(status) {
-  if (status === "pass") return import_picocolors30.default.green("\u2713");
-  if (status === "warn") return import_picocolors30.default.yellow("~");
-  return import_picocolors30.default.red("\u2717");
+  if (status === "pass") return import_picocolors31.default.green("\u2713");
+  if (status === "warn") return import_picocolors31.default.yellow("~");
+  return import_picocolors31.default.red("\u2717");
 }
 async function runDoctor(opts) {
   const cwd = opts?.cwd ?? process.cwd();
@@ -76174,11 +76773,11 @@ async function runDoctor(opts) {
     write(JSON.stringify(output, null, 2));
     return hasFailure ? 1 : 0;
   }
-  write(import_picocolors30.default.bold("\nHorus readiness check\n"));
+  write(import_picocolors31.default.bold("\nHorus readiness check\n"));
   for (const check of checks) {
-    write(`  ${mark2(check.status)} ${import_picocolors30.default.bold(check.label.padEnd(26))}  ${import_picocolors30.default.dim(check.detail)}`);
+    write(`  ${mark2(check.status)} ${import_picocolors31.default.bold(check.label.padEnd(26))}  ${import_picocolors31.default.dim(check.detail)}`);
     if (check.next) {
-      write(`    ${import_picocolors30.default.dim("\u2192 " + check.next)}`);
+      write(`    ${import_picocolors31.default.dim("\u2192 " + check.next)}`);
     }
   }
   write("");
@@ -76187,20 +76786,20 @@ async function runDoctor(opts) {
 
 // ../../packages/cli/src/commands/providers-doctor.ts
 init_cjs_shims();
-var import_node_child_process7 = require("child_process");
-var import_picocolors31 = __toESM(require_picocolors(), 1);
+var import_node_child_process8 = require("child_process");
+var import_picocolors32 = __toESM(require_picocolors(), 1);
 function statusMark(status) {
-  if (status === "ready") return import_picocolors31.default.green("\u2713");
-  if (status === "installed") return import_picocolors31.default.yellow("~");
-  return import_picocolors31.default.red("\u2717");
+  if (status === "ready") return import_picocolors32.default.green("\u2713");
+  if (status === "installed") return import_picocolors32.default.yellow("~");
+  return import_picocolors32.default.red("\u2717");
 }
 function statusLabel(status) {
-  if (status === "ready") return import_picocolors31.default.green("ready");
-  if (status === "installed") return import_picocolors31.default.yellow("installed (not configured)");
-  return import_picocolors31.default.dim("not found on PATH");
+  if (status === "ready") return import_picocolors32.default.green("ready");
+  if (status === "installed") return import_picocolors32.default.yellow("installed (not configured)");
+  return import_picocolors32.default.dim("not found on PATH");
 }
 function detectBinary(id) {
-  const result = (0, import_node_child_process7.spawnSync)(id, ["--version"], { stdio: "pipe", timeout: 2e3 });
+  const result = (0, import_node_child_process8.spawnSync)(id, ["--version"], { stdio: "pipe", timeout: 2e3 });
   if (result.error) {
     return { id, status: "unavailable", detail: `${id}: command not found` };
   }
@@ -76214,7 +76813,7 @@ async function runProvidersDoctorCommand(opts) {
   const registry = opts?.registry ?? DEFAULT_LOCAL_PROVIDER_REGISTRY;
   const write = opts?.write ?? ((line2) => console.log(line2));
   const results = buildProviderResults(registry, opts?._detect);
-  write(import_picocolors31.default.bold("\nLocal AI providers\n"));
+  write(import_picocolors32.default.bold("\nLocal AI providers\n"));
   for (const result of results) {
     const descriptor = registry.get(result.id);
     const name = descriptor?.displayName ?? result.id;
@@ -76222,22 +76821,37 @@ async function runProvidersDoctorCommand(opts) {
       `  ${statusMark(result.status)} ${result.id.padEnd(8)}  ${name.padEnd(22)}  ${statusLabel(result.status)}`
     );
     if (result.status !== "ready" && result.detail) {
-      write(`    ${import_picocolors31.default.dim("\u2192 " + result.detail)}`);
+      write(`    ${import_picocolors32.default.dim("\u2192 " + result.detail)}`);
     }
   }
   write("");
-  write(import_picocolors31.default.bold("Cloud AI providers\n"));
-  const anthropicKey = opts?._anthropicKey !== void 0 ? opts._anthropicKey : process.env["ANTHROPIC_API_KEY"] ?? null;
-  if (anthropicKey) {
+  write(import_picocolors32.default.bold("Cloud AI providers\n"));
+  let source = null;
+  if (opts?._anthropicKey !== void 0) {
+    source = opts._anthropicKey ? "env" : null;
+  } else {
+    try {
+      const config = await loadConfig(opts?.config);
+      const ai = resolveAiSettings(config);
+      if (ai.anthropicApiKey) source = ai.anthropicKeyFromConfig ? "config" : "env";
+    } catch {
+      if (process.env["ANTHROPIC_API_KEY"]) source = "env";
+    }
+  }
+  if (source === "config") {
+    write(
+      `  ${import_picocolors32.default.green("\u2713")} ${"anthropic".padEnd(8)}  ${"Anthropic Claude API".padEnd(22)}  ${import_picocolors32.default.green("configured (.horus/config.json)")}`
+    );
+  } else if (source === "env") {
     write(
-      `  ${import_picocolors31.default.green("\u2713")} ${"anthropic".padEnd(8)}  ${"Anthropic Claude API".padEnd(22)}  ${import_picocolors31.default.green("ANTHROPIC_API_KEY configured")}`
+      `  ${import_picocolors32.default.green("\u2713")} ${"anthropic".padEnd(8)}  ${"Anthropic Claude API".padEnd(22)}  ${import_picocolors32.default.green("configured (ANTHROPIC_API_KEY env)")}`
     );
   } else {
     write(
-      `  ${import_picocolors31.default.red("\u2717")} ${"anthropic".padEnd(8)}  ${"Anthropic Claude API".padEnd(22)}  ${import_picocolors31.default.dim("ANTHROPIC_API_KEY not set")}`
+      `  ${import_picocolors32.default.red("\u2717")} ${"anthropic".padEnd(8)}  ${"Anthropic Claude API".padEnd(22)}  ${import_picocolors32.default.dim("not configured")}`
     );
     write(
-      `    ${import_picocolors31.default.dim('\u2192 set ANTHROPIC_API_KEY=<key> to enable AI-powered investigation (horus investigate "hint" --ai)')}`
+      `    ${import_picocolors32.default.dim("\u2192 run `horus connect ai` (or set ANTHROPIC_API_KEY) to enable `horus investigate --ai`")}`
     );
   }
   write("");
@@ -76248,7 +76862,7 @@ async function runProvidersDoctorCommand(opts) {
 init_cjs_shims();
 var import_node_fs8 = require("fs");
 var import_node_path10 = require("path");
-var import_picocolors32 = __toESM(require_picocolors(), 1);
+var import_picocolors33 = __toESM(require_picocolors(), 1);
 function configTemplate(name, repoPath) {
   return `export default {
   database: {
@@ -76300,40 +76914,40 @@ async function runGenerateConfig(opts) {
   const name = opts.name ?? defaults?.name ?? "my-project";
   const repoPath = opts.repo ?? defaults?.repoPath ?? `/path/to/${name}`;
   if ((0, import_node_fs8.existsSync)(outPath) && !opts.force) {
-    log(`${import_picocolors32.default.red("\u2717")} ${outPath} already exists`);
-    log(import_picocolors32.default.dim("  pass --force to overwrite"));
+    log(`${import_picocolors33.default.red("\u2717")} ${outPath} already exists`);
+    log(import_picocolors33.default.dim("  pass --force to overwrite"));
     return 1;
   }
   try {
     (0, import_node_fs8.mkdirSync)((0, import_node_path10.dirname)(outPath), { recursive: true });
     (0, import_node_fs8.writeFileSync)(outPath, configTemplate(name, repoPath), "utf8");
   } catch (err) {
-    log(`${import_picocolors32.default.red("\u2717")} Could not write ${outPath}: ${err.message}`);
+    log(`${import_picocolors33.default.red("\u2717")} Could not write ${outPath}: ${err.message}`);
     return 1;
   }
-  log(`${import_picocolors32.default.green("\u2713")} Created ${outPath}`);
-  log(import_picocolors32.default.dim(`  project: ${name}`));
-  log(import_picocolors32.default.dim(`  repo:    ${repoPath}`));
+  log(`${import_picocolors33.default.green("\u2713")} Created ${outPath}`);
+  log(import_picocolors33.default.dim(`  project: ${name}`));
+  log(import_picocolors33.default.dim(`  repo:    ${repoPath}`));
   if (hasLocalConfig && localConfigPath2 != null) {
     log("");
-    log(import_picocolors32.default.yellow("Note:") + ` an initialized Horus project config exists at ${localConfigPath2}`);
+    log(import_picocolors33.default.yellow("Note:") + ` an initialized Horus project config exists at ${localConfigPath2}`);
     log("  \u2022 .horus/config.json  \u2014 project config used by `horus investigate` from this repo");
     log("  \u2022 horus.config.js     \u2014 standalone/global config used with `horus doctor --config <path>`");
-    log(import_picocolors32.default.dim(`  next:  review ${outPath} and copy/adapt it as needed`));
+    log(import_picocolors33.default.dim(`  next:  review ${outPath} and copy/adapt it as needed`));
   } else {
-    log(import_picocolors32.default.dim(`  next:    horus doctor --config ${outPath}`));
+    log(import_picocolors33.default.dim(`  next:    horus doctor --config ${outPath}`));
   }
   return 0;
 }
 
 // ../../packages/cli/src/commands/readiness.ts
 init_cjs_shims();
-var import_picocolors33 = __toESM(require_picocolors(), 1);
+var import_picocolors34 = __toESM(require_picocolors(), 1);
 var DEFAULT_DB_URL5 = "postgresql://horus:horus@localhost:5433/horus";
 function mark3(status) {
-  if (status === "pass") return import_picocolors33.default.green("\u2713");
-  if (status === "warn") return import_picocolors33.default.yellow("~");
-  return import_picocolors33.default.red("\u2717");
+  if (status === "pass") return import_picocolors34.default.green("\u2713");
+  if (status === "warn") return import_picocolors34.default.yellow("~");
+  return import_picocolors34.default.red("\u2717");
 }
 async function runReadiness(opts) {
   const cwd = opts?.cwd ?? process.cwd();
@@ -76488,20 +77102,20 @@ async function runReadiness(opts) {
   }
   const blockingChecks = checks.filter((c) => c.blocking);
   const optionalChecks = checks.filter((c) => !c.blocking);
-  write(import_picocolors33.default.bold("\nHorus release readiness\n"));
-  write(import_picocolors33.default.bold("  Blocking"));
+  write(import_picocolors34.default.bold("\nHorus release readiness\n"));
+  write(import_picocolors34.default.bold("  Blocking"));
   for (const check of blockingChecks) {
-    write(`    ${mark3(check.status)} ${import_picocolors33.default.bold(check.label.padEnd(22))}  ${import_picocolors33.default.dim(check.detail)}`);
+    write(`    ${mark3(check.status)} ${import_picocolors34.default.bold(check.label.padEnd(22))}  ${import_picocolors34.default.dim(check.detail)}`);
     if (check.next) {
-      write(`      ${import_picocolors33.default.dim("\u2192 " + check.next)}`);
+      write(`      ${import_picocolors34.default.dim("\u2192 " + check.next)}`);
     }
   }
   write("");
-  write(import_picocolors33.default.bold("  Optional"));
+  write(import_picocolors34.default.bold("  Optional"));
   for (const check of optionalChecks) {
-    write(`    ${mark3(check.status)} ${import_picocolors33.default.bold(check.label.padEnd(22))}  ${import_picocolors33.default.dim(check.detail)}`);
+    write(`    ${mark3(check.status)} ${import_picocolors34.default.bold(check.label.padEnd(22))}  ${import_picocolors34.default.dim(check.detail)}`);
     if (check.next) {
-      write(`      ${import_picocolors33.default.dim("\u2192 " + check.next)}`);
+      write(`      ${import_picocolors34.default.dim("\u2192 " + check.next)}`);
     }
   }
   write("");
@@ -76509,21 +77123,21 @@ async function runReadiness(opts) {
   const optionalWarns = optionalChecks.filter((c) => c.status === "warn").length;
   if (blockingFails.length === 0) {
     if (optionalWarns === 0) {
-      write(import_picocolors33.default.green("  Ready for demo/release."));
+      write(import_picocolors34.default.green("  Ready for demo/release."));
     } else {
       write(
-        import_picocolors33.default.yellow(
+        import_picocolors34.default.yellow(
           `  Ready for a basic demo. ${optionalWarns} optional item(s) not configured \u2014 investigation evidence will be limited.`
         )
       );
     }
   } else {
     write(
-      import_picocolors33.default.red(
+      import_picocolors34.default.red(
         `  Not ready. ${blockingFails.length} blocking item(s) must be resolved before demo/release.`
       )
     );
-    write(import_picocolors33.default.dim("  Re-run `horus readiness` after resolving the items above."));
+    write(import_picocolors34.default.dim("  Re-run `horus readiness` after resolving the items above."));
   }
   write("");
   return blockingFails.length > 0 ? 1 : 0;
@@ -76573,8 +77187,8 @@ Examples:
     process.exitCode = await runReadiness({ config: opts.config });
   });
   program2.command("connect <type>").description(
-    "Add or update a runtime connector (elasticsearch / mongodb / grafana / redis) in .horus/config.json"
-  ).option("--env <name>", "target environment (default: first environment in config)").option("--url <url>", "connector URL or connection string (Redis with auth: redis://:password@host:6379)").option("--username <user>", "username (elasticsearch / grafana)").option("--password <pass>", "password (elasticsearch / grafana; for Redis embed in --url)").option("--index-pattern <pattern>", "Elasticsearch index pattern (required for elasticsearch)").option("--service <name>", "service name scope for log queries").option("--database <name>", "database name (required for mongodb)").option("--collections <list>", "comma-separated collection allowlist (mongodb)").option("--dashboard <uid>", "default dashboard uid (grafana)").option(
+    "Add or update a connector (elasticsearch / mongodb / grafana / redis / ai) in .horus/config.json"
+  ).option("--env <name>", "target environment (default: first environment in config)").option("--provider <name>", "AI provider for `connect ai` (anthropic / claude / codex / gemini)").option("--api-key <key>", "Anthropic API key for `connect ai`").option("--model <id>", "default model for `connect ai`").option("--url <url>", "connector URL or connection string (Redis with auth: redis://:password@host:6379)").option("--username <user>", "username (elasticsearch / grafana)").option("--password <pass>", "password (elasticsearch / grafana; for Redis embed in --url)").option("--index-pattern <pattern>", "Elasticsearch index pattern (required for elasticsearch)").option("--service <name>", "service name scope for log queries").option("--database <name>", "database name (required for mongodb)").option("--collections <list>", "comma-separated collection allowlist (mongodb)").option("--dashboard <uid>", "default dashboard uid (grafana)").option(
     "--db <spec>",
     "redis logical DB as db:role1,role2 (e.g. 0:cache,state or 1:bullmq,queues); repeatable",
     (val, acc) => {
@@ -76597,6 +77211,9 @@ Examples:
         db: opts.db,
         bullmqPrefix: opts.bullmqPrefix,
         scanDbs: opts.scanDbs,
+        provider: opts.provider,
+        apiKey: opts.apiKey,
+        aiModel: opts.model,
         noTest: opts.test === false
       });
     }
@@ -76634,13 +77251,14 @@ Examples:
       process.exitCode = await runIndex(opts);
     }
   );
-  program2.command("queues [name]").description("Show queue topology from source intelligence; --live adds real-time Redis/BullMQ state").option("-c, --config <path>", "path to horus.config.ts").option("--name <name>", "registered project name (resolves via registry)").option("--project <name>", "filter edges by project").option("--live", "fetch real-time queue depths and failed-job counts from Redis/BullMQ").action(
+  program2.command("queues [name]").description("Show queue topology from source intelligence; --live adds real-time Redis/BullMQ state").option("-c, --config <path>", "path to horus.config.ts").option("--name <name>", "registered project name (resolves via registry)").option("--project <name>", "filter edges by project").option("--live", "fetch real-time queue depths and failed-job counts from Redis/BullMQ").option("--json", "output JSON").action(
     async (name, opts) => {
       process.exitCode = await runQueues(name, {
         config: opts.config,
         name: opts.name,
         project: opts.project,
-        live: opts.live
+        live: opts.live,
+        json: opts.json
       });
     }
   );
@@ -76677,13 +77295,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 +77400,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 });
   });
@@ -76807,14 +77426,14 @@ Examples:
   });
   program2.command("logs [service]").description(
     "Synthesize error evidence from logs (signatures, first/last, affected services); --raw for lines"
-  ).option("-c, --config <path>", "path to horus.config.ts").option("--name <name>", "registered project name (resolves via the registry)").option("--project <name>", "project name").option("--env <name>", "environment name (e.g. production)").option("--since <when>", "time window, e.g. 24h, 7d, or an ISO date").option("--level <level>", "minimum level (with --raw): trace|debug|info|warn|error|fatal").option("--grep <text>", "match text in the message").option("--raw", "dump individual log lines instead of synthesized evidence").option("--limit <n>", "max records (with --raw)").action(
+  ).option("-c, --config <path>", "path to horus.config.ts").option("--name <name>", "registered project name (resolves via the registry)").option("--project <name>", "project name").option("--env <name>", "environment name (e.g. production)").option("--since <when>", "time window, e.g. 24h, 7d, or an ISO date").option("--level <level>", "minimum level (with --raw): trace|debug|info|warn|error|fatal").option("--grep <text>", "match text in the message").option("--raw", "dump individual log lines instead of synthesized evidence (error+ by default)").option("--all-levels", "with --raw: show all severity levels, not just error+").option("--limit <n>", "max records (with --raw)").option("--json", "output JSON").action(
     async (service, opts) => {
       process.exitCode = await runLogs(service, opts);
     }
   );
   program2.command("state").description(
     "Surface application-state evidence from MongoDB (read-only, allowlisted): counts, staleness, anomalous statuses"
-  ).option("-c, --config <path>", "path to horus.config.ts").option("--name <name>", "registered project name (resolves via the registry)").option("--project <name>", "project name").option("--env <name>", "environment name (e.g. production)").option("--stale-hours <n>", "staleness threshold in hours (default 24)").action(
+  ).option("-c, --config <path>", "path to horus.config.ts").option("--name <name>", "registered project name (resolves via the registry)").option("--project <name>", "project name").option("--env <name>", "environment name (e.g. production)").option("--stale-hours <n>", "staleness threshold in hours (default 24)").option("--json", "output JSON").action(
     async (opts) => {
       process.exitCode = await runState(opts);
     }