@merittdev/horus 0.1.12 → 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.12" : "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));
@@ -71568,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;
@@ -71732,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) {
@@ -72850,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 = [];
@@ -73577,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,
@@ -73643,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" },
@@ -73841,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 });
@@ -73981,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();
@@ -74007,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"`));
@@ -74472,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();
@@ -74548,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);
@@ -74607,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;
@@ -74642,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}"` : "")
@@ -74766,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;
@@ -74876,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
@@ -75121,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();
@@ -75302,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(":");
@@ -75319,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;
   }
@@ -75352,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."
           )
         );
@@ -75375,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;
   }
 }
@@ -75395,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 };
@@ -75450,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."
         )
       );
@@ -75488,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,
@@ -75506,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 = "";
@@ -75606,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) => {
@@ -75725,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"
     });
@@ -75764,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)`
       )
     );
@@ -75812,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)`,
@@ -75866,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;
@@ -75887,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.`
       )
     );
@@ -75918,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.`
       )
     );
@@ -75931,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.`
       )
     );
@@ -75939,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 {
@@ -75952,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.`
       )
     );
@@ -75961,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.`
       )
     );
@@ -75978,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;
     }
   }
@@ -75996,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 {
@@ -76016,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;
@@ -76026,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;
@@ -76088,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 = [];
@@ -76110,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`
     )
   );
@@ -76149,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();
@@ -76381,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("");
@@ -76394,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` };
   }
@@ -76421,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;
@@ -76429,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_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 (.horus/config.json)")}`
+    );
+  } else if (source === "env") {
+    write(
+      `  ${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("");
@@ -76455,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: {
@@ -76507,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();
@@ -76695,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("");
@@ -76716,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;
@@ -76780,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) => {
@@ -76804,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
       });
     }
@@ -76841,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
       });
     }
   );
@@ -77015,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);
     }

package/package.json

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