@orquentra/codebuddy 2.14.0 → 2.15.1

package/dist/{main-SFC5LV4E.js → main-QF6Z552J.js}

@@ -1,21 +1,12 @@
-import {
-  isDockerDaemonRunning,
-  tryStartDockerDesktop,
-  waitForDockerDaemon
-} from "./chunk-5UH3BEQR.js";
-import {
-  postgresDown,
-  postgresStatus,
-  postgresUp
-} from "./chunk-CSRD5OQA.js";
 import {
   runPreToolHookCommand
 } from "./chunk-UOTKHSQ5.js";
 import {
-  failSoft,
-  readHookInput,
-  writeStdout
-} from "./chunk-FJOTP632.js";
+  LOCAL_LLM_SIZES,
+  addLocalLlm,
+  printLocalLlmStatus,
+  removeLocalLlm
+} from "./chunk-K4XNTYV7.js";
 import {
   WORKFLOW_CLIENTS,
   clientDisplayName,
@@ -41,7 +32,43 @@ import {
   setHooks,
   uninstallClient,
   writeProjectMcpConfig
-} from "./chunk-L6BRYZ6G.js";
+} from "./chunk-PZ4EBFIA.js";
+import {
+  renderLeanBlock,
+  runLeanHook
+} from "./chunk-AFXWCSQ4.js";
+import {
+  isDockerDaemonRunning,
+  tryStartDockerDesktop,
+  waitForDockerDaemon
+} from "./chunk-5UH3BEQR.js";
+import {
+  postgresDown,
+  postgresStatus,
+  postgresUp
+} from "./chunk-CSRD5OQA.js";
+import {
+  failSoft,
+  readHookInput,
+  writeStdout
+} from "./chunk-FJOTP632.js";
+import {
+  loadLlmSummaries,
+  summarizeRepository
+} from "./chunk-7JPUMXFE.js";
+import {
+  listIndexFacts,
+  pruneIndexFacts
+} from "./chunk-BNZDEU5K.js";
+import {
+  chatJson,
+  coolingDown,
+  usageToday
+} from "./chunk-MNSMW4MZ.js";
+import {
+  runIndexModelPass
+} from "./chunk-VF7DKRIU.js";
+import "./chunk-6OQKL35B.js";
 import {
   AUTOMATION_MODES,
   CLIENT_ADAPTERS,
@@ -52,10 +79,6 @@ import {
   parseMode,
   supportedModes
 } from "./chunk-V7PT6ER5.js";
-import {
-  renderLeanBlock,
-  runLeanHook
-} from "./chunk-LRQNPYCK.js";
 import {
   TELEMETRY_NOTICE,
   findReuse,
@@ -72,12 +95,7 @@ import {
   traceCliCommand,
   watchRepository,
   writeTelemetryState
-} from "./chunk-YJPCS2GP.js";
-import {
-  DEFAULT_ZVEC_MODEL,
-  buildZvecIndex,
-  zvecStatus
-} from "./chunk-LW75SKZR.js";
+} from "./chunk-GNV4X67F.js";
 import {
   HookStagingStore,
   PlanFileStore,
@@ -107,7 +125,7 @@ import {
   runStageHook,
   runSyncHook,
   syncReuseVectors
-} from "./chunk-XSNW6Y3X.js";
+} from "./chunk-OO7Q7XZF.js";
 import {
   parseTraceLines,
   readTraces,
@@ -117,12 +135,33 @@ import {
   SessionCapsuleLedger,
   detectTestCommand,
   estimateTokens
-} from "./chunk-4DKYKDHI.js";
+} from "./chunk-7IPSDDO5.js";
 import {
   hookRoot
 } from "./chunk-TGFTKWOR.js";
 import "./chunk-GQKWUHMA.js";
 import "./chunk-DFV2SK6C.js";
+import {
+  DEFAULT_ZVEC_MODEL,
+  buildZvecIndex,
+  zvecStatus
+} from "./chunk-RKF4HBBQ.js";
+import {
+  buildArchitectureMap,
+  generateGraphifyGraph,
+  indexRepository,
+  loadFreshIndex,
+  loadGraphifyMap,
+  loadProjectArchitectureMap,
+  neighbours,
+  queryMap,
+  setupGraphify,
+  syncFileVectors
+} from "./chunk-4DTO2E4Y.js";
+import {
+  extractSymbolTable,
+  supportsSymbols
+} from "./chunk-Y7D7PUBE.js";
 import {
   bootstrapDatabase,
   buildProviderFromConfig,
@@ -134,57 +173,25 @@ import {
   pingDatabase,
   runDoctor,
   runMigrations
-} from "./chunk-YWDH6DQ6.js";
+} from "./chunk-IM5RFEW4.js";
+import "./chunk-57642NGU.js";
 import {
   MemoryFileStore,
   VERSION
-} from "./chunk-7QMHIJBA.js";
+} from "./chunk-VBDM7HC5.js";
 import {
   computeFactHash,
   generateEntityId
-} from "./chunk-CAEPHLHC.js";
-import "./chunk-6JCKMIQY.js";
-import {
-  localRuntimeInstalled,
-  modelCacheDir
-} from "./chunk-3QGW53GD.js";
-import {
-  loadLlmSummaries,
-  summarizeRepository
-} from "./chunk-ESC4Y3L7.js";
-import {
-  chatJson,
-  coolingDown,
-  usageToday
-} from "./chunk-ESZXCZIN.js";
-import {
-  buildArchitectureMap,
-  generateGraphifyGraph,
-  indexRepository,
-  loadFreshIndex,
-  loadGraphifyMap,
-  loadProjectArchitectureMap,
-  neighbours,
-  queryMap,
-  setupGraphify,
-  syncFileVectors
-} from "./chunk-YNSTIMCF.js";
-import {
-  extractSymbolTable,
-  supportsSymbols
-} from "./chunk-Y7D7PUBE.js";
+} from "./chunk-EMWGLKPR.js";
 import {
   redactPersisted
 } from "./chunk-AL6VBTNA.js";
+import "./chunk-6JCKMIQY.js";
 import {
-  DEFAULT_CLOUD_EMBEDDING_MODELS,
-  DEFAULT_RERANK_MODELS,
-  LOCAL_EMBEDDING_MODEL,
-  getModelDefinition
-} from "./chunk-HPOR6YXA.js";
-import {
+  mergeGlobalConfig,
+  readGlobalConfig,
   resolveLlmConfig
-} from "./chunk-SFMIMLXR.js";
+} from "./chunk-RGIVHKBH.js";
 import {
   PLAN_POLICIES,
   configPath,
@@ -202,10 +209,21 @@ import {
   setPlanPolicy,
   setZvecEnabled,
   writeConfigFile
-} from "./chunk-KNR2P2UY.js";
+} from "./chunk-Y4QQML24.js";
 import {
   writeAtomic
 } from "./chunk-CG5B3LYG.js";
+import "./chunk-NNJSAYHY.js";
+import {
+  localRuntimeInstalled,
+  modelCacheDir
+} from "./chunk-3QGW53GD.js";
+import {
+  DEFAULT_CLOUD_EMBEDDING_MODELS,
+  DEFAULT_RERANK_MODELS,
+  LOCAL_EMBEDDING_MODEL,
+  getModelDefinition
+} from "./chunk-HPOR6YXA.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/cli/main.ts
@@ -1988,8 +2006,9 @@ var KEY_ENV = { groq: "GROQ_API_KEY", openrouter: "OPENROUTER_API_KEY" };
 var WATCH_BATCH = 8;
 async function llmStatusReport(root, env = process.env) {
   const block = (await readConfigFile(root)).llm;
-  const provider = block?.provider ?? "groq";
   const config = await resolveLlmConfig(root, env);
+  const provider = config.enabled ? config.provider : block?.provider ?? "groq";
+  const keyName = provider === "local" ? "" : KEY_ENV[provider];
   const model = config.enabled ? config.model : block?.model ?? null;
   const key = `${provider}:${model}`;
   const { manifest } = await loadFreshIndex(root);
@@ -1998,8 +2017,9 @@ async function llmStatusReport(root, env = process.env) {
     reason: config.enabled ? "on" : config.reason,
     provider,
     model,
-    keyEnv: env.CODEBUDDY_LLM_API_KEY ? "CODEBUDDY_LLM_API_KEY" : KEY_ENV[provider],
-    keyPresent: Boolean(env.CODEBUDDY_LLM_API_KEY || env[KEY_ENV[provider]]),
+    keyEnv: provider === "local" ? "none needed" : env.CODEBUDDY_LLM_API_KEY ? "CODEBUDDY_LLM_API_KEY" : keyName,
+    // Enabled implies a key (environment or saved by `codebuddy`).
+    keyPresent: provider === "local" || config.enabled || Boolean(env.CODEBUDDY_LLM_API_KEY || env[keyName]),
     features: config.enabled ? config.features : null,
     usageToday: (await usageToday(root))[key] ?? 0,
     dailyTokenBudget: config.enabled ? config.dailyTokenBudget : block?.dailyTokenBudget ?? 4e5,
@@ -2040,7 +2060,7 @@ function registerLlmCommands(program, runSafely2) {
       if (!report.keyPresent) console.log(pc8.dim(`next: export ${report.keyEnv}=<your key>`));
     });
   });
-  llm.command("enable").option("--provider <provider>", "groq or openrouter", "groq").option("--model <model>", "Model id (default: llama-3.1-8b-instant on groq).").description("Turn the layer on in .codebuddy/config.json (the key stays in your environment).").action(async (opts) => {
+  llm.command("enable").option("--provider <provider>", "groq or openrouter", "groq").option("--model <model>", "Model id (default: qwen/qwen3.8-27b).").description("Turn the layer on in .codebuddy/config.json (the key stays in your environment).").action(async (opts) => {
     await runSafely2(async () => {
       if (opts.provider !== "groq" && opts.provider !== "openrouter") {
         throw new Error("--provider must be groq or openrouter");
@@ -2087,7 +2107,7 @@ function registerLlmCommands(program, runSafely2) {
         onProgress: (done, total) => console.log(pc8.dim(`summarized ${done}/${total}`))
       });
       console.log(
-        `${result.summarized} summarized, ${result.skipped} skipped, ${result.remaining} remaining (${result.stoppedBy})`
+        `${result.summarized} summarized, ${result.skipped} skipped, ${result.timedOut} timed out, ${result.remaining} remaining (${result.stoppedBy})`
       );
     });
   });
@@ -2096,20 +2116,31 @@ function registerLlmCommands(program, runSafely2) {
 // src/cli/commands/indexing.ts
 var VECTOR_BUDGET_MS = 10 * 6e4;
 function registerIndexCommands(program, runSafely2) {
-  program.command("index").option("--full", "Re-summarize every file, ignoring existing content hashes.").option("--json", "Print machine-readable JSON.").option("--no-vectors", "Skip embedding source files for task \u2192 file ordering.").description("Index the repository: content hashes and lightweight file summaries.").action(async (opts) => {
+  program.command("index").option("--full", "Re-summarize every file, ignoring existing content hashes.").option("--json", "Print machine-readable JSON.").option("--no-vectors", "Skip embedding source files for task \u2192 file ordering.").option(
+    "--cards",
+    "Also write intent cards and index facts with the local (or BYOK) model, then embed the cards."
+  ).description("Index the repository: content hashes and lightweight file summaries.").action(async (opts) => {
     await runSafely2(async () => {
       const result = await indexRepository({ ...opts.full ? { full: true } : {} });
       const local = opts.vectors && (await loadRuntimeConfig(process.cwd(), { requireDatabase: false }).catch(() => null))?.provider.type === "local";
       const vectorStarted = Date.now();
       const vectors = local ? await syncFileVectors(process.cwd(), VECTOR_BUDGET_MS) : null;
       const reuseVectors = local ? await syncReuseVectors(process.cwd(), VECTOR_BUDGET_MS - (Date.now() - vectorStarted)) : null;
+      const cardsStarted = Date.now();
+      const model = opts.cards ? await runIndexModelPass(process.cwd(), {
+        ...opts.json ? {} : {
+          onProgress: (done, total) => process.stderr.write(`\r  cards: ${done}/${total}`)
+        }
+      }) : null;
+      if (model && !opts.json) process.stderr.write("\n");
       if (opts.json) {
         console.log(
           JSON.stringify(
             {
               ...result,
               ...vectors ? { vectors } : {},
-              ...reuseVectors ? { reuseVectors } : {}
+              ...reuseVectors ? { reuseVectors } : {},
+              ...model ? { model: { ...model, ms: Date.now() - cardsStarted } } : {}
             },
             null,
             2
@@ -2127,6 +2158,7 @@ function registerIndexCommands(program, runSafely2) {
       } else if (local) {
         console.log(pc9.dim("  file vectors: skipped (local embedding runtime not available)"));
       }
+      if (model) printModelPass(model, Date.now() - cardsStarted);
     });
   });
   program.command("watch").option("--debounce <ms>", "Coalesce file-change bursts within this window.", Number).option("--no-llm", "Do not write BYOK model summaries after index passes.").description("Watch the repository and incrementally re-index on change (Ctrl+C to stop).").action(async (opts) => {
@@ -2153,6 +2185,30 @@ function registerIndexCommands(program, runSafely2) {
     });
   });
 }
+function printModelPass(model, ms) {
+  if (!model.cards && !model.facts) {
+    console.log(pc9.dim("  cards: skipped (no model; codebuddy models add local-llm)"));
+    return;
+  }
+  if (model.cards?.stoppedBy === "locked") {
+    console.log(
+      pc9.yellow(`  cards: already being written by pid ${model.cards.lockedBy ?? "unknown"}`)
+    );
+    return;
+  }
+  if (model.cards) {
+    console.log(
+      pc9.dim(
+        `  cards: ${model.cards.summarized} written, ${model.cards.timedOut ? `${model.cards.timedOut} timed out, ` : ""}${model.cards.remaining} left (${model.cards.stoppedBy}), ${model.cardVectors} embedded, ${Math.round(ms / 1e3)} s`
+      )
+    );
+  }
+  if (model.facts) {
+    console.log(
+      pc9.dim(`  index facts: ${model.facts.written} written, ${model.facts.removed} replaced`)
+    );
+  }
+}
 function printResult(result, compact = false) {
   const summary = `${result.totalIndexed} indexed (${pc9.green(`+${result.added}`)} ${pc9.yellow(`~${result.changed}`)} ${pc9.dim(`=${result.unchanged}`)} ${pc9.red(`-${result.removed}`)}) in ${result.durationMs}ms`;
   console.log(compact ? pc9.dim(summary) : summary);
@@ -2474,6 +2530,36 @@ import { relative as relative3 } from "path";
 import pc13 from "picocolors";
 function registerMemoryCommands(program, runSafely2) {
   const memory = program.command("memory").description("Inspect and curate CodeBuddy memory.");
+  memory.command("list").option(
+    "--origin <origin>",
+    "Only facts from this origin: index (extracted from the repository)."
+  ).option("--json", "Print machine-readable JSON.").description("List durable facts (Markdown under .codebuddy/memory/facts/).").action(async (opts) => {
+    await runSafely2(async () => {
+      if (opts.origin !== void 0 && opts.origin !== "index") {
+        throw new Error(`Unknown origin "${opts.origin}"; supported: index.`);
+      }
+      const facts = opts.origin === void 0 ? await new MemoryFileStore().listFacts() : await listIndexFacts(process.cwd());
+      if (opts.json) {
+        console.log(JSON.stringify(facts, null, 2));
+        return;
+      }
+      if (facts.length === 0) console.log(pc13.dim("no facts"));
+      for (const fact of facts) {
+        const source = fact.verification[0] ?? fact.paths[0];
+        console.log(`${pc13.cyan(fact.id)} ${fact.content}${source ? pc13.dim(` [${source}]`) : ""}`);
+      }
+    });
+  });
+  memory.command("prune").requiredOption("--origin <origin>", "Which facts to delete: index.").description("Delete facts by origin (index: re-extracted on the next index pass).").action(async (opts) => {
+    await runSafely2(async () => {
+      if (opts.origin !== "index")
+        throw new Error(`Unknown origin "${opts.origin}"; supported: index.`);
+      const removed = await pruneIndexFacts(process.cwd());
+      console.log(
+        `${removed} index fact(s) removed ${pc13.dim("(run `codebuddy hooks sync` to update the database)")}`
+      );
+    });
+  });
   const review = memory.command("review").description("Review memory candidates captured automatically after turns.");
   review.command("list", { isDefault: true }).option("--json", "Print machine-readable JSON.").description("List pending review candidates.").action(async (opts) => {
     await runSafely2(async () => {
@@ -2945,13 +3031,17 @@ async function printStatus() {
       );
     }
   }
+  {
+    const { cardProgress } = await import("./summaries-W2J5FCLG.js");
+    await printLocalLlmStatus(await cardProgress(process.cwd()).catch(() => null));
+  }
   console.log(pc14.bold("Memory index"));
   if (process.env.CODEBUDDY_SEMANTIC === "0") {
     console.log(row("recall", warn("CODEBUDDY_SEMANTIC=0: lexical only")));
   }
   if (!config.postgresUrl) {
     console.log(row("postgres", warn("not configured: recall is lexical only")));
-    next.push("codebuddy use   (sets up PostgreSQL)");
+    next.push("codebuddy   (sets up PostgreSQL)");
   } else {
     const counts = await vectorCounts(
       config.postgresUrl,
@@ -3070,6 +3160,29 @@ before keeping one on. A reranker never admits a fact, it only orders them.`
         console.log(pc14.dim("  Run codebuddy models pull to download it now."));
     });
   });
+  models.command("add").argument("<name>", "Optional model to install: local-llm.").option("--size <size>", `Local LLM size: ${LOCAL_LLM_SIZES.join(" | ")}.`, "default").option("-y, --yes", "Install the runtime without asking.").description(
+    "Download the optional local LLM (Qwen3-0.6B by default) that writes file cards and index facts."
+  ).action(async (name2, opts) => {
+    await runSafely2(async () => {
+      if (name2 !== "local-llm") throw new Error(`Unknown model "${name2}"; try: local-llm.`);
+      if (!LOCAL_LLM_SIZES.includes(opts.size)) {
+        throw new Error(`--size must be one of ${LOCAL_LLM_SIZES.join(", ")}.`);
+      }
+      const added = await addLocalLlm({
+        size: opts.size,
+        ...opts.yes ? { yes: true } : {}
+      });
+      if (!added) process.exitCode = 1;
+    });
+  });
+  models.command("remove").argument("<name>", "Optional model to remove: local-llm.").description(
+    "Delete the local LLM weights; CodeBuddy falls back to keyword/vector-only behaviour."
+  ).action(async (name2) => {
+    await runSafely2(async () => {
+      if (name2 !== "local-llm") throw new Error(`Unknown model "${name2}"; try: local-llm.`);
+      await removeLocalLlm();
+    });
+  });
   models.command("pull").description("Download the local models now instead of on first use.").action(async () => {
     await runSafely2(async () => {
       const { LocalModelProvider, rerankLocally } = await import("./local-ST4WMRCG.js");
@@ -4887,54 +5000,10 @@ function registerTelemetryCommands(program, runSafely2) {
 }
 
 // src/cli/commands/use-command.ts
+import { execFile as execFile3, spawn as spawn7 } from "child_process";
 import { basename as basename2 } from "path";
 import { confirm as confirm2, isCancel as isCancel2, log as log2, note as note2, password as password2, select, spinner as spinner3, text as text2 } from "@clack/prompts";
 import pc22 from "picocolors";
-
-// src/core/global-config.ts
-import { chmod, mkdir as mkdir4, readFile as readFile6, writeFile as writeFile3 } from "fs/promises";
-import { homedir } from "os";
-import { dirname as dirname3, join as join8 } from "path";
-import { z as z3 } from "zod";
-var GLOBAL_DIR = ".codebuddy";
-var GLOBAL_FILE = "global.json";
-var globalConfigSchema = z3.object({
-  hfToken: z3.string().min(1).optional(),
-  databaseUrl: z3.string().min(1).optional(),
-  // Where the codebuddy install lives on this machine. Cached so future
-  // `codebuddy use` calls in unrelated projects can find the CLI entry
-  // without re-resolving via process.argv every time.
-  installPath: z3.string().optional()
-});
-function globalConfigPath(home = homedir()) {
-  return join8(home, GLOBAL_DIR, GLOBAL_FILE);
-}
-async function readGlobalConfig(home = homedir()) {
-  const path = globalConfigPath(home);
-  try {
-    const raw = await readFile6(path, "utf8");
-    return globalConfigSchema.parse(JSON.parse(raw));
-  } catch (error) {
-    if (error.code === "ENOENT") return {};
-    throw error;
-  }
-}
-async function writeGlobalConfig(next, home = homedir()) {
-  const path = globalConfigPath(home);
-  await mkdir4(dirname3(path), { recursive: true, mode: 448 });
-  await writeFile3(path, `${JSON.stringify(next, null, 2)}
-`, { mode: 384 });
-  await chmod(path, 384);
-  return { path };
-}
-async function mergeGlobalConfig(patch, home = homedir()) {
-  const current = await readGlobalConfig(home);
-  const merged = { ...current, ...patch };
-  const { path } = await writeGlobalConfig(merged, home);
-  return { path, merged };
-}
-
-// src/cli/commands/use-command.ts
 function bail2() {
   log2.warn("Aborted.");
   process.exit(1);
@@ -4953,6 +5022,131 @@ async function pingOnce2(databaseUrl) {
     await client.close().catch(() => void 0);
   }
 }
+async function setupZvec(configured) {
+  if (configured === false) {
+    log2.info(`zvec-grep: disabled in config (enable with ${pc22.cyan("codebuddy zvec enable")}).`);
+    return;
+  }
+  let report = await zvecStatus(process.cwd()).catch(() => null);
+  if (report && report.version === null && process.env.CODEBUDDY_ZVEC !== "0") {
+    const install = spinner3();
+    install.start(`Installing zvec-grep (${ZVEC_PACKAGE})`);
+    const code2 = await npmGlobalInstall(ZVEC_PACKAGE);
+    install.stop(code2 === 0 ? "zvec-grep installed." : `zvec-grep install failed (exit ${code2}).`);
+    if (code2 === 0) report = await zvecStatus(process.cwd()).catch(() => null);
+  }
+  if (!report?.supported) {
+    log2.warn(
+      `zvec-grep: ${report?.reason ?? "unavailable"}; keyword-only file discovery. Install with ${pc22.cyan("npm install -g @zvec/zvec-grep")}, then ${pc22.cyan("codebuddy zvec index && codebuddy zvec enable")}.`
+    );
+    return;
+  }
+  const zvecSpinner = spinner3();
+  zvecSpinner.start("Building the zvec-grep semantic index");
+  const code = report.indexReady ? 0 : await buildZvecIndex(process.cwd(), { quiet: true });
+  if (code !== 0) {
+    zvecSpinner.stop(`zvec-grep index failed (exit ${code}); keyword-only file discovery.`);
+    return;
+  }
+  await setZvecEnabled(true);
+  zvecSpinner.stop("zvec-grep semantic file discovery enabled.");
+}
+var ZVEC_PACKAGE = "@zvec/zvec-grep@0.2";
+function npmGlobalInstall(spec) {
+  return new Promise((resolve6) => {
+    execFile3(
+      "npm",
+      ["install", "-g", spec],
+      { timeout: 10 * 6e4 },
+      (error) => resolve6(error ? typeof error.code === "number" ? error.code : 1 : 0)
+    );
+  });
+}
+async function setupEmbeddings(embeddings) {
+  if (embeddings !== "local" || process.env.CODEBUDDY_SEMANTIC === "0") return;
+  const pull = spinner3();
+  pull.start("Downloading the local embedding model (~90 MB, once)");
+  try {
+    const { LocalModelProvider } = await import("./local-ST4WMRCG.js");
+    await new LocalModelProvider().embed({ input: "warm up" });
+    pull.stop("Local embedding model ready.");
+  } catch (error) {
+    pull.stop(
+      `Embedding model unavailable (${error.message.split("\n")[0]}); recall stays lexical until ${pc22.cyan("codebuddy models pull")} succeeds.`
+    );
+  }
+}
+function startBackgroundIndex(withModel) {
+  const entry = process.argv[1];
+  if (!entry) return;
+  const child = spawn7(process.execPath, [entry, "index", "--cards"], {
+    cwd: process.cwd(),
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+  log2.info(
+    withModel ? "Building file vectors, intent cards and project facts in the background." : "Building file vectors in the background."
+  );
+}
+async function setupLocalLlm(choice, interactive) {
+  if (choice === false || process.env.CODEBUDDY_LOCAL_LLM === "0") {
+    log2.info(`Local LLM: skipped (add later with ${pc22.cyan("codebuddy models add local-llm")}).`);
+    return false;
+  }
+  const { installedLocalModel, machineCanCard } = await import("./local-TH5XCLVJ.js");
+  let installed = await installedLocalModel() !== null;
+  const machine = machineCanCard();
+  if (!installed && !machine.ok) {
+    if (!await setupCloudQwen(machine.reason, interactive)) return false;
+    installed = true;
+  }
+  if (!installed) {
+    const { addLocalLlm: addLocalLlm2 } = await import("./local-llm-GZREB5DF.js");
+    installed = await addLocalLlm2({ yes: true, interactive });
+    if (!installed) {
+      log2.warn(
+        `Local LLM not installed; file discovery uses keywords and vectors only. Retry with ${pc22.cyan("codebuddy models add local-llm")}.`
+      );
+      return false;
+    }
+  }
+  return installed;
+}
+async function setupCloudQwen(reason, interactive) {
+  const existing = (await readConfigFile()).llm;
+  if (existing && existing.provider !== "local") return existing.enabled;
+  const fromEnv = process.env.GROQ_API_KEY ? "groq" : process.env.OPENROUTER_API_KEY ? "openrouter" : null;
+  const saved = await readGlobalConfig().catch(
+    () => ({})
+  );
+  let chosen = fromEnv ?? (saved.groqApiKey ? "groq" : saved.openrouterApiKey ? "openrouter" : null);
+  if (!chosen && interactive) {
+    log2.info(
+      `This machine is too small for the local model (${reason}), so CodeBuddy can use Qwen in the cloud. Get a free Groq key at ${pc22.cyan("https://console.groq.com/keys")}.`
+    );
+    const key = unwrap2(
+      await password2({
+        message: "Groq API key (Enter to skip; saved to ~/.codebuddy/global.json)"
+      })
+    ).trim();
+    if (key) {
+      await mergeGlobalConfig({ groqApiKey: key });
+      chosen = "groq";
+    }
+  }
+  if (!chosen) {
+    log2.warn(
+      `Local LLM: this machine is too small for it (${reason}). For cloud Qwen, get a free key at ${pc22.cyan("https://console.groq.com/keys")} and rerun ${pc22.cyan("codebuddy")} (or ${pc22.cyan("export GROQ_API_KEY=\u2026")} and ${pc22.cyan("codebuddy llm enable --provider groq")}). Keyword + vector discovery work meanwhile.`
+    );
+    return false;
+  }
+  await setLlmEnabled(true, { provider: chosen });
+  log2.info(
+    `LLM: this machine is too small for the local model (${reason}); using Qwen (qwen/qwen3.8-27b) on ${chosen}. Redacted file heads and signatures are sent to it; turn off with \`codebuddy llm disable\`.`
+  );
+  return true;
+}
 function sanitizeNamespace(input) {
   return input.replace(/[^a-zA-Z0-9_.:-]/g, "-").slice(0, 128) || "default";
 }
@@ -4975,7 +5169,7 @@ async function runUseCommand(options = {}) {
     note2(
       `Project folder: ${pc22.bold(process.cwd())}
 Namespace:      ${pc22.bold(namespace)}`,
-      "codebuddy use"
+      "codebuddy"
     );
     const stored = await readGlobalConfig();
     const projectConfig = await readConfigFile();
@@ -5138,6 +5332,9 @@ Namespace:      ${pc22.bold(namespace)}`,
       tokenBudget: existingConfig.tokenBudget ?? 4e3,
       graphify: { enabled: graphifyConfigured, graphPath: "graphify-out/graph.json" }
     });
+    await setupEmbeddings(embeddings);
+    await setupZvec(existingConfig.zvec?.enabled);
+    startBackgroundIndex(await setupLocalLlm(options.localLlm, interactive));
     const graphifyMessage = graphifySetup?.message ?? "Graphify disabled; CodeBuddy MCP remains available.";
     await writeProjectMcpConfig({
       repositoryRoot: process.cwd(),
@@ -5321,26 +5518,20 @@ function createCli() {
   program.name("codebuddy").description(
     "Project memory and context for AI coding agents: recalls the right facts, files and risks on every prompt."
   ).version(VERSION);
-  program.action(async () => {
-    await runSafely(async () => {
-      await runUseCommand();
-    });
-  });
-  program.command("use").description(
-    "One-command setup for this folder: PostgreSQL (starts Docker if needed), migrations, embeddings, and agent wiring."
-  ).argument("[namespace]", "Override the namespace (defaults to current folder name).").option("--postgres-url <url>", "Postgres URL to use for this project.").option("--skip-claude", "Do not register with Claude Desktop.").option("--skip-codex", "Do not register with Codex.").option("--graphify", "Enable Graphify setup without prompting.").option("--no-graphify", "Skip Graphify setup without prompting.").option(
+  program.enablePositionalOptions().option("--namespace <name>", "Override the namespace (defaults to current folder name).").option("--postgres-url <url>", "Postgres URL to use for this project.").option("--skip-claude", "Do not register with Claude Desktop.").option("--skip-codex", "Do not register with Codex.").option("--graphify", "Enable Graphify setup without prompting.").option("--no-graphify", "Skip Graphify setup without prompting.").option(
     "--docker",
     "Start CodeBuddy's bundled Postgres container when the default DB is unavailable."
-  ).option("--no-docker", "Do not offer to start CodeBuddy's bundled Postgres container.").option("-y, --yes", "Never prompt: use flags and defaults (automatic without a TTY).").option("--non-interactive", "Same as --yes.").action(
-    async (namespace, opts) => {
+  ).option("--no-docker", "Do not offer to start CodeBuddy's bundled Postgres container.").option("--no-local-llm", "Skip installing the local LLM (Qwen3-0.6B, ~400 MB).").option("-y, --yes", "Never prompt: use flags and defaults (automatic without a TTY).").option("--non-interactive", "Same as --yes.").action(
+    async (opts) => {
       await runSafely(async () => {
         await runUseCommand({
-          ...namespace !== void 0 ? { namespace } : {},
+          ...opts.namespace !== void 0 ? { namespace: opts.namespace } : {},
           ...opts.postgresUrl !== void 0 ? { postgresUrl: opts.postgresUrl } : {},
           ...opts.skipClaude !== void 0 ? { skipClaude: opts.skipClaude } : {},
           ...opts.skipCodex !== void 0 ? { skipCodex: opts.skipCodex } : {},
           ...opts.graphify !== void 0 ? { graphify: opts.graphify } : {},
           ...opts.docker !== void 0 ? { useDocker: opts.docker } : {},
+          ...opts.localLlm !== void 0 ? { localLlm: opts.localLlm } : {},
           ...opts.yes || opts.nonInteractive ? { interactive: false } : {}
         });
       });
@@ -5580,7 +5771,13 @@ function createCli() {
   });
   program.command("stats").description("Show CodeBuddy storage and usage stats.").action(async () => {
     await withRuntime(async (runtime) => {
-      console.log(JSON.stringify(await runtime.repository.getStats(), null, 2));
+      console.log(
+        JSON.stringify(
+          { ...await runtime.repository.getStats(), ...await indexModelStats(process.cwd()) },
+          null,
+          2
+        )
+      );
     });
   });
   program.command("storage").option("--json", "Print machine-readable JSON.").description(
@@ -5603,11 +5800,15 @@ function createCli() {
       } catch (error) {
         database = { unavailable: error.message };
       }
+      const index = await indexModelStats(root);
       if (opts.json) {
-        console.log(JSON.stringify({ database, capture: capture2 }, null, 2));
+        console.log(JSON.stringify({ database, capture: capture2, ...index }, null, 2));
         return;
       }
       printStorage(database, capture2);
+      console.log(
+        `intent cards: ${index.cards.carded} / ${index.cards.eligible} source files; index facts: ${index.indexFacts}`
+      );
       if ("unavailable" in database || database.markdownOnly.length + database.dbOnly.length > 0) {
         process.exitCode = 1;
       }
@@ -5658,14 +5859,11 @@ function createCli() {
     return showTelemetryNoticeOnce();
   });
   program.hook("postAction", (_program, command) => traceCliCommand(command, started));
-  program.action(async () => {
-    await runSafely(() => runUseCommand());
-  });
   groupHelp(program);
   return program;
 }
 var HELP_GROUPS = [
-  ["Get started:", ["use", "init", "doctor", "hooks", "clients", "models", "dashboard"]],
+  ["Get started:", ["init", "doctor", "hooks", "clients", "models", "dashboard"]],
   [
     "Daily work:",
     [
@@ -5728,6 +5926,14 @@ Quick start:
                                  see exactly what an agent would be given`
   );
 }
+async function indexModelStats(root) {
+  const { cardProgress } = await import("./summaries-W2J5FCLG.js");
+  const { listIndexFacts: listIndexFacts2 } = await import("./index-facts-MBJKBYA3.js");
+  return {
+    cards: await cardProgress(root).catch(() => ({ carded: 0, eligible: 0 })),
+    indexFacts: (await listIndexFacts2(root).catch(() => [])).length
+  };
+}
 async function withRuntime(fn) {
   await runSafely(async () => {
     const runtime = await createRuntime(await loadRuntimeConfig());
@@ -5847,4 +6053,4 @@ function printStorage(database, capture2) {
 export {
   createCli
 };
-//# sourceMappingURL=main-SFC5LV4E.js.map
+//# sourceMappingURL=main-QF6Z552J.js.map